Rastreamento de entregas integrado às APIs das transportadoras

O que é um rastreamento integrado

É a conexão entre o sistema da empresa e os serviços digitais das transportadoras. Em vez de alguém abrir o portal de cada parceiro, o sistema consulta ou recebe os eventos automaticamente e os associa ao pedido, à nota fiscal e ao cliente.

Informação	Para que serve
Código de rastreio, nota fiscal e CT-e	Ligar o evento ao pedido certo
Data, hora e local de cada evento	Montar a linha do tempo da entrega
Previsão de entrega	Comparar com o prazo prometido ao cliente
Ocorrências	Identificar recusa, endereço incorreto, avaria ou ausência
Comprovante de entrega	Encerrar o ciclo e liberar o financeiro

O objetivo não é só mostrar esses dados em uma tela, e sim transformar informações dispersas em um fluxo operacional confiável.

Por que integrar direto com as transportadoras

Consultar portais funciona enquanto o volume é pequeno. Com o crescimento, a equipe passa o dia copiando códigos, interpretando mensagens diferentes e respondendo clientes de forma reativa. A integração cria uma base única para atendimento, comercial, fiscal e gestão, e substitui a memória da equipe por histórico, prazos e indicadores.

Arquitetura: um conector por transportadora

Uma arquitetura sustentável tem uma camada específica para cada transportadora, que conhece a autenticação, os campos obrigatórios e as particularidades do retorno. Acima dela, todo o restante do sistema segue o mesmo fluxo:

1. Identifica quais entregas precisam de atualização.
2. Consulta ou recebe os dados da transportadora correta.
3. Interpreta a resposta e normaliza os eventos.
4. Atualiza o status interno sem apagar o histórico.
5. Registra logs de sucesso e de falha.
6. Dispara alertas quando surge uma exceção relevante.

Quando uma nova transportadora entra na operação, basta adicionar um conector. O módulo de rastreamento, os painéis e as notificações continuam os mesmos.

Consulta periódica, webhook ou arquivo OCOREN

Cada transportadora oferece um canal diferente para entregar os eventos. O conector precisa saber trabalhar com todos eles:

Canal	Como funciona	Cuidados
API de consulta	O sistema pergunta periodicamente o status de cada entrega	Respeitar limites de requisição e ajustar a frequência
Webhook	A transportadora avisa o sistema quando surge um evento	Validar a origem da chamada e tratar eventos repetidos
Arquivo OCOREN (EDI)	Arquivo de ocorrências enviado em lote, geralmente via SFTP	Processar arquivos fora de ordem e registrar o que já foi lido

Frequência de consulta inteligente

Consultar todas as entregas a cada poucos minutos desperdiça requisições. Uma regra simples por fase resolve: entregas recém-postadas podem ser consultadas poucas vezes ao dia, entregas em rota merecem consultas mais frequentes e entregas concluídas saem da fila.

Status padronizado sem perder o evento original

Cada transportadora usa nomes diferentes para a mesma situação. O sistema traduz esses textos para um conjunto pequeno de status internos, mas guarda o evento original:

Retorno da transportadora	Status padronizado
“Saiu para entrega”, “Em rota”, “Em distribuição”	Saiu para entrega
“Destinatário ausente”, “Tentativa sem sucesso”	Ocorrência na entrega
“Entrega realizada”, “Mercadoria entregue”	Entregue
“Em transferência”, “Chegada na unidade”	Em trânsito

{
  "entrega_id": "PED-58213",
  "status_padrao": "saiu_para_entrega",
  "evento_original": {
    "transportadora": "transportadora-b",
    "codigo": "OC-012",
    "descricao": "Em distribuição na unidade de destino",
    "data_hora": "2026-10-07T08:14:00-03:00",
    "local": "Porto Alegre/RS"
  }
}

Assim a operação ganha filtros e painéis simples sem perder a rastreabilidade técnica quando precisa investigar um caso.

Alertas e gestão de exceções

O maior ganho aparece nas exceções. Com regras bem definidas, o sistema destaca automaticamente o que precisa de ação:

• Entrega sem atualização há mais dias que o normal para a rota.
• Prazo prometido ao cliente vencido ou prestes a vencer.
• Ocorrência que exige contato com o cliente, como endereço incorreto ou ausência.
• Tentativa de entrega sem sucesso.
• Divergência entre a previsão da transportadora e o prazo comercial.
• Comprovante de entrega disponível para o financeiro.

Em vez de esperar a reclamação, a equipe trabalha em uma fila de exceções e atua antes do problema chegar ao cliente.

Integração com ERP, e-commerce e atendimento

O rastreamento fica mais forte quando conversa com os outros sistemas. O atendente vê a entrega sem sair da tela do cliente, o comercial acompanha pedidos críticos e a gestão compara transportadoras por região e tipo de carga.

Também é possível comunicar o cliente de forma proativa, por e-mail ou WhatsApp, quando a entrega sai para rota, quando há uma ocorrência ou quando o comprovante fica disponível. Cada mensagem precisa estar ligada a um evento confiável, para não avisar algo que ainda não aconteceu.

Indicadores que passam a existir

Indicador	Como calcular
Entregas no prazo	Entregas concluídas até a data prometida ÷ total de entregas
Tempo até a primeira movimentação	Data do primeiro evento − data da postagem
Sucesso na primeira tentativa	Entregas sem ocorrência ÷ total de entregas
Ocorrências por transportadora	Entregas com ocorrência ÷ entregas da transportadora
Entregas paradas	Entregas sem evento há mais de X dias

Com esses números, a negociação com transportadoras deixa de ser baseada em impressão e passa a ser baseada em dados.

Cuidados técnicos importantes

• Fila de processamento e retentativas controladas.
• Tratamento de falhas isolado por transportadora.
• Logs detalhados e armazenamento do retorno original, quando permitido.
• Controle seguro de credenciais e tokens.
• Monitoramento de erros e de conectores sem resposta.
• Rotina de conciliação para entregas sem atualização.

Perguntas frequentes

Toda transportadora oferece API de rastreamento?

Não. Muitas trabalham com arquivo OCOREN ou apenas portal. Um conector bem feito lê o arquivo de ocorrências e entrega o mesmo resultado para o restante do sistema.

Webhook é sempre melhor que consulta periódica?

Quando a transportadora oferece webhook, ele é mais eficiente. Mesmo assim, vale manter uma consulta de conferência para entregas paradas, porque eventos podem se perder no caminho.

Dá para avisar o cliente automaticamente?

Sim. Com status padronizado, cada mudança relevante pode disparar uma mensagem por e-mail ou WhatsApp, sempre a partir de um evento confirmado.

Preciso trocar de ERP para ter rastreamento integrado?

Não. O rastreamento costuma funcionar como uma camada ao lado do ERP, lendo pedidos e notas e devolvendo status e comprovantes para os lugares certos.