Hvordan fylle ut melding om forsendelse, vei/ferge

Grensesnittbeskrivelse

Tjenestene gjøres tilgjengelige som REST-tjenester over HTTPS, med data på JSON-format.

POST https://<env>/api/movement/road/v2/transport
POST https://<env>/api/movement/road/v2/master-consignment
POST https://<env>/api/movement/road/v2/house-consignment

PUT/DELETE https://<env>/api/movement/road/v2/transport/{MRN}
PUT/DELETE https://<env>/api/movement/road/v2/master-consignment/{MRN}
PUT/DELETE https://<env>/api/movement/road/v2/house-consignment/{MRN}

GET https://<env>/api/movement/road/status/v2/transport/validation-status/{requestId}
GET https://<env>/api/movement/road/status/v2/master-consignment/validation-status/{requestId}
GET https://<env>/api/movement/road/status/v2/house-consignment/validation-status/{requestId}

der

<env> byttes ut med
- api.toll.no for produksjon
- api-test.toll.no for playground (testmiljø)
{requestId} byttes ut med referansen som returneres ved POST/PUT/DELETE-kall
{MRN} byttes ut med referansen som returneres fra ".../validation-status..."-endepunktene.

Dersom du oppdager sikkerhetsutfordringer i våre løsninger ber vi deg ta kontakt; se her for info

API-tjenester

API: movement-road-api-v2

For å kunne bruke tjenesten må scope for autentisering mot Maskinporten settes til toll:movement/road/v2

Se API-dokumentasjon her.

API: movement-road-query-api-v2

For å kunne bruke tjenesten må scope for autentisering mot Maskinporten settes til toll:movement/road/v2

Se API-dokumentasjon her.

API: movement-presentation-api

Se API-dokumentasjon her.

API: movement-routing-api

Se API-dokumentasjon her.

IMMEDIATE_RELEASE_IMPORT

Felt	Kodeverk	Variant 1	Variant 2	Variant 3		Variant 4
Beskrivelse av tollprosedyre og prosedyre fram til grensen		Det er på forhånd levert deklarasjon for overgang til fri disponering. Annen tollmyndighet har klarert foregående prosedyre (f.eks. dansk toll før ferge til Larvik)	Det er på forhånd levert deklarasjon for overgang til fri disponering. EU/svensk-eksport er foregående prosedyre og skal klareres ved grensepassering	Det er på forhånd levert deklarasjon for overgang til fri disponering. Eksport og transittering er foregående prosedyre og skal fullføres ved grensepassering.		Det er på forhånd levert deklarasjon for overgang til fri disponering. Transittering er foregående prosedyre og skal fullføres ved grensepassering.
importProcedure		må fylles ut	må fylles ut	må fylles ut		må fylles ut
importProcedure	ImportProcedure	IMMEDIATE_RELEASE_IMPORT	IMMEDIATE_RELEASE_IMPORT	IMMEDIATE_RELEASE_IMPORT		IMMEDIATE_RELEASE_IMPORT
outgoingProcedure	OutgoingProcedure	-	EXP	TRE		TRA
hasOutgoingProcedure	-	false	true	true		true
previousDocuments		liste må ha ett innslag av type:	liste må ha ett innslag av type:	liste må ha ett innslag av type:	OG liste må ha ett innslag av type:	liste må ha ett innslag av type:	OG liste må ha ett innslag av type:
referenceNumber	-	-	-	-	<må ha verdi>	-	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	må være = CUDE	må være = CUDE	må være = CUDE	må være = N820	må være = CUDE	må være = N820
declarantNumber	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-	<må ha verdi>	-
declarationDate	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-	<må ha verdi>	-
sequenceNumber	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-	<må ha verdi>	-
exportFromEU		-	liste må ha MINST ett innslag av type:	liste må ha MINST ett innslag av type:		-
exportId	-	-	<må ha verdi>	<må ha verdi>		-
typeOfExport	TB_Eksporttype	-	må være en av [ AES_EXPORT, EUEIR_EXPORT ]	må være en av [ AES_EXPORT, EUEIR_EXPORT ]		-
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen.	IncompleteDocumentationReason	INCOMPLETE_CUDE_DOCUMENTATION	INCOMPLETE_CUDE_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION	INCOMPLETE_CUDE_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION		INCOMPLETE_CUDE_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION

TRANSIT_IMPORT / TRANSIT_RELEASE

