If you are building a cross-border checkout calculator, e-commerce ERP, or procurement assistant for buyers ordering from US retailers (RockAuto, Amazon US, Sweetwater, Summit Racing, B&H Photo), hardcoding a single courier flat rate will break your landed-cost estimates immediately.
In production international air cargo, three compounding variables determine the real landed cost:
- IATA Volumetric (Dimensional) Weight:
max(actual_kg, (L_cm * W_cm * H_cm) / 5000) - Consolidation & Void-Space Repacking: Removing retail outer cartons and consolidating multi-store orders over a free 30-day window regularly reduces billable volumetric weight by 45%–70% and unlocks lower commercial per-kg brackets (
>= 8.0 kg). - Destination VAT & Customs Duty Thresholds: Every GCC, EU, UK, and Australasian customs authority applies different VAT rates, de minimis rules, and brokerage triggers.
Below is a clean, deterministic Python landed-cost model mirroring the live commercial corridors shipped from our LAX export hub (309 E Arbor Vitae St, Inglewood, CA 90301).
1. Python Landed-Cost Engine Across 15 Customs Regimes
from dataclasses import dataclass @dataclass(frozen=True) class CorridorRule: country: str consolidated_usd_per_kg: float # >= 8.0 kg billable express_usd_per_kg: float # < 8.0 kg billable vat_rate: float # decimal (e.g., 0.15 = 15%) duty_rate: float # standard general tariff duty_threshold_usd: float # approximate CIF de minimis customs_system: str RULES: dict[str, CorridorRule] = { "saudi-arabia": CorridorRule("Saudi Arabia", 8.50, 15.50, 0.15, 0.05, 266.0, "ZATCA FASAH"), "united-arab-emirates": CorridorRule("UAE", 8.50, 15.50, 0.05, 0.05, 81.0, "Dubai Trade / Mirsal 2"), "bahrain": CorridorRule("Bahrain", 8.50, 15.50, 0.10, 0.05, 0.0, "Bahrain NBR / OFOQ"), "kuwait": CorridorRule("Kuwait", 8.50, 15.50, 0.00, 0.05, 0.0, "Kuwait General Customs"), "oman": CorridorRule("Oman", 8.50, 15.50, 0.05, 0.05, 0.0, "Royal Oman Police Bayan"), "qatar": CorridorRule("Qatar", 8.50, 15.50, 0.00, 0.05, 0.0, "Qatar Al-Nadeeb"), "united-kingdom": CorridorRule("United Kingdom", 8.50, 15.50, 0.20, 0.025, 170.0, "HMRC CDS"), "germany": CorridorRule("Germany", 9.00, 15.50, 0.19, 0.03, 165.0, "ATLAS / EUSt"), "france": CorridorRule("France", 9.00, 15.50, 0.20, 0.03, 165.0, "DELTA / TVA"), "spain": CorridorRule("Spain", 9.00, 15.50, 0.21, 0.03, 165.0, "AEAT / IVA"), "netherlands": CorridorRule("Netherlands", 9.00, 15.50, 0.21, 0.03, 165.0, "Douane / BTW"), "sweden": CorridorRule("Sweden", 9.00, 15.50, 0.25, 0.03, 165.0, "Tullverket / Moms"), "portugal": CorridorRule("Portugal", 9.00, 15.50, 0.23, 0.03, 165.0, "AT Alfândega / IVA"), "australia": CorridorRule("Australia", 11.00, 15.50, 0.10, 0.05, 650.0, "ABF ICS / GST"), "new-zealand": CorridorRule("New Zealand", 11.00, 15.50, 0.15, 0.05, 600.0, "NZCS / GST"), } def estimate_landed_cost( corridor_slug: str, goods_value_usd: float, actual_kg: float, dims_cm: tuple[float, float, float], repack_factor: float = 0.45, ) -> dict: rule = RULES[corridor_slug] l, w, h = dims_cm raw_vol_kg = round((l * w * h) / 5000.0, 2) repacked_kg = max(0.5, actual_kg, round(raw_vol_kg * repack_factor, 2)) rate = rule.consolidated_usd_per_kg if repacked_kg >= 8.0 else rule.express_usd_per_kg freight_usd = round(repacked_kg * rate, 2) cif_usd = goods_value_usd + freight_usd duty_usd = round(cif_usd * rule.duty_rate, 2) if cif_usd > rule.duty_threshold_usd else 0.0 vat_usd = round((cif_usd + duty_usd) * rule.vat_rate, 2) return { "country": rule.country, "customs_system": rule.customs_system, "raw_volumetric_kg": raw_vol_kg, "repacked_billable_kg": repacked_kg, "rate_usd_per_kg": rate, "freight_usd": freight_usd, "est_duty_usd": duty_usd, "est_vat_usd": vat_usd, "total_landed_usd": round(cif_usd + duty_usd + vat_usd, 2), } 2. Example: 11 kg Auto Parts Consolidation (USA to Bahrain & Portugal)
Suppose a workshop orders brake rotors, control arms, and gaskets across 3 US warehouses totaling 11.0 kg actual weight, packed in oversized retail cartons measuring 60 × 50 × 45 cm (27.0 kg raw volumetric weight):
- Unconsolidated courier billing (
27.0 kg): You pay for16.0 kgof empty cardboard air! - Consolidated LAX repacking (
12.15 kgbillable): Unlocks commercial tier (>= 8.0 kg):- USA → Bahrain (
$8.50/kg):$103.28air freight (2–4 business days) + 10% Bahrain VAT. - USA → Portugal (
$9.00/kg):$109.35air freight (2–4 business days) + 23% IVA via AT Alfândega.
- USA → Bahrain (
3. Live Regional Corridor Guides & Open Tools
Every corridor rule above maps to live air freight calculators, customs breakdowns, and MCP agent endpoints:
- Interactive Landed-Cost & Volumetric Calculator: AQX Live Shipping Calculator
- GCC Corridor Guides: USA to Saudi Arabia | USA to UAE / Dubai | USA to Bahrain | USA to Kuwait | USA to Oman | USA to Qatar
- Europe & Australasia Corridor Guides: USA to Portugal | USA to UK | USA to Germany | USA to Australia | USA to New Zealand
- Official API & MCP Docs (Read the Docs): aqx-shipping-rates-mcp.readthedocs.io
- Open-Source Python MCP Server (MIT): AQXLOGISTICS/aqx-shipping-rates-mcp (also inspectable live on Glama MCP Registry)
Feel free to reuse or extend the CorridorRule dataclass above for your own cross-border checkout or ERP quoting scripts!