Eksempler

Vi har laget noen eksempler på hvordan meldingsinnholdet for en House Consignment kan se ut basert på hvilken tollprosedyre som benyttes. Eksemplene er også illustrert med referanse til MasterConsignment for å vise hvordan Post-forsendelser meldes litt annerledes. For å holde det så kort som mulig er kun innholdet som er forskjellig for de ulike prosedyrene vist, det vil si følgende objekter:

Eksempel 1 – Tolldeklarasjon for overgang til fri disponering og svensk/EU eksport (kun relevant på vei)

{
    "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"
        }
    }
}
       

Eksempel 2 – Tolldeklarasjon for overgang til fri disponering og transittering som skal fullføres ved grensepassering

{
    "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"
        }
    }
}
        

Eksempel 3 – Transittering som er startet opp utenfor Norge og som bare skal grensepasseres ved ankomst til grensen

{
    "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"
        }
    }
}
        

Eksempel 4 – Transittering som skal startes på grensen, prosedyre frem til grensen er svensk eksport

{
    "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"
        }
    }
}
        

Eksempel 5 – Tolldeklarasjon for overgang til fri disponering der eksportene er avsluttet i avgangslandet

{
    "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"
        }
    }
}
        

Eksempel 6 – VOEC-forsendelse

{
    "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"
                }
            }
        ]
    }
}
        

Eksempel 7 – Postforsendelse som blir samlefortollet

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

Eksempel 8 – Tolldeklarasjon for innlegg på tollager uten informasjon om prosedyre fram til grensa

{
    "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"
        }
    }
}
        


Testdata

Valideringen av innsendte meldinger inneholder blant annet en kontroll mot at oppgitte deklarasjoner i TVINN og NCTS eksisterer og har forventet status. I playground-miljøet har vi ikke integrasjon mot disse fagsystemene, så innholdet valideres mot en statisk liste som inneholder noen få deklarasjoner.

For TVINN-deklarasjoner er det disse som kan brukes:

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 transitteringsdeklarasjoner (NCTS) er det enda enklere validering i playground-miljøet. Her validerer vi bare at feltet inneholder 18 alfanumeriske tegn som regnes som OK. Dersom feltet har teksten "INVALID" i seg feilvalideres den.

VOEC tillatelsesnummer som validerer ok: 2056550