Notification Center

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

Introduction

Our Notification Center keeps you informed about relevant events within our platform. The feature allows you to configure email notifications for specific events generated by our software:

• Incoming orders: Get emails for incoming orders. Choose the facility you are interested in or receive emails for all incoming orders.

• Unroutable orders: Get notified if an order could not be assigned to a facility.

Quotas may be imposed on this in the future

fulfillmenttools reserves the right to impose a quota per customer to this feature in the future.

Configuration

To set up notifications, you need to put a corresponding configuration in place. The notification configuration has the following attributes:

• channels: A channel defines the source and the target of notifications. We recommend to define different channels for different receiver groups and/or facilities. See below for a detailed description.

• enabled: Defines the state of the channel. Set to true if notifications should be sent and to false if notifications should be paused.

A channel is a JSON Object which contains the following attributes:

• type: The type of the notification you will receive. Currently, only EMAIL is supported.

• events: The events upon which the notification is triggered. Currently we support:

  • PICK_JOB_CREATED: An order was assigned to a facility and is ready to be picked.

  • ROUTING_PLAN_NOT_ROUTABLE: An order could not be assigned to a facility and is in "unroutable" state.

  • ROUTING_PLAN_WAITING: A routing plan is waiting

• receiver: Who will receive the notification. This is an array of objects. The attributes of the objects change based on the TYPE:

  • Type EMAIL:

    • email: The email address of the recipient

    • language: The language of the email. Currently, this is either de_DE or en_US. It is possible to define a different language for each receiver email address.

You can define, whether you want to receive notifications on network level or only for specific facilities.

Configuration on network level

Create a new configuration

Create a configuration on network level if you want to receive notifications globally, i.e. for all events no matter which facility they apply to. To create a new configuration on network level, use the below endpoint to create one or several channel(s). If you want to send the same events to the same user group, it is sufficient to create one channel. Please speficy type, event(s), and receiver(s) as specified above and set enabled to true.

Creates or updates an existing notification center configuration.

put

Body

one ofOptional

or

all ofOptional

Responses

200

Notification center configuration was successfully updated.

application/json

201

Notification center configuration was successfully created.

application/json

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

409

A version conflict occurred.

application/json

put

HTTPcURLJavaScriptPython

PUT /api/configurations/notifications HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 146

{
  "channels": [
    {
      "enabled": true,
      "events": [
        "PICK_JOB_CREATED"
      ],
      "receiver": [
        {
          "email": "[e-mail]",
          "language": "de_DE"
        }
      ],
      "type": "text"
    }
  ],
  "version": 1
}

{
  "channels": [
    {
      "enabled": true,
      "events": [
        "PICK_JOB_CREATED"
      ],
      "id": "text",
      "receiver": [
        {
          "email": "[e-mail]",
          "language": "de_DE"
        }
      ],
      "type": "text"
    }
  ],
  "created": "2025-05-12T08:59:55.102Z",
  "lastModified": "2025-05-12T08:59:55.102Z",
  "version": 1
}

Add a new channel or update an existing channel

Executes an action to manipulate the notification center configuration.

post

Body

one ofOptional

or

Responses

200

Notification center configuration action was successfully executed.

application/json

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

409

A version conflict occurred.

application/json

post

HTTPcURLJavaScriptPython

POST /api/configurations/notifications/actions HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 164

{
  "channel": {
    "enabled": true,
    "events": [
      "PICK_JOB_CREATED"
    ],
    "receiver": [
      {
        "email": "[e-mail]",
        "language": "de_DE"
      }
    ],
    "type": "text"
  },
  "name": "ADD_CHANNEL",
  "version": 1
}

{
  "channels": [
    {
      "enabled": true,
      "events": [
        "PICK_JOB_CREATED"
      ],
      "id": "text",
      "receiver": [
        {
          "email": "[e-mail]",
          "language": "de_DE"
        }
      ],
      "type": "text"
    }
  ],
  "created": "2025-05-12T08:59:55.102Z",
  "lastModified": "2025-05-12T08:59:55.102Z",
  "version": 1
}

Get configuration information

Returns the notification center configuration.

get

Responses

200

The notification center configuration was successfully returned.

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

get

HTTPcURLJavaScriptPython

