How to fill out a shipment report, road/ferry

Interface description

The services are made available as REST services over HTTPS, with data in 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}

where

<env> is replaced with
- api.toll.no for production
- api-test.toll.no for playground (testing environment)
{requestId} is replaced with the reference returned by POST/PUT/DELETE calls
{MRN} is replaced with the reference returned from ".../validation-status..." endpoints.

If you discover security issues in our solutions, please contact us; see here for info

API Services

API: movement-road-api-v2

To use the service, the scope for authentication against Maskinporten must be set to toll:movement/road/v2

See API documentation here.

API: movement-road-query-api-v2

To use the service, the scope for authentication against Maskinporten must be set to toll:movement/road/v2

See API documentation here.

API: movement-presentation-api

See API documentation here.

API: movement-routing-api

See API documentation here.

IMMEDIATE_RELEASE_IMPORT (Transition to free circulation at border crossing)

Field	Code list	Variant 1	Variant 2	Variant 3		Variant 4
Description of customs procedure and procedure up to the border		A declaration for release for free circulation has been submitted in advance. Another customs authority has cleared the previous procedure (e.g., Danish customs before the ferry to Larvik)	A declaration for release for free circulation has been submitted in advance. EU/Swedish export is the previous procedure and must be cleared at the border crossing	A declaration for release for free circulation has been submitted in advance. Export and transit are the previous procedures and must be completed at the border crossing.		A declaration for release for free circulation has been submitted in advance. Transit is the previous procedure and must be completed at the border crossing.
importProcedure		must be filled out	must be filled out	must be filled out		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		list must have one entry of type:	list must have one entry of type:	list must have one entry of type:	AND list must have one entry of type:	list must have one entry of type:	AND list must have one entry of type:
referenceNumber	-	-	-	-	<must have value>	-	<must have value>
typeOfReference	CL228, AdditionalPreviousDocumentType	must be = CUDE	must be = CUDE	must be = CUDE	must be = N820	må være = CUDE	må være = N820
declarantNumber	-	<must have value>	<must have value>	<must have value>	-	<må ha verdi>	-
declarationDate	-	<must have value>	<must have value>	<must have value>	-	<må ha verdi>	-
sequenceNumber	-	<must have value>	<must have value>	<must have value>	-	<må ha verdi>	-
exportFromEU		-	list must have AT LEAST one entry of type:	list must have AT LEAST one entry of type:		-
exportId	-	-	<must have value>	<må ha verdi>		-
typeOfExport	TB_ExportType	-	must be one of [AES_EXPORT, EUEIR_EXPORT]	må være en av [AES_EXPORT, EUEIR_EXPORT]		-
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_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
(Transit to be completed at unloading/transit to be started at the border)

Field	Code list	Variant 5	Variant 6
Description of customs procedure and procedure up to the border		Transit has started in another country. Completion of the transit must be performed upon unloading. At the border crossing, only the border crossing should be registered in NCTS	Transit should start at the border. EU/Swedish export is the previous procedure and must be cleared at the border crossing
importProcedure		must be filled out	must be filled out
importProcedure	ImportProcedure	TRANSIT_IMPORT	TRANSIT_RELEASE
outgoingProcedure	OutgoingProcedure	TRA	EXP
hasOutgoingProcedure	-	true	true
previousDocuments		list must have one entry of type:	list must have one entry of type:
referenceNumber	-	<must have value>	<must have value>
typeOfReference	CL228, AdditionalPreviousDocumentType	must be = N820	must be = RETR
declarantNumber	-	-	-
declarationDate	-	-	-
sequenceNumber	-	-	-
exportFromEU		-	list must have AT LEAST one entry of type:
exportId	-	-	<must have value>
typeOfExport	TB_ExportType	-	must be one of [AES_EXPORT, EUEIR_EXPORT]
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	INCOMPLETE_TRA_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION

IMMEDIATE_RELEASE_VOEC (VOEC shipments released at border crossing)

