Documentation
Feedback
Guides
API Reference

Guides
Logistics
VTEX Shipping Network
Tracking

Access the boilerplate repository for the tracking app to clone it and begin development.

A tracking app published by a carrier will include an endpoint like this one: https://app.io.vtex.com/{app_name}/{app_version}/{account}/{workspace}/tracking

Once every hour, the VTEX tracking hub makes a POST request to this endpoint containing a list of packages’ tracking numbers. The app should respond with the updated tracking information for each package.

Below are some examples, but you can learn more about this request on the tracking API request documentation.

Request body example:


_10
[
_10
{
_10
"trackingNumber": "BR000000000"
_10
}
_10
]

Response body example:


_15
{
_15
<trackingNumber>: {
_15
"deliveredDate": Date,
_15
"events": [
_15
{
_15
"city": string,
_15
"date": Date,
_15
"description": string,
_15
"state": string
_15
}
_15
],
_15
"hasReturnedToSender": bool,
_15
"isDelivered": bool
_15
}
_15
}

Be aware that this call may contain several package's tracking numbers, and the app should respond with tracking information for each of them.

Learn more

See this guide on how to develop carrier apps on VTEX IO. You can also learn more about the integration flow and notification for carrier apps.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page