Implement international customs documentation (commercial invoice, HS codes, incoterms) for a cross-border shipment API

domain: logistics-general · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. For each line item in the shipment, look up the correct 6-digit HS (Harmonized System) tariff code using a customs classification service or your product database
  2. Build a customs object with: recipient EIN/IOSS/EORI tax identifier (required for EU and UK), incoterms code (e.g. DAP or DDP), and a commodities array with description, quantity, unit value, country of origin, and HS code per line
  3. Set the dutiesPayment on the shipment: DAP (Delivered At Place) bills duties to the recipient; DDP (Delivered Duty Paid) bills them to the shipper account
  4. Include the customs object in the shipment creation request to the carrier API (FedEx, DHL, UPS); some carriers auto-generate the commercial invoice PDF from this data
  5. For shipments into the EU valued under the de minimis threshold, include the IOSS number in the customs object to prevent double VAT collection at customs
  6. Archive the commercial invoice and customs data per shipment for a minimum of 5 years to comply with export record-keeping requirements

Known gotchas

Related routes

Build a customs declaration and commercial invoice payload for an international shipment label via carrier APIs
logistics/shipping · 6 steps · unrated
Generate a compliant commercial invoice for an international shipment programmatically, including required fields for customs clearance
logistics-general · 6 steps · unrated
Upload trade documents (commercial invoice, certificate of origin, export license, etc.) for a UPS international shipment using the Paperless Documents API
developer.ups.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans