Stocks Configuration (Inventory)

Endpoints to create, update and read stocks configuration.

Get inventory config

get

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Requested Inventory Configuration

application/json

InventoryConfiguration

isMixedStoragebooleanOptional

versionnumberRequired

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

/api/configurations/inventory

HTTPcURLJavaScriptPython

GET /api/configurations/inventory HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "isMixedStorage": true,
  "version": 1
}

Update inventory config

patch

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

InventoryConfigurationForPatch

isMixedStorageboolean · nullableOptional

versionnumberRequired

Responses

200

Requested Inventory Configuration

application/json

InventoryConfiguration

isMixedStoragebooleanOptional

versionnumberRequired

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

patch

/api/configurations/inventory

HTTPcURLJavaScriptPython

PATCH /api/configurations/inventory HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "isMixedStorage": true,
  "version": 1
}

{
  "isMixedStorage": true,
  "version": 1
}

Get stock config

get

Read current stock configuration

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

StockConfiguration config found.

application/json

https://docs.fulfillmenttools.com/documentation/products/inventory-management/configurations

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 endpoint

application/json

404

Entity not found

application/json

get

/api/configurations/stock

HTTPcURLJavaScriptPython

GET /api/configurations/stock HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "version": 42,
  "expectedStock": {
    "generateFromRoutingPlan": false
  },
  "reservedStock": {
    "clearStocksAndReservationsTrigger": [
      {
        "completionEntity": "HANDOVERJOB"
      }
    ]
  },
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z"
}

Update stock config

put

Update stock configuration

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Stock configuration data for updates

Responses

200

The stockConfiguration was successfully created.

application/json

https://docs.fulfillmenttools.com/documentation/products/inventory-management/configurations

400

Invalid input. See response for details

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 endpoint

application/json

put

/api/configurations/stock

HTTPcURLJavaScriptPython

PUT /api/configurations/stock HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "version": 42,
  "expectedStock": {
    "generateFromRoutingPlan": false
  },
  "reservedStock": {
    "clearStocksAndReservationsTrigger": [
      {
        "completionEntity": "HANDOVERJOB"
      }
    ]
  }
}

{
  "id": "text",
  "version": 42,
  "expectedStock": {
    "generateFromRoutingPlan": false
  },
  "reservedStock": {
    "clearStocksAndReservationsTrigger": [
      {
        "completionEntity": "HANDOVERJOB"
      }
    ]
  },
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z"
}

List stock change reasons

get

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation. Get external stock change reasons

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

List of external stock change reasons

application/json

ExternalStockChangeReason

activebooleanRequired

Whether the reason is active

Example: true

createdstring · date-timeOptional

Date of creation

customAttributesobjectOptional

The custom attributes of this external stock change reason

idstringRequired

Id of the external stock change reason

Example: 5aa18b4d-45de-4e9e-92db-936288040272

lastModifiedstring · date-timeOptional

Date of last modification

tenantReasonIdstringOptional

Identifier of the stock change reason

Example: F12

versionnumberRequired

Version of the external stock change reason

Example: 1

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

/api/externalstockchangereasons

HTTPcURLJavaScriptPython

GET /api/externalstockchangereasons HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "reasonLocalized": {
    "de_DE": "FUND",
    "en_US": "FOUND"
  },
  "active": true,
  "created": "2026-03-13T16:24:43.461Z",
  "customAttributes": {},
  "id": "5aa18b4d-45de-4e9e-92db-936288040272",
  "lastModified": "2026-03-13T16:24:43.461Z",
  "tenantReasonId": "F12",
  "version": 1
}

Create stock change reason

post

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation. Post external stock change reason.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

ExternalStockChangeReasonForCreation

activebooleanRequired

Whether the reason is active

Example: true

customAttributesobjectOptional

The custom attributes of this external stock change reason

tenantReasonIdstringOptional

Identifier of the stock change reason

Example: F12

Responses

201

The created external stock change reason

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

post

/api/externalstockchangereasons

HTTPcURLJavaScriptPython

POST /api/externalstockchangereasons HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 111

