Examples
We have created some examples of how the message content for a House Consigment may look based on the customs procedure used. The examples are also illustrated with a Master Consignment reference, to show how postal consigments are a little different. To keep it as concise as possible, only the content that differs for the different procedures is shown, which includes the following objects:
- houseConsignment.consignmentHouseLevel.exportFromEU
- houseConsignment.consignmentHouseLevel.importProcedure
- houseConsignment.consignmentHouseLevel.previousDocuments
- houseConsignment.consignmentHouseLevel.transportDocumentHouseLevel
- houseConsignment.consignmentHouseLevel.consignmentMasterLevel
Example 1 – Customs declaration for immediate release import and Swedish/EU Export (road only)
{ "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 immediate release import and transit to be completed at the border
{ "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 – Example 3 – Transit started outside Norway, upon arrival at the border: border crossing only
{ "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 which is to be initiated at the border, preceding procedure 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 immediate release import where the exports are completed in the country of origin
{ "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 customs clearance
{ "consignmentHouseLevel": { "receptacleIdentificationNumber": "4j3i24ji3o24ji23", "transportDocumentHouseLevel": { "documentNumber": "423JI4J53IJ534I", "type": "N750" }, "importProcedure": { "importProcedure": "COLLECTIVE_RELEASE", "hasOutgoingProcedure": false } } }
Example 8 – Customs declaration for warehouse release, without information about customs procedure before border crossing
{ "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 preceding procedure is export
{ "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
Validation of a submitted notification includes a check to ensure that the submitted 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 that contains a few declarations.
For TVINN-declarations, the declarations in the table below may 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), there is an even simpler validation in the playground environment, we only check if the field contains 18 alphanumerical characters, which is then validated as OK. If the field has the text "INVALID", the validation will fail.
VOEC-number that validates ok: 2056550