Customs declarations system

Automation for customs declarations

Connection details

editor_311_5_def8503b-d8ec-4334-b533-e050a2f898ac_rte_image_24.png

Dit screenshot bevestigt  dat er voor NL100005780 / Sway-it B.V. logistieke afspraken geregistreerd zijn in de pre-productie/testomgeving.

Wat ik hieruit lees:

VeldWaarde / betekenis
Geadresseerde IDNL100005780
Geadresseerde00.05 Sway-it B.V. / 00.04 Sway-it B.V. / 00.20 Sway-it B.V.
BerichtstroomDMS, DMSZIP, VERVOER, EMCS
KanaalSMTP
Elektronisch adreshtg24000200@msa.preprod.htpoort.nl
BerichtformaatXML of ZIP
Ingangsdatum05-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:

  1. 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.
  2. DMSZIP – ZIP

    • Voor ZIP-berichten.
    • Dit is waarschijnlijk relevant wanneer berichten of bijlagen gebundeld/gecomprimeerd moeten worden.
    • Het screenshot toont expliciet dat DMSZIP als aparte berichtstroom met formaat ZIP is ingericht.

De basisflow is dan waarschijnlijk als volgt

  1. 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.
  2. Je applicatie verstuurt het bericht via SMTP

    • Naar het elektronische adres dat in de logistieke afspraak staat: htg24000200@msa.preprod.htpoort.nl
  3. 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.
  4. Je ontvangt retourberichten

    • Bijvoorbeeld technische ontvangstbevestiging.
    • Validatiefouten.
    • Functionele response.
    • Statusupdates.
    • Eventueel MRN/status vrijgave/controle, afhankelijk van het type aangifte.
  5. 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:

Wat moet je nu concreet doen om een DMS-testaangifte te sturen?

1. Bepaal de juiste berichtstroom

Voor DMS-aangiften gebruik je waarschijnlijk:

Begin met DMS/XML tenzij de documentatie expliciet zegt dat jouw scenario via ZIP moet.

2. Zoek de DMS berichtspecificatie op

Je hebt nodig:

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:

text
htg24000200@msa.preprod.htpoort.nl
content_copyCopy code

Afhankelijk van de specificatie kan het bericht:

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:

Wat ik uit je screenshot zou concluderen

Je aansluiting lijkt technisch ingericht voor:

text
DMS XML via SMTP
DMS ZIP via SMTP
VERVOER XML via SMTP
EMCS XML via SMTP
content_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

  1. Open de MSA/NHD softwareontwikkelaarsdocumentatie.
  2. Pak de DMS XML/XSD/MIG en SMTP-envelopspecificatie.
  3. Gebruik een officiële testset/testcase.
  4. Genereer een geldig DMS XML-bericht.
  5. Verstuur via SMTP naar htg24000200@msa.preprod.htpoort.nl.
  6. Ontvang en verwerk de response.
  7. Los technische en functionele foutmeldingen op.
  8. 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:

StepTabRequired user action
1Declaration HeaderEnter declaration identifiers, type, office and dates
2PartiesEnter declarant, importer/exporter, buyer/seller, consignee/consignor
3Shipment DetailsEnter invoice amount, currency, countries and trade terms
4Transport & ConsignmentEnter carrier, transport means, equipment and UCR
5Goods ItemsEnter commodity, classification, weights, origin and packaging
6Documents & ReferencesEnter supporting and previous documents
7Valuation, Duties & TaxesEnter customs value, charges and tax lines
8Guarantee & PaymentEnter deferred payment or guarantee details
9Review & SubmitValidate, review XML and submit

UI design pattern

Use this structure:

text
Declaration
 ├── 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 & Submit
content_copyCopy code

For best usability:

RecommendationReason
Use tabs for major sectionsKeeps the form manageable
Use collapsible panels for parties and item detailsAvoids overwhelming the user
Use repeatable grids for documents, goods items, packaging and taxesMatches XML repeatable structures
Use lookups/dropdowns for codesReduces data-entry errors
Use date pickers but store as XML formatUser-friendly entry, valid XML output
Use currency selector next to amount fieldsRequired where XML has currencyID attributes
Use unit selector next to quantity fieldsRequired where XML has unitCode attributes
Use Review & Submit validation tabPrevents invalid XML or incomplete declarations

UI tabs

Tab no.Tab namePurpose
1Declaration HeaderMain declaration identifiers, dates, customs offices and message metadata
2PartiesDeclarant, agent, importer, exporter, buyer, seller, consignee, consignor
3Shipment DetailsInvoice, currency, dispatch/export/destination countries, trade terms, warehouse
4Transport & ConsignmentCarrier, transport means, container, goods location, itinerary, transport equipment
5Goods ItemsCommodity details, classification, weights, origin, packaging and item-level parties
6Documents & ReferencesAdditional references, supporting documents, previous documents, UCR
7Valuation, Duties & TaxesCustoms value, freight, charge/deductions, duty/tax fee, tax base and payments
8Guarantee & PaymentDeferred payment, obligation guarantee, payer, surety
9Review & SubmitValidation summary, missing fields, XML preview and submission

Tab 1 — Declaration Header

Purpose

Capture the declaration identity, message metadata and customs offices.

OrderField labelXML pathUI control
1WCO Type Code/MetaData/WCOTypeCodeText input
2Application Reference ID/MetaData/CommunicationMetaData/ApplicationReferenceIDText input
3Communications Agreement ID/MetaData/CommunicationMetaData/CommunicationsAgreementIDText input
4Sender ID/MetaData/CommunicationMetaData/Sender/IDText input
5Recipient ID/MetaData/CommunicationMetaData/Recipient/IDText input
6Preparation Date/Time/MetaData/CommunicationMetaData/PreparationDateTimeDate/time picker
7Functional Reference ID/MetaData/Declaration/FunctionalReferenceIDText input
8Declaration ID/MetaData/Declaration/IDText input
9Declaration Type Code/MetaData/Declaration/TypeCodeDropdown / code list
10Language Code/MetaData/Declaration/LanguageCodeDropdown
11Specific Circumstances Code/MetaData/Declaration/SpecificCircumstancesCodeDropdown / code list
12Security Code/MetaData/Declaration/SecurityCodeDropdown / code list
13Presentation Date/Time/MetaData/Declaration/PresentationDateTimeDate/time picker
14Declaration Office ID/MetaData/Declaration/DeclarationOffice/IDLookup
15Exit Office ID/MetaData/Declaration/ExitOffice/IDLookup
16Presentation Office ID/MetaData/Declaration/PresentationOffice/IDLookup
17Supervising Office ID/MetaData/Declaration/SupervisingOffice/IDLookup

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

OrderField labelXML pathUI control
1Declarant Name/MetaData/Declaration/Declarant/NameText input
2Declarant ID/MetaData/Declaration/Declarant/IDText input
3Declarant Address Line/MetaData/Declaration/Declarant/Address/LineText input
4Declarant City/MetaData/Declaration/Declarant/Address/CityNameText input
5Declarant Postcode/MetaData/Declaration/Declarant/Address/PostcodeIDText input
6Declarant Country Code/MetaData/Declaration/Declarant/Address/CountryCodeCountry dropdown
7Declarant Contact Name/MetaData/Declaration/Declarant/Contact/NameText input
8Declarant Communication Type/MetaData/Declaration/Declarant/Contact/Communication/TypeCodeDropdown
9Declarant Communication ID/MetaData/Declaration/Declarant/Contact/Communication/IDText input
10Declarant Communication Sequence/MetaData/Declaration/Declarant/Contact/Communication/SequenceNumericNumber input

