Guia
Correios e Total Express no Seu Rastreio: uma integração, várias transportadoras suportadas
Para quem lidera a operação e quem implementa a integração.
A plataforma integra hoje Correios (códigos no padrão clássico, ex.: `AA…BR`) e Total Express (padrão TX…), sem exigir transportadora na URL base: envie o código com `GET` em /api/public/rastreio/{codigo} e Bearer.
A resposta traz linha de tempo e campos conforme /api-docs/rastreio, incluindo o último evento e, se o plano permitir, histórico e previsão. O mesmo rastreio o comprador vê na home e em /objetos/...; a chave fica só com o time na API.
Produto e diretoria reduzem o custo de múltiplas integrações. Tecnologia aplica cache e limite de taxa com critério — mas o fato da encomenda na rua ainda depende da transportadora; o Seu Rastreio expõe o status previsto no contrato público da API.
Como extrair o máximo do desenho único
- Conferir o código no formato suportado. Correios e Total Express: exemplos e tamanho na documentação de rastreio.
- Chamar a API de rastreio. GET com Bearer, mesmo padrão para a transportadora aplicável naquele pedido.
- Expor no canal do cliente. Use o JSON; quando a resposta tiver o link de detalhes, ele aponta para a página pública apropriada, conforme a tabela de campos.
Ganho para o negócio e para a base de código
Um único cliente HTTP, um contrato JSON e a mesma base para e-mail, ERP e app, desde que o código obedeça aos formatos em /api-docs/rastreio. Quando a transportadora mudar regras, acompanhe a documentação pública e o que a equipe publicar em notas de versão; trate a interpretação dos campos com teste de regressão periódico, não com suposição fixa no back-end.
Perguntas frequentes
Dúvidas comuns de quem coloca a integração em produção.
- Como validar o formato do código antes do lote noturno de consultas?
- A busca pública na home ajuda a checar o formato; a verdade operacional vem da transportadora e da resposta da API. Códigos e mensagens de falha constam em /api-docs/rastreio; cota e plano em /planos e na tabela de cada rota, quando a doc exigir.
Próximo passo: documentação oficial
Parâmetros, tabelas de resposta, limites e exemplos em código — tudo na referência de API pública.
Atualizado em 23/04/2026