Felt	Kodeverk	Variant 7	Variant 8	Variant 9	Variant 10
Description of customs procedure and procedure up to the border		VOEC shipments. Another customs authority has cleared the previous procedure, or the value is below the threshold for export requirements.	VOEC shipments. EU/Swedish export is the previous procedure and must be cleared at the border crossing.	VOEC shipments. Export and transit are the previous procedures and must be completed at the border crossing.	VOEC shipments. VOEC shipment arriving with transit that must be completed at the border.
importProcedure		must be filled out	must be filled out	must be filled out	must be filled out
importProcedure	ImportProcedure	IMMEDIATE_RELEASE_VOEC	IMMEDIATE_RELEASE_VOEC	IMMEDIATE_RELEASE_VOEC	IMMEDIATE_RELEASE_VOEC
outgoingProcedure	OutgoingProcedure	-	EXP	TRE	TRA
hasOutgoingProcedure	-	-	true	true	true
previousDocuments		-	-	list must have one entry of type:	list must have one entry of type:
referenceNumber	-	-	-	<must have value>	<must have value>
typeOfReference	CL228, AdditionalPreviousDocumentType	-	-	must be = N820	must be = N820
declarantNumber	-	-	-	-	-
declarationDate	-	-	-	-	-
sequenceNumber	-	-	-	-	-
exportFromEU		-	list must have AT LEAST one entry of type:	list must have AT LEAST one entry of type:	-
exportId	-	-	<must have value>	-	-
typeOfExport	TB_ExportType	-	must be one of [AES_EXPORT, EUEIR_EXPORT]	-	-
goodsItem	-	must be filled out	must be filled out	must be filled out	must be filled out
itemAmountInvoicedVOEC	-	must be filled out	must be filled out	must be filled out	must be filled out
value	-	<must have value>	<must have value>	<must have value>	<must have value>
numberOfItems	-	<must have value>	<must have value>	<must have value>	<must have value>
commodityCodeVOEC	-	must be filled out	must be filled out	must be filled out	must be filled out
harmonizedSystemSubheadingCode	-	<must have value>	<must have value>	<must have value>	<must have value>
additionalFiscalReferences	-	must be filled out	must be filled out	must be filled out	must be filled out
vatIdentificationNumber	-	<must have value>	<must have value>	<must have value>	<must have value>
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_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 (Entry into customs warehouse)

Note: This code should be used when a customs warehouse entry declaration has been submitted before the border crossing.
Until 01.09.2026 it can also be used for goods that are driven directly.

Field	Code list	Variant 11	Variant 12	Variant 13		Variant 14		Variant 23	Variant 24	Variant 25		Variant 26
Description of customs procedure and procedure up to the border		A declaration for warehouse entry has been submitted in advance. Another customs authority has cleared the previous procedure (e.g., Danish customs before the ferry to Larvik)	A declaration for warehouse entry has been submitted in advance. EU/Swedish export is the previous procedure and must be cleared at the border crossing	A declaration for warehouse entry has been submitted in advance. Export and transit are the previous procedures and must be completed at the border crossing.		A declaration for warehouse entry has been submitted in advance. Transit is the previous procedure and must be completed at the border crossing.		Shipment to be goods registered at the border crossing. Transitional arrangement until 01.09.2026, see Digitoll with goods number - Norwegian Customs (in Norwegian)	Shipment to be goods registered at the border crossing. Transitional arrangement until 01.09.2026, see Digitoll with goods number - Norwegian Customs (in Norwegian) Export is the previous procedure and must be cleared at the border crossing.	Shipment to be goods registered at the border crossing. Transitional arrangement until 01.09.2026, see Digitoll with goods number - Norwegian Customs Transit and EU export are the previous procedures and must be completed at the border crossing.		Shipment to be goods registered at the border crossing. Transitional arrangement until 01.09.2026, see Digitoll with goods number - Norwegian Customs Transit is the previous procedure and must be completed at the border crossing.
importProcedure		must be filled out	must be filled out	must be filled out		must be filled out		must be filled out	must be filled out	must be filled out		must be filled out
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		list must have one entry of type:	list must have one entry of type:	list must have one entry of type:	AND list must have one entry of type:	list must have one entry of type:	AND list must have one entry of type:	AND list must have one entry of type:	AND list must have one entry of type:	list must have one entry of type:	AND list must have one entry of type:	list must have one entry of type:	AND list must have one entry of type:
referenceNumber	-	-	-	-	<must have value>	-	<must have value>	<must have value>	<must have value>	<must have value>	<must have value>	<must have value>	<must have value>
typeOfReference	CL228, AdditionalPreviousDocumentType	must be = CUDE	must be = CUDE	must be = CUDE	must be = N820	må være = CUDE	must be = N820	must be = GONU	must be = N820	must be = N820	must be = GONU	must be = GONU	must be = N820
declarantNumber	-	<must have value>	<must have value>	<must have value>	-	<must have value>	-	-	-	-	-	-	-
declarationDate	-	<must have value>	<must have value>	<must have value>	-	<must have value>	-	-	-	-	-	-	-
sequenceNumber	-	<must have value>	<must have value>	<must have value>	-	<must have value>	-	-	-	-	-	-	-
exportFromEU		-	list must have AT LEAST one entry of type:	list must have AT LEAST one entry of type:		-		-	list must have AT LEAST one entry of type:	-		list must have AT LEAST one entry of type:
exportId	-	-	<must have value>	<must have value>		-		-	<must have value>	-		<must have value>
typeOfExport	TB_ExportType	-	must be one of [AES_EXPORT, EUEIR_EXPORT]	must be one of [AES_EXPORT, EUEIR_EXPORT]		-		-	must be one of [AES_EXPORT, EUEIR_EXPORT]	-		must be one of [AES_EXPORT, EUEIR_EXPORT]
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_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 (Goods to be cleared collectively)