Felt	Kodeverk	Variant 5	Variant 6
Beskrivelse av tollprosedyre og prosedyre fram til grensen		Transittering er startet opp i annet land. Fullføring av transitteringen skal utføres ved lossing. Ved grensepassering skal det kun registreres grensepassering i NCTS	Transittering skal startes opp på grensen. EU/svensk-eksport er foregående prosedyre og skal klareres ved grensepassering
importProcedure		må fylles ut	må fylles ut
importProcedure	ImportProcedure	TRANSIT_IMPORT	TRANSIT_RELEASE
outgoingProcedure	OutgoingProcedure	TRA	EXP
hasOutgoingProcedure	-	true	true
previousDocuments		liste må ha ett innslag av type:	liste må ha ett innslag av type:
referenceNumber	-	<må ha verdi>	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	må være = N820	må være = RETR
declarantNumber	-	-	-
declarationDate	-	-	-
sequenceNumber	-	-	-
exportFromEU		-	liste må ha MINST ett innslag av type:
exportId	-	-	<må ha verdi>
typeOfExport	TB_Eksporttype	-	må være en av [ AES_EXPORT, EUEIR_EXPORT ]
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen.	IncompleteDocumentationReason	INCOMPLETE_TRA_DOCUMENTATION	INCOMPLETE_TRA_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION

IMMEDIATE_RELEASE_VOEC

Felt	Kodeverk	Variant 7	Variant 8	Variant 9	Variant 10
Beskrivelse av tollprosedyre og prosedyre fram til grensen		VOEC-forsendelser. Annen tollmyndighet har klarert foregående prosedyre, eller verdi under verdigrensen for krav om eksport.	VOEC-forsendelse. EU/svensk-eksport er foregående prosedyre og skal klareres ved grensepassering	VOEC-forsendelse. Eksport og transittering er foregående prosedyre og skal fullføres ved grensepassering.	VOEC-forsendelse. VOEC-forsendelse som kommer med transittering som skal fullføres på grensen
importProcedure		må fylles ut	må fylles ut	må fylles ut	må fylles ut
importProcedure	ImportProcedure	IMMEDIATE_RELEASE_VOEC	IMMEDIATE_RELEASE_VOEC	IMMEDIATE_RELEASE_VOEC	IMMEDIATE_RELEASE_VOEC
outgoingProcedure	OutgoingProcedure	-	EXP	TRE	TRA
hasOutgoingProcedure	-	-	true	true	true
previousDocuments		-	-	liste må ha ett innslag av type:	liste må ha ett innslag av type:
referenceNumber	-	-	-	<må ha verdi>	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	-	-	må være = N820	må være = N820
declarantNumber	-	-	-	-	-
declarationDate	-	-	-	-	-
sequenceNumber	-	-	-	-	-
exportFromEU		-	liste må ha MINST ett innslag av type:	liste må ha MINST ett innslag av type:	-
exportId	-	-	<må ha verdi>	-	-
typeOfExport	TB_Eksporttype	-	må være en av [ AES_EXPORT, EUEIR_EXPORT ]	-	-
goodsItem	-	må fylles ut	må fylles ut	må fylles ut	må fylles ut
itemAmountInvoicedVOEC	-	må fylles ut	må fylles ut	må fylles ut	må fylles ut
value	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	<må ha verdi>
numberOfItems	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	<må ha verdi>
commodityCodeVOEC	-	må fylles ut	må fylles ut	må fylles ut	må fylles ut
harmonizedSystemSubheadingCode	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	<må ha verdi>
additionalFiscalReferences	-	må fylles ut	må fylles ut	må fylles ut	må fylles ut
vatIdentificationNumber	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	<må ha verdi>
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen.	IncompleteDocumentationReason	INCOMPLETE_VOEC_DOCUMENTATION	INCOMPLETE_VOEC_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION	INCOMPLETE_VOEC_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION	INCOMPLETE_VOEC_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION

WAREHOUSE_RELEASE

