Channel Inventory

Channel inventory is currently not fully operational as it is not considered in reservations and routing.

Channel inventory allows inventory to be reserved for specific sales channels or other purposes. Depending on the individual use case, different rules and periods for stock assignment can be defined per channel. Reservations for specific channels are always performed at the facility level.

1. Manage availability channels

Availability channels in our platform are designed to represent sales channels or other topics by which inventory should be grouped.

• name: Each channel is characterized by a unique name for easy identification.

• strategy: Depending on the priority of the distribution path, different strategies can be defined for stock reduction. In the UI, this is referred to as "allocation type":

  • RESTRICT (Only stock that has been explicitly allocated to this channel is available for sale via this channel. As soon as the allocated stock is used up, no stock is available anymore).

  • REGULAR (If an order is accepted via this channel, the allocated stock is first used up. Afterwards, a stock that has not been allocated to any channel is used.)

  • IRON_RESERVE (If an order is accepted via this channel, a stock that is not assigned to any channel is used. Only after all other stock is used the stock explicitly allocated to the channel is taken.)

Create a channel

Create a new Availability Channel

POST/api/availabilitychannels

Body

application/json

name*string

strategy*enum

REGULARIRON_RESERVERESTRICT

Response

200401403

The created Availability Channel

Body

application/json

created*string (date-time)

id*string

lastModified*string (date-time)

name*string

strategy*enum

REGULARIRON_RESERVERESTRICT

version*number

Request

JavaScriptCurlPython

const response = await fetch('/api/availabilitychannels', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "strategy": "REGULAR"
    }),
});
const data = await response.json();

Response

200401403

{
  "created": "2024-12-05T01:50:56.145Z",
  "id": "text",
  "lastModified": "2024-12-05T01:50:56.145Z",
  "name": "text",
  "strategy": "REGULAR",
  "version": 0
}

Update a channel

Channel name and strategy can be changed after creation.

Replace an existing Availability Channel

PUT/api/availabilitychannels/{availabilityChannelId}

Path parameters

availabilityChannelId*string

Body

application/json

name*string

strategy*enum

REGULARIRON_RESERVERESTRICT

version*number

Response

200401403404

The replaced Availability Channel

Body

application/json

created*string (date-time)

id*string

lastModified*string (date-time)

name*string

strategy*enum

REGULARIRON_RESERVERESTRICT

version*number

Request

JavaScriptCurlPython

const response = await fetch('/api/availabilitychannels/{availabilityChannelId}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "strategy": "REGULAR",
      "version": 0
    }),
});
const data = await response.json();

Response

200401403404

{
  "created": "2024-12-05T01:50:56.145Z",
  "id": "text",
  "lastModified": "2024-12-05T01:50:56.145Z",
  "name": "text",
  "strategy": "REGULAR",
  "version": 0
}

Delete a channel

When deleting a channel, the allocated stock is added back to the general availability.

Delete an existing Availability Channel. PLEASE NOTE: This will also delete all groups and allocations under this channel.

DELETE/api/availabilitychannels/{availabilityChannelId}

Path parameters

availabilityChannelId*string

Response

200401403404

The channel has been deleted

Request

JavaScriptCurlPython

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

Response

401403404

[
  {
    "description": "Missing attributes were name, address, items",
    "requestVersion": 41,
    "summary": "One or more mandatory attributes were not provided.",
    "version": 42
  }
]

2. Manage allocation groups

Each allocation must belong to a group. Groups organize allocations in facilities for a specific product and channel. They are also used to display related allocations as grouped in the Backoffice.

• Active: This value can be true or false, depending on whether the allocated stock should be currently considered in stock availability and routing. This allows for flexibility in managing which distribution paths are presently operational. If active is false, the allocated stock is added back to the general availability.

• ActivePeriod: The allocated stock can be considered for a timespan defined at a group level. Channel allocations are only considered in stock availability and routing if the current time is within the defined time period. If the activePeriod is not defined, the allocations are considered as soon as they are created.

• tenantArticleIds: A group organizes allocations for a product identified by the tenantArticleId. Although not technically forbidden, we advise users only to define one product per group.

Create a group

Create a Group under Channel

POST/api/availabilitychannels/{availabilityChannelId}/groups

Path parameters

availabilityChannelId*string

Body

application/json

active*boolean

activePeriodAvailabilityAllocationPeriod (object)

tenantArticleIds*array of string

Response

200401403404

The created Group

Body

application/json

active*boolean

activePeriodAvailabilityAllocationPeriod (object)

channelRef*string

created*string (date-time)

id*string

lastModified*string (date-time)

tenantArticleIds*array of string

version*number

Request

JavaScriptCurlPython

const response = await fetch('/api/availabilitychannels/{availabilityChannelId}/groups', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "tenantArticleIds": [
        "text"
      ],
      "active": false
    }),
});
const data = await response.json();

Response

200401403404

{
  "active": false,
  "activePeriod": {
    "end": "2024-12-05T01:50:56.145Z",
    "start": "2024-12-05T01:50:56.145Z"
  },
  "channelRef": "text",
  "created": "2024-12-05T01:50:56.145Z",
  "id": "text",
  "lastModified": "2024-12-05T01:50:56.145Z",
  "tenantArticleIds": [
    "text"
  ],
  "version": 0
}

