Update inventory quantity by SKU and warehouse
Updates inventory with a SKU count and availability for a given warehouse. You can do it in two ways:
-
Define a quantity: Indicate a specific number of items of a SKU from a warehouse, and it will decrease whenever an item is sold. When the last item is sold, the SKU will run out of stock.
-
Set an unlimited inventory: Always have items of a SKU from a warehouse considered available for sales. When this configuration is active, the SKU never runs out of stock.
Permissions
Any user or API key must have at least one of the appropriate License Manager resources to be able to successfully run this request. Otherwise they will receive a status code 403 error. These are the applicable resources for this endpoint:
| Product | Category | Resource |
|---|---|---|
| Logistics | Logistics access | Logistics full access |
| Logistics | Logistics access | Logistics inventory full access |
You can create a custom role with that resource or use one of the following predefined roles:
| Role | Resource |
|---|---|
| Logistics - Full access | Logistics full access |
| OMS - Full access | Logistics full access |
| Logistics - Full access | Logistics inventory full access |
| OMS - Full access | Logistics inventory full access |
❗ Assigning a predefined role to users or application keys usually grants permission to multiple License Manager resources. If some of these permissions are not necessary, consider creating a custom role instead. For more information regarding security, see Best practices for using application keys. To learn more about machine authentication at VTEX, see [Authentication overview](https://developers.vtex.com/docs/guides/authentication.
Path parameters
Unique identifier of the SKU you wish to update.
Unique identifier of the warehouse of the SKU you wish to update.
Headers
Type of the content being sent.
HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.
Request body
Example request
{
"quantity": 201,
"dateUtcOnBalanceSystem": "2024-01-31T19:12:01.025662+00:00"
}Response
No Content