Stock balance API Resource

Stock balances identify how many physical units of a product is available in specific warehouses.

POST /warehouse-management/stock-balance/reservations

Creates new or updates existing reservations in the warehouse management system.

Request Parameters
name type description
X-Instance-Id header Identifies the merchant instance, required for all API calls.
X-Language header Specifies the requested language of a resource, for example sv. If not present, this will default to a pre-configured language, most commonly en.
Request Body
media type data type description
application/json array of ReservationRequest The reservations to create or update.
Response Codes
code condition
204 The reservations were successfully created or updated.
400 Given input parameters are incorrect, a more descriptive error message is provided in the response body.

Example

Request
POST /warehouse-management/stock-balance/reservations
Content-Type: application/json
X-Instance-Id: ...
X-Language: ...

                
[ {
  "stockKeepingUnitId" : 12345,
  "priceLookUpNumber" : "...",
  "warehouseId" : 12345,
  "warehouseNumber" : "...",
  "reference" : "...",
  "desiredQuantity" : 12345
} ]
Response
HTTP/1.1 204 No Content

GET /warehouse-management/stock-balance/stock-balances

Searches for stock balances in the system.

Request Parameters
name type description default constraints multivalued
X-Instance-Id header Identifies the merchant instance, required for all API calls.     no
X-Language header Specifies the requested language of a resource, for example sv. If not present, this will default to a pre-configured language, most commonly en.     no
europeanArticleNumber query Filter on the European article number of stock keeping units.     yes
modifiedAfter query Filter on last modification date. Useful for getting delta-changes. More details.     no
page query The page to search for. 1 int no
priceLookUpNumber query Filter on the price look-up number of stock keeping units.     yes
priceLookupNumber query Filter on the price look-up number of stock keeping units. Deprecated in favor of priceLookUpNumber due to a typo.     yes
priceLookupUnitNumber query Filter on the price look-up number of stock keeping units. Deprecated in favor of priceLookUpNumber due to a typo.     yes
resultsPerPage query The number of results per page. Must be a value between 1 and 200.   int no
searchId query The search ID to use for continued pages. Not usable together with any of the filters. More details.     no
stockKeepingUnitId query Filter on the internal identifier of stock keeping units.   int yes
warehouseId query Filter on warehouse by their internal number.   int yes
warehouseNumber query Filter on the external number of warehouses.     yes
Response Codes
code condition
200 The search was successful.
400 Given input parameters are incorrect, a more descriptive error message is provided in the response body.
Response Body
media type data type description
application/json StockBalanceResult The search result.

Example

Request
GET /warehouse-management/stock-balance/stock-balances
Content-Type: */*
Accept: application/json
X-Instance-Id: ...
X-Language: ...

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "searchId" : "236c000d-70a8-4a6c-beed-36e788c107b9",
  "page" : 1,
  "pagesLeft" : 1,
  "totalHits" : 29,
  "stockBalances" : [ {
    "stockKeepingUnitId" : 619,
    "priceLookUpNumber" : "14114192",
    "europeanArticleNumber" : "14114192",
    "warehouseId" : 1,
    "balance" : 12,
    "availableBalance" : 9,
    "modifiedAt" : "2024-03-21T14:36:43.412+01:00",
    "warehouseNumber" : "W01"
  }, {
    "stockKeepingUnitId" : 12345,
    "priceLookUpNumber" : "...",
    "europeanArticleNumber" : "...",
    "warehouseId" : 12345,
    "balance" : 12345,
    "availableBalance" : 12345,
    "modifiedAt" : "...",
    "warehouseNumber" : "..."
  } ]
}

POST /warehouse-management/stock-balance/stock-balances

Creates new or updates existing stock balances in the warehouse management system.

Request Parameters
name type description
X-Instance-Id header Identifies the merchant instance, required for all API calls.
X-Language header Specifies the requested language of a resource, for example sv. If not present, this will default to a pre-configured language, most commonly en.
Request Body
media type data type description
application/json array of StockBalanceUpdate The stock balances to create or update.
Response Codes
code condition
204 The stock balances were successfully created or updated.
400 Given input parameters are incorrect, a more descriptive error message is provided in the response body.

Example

Request
POST /warehouse-management/stock-balance/stock-balances
Content-Type: application/json
X-Instance-Id: ...
X-Language: ...

                
[ {
  "stockKeepingUnitId" : 12345,
  "priceLookUpNumber" : "...",
  "warehouseId" : 12345,
  "warehouseNumber" : "...",
  "balance" : 12345,
  "estimatedShippingDate" : "2024-10-25"
} ]
Response
HTTP/1.1 204 No Content