2.2 Agent

OrderField labelXML pathUI control
1Agent ID/MetaData/Declaration/Agent/IDText input
2Agent Function Code/MetaData/Declaration/Agent/FunctionCodeDropdown / code list
3Agent Contact Name/MetaData/Declaration/Agent/Contact/NameText input
4Agent Communication Type/MetaData/Declaration/Agent/Contact/Communication/TypeCodeDropdown
5Agent Communication ID/MetaData/Declaration/Agent/Contact/Communication/IDText input
6Agent Communication Sequence/MetaData/Declaration/Agent/Contact/Communication/SequenceNumericNumber input

2.3 Importer

OrderField labelXML pathUI control
1Importer Name/MetaData/Declaration/Importer/NameText input
2Importer ID/MetaData/Declaration/Importer/IDText input
3Importer Address Line/MetaData/Declaration/Importer/Address/LineText input
4Importer City/MetaData/Declaration/Importer/Address/CityNameText input
5Importer Postcode/MetaData/Declaration/Importer/Address/PostcodeIDText input
6Importer Country Code/MetaData/Declaration/Importer/Address/CountryCodeCountry dropdown

2.4 Declaration-level Exporter

OrderField labelXML pathUI control
1Exporter Name/MetaData/Declaration/Exporter/NameText input
2Exporter ID/MetaData/Declaration/Exporter/IDText input
3Exporter Address Line/MetaData/Declaration/Exporter/Address/LineText input
4Exporter City/MetaData/Declaration/Exporter/Address/CityNameText input
5Exporter Postcode/MetaData/Declaration/Exporter/Address/PostcodeIDText input
6Exporter Country Code/MetaData/Declaration/Exporter/Address/CountryCodeCountry dropdown

2.5 Buyer

OrderField labelXML pathUI control
1Buyer Name/MetaData/Declaration/GoodsShipment/Buyer/NameText input
2Buyer ID/MetaData/Declaration/GoodsShipment/Buyer/IDText input
3Buyer Address Line/MetaData/Declaration/GoodsShipment/Buyer/Address/LineText input
4Buyer City/MetaData/Declaration/GoodsShipment/Buyer/Address/CityNameText input
5Buyer Postcode/MetaData/Declaration/GoodsShipment/Buyer/Address/PostcodeIDText input
6Buyer Country Code/MetaData/Declaration/GoodsShipment/Buyer/Address/CountryCodeCountry dropdown

2.6 Seller

OrderField labelXML pathUI control
1Seller Name/MetaData/Declaration/GoodsShipment/Seller/NameText input
2Seller ID/MetaData/Declaration/GoodsShipment/Seller/IDText input
3Seller Address Line/MetaData/Declaration/GoodsShipment/Seller/Address/LineText input
4Seller City/MetaData/Declaration/GoodsShipment/Seller/Address/CityNameText input
5Seller Postcode/MetaData/Declaration/GoodsShipment/Seller/Address/PostcodeIDText input
6Seller Country Code/MetaData/Declaration/GoodsShipment/Seller/Address/CountryCodeCountry dropdown

2.7 Consignee and Consignor

These can be shown as two side-by-side party panels.

OrderField labelXML pathUI control
1Consignee Name/MetaData/Declaration/GoodsShipment/Consignment/Consignee/NameText input
2Consignee ID/MetaData/Declaration/GoodsShipment/Consignment/Consignee/IDText input
3Consignee Address Line/MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/LineText input
4Consignee City/MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/CityNameText input
5Consignee Postcode/MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/PostcodeIDText input
6Consignee Country Code/MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/CountryCodeCountry dropdown
7Consignor Name/MetaData/Declaration/GoodsShipment/Consignment/Consignor/NameText input
8Consignor ID/MetaData/Declaration/GoodsShipment/Consignment/Consignor/IDText input
9Consignor Address Line/MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/LineText input
10Consignor City/MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/CityNameText input
11Consignor Postcode/MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/PostcodeIDText input
12Consignor Country Code/MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/CountryCodeCountry dropdown

Tab 3 — Shipment Details

Purpose

Capture commercial shipment-level information.

OrderField labelXML pathUI control
1Shipment Sequence/MetaData/Declaration/GoodsShipment/SequenceNumericNumber input
2Transaction Nature Code/MetaData/Declaration/GoodsShipment/TransactionNatureCodeDropdown / code list
3Dispatch Country Code/MetaData/Declaration/GoodsShipment/DispatchCountryCodeCountry dropdown
4Export Country ID/MetaData/Declaration/GoodsShipment/ExportCountry/IDCountry dropdown
5Destination Country Code/MetaData/Declaration/GoodsShipment/Destination/CountryCodeCountry dropdown
6Destination Region ID/MetaData/Declaration/GoodsShipment/Destination/RegionIDText input
7Destination Qualifier Code/MetaData/Declaration/GoodsShipment/Destination/CCQualifierCodeDropdown
8Invoice Amount/MetaData/Declaration/GoodsShipment/InvoiceAmountAmount input
9Invoice Currency Code/MetaData/Declaration/GoodsShipment/InvoiceCurrencyCodeCurrency dropdown
10Acceptance Date/MetaData/Declaration/GoodsShipment/AcceptanceDateTimeDate picker
11Currency Exchange Currency/MetaData/Declaration/GoodsShipment/CurrencyExchange/CurrencyTypeCodeCurrency dropdown
12Currency Exchange Rate/MetaData/Declaration/GoodsShipment/CurrencyExchange/RateNumericDecimal input
13Trade Term Condition Code/MetaData/Declaration/GoodsShipment/TradeTerms/ConditionCodeIncoterm dropdown
14Trade Term Description/MetaData/Declaration/GoodsShipment/TradeTerms/DescriptionText input
15Trade Term Location ID/MetaData/Declaration/GoodsShipment/TradeTerms/LocationIDText input
16Trade Term Location Name/MetaData/Declaration/GoodsShipment/TradeTerms/LocationNameText input
17Trade Term Country Code/MetaData/Declaration/GoodsShipment/TradeTerms/CountryCodeCountry dropdown
18Warehouse ID/MetaData/Declaration/GoodsShipment/Warehouse/IDText input
19Warehouse Type Code/MetaData/Declaration/GoodsShipment/Warehouse/TypeCodeDropdown / code list
20Shipment-level Freight Payment Method/MetaData/Declaration/GoodsShipment/Freight/PaymentMethodCodeDropdown / code list

Tab 4 — Transport & Consignment

Purpose

Capture logistics, transport, container, location and routing data.

4.1 Consignment header

