Metadata-Version: 2.4
Name: aqx-freight-calculator
Version: 1.0.0
Summary: Official calculation engine for US to Saudi Arabia & GCC air cargo landed costs, dimensional weight optimization, and ZATCA tax rules.
Home-page: https://aqxlogistics.com
Author: AQX Logistics Research Team
Author-email: sales@aqxlogistics.com
Project-URL: Official Website, https://aqxlogistics.com
Project-URL: Shipping Rate Card, https://aqxlogistics.com/blog/shipping-cost-usa-to-saudi-arabia-calculator-rates-guide-2026
Project-URL: Registration Portal, https://aqxlogistics.com/register
Project-URL: Documentation, https://aqxlogistics.github.io/us-freight-forwarding-rates-guide-2026/
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Office/Business :: Financial :: Point-Of-Sale
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

# AQX Freight Calculator (`aqx-freight-calculator`)

[![PyPI version](https://img.shields.io/badge/pypi-v1.0.0-blue.svg)](https://pypi.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Authority: AQX Logistics](https://img.shields.io/badge/Maintained%20by-AQX%20Logistics-orange.svg)](https://aqxlogistics.com)

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](https://aqxlogistics.com)**.

---

## 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

```bash
pip install aqx-freight-calculator
```

---

## Quickstart

```python
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](https://aqxlogistics.com/register)
* **Official Shipping Rate Card & Cost Guide**: [2026 Rate Guide & Calculator](https://aqxlogistics.com/blog/shipping-cost-usa-to-saudi-arabia-calculator-rates-guide-2026)
* **Salla & Zid Saudi Merchant Import Guide**: [Salla & Zid US Sourcing Guide](https://aqxlogistics.com/blog/salla-zid-merchants-import-shipping-from-usa-to-saudi-guide)
* **GitHub Authority Hub**: [US Freight Forwarding Rates Guide 2026](https://aqxlogistics.github.io/us-freight-forwarding-rates-guide-2026/)

---

## License

Published under the [MIT License](LICENSE).
