Skip to main content

Reorder Allocation

POST 
/api/v2/inventory-allocations/:allocation/reorder

Moves a queued backorder (status planned or awaiting_receipt) within its product's release order. Stock arriving for the product is released to backorders in priority order.

Required scope: orders:write

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

Any move pins the moved backorder: when the queue is later re-sorted by demand date (on a purchase order cover, release or cancel), a pinned backorder keeps its place in line and every other backorder stays in date order around it. Only the moved backorder is pinned. The pin ends when the backorder leaves the queue, moves to another warehouse, or is sent back with back_to_date_order.

Body:

  • reorder_type (required) — move_to_top | move_to_bottom | move_up | move_down | move_above_id | back_to_date_order
  • options.above_id (integer, used by move_above_id) — the backorder to take the place of; it and the rows after it move down one. Ignored unless it is a queued backorder of the same product.

A backorder with no priority (not queued) is returned unchanged. Returns the moved backorder. Each row: id, priority (1 = released first), is_priority_pinned (true when the backorder was moved by hand — the priority reshuffle keeps it at its place in line), priority_pinned_at, backorder_date, backordered_quantity, quantity, status (planned | awaiting_receipt), status_label, is_tight_coverage, demand_type (sales | manufacturing), source_number, source_id, manufacturing_order_id, demand_date, sales_order (null for manufacturing demand), sku, supplier, coverage (the covering purchase order line, or null), scheduled_at, created_at.

Request​

Responses​

OK

Response Headers
    Content-Type