OrderField labelXML pathUI control
1Container Code/MetaData/Declaration/GoodsShipment/Consignment/ContainerCodeDropdown / code list
2Total Gross Mass/MetaData/Declaration/GoodsShipment/Consignment/TotalGrossMassMeasureDecimal input
3Carrier ID/MetaData/Declaration/GoodsShipment/Consignment/Carrier/IDText input
4Consignment Freight Payment Method/MetaData/Declaration/GoodsShipment/Consignment/Freight/PaymentMethodCodeDropdown / code list
5Consignment UCR/MetaData/Declaration/GoodsShipment/Consignment/UCR/TraderAssignedReferenceIDText input

4.2 Arrival transport

OrderField labelXML pathUI control
6Arrival Transport ID/MetaData/Declaration/GoodsShipment/Consignment/ArrivalTransportMeans/IDText input
7Arrival Identification Type Code/MetaData/Declaration/GoodsShipment/Consignment/ArrivalTransportMeans/IdentificationTypeCodeDropdown / code list
8Arrival Mode Code/MetaData/Declaration/GoodsShipment/Consignment/ArrivalTransportMeans/ModeCodeDropdown / code list

4.3 Border transport

OrderField labelXML pathUI control
9Border Transport ID/MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/IDText input
10Border Identification Type Code/MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/IdentificationTypeCodeDropdown / code list
11Border Registration Nationality Code/MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/RegistrationNationalityCodeCountry dropdown
12Border Mode Code/MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/ModeCodeDropdown / code list

4.4 Departure transport

OrderField labelXML pathUI control
13Departure Transport Sequence/MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/SequenceNumericNumber input
14Departure Transport ID/MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/IDText input
15Departure Identification Type Code/MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/IdentificationTypeCodeDropdown / code list
16Departure Registration Nationality Code/MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/RegistrationNationalityCodeCountry dropdown
17Departure Mode Code/MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/ModeCodeDropdown / code list

4.5 Goods location

OrderField labelXML pathUI control
18Goods Location ID/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/IDText input
19Goods Location Type Code/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/TypeCodeDropdown / code list
20Latitude/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/LatitudeIDCoordinate input
21Longitude/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/LongitudeIDCoordinate input
22Location Identification Type Code/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/IdentificationTypeCodeDropdown / code list
23Location Authorization ID/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/AuthorizationIDText input
24Location Additional Identifier/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/AdditionalIdentifierIDText input
25Location Address Line/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/LineText input
26Location Street Number/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/StreetNumberIDText input
27Location City/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/CityNameText input
28Location Postcode/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/PostcodeIDText input
29Location Country Code/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/CountryCodeCountry dropdown
30Location Customs Office ID/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/CustomsOffice/IDLookup
31Location Economic Operator ID/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/EconomicOperator/IDText input
32Location Contact Name/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Contact/NameText input
33Location Communication Type/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Contact/Communication/TypeCodeDropdown
34Location Communication ID/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Contact/Communication/IDText input

4.6 Repeatable transport grids

Itinerary grid

Column orderField labelXML path
1Sequence/MetaData/Declaration/GoodsShipment/Consignment/Itinerary/SequenceNumeric
2Routing Country Code/MetaData/Declaration/GoodsShipment/Consignment/Itinerary/RoutingCountryCode

Transport contract document grid

Column orderField labelXML path
1Sequence/MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/SequenceNumeric
2Document Type Code/MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/TypeCode
3Document ID/MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/ID

Transport equipment grid

Column orderField labelXML path
1Equipment Sequence/MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/SequenceNumeric
2Equipment ID/MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/ID
3Seals Affixed Quantity/MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/SealsAffixedQuantity
4Seal Sequence/MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/Seal/SequenceNumeric
5Seal ID/MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/Seal/ID
6Goods Reference Sequence/MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/GoodsReference/SequenceNumeric
7Goods 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:

  1. Goods item list/grid on the left or top
  2. Detail form for selected goods item
  3. Sub-grids for classification, packaging, documents, tax, etc.

5.1 Goods item summary

OrderField labelXML pathUI control
1Goods Item Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumericNumber input
2Goods Description/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/DescriptionLong text
3Customs Value Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValueAmountAmount input
4Customs Value Currency/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValueAmount/@currencyIDCurrency dropdown
5Statistical Value Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/StatisticalValueAmountAmount input
6Transaction Nature Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/TransactionNatureCodeDropdown / code list
7Dispatch Country Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/DispatchCountryCodeCountry dropdown
8Acceptance Date/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/AcceptanceDateTimeDate picker

5.2 Commodity classification

OrderField labelXML pathUI control
9Classification Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/SequenceNumericNumber input
10Classification ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/IDText/code input
11Classification Identification Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/IdentificationTypeCodeDropdown / code list
12Classification Qualifier Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/CCQualifierCodeDropdown

5.3 Goods measure

OrderField labelXML pathUI control
13Gross Mass/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/GrossMassMeasureDecimal input
14Net Net Weight/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/NetNetWeightMeasureDecimal input
15Tariff Quantity/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/TariffQuantityDecimal input
16Item Charge Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/InvoiceLine/ItemChargeAmountAmount input

5.4 Origin and destination

OrderField labelXML pathUI control
17Origin Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/SequenceNumericNumber input
18Origin Country Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/CountryCodeCountry dropdown
19Origin Region ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/RegionIDText input
20Origin Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/TypeCodeDropdown / code list
21Item Destination Country Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Destination/CountryCodeCountry dropdown
22Item Destination Region ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Destination/RegionIDText input
23Item Destination Qualifier Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Destination/CCQualifierCodeDropdown
24Item Export Country ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/ExportCountry/IDCountry dropdown

5.5 Item-level parties

Use collapsible party panels to avoid crowding the screen.

OrderField labelXML pathUI control
25Item Buyer Name/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Buyer/NameText input
26Item Buyer ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Buyer/IDText input
27Item Consignee Name/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Consignee/NameText input
28Item Consignee ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Consignee/IDText input
29Item Consignor Name/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Consignor/NameText input
30Item Consignor ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Consignor/IDText input
31Item Exporter Name/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Exporter/NameText input
32Item Exporter ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Exporter/IDText input
33Item Seller Name/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Seller/NameText input
34Item Seller ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Seller/IDText input

5.6 Packaging grid

Column orderField labelXML path
1Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/SequenceNumeric
2Marks and Numbers/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/MarksNumbersID
3Quantity/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/QuantityQuantity
4Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/TypeCode

5.7 Dangerous goods grid

Column orderField labelXML path
1Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/DangerousGoods/SequenceNumeric
2UNDG ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/DangerousGoods/UNDGID

5.8 Government procedure

OrderField labelXML pathUI control
35Current Procedure Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/CurrentCodeDropdown / code list
36Previous Procedure Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/PreviousCodeDropdown / code list

Additional procedure grid

Column orderField labelXML path
1Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/AdditionalProcedure/SequenceNumeric
2Procedure Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/AdditionalProcedure/ProcedureCode
3Qualifier 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 orderField labelXML path
1Sequence/MetaData/Declaration/Authorisation/SequenceNumeric
2Authorisation Type Code/MetaData/Declaration/Authorisation/TypeCode
3Authorisation ID/MetaData/Declaration/Authorisation/ID
4Authorisation Holder ID/MetaData/Declaration/Authorisation/AuthorisationHolder/ID

6.2 Shipment additional references grid

