Integrações

Conectar o Bling ERP e sincronizar clientes, produtos, pedidos e NF-e

Conecte sua conta do Bling (ERP brasileiro) ao CRM via OAuth e sincronize clientes, produtos, pedidos de venda e notas fiscais nos dois sentidos, sem duplicar registros.

Você pode conectar sua conta do Bling ao CRM. Depois de conectada, o CRM puxa do Bling os clientes (vira Contato ou Empresa), os produtos, os pedidos de venda e as notas fiscais (NF-e), mantendo tudo vinculado pelo id do Bling. Uma nova sincronização nunca cria duplicatas: ela atualiza o registro que já existe.

O modelo é BYO ("traga a sua conta"): você usa a sua própria conta Bling e o seu app OAuth. Nós nunca vemos suas credenciais e não há custo nosso. A integração nasce inerte: nada acontece até você configurar as credenciais e ativar.

Pré-requisitos

Uma conta no Bling com acesso à API v3.
Um aplicativo criado no Bling (menu do desenvolvedor), do qual você obtém o Client ID e o Client Secret e autoriza para obter o refresh token OAuth.
No Sellio, ser administrador (permissão de gerir configurações) para salvar as credenciais em Configurações → Integrações.

Passo 1: crie o aplicativo no Bling

No Bling, acesse a área de aplicativos/desenvolvedor e crie um novo aplicativo usando a API v3.
Copie o Client ID e o Client Secret do aplicativo.
Faça a autorização OAuth do aplicativo para a sua conta e guarde o refresh token gerado. O CRM usa o refresh token para renovar o acesso sozinho.

Passo 2: cole as credenciais no CRM

Abra Configurações → Integrações e localize o cartão "Bling ERP".
Cole o Client ID, o Client Secret e o refresh token. As credenciais são guardadas cifradas e nunca são exibidas de volta.
Em "Entidades e direção", escolha para clientes, produtos, pedidos e notas fiscais se quer puxar do Bling, enviar ao Bling, nos dois sentidos ou não sincronizar.
Clique em "Salvar conexão" e depois em "Ativar".

Passo 3: sincronize e receba atualizações

Clique em "Sincronizar agora" para puxar os dados do Bling imediatamente. Uma sincronização automática também roda diariamente.
Para receber alterações em tempo quase real, aponte as notificações (webhook) do Bling para a URL exibida no cartão. Ela contém um token secreto: mantenha em sigilo.
Recomendamos fortemente preencher o "Segredo do webhook" no cartão e usar o mesmo valor na configuração do Bling. Como esse webhook ESCREVE registros no seu CRM (contatos, pedidos, NF-e), o segredo garante a autenticidade de cada chamada por assinatura (HMAC).

Os clientes pessoa física viram Contatos e os pessoa jurídica viram Empresas. Cada produto vira um Produto, cada pedido de venda vira um Pedido de venda (vinculado ao cliente) e cada NF-e vira uma atividade com o número, o valor e o link do DANFE.

Segurança e privacidade

O Client Secret e o refresh token são guardados cifrados e nunca são exibidos. O token de acesso é renovado automaticamente quando expira, sem nova autorização. A conexão nasce inerte e só sincroniza depois de configurada e ativada.

💡 Recomendação de segurança: configure o "Segredo do webhook". O webhook do Bling ESCREVE registros no seu CRM (contatos, pedidos, NF-e), então trate-o como uma porta de entrada de dados. Com o segredo, cada chamada é validada por assinatura (HMAC) e só passa quem conhece o segredo. Sem ele, a única proteção é o token da URL: se esse token vazar, alguém poderia injetar dados na sua conta. Não é obrigatório, mas é altamente recomendado.

Exemplo: URL do webhook a cadastrar no Bling: https://app.suaempresa.com/api/inbound/bling/SEU-TOKEN (copie o valor exato exibido no cartão).

Como testar

Depois de salvar e ativar, clique em "Sincronizar agora" e aguarde a confirmação.
Abra a lista de Contatos, Produtos e Pedidos de venda e confira se os registros do Bling apareceram.
No cartão, veja a contagem de "Vínculos por entidade" aumentar conforme os dados são sincronizados.

Solução de problemas

Não sincroniza nada: confirme que a integração está "Ativada" e que ao menos uma entidade está marcada como "Puxar do Bling" ou "Nos dois sentidos".
Erro de credenciais ao sincronizar: recadastre o Client ID, o Client Secret e o refresh token (o Secret e o token nunca voltam do servidor, então recole por inteiro).
Os registros não aparecem: confirme que os objetos Contato, Empresa, Produto e Pedido de venda existem na sua conta (eles são padrão).
O webhook não chega: verifique se a URL cadastrada no Bling está idêntica à exibida no cartão e, se você usou um segredo do webhook, se ele é o mesmo dos dois lados.

Abrir este artigo dentro do sistema →