Preview Quick Reorder
POST/api/purchasing/quick-reorder/preview
Expand a selection of products into orderable lines grouped by supplier. Nothing is written.
purchase-orders:writeGrant 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).
quantityis 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_quantityis 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
skippedwith 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
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.