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 ("available for picking" and "available on stock"). This means, if the stock level in a given facility is equal or less than the configured safety stock, the available stock is.

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.

As of now, safety stock is only designed for internal planning, e.g., via the stock overview. It is not considered in order routing which means that safety stock can still be sold online when using our order routing.

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-07-27T08:02:59.989Z",
      "id": "text",
      "lastModified": "2024-07-27T08:02:59.989Z",
      "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();