Skip to main content
POST
/
commerce
/
inventory
/
v5
/
inventory
/
aggregate
Error
A valid request URL is required to generate request examples
[
  {
    "tenantID": 123,
    "onHand": 123,
    "available": 123,
    "partNumber": "<string>",
    "upc": "<string>",
    "sku": "<string>",
    "floor": 123,
    "tags": {},
    "success": true,
    "messages": [
      "<string>"
    ],
    "numResults": 123
  }
]

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme.

Query Parameters

x-vol-site
integer

Site ID

Body

application/json

Request to aggregate inventory

Request for aggregating inventory

items
Item · object[]

List of Items to search on

ignoreSafetyStock
boolean

Whether to ignore the safety stock buffer put in place

includeNegativeInventory
boolean

Whether to allow items with negative inventory in the results

directShip
boolean

Whether to limit results to locations that are shipping enabled

transferEnabled
boolean

Filter results by locations that have transfer enabled (true) or don't (false)

pickup
boolean

Filter results by pickup enabled (true) or not (false)

tags
object

Associative Map of <String, String> for tagCategoryName => tagName

includeFutureInventory
enum<string>

Enum for including future inventory: [futureOnly, futureAndCurrent]

Available options:
futureOnly,
futureAndCurrent
includeNegativeFutureInventory
boolean

Whether to allow items with negative future inventory in the results

futureStartDate
string<date-time>

Future start Date at which the inventory should be allocated against.

futureEndDate
string<date-time>

Future end Date at which the inventory should be allocated against.

forceDefaultsForUnspecifiedTagCategories
boolean

Whether to force populate default tags onto the request if they are unspecified for any tag category

locationCode
string

Location Code

userID
integer

user id

pageSize
integer

how many results to show per page

pageNum
integer

which page to show

sortBy
string

index to sort results by

Response

Success

tenantID
integer

Manufacturer Identifier

onHand
integer

The quantity the location has in its possession

available
integer

The quantity the location has that are available for purchase

partNumber
string

Part/Product Number

upc
string

Universal Product Code

sku
string

Stock Keeping Unit

floor
integer

Absolute minimum quantity of this item that should be in stock at any time

tags
object

Associative Map of <String, String> for tagCategoryName => tagName

success
boolean

Flag for success

messages
string[]

List of messages

numResults
integer

Number of results