Safety Stock

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

This page is outdated. Please go to our new documentation under https://docs.fulfillmenttools.com/documentation.

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

Query parameters

sizenumber · min: 1 · max: 100OptionalDefault: 25

startAfterIdstringOptional

tenantArticleIdstringOptional

facilityRefstringOptional

Responses

200

Available Safety Stocks

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

get

HTTPcURLJavaScriptPython

GET /api/safetystocks HTTP/1.1
Host: 
Accept: */*

{
  "safetyStocks": [
    {
      "created": "2025-05-12T11:12:01.746Z",
      "facilityRef": "text",
      "id": "text",
      "lastModified": "2025-05-12T11:12:01.746Z",
      "tenantArticleId": "text",
      "value": 1,
      "version": 1
    }
  ],
  "total": 1
}

Update Safety Stocks in bulk

put

Body

Responses

207

Result of the bulk operations

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

put

HTTPcURLJavaScriptPython

PUT /api/safetystocks HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "operations": [
    {
      "facilityRef": "text",
      "tenantArticleId": "text",
      "value": 1
    }
  ]
}

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

Delete a single Safety Stock

delete

Path parameters

safetyStockIdstringRequired

Responses

200

Result of the bulk operations

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

404

The requested entity was not found

application/json

delete

HTTPcURLJavaScriptPython

DELETE /api/safetystocks/{safetyStockId} HTTP/1.1
Host: 
Accept: */*

No content