Safety Stock

This page contains information about benefits, usage and context of the configurable safety stock

Introduction

Safety stock enables you to guard your offline sales against online-induced stockouts. It can be defined on facility level, and decreases the available stock levels (for online sales): If the stock level in a given facility is equal or less than the configured safety stock, the available stock (for online sales) is 0, i.e. it is not considered for routing any more so that no online orders are accepted to be fulfilled from this facility.

Quick Start

Users can configure the desired safety stock quantity for each listing. Configurations can be made in the stock overview. For more information, please refer to Stock Availabilities.

API Documentation

Get all Safety Stocks

GET/api/safetystocks

Query parameters

Response

200401403

Available Safety Stocks

Body

application/json

total*number

safetyStocks*array of SafetyStock (object)

Request

JavaScriptCurl

const response = await fetch('/api/safetystocks', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "total": 0,
  "safetyStocks": [
    {
      "tenantArticleId": "text",
      "value": 0,
      "facilityRef": "text",
      "created": "2024-04-28T19:52:27.974Z",
      "id": "text",
      "lastModified": "2024-04-28T19:52:27.974Z",
      "version": 0
    }
  ]
}

Update Safety Stocks in bulk

PUT/api/safetystocks

Body

application/json

operations*array of SafetyStockBulkOperation (object)

Response

207401403

Result of the bulk operations

Body

application/json

tenantArticleId*string

facilityRef*string

value*number

status*enum

UPDATEDCREATEDFAILED

errorBulkOperationError (object)

Request

JavaScriptCurl

const response = await fetch('/api/safetystocks', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "operations": [
        {
          "tenantArticleId": "text",
          "value": 0
        }
      ]
    }),
});
const data = await response.json();

Response

{
  "tenantArticleId": "text",
  "facilityRef": "text",
  "value": 0,
  "status": "UPDATED",
  "error": {
    "type": "VALIDATION",
    "message": "text"
  }
}

Delete a single Safety Stock

DELETE/api/safetystocks/{safetyStockId}

Path parameters

safetyStockId*string

Response

200401403404

Result of the bulk operations

Request

JavaScriptCurl

const response = await fetch('/api/safetystocks/{safetyStockId}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();