Skip to main content

Switch Supplier Options

POST 
//:domain/api/v2/inventory-allocations/switch-supplier-options

Returns the per-allocation supplier picker payload used by the Allocation Pipeline Change Supplier dialog. Only allocations in planned or awaiting_receipt status are eligible. For each eligible allocation, returns the list of suppliers configured for that product (via supplier_products), excluding archived suppliers.

Body:

  • ids (required, array, min 1) — Array of inventory allocation IDs.
  • ids.* (integer) — Each ID must be an integer.

Notes:

  • Allocations whose status is not planned or awaiting_receipt are silently filtered out (they are not eligible for supplier change).
  • Each row's suppliers list is sorted with the default supplier first, then alphabetically by name.
  • Use the returned current_supplier.id to highlight the existing selection in the UI.

Request​

Responses​

OK

Response Headers
    Content-Type