DOCS

Update tracking

Update tracking

Learn how the endpoint to update tracking works.

The setShipmentTracking endpoint is used to update an order in the Zonos system with tracking numbers.

Endpoint 

HTTPS request

POST | https://api.iglobalstores.com/v2/setShipmentTracking

Fieldnotes
HTTP methodPOST
Endpoint URLhttps://api.iglobalstores.com/v2/setShipmentTracking
ProtocolHTTPS
Message FormatJSON
Accept HTTP headerAccept: application/json
Content-Type HTTP headerContent-Type: application/json

JSON key/value pairs in the request body

Message format: JSON

Example

1
2
3
4
5
6
7
8
9
10
{
  "store": "999",
  "secret": "f5bde245-f55e-414d-b722-80b25161c12c",
  "orderId": "999-99999",
  "trackingList": [
    {
      "number": "1Z204E380338943508"
    }
  ]
}
Fieldnotes
orderId REQUIREDThe Zonos order ID can be passed with or without your store ID and hyphen (Example: 123-45678 or 45678).After order completion and payment, the customer will be redirected to an order completion / thank you page hosted on your domain. The URL will contain a querystring parameter orderId that will contain this value.integer / string
secret REQUIREDAPI secret GUID provided by Zonos.string
store REQUIREDStore ID provided by Zonos.integer
trackingList REQUIREDThis is a list of objects. Each object should have a key/value pair with at least one key named “number” and the value of that key is one of the tracking numbers. You must have a separate object with the key/value pair for each tracking number.

HTTPS response

Message format: JSON

Example success response

1
2
3
{
  "success": "Updated Order: 99999 with new tracking info."
}

Example error response

1
2
3
{
  "error": "A specific message describing the error."
}

Was this page helpful?