Vendas

Rastreio

Devolver o código do envio — e o que a zankh faz com ele assim que chega.

Todas as páginas▾

Comece aqui

Catálogo

Vendas

Inteligência artificial

Servidor MCP

Parceiros

Referência

GET/v1/orders/{id}/trackingTodos os rastreios do pedido — os seus e os das etiquetas compradas pela plataforma.
PUT/v1/orders/{id}/trackingCria ou corrige o SEU rastreio. Repetir corrige no lugar.

curl -X PUT https://api.zankhapi.com.br/v1/orders/PEDIDO_ID/tracking \
  -H "Authorization: Bearer zk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "trackingCode": "BR123456789BR",
    "carrier": "Correios",
    "trackingUrl": "https://rastreamento.correios.com.br/...",
    "status": "in_transit"
  }'

Por que isto importa mais do que parece

O código de rastreio é o que a zankh mostra no painel do comprador, na página do pedido dele e no e-mail “seu pedido foi enviado”. Sem ele, essas três telas ficam vazias e o comprador vai pedir o código pelo WhatsApp. Mande assim que a etiqueta existir.

Status aceitos

Valor	Quando usar
`dispatched`	Padrão. Despachado, ainda sem movimento na transportadora.
`in_transit`	Em trânsito.
`delivered`	Entregue.

Os estados anteriores ao envio e os de falha são geridos pela plataforma e não podem ser afirmados pela API — eles vêm da cotação, da compra da etiqueta e do retorno da transportadora.