跳到主要内容
Docs/Features/Incoterms

Incoterms Calculator

Convert between Incoterms (EXW ↔ FOB ↔ CIF ↔ DDP, etc.) and see exactly which costs flip from seller to buyer at each step. Built for quick "if I quote DDP instead of FOB, what's my new landed price?" math.

![Incoterms Calculator](/docs-img/incoterms.png)

What It Does

  • Converts a quoted price between the 11 Incoterms 2020 modes.
  • Decomposes the all-in price into product cost, EXW handling, inland freight, ocean/air freight, insurance, destination handling, and duty.
  • Highlights the cost item that changes at each Incoterm transition.
  • Pulls indicative freight rates from the freight-rate library (per lane, per container size).
  • When to Use

    Whenever a buyer says "what's the DDP equivalent?", or when you're comparing a CIF quote from a supplier against an EXW quote you'd own end-to-end.

    Conversion Flow

    curl -X POST https://api.anvilhk.com/api/v1/tools/incoterms/convert \
      -H "Authorization: Bearer $ANVIL_KEY" \
      -H "X-Tenant-ID: $TENANT" \
      -H "Content-Type: application/json" \
      -d '{
        "from": "FOB",
        "to": "DDP",
        "amount": 12000,
        "currency": "USD",
        "originPort": "CNSHA",
        "destPort": "USLAX",
        "destAddress": { "country": "US", "zip": "90245" },
        "containerSize": "40HQ",
        "weightKg": 18000,
        "hsCode": "8504.40.85"
      }'

    Returns the new total + a per-leg breakdown.

    Freight Rate Library

    GET /api/v1/tools/freight-rates?origin=CNSHA&dest=USLAX&size=40HQ returns indicative rates per carrier with a 14-day validity window. Pro plans can override with their freight forwarder's actual contract rates.

    API Endpoints

  • `POST /api/v1/tools/incoterms/convert` — calculator.
  • `GET /api/v1/tools/freight-rates` — rate library.
  • `POST /api/v1/tools/freight-rates/manual` — Pro+ override.
  • Pricing & Limits

    PlanConversions / monthManual rates
    Starter2000
    Prounlimited50
    Enterpriseunlimitedunlimited

    Gotchas

  • Insurance defaults to 0.3% of CIF value at 110%. Override per-tenant in **Settings > Trade > Insurance**.
  • Freight rates are indicative — they assume container fully utilized. Partial loads need an LCL quote which Anvil doesn't auto-compute.
  • DDP duty calculation reuses the HS-code tool. If your HS code is uncertain, the duty estimate inherits that uncertainty.