Column orderField labelXML path
1Sequence/MetaData/Declaration/GoodsShipment/AdditionalReference/SequenceNumeric
2Type Code/MetaData/Declaration/GoodsShipment/AdditionalReference/TypeCode
3Reference ID/MetaData/Declaration/GoodsShipment/AdditionalReference/ID
4Qualifier Code/MetaData/Declaration/GoodsShipment/AdditionalReference/CCQualifierCode

6.3 Shipment additional information grid

Column orderField labelXML path
1Sequence/MetaData/Declaration/GoodsShipment/AdditionalInformation/SequenceNumeric
2Statement Code/MetaData/Declaration/GoodsShipment/AdditionalInformation/StatementCode
3Statement Description/MetaData/Declaration/GoodsShipment/AdditionalInformation/StatementDescription
4Qualifier Code/MetaData/Declaration/GoodsShipment/AdditionalInformation/CCQualifierCode

6.4 Shipment previous documents grid

Column orderField labelXML path
1Sequence/MetaData/Declaration/GoodsShipment/PreviousDocument/SequenceNumeric
2Type Code/MetaData/Declaration/GoodsShipment/PreviousDocument/TypeCode
3Document ID/MetaData/Declaration/GoodsShipment/PreviousDocument/ID
4Qualifier Code/MetaData/Declaration/GoodsShipment/PreviousDocument/CCQualifierCode

6.5 Shipment supporting documents grid

Column orderField labelXML path
1Sequence/MetaData/Declaration/GoodsShipment/SupportingDocument/SequenceNumeric
2Type Code/MetaData/Declaration/GoodsShipment/SupportingDocument/TypeCode
3Document ID/MetaData/Declaration/GoodsShipment/SupportingDocument/ID
4Expiration Date/MetaData/Declaration/GoodsShipment/SupportingDocument/ExpirationDateTime
5Line Number/MetaData/Declaration/GoodsShipment/SupportingDocument/LineNumeric
6Qualifier Code/MetaData/Declaration/GoodsShipment/SupportingDocument/CCQualifierCode
7Submitter 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 orderField labelXML path
1Goods Item Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric
2Reference Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/AdditionalReference/SequenceNumeric
3Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/AdditionalReference/TypeCode
4Reference ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/AdditionalReference/ID
5Qualifier Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/AdditionalReference/CCQualifierCode

Item previous documents grid

Column orderField labelXML path
1Goods Item Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric
2Document Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/SequenceNumeric
3Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/TypeCode
4Document ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/ID
5Line Number/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/LineNumeric
6Qualifier Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/CCQualifierCode
7Write-off Quantity/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/WriteOff/QuantityQuantity
8Write-off Packaging Quantity/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/WriteOff/Packaging/QuantityQuantity
9Write-off Packaging Type/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/PreviousDocument/WriteOff/Packaging/TypeCode

Item supporting documents grid

Column orderField labelXML path
1Goods Item Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric
2Document Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/SequenceNumeric
3Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/TypeCode
4Document ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/ID
5Expiration Date/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/ExpirationDateTime
6Line Number/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/LineNumeric
7Qualifier Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/CCQualifierCode
8Submitter Name/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/Submitter/Name
9Write-off Quantity/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/WriteOff/QuantityQuantity
10Write-off Quantity Unit/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/WriteOff/QuantityQuantity/@unitCode
11Write-off Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SupportingDocument/WriteOff/AmountAmount
12Write-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

OrderField labelXML pathUI control
1Declaration Freight Charge Amount/MetaData/Declaration/CustomsValuation/FreightChargeAmountAmount input
2Declaration Freight Charge Currency/MetaData/Declaration/CustomsValuation/FreightChargeAmount/@currencyIDCurrency dropdown

7.2 Shipment-level charge/deduction grid

Column orderField labelXML path
1Sequence/MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/SequenceNumeric
2Charges Type Code/MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/ChargesTypeCode
3Amount/MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount
4Currency/MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount/@currencyID

7.3 Item-level valuation

OrderField labelXML pathUI control
1Goods Item Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumericItem selector
2Valuation Method Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/MethodCodeDropdown / code list
3Valuation Addition Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/ValuationAdjustment/AdditionCodeDropdown / code list

Item charge/deduction grid

Column orderField labelXML path
1Goods Item Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric
2Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/SequenceNumeric
3Charges Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/ChargesTypeCode
4Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount
5Currency/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount/@currencyID

7.4 Duty/tax calculation grid

Column orderField labelXML path
1Goods Item Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric
2Tax Assessed Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/TaxAssessedAmount
3Quota Order ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/QuotaOrderID
4Duty Regime Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyRegimeCode
5Duty/Tax/Fee Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/SequenceNumeric
6Duty/Tax/Fee Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TypeCode
7Duty/Tax/Fee Qualifier Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/CCQualifierCode
8Payment Method Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/Payment/MethodCode
9Payment Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/Payment/PaymentAmount
10Tax Base Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/SequenceNumeric
11Tax Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/TaxAmount
12Ad Valorem Tax Base Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/AdValoremTaxBaseAmount
13Specific Tax Base Quantity/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/SpecificTaxBaseQuantity
14Specific Tax Base Unit Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/SpecificTaxBaseQuantity/@unitCode
15Tax Rate/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/TaxRateNumeric

Tab 8 — Guarantee & Payment

Purpose

Capture deferred payment, guarantee, payer and surety information.

OrderField labelXML pathUI control
1Deferred Payment ID/MetaData/Declaration/DeferredPayment/IDText input
2Payer ID/MetaData/Declaration/Payer/IDText input
3Surety ID/MetaData/Declaration/Surety/IDText input
4Obligation Guarantee Sequence/MetaData/Declaration/ObligationGuarantee/SequenceNumericNumber input
5Security Details Code/MetaData/Declaration/ObligationGuarantee/SecurityDetailsCodeDropdown / code list
6Guarantee Amount/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AmountAmountAmount input
7Guarantee Amount Currency/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AmountAmount/@currencyIDCurrency dropdown
8Guarantee Reference ID/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/IDText input
9Guarantee Sequence/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/SequenceNumericNumber input
10Guarantee Access Code/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AccessCodeText input
11Guarantee External Reference ID/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/ReferenceIDText input
12Guarantee Qualifier Code/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/CCQualifierCodeDropdown
13Guarantee Office ID/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/GuaranteeOffice/IDLookup

Tab 9 — Review & Submit

Purpose

Allow the user to validate, review and submit the declaration.

