Per-SKU object
immediate_inventory
Values reflect warehouse and Shopify availability after open orders are allocated. A SKU can show
0 in one region while still having future incoming quantity.
future_inventory
Each region contains an array of ETA lines, sorted by expected_date ascending:
Multiple purchase-order lines with the same date in a region are summed into one entry.
Regional mapping
Data freshness
refreshed_at is updated when inventory is recomputed (warehouse syncs, order transforms, and a nightly full refresh). Treat it as a freshness indicator, not a cache TTL — poll at the rate your integration requires.