Inventory Adjust
This API adjusts the inventory count for a product at a location. It is different from Inventory Refresh because rather than stating the total quantity of the product, this adjustment specifies the amount of change in the form of increments and decrements (+/-). For example, there would be a -2 quantity for an item if there were two fewer than in the previous count, a +2 quantity if there were two more, and a 0 quantity if there were no change.
Note that unlike other OMS APIs, there are two endpoints that may be used. Each endpoint is associated with a different API key related to a package – either an “Inventory V5” or “Inventory Specific” package. The Inventory Specific package is the preferred endpoint to use, but some implementations may use Inventory V5 depending on their configuration.
Version | 5.0 |
Call – Inventory V5 | https://integration.shopatron.com/api/v5/inventory/adjust |
Call – Inventory Specific | https://integration.shopatron.com/inv/api/v5/inventory/adjust |
Supported Formats | JSON |
HTTP Method | POST |
An example use of the Inventory API follows below, or view the sample Postman Collection.
Example
The example case will adjust an inventory with the following properties:
- Location named “Location 1”
- Product 000-11111-22-A adjusted to a quantity of 0
Required Parameters
Adjusting an order requires:
Parameter | Type | Description |
locationName | string | Store Name for this request. The minimum length is 1. |
items | array | List of items to adjust. |
The items array is built as an object (/[object]) with the following parameters. The quantity and any one of the other parameters except binID are required.
Parameter | Type | Description |
partNumber | string | The product part number. The minimum length is 1. |
upc | string | The product’s Universal Product Code. The minimum length is 1. |
sku | string | The product’s Stock Keeping Unit code. The minimum length is 1. |
binID | integer | The bin location identifier. The minimum value is “1”. |
quantity | integer | The quantity of the product. The minimum value is “0”. |
inventoryLocatorName | string | An identifier to indicate where a particular SKU exists within a location. For example, “Aisle 5” would indicate that the bin this item belongs to is located in Aisle 5. The maximum length is 50. |
The Full Request
This is the entire body of the request that will adjust an inventory.
{
"locationName":"Location 1",
"items":[
{
"partNumber":"testsku120",
"sku":"testsku120",
"quantity":0
}]
}
The Full Response
The response will only return a jobID in the form of an integer.
{
"jobID": 76543210
}