Field	Code list	Variant 15	Variant 16	Variant 17	Variant 18
Description of customs procedure and procedure up to the border		Shipment to be collectively cleared after border crossing. Another customs authority has cleared the previous procedure (e.g., Danish customs before the ferry to Larvik)	Shipment to be collectively cleared after border crossing. EU/Swedish export is the previous procedure and must be cleared at the border crossing	Shipment to be collectively cleared after border crossing. Export and transit are the previous procedures and must be completed at the border crossing.	Shipment to be collectively cleared after border crossing. Transit is the previous procedure and must be completed at the border crossing.
importProcedure		must be filled out	must be filled out	must be filled out	must be filled out
importProcedure	ImportProcedure	COLLECTIVE_RELEASE	COLLECTIVE_RELEASE	COLLECTIVE_RELEASE	COLLECTIVE_RELEASE
outgoingProcedure	OutgoingProcedure	-	EXP	TRE	TRA
hasOutgoingProcedure	-	false	true	true	true
previousDocuments		-	-	AND list must have one entry of type:	AND list must have one entry of type:
referenceNumber	-	-	-	<must have value>	<must have value>
typeOfReference	CL228, AdditionalPreviousDocumentType	-		must be = N820	must be = N820
declarantNumber	-	-		-	-
declarationDate	-	-		-	-
sequenceNumber	-	-		-	-
exportFromEU		-	list must have AT LEAST one entry of type:	list must have AT LEAST one entry of type:	-
exportId	-	-	<must have value>	<must have value>	-
typeOfExport	TB_ExportType	-	must be one of [AES_EXPORT, EUEIR_EXPORT]	must be one of [AES_EXPORT, EUEIR_EXPORT]	-
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_EXP_DOCUMENTATION	INCOMPLETE_EXP_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION	INCOMPLETE_TRA_DOCUMENTATION

DOCUMENTS_NOT_OBLIGED_RELEASE

Field	Code list	Variant 19	Variant 20	Variant 21
Description of customs procedure and procedure up to the border		Shipment that is not subject to declaration obligation under § 4-1-29 of the Goods Traffic Regulations. Another customs authority has cleared the previous procedure (e.g., Danish customs before the ferry to Larvik)	Shipment that is not subject to declaration obligation under § 4-1-29 of the Goods Traffic Regulations. EU/Swedish export is the previous procedure and must be cleared at the border crossing	Shipment that is not subject to declaration obligation under § 4-1-29 of the Goods Traffic Regulations. Transit is the previous procedure and must be completed at the border crossing.
importProcedure		must be filled out	must be filled out	must be filled out
importProcedure	ImportProcedure	DOCUMENTS_NOT_OBLIGED_RELEASE	DOCUMENTS_NOT_OBLIGED_RELEASE	DOCUMENTS_NOT_OBLIGED_RELEASE
outgoingProcedure	OutgoingProcedure	-	EXP	TRA
hasOutgoingProcedure	-	false	true	true
previousDocuments		-	-	AND list must have one entry of type:
referenceNumber	-	-	-	<must have value>
typeOfReference	CL228, AdditionalPreviousDocumentType	-		must be = N820
declarantNumber	-	-		-
declarationDate	-	-		-
sequenceNumber	-	-		-
exportFromEU		-	list must have AT LEAST one entry of type:	-
exportId	-	-	<must have value>	-
typeOfExport	TB_ExportType	-	must be one of [AES_EXPORT, EUEIR_EXPORT]	-
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_EXP_DOCUMENTATION	INCOMPLETE_TRA_DOCUMENTATION

ATA_CARNET / TIR_CARNET / NATO_FORM_302

