Update order tracking status

Sends a tracking event to an order that already has a tracking number registered to its invoice.

This endpoint is not meant to send tracking number and URL to the invoice. If you wish to send tracking number and URL to an order, use the Update order's partial invoice API request.

The Notify invoice resource is needed to use this API request. This is included in OMS - Full access and IntegrationProfile - Fulfillment Oms, among other default roles available in the Admin. Learn more about the License manager roles and resources.

❗️

Do not use this request with orders that do not have a tracking number already added to their invoice. If you wish to send tracking number and URL to an order, use the Update order's partial invoice API request

Learn more about Transaction Details in VTEX Help

Important: the package is generated when an invoice is added to the order.
The last tracking's date is not the same as the delivery date.

Request object has the following properties:

AttributeTypeDescription
orderIdstringOrder Id
invoiceNumberstringOrder Invoice ID
isDeliveredbooleanIf the order package is delivered
deliveredDatestringthe date when the package was delivered. It is not the same as the tracking date parameter.
eventsobjectEvents Details Object
citystringEvent Tracking City
statestringEvent Tracking State
descriptionEvent Tracking Description
datestringEvent Tracking Date in international format yyyy-mm-dd

If isDelivered is true, the field finished changes to true. The courierStatus field of status remains as unknown. This field can be found in the Order details of the.

Response object has the following properties:

AttributeTypeDescription
datestringTracking Update Date
orderIdstringOrder ID Update
receiptstringTracking Update Receipt

Request body example

curl --location --request PUT 'https://lojadosuporte.vtexcommercestable.com.br/api/oms/pvt/orders/v501245lspt-01/invoice/0102030405/tracking' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-VTEX-API-AppToken: {{X-VTEX-API-AppToken}}' \
--header 'X-VTEX-API-AppKey: {{X-VTEX-API-AppKey}}' \
--data-raw '{
  "isDelivered": true,
  "events": [
    {
      "city": "Rio de Janeiro",
      "state": "RJ",
      "description": "Coletado pela transportadora",
      "date": "2015-06-23"
    },
    {
      "city": "Sao Paulo",
      "state": "SP",
      "description": "A caminho de Curitiba",
      "date": "2015-06-24"
    }
  ]
}'

Response body example

{
  "date": "2017-03-29T18:04:31.0521233+00:00",
  "orderId": "v501245lspt-01",
  "receipt": "f67d33a8029c42ce9a8f07fc17f54449"
}
Language
Authentication
URL
Click Try It! to start a request and see the response here!