API do Bling: o que dá para fazer e como usar com agentes de IA
A API do Bling dá acesso aos cadastros e movimentos do ERP: produtos, estoque, pedidos, notas fiscais, contatos e financeiro. É usada por lojas virtuais, integradores e empresas que conectam marketplaces e sistemas ao Bling. A versão atual exige aplicativo registrado e autorização OAuth da conta do cliente.
Os grandes recursos da API, em português claro.
Cadastro de produtos, variações, preços e estruturas.
Consulta de saldos por depósito e lançamento de movimentações.
Criação, consulta e mudança de situação de pedidos, inclusive vindos de lojas integradas.
Emissão e consulta de NF-e e NFC-e a partir dos pedidos.
Clientes, fornecedores e transportadoras.
Títulos financeiros, baixas e categorias.
Avisos de mudanças em pedidos, produtos e estoque para reagir sem ficar consultando.
Como se acessa a API do Bling.
- Com credencial da sua empresaOAuth 2.0: você registra um aplicativo na área de desenvolvedor do Bling e a conta da empresa autoriza os escopos; o token de acesso é renovado com refresh token.
- Documentação oficialdeveloper.bling.com.br
- A API tem limite de requisições por segundo e por dia; sincronizações grandes devem usar webhooks.
- A API antiga, por chave, foi substituída pela v3 com OAuth; integrações antigas precisam migrar.
- Notas emitidas têm efeito fiscal: mantenha aprovação humana nessa etapa.
- api bling
- api bling v3
- bling api pedidos
- bling api nota fiscal
- integração api bling
- bling api documentação
- webhook bling
O que um agente do iTeam faz com a API do Bling.
O agente encontra pedidos faturáveis há mais de um dia sem NF-e emitida e avisa o fiscal com o motivo provável, como cadastro incompleto do cliente.
Cruzando vendas recentes e saldo por depósito, o agente aponta produtos que vão zerar na semana e prepara a sugestão de compra para o comprador aprovar.
O cliente B2B pergunta pelo pedido e o agente consulta situação, nota e transportadora no Bling, respondendo sem acionar o comercial.
O agente lista contas a receber vencidas, agrupa por cliente e envia o lembrete com a segunda via, registrando o contato.
Da credencial ao agente trabalhando, com aprovação.
Registre o aplicativo no Bling
Na área de desenvolvedor, crie o app com os escopos mínimos (por exemplo pedidos e estoque) e autorize com um usuário administrador.
Guarde a autorização no cofre do iTeam
O iTeam renova o token e cada agente recebe permissões próprias: atendimento lê pedidos, compras lê estoque, financeiro lê títulos.
Valide com aprovação humana
Emissão de nota, baixa de título e alteração de estoque começam com aprovação e ficam auditadas.
Dúvidas sobre a API do Bling.
A API do Bling é gratuita?
De forma geral, o acesso à API vem com a assinatura do Bling, respeitando os limites do plano. Confirme no seu plano se há restrições.
Preciso programar para usar a API do Bling com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação do Bling e o time de implantação configura os fluxos.
Dá para emitir nota fiscal pela API?
Sim, a API permite emitir e consultar notas a partir dos pedidos, conforme a configuração fiscal da conta.
Quais tarefas do ERP Bling um agente de IA consegue fazer pela API?
A API do Bling cobre produtos, estoque, pedidos de venda, notas fiscais, contatos e contas a pagar e a receber, e o agente age sobre isso. Ele confere o saldo antes de aceitar um pedido de marketplace, atualiza o estoque e avisa quando uma nota fica pendente. A emissão fiscal fica sob aprovação. No iTeam, o agente de operações recebe esse acesso por cargo.
Como autenticar na API v3 do Bling com OAuth 2.0?
Você registra um aplicativo na área de desenvolvedor do Bling, a conta da empresa autoriza os escopos e a integração troca o código por um token de acesso, renovado com um refresh token. Os escopos definem o que o aplicativo lê e grava, então peça só os módulos usados. A versão antiga da API, que usava chave, foi substituída pela v3.
O Bling tem ambiente de testes para a API?
Não confirmei um ambiente de sandbox separado na documentação do Bling, e fontes de terceiros indicam que o host é sempre o de produção. Confira em developer.bling.com.br se há uma conta de teste. Na dúvida, teste com uma conta Bling de homologação com produtos fictícios, desligando a emissão fiscal e as integrações com marketplaces reais.
Minha integração antiga com chave de API do Bling vai continuar funcionando?
A API por chave foi substituída pela v3, que usa OAuth, então integrações antigas precisam migrar. A migração troca o modo de autenticação e os formatos de algumas respostas, e é uma boa hora para rever o que cada fluxo faz. Confira no portal de desenvolvedores do Bling a data de desativação da versão anterior antes de planejar.
Como o agente evita estourar o limite de requisições do Bling?
O Bling limita as requisições por segundo e por dia, então o agente espaça as chamadas e prefere webhooks a consultas repetidas. Em sincronizações grandes, ele pagina, guarda o que já leu e retoma de onde parou se o limite for atingido. Confira os números atuais na documentação, porque eles podem mudar e variar por conta.
O agente pode emitir nota fiscal pelo Bling sozinho?
A API permite emitir notas, mas elas têm efeito fiscal, então a etapa deve passar por aprovação humana, ao menos no começo. O agente monta o pedido, confere NCM, CFOP e cliente e pede a liberação de quem responde pela área fiscal. Depois de um período sem erros, dá para liberar pedidos simples de baixo valor dentro de regras.
Como o Bling se conecta a marketplaces e a um agente de IA ao mesmo tempo?
O Bling já integra com marketplaces e, via API, o agente acompanha os pedidos que chegam ali. O agente não duplica a integração: ele lê os pedidos no Bling, trata exceções como falta de estoque e responde ao cliente. Cuidado com a duplicidade de baixa de estoque, definindo qual sistema é a fonte e qual só consulta.
Preciso programar para conectar o Bling a um agente de IA?
A programação se limita ao registro do aplicativo e ao fluxo de autorização, que muitas plataformas de agentes já trazem prontos. O restante é configurar o que o agente faz e quais escopos ele recebe. Se houver campos personalizados ou regras fiscais próprias, vale a ajuda de alguém técnico para mapeá-los na primeira versão.
