Guia
Como rastrear encomendas da Total Express pela API do Seu Rastreio
Para quem lidera a operação e quem implementa a integração.
Encomendas Total Express vêm com códigos no padrão TX (a documentação pública traz exemplos). No Seu Rastreio você não escolhe a transportadora na URL: o sistema identifica o formato e devolve a linha de tempo no mesmo contrato da rota de rastreio — um só GET para Correios e Total, um só tipo de resposta no seu painel de integração.
Operação: menos treinamento no SAC e uma URL de rastreio coerente com a marca. Tecnologia: reutilize a chave, o `/api/public/rastreio/{codigo}` e o tratamento de erros do guia dos Correios; ajuste apenas a validação do código (AWB TX).
Integração em três passos
- Gerar ou recuperar a chave. Dashboard → Chaves de API (sr_live_…).
- Enviar o código TX no path. GET /api/public/rastreio/{codigo} com o AWB total express.
- Ler a resposta. Mapear eventoMaisRecente e campos de histórico/previsão se o plano incluir, conforme a documentação.
Formato do código e teste antes de publicar
Confirme o código que chega do parceiro logístico: em geral começa por TX. Valide o formato na documentação e teste o mesmo código na página inicial do Seu Rastreio — se a busca pública reconhecer, a API retornará o padrão esperado ou uma mensagem de negócio clara.
A resposta segue a referência de /api-docs/rastreio: evento recente, e campos adicionais conforme o plano. Textos e fusos vêm da transportadora; o envelope é o do Seu Rastreio.
Boas práticas para o seu back-end
Mantenha GET + Authorization: Bearer + código no path, igual ao fluxo dos Correios. Centralize repetição de tentativas (retry) e tempo máximo (timeout) com política única, já que a mesma integração atende a várias transportadoras suportadas.
Perguntas frequentes
Dúvidas comuns de quem coloca a integração em produção.
- Preciso de outro endpoint só para Total Express?
- Não. A detecção é automática a partir do código, desde que o formato seja o suportado. A tabela e os exemplos estão em /api-docs/rastreio.
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