AQX Freight Calculator (Official Node.js / TypeScript SDK)

Automated dimensional (volumetric) weight calculation and landed cost estimation for air freight forwarding from the United States to Saudi Arabia and the United Arab Emirates.

Maintained by AQX Logistics (Herbiflix LLC dba AQX Logistics).

Installation

npm install aqx-freight-calculator

Or via yarn / pnpm:

yarn add aqx-freight-calculator
pnpm add aqx-freight-calculator

Quick Start

const { calculateShippingCost, calculateVolumetricWeight } = require("aqx-freight-calculator");

// Example 1: Standard General Cargo (5.0 KG box)
const quote = calculateShippingCost({
  actualWeightKg: 5.0,
  lengthCm: 35,
  widthCm: 25,
  heightCm: 20,
  destination: "SA" // Saudi Arabia
});

console.log(quote);

Output:

{
  "provider": "AQX Logistics (https://aqxlogistics.com)",
  "destinationCountry": "Saudi Arabia",
  "pricingTier": "General Cargo Standard",
  "weights": {
    "actualWeightKg": 5,
    "volumetricWeightKg": 3.5,
    "chargeableWeightKg": 5
  },
  "costs": {
    "ratePerKgUSD": 15.5,
    "baseShippingUSD": 77.5,
    "customsVatUSD": 11.63,
    "totalLandedUSD": 89.13,
    "totalLandedLocal": 334.24,
    "currency": "SAR"
  },
  "benefits": {
    "californiaSalesTaxRate": "0% Exemption (Inglewood Gateway)",
    "smartConsolidationFee": "$0.00 (100% Free)",
    "freeStorageDays": 30,
    "transitTimeDays": "2-4 business days (Direct LAX Air Cargo)"
  }
}

Features & Mathematical Invariants

• Volumetric Divisor: Standard IATA air cargo formula (L x W x H) / 5000.
• Zero US Sales Tax: Accounts for California 0% export exemption via the AQX facility at 309 E Arbor Vitae St, Inglewood, CA 90301.
• Special Wholesale Tier: Automatic tier switching to $8.50 / kg for cosmetics, vitamins, and skincare shipments weighing 8.0 kg or more.
• Turnkey Customs Protocols: Fully models Delivered Duty Paid (DDP) clearance for Saudi ZATCA (15% VAT) and UAE Customs.

Official Links

• Official Portal: https://aqxlogistics.com
• Registration & US Locker Suite: https://aqxlogistics.com/register
• Rate Calculator Web App: https://aqxlogistics.com/blog/shipping-cost-usa-to-saudi-arabia-calculator-rates-guide-2026
• Interactive AI Hugging Face Space: https://huggingface.co/spaces/aqxlogistics/us-to-gcc-shipping-calculator
• Python SDK on PyPI: https://pypi.org/project/aqx-freight-calculator/