Correios
Como funciona a integração com os Correios
Correios
Os Correios são a maior rede logística do Brasil, integrados à Kanglu com rastreamento via API SRO (Sistema de Rastreamento de Objetos).
Credenciais Necessárias
Para ativar a integração com os Correios, você precisa fornecer:
| Credencial | Descrição | Onde obter |
|---|---|---|
| Login (CNPJ) | CNPJ vinculado ao contrato com os Correios | Seu contrato com os Correios |
| Código de Acesso | Código gerado no portal CWS | CWS Correios |
Como gerar o Código de Acesso
- Acesse o portal CWS Correios com seu CNPJ
- Vá na seção de APIs ou Web Services
- Gere um novo código de acesso
- Copie o código e cadastre na Kanglu
Essas credenciais são cadastradas no painel Kanglu, na página de Integrações. A Kanglu armazena seus dados de forma segura.
Como funciona o rastreamento?
Os Correios não enviam notificações automáticas (webhook). A Kanglu usa apenas verificação periódica (polling) para consultar o status dos seus envios.
| Mecanismo | Disponível? |
|---|---|
| Webhook (notificação instantânea) | Não |
| Verificação periódica (polling) | Sim — a cada 5 minutos |
| Consulta ao vivo (on-demand) | Sim — quando o cliente acessa a página de rastreio |
Fluxo de autenticação
A API dos Correios usa um processo de autenticação em 2 etapas:
- Autenticação — A Kanglu envia o CNPJ + Código de Acesso para obter um token JWT temporário
- Consulta — Com o token JWT, consulta o rastreamento do objeto via API SRO
Tudo isso é feito automaticamente — você só precisa cadastrar as credenciais.
Códigos de evento
Os Correios usam códigos como BDE-01, OEC-01, BDI-01 para identificar cada tipo de evento. A Kanglu mapeia esses códigos automaticamente para os status padronizados da plataforma.
Exemplos de eventos comuns:
| Código | Significado |
|---|---|
| BDE | Objeto entregue |
| OEC | Objeto saiu para entrega |
| RO | Objeto em trânsito |
| BDI | Objeto encaminhado |
| BDR | Objeto devolvido |
Página de Rastreio Pública
Seus clientes podem rastrear envios diretamente no site dos Correios: https://rastreamento.correios.com.br
Pela Kanglu, seus clientes acessam o rastreio pela página pública da sua empresa, sem precisar ir ao site dos Correios.