Skip to main content

Preview Quick Reorder

POST 

/api/purchasing/quick-reorder/preview

Expand a selection of products into orderable lines grouped by supplier. Nothing is written.

Required scope: purchase-orders:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

  • Matrix (parent) products expand into their active variants.
  • Each product is grouped under its default supplier (or its first supplier when none is marked default).
  • quantity is pre-filled from the reorder suggestion when it is above zero (quantity_source: suggestion — daily demand × (lead time + target stock days) less available and inbound stock, rounded up to the supplier MOQ), otherwise the quantity on the product's most recent non-draft purchase order (last_order), otherwise 0 (none). suggested_quantity is null when the product has no demand history and 0 when stock already covers demand.
  • Bundles, kits, archived products and products without a supplier are returned in skipped with a reason.

Requires the create purchase orders permission and the purchase-orders scope.

Body fields:

  • product_ids (array of integers, required, 1–500, distinct) — products, variants or matrix parents to reorder.

Request​

Responses​

OK

Response Headers
    Content-Type