Skip to main content

Move Line to Configured Product

POST 

/api/configurable-products/lines/:salesOrderLineId/move

Move one sales order line from its base product to its configured SKU's product — Re-link Open Lines for a single line. The line is replaced by a line for the configured product with the same quantity, price, channel tax and line discounts and its options, so the order's total, discount, tax and balance due don't change. Check Line Move to Configured Product tells you first whether it will move.

Required scope: products:write

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

Authentication: Requires Bearer token (scopes products:write and orders:write) and the permissions to create products and update sales orders.

No body. Response data: sales_order_line_id — the ID of the line now on the configured product (moving replaces the line, so it differs from the ID you sent); product_id — the configured product.

Returns 422 when the line can't move, with message and reason (the same sentence), code and fix — the same values Check Line Move to Configured Product returns (see its Blocked lines list). A refusal during the move itself (for example the move would change the order's total, or the line changed meanwhile) returns code: "move_refused" with fix: "open_order". Returns 404 when the line does not exist or line options are switched off.

Request​

Responses​

OK

Response Headers
    Content-Type