v1

latestOpenAPI 3.0.0Apache License Version 2.02026-07-24163274903.6 KB
Inventory Service

getCurrentInventoryByPage

Retrieve the current inventory for a product or subset of products.

get/inventory/currentinventory/v1/getCurrentInventoryByPage

Query parameters

locationCodestring

The code that identifies the location in Crunchtime.

productNumberstring

The code number for the product to retrieve. (case sensitive).

lotNumberstring

The Lot Number associated with the product in inventory.

summarizeByProductboolean

Flag to control whether products are summed for the entire location or separated by storage location. Valid values are 'true' or 'false'. When 'true', results are aggregated across all storage locations and ordered by locationCode and productNumber. When 'false', results are separated by storage location and ordered by locationCode, storageName and productNumber. If left blank, the default is 'true'.

categoryNamestring

The category name assigned to the product. Use 3 or more characters.

subcategoryNamestring

The subcategory name assigned to the product. Use 3 or more characters.

microcategoryNamestring

The microcategory name assigned to the product. Use 3 or more characters.

pageNumberinteger

Retrieve one or more records by pageNumber. Use to retrieve data in smaller chunks. If left blank, the default is 1.

pageSizeinteger

Number of items to display per page.

includeNullboolean

Specify 'true' to output null data elements.

Headers

authenticationtokenstring required

Secure token for API authentication.

passwordstring required

Password for the Crunchtime Application User.

sitenamestring required

Crunchtime site identifier. (test or production)

useridstring required

User ID for the Crunchtime Application User.

X-B3-TraceIdstring

Optional trace identifier for troubleshooting.

Response

Success

hasNextboolean
totalPagesinteger

Example response

{
  "currentInventoryDetails": [
    {
      "currentInventoryDetailDetails": [
        {
          "locationCode": "BS002",
          "locationName": "Boston Store",
          "storageName": "Produce Cooler",
          "storageCode": "0004",
          "productName": "Romaine Lettuce",
          "lotNumber": "165R-13593",
          "categoryName": "FOOD",
          "subcategoryName": "PRODUCE",
          "microcategoryName": "VEGETABLE",
          "glCode": "5010-0005",
          "glDescription": "Produce",
          "inventoryUnit": "LB",
          "onHandQuantity": 24,
          "onHandValue": 35.7,
          "inTransitQuantity": 4.5,
          "inTransitValue": 7.49,
          "totalQuantity": 45.8,
          "totalValue": 98.58,
          "customerOrderQuantity": 7.5,
          "vendorOrderQuantity": 20
        }
      ]
    }
  ]
}