Update a group

Status (active) and activePeriod can be changed after creation.

Replace a Group under Channel

PUT/api/availabilitychannels/{availabilityChannelId}/groups/{groupId}

Path parameters

availabilityChannelId*string

groupId*string

Body

application/json

active*boolean

activePeriodAvailabilityAllocationPeriod (object)

version*number

Response

200401403404

The replaced Group

Body

application/json

active*boolean

activePeriodAvailabilityAllocationPeriod (object)

channelRef*string

created*string (date-time)

id*string

lastModified*string (date-time)

tenantArticleIds*array of string

version*number

Request

JavaScriptCurlPython

const response = await fetch('/api/availabilitychannels/{availabilityChannelId}/groups/{groupId}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "version": 0,
      "active": false
    }),
});
const data = await response.json();

Response

200401403404

{
  "active": false,
  "activePeriod": {
    "end": "2024-12-05T01:50:56.145Z",
    "start": "2024-12-05T01:50:56.145Z"
  },
  "channelRef": "text",
  "created": "2024-12-05T01:50:56.145Z",
  "id": "text",
  "lastModified": "2024-12-05T01:50:56.145Z",
  "tenantArticleIds": [
    "text"
  ],
  "version": 0
}

Delete a group

When deleting a group, the allocated stock is added back to the general availability.

Delete an existing Group and all its allocations under Channel

DELETE/api/availabilitychannels/{availabilityChannelId}/groups/{groupId}

Path parameters

groupId*string

availabilityChannelId*string

Response

200401403404

The Group has been deleted.

Request

JavaScriptCurlPython

const response = await fetch('/api/availabilitychannels/{availabilityChannelId}/groups/{groupId}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

401403404

[
  {
    "description": "Missing attributes were name, address, items",
    "requestVersion": 41,
    "summary": "One or more mandatory attributes were not provided.",
    "version": 42
  }
]

3. Manage allocations for channels

The core functionality of channels is realized through availabilityAllocationentities. These entities link channels to specific products (identified by tenantArticleIds) and assign a predetermined quantity of stock to each channel.

• facilityRef: Each allocation can only allocate stocks from one facility to a channel.

• initialStockQuantity: Defines the quantity of items that should be initially allocated to the respective channel within the facility.

Create an allocation

Create a new Allocation under Group

POST/api/availabilitychannels/{availabilityChannelId}/groups/{groupId}/allocations

Path parameters

groupId*string

availabilityChannelId*string

Body

application/json

facilityRef*string

initialStockQuantity*number

Response

200401403404

The created Allocation

Body

application/json

channelRef*string

created*string (date-time)

facilityRef*string

groupRef*string

id*string

initialStockQuantity*number

lastModified*string (date-time)

version*number

Request

JavaScriptCurlPython

const response = await fetch('/api/availabilitychannels/{availabilityChannelId}/groups/{groupId}/allocations', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "facilityRef": "text",
      "initialStockQuantity": 0
    }),
});
const data = await response.json();

Response

200401403404

{
  "channelRef": "text",
  "created": "2024-12-05T01:50:56.145Z",
  "facilityRef": "text",
  "groupRef": "text",
  "id": "text",
  "initialStockQuantity": 0,
  "lastModified": "2024-12-05T01:50:56.145Z",
  "version": 0
}

Update an allocation

InitialStockQuantity and groupId can be changed after creation.

Replace an existing Allocation under a group

PUT/api/availabilitychannels/{availabilityChannelId}/groups/{groupId}/allocations/{allocationId}

Path parameters

groupId*string

allocationId*string

availabilityChannelId*string

Body

application/json

groupIdstring

initialStockQuantity*number

version*number

Response

200401403404

The replaced Allocation

Body

application/json

channelRef*string

created*string (date-time)

facilityRef*string

groupRef*string

id*string

initialStockQuantity*number

lastModified*string (date-time)

version*number

Request

JavaScriptCurlPython

const response = await fetch('/api/availabilitychannels/{availabilityChannelId}/groups/{groupId}/allocations/{allocationId}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "version": 0,
      "initialStockQuantity": 0
    }),
});
const data = await response.json();

Response

200401403404

{
  "channelRef": "text",
  "created": "2024-12-05T01:50:56.145Z",
  "facilityRef": "text",
  "groupRef": "text",
  "id": "text",
  "initialStockQuantity": 0,
  "lastModified": "2024-12-05T01:50:56.145Z",
  "version": 0
}

Delete an allocation

When deleting an allocation, the allocated stock is added back to the general availability.

Delete an existing Allocation under Group

DELETE/api/availabilitychannels/{availabilityChannelId}/groups/{groupId}/allocations/{allocationId}

Path parameters

allocationId*string

groupId*string

availabilityChannelId*string

Response

200401403404

The Allocation has been deleted

Request

JavaScriptCurlPython

const response = await fetch('/api/availabilitychannels/{availabilityChannelId}/groups/{groupId}/allocations/{allocationId}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

401403404

[
  {
    "description": "Missing attributes were name, address, items",
    "requestVersion": 41,
    "summary": "One or more mandatory attributes were not provided.",
    "version": 42
  }
]