Tracking

Track the delivery of your parcels

Glopal pulls tracking updates from couriers for any processed shipment in real-time and harmonises those events.

Implement our tracking API for automated notifications on all parcel movements.

Get tracking events per parcel or order

post

https://ws.xport.glopalservice.comhttps://ws.stg.xport.glopalservice.com

/shipment/tracking

Header parameters

x-loginstringRequired

Client username (set by Glopal)

Example: usernamePattern: ^[a-z0-9\-]{3,255}$

x-aliasstringOptional

Optional system username to enable separation of authentication credentials by integrated client system. (set by Glopal)

Example: alias-usernamePattern: ^[a-z0-9\-]{3,50}$

x-signaturestringRequired

The authentication signature is created by using the concatenation of the login, the ‘@’ sign and the timestamp, transformed into a HMAC_256 signature using your secret access key.

Example: 40b976b35a08bb951439ea7bbfa0a7bd73dab7c813399a31d9d1a157bc08929bPattern: ^[0-9a-f]{64}$

x-timestampnumber · floatRequired

The authentication timestamp must be a decimal numeric representing the current POSIX time, extended to microsecond accuracy. If the requesting system does not provide high-resolution time, it is advised to use a 6-digit random number. It is important to have the requesting system synchronised with a reliable time source (f.i. a stratum 2 NTP server) to avoid request rejection.

Example: 1680010295.775523Pattern: ^[12]\d{9}\.\d{6}$

x-versionnumber · floatOptionalDefault: 0.68Pattern: (^0\.\d{2}$|^[1-9]\d*\.\d{2}$)

Body

application/jsonapplication/xml

Responses

200

OK

application/jsonapplication/xml

Responseall of

400

Bad Request

application/jsonapplication/xml

401

Unauthorized

application/jsonapplication/xml

403

Forbidden

application/jsonapplication/xml

404

Not found

application/jsonapplication/xml

405

Method not allowed

application/jsonapplication/xml

500

Internal server error

application/jsonapplication/xml

503

Service unavailable

application/jsonapplication/xml

post

/shipment/tracking

JSPy

const timestamp = String(Date.now() / 1000).padEnd(17, '0');
const username = "username";
const signature = CryptoJS.HmacSHA256(
  `${username}@${timestamp}`, "sharedsecret"
  ).toString(CryptoJS.digest)

const response = await fetch('https://ws.xport.glopalservice.com/shipment/tracking', {
  method: 'POST',
  headers: {
    "Content-Type": "application/json",
    "x-login": username,
    "x-timestamp": timestamp,
    "x-signature": signature
  },
  body: JSON.stringify({
    "reference": "test123"
  }),
});
const data = await response.json();

{
  "error": 0,
  "shipment": {
    "fulfillment_id": "FU.123OMS",
    "inboundawb": "AWB1234567890_23",
    "outboundawb": "AWB1234567890_23",
    "outbound_carrier": "DHL",
    "outbound_tracking_url": "https://test.xport.glopalservice.com/test",
    "outbound_carrier_tracking_url": "https://test.xport.glopalservice.com/test",
    "shipin_id": 123456,
    "wms_id": "WMS12345"
  },
  "event": [
    {
      "timestamp": 1680010295,
      "status": "OK",
      "description": "Processing in hub",
      "location": "Los Angeles",
      "source": "CBTS"
    }
  ]
}