Transaction JSON Description

The Transaction JSON is the standardized interface used by the source system to communicate business and operational data to the customs management system. It contains all relevant information relating to a logistics activity, such as the movement of goods, transport details, involved parties, storage locations, and the products or parcels that are part of the transaction.

The information contained in the Transaction JSON serves as the primary input for the creation of customs declarations and other compliance-related processes. Each message must accurately represent the underlying business transaction and include all data required to determine the correct customs treatment of the goods.

The quality, completeness, and timeliness of the data provided are critical. Incorrect, incomplete, or delayed information may result in inaccurate customs declarations, non-compliance with customs legislation, delays in the supply chain, financial penalties, or increased audit risks.

It is therefore the responsibility of the source system and the data provider to ensure that:

• all mandatory data elements are populated correctly;
• the information reflects the actual business transaction and physical movement of the goods;
• product and parcel details, including commodity classifications, origin, quantities, and supporting documents, are accurate and up to date;
• changes affecting the transaction are communicated promptly to the customs management system.

By providing reliable and timely Transaction JSON messages, organizations can support compliant customs processes, minimize operational risks, and ensure efficient processing of import, export, transit, and storage activities.

1. Transaction Header

JSON Path	Business Name	Description	Mandatory	Allowed Values	Example
sourceApplication	Source System	Unique identifier of the source application	Yes	ATLAS, CTA	ATLAS
terminal	Terminal	Unique identifier of the terminal	Yes	-	ETT
reference	Movement Reference	Unique local reference for the declaration request	Yes	-	PR_ACTI_AC10007466
displayReference	Display Reference	Display value of the reference	No	-	AC 007 466
taxCountry	Customs Country	Country where tax is due	Yes	CMS Country Codes	NL
cmsReference	CMS Reference	Reference to an existing CMS transaction	Conditional	-	UUID
overrideCheckAlert	Override Indicator	Override validation warnings	No	Y, N	N
userId	User ID	User invoking the transaction service	No	-	USER001
presentationDateTime	Presentation Date Time	Transaction timestamp in UTC	Yes	ISO-8601	2026-05-30T20:59:17Z
normalProcedure	Normal Procedure	Apply Normal Customs Procedure	No	Y, N	N

2. Customs Product

customsProduct.customsValue.invoice

JSON Path	Description	Mandatory
reference	Invoice reference	Conditional
amount	Invoice value	Conditional
currency	Invoice currency	Conditional
incotermCode	Applicable Incoterm	Conditional
elementsToInclude.freightCostsAmount	Freight costs	Conditional
elementsToInclude.insuranceCostsAmount	Insurance costs	Conditional

Allowed Incoterms

Value
CIF
FOB

Allowed Currencies

Value
USD
EUR

customsProduct.customsValue.marketValue

JSON Path	Description
amount	Market value of goods
currency	Currency

customsProduct.commodity

JSON Path	Description
code	10-digit TARIC code
description	Commercial product description
reference	External product reference

3. Activities

JSON Path	Description	Mandatory
activities.reference	Activity reference	Yes
activities.displayReference	Display reference	No
activities.activityType	Activity type	Yes
activities.serviceType	Service type	Conditional
activities.nominationReference	Nomination reference	Conditional
activities.relatedReference	Related activity reference	Conditional
activities.executedByExternalCustomsBroker	External broker indicator	No

Activity Types

Allowed Values
MOVEMENT
SERVICE

Service Types

Allowed Values
IMPORT
REBRAND
RENAME
DEPARTURE
ADMINISTRATIVE_STOCK_TRANSFER
TAKE_IN
SHIFTING
COMMODITY_CODE_CORRECTION

4. Medium

JSON Path	Description
medium.type	Source / destination side of activity

Allowed Values

Value	Meaning
FROM_STORAGE_UNIT	Source storage location
TO_STORAGE_UNIT	Destination storage location
IN_STORAGE_UNIT	Activity within same storage unit

5. Storage Unit

JSON Path	Description
storageUnit.storageUnitReference	Storage Unit Identifier

6. Visit Information

JSON Path	Description
visit.visitReference	Visit identifier
visit.transportMeansReference	Vessel name / Truck registration
visit.transportMeansTypeCode	Transport means type
visit.transportMeansNationalityCode	Nationality of transport means
visit.changedTransportArrangement	Changed arrangement indicator

Transport Means Types

Value
RA
RO
VES
BAR
PI
TANK

7. Tank Information

JSON Path	Description
tank.tankName	Tank name

8. Parcel Information

JSON Path	Description
parcels.reference	Unique parcel identifier
parcels.parentReference	Parent parcel
parcels.firstTimeArrival	First arrival under license
parcels.inwardProcessingFlag	Subject to inward processing
parcels.commercialPolicyMeasureFlag	Commercial Policy Measures applicable
parcels.exceptionDocument	Exception document
customsStatus	Customs status
unNumber	Dangerous Goods UN number