{
  "reasonLocalized": {
    "de_DE": "FUND",
    "en_US": "FOUND"
  },
  "active": true,
  "customAttributes": {},
  "tenantReasonId": "F12"
}

{
  "reasonLocalized": {
    "de_DE": "FUND",
    "en_US": "FOUND"
  },
  "active": true,
  "created": "2026-03-13T16:24:43.461Z",
  "customAttributes": {},
  "id": "5aa18b4d-45de-4e9e-92db-936288040272",
  "lastModified": "2026-03-13T16:24:43.461Z",
  "tenantReasonId": "F12",
  "version": 1
}

Get stock change reason

get

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation. Get external stock change reason.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

externalStockChangeReasonIdstringRequired

Responses

200

The external stock change reason

application/json

ExternalStockChangeReason

activebooleanRequired

Whether the reason is active

Example: true

createdstring · date-timeOptional

Date of creation

customAttributesobjectOptional

The custom attributes of this external stock change reason

idstringRequired

Id of the external stock change reason

Example: 5aa18b4d-45de-4e9e-92db-936288040272

lastModifiedstring · date-timeOptional

Date of last modification

tenantReasonIdstringOptional

Identifier of the stock change reason

Example: F12

versionnumberRequired

Version of the external stock change reason

Example: 1

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

/api/externalstockchangereasons/{externalStockChangeReasonId}

HTTPcURLJavaScriptPython

GET /api/externalstockchangereasons/{externalStockChangeReasonId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "reasonLocalized": {
    "de_DE": "FUND",
    "en_US": "FOUND"
  },
  "active": true,
  "created": "2026-03-13T16:24:43.461Z",
  "customAttributes": {},
  "id": "5aa18b4d-45de-4e9e-92db-936288040272",
  "lastModified": "2026-03-13T16:24:43.461Z",
  "tenantReasonId": "F12",
  "version": 1
}

Update stock change reason

put

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation. Update external stock change reason.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

externalStockChangeReasonIdstringRequired

Body

application/json

ExternalStockChangeReasonForUpdate

activebooleanOptional

Whether the reason is active

Example: true

customAttributesobjectOptional

The custom attributes of this external stock change reason

idstringOptional

Id of the external stock change reason

Example: 5aa18b4d-45de-4e9e-92db-936288040272

versionnumberRequired

Version of the external stock change reason

Example: 1

Responses

200

The updated external stock change reason

application/json

ExternalStockChangeReason

activebooleanRequired

Whether the reason is active

Example: true

createdstring · date-timeOptional

Date of creation

customAttributesobjectOptional

The custom attributes of this external stock change reason

idstringRequired

Id of the external stock change reason

Example: 5aa18b4d-45de-4e9e-92db-936288040272

lastModifiedstring · date-timeOptional

Date of last modification

tenantReasonIdstringOptional

Identifier of the stock change reason

Example: F12

versionnumberRequired

Version of the external stock change reason

Example: 1

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

/api/externalstockchangereasons/{externalStockChangeReasonId}

HTTPcURLJavaScriptPython

PUT /api/externalstockchangereasons/{externalStockChangeReasonId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 144

{
  "reasonLocalized": {
    "de_DE": "FUND",
    "en_US": "FOUND"
  },
  "active": true,
  "customAttributes": {},
  "id": "5aa18b4d-45de-4e9e-92db-936288040272",
  "version": 1
}

{
  "reasonLocalized": {
    "de_DE": "FUND",
    "en_US": "FOUND"
  },
  "active": true,
  "created": "2026-03-13T16:24:43.461Z",
  "customAttributes": {},
  "id": "5aa18b4d-45de-4e9e-92db-936288040272",
  "lastModified": "2026-03-13T16:24:43.461Z",
  "tenantReasonId": "F12",
  "version": 1
}

Get facility inventory config

get

Get the Inventory Configuration for a specific Facility.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of the facility you want to get the config for. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}) for the path parameter facilityId.

Responses

200

Requested Inventory Facility Configuration

application/json

InventoryFacilityConfiguration

facilityRefstringRequired

idstringRequired

