Get Online ATP of Products

Discover how to retrieve online ATP for products at specific locations with the 'getProductOnlineAtp' API

Store Associates need to access the online Available to Promise (ATP) inventory of products on their POS systems for sendsales orders. The getProductOnlineAtp API facilitates retrieving the online ATP of a product from all locations except the one it's being ordered from. The API does not count the Online ATP of a facility in the following scenarios:

  1. Inventory for the store placing the order.

  2. Inventory from stores with sell online turned off.

  3. Inventory for an SKU where the inventory is turned off in specific locations.

To fetch the online ATP details, make a POST request to the /getProductOnlineAtp endpoint.

Request

End Point

https://<host>/api/service/getProductOnlineAtp

Example https://demo-oms.hotwax.io/api/service/getProductOnlineAtp

Content-Type: application/json

Body

{
  "idType": "<SKU>",
  "idValue": "<SKU>",
  "productStoreId": "<STORE_ID>",
  "conditionMap": {
    "externalFacilityId_value": "<External Facility ID>",
    "externalFacilityId_op": "<operator>"
  }
}

Sample

{
  "idType": "SKU",
  "idValue": "MSH02-32-Black",
  "productStoreId": "DEMO_STORE",
  "conditionMap": {
    "externalFacilityId_value": "101",
    "externalFacilityId_op": "notEqual"
  }
}

Parameters

Parameter NameDescription

idType

Specifies the type of identifier being used (e.g., "SKU")

idValue

The specific value of the SKU being referenced

productStoreId

Identifies the store or location within the system where the product is available

conditionMap

Contains conditions for filtering or specifying attributes related to the request

externalFacilityId_value

The value of the external facility ID

externalFacilityId_op

The operation or condition applied to the external facility ID (e.g., "notEqual")

Response

Status Code

HTTP/1.1 200 OK

Headers

Content-Type: application/json

Body

{
    "onlineAtp": "<Value>"
}

Sample

{
    "onlineAtp": 100
}

Parameters

Parameter NameDescription

onlineAtp

The online available to promise inventory of the product

Last updated