OrderField / actionUI controlDescription
1Validation StatusStatus panelShows errors, warnings and missing mandatory data
2Declaration SummaryRead-only summaryDeclaration ID, type, parties, shipment, goods count
3Goods Items SummaryGridShows goods items, commodity description, value, weight
4Documents SummaryGridShows attached/declared supporting and previous documents
5Duties & Taxes SummaryGridShows assessed taxes, payments and duty/tax fee lines
6XML PreviewExpandable XML viewerGenerated XML based on keyed-in data
7Save DraftButtonSave without submission
8ValidateButtonRun business and XML validation
9Submit DeclarationButtonFinal submission
10Export XMLButtonDownload 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

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1WCO Type Code/MetaData/WCOTypeCodeTechnical metadataMessage / WCO typeText inputIdentifies the WCO/DMS message or declaration type being created.R
2Application Reference ID/MetaData/CommunicationMetaData/ApplicationReferenceIDTechnical metadataApplication referenceText inputReference assigned by the sending application for tracking the message.R
3Communications Agreement ID/MetaData/CommunicationMetaData/CommunicationsAgreementIDTechnical metadataCommunications agreement referenceText inputAgreement or interface reference between sender and recipient systems.D
4Sender ID/MetaData/CommunicationMetaData/Sender/IDTechnical metadataSender identificationText inputIdentifier of the party or system sending the declaration message.R
5Recipient ID/MetaData/CommunicationMetaData/Recipient/IDTechnical metadataRecipient identificationText inputIdentifier of the receiving customs/DMS system or party.R
6Preparation Date/Time/MetaData/CommunicationMetaData/PreparationDateTimeTechnical metadataPreparation date and timeDate/time pickerDate and time when the declaration message was prepared.R
7Functional Reference ID/MetaData/Declaration/FunctionalReferenceID12 01 000 000Previous document / reference number or LRN depending national implementationText inputBusiness reference used to identify and track the declaration functionally.R
8Declaration ID/MetaData/Declaration/ID12 09 000 000LRN / MRN / declaration identifier depending message statusText inputUnique customs declaration identifier.R
9Declaration Type Code/MetaData/Declaration/TypeCode11 01 000 000Declaration typeDropdown / code listCode indicating the type of customs declaration being submitted.R
10Language Code/MetaData/Declaration/LanguageCodeTo be confirmed by national DMS mappingLanguageDropdownLanguage used for declaration text fields.O
11Specific Circumstances Code/MetaData/Declaration/SpecificCircumstancesCode11 10 000 000Additional declaration type / specific circumstance indicatorDropdown / code listCode for any special circumstances applying to the declaration.D
12Security Code/MetaData/Declaration/SecurityCode11 07 000 000SecurityDropdown / code listSecurity indicator used when safety/security data is required.D
13Presentation Date/Time/MetaData/Declaration/PresentationDateTime15 09 000 000Presentation date and timeDate/time pickerDate and time the declaration is presented to customs.R
14Declaration Office ID/MetaData/Declaration/DeclarationOffice/ID17 09 000 000Customs office of presentation / customs office of declarationLookupCustoms office where the declaration is lodged.R
15Exit Office ID/MetaData/Declaration/ExitOffice/ID17 01 000 000Customs office of exitLookupCustoms office of exit, where applicable.D
16Presentation Office ID/MetaData/Declaration/PresentationOffice/ID17 09 000 000Customs office of presentationLookupCustoms office where the goods or declaration are physically/electronically presented.D
17Supervising Office ID/MetaData/Declaration/SupervisingOffice/ID17 10 000 000Supervising customs officeLookupCustoms office supervising the declaration or special procedure.D

Tab 2 — Parties

2.1 Declarant

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Declarant Name/MetaData/Declaration/Declarant/Name13 05 016 000Declarant nameText inputName of the person or company lodging the declaration.R
2Declarant ID/MetaData/Declaration/Declarant/ID13 05 017 000Declarant identification numberText inputIdentification number of the declarant.R
3Declarant Address Line/MetaData/Declaration/Declarant/Address/Line13 05 018 019Declarant street and number / address lineText inputStreet name, building, PO box or main address line.D
4Declarant City/MetaData/Declaration/Declarant/Address/CityName13 05 018 020Declarant cityText inputCity of the declarant address.D
5Declarant Postcode/MetaData/Declaration/Declarant/Address/PostcodeID13 05 018 021Declarant postcodeText inputPostal or ZIP code of the declarant address.D
6Declarant Country Code/MetaData/Declaration/Declarant/Address/CountryCode13 05 018 020/021/022Declarant countryCountry dropdownCountry where the declarant is established or addressed.D
7Declarant Contact Name/MetaData/Declaration/Declarant/Contact/Name13 05 074 000Declarant contact personText inputName of the declarant’s contact person.D
8Declarant Communication Type/MetaData/Declaration/Declarant/Contact/Communication/TypeCode13 05 074 000Declarant communication typeDropdownType of contact detail, such as telephone or email.D
9Declarant Communication ID/MetaData/Declaration/Declarant/Contact/Communication/ID13 05 074 000Declarant communication detailText inputActual contact detail, such as phone number or email address.D

2.2 Representative / Agent

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Agent ID/MetaData/Declaration/Agent/ID13 06 017 000Representative identification numberText inputIdentification number of the agent or customs representative.D
2Agent Function Code/MetaData/Declaration/Agent/FunctionCode13 06 030 000Representative statusDropdown / code listCode describing the agent’s representation status or role.D
3Agent Contact Name/MetaData/Declaration/Agent/Contact/Name13 06 074 000Representative contact personText inputName of the agent’s contact person.D
4Agent Communication Type/MetaData/Declaration/Agent/Contact/Communication/TypeCode13 06 074 000Representative communication typeDropdownType of communication detail, such as email or telephone.D
5Agent Communication ID/MetaData/Declaration/Agent/Contact/Communication/ID13 06 074 000Representative communication detailText inputActual communication detail of the agent.D

2.3 Importer

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Importer Name/MetaData/Declaration/Importer/Name13 04 016 000Importer nameText inputName of the party importing the goods.D
2Importer ID/MetaData/Declaration/Importer/ID13 04 017 000Importer identification numberText inputIdentification number of the importer.D
3Importer Address Line/MetaData/Declaration/Importer/Address/Line13 04 018 019Importer street and number / address lineText inputStreet name, building, PO box or main address line of the importer.D
4Importer City/MetaData/Declaration/Importer/Address/CityName13 04 018 020Importer cityText inputCity of the importer address.D
5Importer Postcode/MetaData/Declaration/Importer/Address/PostcodeID13 04 018 021Importer postcodeText inputPostal or ZIP code of the importer address.D
6Importer Country Code/MetaData/Declaration/Importer/Address/CountryCode13 04 018 022Importer countryCountry dropdownCountry where the importer is established or addressed.D

2.4 Exporter

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Exporter Name/MetaData/Declaration/Exporter/Name13 01 016 000Exporter nameText inputName of the exporter at declaration level.D
2Exporter ID/MetaData/Declaration/Exporter/ID13 01 017 000Exporter identification numberText inputIdentification number of the declaration-level exporter.D
3Exporter Address Line/MetaData/Declaration/Exporter/Address/Line13 01 018 019Exporter street and number / address lineText inputStreet name, building, PO box or main address line of the exporter.D
4Exporter City/MetaData/Declaration/Exporter/Address/CityName13 01 018 020Exporter cityText inputCity of the exporter address.D
5Exporter Postcode/MetaData/Declaration/Exporter/Address/PostcodeID13 01 018 021Exporter postcodeText inputPostal or ZIP code of the exporter address.D
6Exporter Country Code/MetaData/Declaration/Exporter/Address/CountryCode13 01 018 022Exporter countryCountry dropdownCountry where the exporter is established or addressed.D