Field	Code List	Variant 27	Variant 28	Variant 29
Description of customs procedure and procedure up to the border		ATA-Carnet	TIR-Carnet	NATO Formular 302
importProcedure		must be filled out	must be filled out	must be filled out
importProcedure	ImportProcedure	ATA_CARNET	TIR_CARNET	NATO_FORM_302
outgoingProcedure	OutgoingProcedure	-	-	-
hasOutgoingProcedure	-	false	false	false
previousDocuments		AND list must have one entry of type:	AND list must have one entry of type:	AND list must have one entry of type:
referenceNumber	-	<must have value>	<must have value>	<must have value>
typeOfReference	CL228, AdditionalPreviousDocumentType	must be = N955	must be = N952	must be = C624
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_DOCUMENTATION	INCOMPLETE_DOCUMENTATION	INCOMPLETE_DOCUMENTATION

CUSTOMS_DECLARATION (Customs Declaration)

Field	Code list	Variant 30	Variant 31	Variant 32		Variant 33
Description of customs procedure and procedure up to the border		Shipment with reference to Tvinn declaration. Can be used regardless of whether the declaration is release for free circulation or entry into customs warehouse (Measure 7) No preceding procedure	Shipment with reference to Tvinn declaration. Can be used regardless of whether the declaration is release for free circulation or entry into customs warehouse (Measure 7) Export is the preceding procedure and shall be cleared at border crossing.	Shipment with reference to Tvinn declaration. Can be used regardless of whether the declaration is release for free circulation or entry into customs warehouse (Measure 7) Transit is the preceding procedure and shall be concluded at border crossing.		Shipment with reference to Tvinn declaration. Can be used regardless of whether the declaration is release for free circulation or entry into customs warehouse (Measure 7) Transit and export are preceding procedures and shall be concluded at border crossing.
importProcedure		must be filled in	must be filled in	must be filled in		must be filled in
importProcedure	ImportProcedure	CUSTOMS_DECLARATION	CUSTOMS_DECLARATION	CUSTOMS_DECLARATION		CUSTOMS_DECLARATION
outgoingProcedure	OutgoingProcedure	-	EXP	TRA		TRE
hasOutgoingProcedure	-	false	true	true		true
previousDocuments		list must have one entry of type:	list must have one entry of type:	list must have one entry of type:	AND list must have one entry of type:	list must have one entry of type:	AND list must have one entry of type:
referenceNumber	-	-	-	-	<must have value>	-	<must have value>
typeOfReference	CL228, AdditionalPreviousDocumentType	must be = CUDE	must be = CUDE	must be = CUDE	must be = N820	must be = CUDE	must be = N820
declarantNumber	-	<must have value>	<must have value>	<must have value>	-	<must have value>	-
declarationDate	-	<must have value>	<must have value>	<must have value>	-	<must have value>	-
sequenceNumber	-	<must have value>	<must have value>	<must have value>	-	<must have value>	-
exportFromEU		-	list must have AT LEAST one entry of type:	-		list must have AT LEAST one entry of type:
exportId	-	-	<must have value>	-		<must have value>
typeOfExport	TB_Eksporttype	-	must be one of [AES_EXPORT, EUEIR_EXPORT]	-		must be one of [AES_EXPORT, EUEIR_EXPORT]
Possible validation messages if the information is incomplete. We assume that the missing information will be submitted at the latest upon arrival at the border.	IncompleteDocumentationReason	INCOMPLETE_CUDE_DOCUMENTATION	INCOMPLETE_CUDE_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION	INCOMPLETE_CUDE_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION		INCOMPLETE_CUDE_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION

How to fill out a shipment report, road/ferry

Interface description

API Services

API: movement-road-api-v2

API: movement-road-query-api-v2

API: movement-presentation-api

API: movement-routing-api

IMMEDIATE_RELEASE_IMPORT (Transition to free circulation at border crossing)

TRANSIT_IMPORT / TRANSIT_RELEASE (Transit to be completed at unloading/transit to be started at the border)

IMMEDIATE_RELEASE_VOEC (VOEC shipments released at border crossing)

WAREHOUSE_RELEASE (Entry into customs warehouse)

Note: This code should be used when a customs warehouse entry declaration has been submitted before the border crossing. Until 01.09.2026 it can also be used for goods that are driven directly.

COLLECTIVE_RELEASE (Goods to be cleared collectively)

DOCUMENTS_NOT_OBLIGED_RELEASE

ATA_CARNET / TIR_CARNET / NATO_FORM_302

CUSTOMS_DECLARATION (Customs Declaration)

TRANSIT_IMPORT / TRANSIT_RELEASE
(Transit to be completed at unloading/transit to be started at the border)

Note: This code should be used when a customs warehouse entry declaration has been submitted before the border crossing.
Until 01.09.2026 it can also be used for goods that are driven directly.