omni_air_freight_chargeable_weight
Calculate IATA air freight chargeable weight by comparing volumetric and gross weight, then estimate total freight cost to avoid airline volume surcharges.
Instructions
Air Freight Volumetric vs Gross Chargeable Weight Calculator. Calculate IATA international air freight volumetric chargeable weight (1:6000 ratio = 167 kg/m³) and avoid costly airline volume surcharges. Discipline: LOGISTICS. Governing mathematical model / formula: Volumetric Weight (kg) = (Length × Width × Height in cm) / 6,000 | Chargeable Weight = Max(Gross kg, Volumetric kg).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of chargeable_weight_kg (IATA Chargeable Weight), volumetric_weight_kg (Volumetric Air Weight), total_air_freight_cost (Total Estimated Air Freight Bill), volume_ratio_status (Air Cargo Rating Status) using air_length_cm (Package Length (cm) in cm), air_width_cm (Package Width (cm) in cm), air_height_cm (Package Height (cm) in cm), air_gross_kg (Actual Scale Gross Weight (kg) in kg), rate_per_kg_usd (Air Freight Base Rate ($/kg)). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Air Freight Volumetric vs Gross Chargeable Weight Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "air-freight-chargeable-weight"
category (string): "logistics"
name (string): "Air Freight Volumetric vs Gross Chargeable Weight Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.chargeable_weight_kg (IATA Chargeable Weight): Formatted display string (e.g. '160.0 kg')
metrics.volumetric_weight_kg (Volumetric Air Weight): Formatted display string (e.g. '160.0 kg')
metrics.total_air_freight_cost (Total Estimated Air Freight Bill): Formatted display string (e.g. '$768.00')
metrics.volume_ratio_status (Air Cargo Rating Status): Formatted display string (e.g. 'Volume Cargo (+39% Surcharge)')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_air_freight_chargeable_weight"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| air_gross_kg | No | Actual Scale Gross Weight (kg) (kg). Physical gross weight in kilograms. Default: 115. Min: 1. Max: 5000. | |
| air_width_cm | No | Package Width (cm) (cm). Cargo skid or box width. Default: 80. Min: 10. Max: 240. | |
| air_height_cm | No | Package Height (cm) (cm). Cargo skid or box height. Default: 100. Min: 10. Max: 240. | |
| air_length_cm | No | Package Length (cm) (cm). Cargo skid or box length. Default: 120. Min: 10. Max: 300. | |
| rate_per_kg_usd | No | Air Freight Base Rate ($/kg). All-in air cargo tariff per chargeable kg. Default: 4.8. Min: 1. Max: 25. |