Examples

We have created some examples of how the message content for a House Consignment can look based on the customs procedure used. The examples are also illustrated with reference to Master Consignment to show how postal consignments are reported slightly differently. To keep it as short as possible, only the content that differs for the various procedures is shown, i.e., the following objects:

houseConsignment.consignmentHouseLevel.exportFromEU
houseConsignment.consignmentHouseLevel.importProcedure
houseConsignment.consignmentHouseLevel.previousDocuments
houseConsignment.consignmentHouseLevel.transportDocumentHouseLevel
houseConsignment.consignmentHouseLevel.consignmentMasterLevel

Example 1 – Customs declaration for release for free circulation and Swedish/EU export (only relevant for road)

{
    "consignmentHouseLevel": {
        "transportDocumentHouseLevel": {
            "documentNumber": "423JI4J53IJ534I",
            "type": "N750"
        },
        "consignmentMasterLevel": {
            "carrierIdentificationNumber": "123456789",
            "transportDocumentMasterLevel": {
                "documentNumber": "HUH34UI5HU34I",
                "type": "N741"
            }
        },
        "previousDocuments": [
            {
                "typeOfReference": "CUDE",
                "declarantNumber": "913144929",
                "declarationDate": "2022-03-01",
                "sequenceNumber": "13881"
            }
        ],
        "exportFromEU": [
            {
                "typeOfExport": "UGE_EXPORT",
                "exportId": "22SEEVO1CT5UAP2BT3"
            }
        ],
        "importProcedure": {
            "outgoingProcedure": "EXP",
            "importProcedure": "IMMEDIATE_RELEASE_IMPORT"
        }
    }
}

Example 2 – Customs declaration for release for free circulation and transit to be completed at border crossing

{
    "consignmentHouseLevel": {
        "transportDocumentHouseLevel": {
            "documentNumber": "423JI4J53IJ534I",
            "type": "N750"
        },
        "consignmentMasterLevel": {
            "carrierIdentificationNumber": "123456789",
            "transportDocumentMasterLevel": {
                "documentNumber": "HUH34UI5HU34I",
                "type": "N741"
            }
        },
        "previousDocuments": [
            {
                "typeOfReference": "N820",
                "referenceNumber": "22FR98765273876523"
            },
            {
                "typeOfReference": "CUDE",
                "declarantNumber": "913144929",
                "declarationDate": "2022-03-01",
                "sequenceNumber": "13881"
            }
        ],
        "importProcedure": {
            "outgoingProcedure": "TRA",
            "importProcedure": "IMMEDIATE_RELEASE_IMPORT"
        }
    }
}

Example 3 – Transit started outside Norway and only to be border-crossed upon arrival at the border

{
    "consignmentHouseLevel": {
        "transportDocumentHouseLevel": {
            "documentNumber": "423JI4J53IJ534I",
            "type": "N750"
        },
        "consignmentMasterLevel": {
            "carrierIdentificationNumber": "123456789",
            "transportDocumentMasterLevel": {
                "documentNumber": "HUH34UI5HU34I",
                "type": "N741"
            }
        },
        "previousDocuments": [
            {
                "typeOfReference": "N820",
                "referenceNumber": "22FR98765273876523"
            }
        ],
        "importProcedure": {
            "outgoingProcedure": "TRA",
            "importProcedure": "TRANSIT_IMPORT"
        }
    }
}

Example 4 – Transit to be started at the border, procedure up to the border is Swedish export

{
    "consignmentHouseLevel": {
        "transportDocumentHouseLevel": {
            "documentNumber": "423JI4J53IJ534I",
            "type": "N750"
        },
        "consignmentMasterLevel": {
            "carrierIdentificationNumber": "123456789",
            "transportDocumentMasterLevel": {
                "documentNumber": "HUH34UI5HU34I",
                "type": "N741"
            }
        },
        "previousDocuments": [
            {
                "typeOfReference": "RETR",
                "referenceNumber": "SE2298081234598765"
            }
        ],
        "exportFromEU": [
            {
                "typeOfExport": "UGE_EXPORT",
                "exportId": "22SEEEO1CT5UAP2BT3"
            }
        ],
        "importProcedure": {
            "outgoingProcedure": "EXP",
            "importProcedure": "TRANSIT_RELEASE"
        }
    }
}

Example 5 – Customs declaration for release for free circulation where exports are completed in the country of departure

