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"
}
]
}
]
}| Key | Description |
|---|---|
| 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
|
| 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
functionType explanationThe name is what scenario is will be inside the CAS application
| Value | Name |
|---|---|
| 0 | Success |
| 1 | Failure |
| 2 | Info |
