Tracking | Glopal

Merchants Help Sign in

Get tracking events per parcel or order

post

/shipment/tracking

Header parameters

x-loginstringrequired

Client username (set by Glopal)

Example: username

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

x-aliasstring

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

Example: alias-username

Pattern: ^[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: 40b976b35a08bb951439ea7bbfa0a7bd73dab7c813399a31d9d1a157bc08929b

Pattern: ^[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.775523

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

x-versionnumber · float · default: 0.68

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

Body

all of

Responses

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();

200

400

401

403

404

405

500

503

application/json

application/xml

Success

Error

{
  "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"
    }
  ]
}

Get tracking events per parcel or order

Show child attributes