{
    "consignmentHouseLevel": {
        "transportDocumentHouseLevel": {
            "documentNumber": "423JI4J53IJ534I",
            "type": "N750"
        },
        "consignmentMasterLevel": {
            "carrierIdentificationNumber": "123456789",
            "transportDocumentMasterLevel": {
                "documentNumber": "HUH34UI5HU34I",
                "type": "N741"
            }
        },
        "previousDocuments": [
            {
                "typeOfReference": "CUDE",
                "declarantNumber": "913144929",
                "declarationDate": "2022-03-01",
                "sequenceNumber": "13881"
            }
        ],
        "importProcedure": {
            "hasOutgoingProcedure": false,
            "importProcedure": "IMMEDIATE_RELEASE_IMPORT"
        }
    }
}

Example 6 – VOEC consignment

{
    "consignmentHouseLevel": {
        "transportDocumentHouseLevel": {
            "documentNumber": "423JI4J53IJ534I",
            "type": "N750"
        },
        "consignmentMasterLevel": {
            "carrierIdentificationNumber": "123456789",
            "transportDocumentMasterLevel": {
                "documentNumber": "HUH34UI5HU34I",
                "type": "N741"
            }
        },
        "importProcedure": {
            "importProcedure": "IMMEDIATE_RELEASE_VOEC",
            "hasOutgoingProcedure": false
        },
        "goodsItem": [
            {
                "additionalFiscalReferences": {
                    "vatIdentificationNumber": "589403",
                    "role": "FR5"
                },
                "itemAmountInvoicedVOEC": {
                    "value": 400.50,
                    "numberOfItems": 11
                },
                "commodityCodeVOEC": {
                    "harmonizedSystemSubHeadingCode": "551100"
                }
            }
        ]
    }
}

Example 7 – Postal consignment for collective clearance

{
    "consignmentHouseLevel": {
        "receptacleIdentificationNumber": "4j3i24ji3o24ji23",
        "transportDocumentHouseLevel": {
            "documentNumber": "423JI4J53IJ534I",
            "type": "N750"
        },
        "importProcedure": {
            "importProcedure": "COLLECTIVE_RELEASE",
            "hasOutgoingProcedure": false
        }
    }
}

Example 8 – Customs declaration for entry into a customs warehouse without information on the procedure up to the border

{
    "consignmentHouseLevel": {
        "transportDocumentHouseLevel": {
            "documentNumber": "423JI4J53IJ534I",
            "type": "N750"
        },
        "consignmentMasterLevel": {
            "carrierIdentificationNumber": "123456789",
            "transportDocumentMasterLevel": {
                "documentNumber": "HUH34UI5HU34I",
                "type": "N741"
            }
        },
        "previousDocuments": [
            {
                "typeOfReference": "CUDE",
                "declarantNumber": "913144929",
                "declarationDate": "2022-03-01",
                "sequenceNumber": "13881"
            }
        ],
        "importProcedure": {
            "hasOutgoingProcedure": false,
            "importProcedure": "WAREHOUSE_RELEASE"
        }
    }
}

Example 9 – Goods registration at the border and export up to the border

{
    "consignmentHouseLevel": {
        "transportDocumentHouseLevel": {
            "documentNumber": "423JI4J53IJ534I",
            "type": "N750"
        },
        "consignmentMasterLevel": {
            "carrierIdentificationNumber": "123456789",
            "transportDocumentMasterLevel": {
                "documentNumber": "HUH34UI5HU34I",
                "type": "N741"
            }
        },
        "previousDocuments": [
            {
                "typeOfReference": "GONU",
                "referenceNumber": "123456789"
            }
        ],
        "exportFromEU": [
            {
                "typeOfExport": "AES_EXPORT",
                "exportId": "22SEEVO1CT5UAP2BT3"
            }
        ],
        "importProcedure": {
            "outgoingProcedure": "EXP",
            "importProcedure": "WAREHOUSE_RELEASE"
        }
    }
}

Test data

The validation of submitted messages includes a check that the specified declarations in TVINN and NCTS exist and have the expected status. In the playground environment, we do not have integration with these systems, so the content is validated against a static list containing a few declarations.

For TVINN declarations, these can be used:

declarant_number	declaration_date	sequence_number
123456789	2022-08-10	1
123456789	2022-08-10	2
123456789	2022-08-10	3
123456789	2022-08-10	4
123456789	2022-08-10	5
123456789	2022-08-10	6
123456789	2022-08-10	7
123456789	2022-08-10	8
123456789	2022-08-10	9
123456789	2022-08-10	10

For transit declarations (NCTS), validation in the playground environment is even simpler. Here we only validate that the field contains 18 alphanumeric characters which are considered OK. If the field contains the text "INVALID", it will be invalidated.

VOEC permit number that validates ok: 2056550