Automação e Agentes de IA · Integração Bling — Pedido, estoque e nota já vivem no Bling. Os outros sistemas da empresa precisam saber disso na hora.
A Composto Web conecta o Bling aos outros sistemas da empresa pela API oficial dele, a versão 3. A venda que nasce fora entra no Bling, a mudança de estoque chega a quem vende e a nota emitida avisa quem expede. Cada passo segue o que o portal de desenvolvedores do Bling documenta.
Onde a integração manual aparece
Vender em vários canais com um Bling que só sabe o que alguém digitou.
O Bling organiza a operação de quem vende produto. O atrito começa quando loja, marketplace, depósito e planilha de gestão precisam do mesmo dado e cada um recebe uma cópia feita à mão.
Uma venda feita no canal que ainda não está conectado é redigitada no Bling no fim do dia, e o cliente espera a separação começar no dia seguinte.
O saldo de estoque baixa no Bling, mas a vitrine continua mostrando a peça disponível, e a venda sem produto vira cancelamento e reclamação.
A equipe do depósito só descobre que a nota saiu quando alguém avisa no grupo, porque o sistema de separação não recebe nada do Bling.
A conexão antiga, feita com a chave da versão anterior da API, nunca foi migrada nem monitorada, e quando uma chamada falhou o pedido parado foi notado pelo cliente antes da empresa.
O que a integração cobre com a API v3 do Bling
Os recursos abaixo estão no portal de desenvolvedores e no anúncio oficial da versão 3. O desenho escolhe os que o fluxo da empresa usa e deixa o resto de fora.
Autorização OAuth 2.0, sem senha de usuário
A versão 3 exige um aplicativo registrado no Bling e autoriza o acesso pelo fluxo de código de autorização do OAuth 2.0. O token de acesso vai em cada chamada, e o token de renovação mantém a conexão viva. A credencial do aplicativo fica no servidor da integração, longe do navegador.
Pedidos de venda e de compra
As rotas de pedidos da versão 3 separam venda e compra, e as respostas vêm em JSON. O pedido que nasce na loja, no marketplace ou no sistema do representante entra no Bling sem redigitação, e o pedido de compra pode alimentar o planejamento de reposição.
Produto, variação, estrutura e estoque
Produtos, variações e estruturas têm rotas próprias, e os webhooks do Bling avisam quando produto, estoque, estoque virtual ou vínculo de produto com fornecedor muda. Com isso o saldo chega à vitrine e ao depósito quando acontece, e não na próxima rodada de exportação.
Nota fiscal que avisa quem expede
Nota fiscal e nota fiscal de consumidor estão entre os recursos que geram webhook, com ação de criação, alteração e exclusão. A emissão da nota pode liberar a etapa seguinte no sistema de separação ou de transporte sem ninguém conferir a tela do Bling.
Receptor de webhook que confere a assinatura
Cada notificação traz um cabeçalho com assinatura HMAC calculada com o segredo do aplicativo, e o receptor confere essa assinatura antes de aceitar o dado. Como o Bling avisa que a entrega pode repetir e não segue ordem garantida, o receptor trata duplicidade e processa em fila.
Onde esta integração termina
Liga o Bling aos outros sistemas pela API oficial. Não opera a conta nem a configuração do Bling.
Integração com o Bling (esta página)
- O Bling já organiza pedido, estoque e nota, e falta conectar os sistemas que dependem desses dados.
- Os recursos necessários estão na API v3 e nos webhooks documentados.
- A Composto Web desenha, constrói, acompanha e mantém a conexão.
Software Sob Medida
- O outro lado não tem API nem arquivo de troca, e o caminho é construir essa camada.
- O processo da empresa pede um sistema próprio, e não uma conexão entre dois existentes.
Cadastro de regra fiscal, natureza de operação e ajuste da conta do Bling continuam com a empresa e com o suporte do Bling. A integração lê e grava pelo que a API permite, sem mexer na configuração.
Quando faz sentido conversar
O sinal mais claro é a mesma venda aparecer em dois lugares com números diferentes.
Quem vende por um canal só e opera tudo dentro do Bling raramente precisa disso. A conversa vale a pena quando estes sinais aparecem.
Há venda em canal que ainda não chega ao Bling sozinha.
A vitrine mostra saldo diferente do que o Bling tem.
O depósito ou a transportadora dependem de aviso manual para saber da nota emitida.
Uma integração antiga parou ou nunca foi migrada para a versão 3 da API.
Como o projeto anda do diagnóstico à conexão no ar
Primeiro decidimos qual sistema é a referência de cada saldo e de cada pedido. Só depois vem a primeira linha de código.
ETAPA 01
Imersão
Mapeamos cada canal de venda, o depósito, a transportadora e as planilhas em volta do Bling, e anotamos onde o pedido ou o saldo é copiado à mão.
ETAPA 02
Engenharia
Definimos os escopos do aplicativo, as rotas e os webhooks usados, quem é referência de estoque e como distribuir as chamadas dentro do limite por conta que o Bling impõe.
ETAPA 03
Construção
Registramos o aplicativo, implementamos a autorização e a renovação do token, e montamos o receptor que confere assinatura, descarta repetição e grava em fila.
ETAPA 04
Homologação
Pedidos e saldos passam pela integração enquanto a equipe confere em paralelo. A conferência manual só termina quando os dois lados batem por um ciclo completo de vendas.
ETAPA 05
Gestão e Sustentação
Acompanhamos resposta 429, webhook desativado por falha e token expirado, e ajustamos a conexão quando o Bling publica mudança na API ou quando a empresa troca os escopos do aplicativo.
O que muda quando o Bling conversa com os outros sistemas
Separação que começa com a venda
O pedido de qualquer canal chega ao Bling e ao depósito sem esperar o lançamento do fim do dia.
Saldo igual em todo canal
A vitrine recebe a mudança de estoque quando ela acontece, e a venda de produto que acabou deixa de ser rotina.
Falha percebida pela empresa
Webhook parado ou token vencido gera alerta, e o problema é tratado antes de virar reclamação de cliente.
Dúvidas mais comuns
O que perguntam antes de integrar o Bling
“Vamos precisar dar o login do Bling para alguém?”
Não. A versão 3 trabalha com um aplicativo registrado e com autorização OAuth 2.0: a conta autoriza o aplicativo, e as chamadas usam token. Se a empresa alterar os escopos do aplicativo, o Bling revoga os usuários autorizados, por isso mudança de escopo é planejada junto com a manutenção.
“O Bling limita quantas chamadas a integração faz?”
Limita, por conta e somando todas as rotas, e devolve HTTP 429 quando o limite passa. A documentação também prevê bloqueio do IP de origem quando há muitos erros ou muitas requisições em poucos segundos. A integração agenda, agrupa e espaça as chamadas para ficar dentro disso.
“O que acontece se o nosso servidor demorar a responder um webhook?”
O Bling considera entregue a notificação respondida com sucesso em poucos segundos e repete as que falham por alguns dias. Se a falha continuar, o webhook daquele recurso é desativado até alguém reativar no aplicativo. O receptor responde na hora, processa depois e avisa quando um recurso fica sem notificação.
“Nossa integração ainda usa a versão antiga da API. Dá para migrar?”
Dá, e o anúncio da versão 3 explica o que muda: autenticação por OAuth no lugar da chave antiga e rotas renomeadas, como pedidos que passaram a ser pedidos de venda. O diagnóstico confere o que a integração atual faz e diz quanto dela é aproveitado.
Frentes relacionadas
Voltar para Integrações entre SistemasIntegrações entre sistemas
Como a Composto Web conecta CRM, ERP e canais.
O que é webhook
A notificação que o sistema envia quando algo muda.
O que é ERP
O papel do sistema de gestão na operação.
Aviso automático de status de entrega
Quando a nota emitida precisa virar aviso ao cliente.
Sustentação de automações
Monitoramento da conexão depois da entrega.
Fontes citadas
- Bling: anúncio da API v3: A versão 3 usa OAuth 2.0 e exige aplicativo registrado no Bling; as respostas são em JSON e rotas foram renomeadas, como /pedidos para /pedidos/vendas e /pedidoscompra para /pedidos/compras; produtos têm rotas de variações e estruturas.
- Bling Developers: autenticação e autorização: Fluxo Authorization Code do OAuth 2.0, token de acesso do tipo Bearer, token de renovação, escopos do aplicativo; alterar os escopos revoga os usuários do aplicativo.
- Bling Developers: webhooks: Ações created, updated e deleted para pedido de venda, produto, estoque, estoque virtual, produto fornecedor, nota fiscal e nota fiscal de consumidor; assinatura HMAC no cabeçalho X-Bling-Signature-256; novas tentativas e desativação do webhook se a falha persistir; entrega pode repetir e não tem ordem garantida.
- Bling Developers: limites: Limites por conta, somando todas as rotas, com resposta HTTP 429 ao exceder; bloqueio do IP de origem após excesso de erros ou de requisições em poucos segundos.
Próximo passo
Se a venda de um canal ainda chega ao Bling pela mão de alguém, é por essa venda que o projeto começa.
O diagnóstico percorre com a sua equipe cada canal, o depósito e os relatórios que dependem do Bling, e mostra quais recursos da API v3 cobrem cada passagem.
- Canais, depósito e relatórios que dependem do Bling
- Recursos e webhooks da API v3 para cada fluxo
- Referência de estoque e de pedido definida por sistema