Revision

Introduction

(Web) shops selling physical products to their customers place great value in fulfilling their client commitments. Important aspect is understanding the currently available stock. On this basis, the (web) shop is able to provide their customers with the correct delivery indication.

This operation allows the (web) shop to request the physically available stock of one or multiple products.  

Requirements:

• This operation concerns available stock of the owner ready to be delivered. 
• No account is taken of buyer restrictions such as delivery agreements, credit checks etc.
• No account is taken of agreed logistical constraints like cut-off times.

This operation only supports REST.

Authentication for this webservice

This operation needs authentication.

Operation getStockAvailability

Request

POST
https://testservices.cb.nl/rest/api/v1/PhysicalProductStockService/getStockAvailabilityByOwner HTTP/1.1
UserName: _SNIP_
Password: _SNIP_
Content-Type: application/json
  
{
    "Product": [
    {"ProductId": "9780582275225", "ProductIdType": "OWN", "OwnerId": "123456"},
    {"ProductId": "9783259011928", "ProductIdType": "OWN", "OwnerId": "123456"}
    ]
}

Reply

{
  "StockAvailabilityByOwner": [
    {
      "ProductId": "9780582275225",
      "ProductIdType": "OWN",
      "OwnerId": "123456",
      "QuantityAvailable": "1554"
    },
    {
      "ProductId": "9783259011928",
      "ProductIdType": "OWN",
      "OwnerId": "123456",
      "QuantityAvailable": "11"
    }
  ]
}

{
  "Message": {
    "MessageType": "E",
    "MessageCode": "WMS-00021",
    "MessageText": "Invalid value for productIdType."
  }
}

Specific messages (type/code/text) for this webservice

As of February 1, 2022, CB will no longer support TLS 1.0 and 1.1

Volume limits and performance requirements

Performance

The average service response time is no less than 2 seconds in prime time (08:00 -01:00). Inside this window, 99.95% of the requests will be dealt with. Outside prime time, 99% of the requests will be dealt with within 6 seconds.