Total declared contents. Required by carriers that want a declaration even with no customs items. Plain-language description of everything in the shipment.
Total declared value of the shipment. The amount as an exact decimal string (e.g. “19.99”).
ISO 4217 currency code (e.g. USD).
Customs declaration. Required for international shipments; carriers reject them without one. AES exemption to cite when your account files by exemption. Ignored if your account files by ITN; defaults to NOEEI_30_37_A.
Description of the contents to print on the form. Defaults to your configured description, or the item descriptions joined together.
What the shipment holds. Defaults to MERCHANDISE.
The declared lines (max 100). Plain-language description of the goods.
Harmonized System tariff code for the goods.
Manufacturer of the goods, when the carrier requires it.
The manufacturer’s part number. Required on EU B2C imports when the product is not exempt.
Your identifier for the goods, typically a SKU. Not a barcode or GTIN.
Country where the goods were manufactured.
Legacy single identifier for the goods (e.g. a SKU). Prefer merchantProductId, manufacturerProductId, and standardizedProductId.
How many units of this line are in the shipment.
A standardized identifier such as a GTIN (barcode). Not your SKU.
Declared value of a single unit. The line total is derived as this times quantity. Every item must use the same currency — carriers accept one currency per form.
Weight of a single unit. Lines whose declared total exceeds the shipment’s actual weight are scaled down to fit it.
Internal Transaction Number for a shipment you filed with AES, e.g. “AES X20260827123456”. Used only if your account is configured to file by ITN.
What to do if the shipment cannot be delivered. Defaults to RETURN.
Assigns who is billed for duties and import taxes: the sender (DDP) or the recipient (DAP). Does not affect the quoted or charged rate — duties are billed separately after the shipment moves. Omit to leave the choice to your carrier configuration.
The parcels in the shipment (max 5). The unit the value is expressed in.
The numeric magnitude of the length.
The unit the value is expressed in.
The numeric magnitude of the length.
The unit the value is expressed in.
The numeric magnitude of the weight.
The unit the value is expressed in.
The numeric magnitude of the length.
Return address, if different from the ship-from address. Tax identifiers for the shipment, e.g. an IOSS number for EU-bound goods. Which party the identifier belongs to.
Country of the authority that issued it.
