# Transaction JSON

<div id="bkmrk-1.-transaction-heade"># <span>Transaction JSON Description</span>

<div><span>  
</span></div><span>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.</span>

<span>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.</span>

<span>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.</span>

<span>It is therefore the responsibility of the source system and the data provider to ensure that:</span>

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

<span>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.</span>

<div><span>  
</span></div># 1. Transaction Header

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

#   


# 2. Customs Product

##   


## customsProduct.customsValue.invoice

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th><th>Mandatory</th></tr></thead><tbody><tr><td>reference</td><td>Invoice reference</td><td>Conditional</td></tr><tr><td>amount</td><td>Invoice value</td><td>Conditional</td></tr><tr><td>currency</td><td>Invoice currency</td><td>Conditional</td></tr><tr><td>incotermCode</td><td>Applicable Incoterm</td><td>Conditional</td></tr><tr><td>elementsToInclude.freightCostsAmount</td><td>Freight costs</td><td>Conditional</td></tr><tr><td>elementsToInclude.insuranceCostsAmount</td><td>Insurance costs</td><td>Conditional</td></tr></tbody></table>

###   


### Allowed Incoterms

<table class="e-rte-table"><thead><tr><th>Value</th></tr></thead><tbody><tr><td>CIF</td></tr><tr><td>FOB</td></tr></tbody></table>

###   


### Allowed Currencies

<table class="e-rte-table"><thead><tr><th>Value</th></tr></thead><tbody><tr><td>USD</td></tr><tr><td>EUR</td></tr></tbody></table>

##   


## customsProduct.customsValue.marketValue

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>amount</td><td>Market value of goods</td></tr><tr><td>currency</td><td>Currency</td></tr></tbody></table>

##   


## customsProduct.commodity

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>code</td><td>10-digit TARIC code</td></tr><tr><td>description</td><td>Commercial product description</td></tr><tr><td>reference</td><td>External product reference</td></tr></tbody></table>

#   


# 3. Activities

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th><th>Mandatory</th></tr></thead><tbody><tr><td>activities.reference</td><td>Activity reference</td><td>Yes</td></tr><tr><td>activities.displayReference</td><td>Display reference</td><td>No</td></tr><tr><td>activities.activityType</td><td>Activity type</td><td>Yes</td></tr><tr><td>activities.serviceType</td><td>Service type</td><td>Conditional</td></tr><tr><td>activities.nominationReference</td><td>Nomination reference</td><td>Conditional</td></tr><tr><td>activities.relatedReference</td><td>Related activity reference</td><td>Conditional</td></tr><tr><td>activities.executedByExternalCustomsBroker</td><td>External broker indicator</td><td>No</td></tr></tbody></table>

###   


### Activity Types

<table class="e-rte-table"><thead><tr><th>Allowed Values</th></tr></thead><tbody><tr><td>MOVEMENT</td></tr><tr><td>SERVICE</td></tr></tbody></table>

###   


### Service Types

<table class="e-rte-table"><thead><tr><th>Allowed Values</th></tr></thead><tbody><tr><td>IMPORT</td></tr><tr><td>REBRAND</td></tr><tr><td>RENAME</td></tr><tr><td>DEPARTURE</td></tr><tr><td>ADMINISTRATIVE\_STOCK\_TRANSFER</td></tr><tr><td>TAKE\_IN</td></tr><tr><td>SHIFTING</td></tr><tr><td>COMMODITY\_CODE\_CORRECTION</td></tr></tbody></table>

#   


# 4. Medium

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>medium.type</td><td>Source / destination side of activity</td></tr></tbody></table>

###   


### Allowed Values

<table class="e-rte-table"><thead><tr><th>Value</th><th>Meaning</th></tr></thead><tbody><tr><td>FROM\_STORAGE\_UNIT</td><td>Source storage location</td></tr><tr><td>TO\_STORAGE\_UNIT</td><td>Destination storage location</td></tr><tr><td>IN\_STORAGE\_UNIT</td><td>Activity within same storage unit</td></tr></tbody></table>

#   


# 5. Storage Unit

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>storageUnit.storageUnitReference</td><td>Storage Unit Identifier</td></tr></tbody></table>

#   


