πŸ”‘ GLS Track & Trace

The action is used to get the tracking information from GLS.

Inputs

NameTypeDescription
Tracking NumberStringGLS tracking number
UsernameStringGLS username
PasswordStringGLS password

Outputs

NameTypeDescription
Found Tracking?BooleanWhether the tracking information was found
True / False
StatusStringTracking status:
Ready for Shipment,
Delivered,
In Transit,
Problem with Delivery,
Returning to Sender,
Ready for Pickup
Status DescriptionStringDetailed description of the tracking status
Shipped DateStringThe date of the shipment.
Format:
YYYY-MM-DDThh:mm:ss
Last Event DateStringThe date of the last tracking event.
Format:
YYYY-MM-DDThh:mm:ss
Tracking DataObjectTracking Data
Tracking URLStringCanada Post tracking URL
Activity HistoryListList of all the tracking events.
See the example below

Sample Response
Activity History

{
    "parcels": [
        {
            "timestamp": "2021-08-27T12:04:00",
            "status": "",
            "trackid": "20287788695",
            "references": [
                {
                    "type": "UNITNO",
                    "name": "Parcel number:",
                    "value": ""
                },
                {
                    "type": "UNIQUENO",
                    "name": "Track ID",
                    "value": ""
                },
                {
                    "type": "GLSREF",
                    "name": "Parcel Force parcel number",
                    "value": ""
                },
                {
                    "type": "GLSREF",
                    "name": "Origin National Reference in Unicode",
                    "value": ""
                },
                {
                    "type": "CUSTREF",
                    "name": "Customer's own reference number",
                    "value": ""
                },
                {
                    "type": "CUSTREF",
                    "name": "Customer's own reference number",
                    "value": ""
                },
                {
                    "type": "CUSTREF",
                    "name": "Customers own reference number - per TU",
                    "value": ""
                }
            ],
            "events": [
                {
                    "timestamp": "2021-08-27T12:04:00",
                    "description": "The parcel has been delivered.",
                    "location": "",
                    "country": "GB",
                    "code": "3.0"
                },
                {
                    "timestamp": "2021-08-27T08:25:00",
                    "description": "The parcel is expected to be delivered during the day.",
                    "location": "",
                    "country": "GB",
                    "code": "11.0"
                },
                {
                    "timestamp": "2021-08-27T00:52:32",
                    "description": "The parcel has reached the parcel center.",
                    "location": "",
                    "country": "GB",
                    "code": "2.0"
                },
                {
                    "timestamp": "2021-08-26T09:07:00",
                    "description": "The parcel has reached the parcel center.",
                    "location": "",
                    "country": "GB",
                    "code": "2.0"
                },
                {
                    "timestamp": "2021-08-26T08:58:39",
                    "description": "The parcel was released by customs.",
                    "location": "",
                    "country": "GB",
                    "code": "15.0"
                },
                {
                    "timestamp": "2021-08-25T00:31:50",
                    "description": "The parcel has left the parcel center.",
                    "location": "Neuenstein",
                    "country": "DE",
                    "code": "1.0"
                },
                {
                    "timestamp": "2021-08-25T00:27:39",
                    "description": "The parcel has reached the parcel center.",
                    "location": "Neuenstein",
                    "country": "DE",
                    "code": "2.0"
                },
                {
                    "timestamp": "2021-08-24T18:47:51",
                    "description": "The parcel was handed over to GLS.",
                    "location": "Hamburg",
                    "country": "DE",
                    "code": "0.0"
                },
                {
                    "timestamp": "2021-08-23T21:38:26",
                    "description": "The parcel data was entered into the GLS IT system; the parcel was not yet handed over to GLS.",
                    "location": "Hamburg",
                    "country": "DE",
                    "code": "0.100"
                }
            ]
        }
    ]
}

πŸ“˜

Tracking Status

GLS API returns a status code for each tracking event. DG maps this status code to one of the predefined statuses. E.g. 0 - Ready for Shipment.

DG scans all the tracking events to identify whether there is an event with status code that shows the parcel is returning back to the sender.

Statuses mapping

'Ready for Shipment': ['0', '81'],
  'Returning to Sender': ['5'],
  'In Transit': ['1', '2', '6', '8', '11', '15', '27', '941', '951'],
  'Ready for Pickup': ['16'],
  'Problem with Delivery': ['4','7','12','13','14','18','19','20','30','31','35','82','83','90','824','829','895','897','949','950' ],
  'Delivered': ['3', '17'],