get_landed_cost
Calculate total landed cost for imports, breaking down FOB value, ocean freight, insurance, customs duty, and import VAT. Includes HS code classification and origin-sensitive trade remedies.
Instructions
Get the full LANDED COST (cost puesto en destino) of an import — the number the importer's margin actually depends on, not just the freight. Returns merchandise value (FOB) + all-in ocean freight (base + every surcharge) + insurance (CIF) + CUSTOMS DUTY + import VAT/consumption tax, as a line-item breakdown, plus the % of landed cost that is freight vs duties vs taxes. Includes an HS-CODE CLASSIFIER: pass a product description ('bluetooth earbuds', 'office chairs', 'cotton t-shirts') and it proposes the most likely HS6 heading with a confidence score (and 2-3 candidates when the text is ambiguous), or pass an explicit hs_code. Duty is modeled per destination bloc (US HTS, EU TARIC, UK Global Tariff, Canada, Australia, Japan) with the right MFN rate for the product family, then the ORIGIN-SENSITIVE trade remedies: US Section 301 applied ONLY to China-origin goods, Section 232 on steel/aluminium, an ANTIDUMPING/CVD flag on high-risk family×origin combos (it warns, it does not invent a rate), and FTA PREFERENCE (EVFTA, USMCA, CETA, EU-Japan EPA, RCEP, …) when origin↔destination share an agreement — subject to rules of origin. De-minimis is handled (US $800, EU €150, …): below threshold → no duty/tax. Import VAT is computed on the correct CIF+duty base (EU VAT by country; the US has no federal import VAT). Every figure is tagged typical/modeled; this is an INDICATIVE landed-cost estimate and HS-classification aid, NOT a binding customs ruling. PREMIUM: pay per call with x402 (USDC on Base) or set a prepaid key (FREIGHT_PULSE_KEY). Same UN/LOCODE port normalization as get_spot_rate.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origin_port | Yes | Origin port (city name, UN/LOCODE, or 'City, Country'). The origin COUNTRY drives Section 301 / FTA / antidumping. | |
| dest_port | Yes | Destination port (city name, UN/LOCODE). The destination COUNTRY drives the duty bloc (US/EU/UK/CA/AU/JP) and import VAT. | |
| product | No | Product description to classify, e.g. 'bluetooth earbuds', 'office chairs', 'cotton t-shirts', 'car tyres'. The classifier maps it to an HS6 heading. Provide this OR hs_code. | |
| hs_code | No | Explicit HS code (6+ digits, e.g. '851830'). Overrides the text classifier. Provide this OR product. | |
| fob_value | Yes | Merchandise value (FOB) in USD — the goods value at origin. REQUIRED: duties & taxes are computed on this (via CIF). | |
| container_type | No | Container size '20ft'/'40ft'/'40HC' for the freight leg. Optional; defaults to '40ft'. | |
| ship_date | No | Intended ship date (ISO). Drives seasonal freight surcharges. Optional; defaults to today. | |
| estimated_days_at_port | No | Days the box will dwell at destination (adds Demurrage & Detention to the freight leg). Optional. | |
| free_days | No | Carrier free days before D&D (default 5 if a dwell is given). | |
| overweight | No | Flag an overweight load (freight surcharge). Optional. | |
| fuel_proxy | No | Optional VLSFO $/tonne for the BAF model. Optional. | |
| insurance_rate_pct | No | Marine insurance as a fraction of FOB+freight for the CIF model (default 0.005 = 0.5%). Optional. |