Webhook Integration Documentation

version: 1.2.0

Last updated: 2026-04-22

DeltaX supports client integration via webhooks. The general integration procedure follows these steps:

DeltaX sets up a new client in the platform and shares the credentials to the client.

The client implements a reception callback service according to the specification.

The client registers the webhook using the API.

Once registered, DeltaX automatically sends data updates to the callback service

Trip data from all supported countries is sent to the same callback service, using the same credentials.

1. Authentication

Once DeltaX has setup the client in the platform, the credentials sent to the client are:

Client Code: Short code uniquely identifying the client within the platform.

Authentication Token(s): Tokens used as authentication on API requests.

1.1 Usage

To use an authentication token on HTTP requests to the DeltaX API, the token has to be provided as a Bearer Token in the Authorization header.

2. Callback Registration

Method: GET
Path: /registerCallback
Query string parameters:

webhook (mandatory) - Code of webhook being registered (supported values: trips).

name (optional) - Describing name for the callback.

url (mandatory) - URL of the callback service.

callbackToken (optional) - Token that should be used by DeltaX in the update requests, not to be confused with the client authentication token. If provided, the update requests will include this token in the Authorization header. If not provided, the requests will be made without authentication.

distanceBetweenCallbacksMins (optional, default: 5) Time between update requests in minutes. For example, if the value is 5, one update request will be made to the callback service every 5 minutes. The minimum possible value is established per client.

maxDocumentsPerCallback (optional, default: 100) Maximum number of documents included in a single update request to the callback service. For example, if the value is 100, each update request will include at most 100 documents. If there are more documents needed to be updated, these will be included in further update requests. The maximum possible value is established per client.

3. Callback Service Specification

The callback service implemented by the client must be capable of receiving update requests from DeltaX. Each update request may include several documents.

Availability

The callback service must be publicly accessible via HTTPS. The IP used by DeltaX to make the update requests is not a dedicated, fixed IP and may change over time.

Authentication

The update requests made by DeltaX to the callback service are unauthenticated by default. However, if the callbackToken is set for the callback registration, the specified token is used as a bearer token in the Authorization header of the requests.

Request Format

The requests made by DeltaX to the callback service will have the following format:

Method: POST
URL: The url provided at registration.
Body: JSON with the following fields:

dateTime - Time of the request as marked by DeltaX.

webhook - Code of the webhook.

clientCode - Code of the client.

registrationCode - Code of the callback registration.

numDocuments - Number of documents being included in the request.

sizeBytes - Size of the documents (as JSON plain text) in bytes.

data - Array of documents. The format of each document depends on the webhook used.

Example:

Response

If the request is handled successfully then a 200 response status code is expected.
Any other response code (or lack thereof) is interpreted as a reception error and the service will attempt to send the documents on the next scheduled callback requests.

4. Document Format

4.1 Trips

Trip Fields:

TKNUM (String) - SAP Transport Number

F_ELIM (String) - Fields for Octopus traceability

