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:

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
1234567892022-08-101
1234567892022-08-102
1234567892022-08-103
1234567892022-08-104
1234567892022-08-105
1234567892022-08-106
1234567892022-08-107
1234567892022-08-108
1234567892022-08-109
1234567892022-08-1010

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