Customs declarations system
Connection details

Dit screenshot bevestigt dat er voor NL100005780 / Sway-it B.V. logistieke afspraken geregistreerd zijn in de pre-productie/testomgeving.
Wat ik hieruit lees:
| Veld | Waarde / betekenis |
|---|---|
| Geadresseerde ID | NL100005780 |
| Geadresseerde | 00.05 Sway-it B.V. / 00.04 Sway-it B.V. / 00.20 Sway-it B.V. |
| Berichtstroom | DMS, DMSZIP, VERVOER, EMCS |
| Kanaal | SMTP |
| Elektronisch adres | htg24000200@msa.preprod.htpoort.nl |
| Berichtformaat | XML of ZIP |
| Ingangsdatum | 05-12-2024 11:00 |
Wat betekent dit praktisch?
Je bent dus niet alleen “algemeen geregistreerd”; er zijn concrete logistieke afspraken ingericht voor berichtenverkeer via SMTP naar het MSA preprod-adres:
htg24000200@msa.preprod.htpoort.nl
Dat betekent praktisch dat jouw systeem in de pre-productieomgeving berichten kan uitwisselen via e-mail/SMTP met de Douane/HT-poort/MSA-keten, mits de berichten technisch correct zijn opgebouwd.
Voor DMS betekent dit
Je hebt twee relevante berichtstromen:
DMS – XML
- Voor gewone DMS-berichten in XML-formaat.
- Je software maakt een XML-bericht conform de DMS-specificatie.
- Dat bericht wordt via SMTP aangeboden.
DMSZIP – ZIP
- Voor ZIP-berichten.
- Dit is waarschijnlijk relevant wanneer berichten of bijlagen gebundeld/gecomprimeerd moeten worden.
- Het screenshot toont expliciet dat
DMSZIPals aparte berichtstroom met formaatZIPis ingericht.
De basisflow is dan waarschijnlijk als volgt
Je applicatie genereert een DMS XML-bericht
- Bijvoorbeeld een invoer-/uitvoeraangifte of ander DMS-berichttype.
- Het bericht moet voldoen aan de juiste XSD/MIG-specificatie.
Je applicatie verstuurt het bericht via SMTP
- Naar het elektronische adres dat in de logistieke afspraak staat:
htg24000200@msa.preprod.htpoort.nl
- Naar het elektronische adres dat in de logistieke afspraak staat:
De berichtstroom en het berichttype moeten herkenbaar zijn
- In de logistieke afspraak staat alleen de berichtstroom.
- In het daadwerkelijke bericht of de envelop/header moet waarschijnlijk duidelijk zijn welk berichttype het betreft.
- Dit moet exact volgens de MSA/HT-poort/DMS-specificatie.
Je ontvangt retourberichten
- Bijvoorbeeld technische ontvangstbevestiging.
- Validatiefouten.
- Functionele response.
- Statusupdates.
- Eventueel MRN/status vrijgave/controle, afhankelijk van het type aangifte.
Je software moet die retourberichten verwerken
- Niet alleen verzenden, maar ook mailbox uitlezen.
- Correlatie leggen met je eigen referentie/LRN.
- Foutcodes en statusberichten tonen aan de gebruiker.
Belangrijke nuance: dit is preprod
Het adres bevat:
msa.preprod.htpoort.nl
Dat betekent dat dit de pre-productieomgeving is. Je kunt hiermee testen, maar dit is niet per se productie. Voor productie zou je normaal gesproken een ander elektronisch adres/omgeving verwachten, zonder preprod.
Dus:
- Ja, dit bevestigt dat je praktisch via MSA/SMTP DMS-berichten kunt testen.
- Nee, dit is nog geen bewijs dat je productieaangiften bij de Douane indient.
- Voor productie moet er een aparte productie-logistieke afspraak/aansluiting zijn.
Wat moet je nu concreet doen om een DMS-testaangifte te sturen?
1. Bepaal de juiste berichtstroom
Voor DMS-aangiften gebruik je waarschijnlijk:
DMSvoor losse XML-berichten;DMSZIPals de specificatie vereist dat je een ZIP-bestand stuurt.
Begin met DMS/XML tenzij de documentatie expliciet zegt dat jouw scenario via ZIP moet.
2. Zoek de DMS berichtspecificatie op
Je hebt nodig:
- het juiste berichttype;
- XML schema/XSD;
- envelopspecificatie;
- naamgevingsconventies;
- SMTP-eisen;
- subjectregel/e-mailheaders;
- attachmentregels;
- retourberichtspecificaties.
Zonder die specificatie zou ik niet zomaar een e-mail met XML bijlage sturen, want de HT-poort verwacht vaak een zeer specifieke envelop/structuur.
3. Bouw een minimaal geldig testbericht
Gebruik een testcase uit de Douane/MSA-community of DMS testset. Een “zelfbedachte” aangifte faalt vaak op codes, vergunningen, goederencodes, locaties, vertegenwoordiging of testdata.
4. Verstuur via SMTP
Je verzendt naar:
texthtg24000200@msa.preprod.htpoort.nlcontent_copyCopy code
Afhankelijk van de specificatie kan het bericht:
- als body worden verstuurd;
- als XML-bijlage;
- als ZIP-bijlage;
- met specifieke bestandsnaam;
- met specifieke subjectregel;
- met aanvullende SMTP headers.
5. Lees de retourmailbox uit
De logistieke afspraak toont het adres waar berichten naartoe gaan, maar je moet ook weten via welk adres jij retourberichten ontvangt. In veel setups is er een retouradres/mailbox of MSA-account waar replies/statussen terechtkomen.
Je software moet dus minimaal:
- mail kunnen verzenden;
- mail kunnen ontvangen;
- XML/ZIP retourberichten kunnen parsen;
- foutmeldingen kunnen tonen;
- correlatie kunnen leggen met de verzonden aangifte.
Wat ik uit je screenshot zou concluderen
Je aansluiting lijkt technisch ingericht voor:
textDMS XML via SMTP DMS ZIP via SMTP VERVOER XML via SMTP EMCS XML via SMTPcontent_copyCopy code
Voor jouw vraag “kan ik bijvoorbeeld DMS-aangiften insturen?” is het antwoord:
Ja, in pre-productie lijkt je organisatie ingericht om DMS-berichten te kunnen uitwisselen via SMTP. Praktisch moet je nu de juiste DMS XML/ZIP specificatie volgen, testberichten opbouwen, via SMTP naar het preprod MSA-adres sturen en retourberichten verwerken.
Let op met productie
Als je echte aangiften wilt indienen, controleer dan of je ook een productieafspraak hebt. Die zou waarschijnlijk niet naar msa.preprod.htpoort.nl wijzen. Als je alleen dit screenshot hebt, dan praat je nu over testen, niet over live aangiften.
Kort stappenplan
- Open de MSA/NHD softwareontwikkelaarsdocumentatie.
- Pak de DMS XML/XSD/MIG en SMTP-envelopspecificatie.
- Gebruik een officiële testset/testcase.
- Genereer een geldig DMS XML-bericht.
- Verstuur via SMTP naar
htg24000200@msa.preprod.htpoort.nl. - Ontvang en verwerk de response.
- Los technische en functionele foutmeldingen op.
- Vraag daarna pas productie-aansluiting/logistieke afspraken aan of controleer of die al bestaan.
UI/UX Declaration data entry
First-screen order for fastest user entry
If you want the shortest practical user journey, use this order:
| Step | Tab | Required user action |
|---|---|---|
| 1 | Declaration Header | Enter declaration identifiers, type, office and dates |
| 2 | Parties | Enter declarant, importer/exporter, buyer/seller, consignee/consignor |
| 3 | Shipment Details | Enter invoice amount, currency, countries and trade terms |
| 4 | Transport & Consignment | Enter carrier, transport means, equipment and UCR |
| 5 | Goods Items | Enter commodity, classification, weights, origin and packaging |
| 6 | Documents & References | Enter supporting and previous documents |
| 7 | Valuation, Duties & Taxes | Enter customs value, charges and tax lines |
| 8 | Guarantee & Payment | Enter deferred payment or guarantee details |
| 9 | Review & Submit | Validate, review XML and submit |
UI design pattern
Use this structure:
textDeclaration ├── Header ├── Parties ├── Shipment ├── Transport & Consignment ├── Goods Items │ ├── Goods item detail │ ├── Commodity │ ├── Classification │ ├── Measures │ ├── Origin │ ├── Packaging │ ├── Item parties │ └── Item documents ├── Documents & References ├── Valuation, Duties & Taxes ├── Guarantee & Payment └── Review & Submitcontent_copyCopy code
For best usability:
| Recommendation | Reason |
|---|---|
| Use tabs for major sections | Keeps the form manageable |
| Use collapsible panels for parties and item details | Avoids overwhelming the user |
| Use repeatable grids for documents, goods items, packaging and taxes | Matches XML repeatable structures |
| Use lookups/dropdowns for codes | Reduces data-entry errors |
| Use date pickers but store as XML format | User-friendly entry, valid XML output |
| Use currency selector next to amount fields | Required where XML has currencyID attributes |
| Use unit selector next to quantity fields | Required where XML has unitCode attributes |
| Use Review & Submit validation tab | Prevents invalid XML or incomplete declarations |
UI tabs
| Tab no. | Tab name | Purpose |
|---|---|---|
| 1 | Declaration Header | Main declaration identifiers, dates, customs offices and message metadata |
| 2 | Parties | Declarant, agent, importer, exporter, buyer, seller, consignee, consignor |
| 3 | Shipment Details | Invoice, currency, dispatch/export/destination countries, trade terms, warehouse |
| 4 | Transport & Consignment | Carrier, transport means, container, goods location, itinerary, transport equipment |
| 5 | Goods Items | Commodity details, classification, weights, origin, packaging and item-level parties |
| 6 | Documents & References | Additional references, supporting documents, previous documents, UCR |
| 7 | Valuation, Duties & Taxes | Customs value, freight, charge/deductions, duty/tax fee, tax base and payments |
| 8 | Guarantee & Payment | Deferred payment, obligation guarantee, payer, surety |
| 9 | Review & Submit | Validation summary, missing fields, XML preview and submission |
Tab 1 — Declaration Header
Purpose
Capture the declaration identity, message metadata and customs offices.
Recommended field order
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | WCO Type Code | /MetaData/WCOTypeCode | Text input |
| 2 | Application Reference ID | /MetaData/CommunicationMetaData/ApplicationReferenceID | Text input |
| 3 | Communications Agreement ID | /MetaData/CommunicationMetaData/CommunicationsAgreementID | Text input |
| 4 | Sender ID | /MetaData/CommunicationMetaData/Sender/ID | Text input |
| 5 | Recipient ID | /MetaData/CommunicationMetaData/Recipient/ID | Text input |
| 6 | Preparation Date/Time | /MetaData/CommunicationMetaData/PreparationDateTime | Date/time picker |
| 7 | Functional Reference ID | /MetaData/Declaration/FunctionalReferenceID | Text input |
| 8 | Declaration ID | /MetaData/Declaration/ID | Text input |
| 9 | Declaration Type Code | /MetaData/Declaration/TypeCode | Dropdown / code list |
| 10 | Language Code | /MetaData/Declaration/LanguageCode | Dropdown |
| 11 | Specific Circumstances Code | /MetaData/Declaration/SpecificCircumstancesCode | Dropdown / code list |
| 12 | Security Code | /MetaData/Declaration/SecurityCode | Dropdown / code list |
| 13 | Presentation Date/Time | /MetaData/Declaration/PresentationDateTime | Date/time picker |
| 14 | Declaration Office ID | /MetaData/Declaration/DeclarationOffice/ID | Lookup |
| 15 | Exit Office ID | /MetaData/Declaration/ExitOffice/ID | Lookup |
| 16 | Presentation Office ID | /MetaData/Declaration/PresentationOffice/ID | Lookup |
| 17 | Supervising Office ID | /MetaData/Declaration/SupervisingOffice/ID | Lookup |
Tab 2 — Parties
Purpose
Capture all legal and operational parties involved in the declaration.
Use reusable party panels where possible:
- Name
- ID
- Address line
- City
- Postcode
- Country
- Contact name
- Communication type
- Communication value
2.1 Declarant
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Declarant Name | /MetaData/Declaration/Declarant/Name | Text input |
| 2 | Declarant ID | /MetaData/Declaration/Declarant/ID | Text input |
| 3 | Declarant Address Line | /MetaData/Declaration/Declarant/Address/Line | Text input |
| 4 | Declarant City | /MetaData/Declaration/Declarant/Address/CityName | Text input |
| 5 | Declarant Postcode | /MetaData/Declaration/Declarant/Address/PostcodeID | Text input |
| 6 | Declarant Country Code | /MetaData/Declaration/Declarant/Address/CountryCode | Country dropdown |
| 7 | Declarant Contact Name | /MetaData/Declaration/Declarant/Contact/Name | Text input |
| 8 | Declarant Communication Type | /MetaData/Declaration/Declarant/Contact/Communication/TypeCode | Dropdown |
| 9 | Declarant Communication ID | /MetaData/Declaration/Declarant/Contact/Communication/ID | Text input |
| 10 | Declarant Communication Sequence | /MetaData/Declaration/Declarant/Contact/Communication/SequenceNumeric | Number input |
2.2 Agent
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Agent ID | /MetaData/Declaration/Agent/ID | Text input |
| 2 | Agent Function Code | /MetaData/Declaration/Agent/FunctionCode | Dropdown / code list |
| 3 | Agent Contact Name | /MetaData/Declaration/Agent/Contact/Name | Text input |
| 4 | Agent Communication Type | /MetaData/Declaration/Agent/Contact/Communication/TypeCode | Dropdown |
| 5 | Agent Communication ID | /MetaData/Declaration/Agent/Contact/Communication/ID | Text input |
| 6 | Agent Communication Sequence | /MetaData/Declaration/Agent/Contact/Communication/SequenceNumeric | Number input |
2.3 Importer
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Importer Name | /MetaData/Declaration/Importer/Name | Text input |
| 2 | Importer ID | /MetaData/Declaration/Importer/ID | Text input |
| 3 | Importer Address Line | /MetaData/Declaration/Importer/Address/Line | Text input |
| 4 | Importer City | /MetaData/Declaration/Importer/Address/CityName | Text input |
| 5 | Importer Postcode | /MetaData/Declaration/Importer/Address/PostcodeID | Text input |
| 6 | Importer Country Code | /MetaData/Declaration/Importer/Address/CountryCode | Country dropdown |
2.4 Declaration-level Exporter
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Exporter Name | /MetaData/Declaration/Exporter/Name | Text input |
| 2 | Exporter ID | /MetaData/Declaration/Exporter/ID | Text input |
| 3 | Exporter Address Line | /MetaData/Declaration/Exporter/Address/Line | Text input |
| 4 | Exporter City | /MetaData/Declaration/Exporter/Address/CityName | Text input |
| 5 | Exporter Postcode | /MetaData/Declaration/Exporter/Address/PostcodeID | Text input |
| 6 | Exporter Country Code | /MetaData/Declaration/Exporter/Address/CountryCode | Country dropdown |
2.5 Buyer
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Buyer Name | /MetaData/Declaration/GoodsShipment/Buyer/Name | Text input |
| 2 | Buyer ID | /MetaData/Declaration/GoodsShipment/Buyer/ID | Text input |
| 3 | Buyer Address Line | /MetaData/Declaration/GoodsShipment/Buyer/Address/Line | Text input |
| 4 | Buyer City | /MetaData/Declaration/GoodsShipment/Buyer/Address/CityName | Text input |
| 5 | Buyer Postcode | /MetaData/Declaration/GoodsShipment/Buyer/Address/PostcodeID | Text input |
| 6 | Buyer Country Code | /MetaData/Declaration/GoodsShipment/Buyer/Address/CountryCode | Country dropdown |
2.6 Seller
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Seller Name | /MetaData/Declaration/GoodsShipment/Seller/Name | Text input |
| 2 | Seller ID | /MetaData/Declaration/GoodsShipment/Seller/ID | Text input |
| 3 | Seller Address Line | /MetaData/Declaration/GoodsShipment/Seller/Address/Line | Text input |
| 4 | Seller City | /MetaData/Declaration/GoodsShipment/Seller/Address/CityName | Text input |
| 5 | Seller Postcode | /MetaData/Declaration/GoodsShipment/Seller/Address/PostcodeID | Text input |
| 6 | Seller Country Code | /MetaData/Declaration/GoodsShipment/Seller/Address/CountryCode | Country dropdown |
2.7 Consignee and Consignor
These can be shown as two side-by-side party panels.
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Consignee Name | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/Name | Text input |
| 2 | Consignee ID | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/ID | Text input |
| 3 | Consignee Address Line | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/Line | Text input |
| 4 | Consignee City | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/CityName | Text input |
| 5 | Consignee Postcode | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/PostcodeID | Text input |
| 6 | Consignee Country Code | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/CountryCode | Country dropdown |
| 7 | Consignor Name | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/Name | Text input |
| 8 | Consignor ID | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/ID | Text input |
| 9 | Consignor Address Line | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/Line | Text input |
| 10 | Consignor City | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/CityName | Text input |
| 11 | Consignor Postcode | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/PostcodeID | Text input |
| 12 | Consignor Country Code | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/CountryCode | Country dropdown |
Tab 3 — Shipment Details
Purpose
Capture commercial shipment-level information.
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Shipment Sequence | /MetaData/Declaration/GoodsShipment/SequenceNumeric | Number input |
| 2 | Transaction Nature Code | /MetaData/Declaration/GoodsShipment/TransactionNatureCode | Dropdown / code list |
| 3 | Dispatch Country Code | /MetaData/Declaration/GoodsShipment/DispatchCountryCode | Country dropdown |
| 4 | Export Country ID | /MetaData/Declaration/GoodsShipment/ExportCountry/ID | Country dropdown |
| 5 | Destination Country Code | /MetaData/Declaration/GoodsShipment/Destination/CountryCode | Country dropdown |
| 6 | Destination Region ID | /MetaData/Declaration/GoodsShipment/Destination/RegionID | Text input |
| 7 | Destination Qualifier Code | /MetaData/Declaration/GoodsShipment/Destination/CCQualifierCode | Dropdown |
| 8 | Invoice Amount | /MetaData/Declaration/GoodsShipment/InvoiceAmount | Amount input |
| 9 | Invoice Currency Code | /MetaData/Declaration/GoodsShipment/InvoiceCurrencyCode | Currency dropdown |
| 10 | Acceptance Date | /MetaData/Declaration/GoodsShipment/AcceptanceDateTime | Date picker |
| 11 | Currency Exchange Currency | /MetaData/Declaration/GoodsShipment/CurrencyExchange/CurrencyTypeCode | Currency dropdown |
| 12 | Currency Exchange Rate | /MetaData/Declaration/GoodsShipment/CurrencyExchange/RateNumeric | Decimal input |
| 13 | Trade Term Condition Code | /MetaData/Declaration/GoodsShipment/TradeTerms/ConditionCode | Incoterm dropdown |
| 14 | Trade Term Description | /MetaData/Declaration/GoodsShipment/TradeTerms/Description | Text input |
| 15 | Trade Term Location ID | /MetaData/Declaration/GoodsShipment/TradeTerms/LocationID | Text input |
| 16 | Trade Term Location Name | /MetaData/Declaration/GoodsShipment/TradeTerms/LocationName | Text input |
| 17 | Trade Term Country Code | /MetaData/Declaration/GoodsShipment/TradeTerms/CountryCode | Country dropdown |
| 18 | Warehouse ID | /MetaData/Declaration/GoodsShipment/Warehouse/ID | Text input |
| 19 | Warehouse Type Code | /MetaData/Declaration/GoodsShipment/Warehouse/TypeCode | Dropdown / code list |
| 20 | Shipment-level Freight Payment Method | /MetaData/Declaration/GoodsShipment/Freight/PaymentMethodCode | Dropdown / code list |
Tab 4 — Transport & Consignment
Purpose
Capture logistics, transport, container, location and routing data.
4.1 Consignment header
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Container Code | /MetaData/Declaration/GoodsShipment/Consignment/ContainerCode | Dropdown / code list |
| 2 | Total Gross Mass | /MetaData/Declaration/GoodsShipment/Consignment/TotalGrossMassMeasure | Decimal input |
| 3 | Carrier ID | /MetaData/Declaration/GoodsShipment/Consignment/Carrier/ID | Text input |
| 4 | Consignment Freight Payment Method | /MetaData/Declaration/GoodsShipment/Consignment/Freight/PaymentMethodCode | Dropdown / code list |
| 5 | Consignment UCR | /MetaData/Declaration/GoodsShipment/Consignment/UCR/TraderAssignedReferenceID | Text input |
4.2 Arrival transport
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 6 | Arrival Transport ID | /MetaData/Declaration/GoodsShipment/Consignment/ArrivalTransportMeans/ID | Text input |
| 7 | Arrival Identification Type Code | /MetaData/Declaration/GoodsShipment/Consignment/ArrivalTransportMeans/IdentificationTypeCode | Dropdown / code list |
| 8 | Arrival Mode Code | /MetaData/Declaration/GoodsShipment/Consignment/ArrivalTransportMeans/ModeCode | Dropdown / code list |
4.3 Border transport
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 9 | Border Transport ID | /MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/ID | Text input |
| 10 | Border Identification Type Code | /MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/IdentificationTypeCode | Dropdown / code list |
| 11 | Border Registration Nationality Code | /MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/RegistrationNationalityCode | Country dropdown |
| 12 | Border Mode Code | /MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/ModeCode | Dropdown / code list |
4.4 Departure transport
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 13 | Departure Transport Sequence | /MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/SequenceNumeric | Number input |
| 14 | Departure Transport ID | /MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/ID | Text input |
| 15 | Departure Identification Type Code | /MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/IdentificationTypeCode | Dropdown / code list |
| 16 | Departure Registration Nationality Code | /MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/RegistrationNationalityCode | Country dropdown |
| 17 | Departure Mode Code | /MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/ModeCode | Dropdown / code list |
4.5 Goods location
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 18 | Goods Location ID | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/ID | Text input |
| 19 | Goods Location Type Code | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/TypeCode | Dropdown / code list |
| 20 | Latitude | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/LatitudeID | Coordinate input |
| 21 | Longitude | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/LongitudeID | Coordinate input |
| 22 | Location Identification Type Code | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/IdentificationTypeCode | Dropdown / code list |
| 23 | Location Authorization ID | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/AuthorizationID | Text input |
| 24 | Location Additional Identifier | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/AdditionalIdentifierID | Text input |
| 25 | Location Address Line | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/Line | Text input |
| 26 | Location Street Number | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/StreetNumberID | Text input |
| 27 | Location City | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/CityName | Text input |
| 28 | Location Postcode | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/PostcodeID | Text input |
| 29 | Location Country Code | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/CountryCode | Country dropdown |
| 30 | Location Customs Office ID | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/CustomsOffice/ID | Lookup |
| 31 | Location Economic Operator ID | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/EconomicOperator/ID | Text input |
| 32 | Location Contact Name | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Contact/Name | Text input |
| 33 | Location Communication Type | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Contact/Communication/TypeCode | Dropdown |
| 34 | Location Communication ID | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Contact/Communication/ID | Text input |
4.6 Repeatable transport grids
Itinerary grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Sequence | /MetaData/Declaration/GoodsShipment/Consignment/Itinerary/SequenceNumeric |
| 2 | Routing Country Code | /MetaData/Declaration/GoodsShipment/Consignment/Itinerary/RoutingCountryCode |
Transport contract document grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Sequence | /MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/SequenceNumeric |
| 2 | Document Type Code | /MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/TypeCode |
| 3 | Document ID | /MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/ID |
Transport equipment grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Equipment Sequence | /MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/SequenceNumeric |
| 2 | Equipment ID | /MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/ID |
| 3 | Seals Affixed Quantity | /MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/SealsAffixedQuantity |
| 4 | Seal Sequence | /MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/Seal/SequenceNumeric |
| 5 | Seal ID | /MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/Seal/ID |
| 6 | Goods Reference Sequence | /MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/GoodsReference/SequenceNumeric |
| 7 | Goods Item Number | /MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/GoodsReference/GoodsItemNumeric |
Tab 5 — Goods Items
Purpose
Capture product, commodity, origin, packaging and item-specific parties.
This tab should be a repeatable goods item section.
Recommended layout:
- Goods item list/grid on the left or top
- Detail form for selected goods item
- Sub-grids for classification, packaging, documents, tax, etc.
5.1 Goods item summary
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Goods Item Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric | Number input |
| 2 | Goods Description | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Description | Long text |
| 3 | Customs Value Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValueAmount | Amount input |
| 4 | Customs Value Currency | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValueAmount/@currencyID | Currency dropdown |
| 5 | Statistical Value Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/StatisticalValueAmount | Amount input |
| 6 | Transaction Nature Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/TransactionNatureCode | Dropdown / code list |
| 7 | Dispatch Country Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/DispatchCountryCode | Country dropdown |
| 8 | Acceptance Date | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/AcceptanceDateTime | Date picker |
5.2 Commodity classification
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 9 | Classification Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/SequenceNumeric | Number input |
| 10 | Classification ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/ID | Text/code input |
| 11 | Classification Identification Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/IdentificationTypeCode | Dropdown / code list |
| 12 | Classification Qualifier Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/CCQualifierCode | Dropdown |
5.3 Goods measure
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 13 | Gross Mass | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/GrossMassMeasure | Decimal input |
| 14 | Net Net Weight | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/NetNetWeightMeasure | Decimal input |
| 15 | Tariff Quantity | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/TariffQuantity | Decimal input |
| 16 | Item Charge Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/InvoiceLine/ItemChargeAmount | Amount input |
5.4 Origin and destination
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 17 | Origin Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/SequenceNumeric | Number input |
| 18 | Origin Country Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/CountryCode | Country dropdown |
| 19 | Origin Region ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/RegionID | Text input |
| 20 | Origin Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/TypeCode | Dropdown / code list |
| 21 | Item Destination Country Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Destination/CountryCode | Country dropdown |
| 22 | Item Destination Region ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Destination/RegionID | Text input |
| 23 | Item Destination Qualifier Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Destination/CCQualifierCode | Dropdown |
| 24 | Item Export Country ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/ExportCountry/ID | Country dropdown |
5.5 Item-level parties
Use collapsible party panels to avoid crowding the screen.
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 25 | Item Buyer Name | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Buyer/Name | Text input |
| 26 | Item Buyer ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Buyer/ID | Text input |
| 27 | Item Consignee Name | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Consignee/Name | Text input |
| 28 | Item Consignee ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Consignee/ID | Text input |
| 29 | Item Consignor Name | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Consignor/Name | Text input |
| 30 | Item Consignor ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Consignor/ID | Text input |
| 31 | Item Exporter Name | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Exporter/Name | Text input |
| 32 | Item Exporter ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Exporter/ID | Text input |
| 33 | Item Seller Name | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Seller/Name | Text input |
| 34 | Item Seller ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Seller/ID | Text input |
5.6 Packaging grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/SequenceNumeric |
| 2 | Marks and Numbers | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/MarksNumbersID |
| 3 | Quantity | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/QuantityQuantity |
| 4 | Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/TypeCode |
5.7 Dangerous goods grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/DangerousGoods/SequenceNumeric |
| 2 | UNDG ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/DangerousGoods/UNDGID |
5.8 Government procedure
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 35 | Current Procedure Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/CurrentCode | Dropdown / code list |
| 36 | Previous Procedure Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/PreviousCode | Dropdown / code list |
Additional procedure grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/AdditionalProcedure/SequenceNumeric |
| 2 | Procedure Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/AdditionalProcedure/ProcedureCode |
| 3 | Qualifier Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/AdditionalProcedure/CCQualifierCode |
Tab 6 — Documents & References
Purpose
Capture repeatable references, supporting documents, previous documents and authorisations.
6.1 Declaration authorisations grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Sequence | /MetaData/Declaration/Authorisation/SequenceNumeric |
| 2 | Authorisation Type Code | /MetaData/Declaration/Authorisation/TypeCode |
| 3 | Authorisation ID | /MetaData/Declaration/Authorisation/ID |
| 4 | Authorisation Holder ID | /MetaData/Declaration/Authorisation/AuthorisationHolder/ID |
6.2 Shipment additional references grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Sequence | /MetaData/Declaration/GoodsShipment/AdditionalReference/SequenceNumeric |
| 2 | Type Code | /MetaData/Declaration/GoodsShipment/AdditionalReference/TypeCode |
| 3 | Reference ID | /MetaData/Declaration/GoodsShipment/AdditionalReference/ID |
| 4 | Qualifier Code | /MetaData/Declaration/GoodsShipment/AdditionalReference/CCQualifierCode |
6.3 Shipment additional information grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Sequence | /MetaData/Declaration/GoodsShipment/AdditionalInformation/SequenceNumeric |
| 2 | Statement Code | /MetaData/Declaration/GoodsShipment/AdditionalInformation/StatementCode |
| 3 | Statement Description | /MetaData/Declaration/GoodsShipment/AdditionalInformation/StatementDescription |
| 4 | Qualifier Code | /MetaData/Declaration/GoodsShipment/AdditionalInformation/CCQualifierCode |
6.4 Shipment previous documents grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Sequence | /MetaData/Declaration/GoodsShipment/PreviousDocument/SequenceNumeric |
| 2 | Type Code | /MetaData/Declaration/GoodsShipment/PreviousDocument/TypeCode |
| 3 | Document ID | /MetaData/Declaration/GoodsShipment/PreviousDocument/ID |
| 4 | Qualifier Code | /MetaData/Declaration/GoodsShipment/PreviousDocument/CCQualifierCode |
6.5 Shipment supporting documents grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Sequence | /MetaData/Declaration/GoodsShipment/SupportingDocument/SequenceNumeric |
| 2 | Type Code | /MetaData/Declaration/GoodsShipment/SupportingDocument/TypeCode |
| 3 | Document ID | /MetaData/Declaration/GoodsShipment/SupportingDocument/ID |
| 4 | Expiration Date | /MetaData/Declaration/GoodsShipment/SupportingDocument/ExpirationDateTime |
| 5 | Line Number | /MetaData/Declaration/GoodsShipment/SupportingDocument/LineNumeric |
| 6 | Qualifier Code | /MetaData/Declaration/GoodsShipment/SupportingDocument/CCQualifierCode |
| 7 | Submitter Name | /MetaData/Declaration/GoodsShipment/SupportingDocument/Submitter/Name |
6.6 Item-level references and documents
These should be displayed inside each goods item, but can also be summarised in this tab.
Item additional references grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Goods Item Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric |
| 2 | Reference Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/AdditionalReference/SequenceNumeric |
| 3 | Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/AdditionalReference/TypeCode |
| 4 | Reference ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/AdditionalReference/ID |
| 5 | Qualifier Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/AdditionalReference/CCQualifierCode |
Item previous documents grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Goods Item Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric |
| 2 | Document Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/SequenceNumeric |
| 3 | Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/TypeCode |
| 4 | Document ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/ID |
| 5 | Line Number | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/LineNumeric |
| 6 | Qualifier Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/CCQualifierCode |
| 7 | Write-off Quantity | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/WriteOff/QuantityQuantity |
| 8 | Write-off Packaging Quantity | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/WriteOff/Packaging/QuantityQuantity |
| 9 | Write-off Packaging Type | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/WriteOff/Packaging/TypeCode |
Item supporting documents grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Goods Item Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric |
| 2 | Document Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/SequenceNumeric |
| 3 | Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/TypeCode |
| 4 | Document ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/ID |
| 5 | Expiration Date | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/ExpirationDateTime |
| 6 | Line Number | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/LineNumeric |
| 7 | Qualifier Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/CCQualifierCode |
| 8 | Submitter Name | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/Submitter/Name |
| 9 | Write-off Quantity | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/WriteOff/QuantityQuantity |
| 10 | Write-off Quantity Unit | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/WriteOff/QuantityQuantity/@unitCode |
| 11 | Write-off Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/WriteOff/AmountAmount |
| 12 | Write-off Amount Currency | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/WriteOff/AmountAmount/@currencyID |
Tab 7 — Valuation, Duties & Taxes
Purpose
Capture values, charges, deductions, duties, taxes and tax base information.
7.1 Declaration-level valuation
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Declaration Freight Charge Amount | /MetaData/Declaration/CustomsValuation/FreightChargeAmount | Amount input |
| 2 | Declaration Freight Charge Currency | /MetaData/Declaration/CustomsValuation/FreightChargeAmount/@currencyID | Currency dropdown |
7.2 Shipment-level charge/deduction grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Sequence | /MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/SequenceNumeric |
| 2 | Charges Type Code | /MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/ChargesTypeCode |
| 3 | Amount | /MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount |
| 4 | Currency | /MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount/@currencyID |
7.3 Item-level valuation
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Goods Item Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric | Item selector |
| 2 | Valuation Method Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/MethodCode | Dropdown / code list |
| 3 | Valuation Addition Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/ValuationAdjustment/AdditionCode | Dropdown / code list |
Item charge/deduction grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Goods Item Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric |
| 2 | Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/SequenceNumeric |
| 3 | Charges Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/ChargesTypeCode |
| 4 | Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount |
| 5 | Currency | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount/@currencyID |
7.4 Duty/tax calculation grid
| Column order | Field label | XML path |
|---|---|---|
| 1 | Goods Item Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric |
| 2 | Tax Assessed Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/TaxAssessedAmount |
| 3 | Quota Order ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/QuotaOrderID |
| 4 | Duty Regime Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyRegimeCode |
| 5 | Duty/Tax/Fee Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/SequenceNumeric |
| 6 | Duty/Tax/Fee Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TypeCode |
| 7 | Duty/Tax/Fee Qualifier Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/CCQualifierCode |
| 8 | Payment Method Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/Payment/MethodCode |
| 9 | Payment Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/Payment/PaymentAmount |
| 10 | Tax Base Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/SequenceNumeric |
| 11 | Tax Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/TaxAmount |
| 12 | Ad Valorem Tax Base Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/AdValoremTaxBaseAmount |
| 13 | Specific Tax Base Quantity | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/SpecificTaxBaseQuantity |
| 14 | Specific Tax Base Unit Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/SpecificTaxBaseQuantity/@unitCode |
| 15 | Tax Rate | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/TaxRateNumeric |
Tab 8 — Guarantee & Payment
Purpose
Capture deferred payment, guarantee, payer and surety information.
| Order | Field label | XML path | UI control |
|---|---|---|---|
| 1 | Deferred Payment ID | /MetaData/Declaration/DeferredPayment/ID | Text input |
| 2 | Payer ID | /MetaData/Declaration/Payer/ID | Text input |
| 3 | Surety ID | /MetaData/Declaration/Surety/ID | Text input |
| 4 | Obligation Guarantee Sequence | /MetaData/Declaration/ObligationGuarantee/SequenceNumeric | Number input |
| 5 | Security Details Code | /MetaData/Declaration/ObligationGuarantee/SecurityDetailsCode | Dropdown / code list |
| 6 | Guarantee Amount | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AmountAmount | Amount input |
| 7 | Guarantee Amount Currency | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AmountAmount/@currencyID | Currency dropdown |
| 8 | Guarantee Reference ID | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/ID | Text input |
| 9 | Guarantee Sequence | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/SequenceNumeric | Number input |
| 10 | Guarantee Access Code | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AccessCode | Text input |
| 11 | Guarantee External Reference ID | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/ReferenceID | Text input |
| 12 | Guarantee Qualifier Code | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/CCQualifierCode | Dropdown |
| 13 | Guarantee Office ID | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/GuaranteeOffice/ID | Lookup |
Tab 9 — Review & Submit
Purpose
Allow the user to validate, review and submit the declaration.
| Order | Field / action | UI control | Description |
|---|---|---|---|
| 1 | Validation Status | Status panel | Shows errors, warnings and missing mandatory data |
| 2 | Declaration Summary | Read-only summary | Declaration ID, type, parties, shipment, goods count |
| 3 | Goods Items Summary | Grid | Shows goods items, commodity description, value, weight |
| 4 | Documents Summary | Grid | Shows attached/declared supporting and previous documents |
| 5 | Duties & Taxes Summary | Grid | Shows assessed taxes, payments and duty/tax fee lines |
| 6 | XML Preview | Expandable XML viewer | Generated XML based on keyed-in data |
| 7 | Save Draft | Button | Save without submission |
| 8 | Validate | Button | Run business and XML validation |
| 9 | Submit Declaration | Button | Final submission |
| 10 | Export XML | Button | Download generated XML |
Extended version
DMS_Customs_Declaration_UI_Field_Order_with_UCC_Annex_B.xlsx
DMS_Customs_Declaration_UI_Field_Order_with_UCC_Annex_B.docx
Tab 1 — Declaration Header
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | WCO Type Code | /MetaData/WCOTypeCode | Technical metadata | Message / WCO type | Text input | Identifies the WCO/DMS message or declaration type being created. | R |
| 2 | Application Reference ID | /MetaData/CommunicationMetaData/ApplicationReferenceID | Technical metadata | Application reference | Text input | Reference assigned by the sending application for tracking the message. | R |
| 3 | Communications Agreement ID | /MetaData/CommunicationMetaData/CommunicationsAgreementID | Technical metadata | Communications agreement reference | Text input | Agreement or interface reference between sender and recipient systems. | D |
| 4 | Sender ID | /MetaData/CommunicationMetaData/Sender/ID | Technical metadata | Sender identification | Text input | Identifier of the party or system sending the declaration message. | R |
| 5 | Recipient ID | /MetaData/CommunicationMetaData/Recipient/ID | Technical metadata | Recipient identification | Text input | Identifier of the receiving customs/DMS system or party. | R |
| 6 | Preparation Date/Time | /MetaData/CommunicationMetaData/PreparationDateTime | Technical metadata | Preparation date and time | Date/time picker | Date and time when the declaration message was prepared. | R |
| 7 | Functional Reference ID | /MetaData/Declaration/FunctionalReferenceID | 12 01 000 000 | Previous document / reference number or LRN depending national implementation | Text input | Business reference used to identify and track the declaration functionally. | R |
| 8 | Declaration ID | /MetaData/Declaration/ID | 12 09 000 000 | LRN / MRN / declaration identifier depending message status | Text input | Unique customs declaration identifier. | R |
| 9 | Declaration Type Code | /MetaData/Declaration/TypeCode | 11 01 000 000 | Declaration type | Dropdown / code list | Code indicating the type of customs declaration being submitted. | R |
| 10 | Language Code | /MetaData/Declaration/LanguageCode | To be confirmed by national DMS mapping | Language | Dropdown | Language used for declaration text fields. | O |
| 11 | Specific Circumstances Code | /MetaData/Declaration/SpecificCircumstancesCode | 11 10 000 000 | Additional declaration type / specific circumstance indicator | Dropdown / code list | Code for any special circumstances applying to the declaration. | D |
| 12 | Security Code | /MetaData/Declaration/SecurityCode | 11 07 000 000 | Security | Dropdown / code list | Security indicator used when safety/security data is required. | D |
| 13 | Presentation Date/Time | /MetaData/Declaration/PresentationDateTime | 15 09 000 000 | Presentation date and time | Date/time picker | Date and time the declaration is presented to customs. | R |
| 14 | Declaration Office ID | /MetaData/Declaration/DeclarationOffice/ID | 17 09 000 000 | Customs office of presentation / customs office of declaration | Lookup | Customs office where the declaration is lodged. | R |
| 15 | Exit Office ID | /MetaData/Declaration/ExitOffice/ID | 17 01 000 000 | Customs office of exit | Lookup | Customs office of exit, where applicable. | D |
| 16 | Presentation Office ID | /MetaData/Declaration/PresentationOffice/ID | 17 09 000 000 | Customs office of presentation | Lookup | Customs office where the goods or declaration are physically/electronically presented. | D |
| 17 | Supervising Office ID | /MetaData/Declaration/SupervisingOffice/ID | 17 10 000 000 | Supervising customs office | Lookup | Customs office supervising the declaration or special procedure. | D |
Tab 2 — Parties
2.1 Declarant
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Declarant Name | /MetaData/Declaration/Declarant/Name | 13 05 016 000 | Declarant name | Text input | Name of the person or company lodging the declaration. | R |
| 2 | Declarant ID | /MetaData/Declaration/Declarant/ID | 13 05 017 000 | Declarant identification number | Text input | Identification number of the declarant. | R |
| 3 | Declarant Address Line | /MetaData/Declaration/Declarant/Address/Line | 13 05 018 019 | Declarant street and number / address line | Text input | Street name, building, PO box or main address line. | D |
| 4 | Declarant City | /MetaData/Declaration/Declarant/Address/CityName | 13 05 018 020 | Declarant city | Text input | City of the declarant address. | D |
| 5 | Declarant Postcode | /MetaData/Declaration/Declarant/Address/PostcodeID | 13 05 018 021 | Declarant postcode | Text input | Postal or ZIP code of the declarant address. | D |
| 6 | Declarant Country Code | /MetaData/Declaration/Declarant/Address/CountryCode | 13 05 018 020/021/022 | Declarant country | Country dropdown | Country where the declarant is established or addressed. | D |
| 7 | Declarant Contact Name | /MetaData/Declaration/Declarant/Contact/Name | 13 05 074 000 | Declarant contact person | Text input | Name of the declarant’s contact person. | D |
| 8 | Declarant Communication Type | /MetaData/Declaration/Declarant/Contact/Communication/TypeCode | 13 05 074 000 | Declarant communication type | Dropdown | Type of contact detail, such as telephone or email. | D |
| 9 | Declarant Communication ID | /MetaData/Declaration/Declarant/Contact/Communication/ID | 13 05 074 000 | Declarant communication detail | Text input | Actual contact detail, such as phone number or email address. | D |
2.2 Representative / Agent
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Agent ID | /MetaData/Declaration/Agent/ID | 13 06 017 000 | Representative identification number | Text input | Identification number of the agent or customs representative. | D |
| 2 | Agent Function Code | /MetaData/Declaration/Agent/FunctionCode | 13 06 030 000 | Representative status | Dropdown / code list | Code describing the agent’s representation status or role. | D |
| 3 | Agent Contact Name | /MetaData/Declaration/Agent/Contact/Name | 13 06 074 000 | Representative contact person | Text input | Name of the agent’s contact person. | D |
| 4 | Agent Communication Type | /MetaData/Declaration/Agent/Contact/Communication/TypeCode | 13 06 074 000 | Representative communication type | Dropdown | Type of communication detail, such as email or telephone. | D |
| 5 | Agent Communication ID | /MetaData/Declaration/Agent/Contact/Communication/ID | 13 06 074 000 | Representative communication detail | Text input | Actual communication detail of the agent. | D |
2.3 Importer
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Importer Name | /MetaData/Declaration/Importer/Name | 13 04 016 000 | Importer name | Text input | Name of the party importing the goods. | D |
| 2 | Importer ID | /MetaData/Declaration/Importer/ID | 13 04 017 000 | Importer identification number | Text input | Identification number of the importer. | D |
| 3 | Importer Address Line | /MetaData/Declaration/Importer/Address/Line | 13 04 018 019 | Importer street and number / address line | Text input | Street name, building, PO box or main address line of the importer. | D |
| 4 | Importer City | /MetaData/Declaration/Importer/Address/CityName | 13 04 018 020 | Importer city | Text input | City of the importer address. | D |
| 5 | Importer Postcode | /MetaData/Declaration/Importer/Address/PostcodeID | 13 04 018 021 | Importer postcode | Text input | Postal or ZIP code of the importer address. | D |
| 6 | Importer Country Code | /MetaData/Declaration/Importer/Address/CountryCode | 13 04 018 022 | Importer country | Country dropdown | Country where the importer is established or addressed. | D |
2.4 Exporter
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Exporter Name | /MetaData/Declaration/Exporter/Name | 13 01 016 000 | Exporter name | Text input | Name of the exporter at declaration level. | D |
| 2 | Exporter ID | /MetaData/Declaration/Exporter/ID | 13 01 017 000 | Exporter identification number | Text input | Identification number of the declaration-level exporter. | D |
| 3 | Exporter Address Line | /MetaData/Declaration/Exporter/Address/Line | 13 01 018 019 | Exporter street and number / address line | Text input | Street name, building, PO box or main address line of the exporter. | D |
| 4 | Exporter City | /MetaData/Declaration/Exporter/Address/CityName | 13 01 018 020 | Exporter city | Text input | City of the exporter address. | D |
| 5 | Exporter Postcode | /MetaData/Declaration/Exporter/Address/PostcodeID | 13 01 018 021 | Exporter postcode | Text input | Postal or ZIP code of the exporter address. | D |
| 6 | Exporter Country Code | /MetaData/Declaration/Exporter/Address/CountryCode | 13 01 018 022 | Exporter country | Country dropdown | Country where the exporter is established or addressed. | D |
2.5 Buyer
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Buyer Name | /MetaData/Declaration/GoodsShipment/Buyer/Name | 13 02 016 000 | Buyer name | Text input | Name of the party buying the goods. | D |
| 2 | Buyer ID | /MetaData/Declaration/GoodsShipment/Buyer/ID | 13 02 017 000 | Buyer identification number | Text input | Identification number of the buyer. | D |
| 3 | Buyer Address Line | /MetaData/Declaration/GoodsShipment/Buyer/Address/Line | 13 02 018 019 | Buyer street and number / address line | Text input | Street name, building, PO box or main address line of the buyer. | D |
| 4 | Buyer City | /MetaData/Declaration/GoodsShipment/Buyer/Address/CityName | 13 02 018 020 | Buyer city | Text input | City of the buyer address. | D |
| 5 | Buyer Postcode | /MetaData/Declaration/GoodsShipment/Buyer/Address/PostcodeID | 13 02 018 021 | Buyer postcode | Text input | Postal or ZIP code of the buyer address. | D |
| 6 | Buyer Country Code | /MetaData/Declaration/GoodsShipment/Buyer/Address/CountryCode | 13 02 018 022 | Buyer country | Country dropdown | Country where the buyer is established or addressed. | D |
2.6 Seller
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Seller Name | /MetaData/Declaration/GoodsShipment/Seller/Name | 13 03 016 000 | Seller name | Text input | Name of the party selling the goods. | D |
| 2 | Seller ID | /MetaData/Declaration/GoodsShipment/Seller/ID | 13 03 017 000 | Seller identification number | Text input | Identification number of the seller. | D |
| 3 | Seller Address Line | /MetaData/Declaration/GoodsShipment/Seller/Address/Line | 13 03 018 019 | Seller street and number / address line | Text input | Street name, building, PO box or main address line of the seller. | D |
| 4 | Seller City | /MetaData/Declaration/GoodsShipment/Seller/Address/CityName | 13 03 018 020 | Seller city | Text input | City of the seller address. | D |
| 5 | Seller Postcode | /MetaData/Declaration/GoodsShipment/Seller/Address/PostcodeID | 13 03 018 021 | Seller postcode | Text input | Postal or ZIP code of the seller address. | D |
| 6 | Seller Country Code | /MetaData/Declaration/GoodsShipment/Seller/Address/CountryCode | 13 03 018 022 | Seller country | Country dropdown | Country where the seller is established or addressed. | D |
2.7 Consignee
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Consignee Name | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/Name | 13 10 016 000 | Consignee name | Text input | Name of the party receiving the goods. | D |
| 2 | Consignee ID | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/ID | 13 10 017 000 | Consignee identification number | Text input | Identification number of the consignee. | D |
| 3 | Consignee Address Line | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/Line | 13 10 018 019 | Consignee street and number / address line | Text input | Street name, building, PO box or main address line of the consignee. | D |
| 4 | Consignee City | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/CityName | 13 10 018 020 | Consignee city | Text input | City of the consignee address. | D |
| 5 | Consignee Postcode | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/PostcodeID | 13 10 018 021 | Consignee postcode | Text input | Postal or ZIP code of the consignee address. | D |
| 6 | Consignee Country Code | /MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/CountryCode | 13 10 018 022 | Consignee country | Country dropdown | Country where the consignee is established or addressed. | D |
2.8 Consignor
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Consignor Name | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/Name | 13 09 016 000 | Consignor name | Text input | Name of the party sending the goods. | D |
| 2 | Consignor ID | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/ID | 13 09 017 000 | Consignor identification number | Text input | Identification number of the consignor. | D |
| 3 | Consignor Address Line | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/Line | 13 09 018 019 | Consignor street and number / address line | Text input | Street name, building, PO box or main address line of the consignor. | D |
| 4 | Consignor City | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/CityName | 13 09 018 020 | Consignor city | Text input | City of the consignor address. | D |
| 5 | Consignor Postcode | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/PostcodeID | 13 09 018 021 | Consignor postcode | Text input | Postal or ZIP code of the consignor address. | D |
| 6 | Consignor Country Code | /MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/CountryCode | 13 09 018 022 | Consignor country | Country dropdown | Country where the consignor is established or addressed. | D |
Tab 3 — Shipment Details
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Shipment Sequence | /MetaData/Declaration/GoodsShipment/SequenceNumeric | Technical / structural | Goods shipment sequence | Number input | Sequence number for the goods shipment. | R |
| 2 | Transaction Nature Code | /MetaData/Declaration/GoodsShipment/TransactionNatureCode | 99 05 000 000 | Nature of transaction | Dropdown / code list | Code describing the nature of the transaction, such as sale, return or transfer. | R |
| 3 | Dispatch Country Code | /MetaData/Declaration/GoodsShipment/DispatchCountryCode | 16 06 000 000 | Country of dispatch | Country dropdown | Country from which the goods are dispatched. | R |
| 4 | Export Country ID | /MetaData/Declaration/GoodsShipment/ExportCountry/ID | 16 07 000 000 | Country of export | Country dropdown | Country from which the goods are exported. | D |
| 5 | Destination Country Code | /MetaData/Declaration/GoodsShipment/Destination/CountryCode | 16 03 000 000 | Country of destination | Country dropdown | Final destination country of the goods. | R |
| 6 | Destination Region ID | /MetaData/Declaration/GoodsShipment/Destination/RegionID | 16 04 000 000 | Region of destination | Text input | Region/state/province of destination, if required. | D |
| 7 | Destination Qualifier Code | /MetaData/Declaration/GoodsShipment/Destination/CCQualifierCode | To be confirmed by national DMS mapping | Destination qualifier | Dropdown | Qualifier providing context for destination data. | D |
| 8 | Invoice Amount | /MetaData/Declaration/GoodsShipment/InvoiceAmount | 14 06 000 000 | Total amount invoiced | Amount input | Total invoice value for the shipment. | R |
| 9 | Invoice Currency Code | /MetaData/Declaration/GoodsShipment/InvoiceCurrencyCode | 14 05 000 000 | Invoice currency | Currency dropdown | Currency used on the commercial invoice. | R |
| 10 | Acceptance Date | /MetaData/Declaration/GoodsShipment/AcceptanceDateTime | 15 09 000 000 or national mapping | Acceptance date | Date picker | Date of customs or commercial acceptance, depending on DMS rule. | D |
| 11 | Currency Exchange Currency | /MetaData/Declaration/GoodsShipment/CurrencyExchange/CurrencyTypeCode | 14 05 000 000 / valuation mapping | Currency for exchange | Currency dropdown | Currency for exchange-rate conversion, where valuation requires it. | D |
| 12 | Currency Exchange Rate | /MetaData/Declaration/GoodsShipment/CurrencyExchange/RateNumeric | 14 15 000 000 | Exchange rate | Decimal input | Exchange rate used to convert invoice or customs value. | D |
| 13 | Trade Term Condition Code | /MetaData/Declaration/GoodsShipment/TradeTerms/ConditionCode | 14 01 000 000 | Delivery terms | Incoterm dropdown | Incoterm condition, for example FOB. FOB means Free on Board. | R |
| 14 | Trade Term Description | /MetaData/Declaration/GoodsShipment/TradeTerms/Description | 14 01 000 000 | Delivery terms description | Text input | Free-text description of the trade terms, if needed. | O |
| 15 | Trade Term Location ID | /MetaData/Declaration/GoodsShipment/TradeTerms/LocationID | 14 01 000 000 | Delivery terms place code | Text input | Code or identifier of the named place for the Incoterm. | D |
| 16 | Trade Term Location Name | /MetaData/Declaration/GoodsShipment/TradeTerms/LocationName | 14 01 000 000 | Delivery terms place | Text input | Name of the place linked to the Incoterm, such as port or terminal. | D |
| 17 | Trade Term Country Code | /MetaData/Declaration/GoodsShipment/TradeTerms/CountryCode | 14 01 000 000 | Delivery terms country | Country dropdown | Country of the Incoterm location. | D |
| 18 | Warehouse ID | /MetaData/Declaration/GoodsShipment/Warehouse/ID | 12 11 000 000 or procedure-specific | Warehouse identifier | Text input | Warehouse identifier when goods are stored under customs warehousing. | D |
| 19 | Warehouse Type Code | /MetaData/Declaration/GoodsShipment/Warehouse/TypeCode | 12 11 000 000 or procedure-specific | Warehouse type | Dropdown / code list | Type of customs warehouse or storage facility. | D |
Tab 4 — Transport & Consignment
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Container Code | /MetaData/Declaration/GoodsShipment/Consignment/ContainerCode | 19 07 000 000 | Container indicator | Dropdown / code list | Indicates whether the goods are containerised. | D |
| 2 | Total Gross Mass | /MetaData/Declaration/GoodsShipment/Consignment/TotalGrossMassMeasure | 18 04 000 000 | Gross mass | Decimal input | Total gross weight of the consignment including packaging. | R |
| 3 | Carrier ID | /MetaData/Declaration/GoodsShipment/Consignment/Carrier/ID | 13 12 017 000 | Carrier identification number | Text input | Identifier of the carrier transporting the goods. | D |
| 4 | Consignment UCR | /MetaData/Declaration/GoodsShipment/Consignment/UCR/TraderAssignedReferenceID | 12 08 000 000 | Reference number / UCR | Text input | Trader-assigned unique consignment reference. | D |
| 5 | Arrival Transport ID | /MetaData/Declaration/GoodsShipment/Consignment/ArrivalTransportMeans/ID | 19 05 017 000 | Identification of means of transport on arrival | Text input | Identification of the transport means on arrival. | D |
| 6 | Arrival Mode Code | /MetaData/Declaration/GoodsShipment/Consignment/ArrivalTransportMeans/ModeCode | 19 03 000 000 | Mode of transport at arrival | Dropdown | Mode of transport on arrival. | D |
| 7 | Border Transport ID | /MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/ID | 19 06 017 000 | Identification of means of transport crossing the border | Text input | Identification of the transport crossing the border. | D |
| 8 | Border Registration Nationality Code | /MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/RegistrationNationalityCode | 19 08 000 000 | Nationality of active means of transport crossing the border | Country dropdown | Country of registration or nationality of border transport. | D |
| 9 | Border Mode Code | /MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/ModeCode | 19 03 000 000 / 19 04 000 000 | Mode of transport at the border | Dropdown | Mode of transport at the border crossing. | D |
| 10 | Departure Transport ID | /MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/ID | 19 05 017 000 or national mapping | Identification of means of transport at departure | Text input | Identification of the transport means at departure. | D |
| 11 | Goods Location ID | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/ID | 16 15 000 000 | Location of goods | Text input | Identifier of the place where goods are available for customs control or inspection. | D |
| 12 | Goods Location Type Code | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/TypeCode | 16 15 000 000 | Location of goods type | Dropdown | Code describing the type of goods location. | D |
| 13 | Goods Location Address | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/Line | 16 15 000 000 | Location of goods address | Text input | Physical address of the goods location. | D |
| 14 | Goods Location Latitude | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/LatitudeID | 16 15 000 000 | Location of goods latitude | Coordinate input | Latitude coordinate of the goods location. | O |
| 15 | Goods Location Longitude | /MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/LongitudeID | 16 15 000 000 | Location of goods longitude | Coordinate input | Longitude coordinate of the goods location. | O |
| 16 | Itinerary Routing Country | /MetaData/Declaration/GoodsShipment/Consignment/Itinerary/RoutingCountryCode | 16 12 000 000 | Country of routing | Repeatable grid | Country through which the goods travel. | D |
| 17 | Transport Contract Document ID | /MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/ID | 12 05 000 000 | Transport document | Repeatable grid | Reference number of the transport contract document. | D |
| 18 | Transport Contract Document Type Code | /MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/TypeCode | 12 05 000 000 | Transport document type | Repeatable grid | Type of transport document, such as bill of lading or waybill. | D |
| 19 | Transport Equipment ID | /MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/ID | 19 07 063 000 | Container identification number | Repeatable grid | Container or transport equipment number. | D |
| 20 | Seal ID | /MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/Seal/ID | 19 10 000 000 | Seal number | Repeatable grid | Seal number attached to the container or equipment. | D |
Tab 5 — Goods Items
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Goods Item Sequence | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric | 11 03 000 000 | Goods item number | Number input | Line number or sequence of the goods item. | R |
| 2 | Goods Description | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Description | 18 05 000 000 | Description of goods | Long text | Plain-language description of the goods being declared. | R |
| 3 | Customs Value Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValueAmount | 14 07 000 000 | Customs value | Amount input | Customs value of the goods item. | R |
| 4 | Customs Value Currency | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValueAmount/@currencyID | 14 07 000 000 | Customs value currency | Currency dropdown | Currency of the customs value amount. | R |
| 5 | Statistical Value Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/StatisticalValueAmount | 99 06 000 000 | Statistical value | Amount input | Statistical value used for customs or trade statistics. | D |
| 6 | Item Transaction Nature Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/TransactionNatureCode | 99 05 000 000 | Nature of transaction | Dropdown | Nature of transaction at goods item level, if different from shipment level. | D |
| 7 | Item Dispatch Country Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/DispatchCountryCode | 16 06 000 000 | Country of dispatch | Country dropdown | Dispatch country at goods item level, if different from shipment level. | D |
| 8 | Classification ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/ID | 18 09 056 000 | Commodity code | Text/code input | Commodity classification code, such as HS, CN or TARIC depending on DMS rules. | R |
| 9 | Classification Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/IdentificationTypeCode | 18 09 056 000 | Commodity code type | Dropdown | Indicates which classification code system is used. | R |
| 10 | Gross Mass | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/GrossMassMeasure | 18 04 000 000 | Gross mass | Decimal input | Gross weight of the goods item including packaging. | R |
| 11 | Net Net Weight | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/NetNetWeightMeasure | 18 01 000 000 | Net mass | Decimal input | Net weight excluding packaging, if required by the commodity or procedure. | D |
| 12 | Tariff Quantity | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/TariffQuantity | 18 02 000 000 | Supplementary units | Decimal input | Supplementary/tariff quantity required for tariff/statistical purposes. | D |
| 13 | Origin Country Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/CountryCode | 16 08 000 000 | Country of origin | Country dropdown | Country of origin of the goods item. | R |
| 14 | Preferential Origin / Origin Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/TypeCode | 16 09 000 000 or national mapping | Preferential origin country / origin type | Dropdown | Code indicating the type or basis of origin, where applicable. | D |
| 15 | Packaging Quantity | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/QuantityQuantity | 18 06 004 000 | Number of packages | Repeatable grid | Number of packages. | D |
| 16 | Packaging Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/TypeCode | 18 06 003 000 | Kind of packages | Repeatable grid | Code describing the type of packaging. | D |
| 17 | Marks and Numbers | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/MarksNumbersID | 18 06 054 000 | Shipping marks | Repeatable grid | Shipping marks or package identification markings. | D |
| 18 | UNDG ID | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/DangerousGoods/UNDGID | 18 07 000 000 | Dangerous goods UN number | Repeatable grid | UN dangerous goods number, if goods are dangerous. | D |
| 19 | Current Procedure Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/CurrentCode | 11 09 001 000 | Requested procedure | Dropdown | Customs procedure requested for the goods item. | R |
| 20 | Previous Procedure Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/PreviousCode | 11 09 002 000 | Previous procedure | Dropdown | Previous customs procedure, where applicable. | D |
| 21 | Additional Procedure Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/AdditionalProcedure/ProcedureCode | 11 10 000 000 | Additional procedure | Repeatable grid | Additional procedure code applicable to the goods item. | D |
Tab 6 — Documents & References
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Authorisation ID | /MetaData/Declaration/Authorisation/ID | 12 12 001 000 | Authorisation reference number | Repeatable grid | Reference number of the customs authorisation. | D |
| 2 | Authorisation Type Code | /MetaData/Declaration/Authorisation/TypeCode | 12 12 002 000 | Authorisation type | Repeatable grid | Type of customs authorisation. | D |
| 3 | Authorisation Holder ID | /MetaData/Declaration/Authorisation/AuthorisationHolder/ID | 12 12 080 000 | Authorisation holder | Repeatable grid | Identifier of the party holding the authorisation. | D |
| 4 | Additional Reference ID | /MetaData/Declaration/GoodsShipment/AdditionalReference/ID | 12 04 001 000 | Additional reference number | Repeatable grid | Additional commercial/customs reference. | D |
| 5 | Additional Reference Type Code | /MetaData/Declaration/GoodsShipment/AdditionalReference/TypeCode | 12 04 002 000 | Additional reference type | Repeatable grid | Type of additional reference. | D |
| 6 | Statement Code | /MetaData/Declaration/GoodsShipment/AdditionalInformation/StatementCode | 12 02 008 000 | Additional information code | Repeatable grid | Code identifying the additional information statement. | D |
| 7 | Statement Description | /MetaData/Declaration/GoodsShipment/AdditionalInformation/StatementDescription | 12 02 009 000 | Additional information text | Repeatable grid | Free-text explanation or statement required by customs. | D |
| 8 | Previous Document ID | /MetaData/Declaration/GoodsShipment/PreviousDocument/ID | 12 01 001 000 | Previous document reference number | Repeatable grid | Reference number of a previous customs or commercial document. | D |
| 9 | Previous Document Type Code | /MetaData/Declaration/GoodsShipment/PreviousDocument/TypeCode | 12 01 002 000 | Previous document type | Repeatable grid | Type of previous document. | D |
| 10 | Supporting Document ID | /MetaData/Declaration/GoodsShipment/SupportingDocument/ID | 12 03 001 000 | Supporting document reference number | Repeatable grid | Reference number of a document supporting the declaration. | D |
| 11 | Supporting Document Type Code | /MetaData/Declaration/GoodsShipment/SupportingDocument/TypeCode | 12 03 002 000 | Supporting document type | Repeatable grid | Type of supporting document, such as licence, certificate or invoice. | D |
| 12 | Supporting Document Expiry Date | /MetaData/Declaration/GoodsShipment/SupportingDocument/ExpirationDateTime | 12 03 013 000 | Supporting document validity / expiry date | Date picker | Expiry date of the supporting document, if applicable. | D |
| 13 | Supporting Document Line Number | /MetaData/Declaration/GoodsShipment/SupportingDocument/LineNumeric | 12 03 007 000 | Supporting document line item number | Number input | Line number in the supporting document, where relevant. | D |
| 14 | Transport Document ID | /MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/ID | 12 05 001 000 | Transport document reference number | Repeatable grid | Reference number of the transport document. | D |
| 15 | Transport Document Type Code | /MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/TypeCode | 12 05 002 000 | Transport document type | Repeatable grid | Type of transport document. | D |
| 16 | Consignment UCR | /MetaData/Declaration/GoodsShipment/Consignment/UCR/TraderAssignedReferenceID | 12 08 000 000 | Reference number / UCR | Text input | Trader-assigned unique consignment reference. | D |
| 17 | Item UCR | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/UCR/TraderAssignedReferenceID | 12 08 000 000 | Reference number / UCR | Text input | Item-level unique commercial or consignment reference. | D |
Tab 7 — Valuation, Duties & Taxes
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Declaration Freight Charge Amount | /MetaData/Declaration/CustomsValuation/FreightChargeAmount | 14 10 000 000 or valuation adjustment mapping | Freight costs | Amount input | Freight amount declared for customs valuation purposes. | D |
| 2 | Declaration Freight Charge Currency | /MetaData/Declaration/CustomsValuation/FreightChargeAmount/@currencyID | 14 10 000 000 | Freight costs currency | Currency dropdown | Currency of the freight charge amount. | D |
| 3 | Shipment Charge Type Code | /MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/ChargesTypeCode | 14 04 000 000 | Additions and deductions | Repeatable grid | Type of additional charge or deduction. | D |
| 4 | Shipment Charge/Deduction Amount | /MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount | 14 04 000 000 | Additions and deductions amount | Repeatable grid | Amount of the charge or deduction. | D |
| 5 | Valuation Method Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/MethodCode | 14 11 000 000 | Valuation method | Dropdown | Customs valuation method used for the item. | D |
| 6 | Item Charge/Deduction Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/ChargesTypeCode | 14 04 000 000 | Additions and deductions | Repeatable grid | Type of item-level charge or deduction. | D |
| 7 | Item Charge/Deduction Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount | 14 04 000 000 | Additions and deductions amount | Repeatable grid | Amount of item-level charge or deduction. | D |
| 8 | Valuation Addition Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/ValuationAdjustment/AdditionCode | 14 04 000 000 | Addition/deduction code | Dropdown | Code identifying a valuation adjustment or addition. | D |
| 9 | Tax Assessed Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/TaxAssessedAmount | 14 03 000 000 or national duties/taxes mapping | Duties and taxes amount | Amount input | Total duty/tax amount assessed for the goods item. | D |
| 10 | Duty Regime Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyRegimeCode | National duties/taxes mapping | Duty regime | Dropdown | Duty regime applicable to the goods item. | D |
| 11 | Duty/Tax/Fee Type Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TypeCode | 14 03 039 000 or national mapping | Tax type | Repeatable grid | Type of duty, tax or fee. | D |
| 12 | Payment Method Code | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/Payment/MethodCode | 14 03 038 000 or national mapping | Method of payment | Dropdown | Method used to pay duty, tax or fee. | D |
| 13 | Payment Amount | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/Payment/PaymentAmount | 14 03 000 000 | Duties and taxes payable amount | Amount input | Amount payable for the duty, tax or fee line. | D |
| 14 | Tax Rate | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/TaxRateNumeric | National duties/taxes mapping | Tax rate | Decimal input | Rate used to calculate duty or tax. | D |
| 15 | Specific Tax Base Quantity | /MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/SpecificTaxBaseQuantity | National duties/taxes mapping | Specific tax base quantity | Quantity input | Quantity-based tax base, where duty/tax is based on units or weight. | D |
Tab 8 — Guarantee & Payment
| Order | Field label | XML path | UCC Annex B path | UCC Annex B data element name | UI control | Explanatory description | R/O/D |
|---|---|---|---|---|---|---|---|
| 1 | Deferred Payment ID | /MetaData/Declaration/DeferredPayment/ID | 14 02 000 000 or national mapping | Deferred payment / payment reference | Text input | Deferred payment account or reference used for customs charges. | D |
| 2 | Payer ID | /MetaData/Declaration/Payer/ID | 13 14 017 000 | Person paying customs duty identification number | Text input | Identifier of the party responsible for paying customs duties, taxes or fees. | D |
| 3 | Surety ID | /MetaData/Declaration/Surety/ID | 13 13 017 000 or guarantee mapping | Surety identification number | Text input | Identifier of the surety or guarantor. | D |
| 4 | Security Details Code | /MetaData/Declaration/ObligationGuarantee/SecurityDetailsCode | 99 02 000 000 or guarantee mapping | Guarantee type / security details | Dropdown | Code describing the type of security or guarantee provided. | D |
| 5 | Guarantee Amount | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AmountAmount | 99 02 000 000 or guarantee mapping | Guarantee amount | Amount input | Monetary amount covered by the guarantee. | D |
| 6 | Guarantee Currency | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AmountAmount/@currencyID | 99 02 000 000 or guarantee mapping | Guarantee amount currency | Currency dropdown | Currency of the guarantee amount. | D |
| 7 | Guarantee Reference ID | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/ID | 99 02 000 000 or guarantee mapping | Guarantee reference number | Text input | Reference number of the guarantee. | D |
| 8 | Guarantee Access Code | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AccessCode | 99 02 000 000 or guarantee mapping | Guarantee access code | Text input | Access code used to validate or use the guarantee. | D |
| 9 | Guarantee Office ID | /MetaData/Declaration/ObligationGuarantee/GuaranteeReference/GuaranteeOffice/ID | 17 11 000 000 or guarantee mapping | Customs office of guarantee | Lookup | Customs office responsible for the guarantee. | D |