Skip to main content

​
Overview

Update the available quantity of a SKU in a specific warehouse. The quantity represents how many pieces can be sold.
Update e-CROSS as soon as possible after SKU inventory changes to mitigate backorder scenarios, i.e., the selling of an SKU that is not available.

​
Update SKU Inventory

Updates the quantity of inventory for a given SKU and warehouse ID. 
curl -X POST 'https://product.api.e-cross.tech/ext/inventories/' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "skuId": "1234567891",
    "quantity": 49,
    "warehouseId": 1
  }'

{
  "id": "ACME-1234567891-1",
  "skuId": "1234567891",
  "skuName": "T-Shirt",
  "merchantId": "ACME",
  "quantity": 3,
  "lastUpdateDate": "2024-01-17T19:58:53.270Z",
  "warehouseId": 1
}

​
Request Parameters

​
skuId
string
required
The SKU ID in the sales channel (the SKU_ID used to create the SKU).
​
quantity
integer
required
The available quantity of the SKU. This represents how many pieces can be sold.
​
warehouseId
integer
required
The ID of the warehouse where the SKU is stocked. Use 1 unless you are informed otherwise.

​
Response Fields

​
id
string
required
The unique identifier of this SKU inventory record.
​
merchantId
string
required
The unique identifier of the merchant within the e-CROSS platform.
​
skuId
string
required
The SKU ID in the sales channel.
​
skuName
string
The SKU name within e-CROSS. If the SKU isn’t registered in the e-CROSS platform, this field won’t be returned.
​
warehouseId
integer
required
The ID of the warehouse where the SKU is stocked.
​
quantity
integer
required
The quantity of SKUs stocked in this warehouse.
​
lastUpdateDate
string
required
The date and time when the product inventory entry was created or the quantity was changed, in ISO 8601 format.
​
lastIntegrationDate
string
The date and time when the sales channel updated the inventory quantity in their system. If no integration has occurred yet, this field won’t be returned.
Setting quantity to 0 will make the SKU unavailable for purchase in connected sales channels. Ensure you update inventory levels promptly when items are restocked.

List Orders

Next: Learn how to retrieve orders ready for fulfillment