2.5 Buyer

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Buyer Name/MetaData/Declaration/GoodsShipment/Buyer/Name13 02 016 000Buyer nameText inputName of the party buying the goods.D
2Buyer ID/MetaData/Declaration/GoodsShipment/Buyer/ID13 02 017 000Buyer identification numberText inputIdentification number of the buyer.D
3Buyer Address Line/MetaData/Declaration/GoodsShipment/Buyer/Address/Line13 02 018 019Buyer street and number / address lineText inputStreet name, building, PO box or main address line of the buyer.D
4Buyer City/MetaData/Declaration/GoodsShipment/Buyer/Address/CityName13 02 018 020Buyer cityText inputCity of the buyer address.D
5Buyer Postcode/MetaData/Declaration/GoodsShipment/Buyer/Address/PostcodeID13 02 018 021Buyer postcodeText inputPostal or ZIP code of the buyer address.D
6Buyer Country Code/MetaData/Declaration/GoodsShipment/Buyer/Address/CountryCode13 02 018 022Buyer countryCountry dropdownCountry where the buyer is established or addressed.D

2.6 Seller

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Seller Name/MetaData/Declaration/GoodsShipment/Seller/Name13 03 016 000Seller nameText inputName of the party selling the goods.D
2Seller ID/MetaData/Declaration/GoodsShipment/Seller/ID13 03 017 000Seller identification numberText inputIdentification number of the seller.D
3Seller Address Line/MetaData/Declaration/GoodsShipment/Seller/Address/Line13 03 018 019Seller street and number / address lineText inputStreet name, building, PO box or main address line of the seller.D
4Seller City/MetaData/Declaration/GoodsShipment/Seller/Address/CityName13 03 018 020Seller cityText inputCity of the seller address.D
5Seller Postcode/MetaData/Declaration/GoodsShipment/Seller/Address/PostcodeID13 03 018 021Seller postcodeText inputPostal or ZIP code of the seller address.D
6Seller Country Code/MetaData/Declaration/GoodsShipment/Seller/Address/CountryCode13 03 018 022Seller countryCountry dropdownCountry where the seller is established or addressed.D

2.7 Consignee

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Consignee Name/MetaData/Declaration/GoodsShipment/Consignment/Consignee/Name13 10 016 000Consignee nameText inputName of the party receiving the goods.D
2Consignee ID/MetaData/Declaration/GoodsShipment/Consignment/Consignee/ID13 10 017 000Consignee identification numberText inputIdentification number of the consignee.D
3Consignee Address Line/MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/Line13 10 018 019Consignee street and number / address lineText inputStreet name, building, PO box or main address line of the consignee.D
4Consignee City/MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/CityName13 10 018 020Consignee cityText inputCity of the consignee address.D
5Consignee Postcode/MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/PostcodeID13 10 018 021Consignee postcodeText inputPostal or ZIP code of the consignee address.D
6Consignee Country Code/MetaData/Declaration/GoodsShipment/Consignment/Consignee/Address/CountryCode13 10 018 022Consignee countryCountry dropdownCountry where the consignee is established or addressed.D

2.8 Consignor

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Consignor Name/MetaData/Declaration/GoodsShipment/Consignment/Consignor/Name13 09 016 000Consignor nameText inputName of the party sending the goods.D
2Consignor ID/MetaData/Declaration/GoodsShipment/Consignment/Consignor/ID13 09 017 000Consignor identification numberText inputIdentification number of the consignor.D
3Consignor Address Line/MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/Line13 09 018 019Consignor street and number / address lineText inputStreet name, building, PO box or main address line of the consignor.D
4Consignor City/MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/CityName13 09 018 020Consignor cityText inputCity of the consignor address.D
5Consignor Postcode/MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/PostcodeID13 09 018 021Consignor postcodeText inputPostal or ZIP code of the consignor address.D
6Consignor Country Code/MetaData/Declaration/GoodsShipment/Consignment/Consignor/Address/CountryCode13 09 018 022Consignor countryCountry dropdownCountry where the consignor is established or addressed.D

Tab 3 — Shipment Details

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Shipment Sequence/MetaData/Declaration/GoodsShipment/SequenceNumericTechnical / structuralGoods shipment sequenceNumber inputSequence number for the goods shipment.R
2Transaction Nature Code/MetaData/Declaration/GoodsShipment/TransactionNatureCode99 05 000 000Nature of transactionDropdown / code listCode describing the nature of the transaction, such as sale, return or transfer.R
3Dispatch Country Code/MetaData/Declaration/GoodsShipment/DispatchCountryCode16 06 000 000Country of dispatchCountry dropdownCountry from which the goods are dispatched.R
4Export Country ID/MetaData/Declaration/GoodsShipment/ExportCountry/ID16 07 000 000Country of exportCountry dropdownCountry from which the goods are exported.D
5Destination Country Code/MetaData/Declaration/GoodsShipment/Destination/CountryCode16 03 000 000Country of destinationCountry dropdownFinal destination country of the goods.R
6Destination Region ID/MetaData/Declaration/GoodsShipment/Destination/RegionID16 04 000 000Region of destinationText inputRegion/state/province of destination, if required.D
7Destination Qualifier Code/MetaData/Declaration/GoodsShipment/Destination/CCQualifierCodeTo be confirmed by national DMS mappingDestination qualifierDropdownQualifier providing context for destination data.D
8Invoice Amount/MetaData/Declaration/GoodsShipment/InvoiceAmount14 06 000 000Total amount invoicedAmount inputTotal invoice value for the shipment.R
9Invoice Currency Code/MetaData/Declaration/GoodsShipment/InvoiceCurrencyCode14 05 000 000Invoice currencyCurrency dropdownCurrency used on the commercial invoice.R
10Acceptance Date/MetaData/Declaration/GoodsShipment/AcceptanceDateTime15 09 000 000 or national mappingAcceptance dateDate pickerDate of customs or commercial acceptance, depending on DMS rule.D
11Currency Exchange Currency/MetaData/Declaration/GoodsShipment/CurrencyExchange/CurrencyTypeCode14 05 000 000 / valuation mappingCurrency for exchangeCurrency dropdownCurrency for exchange-rate conversion, where valuation requires it.D
12Currency Exchange Rate/MetaData/Declaration/GoodsShipment/CurrencyExchange/RateNumeric14 15 000 000Exchange rateDecimal inputExchange rate used to convert invoice or customs value.D
13Trade Term Condition Code/MetaData/Declaration/GoodsShipment/TradeTerms/ConditionCode14 01 000 000Delivery termsIncoterm dropdownIncoterm condition, for example FOB. FOB means Free on Board.R
14Trade Term Description/MetaData/Declaration/GoodsShipment/TradeTerms/Description14 01 000 000Delivery terms descriptionText inputFree-text description of the trade terms, if needed.O
15Trade Term Location ID/MetaData/Declaration/GoodsShipment/TradeTerms/LocationID14 01 000 000Delivery terms place codeText inputCode or identifier of the named place for the Incoterm.D
16Trade Term Location Name/MetaData/Declaration/GoodsShipment/TradeTerms/LocationName14 01 000 000Delivery terms placeText inputName of the place linked to the Incoterm, such as port or terminal.D
17Trade Term Country Code/MetaData/Declaration/GoodsShipment/TradeTerms/CountryCode14 01 000 000Delivery terms countryCountry dropdownCountry of the Incoterm location.D
18Warehouse ID/MetaData/Declaration/GoodsShipment/Warehouse/ID12 11 000 000 or procedure-specificWarehouse identifierText inputWarehouse identifier when goods are stored under customs warehousing.D
19Warehouse Type Code/MetaData/Declaration/GoodsShipment/Warehouse/TypeCode12 11 000 000 or procedure-specificWarehouse typeDropdown / code listType of customs warehouse or storage facility.D

