KangluKanglu Docs
Como Funciona

Consulta ao Vivo (On-Demand)

Como a Kanglu busca dados em tempo real quando seu cliente acessa a página de rastreio

Consulta ao Vivo (On-Demand)

A consulta on-demand acontece automaticamente quando seu cliente final acessa a página pública de rastreio do pedido. Nesse momento, a Kanglu faz uma consulta direta à transportadora para garantir que o status exibido esteja o mais atualizado possível.

Como funciona?

  1. Seu cliente acessa o link de rastreio do pedido
  2. O cliente informa o CPF para validação de segurança
  3. A Kanglu consulta a transportadora em tempo real
  4. Se houver novos eventos, eles são adicionados à timeline
  5. O cliente vê o histórico completo e atualizado

Por que consultar na hora?

Entre uma verificação periódica e outra, pode haver atualizações que ainda não chegaram. A consulta on-demand resolve isso: quando o cliente realmente precisa da informação, buscamos diretamente na fonte.

Exemplo prático:

  • A verificação periódica rodou às 09:00 e mostrou "Em trânsito"
  • Às 10:30, a transportadora atualizou para "Saiu para entrega"
  • Às 11:00, seu cliente acessa o link de rastreio
  • A Kanglu consulta a transportadora e mostra "Saiu para entrega" atualizado

Resistência a falhas

Se a API da transportadora estiver fora do ar no momento da consulta, a página não quebra. O sistema simplesmente exibe o último histórico disponível, sem erros para o cliente.

A consulta on-demand complementa o webhook e o polling. Juntos, os 3 mecanismos garantem que seu cliente sempre tenha acesso à informação mais recente possível.

On this page