# 6. Visit Information

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>visit.visitReference</td><td>Visit identifier</td></tr><tr><td>visit.transportMeansReference</td><td>Vessel name / Truck registration</td></tr><tr><td>visit.transportMeansTypeCode</td><td>Transport means type</td></tr><tr><td>visit.transportMeansNationalityCode</td><td>Nationality of transport means</td></tr><tr><td>visit.changedTransportArrangement</td><td>Changed arrangement indicator</td></tr></tbody></table>

###   


### Transport Means Types

<table class="e-rte-table"><thead><tr><th>Value</th></tr></thead><tbody><tr><td>RA</td></tr><tr><td>RO</td></tr><tr><td>VES</td></tr><tr><td>BAR</td></tr><tr><td>PI</td></tr><tr><td>TANK</td></tr></tbody></table>

#   


# 7. Tank Information

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>tank.tankName</td><td>Tank name</td></tr></tbody></table>

#   


# 8. Parcel Information

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>parcels.reference</td><td>Unique parcel identifier</td></tr><tr><td>parcels.parentReference</td><td>Parent parcel</td></tr><tr><td>parcels.firstTimeArrival</td><td>First arrival under license</td></tr><tr><td>parcels.inwardProcessingFlag</td><td>Subject to inward processing</td></tr><tr><td>parcels.commercialPolicyMeasureFlag</td><td>Commercial Policy Measures applicable</td></tr><tr><td>parcels.exceptionDocument</td><td>Exception document</td></tr><tr><td>customsStatus</td><td>Customs status</td></tr><tr><td>unNumber</td><td>Dangerous Goods UN number</td></tr></tbody></table>

###   


### Flag Values

<table class="e-rte-table"><thead><tr><th>Value</th></tr></thead><tbody><tr><td>Y</td></tr><tr><td>N</td></tr></tbody></table>

###   


### Customs Status Values

<table class="e-rte-table"><thead><tr><th>Value</th></tr></thead><tbody><tr><td>BONDED</td></tr><tr><td>EXCISE</td></tr><tr><td>DOMESTIC</td></tr></tbody></table>

#   


# 9. Parties

##   


## Customer

<table class="e-rte-table"><thead><tr><th>JSON Path</th></tr></thead><tbody><tr><td>parties.customer.reference</td></tr><tr><td>parties.customer.name</td></tr><tr><td>parties.customer.language</td></tr><tr><td>parties.customer.eori</td></tr><tr><td>parties.customer.vatNumber</td></tr><tr><td>parties.customer.cbsCode</td></tr><tr><td>parties.customer.address.streetName</td></tr><tr><td>parties.customer.address.houseNumber</td></tr><tr><td>parties.customer.address.postalCode</td></tr><tr><td>parties.customer.address.cityName</td></tr><tr><td>parties.customer.address.countryCode</td></tr></tbody></table>

##   


## Consignee

<table class="e-rte-table"><thead><tr><th>JSON Path</th></tr></thead><tbody><tr><td>parties.consignee.reference</td></tr><tr><td>parties.consignee.name</td></tr><tr><td>parties.consignee.language</td></tr><tr><td>parties.consignee.eori</td></tr><tr><td>parties.consignee.exciseNumber</td></tr><tr><td>parties.consignee.registeredConsigneeFlag</td></tr><tr><td>parties.consignee.monthlyStatementApproval</td></tr><tr><td>parties.consignee.cbsCode</td></tr><tr><td>parties.consignee.address.\*</td></tr></tbody></table>

##   


## Consignor

<table class="e-rte-table"><thead><tr><th>JSON Path</th></tr></thead><tbody><tr><td>parties.consignor.reference</td></tr><tr><td>parties.consignor.name</td></tr><tr><td>parties.consignor.language</td></tr><tr><td>parties.consignor.eori</td></tr><tr><td>parties.consignor.exciseNumber</td></tr><tr><td>parties.consignor.cbsCode</td></tr><tr><td>parties.consignor.address.\*</td></tr></tbody></table>

##   


## Place Of Dispatch Trader

<table class="e-rte-table"><thead><tr><th>JSON Path</th></tr></thead><tbody><tr><td>parties.placeOfDispatchTrader.reference</td></tr><tr><td>parties.placeOfDispatchTrader.name</td></tr><tr><td>parties.placeOfDispatchTrader.language</td></tr><tr><td>parties.placeOfDispatchTrader.eori</td></tr><tr><td>parties.placeOfDispatchTrader.referenceOfTaxWarehouse</td></tr><tr><td>parties.placeOfDispatchTrader.locationName</td></tr><tr><td>parties.placeOfDispatchTrader.cbsCode</td></tr><tr><td>parties.placeOfDispatchTrader.address.\*</td></tr></tbody></table>

