Preview Inbound Shipment Release Impact
POST/api/inbound-shipments/receive/preview-release-impact
Read-only preview of which back-ordered sales orders an inbound-shipment receive would fill, per receipt line. Send the same payload you would POST to receive the shipment; each line is resolved to its purchase order line, product and receive warehouse and evaluated against waiting back-ordered demand. Nothing is written.
Each row describes one product the receive would restock. releasable_quantity is the number of incoming units that can be released to back-ordered demand; orders[] are the back-ordered sales orders that would be filled; held_back[] is demand that stays back-ordered, with reason_kept explaining why (e.g. "Insufficient supply").
Body: the same shape as the receive call. Minimum: received_at plus either a purchase_order_id or receipt_lines (each with purchase_order_line_id or purchase_order_line_reference and a quantity). warehouse_id defaults to the purchase order's destination warehouse. release_backorders (true/false/null) mirrors the receive call's release control.
Authentication: Requires Bearer token.
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.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
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.