Tab 4 — Transport & Consignment

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Container Code/MetaData/Declaration/GoodsShipment/Consignment/ContainerCode19 07 000 000Container indicatorDropdown / code listIndicates whether the goods are containerised.D
2Total Gross Mass/MetaData/Declaration/GoodsShipment/Consignment/TotalGrossMassMeasure18 04 000 000Gross massDecimal inputTotal gross weight of the consignment including packaging.R
3Carrier ID/MetaData/Declaration/GoodsShipment/Consignment/Carrier/ID13 12 017 000Carrier identification numberText inputIdentifier of the carrier transporting the goods.D
4Consignment UCR/MetaData/Declaration/GoodsShipment/Consignment/UCR/TraderAssignedReferenceID12 08 000 000Reference number / UCRText inputTrader-assigned unique consignment reference.D
5Arrival Transport ID/MetaData/Declaration/GoodsShipment/Consignment/ArrivalTransportMeans/ID19 05 017 000Identification of means of transport on arrivalText inputIdentification of the transport means on arrival.D
6Arrival Mode Code/MetaData/Declaration/GoodsShipment/Consignment/ArrivalTransportMeans/ModeCode19 03 000 000Mode of transport at arrivalDropdownMode of transport on arrival.D
7Border Transport ID/MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/ID19 06 017 000Identification of means of transport crossing the borderText inputIdentification of the transport crossing the border.D
8Border Registration Nationality Code/MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/RegistrationNationalityCode19 08 000 000Nationality of active means of transport crossing the borderCountry dropdownCountry of registration or nationality of border transport.D
9Border Mode Code/MetaData/Declaration/GoodsShipment/Consignment/BorderTransportMeans/ModeCode19 03 000 000 / 19 04 000 000Mode of transport at the borderDropdownMode of transport at the border crossing.D
10Departure Transport ID/MetaData/Declaration/GoodsShipment/Consignment/DepartureTransportMeans/ID19 05 017 000 or national mappingIdentification of means of transport at departureText inputIdentification of the transport means at departure.D
11Goods Location ID/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/ID16 15 000 000Location of goodsText inputIdentifier of the place where goods are available for customs control or inspection.D
12Goods Location Type Code/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/TypeCode16 15 000 000Location of goods typeDropdownCode describing the type of goods location.D
13Goods Location Address/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/Address/Line16 15 000 000Location of goods addressText inputPhysical address of the goods location.D
14Goods Location Latitude/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/LatitudeID16 15 000 000Location of goods latitudeCoordinate inputLatitude coordinate of the goods location.O
15Goods Location Longitude/MetaData/Declaration/GoodsShipment/Consignment/GoodsLocation/LongitudeID16 15 000 000Location of goods longitudeCoordinate inputLongitude coordinate of the goods location.O
16Itinerary Routing Country/MetaData/Declaration/GoodsShipment/Consignment/Itinerary/RoutingCountryCode16 12 000 000Country of routingRepeatable gridCountry through which the goods travel.D
17Transport Contract Document ID/MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/ID12 05 000 000Transport documentRepeatable gridReference number of the transport contract document.D
18Transport Contract Document Type Code/MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/TypeCode12 05 000 000Transport document typeRepeatable gridType of transport document, such as bill of lading or waybill.D
19Transport Equipment ID/MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/ID19 07 063 000Container identification numberRepeatable gridContainer or transport equipment number.D
20Seal ID/MetaData/Declaration/GoodsShipment/Consignment/TransportEquipment/Seal/ID19 10 000 000Seal numberRepeatable gridSeal number attached to the container or equipment.D

Tab 5 — Goods Items

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Goods Item Sequence/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/SequenceNumeric11 03 000 000Goods item numberNumber inputLine number or sequence of the goods item.R
2Goods Description/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Description18 05 000 000Description of goodsLong textPlain-language description of the goods being declared.R
3Customs Value Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValueAmount14 07 000 000Customs valueAmount inputCustoms value of the goods item.R
4Customs Value Currency/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValueAmount/@currencyID14 07 000 000Customs value currencyCurrency dropdownCurrency of the customs value amount.R
5Statistical Value Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/StatisticalValueAmount99 06 000 000Statistical valueAmount inputStatistical value used for customs or trade statistics.D
6Item Transaction Nature Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/TransactionNatureCode99 05 000 000Nature of transactionDropdownNature of transaction at goods item level, if different from shipment level.D
7Item Dispatch Country Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/DispatchCountryCode16 06 000 000Country of dispatchCountry dropdownDispatch country at goods item level, if different from shipment level.D
8Classification ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/ID18 09 056 000Commodity codeText/code inputCommodity classification code, such as HS, CN or TARIC depending on DMS rules.R
9Classification Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/Classification/IdentificationTypeCode18 09 056 000Commodity code typeDropdownIndicates which classification code system is used.R
10Gross Mass/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/GrossMassMeasure18 04 000 000Gross massDecimal inputGross weight of the goods item including packaging.R
11Net Net Weight/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/NetNetWeightMeasure18 01 000 000Net massDecimal inputNet weight excluding packaging, if required by the commodity or procedure.D
12Tariff Quantity/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/GoodsMeasure/TariffQuantity18 02 000 000Supplementary unitsDecimal inputSupplementary/tariff quantity required for tariff/statistical purposes.D
13Origin Country Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/CountryCode16 08 000 000Country of originCountry dropdownCountry of origin of the goods item.R
14Preferential Origin / Origin Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Origin/TypeCode16 09 000 000 or national mappingPreferential origin country / origin typeDropdownCode indicating the type or basis of origin, where applicable.D
15Packaging Quantity/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/QuantityQuantity18 06 004 000Number of packagesRepeatable gridNumber of packages.D
16Packaging Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/TypeCode18 06 003 000Kind of packagesRepeatable gridCode describing the type of packaging.D
17Marks and Numbers/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Packaging/MarksNumbersID18 06 054 000Shipping marksRepeatable gridShipping marks or package identification markings.D
18UNDG ID/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/DangerousGoods/UNDGID18 07 000 000Dangerous goods UN numberRepeatable gridUN dangerous goods number, if goods are dangerous.D
19Current Procedure Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/CurrentCode11 09 001 000Requested procedureDropdownCustoms procedure requested for the goods item.R
20Previous Procedure Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/PreviousCode11 09 002 000Previous procedureDropdownPrevious customs procedure, where applicable.D
21Additional Procedure Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/GovernmentProcedure/AdditionalProcedure/ProcedureCode11 10 000 000Additional procedureRepeatable gridAdditional procedure code applicable to the goods item.D