Felt	Kodeverk	Variant 11	Variant 12	Variant 13		Variant 14		Variant 23	Variant 24	Variant 25		Variant 26
Beskrivelse av tollprosedyre og prosedyre fram til grensen		Det er på forhånd levert deklarasjon for innlegg på tollager. Annen tollmyndighet har klarert foregående prosedyre (f.eks. dansk toll før ferge til Larvik)	Det er på forhånd levert deklarasjon for innlegg på tollager. EU/svensk-eksport er foregående prosedyre og skal klareres ved grensepassering	Det er på forhånd levert deklarasjon for innlegg på tollager. Eksport og transittering er foregående prosedyre og skal fullføres ved grensepassering.		Det er på forhånd levert deklarasjon for innlegg på tollager. ETransittering er foregående prosedyre og skal fullføres ved grensepassering.		Forsendelse som skal godsregistreres ved grensepassering Annen tollmyndighet har klarert foregående prosedyre (f.eks. dansk toll før ferge til Larvik)	Forsendelse som skal godsregistreres ved grensepassering Eksport er foregående prosedyre og skal klareres ved grensepassering.	Forsendelse som skal godsregistreres ved grensepassering Transittering er foregående prosedyre og skal fullføres ved grensepassering.		Forsendelse som skal godsregistreres ved grensepassering Eksport og transittering er foregående prosedyre og skal fullføres ved grensepassering.
importProcedure		må fylles ut	må fylles ut	må fylles ut		må fylles ut		må fylles ut	må fylles ut	må fylles ut		må fylles ut
importProcedure	ImportProcedure	WAREHOUSE_RELEASE	WAREHOUSE_RELEASE	WAREHOUSE_RELEASE		WAREHOUSE_RELEASE		WAREHOUSE_RELEASE	WAREHOUSE_RELEASE	WAREHOUSE_RELEASE		WAREHOUSE_RELEASE
outgoingProcedure	OutgoingProcedure	-	EXP	TRE		TRA		-	EXP	TRA		TRE
hasOutgoingProcedure	-	false	true	true		true		false	true	true		true
previousDocuments		liste må ha ett innslag av type:	liste må ha ett innslag av type:	liste må ha ett innslag av type:	OG liste må ha ett innslag av type:	liste må ha ett innslag av type:	OG liste må ha ett innslag av type:	OG liste må ha ett innslag av type:	OG liste må ha ett innslag av type:	liste må ha ett innslag av type:	OG liste må ha ett innslag av type:	liste må ha ett innslag av type:	OG liste må ha ett innslag av type:
referenceNumber	-	-	-	-	<må ha verdi>	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	<må ha verdi>	<må ha verdi>	<må ha verdi>	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	må være = CUDE	må være = CUDE	må være = CUDE	må være = N820	må være = CUDE	må være = N820	må være = GONU	må være = GONU	må være = N820	må være = GONU	må være = GONU	må være = N820
declarantNumber	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-	<må ha verdi>	-	-	-	-	-	-	-
declarationDate	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-	<må ha verdi>	-	-	-	-	-	-	-
sequenceNumber	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-	<må ha verdi>	-	-	-	-	-	-	-
exportFromEU		-	liste må ha MINST ett innslag av type:	liste må ha MINST ett innslag av type:		-		-	liste må ha MINST ett innslag av type:	-		liste må ha MINST ett innslag av type:
exportId	-	-	<må ha verdi>	<må ha verdi>		-		-	<må ha verdi>	-		<må ha verdi>
typeOfExport	TB_Eksporttype	-	må være en av [ AES_EXPORT, EUEIR_EXPORT ]	må være en av [ AES_EXPORT, EUEIR_EXPORT ]		-		-	må være en av [ AES_EXPORT, EUEIR_EXPORT ]	-		må være en av [ AES_EXPORT, EUEIR_EXPORT ]
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen.	IncompleteDocumentationReason	INCOMPLETE_DOCUMENTATION	INCOMPLETE_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION	INCOMPLETE_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION		INCOMPLETE_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION		INCOMPLETE_DOCUMENTATION	INCOMPLETE_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION	INCOMPLETE_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION		INCOMPLETE_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION

COLLECTIVE_RELEASE

Felt	Kodeverk	Variant 15	Variant 16	Variant 17	Variant 18
Beskrivelse av tollprosedyre og prosedyre fram til grensen		Forsendelse som skal samlefortolles etter grensepassering. Annen tollmyndighet har klarert foregående prosedyre (f.eks. dansk toll før ferge til Larvik)	Forsendelse som skal samlefortolles etter grensepassering. EU/svensk-eksport er foregående prosedyre og skal klareres ved grensepassering	Forsendelse som skal samlefortolles etter grensepassering. Eksport og transittering er foregående prosedyre og skal klareres ved grensepassering	Forsendelse som skal samlefortolles etter grensepassering. Transittering er foregående prosedyre og skal fullføres ved grensepassering.
importProcedure		må fylles ut	må fylles ut	må fylles ut	må fylles ut
importProcedure	ImportProcedure	COLLECTIVE_RELEASE	COLLECTIVE_RELEASE	COLLECTIVE_RELEASE	COLLECTIVE_RELEASE
outgoingProcedure	OutgoingProcedure	-	EXP	TRE	TRA
hasOutgoingProcedure	-	false	true	true	true
previousDocuments		-	-	OG liste må ha ett innslag av type:	OG liste må ha ett innslag av type:
referenceNumber	-	-	-	<må ha verdi>	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	-		må være = N820	må være = N820
declarantNumber	-	-		-	-
declarationDate	-	-		-	-
sequenceNumber	-	-		-	-
exportFromEU		-	liste må ha MINST ett innslag av type:	liste må ha MINST ett innslag av type:	-
exportId	-	-	<må ha verdi>	<må ha verdi>	-
typeOfExport	TB_Eksporttype	-	må være en av [ AES_EXPORT, EUEIR_EXPORT ]	må være en av [ AES_EXPORT, EUEIR_EXPORT ]	-
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen.	IncompleteDocumentationReason		INCOMPLETE_EXP_DOCUMENTATION	INCOMPLETE_EXP_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION	INCOMPLETE_TRA_DOCUMENTATION