GET /api/configurations/notifications HTTP/1.1
Host: 
Accept: */*

{
  "channels": [
    {
      "enabled": true,
      "events": [
        "PICK_JOB_CREATED"
      ],
      "id": "text",
      "receiver": [
        {
          "email": "[e-mail]",
          "language": "de_DE"
        }
      ],
      "type": "text"
    }
  ],
  "created": "2025-05-12T08:59:55.102Z",
  "lastModified": "2025-05-12T08:59:55.102Z",
  "version": 1
}

Delete a channel

Deletes a notification center config channel.

delete

Path parameters

channelIdstringRequired

Query parameters

versionnumberRequired

Responses

200

Notification center config channel was successfully deleted.

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

delete

HTTPcURLJavaScriptPython

DELETE /api/configurations/notifications/channels/{channelId}?version=1 HTTP/1.1
Host: 
Accept: */*

No content

Configurations on facility level

Create a new configuration

Create a configuration on facility level if you want to receive notifications only for specific facilities, e.g., only for orders that are routed to a specific facility. To create a new configuration on facility level, use the below endpoint to create one or several channel(s). If you want to send the same events to the same user group in the same facility, it is sufficient to create one channel. Please speficy facilityRef, type, event(s), and receiver(s) as specified above and set enabled to true.

Creates or updates an existing notification center facility configuration.

put

Path parameters

facilityRefstringRequired

Body

one ofOptional

or

all ofOptional

Responses

200

Notification center facility configuration was successfully updated.

application/json

201

Notification center facility configuration was successfully created.

application/json

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

put

HTTPcURLJavaScriptPython

PUT /api/facilities/{facilityRef}/configurations/notifications HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 146

{
  "channels": [
    {
      "enabled": true,
      "events": [
        "PICK_JOB_CREATED"
      ],
      "receiver": [
        {
          "email": "[e-mail]",
          "language": "de_DE"
        }
      ],
      "type": "text"
    }
  ],
  "version": 1
}

{
  "channels": [
    {
      "enabled": true,
      "events": [
        "PICK_JOB_CREATED"
      ],
      "id": "text",
      "receiver": [
        {
          "email": "[e-mail]",
          "language": "de_DE"
        }
      ],
      "type": "text"
    }
  ],
  "created": "2025-05-12T08:59:55.102Z",
  "lastModified": "2025-05-12T08:59:55.102Z",
  "version": 1
}

Add a new channel or update an existing channel

Executes an action to manipulate the notification center facility configuration.

post

Path parameters

facilityRefstringRequired

Body

one ofOptional

or

Responses

200

Notification center facility configuration action was successfully executed.

application/json

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

post

HTTPcURLJavaScriptPython

POST /api/facilities/{facilityRef}/configurations/notifications/actions HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 164

{
  "channel": {
    "enabled": true,
    "events": [
      "PICK_JOB_CREATED"
    ],
    "receiver": [
      {
        "email": "[e-mail]",
        "language": "de_DE"
      }
    ],
    "type": "text"
  },
  "name": "ADD_CHANNEL",
  "version": 1
}

{
  "channels": [
    {
      "enabled": true,
      "events": [
        "PICK_JOB_CREATED"
      ],
      "id": "text",
      "receiver": [
        {
          "email": "[e-mail]",
          "language": "de_DE"
        }
      ],
      "type": "text"
    }
  ],
  "created": "2025-05-12T08:59:55.102Z",
  "lastModified": "2025-05-12T08:59:55.102Z",
  "version": 1
}

Get configuration information

Returns the notification center facility configuration.

get

Path parameters

facilityRefstringRequired

Responses

200

The notification center facility configuration was successfully returned.

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

get

HTTPcURLJavaScriptPython

GET /api/facilities/{facilityRef}/configurations/notifications HTTP/1.1
Host: 
Accept: */*

{
  "channels": [
    {
      "enabled": true,
      "events": [
        "PICK_JOB_CREATED"
      ],
      "id": "text",
      "receiver": [
        {
          "email": "[e-mail]",
          "language": "de_DE"
        }
      ],
      "type": "text"
    }
  ],
  "created": "2025-05-12T08:59:55.102Z",
  "lastModified": "2025-05-12T08:59:55.102Z",
  "version": 1
}

Delete a channel

Deletes a notification center facility config channel.

delete

Path parameters

facilityRefstringRequired

channelIdstringRequired

Query parameters

versionnumberRequired

Responses

200

Notification center facility config channel was successfully deleted.

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

delete

HTTPcURLJavaScriptPython

DELETE /api/facilities/{facilityRef}/configurations/notifications/channels/{channelId}?version=1 HTTP/1.1
Host: 
Accept: */*

No content