##   


## Delivery Place Trader

<table class="e-rte-table"><thead><tr><th>JSON Path</th></tr></thead><tbody><tr><td>parties.deliveryPlaceTrader.reference</td></tr><tr><td>parties.deliveryPlaceTrader.name</td></tr><tr><td>parties.deliveryPlaceTrader.language</td></tr><tr><td>parties.deliveryPlaceTrader.eori</td></tr><tr><td>parties.deliveryPlaceTrader.referenceOfTaxWarehouse</td></tr><tr><td>parties.deliveryPlaceTrader.locationName</td></tr><tr><td>parties.deliveryPlaceTrader.cbsCode</td></tr><tr><td>parties.deliveryPlaceTrader.address.\*</td></tr></tbody></table>

##   


## Exporter

<table class="e-rte-table"><thead><tr><th>JSON Path</th></tr></thead><tbody><tr><td>parties.exporter.reference</td></tr><tr><td>parties.exporter.name</td></tr><tr><td>parties.exporter.language</td></tr><tr><td>parties.exporter.eori</td></tr><tr><td>parties.exporter.cbsCode</td></tr><tr><td>parties.exporter.address.\*</td></tr></tbody></table>

##   


## Seller

<table class="e-rte-table"><thead><tr><th>JSON Path</th></tr></thead><tbody><tr><td>parties.seller.reference</td></tr><tr><td>parties.seller.name</td></tr><tr><td>parties.seller.language</td></tr><tr><td>parties.seller.eori</td></tr><tr><td>parties.seller.cbsCode</td></tr><tr><td>parties.seller.address.\*</td></tr></tbody></table>

#   


# 10. Goods Location

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>location.language</td><td>Location language</td></tr><tr><td>location.address.streetName</td><td>Street</td></tr><tr><td>location.address.houseNumber</td><td>House number</td></tr><tr><td>location.address.postalCode</td><td>Postal code</td></tr><tr><td>location.address.cityName</td><td>City</td></tr><tr><td>location.address.countryCode</td><td>Country</td></tr><tr><td>location.cbsCode</td><td>CBS code</td></tr><tr><td>location.locationName</td><td>Location name</td></tr></tbody></table>

#   


# 11. Country Information

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>destinationCountryCode</td><td>Destination country</td></tr><tr><td>dispatchCountryCode</td><td>Dispatch country</td></tr></tbody></table>

##   


## Exit Office

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>exitOffice.reference</td><td>CMS reference</td></tr><tr><td>exitOffice.name</td><td>Exit office name</td></tr><tr><td>exitOffice.id</td><td>Customs office code (CL294)</td></tr></tbody></table>

##   


## Origin

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>origin.type</td><td>Origin type</td></tr><tr><td>origin.countryCode</td><td>Origin country</td></tr></tbody></table>

###   


### Origin Types

<table class="e-rte-table"><thead><tr><th>Value</th></tr></thead><tbody><tr><td>PREFERENTIAL</td></tr><tr><td>NON-PREFERENTIAL</td></tr></tbody></table>

#   


# 12. Commodity

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>commodity.code</td><td>10-digit TARIC code</td></tr><tr><td>commodity.description</td><td>Commercial description</td></tr><tr><td>commodity.reference</td><td>Product reference</td></tr></tbody></table>

#   


# 13. Cargo Documents

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>cargoDocuments.type</td><td>Document type</td></tr><tr><td>cargoDocuments.reference</td><td>Document reference</td></tr></tbody></table>

###   


### Supported Document Types

<table class="e-rte-table"><thead><tr><th>Value</th></tr></thead><tbody><tr><td>MANIFEST\_INFO</td></tr><tr><td>B\_L</td></tr><tr><td>AGRIM</td></tr><tr><td>AT\_R</td></tr><tr><td>EUR\_1</td></tr><tr><td>EUR\_MED</td></tr><tr><td>INVOICE</td></tr><tr><td>ORIG\_DECL</td></tr><tr><td>INF3</td></tr><tr><td>STAT\_ON\_ORIG</td></tr><tr><td>T2L\_F</td></tr><tr><td>T2L</td></tr><tr><td>E\_AD</td></tr><tr><td>T1</td></tr><tr><td>T2</td></tr><tr><td>EVIDENCE</td></tr></tbody></table>

