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
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. Transittering er foregående prosedyre og skal fullføres ved grensepassering.
Aktuelle transportmåter der denne kombinasjonen er gyldig		Fly, tog, bil på ferge	Bil på vei	Tog, bil på vei, bil på ferge
importProcedure		må fylles ut	må fylles ut	må fylles ut
importProcedure	ImportProcedure	IMMEDIATE_RELEASE_IMPORT	IMMEDIATE_RELEASE_IMPORT	IMMEDIATE_RELEASE_IMPORT
outgoingProcedure	OutgoingProcedure	-	EXP	TRA
hasOutgoingProcedure	-	false	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:
referenceNumber	-	-	-	-	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	må være = CUDE	må være = CUDE	må være = CUDE	må være = N820
declarantNumber	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-
declarationDate	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-
sequenceNumber	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-
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_CUDE_DOCUMENTATION	INCOMPLETE_CUDE_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION	INCOMPLETE_CUDE_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION

TRANSIT_IMPORT / TRANSIT_RELEASE

Felt	Kodeverk	Variant 4	Variant 5
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
Aktuelle transportmåter		Bil på vei/ferge, tog	Bil på vei
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 6	Variant 7	Variant 8
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. Transittering er foregående prosedyre og skal fullføres ved grensepassering.
Aktuelle transportmåter		Bil på vei/ferge, tog, fly	Bil på vei	Bil på vei/ferge, tog
importProcedure		må fylles ut	må fylles ut	må fylles ut
importProcedure	ImportProcedure	IMMEDIATE_RELEASE_VOEC	IMMEDIATE_RELEASE_VOEC	IMMEDIATE_RELEASE_VOEC
outgoingProcedure	OutgoingProcedure	-	EXP	TRA
hasOutgoingProcedure	-	-	true	true
previousDocuments		-	-	liste må ha ett innslag av type:
referenceNumber	-	-	-	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	-	-	må være = N820
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 ]	-
goodsItem	-	må fylles ut	må fylles ut	må fylles ut
itemAmountInvoicedVOEC	-	må fylles ut	må fylles ut	må fylles ut
value	-	<må ha verdi>	<må ha verdi>	<må ha verdi>
numberOfItems	-	<må ha verdi>	<må ha verdi>	<må ha verdi>
commodityCodeVOEC	-	må fylles ut	må fylles ut	må fylles ut
harmonizedSystemSubheadingCode	-	<må ha verdi>	<må ha verdi>	<må ha verdi>
additionalFiscalReferences	-	må fylles ut	må fylles ut	må fylles ut
vatIdentificationNumber	-	<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_TRA_DOCUMENTATION

WAREHOUSE_RELEASE

Felt	Kodeverk	Variant 9	Variant 10	Variant 11		Variant 18
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. Transittering er foregående prosedyre og skal fullføres ved grensepassering.		Forsendelse som skal godsregistreres ved grensepassering Eksport er foregående prosedyre og skal klareres ved grensepassering.
Aktuelle transportmåter		Bil på ferge, fly	Bil på vei	Bil på vei/ferge, tog		Bil på vei
importProcedure		må fylles ut	må fylles ut	må fylles ut		må fylles ut
importProcedure	ImportProcedure	WAREHOUSE_RELEASE	WAREHOUSE_RELEASE	WAREHOUSE_RELEASE		WAREHOUSE_RELEASE
outgoingProcedure	OutgoingProcedure	-	EXP	TRA		EXP
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:
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 = GONU
declarantNumber	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-	-
declarationDate	-	<må ha verdi>	<må ha verdi>	<må ha verdi>	-	-
sequenceNumber	-	<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_TRA_DOCUMENTATION		INCOMPLETE_EXP_DOCUMENTATION

COLLECTIVE_RELEASE

Felt	Kodeverk	Variant 12	Variant 13	Variant 14
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. Transittering er foregående prosedyre og skal fullføres ved grensepassering.
Aktuelle transportmåter		Bil på ferge, fly	Bil på vei	Bil på vei/ferge, tog
importProcedure		må fylles ut	må fylles ut	må fylles ut
importProcedure	ImportProcedure	COLLECTIVE_RELEASE	COLLECTIVE_RELEASE	COLLECTIVE_RELEASE
outgoingProcedure	OutgoingProcedure	-	EXP	TRA
hasOutgoingProcedure	-	false	true	true
previousDocuments		-	-	OG liste må ha ett innslag av type:
referenceNumber	-	-	-	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	-		må være = N820
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_EXP_DOCUMENTATION	INCOMPLETE_TRA_DOCUMENTATION

DOCUMENTS_NOT_OBLIGED_RELEASE

Felt	Kodeverk	Variant 15	Variant 16	Variant 17
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. Transittering er foregående prosedyre og skal fullføres ved grensepassering.
Aktuelle transportmåter		Bil på ferge, fly	Bil på vei	Bil på vei/ferge, tog
importProcedure		må fylles ut	må fylles ut	må fylles ut
importProcedure	ImportProcedure	DOCUMENTS_NOT_OBLIGED_RELEASE	DOCUMENTS_NOT_OBLIGED_RELEASE	DOCUMENTS_NOT_OBLIGED_RELEASE
outgoingProcedure	OutgoingProcedure	-	EXP	TRA
hasOutgoingProcedure	-	false	true	true
previousDocuments		-	-	OG liste må ha ett innslag av type:
referenceNumber	-	-	-	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	-		må være = N820
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_EXP_DOCUMENTATION	INCOMPLETE_TRA_DOCUMENTATION