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 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	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
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

Felt	Kodeverk	Variant 5
Beskrivelse av tollprosedyre og prosedyre fram til grensen		Transittering er startet opp i annet land. Fullføring av transitteringen skal utføres av autorisert mottaker.
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 7	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. Transittering er foregående prosedyre og skal fullføres ved grensepassering.
importProcedure		må fylles ut	må fylles ut
importProcedure	ImportProcedure	IMMEDIATE_RELEASE_VOEC	IMMEDIATE_RELEASE_VOEC
outgoingProcedure	OutgoingProcedure	-	TRA
hasOutgoingProcedure	-	false	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.
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 15
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)
importProcedure		må fylles ut
importProcedure	ImportProcedure	COLLECTIVE_RELEASE
outgoingProcedure	OutgoingProcedure	-
hasOutgoingProcedure	-	false
previousDocuments		-
referenceNumber	-	-
typeOfReference	CL228, AdditionalPreviousDocumentType	-
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

DOCUMENTS_NOT_OBLIGED_RELEASE

Field	Code list	Variant 17
Beskrivelse av tollprosedyre og prosedyre fram til grensen		Forsendelse som ikke har deklarasjonsplikt etter § 4-1-29 i vareførselsforskriften. Transittering er foregående prosedyre og skal fullføres ved grensepassering.
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

ATA_CARNET / TIR_CARNET

Felt	Kodeverk	Variant 27	Variant 28
Beskrivelse av tollprosedyre og prosedyre fram til grensen		ATA-Carnet	TIR-Carnet
importProcedure		må fylles ut	må fylles ut
importProcedure	ImportProcedure	ATA_CARNET	TIR_CARNET
outgoingProcedure	OutgoingProcedure	-	-
hasOutgoingProcedure	-	false	false
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 = N955	må være = N952
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