Skip to main content

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