Container return result

This webhook is activated when an order include a CAS (Container Accounting System) update and the CAS API is activated.

When the driver either picked up or delivered an order with a return container update, the payload of the actual return container details, is send.

The request from the webhook will look like this:

{
  "webhookId": "692f438b5f1be0191d333510",
  "name": "casReturns",
  "sent": "2025-12-01T19:52:43.686Z",
  "created": "2025-12-01T19:52:43.696Z",
  "data": [
    {
      "orderId": "692e5a47c0a3f50031b1d9ba",
      "orderNumber": "DROP-123-45678901",
      "orderType": "pick_up",
      "historyId": "692f438b46dca403f11651bc",
      "containerId": "579169e3-07e0-4135-8a63-edaf98e79c9e",
      "containerName": "Pallet",
      "containerSubTypeId": "6a6068ae-3a7d-4f6a-ba06-845b32885cf5",
      "containerSubTypeName": "Euro",
      "returnCodes": [
        {
          "id": "b9e83f73-2612-4042-b886-23cfd2e7ba81",
          "code": "100",
          "quantity": 1,
          "functionType": "0",
          "description": "Exchange"
        },
        {
          "id": "d936763f-0331-41a3-878b-718436f06475",
          "code": "101",
          "quantity": 2,
          "functionType": "0",
          "description": "Missing"
        }
      ]
    },
    {
      "orderId": "692e5a47c0a3f50031b1d9ba",
      "orderNumber": "DROP-123-45678901",
      "orderType": "deliver",
      "historyId": "692f438b46dca403f11651bc",
      "containerId": "579169e3-07e0-4135-8a63-edaf98e79c9e",
      "containerName": "Pallet",
      "containerSubTypeId": "f3056f2a-44f3-47aa-b72e-fdc140dff7cf",
      "containerSubTypeName": "1/2 Euro",
      "returnCodes": [
        {
          "id": "b9e83f73-2612-4042-b886-23cfd2e7ba81",
          "code": "100",
          "quantity": 1,
          "functionType": "0",
          "description": "Exchange"
        },
        {
          "id": "d936763f-0331-41a3-878b-718436f06475",
          "code": "101",
          "quantity": 2,
          "functionType": "0",
          "description": "Missing"
        }
      ]
    }
  ]
}
KeyDescription
orderId

The id of the order

The unique order ID related to the transaction

orderNumber

The order number of the order

The order number related to the transaction.

orderType

Type type of the order

Can be either pick_up or delivery

historyId

The id of the history

The unique history ID for the transaction saved on the order in Dropboy.

containerId

The id of the container

The unique ID for the containerType, the subscriber created in the CAS settings.

containerName

The name of the container

The name of the containerType, the subscriber created in the CAS settings.

Examples
  • Pallet
  • Box
  • Cage
containerSubTypeId

The id of the sub container

The unique ID of the containerSubType, the subscriber created in the CAS settings.

containerSubTypeName

The name of the sub container

The name of the containerSubType, the subscriber created in the CAS settings.

returnCodes.id

The id of the return code

The ID of the returnCode, the subscriber created in the CAS settings.

returnCodes.code

The code of the return code

The name of the returnCode, the subscriber created in the CAS settings.

returnCodes.quantity

The amount of exchanges items

The specific returnCode is set by the subscriber in the CAS settings

returnCodes.functionType

The function type of a return code

Look at the table below for possible value and their meaning

returnCodes.description

The description of the return code

The description name that the subscriber created in the CAS settings.


functionType explanation

The name is what scenario is will be inside the CAS application

ValueName
0Success
1Failure
2Info