Skip to main content

Build Forecast (Single Supplier)

POST 
/api/inventory-forecasting/build-single

Build a forecast for a single supplier. If product count is large, dispatches a background job and returns a job_id for polling. Otherwise returns the result synchronously.

Authentication: Requires Bearer token.

Response type field: sync (includes data) or async (includes job_id for status polling).

Returns 422 if too many products.

enforce_minimum_order_value / enforce_minimum_order_quantity: when true, the response minimums block per supplier flags whether the forecast totals fall below the supplier's minimum_purchase_order / minimum_purchase_order_quantity. Display-only on this endpoint; enforcement is applied at PO creation time (POST /api/inventory-forecasting/purchase-orders).

Request​

Responses​

Successful response