Hvordan fylle ut melding om forsendelse, tog

Grensesnittbeskrivelse

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

POST https://<env>/api/movement/rail/v1/transport
POST https://<env>/api/movement/rail/v1/master-consignment
POST https://<env>/api/movement/rail/v1/house-consignment

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

GET https://<env>/api/movement/rail/status/v1/transport/validation-status/{requestId}
GET https://<env>/api/movement/rail/status/v1/master-consignment/validation-status/{requestId}
GET https://<env>/api/movement/rail/status/v1/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-rail-api

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

Se API-dokumentasjon her.

API: movement-rail-query-api

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

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

TRANSIT_IMPORT / TRANSIT_RELEASE

Felt	Kodeverk	Variant 4
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
Aktuelle transportmåter		Bil på vei/ferge, tog
importProcedure		må fylles ut
importProcedure	ImportProcedure	TRANSIT_IMPORT
outgoingProcedure	OutgoingProcedure	TRA
hasOutgoingProcedure	-	true
previousDocuments		liste må ha ett innslag av type:
referenceNumber	-	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	må være = N820
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_TRA_DOCUMENTATION

IMMEDIATE_RELEASE_VOEC

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

WAREHOUSE_RELEASE

Felt	Kodeverk	Variant 11
Beskrivelse av tollprosedyre og prosedyre fram til grensen		Det er på forhånd levert deklarasjon for innlegg på tollager. Transittering er foregående prosedyre og skal fullføres ved grensepassering.
Aktuelle transportmåter		Bil på vei/ferge, tog
importProcedure		må fylles ut
importProcedure	ImportProcedure	WAREHOUSE_RELEASE
outgoingProcedure	OutgoingProcedure	TRA
hasOutgoingProcedure	-	true
previousDocuments		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 = N820
declarantNumber	-	<må ha verdi>	-
declarationDate	-	<må ha verdi>	-
sequenceNumber	-	<må ha verdi>	-
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_CUDE_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION

COLLECTIVE_RELEASE

Felt	Kodeverk	Variant 14
Beskrivelse av tollprosedyre og prosedyre fram til grensen		Forsendelse som skal samlefortolles etter grensepassering. Transittering er foregående prosedyre og skal fullføres ved grensepassering.
Aktuelle transportmåter		Bil på vei/ferge, tog
importProcedure		må fylles ut
importProcedure	ImportProcedure	COLLECTIVE_RELEASE
outgoingProcedure	OutgoingProcedure	TRA
hasOutgoingProcedure	-	true
previousDocuments		liste må ha ett innslag av type:
referenceNumber	-	<må ha verdi>
typeOfReference	CL228, AdditionalPreviousDocumentType	må være = N820
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_TRA_DOCUMENTATION

DOCUMENTS_NOT_OBLIGED_RELEASE

Field	Code list	Variant 17
Description of customs procedure and procedure up to the border		Shipments that are not subject to declaration obligation under § 4-1-29 of the Goods Traffic Regulations. Transit is the preceding procedure and must be completed at the border crossing.
Applicable modes of transport		Car on road/ferry, train
importProcedure		must be filled out
importProcedure	ImportProcedure	DOCUMENTS_NOT_OBLIGED_RELEASE
outgoingProcedure	OutgoingProcedure	TRA
hasOutgoingProcedure	-	true
previousDocuments		list must have one entry of type:
referenceNumber	-	<must have value>
typeOfReference	CL228, AdditionalPreviousDocumentType	must be = N820
declarantNumber	-	-
declarationDate	-	-
sequenceNumber	-	-
exportFromEU		-
exportId	-	-
typeOfExport	TB_Eksporttype	-
Possible validation messages if the information is not complete. We assume that the missing information is submitted no later than upon arrival at the border.	IncompleteDocumentationReason	INCOMPLETE_TRA_DOCUMENTATION