Bin Location Set
{{api_url}}/shop/inventory/bin_location_updateSet the bin locatiSets the bin location for SKUs in one or more warehouses. Each row names a SKU, a warehouse, and the bin, so one call can set bins for many SKUs across many warehouses. The same SKU can have a different bin in each warehouse.
This only changes where a SKU is stored. It does not change inventory quantity. To change quantity, use Inventory Set or Inventory Set Bulk.
Body
A JSON array as the body root, one object per row:
| Field | Type | Description |
|---|---|---|
sku | string | The SKU to update. |
warehouse_id | integer | The InfiPlex warehouse the bin is in. Use Warehouse Search to find a warehouse's ID. |
bin_location | string | The bin, for example bin09. |
The same SKU can appear on more than one row with different warehouses.
Example
Put CF226A-C in bin09 in warehouse 9, and CF281A-C in bin14 in warehouse 14 and bin80 in warehouse 80:
[
{"sku": "CF226A-C", "warehouse_id": 9, "bin_location": "bin09"},
{"sku": "CF281A-C", "warehouse_id": 14, "bin_location": "bin14"},
{"sku": "CF281A-C", "warehouse_id": 80, "bin_location": "bin80"}
]
Response
The rows, echoed back:
[
{"sku": "CF226A-C", "warehouse_id": 9, "bin_location": "bin09"},
{"sku": "CF281A-C", "warehouse_id": 14, "bin_location": "bin14"},
{"sku": "CF281A-C", "warehouse_id": 80, "bin_location": "bin80"}
]
| Field | Type | Description |
|---|---|---|
sku | string | The SKU from the row. |
warehouse_id | integer | The warehouse from the row. |
bin_location | string | The bin set for the SKU in that warehouse. |
Before you build
- These are the same bin locations shown on the Inventory page in InfiPlex and set by the
bin_locationcolumn of the Price & Inventory upload. A later change from any of those places replaces the value you set here. - To read a SKU's current bin, use Inventory Search. Each row carries
bin_locationfor its warehouse. - Your API key needs Inventory write permission. A key without it gets
403 Forbidden.
Related guides:
InfiPlex OMS API Overviewon for a sku in a warehouses
Authorization
Bearer token, sent in the Authorization header. Inherited from the collection.
Headers
| Key | Value | Description |
|---|---|---|
Content-Type | application/json |
Body
[
{
"sku": "CF226A-C",
"warehouse_id": 9,
"bin_location": "bin09"
},
{
"sku": "CF281A-C",
"warehouse_id": 14,
"bin_location": "bin14"
},
{
"sku": "CF281A-C",
"warehouse_id": 80,
"bin_location": "bin80"
}
]Example Request
curl --location --request POST '{{api_url}}/shop/inventory/bin_location_update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{auth_token}}' \
--data '[
{
"sku": "CF226A-C",
"warehouse_id": 9,
"bin_location": "bin09"
},
{
"sku": "CF281A-C",
"warehouse_id": 14,
"bin_location": "bin14"
},
{
"sku": "CF281A-C",
"warehouse_id": 80,
"bin_location": "bin80"
}
]'Example Responses
Bin Location Set
Request
curl --location --request POST '{{api_url}}/shop/inventory/bin_location_update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '[
{
"sku": "CF226A-C",
"warehouse_id": 9,
"bin_location": "bin09"
},
{
"sku": "CF281A-C",
"warehouse_id": 14,
"bin_location": "bin14"
},
{
"sku": "CF281A-C",
"warehouse_id": 80,
"bin_location": "bin80"
}
]'Response 200 OK
[
{
"sku": "CF226A-C",
"warehouse_id": 9,
"bin_location": "bin09"
},
{
"sku": "CF281A-C",
"warehouse_id": 14,
"bin_location": "bin14"
},
{
"sku": "CF281A-C",
"warehouse_id": 80,
"bin_location": "bin80"
}
]
