Atualizar rastreio (bulk)

Atualizar rastreio em massa (bulk)

Processa até 100 pedidos por requisição. Cada item pode usar UUID ou external_id.

Contrato

Item	Valor
Método	`POST`
Path	`/integrations/v1/stores/:storeId/orders/tracking/bulk`
Autenticação	`Authorization: Bearer cvx_live_...`
Escopo	`orders:write`

Body (JSON)

{
  "items": [
    {
      "orderId": "PED-1001",
      "trackingCode": "AB111111111BR",
      "trackingStatus": "posted",
      "trackingCarrier": "Correios"
    },
    {
      "orderId": "11111111-1111-4111-8111-111111111111",
      "trackingCode": "AB222222222BR",
      "trackingUrl": "https://tracking.example.com/AB222222222BR"
    }
  ]
}

Campo (item)	Tipo	Obrigatório	Descrição
`orderId`	string (1–80)	Sim	UUID ou `external_id`
`trackingCode`	string (1–120)	Sim	Código de rastreio
`trackingUrl`	string (URL)	Não	URL de rastreamento
`trackingStatus`	enum	Não	Mesmos valores do PATCH individual
`trackingCarrier`	string (max 120)	Não	Transportadora

Resposta 200 — sucesso

{
  "success": true,
  "message": "2 rastreio(s) atualizado(s)",
  "data": {
    "total": 2,
    "updated": 2,
    "skipped": 0,
    "failed": 0,
    "results": [
      {
        "index": 0,
        "orderId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
        "orderReference": "PED-1001",
        "status": "updated",
        "trackingStatus": "posted"
      }
    ]
  }
}

Documentação completa: Integração de rastreio

{ "success": true, "message": "2 rastreio(s) atualizado(s)", "data": { "total": 2, "updated": 2, "skipped": 0, "failed": 0, "results": [ { "index": 0, "orderId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa", "orderReference": "PED-1001", "status": "updated", "trackingStatus": "posted" } ] } }