#   


# 14. Quantities

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>quantities.type</td><td>PLANNED or ACTUAL</td></tr><tr><td>quantities.kgv</td><td>Kilograms in vacuum</td></tr><tr><td>quantities.kga</td><td>Kilograms in air</td></tr><tr><td>quantities.gmv</td><td>Kilograms in vacuum (decimal)</td></tr><tr><td>quantities.gma</td><td>Kilograms in air (decimal)</td></tr><tr><td>quantities.l15</td><td>Litres at 15°C</td></tr><tr><td>quantities.l20</td><td>Litres at 20°C</td></tr><tr><td>quantities.ml5</td><td>Litres (decimal precision)</td></tr><tr><td>quantities.alcPerc</td><td>Alcohol percentage</td></tr></tbody></table>

###   


### Quantity Types

<table class="e-rte-table"><thead><tr><th>Value</th></tr></thead><tbody><tr><td>PLANNED</td></tr><tr><td>ACTUAL</td></tr></tbody></table>

#   


# 15. Density

<table class="e-rte-table"><thead><tr><th>JSON Path</th><th>Description</th></tr></thead><tbody><tr><td>density.value</td><td>Density value</td></tr><tr><td>density.uom</td><td>Density reference basis</td></tr></tbody></table>

###   


### Density UOM

<table class="e-rte-table"><thead><tr><th>Value</th></tr></thead><tbody><tr><td>D15</td></tr><tr><td>D1A</td></tr></tbody></table>

#   


# 16. Compliance-Critical Fields

<table class="e-rte-table"><thead><tr><th>Field</th><th>Compliance Impact</th></tr></thead><tbody><tr><td>commodity.code</td><td>Duty determination, restrictions and TARIC measures</td></tr><tr><td>customsStatus</td><td>Customs treatment</td></tr><tr><td>destinationCountryCode</td><td>Declaration routing and reporting</td></tr><tr><td>dispatchCountryCode</td><td>Origin and trade statistics</td></tr><tr><td>origin.countryCode</td><td>Preference and duty calculation</td></tr><tr><td>customsValue</td><td>Customs valuation</td></tr><tr><td>parties.customer.eori</td><td>Legal declarant identification</td></tr><tr><td>cargoDocuments</td><td>Supporting evidence</td></tr><tr><td>quantities.\*</td><td>Tax and customs calculations</td></tr><tr><td>firstTimeArrival</td><td>Import declaration treatment</td></tr><tr><td>inwardProcessingFlag</td><td>Special procedure determination</td></tr></tbody></table>

</div># Structure Transaction JSON