ERDAT (String) - SAP Creation date (Format: YYYY-MM-DD, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

ERZET (String) - SAP Creation time (Format: HH:MM:SS, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

SIGNI (String) - SAP Round-trip or triangulation trip number

SHTYP (String) - SAP Transport Class ID

AEDAT (String) - SAP Last modified date (Format: YYYY-MM-DD, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

AEZET (String) - SAP Last modified time (Format: HH:MM:SS, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

ROUTE (String) - SAP Route ID

BEZEI_R (String) - SAP Route Description

KNOTA (String) - I2 Origin Location ID

KNOTZ (String) - I2 Destination Location ID

WERKS_O (String) - SAP Origin Plant ID

WERKS_D (String) - SAP Destination Plant ID

VSART (String) - SAP Shipping Class ID

BEZEI_V (String) - SAP Shipping Class Description

TDLNR (String) - SAP Carrier ID

NAME_TRANS (String) - SAP Carrier Description

ADD01 (String) - Supplement 1 ID Folio Type. Outbound = Null, Return = ZE00, Cancellation = ZC00

BEZEI_S1 (String) - SAP Supplement 1 Description Folio Type

ADD03 (String) - Supplement 3 ID Operation Type: Beer = TP04, Glass = TP09, Export = TP11, Self-service = TP01

BEZEI_S3 (String) - SAP Supplement Description 3 (OperationType)

DPREG (String) - SAP Load Appointment Date (Format: YYYY-MM-DD, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

UPREG (String) - SAP Load Appointment Time (Format: HH:MM:SS, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

DPTEN (String) - SAP Unload Appointment Date (Format: YYYY-MM-DD, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

UPTEN (String) - SAP Unload Appointment Time (Format: HH:MM:SS, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

TEXT1 (String) - Text 1

TEXT2 (String) - Text 2

TEXT3 (String) - Text 3

TEXT4 (String) - Text 4

ADD02 (String) - Supplement ID 2

ADD04 (String) - Supplement ID 4. Only for PE and CO: If specified indicates transport company SAP code. If not specified, TDLNR is used.

SDABW (String) - Special Management Indicator ID

TPLST (String) - Transport Planning Position ID

VSBED (String) - Shipping Condition ID

EXTI1 (String) - Ext ID 1

TNDR_TRKID (String) - Tracking ID

LFIMG_P (Int32) - Planned Pallets

WBSTK_S (String) - Goods Outbound Movement (VL02N)

WBSTK_E (String) - Goods Inbound Movement (VL06I)

SGE_S (String) - Global Delivery Status (Outbound)

SGE_E (String) - Global Delivery Status (Inbound)

STTRG (String) - Global Transportation Status

DDTEXT (String) - Global Transportation Status Description

DTDIS (String) - Needed Planning Date (Execution) (Format: YYYY-MM-DD, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

UZDIS (String) - Needed Planning Time (Execution) (Format: HH:MM:SS, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

DAREG (String) - Recording Date (Execution) (Format: YYYY-MM-DD, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

UAREG (String) - Recording Time (Execution) (Format: HH:MM:SS, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

DALBG (String) - Loading Start Date (Execution) (Format: YYYY-MM-DD, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

UALBG (String) - Loading Start Time (Execution) (Format: HH:MM:SS, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

DALEN (String) - Loading End Date (Execution) (Format: YYYY-MM-DD, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

UALEN (String) - Loading End Time (Execution) (Format: HH:MM:SS, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

DTABF (String) - Export Dispatch Date (Execution) (Format: YYYY-MM-DD, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

UZABF (String) - Export Dispatch Time (Execution) (Format: HH:MM:SS, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

DATBG (String) - Transportation Start Date (Execution) (Format: YYYY-MM-DD, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

UATBG (String) - Transportation Start Time (Execution) (Format: HH:MM:SS, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

DATEN (String) - Transportation End Date (Execution) (Format: YYYY-MM-DD, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

UATEN (String) - Transportation End Time (Execution) (Format: HH:MM:SS, Timezone: UTC-6 for MX, UTC-5 for PE,CO,EC)

Entregas (Array) - Array of delivery wares

plannedPlate (String) - TMS Planned Plate

planDate (String) - TMS Plan Date

priority (String) - TMS Priority

additional (String) - TMS Additional

transportCompanyName (String) - DeltaX Transport Company

truckPlate (String) - Plate of truck

truckEconomicNumber (String) - Economic number of truck

trailerPlate (String) - Plate of first trailer

trailerEconomicNumber (String) - Economic number of first trailer

secondTrailerPlate (String) - Plate of second trailer

secondTrailerEconomicNumber (String) - Economic number of second trailer

truckerName (String) - Name of trucker

truckerLicenseNumber (String) License number of trucker

assignmentDate - (String, Date in ISO 8601 format, UTC-0) Date of loading order assignment to transport company

originEtaDate - (String, Date in ISO 8601 format, UTC-0) Origin ETA Date

originEtaStatus - (String) Origin ETA Status: advanced = Arrived before ETA, onSchedule = Arrived at ETA, delayed = Arrived - after ETA, completed = ETA Completed

originAtaDate - (String, Date in ISO 8601 format, UTC-0) Origin ATA Date

originAtaStatus - (String) Origin ATA Status: advanced = Arrived before ETA, onSchedule = Arrived at ETA, delayed = Arrived - after ETA, completed = ETA Completed

originExternalEntryDate - (String, Date in ISO 8601 format, UTC-0) Date of origin external geofence entry

originInternalEntryDate - (String, Date in ISO 8601 format, UTC-0) Date origin internal geofence entry

originInternalLeftDate - (String, Date in ISO 8601 format, UTC-0) Date origin internal geofence departure

originExternalLeftDate - (String, Date in ISO 8601 format, UTC-0) Date origin external geofence departure

destinationEtaDate - (String, Date in ISO 8601 format, UTC-0) Destination ETA Date

destinationEtaStatus - (String) Destination ETA Status: advanced = Arrived before ETA, onSchedule = Arrived at ETA, delayed = Arrived - after ETA, completed = ETA Completed

destinationAtaDate - (String, Date in ISO 8601 format, UTC-0) Destination ATA Date

destinationAtaStatus - (String) Destination ATA Status: advanced = Arrived before ETA, onSchedule = Arrived at ETA, delayed - = Arrived after ETA, completed = ETA Completed

destinationExternalEntryDate - (String, Date in ISO 8601 format, UTC-0) Date of destination external geofence entry

destinationInternalEntryDate - (String, Date in ISO 8601 format, UTC-0) Date of destination internal geofence entry

destinationInternalLeftDate - (String, Date in ISO 8601 format, UTC-0) Date of destination internal geofence departure

destinationExternalLeftDate - (String, Date in ISO 8601 format, UTC-0) Date of destination external geofence departure

tripStatus - (String) Status of trip: scheduled = Scheduled, confirmed = Confirmed, adjustment = Adjustment, rejected = Rejected, assigned = Assigned, originOnRoute = On route to origin, - originExternalEntry = Arrival at origin, originInternalEntry = Entered origin, originInternalLeft = Left origin, - destinationOnRoute = On route to destination, destinationExternalEntry = Arrival at destination, destinationInternalEntry = - Entered destination, completed = Completed, completedHibrid = Hybrid completed, completedImport = Manually completed, - finished = Finished, cancelled = Cancelled

operationStatus - (String) Status of operation: pending = Pending, postponed = Postponed, loading = Loading, expired = Expired, atRisk = At Risk, underway = Underway, unloadPending = Unload Pending, unloading = Unloading, accountingPending = Account Pending, returning = Returning, delivered = Delivered, cancelled = Cancelled

url - (String) URL to the detail page of the trip.

incidences (Array) - Array of incidences

country - (STRING, options: 'MX', 'PE', 'CO', 'EC') Country of the operation.

MX - México (company GMODELO)

PE - Perú (company BACKUS)

CO - Colombia (company BAVARIA)

EC - Ecuador (company CERVECERÍA NACIONAL)

Delivery Ware Fields:

TKNUM_V (String) - Request Number

VBELN (String) - Delivery Number

POSNR (String) - Delivery Item

MATNR (String) - SKU (Material)

ARKTX (String) - Material Description

WERKS (String) - SAP Plant ID Delivery Destination

LGORT (String) - Warehouse ID Delivery Destination

LFIMG (Int32) - Quantity

MEINS (String) - Unit of Measure Quantity

VGBEL (String) - Order

BRGEW (Decimal) - Gross Weight

GEWEI (String) - Unit of Measure Gross Weight

NTGEW (Decimal) - Net Weight

GEWEI_NET (String) - Unit of Measure Net Weight

VOLUM (Decimal) - Volume

VOLEH (String) - Unit of Measure Volume

ANZPK (String) - Total Pallets Quantified

WADAT_IST (String) - Output Date

LFART_ES (String) - Output/Input Posting Indicator

FCONT_SAL (String) - Inventory Output Posting Date and Time

FCONT_ENT (String) - Inventory Input Posting Date and Time

Incidence fields:

stage (String) - Stage at which the incidence occurred.

incident (String) - Code of the incidence

offender (String) - Offender of the incidence

observation (String) - Code of the observation

comment (String) - Comment for the incidence

Example:

Webhook Integration Documentation

version: 1.2.0#

Last updated: 2026-04-22#

1. Authentication#

1.1 Usage#

2. Callback Registration#

3. Callback Service Specification#

Availability#

Authentication#

Request Format#

Response#

4. Document Format#

4.1 Trips#