omni_inventory_turnover_days_sales
Calculates inventory turnover ratio and days sales of inventory from COGS and beginning/ending inventory values to assess merchandising velocity and working capital efficiency.
Instructions
Inventory Turnover Ratio & Days Sales of Inventory (DSI) Calculator. Evaluate retail merchandising velocity and working capital efficiency by calculating inventory turnover ratio and average days required to sell through inventory. Discipline: ECOMMERCE. Governing mathematical model / formula: Turnover Ratio = Annual COGS / Average Inventory | DSI = (Average Inventory / Annual COGS) × 365 Days.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of inventory_turnover_ratio (Inventory Turnover Ratio), days_sales_inventory_dsi (Days Sales of Inventory (DSI)), average_inventory_cost (Average Inventory Value Held), velocity_classification (Merchandising Health Rating) using annual_cogs (Annual Cost of Goods Sold (COGS) in $), beginning_inventory_value (Beginning Inventory Value ($ Cost) in $), ending_inventory_value (Ending Inventory Value ($ Cost) in $). 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 'Inventory Turnover Ratio & Days Sales of Inventory (DSI) 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): "inventory-turnover-days-sales"
category (string): "ecommerce"
name (string): "Inventory Turnover Ratio & Days Sales of Inventory (DSI) Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.inventory_turnover_ratio (Inventory Turnover Ratio): Formatted display string (e.g. '5.00× per year')
metrics.days_sales_inventory_dsi (Days Sales of Inventory (DSI)): Formatted display string (e.g. '73.0 Days')
metrics.average_inventory_cost (Average Inventory Value Held): Formatted display string (e.g. '$150,000')
metrics.velocity_classification (Merchandising Health Rating): Formatted display string (e.g. 'Optimal DTC Velocity (4× - 6×)')
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_inventory_turnover_days_sales"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| annual_cogs | No | Annual Cost of Goods Sold (COGS) ($). Total wholesale inventory cost sold over the trailing 12 months. Default: 750000. Min: 10000. Max: 50000000. | |
| ending_inventory_value | No | Ending Inventory Value ($ Cost) ($). Inventory valuation at the end of the period. Default: 160000. Min: 1000. Max: 10000000. | |
| beginning_inventory_value | No | Beginning Inventory Value ($ Cost) ($). Inventory valuation at the start of the period. Default: 140000. Min: 1000. Max: 10000000. |