KangluKanglu Docs
Como Funciona

Como Funciona

Entenda como a Kanglu rastreia seus pedidos automaticamente

Como Funciona o Rastreamento

A Kanglu mantém seus pedidos atualizados automaticamente usando 3 mecanismos complementares. Você não precisa fazer nada — basta configurar suas credenciais e o sistema cuida do resto.

Os 3 Mecanismos

1. Notificação Instantânea (Webhook)

Quando a transportadora atualiza o status de um envio, ela nos avisa automaticamente em tempo real. Este é o mecanismo principal e mais rápido.

Na prática: Assim que a transportadora registra que seu pedido saiu para entrega, você vê essa informação na Kanglu em segundos.

2. Verificação Periódica (Polling)

Como rede de segurança, a Kanglu também consulta ativamente as transportadoras em intervalos regulares. Isso garante que nenhuma atualização seja perdida, mesmo que a notificação instantânea tenha alguma falha temporária.

Na prática: Mesmo que uma notificação se perca, a Kanglu vai buscar a informação automaticamente.

SituaçãoFrequência da verificação
Webhook funcionando normalmenteA cada 6 horas (rede de segurança)
Webhook com problemas ou sem webhookA cada 5 minutos (modo ativo)

3. Consulta ao Vivo (On-Demand)

Quando seu cliente final acessa a página pública de rastreio, a Kanglu faz uma consulta direta à transportadora naquele momento. Isso garante que a informação exibida esteja o mais atualizada possível.

Na prática: Seu cliente sempre vê o status mais recente quando acessa o link de rastreio.

Fluxo Simplificado

Transportadora atualiza status
        |
        v
  Kanglu recebe a informação (webhook / polling / on-demand)
        |
        v
  Status é normalizado para uma linguagem padronizada
        |
        v
  Timeline do pedido é atualizada
        |
        v
  Você e seu cliente veem a atualização

O que significa "status normalizado"?

Cada transportadora usa nomes diferentes para os mesmos eventos. A Kanglu traduz todos para um padrão único. Por exemplo:

O que a transportadora dizO que você vê na Kanglu
"Objeto postado" (Mandaê)Postado
"SIGNED" (J&T)Entregue
"Em trânsito" (FM)Em transferência

Assim, independente da transportadora, você sempre entende o status do pedido.

On this page