Tab 6 — Documents & References

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Authorisation ID/MetaData/Declaration/Authorisation/ID12 12 001 000Authorisation reference numberRepeatable gridReference number of the customs authorisation.D
2Authorisation Type Code/MetaData/Declaration/Authorisation/TypeCode12 12 002 000Authorisation typeRepeatable gridType of customs authorisation.D
3Authorisation Holder ID/MetaData/Declaration/Authorisation/AuthorisationHolder/ID12 12 080 000Authorisation holderRepeatable gridIdentifier of the party holding the authorisation.D
4Additional Reference ID/MetaData/Declaration/GoodsShipment/AdditionalReference/ID12 04 001 000Additional reference numberRepeatable gridAdditional commercial/customs reference.D
5Additional Reference Type Code/MetaData/Declaration/GoodsShipment/AdditionalReference/TypeCode12 04 002 000Additional reference typeRepeatable gridType of additional reference.D
6Statement Code/MetaData/Declaration/GoodsShipment/AdditionalInformation/StatementCode12 02 008 000Additional information codeRepeatable gridCode identifying the additional information statement.D
7Statement Description/MetaData/Declaration/GoodsShipment/AdditionalInformation/StatementDescription12 02 009 000Additional information textRepeatable gridFree-text explanation or statement required by customs.D
8Previous Document ID/MetaData/Declaration/GoodsShipment/PreviousDocument/ID12 01 001 000Previous document reference numberRepeatable gridReference number of a previous customs or commercial document.D
9Previous Document Type Code/MetaData/Declaration/GoodsShipment/PreviousDocument/TypeCode12 01 002 000Previous document typeRepeatable gridType of previous document.D
10Supporting Document ID/MetaData/Declaration/GoodsShipment/SupportingDocument/ID12 03 001 000Supporting document reference numberRepeatable gridReference number of a document supporting the declaration.D
11Supporting Document Type Code/MetaData/Declaration/GoodsShipment/SupportingDocument/TypeCode12 03 002 000Supporting document typeRepeatable gridType of supporting document, such as licence, certificate or invoice.D
12Supporting Document Expiry Date/MetaData/Declaration/GoodsShipment/SupportingDocument/ExpirationDateTime12 03 013 000Supporting document validity / expiry dateDate pickerExpiry date of the supporting document, if applicable.D
13Supporting Document Line Number/MetaData/Declaration/GoodsShipment/SupportingDocument/LineNumeric12 03 007 000Supporting document line item numberNumber inputLine number in the supporting document, where relevant.D
14Transport Document ID/MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/ID12 05 001 000Transport document reference numberRepeatable gridReference number of the transport document.D
15Transport Document Type Code/MetaData/Declaration/GoodsShipment/Consignment/TransportContractDocument/TypeCode12 05 002 000Transport document typeRepeatable gridType of transport document.D
16Consignment UCR/MetaData/Declaration/GoodsShipment/Consignment/UCR/TraderAssignedReferenceID12 08 000 000Reference number / UCRText inputTrader-assigned unique consignment reference.D
17Item UCR/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/UCR/TraderAssignedReferenceID12 08 000 000Reference number / UCRText inputItem-level unique commercial or consignment reference.D

Tab 7 — Valuation, Duties & Taxes

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Declaration Freight Charge Amount/MetaData/Declaration/CustomsValuation/FreightChargeAmount14 10 000 000 or valuation adjustment mappingFreight costsAmount inputFreight amount declared for customs valuation purposes.D
2Declaration Freight Charge Currency/MetaData/Declaration/CustomsValuation/FreightChargeAmount/@currencyID14 10 000 000Freight costs currencyCurrency dropdownCurrency of the freight charge amount.D
3Shipment Charge Type Code/MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/ChargesTypeCode14 04 000 000Additions and deductionsRepeatable gridType of additional charge or deduction.D
4Shipment Charge/Deduction Amount/MetaData/Declaration/GoodsShipment/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount14 04 000 000Additions and deductions amountRepeatable gridAmount of the charge or deduction.D
5Valuation Method Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/MethodCode14 11 000 000Valuation methodDropdownCustoms valuation method used for the item.D
6Item Charge/Deduction Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/ChargesTypeCode14 04 000 000Additions and deductionsRepeatable gridType of item-level charge or deduction.D
7Item Charge/Deduction Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/CustomsValuation/ChargeDeduction/OtherChargeDeductionAmount14 04 000 000Additions and deductions amountRepeatable gridAmount of item-level charge or deduction.D
8Valuation Addition Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/ValuationAdjustment/AdditionCode14 04 000 000Addition/deduction codeDropdownCode identifying a valuation adjustment or addition.D
9Tax Assessed Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/TaxAssessedAmount14 03 000 000 or national duties/taxes mappingDuties and taxes amountAmount inputTotal duty/tax amount assessed for the goods item.D
10Duty Regime Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyRegimeCodeNational duties/taxes mappingDuty regimeDropdownDuty regime applicable to the goods item.D
11Duty/Tax/Fee Type Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TypeCode14 03 039 000 or national mappingTax typeRepeatable gridType of duty, tax or fee.D
12Payment Method Code/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/Payment/MethodCode14 03 038 000 or national mappingMethod of paymentDropdownMethod used to pay duty, tax or fee.D
13Payment Amount/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/Payment/PaymentAmount14 03 000 000Duties and taxes payable amountAmount inputAmount payable for the duty, tax or fee line.D
14Tax Rate/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/TaxRateNumericNational duties/taxes mappingTax rateDecimal inputRate used to calculate duty or tax.D
15Specific Tax Base Quantity/MetaData/Declaration/GoodsShipment/GovernmentAgencyGoodsItem/Commodity/TaxCalculation/DutyTaxFee/TaxBase/SpecificTaxBaseQuantityNational duties/taxes mappingSpecific tax base quantityQuantity inputQuantity-based tax base, where duty/tax is based on units or weight.D

Tab 8 — Guarantee & Payment

OrderField labelXML pathUCC Annex B pathUCC Annex B data element nameUI controlExplanatory descriptionR/O/D
1Deferred Payment ID/MetaData/Declaration/DeferredPayment/ID14 02 000 000 or national mappingDeferred payment / payment referenceText inputDeferred payment account or reference used for customs charges.D
2Payer ID/MetaData/Declaration/Payer/ID13 14 017 000Person paying customs duty identification numberText inputIdentifier of the party responsible for paying customs duties, taxes or fees.D
3Surety ID/MetaData/Declaration/Surety/ID13 13 017 000 or guarantee mappingSurety identification numberText inputIdentifier of the surety or guarantor.D
4Security Details Code/MetaData/Declaration/ObligationGuarantee/SecurityDetailsCode99 02 000 000 or guarantee mappingGuarantee type / security detailsDropdownCode describing the type of security or guarantee provided.D
5Guarantee Amount/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AmountAmount99 02 000 000 or guarantee mappingGuarantee amountAmount inputMonetary amount covered by the guarantee.D
6Guarantee Currency/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AmountAmount/@currencyID99 02 000 000 or guarantee mappingGuarantee amount currencyCurrency dropdownCurrency of the guarantee amount.D
7Guarantee Reference ID/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/ID99 02 000 000 or guarantee mappingGuarantee reference numberText inputReference number of the guarantee.D
8Guarantee Access Code/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/AccessCode99 02 000 000 or guarantee mappingGuarantee access codeText inputAccess code used to validate or use the guarantee.D
9Guarantee Office ID/MetaData/Declaration/ObligationGuarantee/GuaranteeReference/GuaranteeOffice/ID17 11 000 000 or guarantee mappingCustoms office of guaranteeLookupCustoms office responsible for the guarantee.D