<div id="bkmrk--39">  
</div><div id="bkmrk-transaction%E2%94%9C%E2%94%80%E2%94%80-sourc"><div><div class=""><span>Transaction</span></div><div class=""><span>├── sourceApplication</span></div><div class=""><span>├── terminal</span></div><div class=""><span>├── reference</span></div><div class=""><span>├── displayReference</span></div><div class=""><span>├── taxCountry</span></div><div class=""><span>├── cmsReference</span></div><div class=""><span>├── overrideCheckAlert</span></div><div class=""><span>├── userId</span></div><div class=""><span>├── presentationDateTime</span></div><div class=""><span>├── normalProcedure</span></div><div class=""><span>│</span></div><div class=""><span>├── customsProduct</span></div><div class=""><span>│ ├── customsValue</span></div><div class=""><span>│ │ ├── invoice</span></div><div class=""><span>│ │ │ ├── reference</span></div><div class=""><span>│ │ │ ├── amount</span></div><div class=""><span>│ │ │ ├── currency</span></div><div class=""><span>│ │ │ ├── incotermCode</span></div><div class=""><span>│ │ │ └── elementsToInclude</span></div><div class=""><span>│ │ │ ├── freightCostsAmount</span></div><div class=""><span>│ │ │ └── insuranceCostsAmount</span></div><div class=""><span>│ │ │</span></div><div class=""><span>│ │ └── marketValue</span></div><div class=""><span>│ │ ├── amount</span></div><div class=""><span>│ │ └── currency</span></div><div class=""><span>│ │</span></div><div class=""><span>│ └── commodity</span></div><div class=""><span>│ ├── code</span></div><div class=""><span>│ ├── description</span></div><div class=""><span>│ └── reference</span></div><div class=""><span>│</span></div><div class=""><span>└── activities\[\]</span></div><div class=""><span> ├── reference</span></div><div class=""><span> ├── displayReference</span></div><div class=""><span> ├── activityType</span></div><div class=""><span> ├── serviceType</span></div><div class=""><span> ├── nominationReference</span></div><div class=""><span> ├── relatedReference</span></div><div class=""><span> ├── executedByExternalCustomsBroker</span></div><div class=""><span> │</span></div><div class=""><span> └── medium\[\]</span></div><div class=""><span> ├── type</span></div><div class=""><span> │</span></div><div class=""><span> ├── storageUnit</span></div><div class=""><span> │ ├── storageUnitReference</span></div><div class=""><span> │ │</span></div><div class=""><span> │ ├── visit</span></div><div class=""><span> │ │ ├── visitReference</span></div><div class=""><span> │ │ ├── transportMeansReference</span></div><div class=""><span> │ │ ├── transportMeansTypeCode</span></div><div class=""><span> │ │ ├── transportMeansNationalityCode</span></div><div class=""><span> │ │ └── changedTransportArrangement</span></div><div class=""><span> │ │</span></div><div class=""><span> │ └── tank</span></div><div class=""><span> │ └── tankName</span></div><div class=""><span> │</span></div><div class=""><span> └── parcels\[\]</span></div><div class=""><span> ├── reference</span></div><div class=""><span> ├── parentReference</span></div><div class=""><span> ├── firstTimeArrival</span></div><div class=""><span> ├── inwardProcessingFlag</span></div><div class=""><span> ├── commercialPolicyMeasureFlag</span></div><div class=""><span> ├── exceptionDocument</span></div><div class=""><span> │</span></div><div class=""><span> ├── parties</span></div><div class=""><span> │ │</span></div><div class=""><span> │ ├── customer</span></div><div class=""><span> │ │ ├── reference</span></div><div class=""><span> │ │ ├── name</span></div><div class=""><span> │ │ ├── language</span></div><div class=""><span> │ │ ├── eori</span></div><div class=""><span> │ │ ├── vatNumber</span></div><div class=""><span> │ │ ├── cbsCode</span></div><div class=""><span> │ │ └── address</span></div><div class=""><span> │ │ ├── cityName</span></div><div class=""><span> │ │ ├── countryCode</span></div><div class=""><span> │ │ ├── streetName</span></div><div class=""><span> │ │ ├── postalCode</span></div><div class=""><span> │ │ └── houseNumber</span></div><div class=""><span> │ │</span></div><div class=""><span> │ ├── consignee</span></div><div class=""><span> │ │ ├── reference</span></div><div class=""><span> │ │ ├── name</span></div><div class=""><span> │ │ ├── language</span></div><div class=""><span> │ │ ├── eori</span></div><div class=""><span> │ │ ├── exciseNumber</span></div><div class=""><span> │ │ ├── registeredConsigneeFlag</span></div><div class=""><span> │ │ ├── monthlyStatementApproval</span></div><div class=""><span> │ │ ├── cbsCode</span></div><div class=""><span> │ │ └── address</span></div><div class=""><span> │ │ ├── cityName</span></div><div class=""><span> │ │ ├── countryCode</span></div><div class=""><span> │ │ ├── streetName</span></div><div class=""><span> │ │ ├── postalCode</span></div><div class=""><span> │ │ └── houseNumber</span></div><div class=""><span> │ │</span></div><div class=""><span> │ ├── consignor</span></div><div class=""><span> │ │ ├── reference</span></div><div class=""><span> │ │ ├── name</span></div><div class=""><span> │ │ ├── language</span></div><div class=""><span> │ │ ├── eori</span></div><div class=""><span> │ │ ├── exciseNumber</span></div><div class=""><span> │ │ ├── cbsCode</span></div><div class=""><span> │ │ └── address</span></div><div class=""><span> │ │ ├── cityName</span></div><div class=""><span> │ │ ├── countryCode</span></div><div class=""><span> │ │ ├── streetName</span></div><div class=""><span> │ │ ├── postalCode</span></div><div class=""><span> │ │ └── houseNumber</span></div><div class=""><span> │ │</span></div><div class=""><span> │ ├── placeOfDispatchTrader</span></div><div class=""><span> │ │ ├── reference</span></div><div class=""><span> │ │ ├── name</span></div><div class=""><span> │ │ ├── language</span></div><div class=""><span> │ │ ├── eori</span></div><div class=""><span> │ │ ├── referenceOfTaxWarehouse</span></div><div class=""><span> │ │ ├── locationName</span></div><div class=""><span> │ │ ├── cbsCode</span></div><div class=""><span> │ │ └── address</span></div><div class=""><span> │ │ ├── cityName</span></div><div class=""><span> │ │ ├── countryCode</span></div><div class=""><span> │ │ ├── streetName</span></div><div class=""><span> │ │ ├── postalCode</span></div><div class=""><span> │ │ └── houseNumber</span></div><div class=""><span> │ │</span></div><div class=""><span> │ ├── deliveryPlaceTrader</span></div><div class=""><span> │ │ ├── reference</span></div><div class=""><span> │ │ ├── name</span></div><div class=""><span> │ │ ├── language</span></div><div class=""><span> │ │ ├── eori</span></div><div class=""><span> │ │ ├── referenceOfTaxWarehouse</span></div><div class=""><span> │ │ ├── locationName</span></div><div class=""><span> │ │ ├── cbsCode</span></div><div class=""><span> │ │ └── address</span></div><div class=""><span> │ │ ├── cityName</span></div><div class=""><span> │ │ ├── countryCode</span></div><div class=""><span> │ │ ├── streetName</span></div><div class=""><span> │ │ ├── postalCode</span></div><div class=""><span> │ │ └── houseNumber</span></div><div class=""><span> │ │</span></div><div class=""><span> │ ├── exporter</span></div><div class=""><span> │ │ ├── reference</span></div><div class=""><span> │ │ ├── name</span></div><div class=""><span> │ │ ├── language</span></div><div class=""><span> │ │ ├── eori</span></div><div class=""><span> │ │ ├── cbsCode</span></div><div class=""><span> │ │ └── address</span></div><div class=""><span> │ │ ├── cityName</span></div><div class=""><span> │ │ ├── countryCode</span></div><div class=""><span> │ │ ├── streetName</span></div><div class=""><span> │ │ ├── postalCode</span></div><div class=""><span> │ │ └── houseNumber</span></div><div class=""><span> │ │</span></div><div class=""><span> │ └── seller</span></div><div class=""><span> │ ├── reference</span></div><div class=""><span> │ ├── name</span></div><div class=""><span> │ ├── language</span></div><div class=""><span> │ ├── eori</span></div><div class=""><span> │ ├── cbsCode</span></div><div class=""><span> │ └── address</span></div><div class=""><span> │ ├── cityName</span></div><div class=""><span> │ ├── countryCode</span></div><div class=""><span> │ ├── streetName</span></div><div class=""><span> │ ├── postalCode</span></div><div class=""><span> │ └── houseNumber</span></div><div class=""><span> │</span></div><div class=""><span> ├── location</span></div><div class=""><span> │ ├── language</span></div><div class=""><span> │ ├── address</span></div><div class=""><span> │ │ ├── cityName</span></div><div class=""><span> │ │ ├── countryCode</span></div><div class=""><span> │ │ ├── streetName</span></div><div class=""><span> │ │ ├── postalCode</span></div><div class=""><span> │ │ └── houseNumber</span></div><div class=""><span> │ ├── cbsCode</span></div><div class=""><span> │ └── locationName</span></div><div class=""><span> │</span></div><div class=""><span> ├── destinationCountryCode</span></div><div class=""><span> ├── dispatchCountryCode</span></div><div class=""><span> │</span></div><div class=""><span> ├── exitOffice</span></div><div class=""><span> │ ├── reference</span></div><div class=""><span> │ ├── name</span></div><div class=""><span> │ └── id</span></div><div class=""><span> │</span></div><div class=""><span> ├── origin\[\]</span></div><div class=""><span> │ ├── type</span></div><div class=""><span> │ └── countryCode</span></div><div class=""><span> │</span></div><div class=""><span> ├── commodity</span></div><div class=""><span> │ ├── code</span></div><div class=""><span> │ ├── description</span></div><div class=""><span> │ └── reference</span></div><div class=""><span> │</span></div><div class=""><span> ├── customsValue</span></div><div class=""><span> │ └── marketValue</span></div><div class=""><span> │ ├── amount</span></div><div class=""><span> │ └── currency</span></div><div class=""><span> │</span></div><div class=""><span> ├── customsStatus</span></div><div class=""><span> │</span></div><div class=""><span> ├── cargoDocuments\[\]</span></div><div class=""><span> │ ├── type</span></div><div class=""><span> │ ├── reference</span></div><div class=""><span> │ └── quantities\[\]</span></div><div class=""><span> │ ├── kgv</span></div><div class=""><span> │ ├── l15</span></div><div class=""><span> │ └── mtv</span></div><div class=""><span> │</span></div><div class=""><span> ├── unNumber</span></div><div class=""><span> │</span></div><div class=""><span> ├── quantities\[\]</span></div><div class=""><span> │ ├── type</span></div><div class=""><span> │ ├── kgv</span></div><div class=""><span> │ ├── kga</span></div><div class=""><span> │ ├── gmv</span></div><div class=""><span> │ ├── gma</span></div><div class=""><span> │ ├── l15</span></div><div class=""><span> │ ├── l20</span></div><div class=""><span> │ ├── ml5</span></div><div class=""><span> │ └── alcPerc</span></div><div class=""><span> │</span></div><div class=""><span> └── density</span></div><div class=""><span> ├── value</span></div><div class=""><span> └── uom</span></div><div>  
</div>This is the consolidated hierarchy using the CMS schema as the authoritative source and includes both the transaction-level `customsProduct` and the parcel-level customs/commodity structures.