Flag Values

Value
Y
N

Customs Status Values

Value
BONDED
EXCISE
DOMESTIC

9. Parties

Customer

JSON Path
parties.customer.reference
parties.customer.name
parties.customer.language
parties.customer.eori
parties.customer.vatNumber
parties.customer.cbsCode
parties.customer.address.streetName
parties.customer.address.houseNumber
parties.customer.address.postalCode
parties.customer.address.cityName
parties.customer.address.countryCode

Consignee

JSON Path
parties.consignee.reference
parties.consignee.name
parties.consignee.language
parties.consignee.eori
parties.consignee.exciseNumber
parties.consignee.registeredConsigneeFlag
parties.consignee.monthlyStatementApproval
parties.consignee.cbsCode
parties.consignee.address.*

Consignor

JSON Path
parties.consignor.reference
parties.consignor.name
parties.consignor.language
parties.consignor.eori
parties.consignor.exciseNumber
parties.consignor.cbsCode
parties.consignor.address.*

Place Of Dispatch Trader

JSON Path
parties.placeOfDispatchTrader.reference
parties.placeOfDispatchTrader.name
parties.placeOfDispatchTrader.language
parties.placeOfDispatchTrader.eori
parties.placeOfDispatchTrader.referenceOfTaxWarehouse
parties.placeOfDispatchTrader.locationName
parties.placeOfDispatchTrader.cbsCode
parties.placeOfDispatchTrader.address.*

Delivery Place Trader

JSON Path
parties.deliveryPlaceTrader.reference
parties.deliveryPlaceTrader.name
parties.deliveryPlaceTrader.language
parties.deliveryPlaceTrader.eori
parties.deliveryPlaceTrader.referenceOfTaxWarehouse
parties.deliveryPlaceTrader.locationName
parties.deliveryPlaceTrader.cbsCode
parties.deliveryPlaceTrader.address.*

Exporter

JSON Path
parties.exporter.reference
parties.exporter.name
parties.exporter.language
parties.exporter.eori
parties.exporter.cbsCode
parties.exporter.address.*

Seller

JSON Path
parties.seller.reference
parties.seller.name
parties.seller.language
parties.seller.eori
parties.seller.cbsCode
parties.seller.address.*

10. Goods Location

JSON Path	Description
location.language	Location language
location.address.streetName	Street
location.address.houseNumber	House number
location.address.postalCode	Postal code
location.address.cityName	City
location.address.countryCode	Country
location.cbsCode	CBS code
location.locationName	Location name

11. Country Information

JSON Path	Description
destinationCountryCode	Destination country
dispatchCountryCode	Dispatch country

Exit Office

JSON Path	Description
exitOffice.reference	CMS reference
exitOffice.name	Exit office name
exitOffice.id	Customs office code (CL294)

Origin

JSON Path	Description
origin.type	Origin type
origin.countryCode	Origin country

Origin Types

Value
PREFERENTIAL
NON-PREFERENTIAL

12. Commodity

JSON Path	Description
commodity.code	10-digit TARIC code
commodity.description	Commercial description
commodity.reference	Product reference

13. Cargo Documents

JSON Path	Description
cargoDocuments.type	Document type
cargoDocuments.reference	Document reference

Supported Document Types

Value
MANIFEST_INFO
B_L
AGRIM
AT_R
EUR_1
EUR_MED
INVOICE
ORIG_DECL
INF3
STAT_ON_ORIG
T2L_F
T2L
E_AD
T1
T2
EVIDENCE

14. Quantities

JSON Path	Description
quantities.type	PLANNED or ACTUAL
quantities.kgv	Kilograms in vacuum
quantities.kga	Kilograms in air
quantities.gmv	Kilograms in vacuum (decimal)
quantities.gma	Kilograms in air (decimal)
quantities.l15	Litres at 15°C
quantities.l20	Litres at 20°C
quantities.ml5	Litres (decimal precision)
quantities.alcPerc	Alcohol percentage

Quantity Types

Value
PLANNED
ACTUAL

15. Density

JSON Path	Description
density.value	Density value
density.uom	Density reference basis

Density UOM

Value
D15
D1A

16. Compliance-Critical Fields

Field	Compliance Impact
commodity.code	Duty determination, restrictions and TARIC measures
customsStatus	Customs treatment
destinationCountryCode	Declaration routing and reporting
dispatchCountryCode	Origin and trade statistics
origin.countryCode	Preference and duty calculation
customsValue	Customs valuation
parties.customer.eori	Legal declarant identification
cargoDocuments	Supporting evidence
quantities.*	Tax and customs calculations
firstTimeArrival	Import declaration treatment
inwardProcessingFlag	Special procedure determination