Revision history

Date	Version	Description
2025-02-21	1.0	Initial version.
2025-08-25	1.1	Added business rules based on conversation with Delaware + example handling unit level
2025-11-11	1.2	Removed SAP code as this is not used by SAP anymore they only map POD events. Removed square brackets from payload as this is causing issues in SAP.

Purpose

Provide unified tracking information of all carriers into SAP.

State

Webhook is part of the project scope.

Envisioned process

Tracking push full

SAP will get all tracking details from Viya in a push message.

Request

Method: POST
Endpoint: to be provided by SAP
Payload: As per below examples, always 1 event per message

Business rules

The carrier can provide tracking information on handlingUnit or Shipment level: Viya will always include the shipment reference + optionally the applicable handlingUnit reference.
Viya will translate the standardized event codes to the Aalberts HFC specific event codes in property translatedCode. (Pending Delaware providing Aalberts HFC specific codes) This is not valid anymore as agreed with Delaware at 2025-11-11 during QAT.

Examples

a. Tracking received on shipment level

{
    "eventDateTime": "2025-02-24T14:15:22Z",
    "references": {
        "shipment": {
            "reference": "08123150",
            "trackingReference": "11549840405605"
        }
    },
    "eventType": {
        "code": "PK",
        "description": "Pick up from shipper"
    },
    "reason": {
        "code": "0",
        "description": "Complete"
    },
    "standardizedCode": "PickupCompleted",
    "scanLocation": {
        "companyName": "ShipitSmarter HQ",
        "addressLine1": "Arendstraat",
        "streetNumber": "21",
        "city": "Hilversum",
        "postCode": "1223RE",
        "countryCode": "NL"
    }
}

b. Tracking received on handling unit level

Note that the shipment property is there to indicate in which shipment the handlingUnit is included, but the handlingUnit node to specifically indicate the affected handling unit for the given event.

{
    "eventDateTime": "2025-02-24T14:15:22Z",
    "references": {
        "shipment": {
            "reference": "08123150"
        },
        "handlingUnit": {
            "reference": "0012345678913151719",
            "trackingReference": "11549840405605"
        }
    },
    "eventType": {
        "code": "PK",
        "description": "Pick up from shipper"
    },
    "reason": {
        "code": "0",
        "description": "Complete"
    },
    "standardizedCode": "PickupCompleted",
    "scanLocation": {
        "companyName": "ShipitSmarter HQ",
        "addressLine1": "Arendstraat",
        "streetNumber": "21",
        "city": "Hilversum",
        "postCode": "1223RE",
        "countryCode": "NL"
    }
}