Bling

O Bling é o ERP principal integrado à Kanglu. A conexão é feita via OAuth2 — você autoriza a Kanglu a acessar seus dados do Bling com apenas alguns cliques.

Como conectar

1. No painel Kanglu, vá em Integrações
2. Na seção de ERPs, clique em Bling
3. Você será redirecionado para o site do Bling
4. Faça login e autorize a Kanglu a acessar seus dados
5. Pronto! A conexão é estabelecida automaticamente

O que a Kanglu acessa no Bling?

• Pedidos de venda — Para importar os dados do pedido
• Situações — Para mapear os status do Bling para ações na Kanglu
• Dados da empresa — CNPJ para associar os rastreamentos

Como os pedidos chegam?

O Bling envia os pedidos para a Kanglu de duas formas:

1. Webhook (principal)

Quando um pedido é criado ou atualizado no Bling, ele envia automaticamente uma notificação para a Kanglu. Isso acontece em tempo real.

A Kanglu processa esses webhooks a cada 60 segundos, garantindo que pedidos novos apareçam rapidamente.

2. Verificação de saúde

A Kanglu verifica a cada 30 minutos se o webhook do Bling está funcionando. Se detectar que parou de receber pedidos, ela alerta via WhatsApp.

Importação de pedidos históricos

Ao conectar o Bling pela primeira vez, é comum que o Bling envie webhooks de pedidos que já existiam antes da conexão. A Kanglu trata esses pedidos de forma inteligente:

• Pedidos históricos são importados normalmente no painel, com todos os dados disponíveis
• Notificações via WhatsApp não são enviadas para pedidos históricos — evitando que seus clientes recebam mensagens sobre pedidos antigos
• Pedidos sem dados de transporte (sem volumes de envio) também são importados, ficando disponíveis no painel mesmo que ainda não tenham informações de rastreio

Identificação automática de transportadoras

Quando um pedido chega do Bling, a Kanglu tenta identificar automaticamente qual transportadora está sendo utilizada. Esse processo funciona em duas etapas:

1. Mapeamento por serviço

Se o pedido tem dados de envio (volumes), a Kanglu consulta o serviço logístico no Bling e verifica se já existe um mapeamento cadastrado para aquele serviço.

2. Auto-identificação por nome

Caso não exista um mapeamento prévio, a Kanglu analisa o nome do serviço e o nome da transportadora que constam no pedido e tenta fazer o match automaticamente com as transportadoras já cadastradas no sistema.

Por exemplo, se o Bling informa que a transportadora é "J&T EXPRESS - MKTPLACE", a Kanglu automaticamente associa ao J&T Express. Quando o match é encontrado, o mapeamento é salvo automaticamente para que pedidos futuros com o mesmo serviço sejam identificados instantaneamente.

As transportadoras reconhecidas automaticamente incluem: Correios, FM Transportes, J&T Express, Jadlog, Loggi, Mandaê, Anjun, iMile, Vetor, Mercado Envios, TikTok e Frenet.

Dados importados

Quando um pedido chega do Bling, a Kanglu extrai:

• Numero do pedido e data de venda
• Dados do cliente (nome, CPF, telefone, e-mail, endereço)
• Nota fiscal (numero e chave de acesso)
• Transportadora e codigo de rastreio
• Valor total do pedido
• Status do pedido no Bling
• Dados completos de transporte (etiqueta, peso, frete, volumes)
• Itens do pedido e parcelas de pagamento
• Intermediador (marketplace) quando aplicável

Tratamento de erros e rate limiting

A Kanglu respeita os limites de requisição da API do Bling (3 requisições por segundo). O processamento inclui pausas entre cada pedido para evitar bloqueios.

Se uma requisição falhar por limite de taxa (erro 429), o webhook é automaticamente re-enfileirado para processamento posterior. Erros temporários não causam perda de dados — o pedido será processado na próxima tentativa.

Renovação automática de tokens

O token do Bling expira periodicamente. A Kanglu renova automaticamente antes da expiração — você não precisa reconectar manualmente.