In the FedEx Ship API request body, populate 'customsClearanceDetail.commodities' with an array of line items: description, quantity, unitPrice, customsValue, countryOfManufacture, and harmonizedCode
Set 'customsClearanceDetail.dutiesPayment.paymentType' to 'SENDER' (DDP) or 'RECIPIENT' (DAP) based on your trade terms; include accountNumber for sender-paid duties
Set 'shippingDocumentSpecification.shippingDocumentTypes' to include 'COMMERCIAL_INVOICE' and 'ETD' to generate both a printable invoice and submit it electronically
After shipment creation, use GET /ship/v1/shipments/{trackingNumber}/documents to retrieve the generated commercial invoice PDF URL for your records
For high-value goods exceeding customs de minimis thresholds, include an accurate 'freightOnValue' and 'insuranceCharges' to ensure correct duty calculation
Known gotchas
Harmonized (HS) codes must match the actual commodity; misclassification triggers customs delays, fines, and potential seizure — consult a trade compliance resource for correct codes
FedEx ETD is not available for all country pairs; if the destination country does not accept paperless clearance, the API responds with EWO status and paper originals must be included
The FedEx developer sandbox does not validate ETD submission with real customs systems; ETD errors may only surface in production — test with low-value shipments first
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp