๐Ÿ”‘ TNT International Track & Trace

The action is used to get the tracking information from TNT International.

๐Ÿ“˜

Credentials

The credentials are optained from your TNT contact person.

Inputs

Name

Type

Description

Username

String

TNT iternational username

Password

String

TNT iternational password

Tracking Number

String

TNT international tracking number

Outputs

Name

Type

Description

Tracking Found?

Boolean

Whether the tracking information was found

Status

String

Tracking status:
Delivered,
In Transit,
Problem with Delivery

Status Description

String

Longer description of the tracking status

Shipped Date

String

The date of the first tracking event.
Format:
YYYY-MM-DDThh:mm:ss

Last Event Date

String

The date of the last tracking event.
Format:
YYYY-MM-DDThh:mm:ss

Delivery Date

String

The date when the parcel was delivered.
Format:
YYYY-MM-DDThh:mm:ss

Tracking Events

List

List of all the tracking events

Tracking Events

Object

All the tracking information returned from TNT.
See example below

Sample Response
Tracking Events

{
    "ConsignmentNumber": 620290246,
    "OriginDepot": "LIL",
    "OriginDepotName": "Lille",
    "CustomerReference": "8010715584",
    "CollectionDate": 20210428,
    "DeliveryTown": "DUBLIN",
    "DeliveryDate": 20210429,
    "DeliveryTime": 1159,
    "Signatory": "",
    "SummaryCode": "DEL",
    "DestinationCountry": {
        "CountryCode": "IE",
        "CountryName": "Ireland"
    },
    "OriginCountry": {
        "CountryCode": "FR",
        "CountryName": "France"
    },
    "TermsOfPaymentAccount": {
        "Number": "",
        "CountryCode": "FR"
    },
    "SenderAccount": {
        "Number": "",
        "CountryCode": "FR"
    },
    "PieceQuantity": 1,
    "StatusData": [
        {
            "StatusCode": "RES",
            "StatusDescription": "Consignment Delivered To Residential",
            "LocalEventDate": 20210429,
            "LocalEventTime": 1159,
            "Depot": "DUB",
            "DepotName": "Dublin"
        },
        {
            "StatusCode": "OD",
            "StatusDescription": "Out For Delivery.",
            "LocalEventDate": 20210429,
            "LocalEventTime": 846,
            "Depot": "DUB",
            "DepotName": "Dublin"
        },
        {
            "StatusCode": "IR",
            "StatusDescription": "Shipment Received At Tnt Location",
            "LocalEventDate": 20210429,
            "LocalEventTime": 754,
            "Depot": "DUB",
            "DepotName": "Dublin"
        },
        {
            "StatusCode": "TR",
            "StatusDescription": "Shipment In Transit.",
            "LocalEventDate": 20210429,
            "LocalEventTime": 344,
            "Depot": "LGG",
            "DepotName": "Liege Euro Hub"
        },
        {
            "StatusCode": "TR",
            "StatusDescription": "Shipment In Transit.",
            "LocalEventDate": 20210429,
            "LocalEventTime": 17,
            "Depot": "LGG",
            "DepotName": "Liege Euro Hub"
        },
        {
            "StatusCode": "AS",
            "StatusDescription": "Shipment Received At Transit Point.",
            "LocalEventDate": 20210428,
            "LocalEventTime": 2242,
            "Depot": "LGG",
            "DepotName": "Liege Euro Hub"
        },
        {
            "StatusCode": "CI",
            "StatusDescription": "Shipment Received At Origin Depot.",
            "LocalEventDate": 20210428,
            "LocalEventTime": 2242,
            "Depot": "LGG",
            "DepotName": "Liege Euro Hub"
        },
        {
            "StatusCode": "OS",
            "StatusDescription": "Shipment In Transit.",
            "LocalEventDate": 20210428,
            "LocalEventTime": 2041,
            "Depot": "LIL",
            "DepotName": "Lille"
        },
        {
            "StatusCode": "TR",
            "StatusDescription": "Shipment In Transit.",
            "LocalEventDate": 20210428,
            "LocalEventTime": 1922,
            "Depot": "LIL",
            "DepotName": "Lille"
        },
        {
            "StatusCode": "CI",
            "StatusDescription": "Shipment Received At Origin Depot.",
            "LocalEventDate": 20210428,
            "LocalEventTime": 1808,
            "Depot": "LIL",
            "DepotName": "Lille"
        }
    ],
    "PackageSummary": {
        "NumberOfPieces": 1,
        "Weight": 0.25,
        "PackageDescription": "CARTON",
        "GoodsDescription": ""
    },
    "ShipmentSummary": {
        "TermsOfPayment": "Sender",
        "DueDate": 20210429,
        "Service": "Express"
    },
    "Addresses": {
        "Address": [
            {
                "Name": "Name",
                "AddressLine": [
                    "Address",
                    ""
                ],
                "City": "",
                "Province": "",
                "Postcode": "",
                "Country": {
                    "CountryCode": "",
                    "CountryName": ""
                },
                "PhoneNumber": "",
                "ContactName": "",
                "ContactPhoneNumber": ""
            },
            {
                "Name": "",
                "AddressLine": [
                    "",
                    ""
                ],
                "City": "",
                "Postcode": "",
                "Country": {
                    "CountryCode": "",
                    "CountryName": ""
                },
                "PhoneNumber": "",
                "ContactName": "",
                "ContactPhoneNumber": "",
                "AccountNumber": "",
                "VATNumber": ""
            },
            {
                "Name": "",
                "AddressLine": "",
                "City": "",
                "Postcode": "",
                "Country": {
                    "CountryCode": "",
                    "CountryName": ""
                },
                "ContactName": ""
            }
        ]
    },
    "POD": ""
}
๐Ÿ“˜

Tracking Status

TNT returns a status code for each tracking event. DG maps this status code to one of the predefined statuses. E.g. INT - In Transit.

Statuses mapping

DEL - Delivered
INT - In Transit
EXC - Problem with Delivery
CNF - null