Skip to main content

Move To Line

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

Moves on-hand (allocated) stock from this allocation to a backordered line in the same product + warehouse pool — a conserved swap.

Required scope: orders:write

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

The moved quantity releases the destination line's backorder (planned / awaiting_receipt → allocated), carrying the source allocation's FIFO release_source reference. The source's allocated row is reduced by the same quantity (or cancelled if fully consumed), and the source's demand is recreated as a planned backorder. Total on-hand commitment, total demand, and FIFO cost layering are all preserved.

Body:

  • destination_sales_order_line_id (required, integer) — the backordered sales order line to move stock to. Must exist and be in the same product + warehouse pool. Get valid targets from GET /move-targets.
  • quantity (required, numeric, > 0) — how much on-hand stock to move. Must not exceed the source's movable on-hand quantity (allocated minus any stock committed to open fulfillments) nor the destination line's backordered quantity.

Returns 422 when the source is not allocated, the destination is a different product/warehouse or the same line, the quantity exceeds the movable on-hand stock (e.g. committed to an open fulfillment) or the destination's backorder, or the destination has no matching backorder to release.

Request​

Responses​

OK

Response Headers
    Content-Type