DOCUMENTS_NOT_OBLIGED_RELEASE

Felt	Kodeverk	Variant 19	Variant 20	Variant 21	Variant 22
Beskrivelse av tollprosedyre og prosedyre fram til grensen		Forsendelse som ikke har deklarasjonsplikt etter § 4-1-29 i vareførselsforskriften. Annen tollmyndighet har klarert foregående prosedyre (f.eks. dansk toll før ferge til Larvik)	Forsendelse som ikke har deklarasjonsplikt etter § 4-1-29 i vareførselsforskriften. EU/svensk-eksport er foregående prosedyre og skal klareres ved grensepassering	Forsendelse som ikke har deklarasjonsplikt etter § 4-1-29 i vareførselsforskriften. Eksport og transittering er foregående prosedyre og skal fullføres ved grensepassering.	Forsendelse som ikke har deklarasjonsplikt etter § 4-1-29 i vareførselsforskriften. Transittering er foregående prosedyre og skal fullføres ved grensepassering.
importProcedure		må fylles ut	må fylles ut	må fylles ut	må fylles ut
importProcedure	ImportProcedure	DOCUMENTS_NOT_OBLIGED_RELEASE	DOCUMENTS_NOT_OBLIGED_RELEASE	DOCUMENTS_NOT_OBLIGED_RELEASE	DOCUMENTS_NOT_OBLIGED_RELEASE
outgoingProcedure	OutgoingProcedure	-	EXP	TRE	TRA
hasOutgoingProcedure	-	false	true	true	true
previousDocuments		-	-	OG liste må ha ett innslag av type:	OG liste må ha ett innslag av type:
referenceNumber	-	-	-	<må ha verdi>	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	-		må være = N820	må være = N820
declarantNumber	-	-		-	-
declarationDate	-	-		-	-
sequenceNumber	-	-		-	-
exportFromEU		liste må ha MINST ett innslag av type:	liste må ha MINST ett innslag av type:	liste må ha MINST ett innslag av type:	-
exportId	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-
typeOfExport	TB_Eksporttype	må være en av [ AES_EXPORT, EUEIR_EXPORT ]	må være en av [ AES_EXPORT, EUEIR_EXPORT ]	må være en av [ AES_EXPORT, EUEIR_EXPORT ]	-
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen.	IncompleteDocumentationReason	INCOMPLETE_EXP_DOCUMENTATION	INCOMPLETE_EXP_DOCUMENTATION	INCOMPLETE_EXP_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION	INCOMPLETE_TRA_DOCUMENTATION

ATA_CARNET / TIR_CARNET / NATO_FORM_302

Felt	Kodeverk	Variant 27	Variant 28	Variant 29
Beskrivelse av tollprosedyre og prosedyre fram til grensen		ATA-Carnet	TIR-Carnet	NATO Formular 302
importProcedure		må fylles ut	må fylles ut	må fylles ut
importProcedure	ImportProcedure	ATA_CARNET	TIR_CARNET	NATO_FORM_302
outgoingProcedure	OutgoingProcedure	-	-	-
hasOutgoingProcedure	-	false	false	false
previousDocuments		OG liste må ha ett innslag av type:	OG liste må ha ett innslag av type:	OG liste må ha ett innslag av type:
referenceNumber	-	<må ha verdi>	<må ha verdi>	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	må være = N955	må være = N952	må være = C624
declarantNumber	-	-	-	-
declarationDate	-	-	-	-
sequenceNumber	-	-	-	-
exportFromEU		-	-	-
exportId		-	-	-
typeOfExport	TB_Eksporttype	-	-	-
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen.	IncompleteDocumentationReason	INCOMPLETE_DOCUMENTATION	INCOMPLETE_DOCUMENTATION	INCOMPLETE_DOCUMENTATION