isMixedStoragebooleanOptional

versionnumberRequired

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

/api/facilities/{facilityId}/configurations/inventory

HTTPcURLJavaScriptPython

GET /api/facilities/{facilityId}/configurations/inventory HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "facilityRef": "text",
  "id": "text",
  "isMixedStorage": true,
  "outboundStockConfiguration": {
    "clearTrigger": [
      {
        "event": "pick-job-closed_event-v1",
        "tagFilter": [
          {
            "allowedValues": [
              "text"
            ],
            "tagId": "text"
          }
        ]
      }
    ],
    "locationRef": "text",
    "trackOutboundStock": true
  },
  "version": 1
}

Update facility inventory config

patch

This endpoint allows you to update the inventory configuration for a specific facility. It is used to set or modify the inventory management settings at the facility level.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of the facility you want to set the config to. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}) for the path parameter facilityId.

Body

application/json

InventoryFacilityConfigurationForPatch

isMixedStorageboolean · nullableOptional

versionnumberRequired

Responses

200

Requested Inventory Facility Configuration

application/json

InventoryFacilityConfiguration

facilityRefstringRequired

idstringRequired

isMixedStoragebooleanOptional

versionnumberRequired

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

patch

/api/facilities/{facilityId}/configurations/inventory

HTTPcURLJavaScriptPython

PATCH /api/facilities/{facilityId}/configurations/inventory HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 223

{
  "isMixedStorage": true,
  "outboundStockConfiguration": {
    "clearTrigger": [
      {
        "event": "pick-job-closed_event-v1",
        "tagFilter": [
          {
            "allowedValues": [
              "text"
            ],
            "tagId": "text"
          }
        ]
      }
    ],
    "locationRef": "text",
    "trackOutboundStock": true
  },
  "version": 1
}

{
  "facilityRef": "text",
  "id": "text",
  "isMixedStorage": true,
  "outboundStockConfiguration": {
    "clearTrigger": [
      {
        "event": "pick-job-closed_event-v1",
        "tagFilter": [
          {
            "allowedValues": [
              "text"
            ],
            "tagId": "text"
          }
        ]
      }
    ],
    "locationRef": "text",
    "trackOutboundStock": true
  },
  "version": 1
}

Get facility stock config

get

Get the stock configuration for a specific facility.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

Responses

200

Configuration for stock routing was found.

application/json

FacilityStockConfiguration

createdstring · date-timeOptional

Creation timestamp

idstringRequired

The facility stock configuration ID (same as facility ID)

lastModifiedstring · date-timeOptional

Last modified timestamp

versionnumberRequired

Document version for optimistic locking

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

get

/api/facilities/{facilityId}/configurations/stock

HTTPcURLJavaScriptPython

GET /api/facilities/{facilityId}/configurations/stock HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "created": "2026-03-13T16:24:43.461Z",
  "id": "text",
  "lastModified": "2026-03-13T16:24:43.461Z",
  "listingReactivationAfter": {
    "active": true,
    "value": 24
  },
  "shortpick": {
    "active": true
  },
  "version": 1
}

Update facility stock config

patch

Update the stock configuration for a specific facility.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

Responses

200

Facility was found & patch-set has been applied. The patched facility configuration is in the body.

application/json

FacilityStockConfiguration

createdstring · date-timeOptional

Creation timestamp

idstringRequired

The facility stock configuration ID (same as facility ID)

lastModifiedstring · date-timeOptional

Last modified timestamp

versionnumberRequired

Document version for optimistic locking

400

Invalid input. See response for details.

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

404

The requested entity was not found

application/json

409

A version conflict occurred.

application/json

patch

/api/facilities/{facilityId}/configurations/stock

HTTPcURLJavaScriptPython

PATCH /api/facilities/{facilityId}/configurations/stock HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "created": "2026-03-13T16:24:43.461Z",
  "id": "text",
  "lastModified": "2026-03-13T16:24:43.461Z",
  "listingReactivationAfter": {
    "active": true,
    "value": 24
  },
  "shortpick": {
    "active": true
  },
  "version": 1
}