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?