Consultar Logística Reversa

GET por ID interno ou pelo número de pedido dos Correios. Devolve o registro completo com histórico e remetente.

Endpoint

GET/api/public/logistica-reversa/{idOuNumeroPedido}

Auth10/min por IP

Parâmetros de path

Campo	Tipo	Obrig.	Descrição
`idOuNumeroPedido`	string	sim	Aceita o `id` interno (UUID) ou o `numeroPedido` retornado pelos Correios. A API tenta os dois.

Resposta de Sucesso (200)

{
  "ok": true,
  "id": "lr_uuid_interno",
  "orderId": "ord_123456",
  "credentialId": "9a2c1f80-...-uuid",
  "tipo": "A",
  "servicoEnvio": "pac",
  "idCliente": "lr1a2b3c4d5e6f...",
  "numeroPedido": "1234567890",
  "numeroEtiqueta": "AA123456789BR",
  "lastStatusCode": "01",
  "lastStatusDescription": "Aguardando coleta",
  "prazoValidade": "2026-05-18",
  "valorDeclarado": "89.90",
  "remetente": {
    "nome": "Maria Silva",
    "logradouro": "Rua das Flores",
    "numero": "100",
    "complemento": "Apto 12",
    "bairro": "Centro",
    "cidade": "São Paulo",
    "uf": "SP",
    "cep": "01310100",
    "ddd": "11",
    "telefone": "987654321",
    "email": "[email protected]"
  },
  "historico": [
    {
      "data": "2026-04-19T09:30:00.000Z",
      "codigo": "01",
      "descricao": "Aguardando coleta",
      "local": "São Paulo/SP"
    }
  ],
  "lastSyncedAt": "2026-04-19T09:35:00.000Z",
  "createdAt": "2026-04-18T12:00:00.000Z",
  "updatedAt": "2026-04-19T09:35:00.000Z"
}

Campos adicionais (vs listagem)

Campo	Tipo	Obrig.	Descrição
`remetente`	object	não	Snapshot do remetente no momento da criação. Mesmo schema do POST.
`historico`	array \| null	não	Eventos sincronizados dos Correios (mais recente primeiro). null se ainda não houve sincronização.
`lastSyncedAt`	string(ISO) \| null	não	Data da última sincronização do histórico com os Correios.

Demais campos

Os outros campos (id, orderId, credentialId, etc.) seguem o mesmo formato da listagem. Vale o mesmo cuidado com orderId: LRs avulsas devolvem null.

Códigos de Status

Status	Significado
`200`	LR encontrada.
`400`	`validation` — ID/número de pedido vazio.
`401`	Chave de API ausente ou inválida.
`404`	`not_found` — não existe LR com esse ID/número para o seu time.

Exemplos

cURL — por ID interno

curl -H "Authorization: Bearer sr_live_sua_chave_aqui" \
  "https://seurastreio.com.br/api/public/logistica-reversa/lr_uuid_interno"

cURL — por número de pedido

curl -H "Authorization: Bearer sr_live_sua_chave_aqui" \
  "https://seurastreio.com.br/api/public/logistica-reversa/1234567890"

JavaScript

const res = await fetch(
  "https://seurastreio.com.br/api/public/logistica-reversa/lr_uuid_interno",
  { headers: { Authorization: "Bearer sr_live_sua_chave_aqui" } },
);
const lr = await res.json();
if (lr.ok) {
  console.log(lr.numeroEtiqueta, lr.lastStatusDescription);
  console.log("Eventos:", lr.historico?.length ?? 0);
}

Python

import requests

r = requests.get(
    "https://seurastreio.com.br/api/public/logistica-reversa/lr_uuid_interno",
    headers={"Authorization": "Bearer sr_live_sua_chave_aqui"},
)
lr = r.json()
if lr.get("ok"):
    print(lr["numeroEtiqueta"], lr["lastStatusDescription"])
    for evento in (lr.get("historico") or [])[:5]:
        print(evento["data"], evento["descricao"])

Resposta cacheada por 15 segundos no servidor. O historico é atualizado por jobs internos — chamadas em alta frequência não disparam novo fetch nos Correios.