<div>  
</div>#### Back up, documentation Confluence

<div>  
</div><div><div id="bkmrk-transaction_request_" role="navigation"><div data-automation-id="visibleContent"><div class="ms-FocusZone css-47 ms-CommandBar root-43" data-focuszone-id="FocusZone3" data-tabster="{"uncontrolled": {}}" role="menubar"><div class="ms-OverflowSet ms-CommandBar-primaryCommand OneUpCommandBar-primaryCommandSet primarySet-48" role="group"><div class="ms-OverflowSet-item item-49" role="none"><div>[transaction\_request\_schema.md](https://www.bzctrl.com/bzctrl-core-api/api/v1/bookstack/attachments/14)</div><div aria-disabled="true" aria-label="Divider" class="OneUpNonInteractiveCommandWrapper_d7f8e809" id="bkmrk-transaction_request_-1" role="menuitem" tabindex="-1">[transaction\_request\_json\_schema (1).md](https://www.bzctrl.com/bzctrl-core-api/api/v1/bookstack/attachments/13)</div></div></div></div></div></div><div class="OneUpRoot_e6db539d OneUpRootDarkBackground_e6db539d"><div class="OneUpViewer_e6db539d"><div class="root_f8e2bfcb" id="bkmrk-the-request-expected-2" role="main" tabindex="0"><div class="platform_f8e2bfcb flipping_f8e2bfcb" data-is-powered="false"><div class="slide_f8e2bfcb current_f8e2bfcb loaded_f8e2bfcb" data-item-direction="0" data-item-offset="0" data-item-order="1"><div class="fui-FluentProvider fui-FluentProvider20 markdownViewerWrapper_01271d79 ___jdtuxv0 f19n0e5 fxugw4r f1o700av fk6fouc fkhj508 figsok6 f1i3iumi" dir="ltr"><div class="markdownViewerContainer_01271d79"><div class="markdownViewerContent_01271d79"><div class="markdownPreviewFull_01271d79"><div class="previewWithComments_01271d79"><div class="fui-FluentProvider fui-FluentProvider108 previewContentWrapper_01271d79 ___jdtuxv0 f19n0e5 fxugw4r f1o700av fk6fouc fkhj508 figsok6 f1i3iumi" dir="ltr"><div class="previewContainer_01271d79" data-fui-focus-visible="" tabindex="0"><div>[transaction\_response\_json\_schema.md](https://www.bzctrl.com/bzctrl-core-api/api/v1/bookstack/attachments/15)</div>The request expected by CMS to create a transaction

**Schema Version:**<span> </span>[https://json-schema.org/draft/2020-12/schema](https://json-schema.org/draft/2020-12/schema)

</div></div></div></div></div></div></div></div></div></div></div></div></div></div></div>