Update inventory by overriding existing values

This endpoint updates inventory by overriding the existing values with all the new inventory properties that are specified in the request body, or creates a new inventory if inventory does not exist. If an existing property is not mentioned in the request body, then the value for the existing property will be displayed as null or zero. Inventory is identified based on the combination of location number, channel ID, and item ID or item SKU.

Authorizations

Authorization

string

headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-site-context

string

required

The x-site-context header is a JSON object that contains information about the source you wish to pull from. The mandatory account is the 24 character identifier found in Copilot. The channel (Sales channel ID), stage (environment name), and date attributes can be used to further narrow the scope of your data source.

Body

application/json

sku

string

required

SKU of the item

itemId

integer

required

Item ID

locationNum

integer

required

Location number is used to identify the warehouse or location where the inventory is going to be kept

channelId

string

required

Sales channel ID. This field is used to identify where the business operations are being held.

vendorId

string

Vendor ID

leadTime

string

The amount of time between when a purchase order is placed to replenish products and when the order is received in the warehouse.

inventoryType

string

Inventory type. It is a classifier attribute that provides flexibility to define types.

infiniteInventory

boolean

Infinite inventory flag.<br /> true indicates that the inventory can be consumed any number of times as per need<br />false indicates that the inventory cannot be used infinitely, and has a limit to be consumed

backOrderDate

string

Inventory restock date

preOrderDate

string

First ship date of inventory

backOrderLimit

integer

Maximum restock inventory quantity

preOrderLimit

integer

Maximum quanity of inventory for first-ship

safetyStock

integer

Reserved inventory quantity at the location

lowStock

integer

Inventory quantity to mark as low stock at the location

segment

string

Inventory segment

region

string

Region where inventory is managed

counters

object

Inventory counter (also known as inventory position) configured by the merchant

attributes

object

Custom attribute of the inventory

Response

200 - application/json

virtualCounters

object

View quantity of inventory, based on pre configured value. For example, 'availableToPurchase' can be a custom attribute configured by merchants.

id

string

Inventory ID

sku

string

SKU of the item

itemId

integer

Item ID for which inventory is updated

locationNum

integer

Location number is used to identify the warehouse or location where the inventory is kept

channelId

string

Sales channel ID. This field is used to identify where the business operations are being held.

vendorId

string

Vendor ID

leadTime

string

The amount of time between when a purchase order is placed to replenish products and when the order is received in the warehouse

inventoryType

string

Type of inventory

infiniteInventory

boolean

Infinite inventory flag.<br /> true indicates that the inventory can be consumed any number of times as per need<br />false indicates that the inventory cannot be used infinitely, and has a limit to be consumed

counters

object

Inventory counter (also known as inventory position) configured by the merchant

attributes

object

Custom inventory attributes configured by the merchant