Bin Location Set

POST{{api_url}}/shop/inventory/bin_location_update

Set 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:

FieldTypeDescription
skustringThe SKU to update.
warehouse_idintegerThe InfiPlex warehouse the bin is in. Use Warehouse Search to find a warehouse's ID.
bin_locationstringThe 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"}
]
FieldTypeDescription
skustringThe SKU from the row.
warehouse_idintegerThe warehouse from the row.
bin_locationstringThe 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_location column 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_location for 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

KeyValueDescription
Content-Typeapplication/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"
    }
]