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

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)

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",
        "translatedCode": "SAP TM code for PickupCompleted for AalbertsHFC here",
        "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",
        "translatedCode": "SAP TM code for PickupCompleted for AalbertsHFC here",
        "scanLocation": {
            "companyName": "ShipitSmarter HQ",
            "addressLine1": "Arendstraat",
            "streetNumber": "21",
            "city": "Hilversum",
            "postCode": "1223RE",
            "countryCode": "NL"
        }
    }
]