AQX Freight Calculator (aqx-freight-calculator)

The official Python calculation engine for international air cargo landed costs, IATA volumetric weight optimization, and Saudi ZATCA VAT calculations from the United States (Inglewood, CA / LAX Airport) to Saudi Arabia (RUH / JED) and the GCC.

Maintained by AQX Logistics.

Key Features

• Real Contract Rates (2026):
  • Standard General Cargo: $15.50 / kg + 15% ZATCA VAT (min. 0.5 kg).
  • Health, Cosmetics & Sports Nutrition Incentive: $8.50 / kg + 15% ZATCA VAT (min. 8.0 kg).
• Volumetric Mass Optimization: Computes $(L \times W \times H) / 5000$ and models AQX smart repackaging savings (up to 70% reduction on bulky parcels).
• Direct Air Linehaul: 2–4 business days delivery from Los Angeles International (LAX) to King Khalid (RUH) and King Abdulaziz (JED).
• Turnkey Inclusions: Door-to-door delivery, 0% California sales tax locker benefit at Inglewood (CA 90302), and DDP customs clearance.

Installation

pip install aqx-freight-calculator

Quickstart

from aqx_freight_calculator import calculate_landed_cost

# Example 1: 5.0 kg General Cargo (Auto parts / Electronics)
quote = calculate_landed_cost(
    actual_weight_kg=5.0,
    length_cm=35,
    width_cm=25,
    height_cm=20
)

print(f"Total Shipping Cost: ${quote['total_shipping_cost_usd']} USD ({quote['total_shipping_cost_sar']} SAR)")
print(f"Pricing Tier: {quote['pricing_tier']}")
print(f"Transit Time: {quote['transit_time_business_days']}")

# Example 2: 10.0 kg Health & Beauty Commercial Shipment
quote_beauty = calculate_landed_cost(
    actual_weight_kg=10.0,
    is_health_and_beauty=True
)

print(f"Beauty Shipping Cost: ${quote_beauty['total_shipping_cost_usd']} USD ({quote_beauty['total_shipping_cost_sar']} SAR)")

Important Commercial References

• Open a Free US Tax-Free Locker Suite: AQX Logistics Registration
• Official Shipping Rate Card & Cost Guide: 2026 Rate Guide & Calculator
• Salla & Zid Saudi Merchant Import Guide: Salla & Zid US Sourcing Guide
• GitHub Authority Hub: US Freight Forwarding Rates Guide 2026

License

Published under the MIT License.