How to fill out a shipment report, Air

Interface description

The services are made available as REST services over HTTPS, with data in JSON format.

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

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

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

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

See API documentation here.

API: movement-air-query-api

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

See API documentation here.

API: movement-presentation-api

See API documentation here.

API: movement-routing-api

See API documentation here.

IMMEDIATE_RELEASE_IMPORT

Field	Code list	Variant 1
Description of customs procedure and procedure up to the border		A declaration for transition to free disposal has been submitted in advance. Another customs authority has cleared the previous procedure (e.g., Danish customs before ferry to Larvik)
Applicable modes of transport where this combination is valid		Plane, train, car on ferry
importProcedure		must be filled out
importProcedure	ImportProcedure	IMMEDIATE_RELEASE_IMPORT
outgoingProcedure	OutgoingProcedure	-
hasOutgoingProcedure	-	false
previousDocuments		list must have one entry of type:
referenceNumber	-	-
typeOfReference	CL228, AdditionalPreviousDocumentType	must be = CUDE
declarantNumber	-	<must have value>
declarationDate	-	<must have value>
sequenceNumber	-	<must have value>
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_CUDE_DOCUMENTATION

IMMEDIATE_RELEASE_VOEC

Field	Code list	Variant 6
Description of customs procedure and procedure up to the border		VOEC shipments. Another customs authority has cleared the previous procedure, or value below the threshold for export requirements.
Applicable modes of transport		Car on road/ferry, train, plane
importProcedure		must be filled out
importProcedure	ImportProcedure	IMMEDIATE_RELEASE_VOEC
outgoingProcedure	OutgoingProcedure	-
hasOutgoingProcedure	-	-
previousDocuments		-
referenceNumber	-	-
typeOfReference	CL228, AdditionalPreviousDocumentType	-
declarantNumber	-	-
declarationDate	-	-
sequenceNumber	-	-
exportFromEU		-
exportId	-	-
typeOfExport	TB_Eksporttype	-
goodsItem	-	must be filled out
itemAmountInvoicedVOEC	-	must be filled out
value	-	<must have value>
numberOfItems	-	<must have value>
commodityCodeVOEC	-	must be filled out
harmonizedSystemSubheadingCode	-	<must have value>
additionalFiscalReferences	-	must be filled out
vatIdentificationNumber	-	<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

WAREHOUSE_RELEASE

Field	Code list	Variant 9
Description of customs procedure and procedure up to the border		A declaration for entry into a customs warehouse has been submitted in advance. Another customs authority has cleared the previous procedure (e.g., Danish customs before the ferry to Larvik)
Applicable modes of transport		Car on ferry, plane
importProcedure		must be filled out
importProcedure	ImportProcedure	WAREHOUSE_RELEASE
outgoingProcedure	OutgoingProcedure	-
hasOutgoingProcedure	-	false
previousDocuments		list must have one entry of type:
referenceNumber	-	-
typeOfReference	CL228, AdditionalPreviousDocumentType	must be = CUDE
declarantNumber	-	<must have value>
declarationDate	-	<must have value>
sequenceNumber	-	<must have value>
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_CUDE_DOCUMENTATION

COLLECTIVE_RELEASE

Field	Code list	Variant 12
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)
Applicable modes of transport		Car on ferry, plane
importProcedure		must be filled out
importProcedure	ImportProcedure	COLLECTIVE_RELEASE
outgoingProcedure	OutgoingProcedure	-
hasOutgoingProcedure	-	false
previousDocuments		-
referenceNumber	-	-
typeOfReference	CL228, AdditionalPreviousDocumentType	-
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

DOCUMENTS_NOT_OBLIGED_RELEASE

Field	Code list	Variant 15
Description of customs procedure and procedure up to the border		Shipment that is not subject to declaration obligation under § 4-1-29 of the customs regulations. Another customs authority has cleared the previous procedure (e.g., Danish customs before the ferry to Larvik)
Applicable modes of transport		Car on ferry, plane
importProcedure		must be filled out
importProcedure	ImportProcedure	DOCUMENTS_NOT_OBLIGED_RELEASE
outgoingProcedure	OutgoingProcedure	-
hasOutgoingProcedure	-	false
previousDocuments		-
referenceNumber	-	-
typeOfReference	CL228, AdditionalPreviousDocumentType	-
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

Field	Code list	Variant 15
Description of customs procedure and procedure up to the border		Shipment that is not subject to declaration obligation under § 4-1-29 of the customs regulations. Another customs authority has cleared the previous procedure (e.g., Danish customs before the ferry to Larvik)
Applicable modes of transport		Car on ferry, plane
importProcedure		must be filled out
importProcedure	ImportProcedure	DOCUMENTS_NOT_OBLIGED_RELEASE
outgoingProcedure	OutgoingProcedure	-
hasOutgoingProcedure	-	false
previousDocuments		-
referenceNumber	-	-
typeOfReference	CL228, AdditionalPreviousDocumentType	-
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