Integração Bling ERP ao Excel VBA via API

Descubra como automatizar processos entre o Excel e o Bling ERP através da API RESTful com VBA! Este tutorial passo a passo ensina você a implementar operações CRUD (Create, Read, Update, Delete) usando métodos HTTP (GET, POST, PATCH, DELETE) para:

• ✅ Cadastrar produtos diretamente do Excel (POST)
• ✅ Consultar dados de estoque e vendas (GET)
• ✅ Atualizar informações como preço e estoque (PATCH)
• ✅ Excluir registros com confirmação (DELETE)

✨ Principais Benefícios:

• Economize tempo eliminando digitação manual no Bling.
• Sincronize dados em tempo real entre planilhas e o ERP.
• Automatize relatórios de vendas, estoque e financeiro.
• Integre com outras ferramentas (e-commerces, marketplaces).

🔑 Palavras-Chave:

Excel VBA, Bling API, Integração de Sistemas, Automação com CRUD, Métodos HTTP (GET, POST, PATCH, DELETE), ERP para PMEs, API RESTful, JSON, Gestão de Estoque, Automação Comercial.

📌 Pré-requisitos:

• Conta no Bling (versão Starter ou superior).
• Excel habilitado para macros (2010+).
• Noções básicas de VBA (códigos prontos inclusos!).

👉 Continue lendo para dominar a integração e transformar seu Excel em uma poderosa ferramenta de gestão com o Bling!

Tutorial Integração Excel VBA e Bling API

🔹 ETAPA 1: Criar uma Conta na Bling

• Acesse https://www.bling.com.br e clique em "Experimente Grátis".
• Preencha os dados (e-mail, nome, CNPJ/CPF) e selecione um plano (o Starter já inclui acesso à API).
• Confirme seu e-mail e faça login no painel da Bling.

🔹 ETAPA 2: Criar um Aplicativo na Bling

A criação de uma aplicativo na Bling dará a você acesso a 3 dados importantes, são eles o "Client ID", o "Client Secret" e "Link de convite". Estes três valores, serão usados para gerar os Tokens de acesso.

É possível cadastrar um aplicativo pela conta do administrador ou criando um usuário para tal finalidade. Recomendamos a criação de um usuário para cada desenvolvedor, dessa forma, cada usuário poderá gerenciar somente os seus aplicativos.

1. Para criar um usuário acesse o menu "Preferências > Sistema > Usuários", clique em "Incluir usuário".
2. Nas permissões de "Cadastros" selecione "Cadastro de aplicativos" e preencha as informações da conta do usuário.

Após esse processo, o usuário possuirá acesso ao módulo de Cadastro de aplicativos.

Como cadastrar

1. Acesse a Central de Extensões
2. Clique em "Área do Integrador"

Criação do aplicativo na Bling

Na tela de cadastro de aplicativos clique no botão CRIAR NOVO APLICATIVO.

Criar novo Aplicativo

Visibilidade

Escolha a visibilidade do aplicativo:

• Público: O aplicativo será utilizado para realizar operações em outras contas Bling e passará pelo processo de homologação. Enquanto não for homologado, o número de usuários que podem autorizá-lo estará restrito a 10.
• Privado: O aplicativo será utilizado para realizar operações na própria conta Bling.

Tipo de visibilidade do aplicativo

Clique em próximo. Na sequência preencha os seguintes dados do aplicativo:

• Logo: Exibido aos usuários do aplicativo.
• Nome: Exibido aos seus usuários.
• Categoria: Classificação de negócio.
• Descrição: Detalhamento das principais características e finalidades deste aplicativo.
• Link de redirecionamento: Utilizado na etapa de autorização.
• Link da homepage: Endereço do site do aplicativo.
• Nome do desenvolvedor: Nome do desenvolvedor do aplicativo.
• Email: Email para eventuais contatos do nosso time.
• Celular: Celular para eventuais contatos do nosso time.
• Lista de escopos: Escopos referentes aos dados dos usuários que serão acessados pelo aplicativo.

Informações do aplicativo

Após a criação do aplicativo, a aba "Informações do app" ficará disponível. Atente-se ao Client Id e ao Client Secret, que serão utilizados no momento da autorização.

Informações do app

Códigos de acesso

Para gerar os códigos de acesso é necessário que os usuários deem autorização sobre o acesso aos dados das contas, ao aplicativo. O OAuth 2 protocola 4 tipos de concessão para que essa autorização seja realizada, no entanto o Bling fará uso de apenas uma delas, que é o Authorization Code. Portanto, será necessário seguir o fluxo de autorização descrito abaixo para obter os códigos de acesso.

Terminologia

• Client App: Aplicativo que fará uso dos dados das contas dos usuários (conta Bling).
• Authorization Code: Código enviado ao Client App quando um usuário autoriza acesso aos dados.
• Access Token: Token utilizado para requisição do recurso dos usuários.
• Refresh Token: Token utilizado para requisitar um novo access_token, quando o mesmo expirar.

Fluxo de autorização

• O client app, com a intenção de obter o authorization_code, redireciona o usuário (através do seu user agent) para o authorization server.
• O usuário se autentica no sistema e autoriza, ou não, o aplicativo.
• O authorization server redireciona o usuário (através do user agent) de volta ao client app, utilizando a “URL de redirecionamento” inserida no cadastro do aplicativo. Se o usuário autorizou o acesso aos seus recursos, o authorization_code será incluído no retorno e segue-se para o passo a seguir. Caso contrário, o fluxo de autorização termina aqui.
• O client app requisita o access_token, fazendo uma requisição para o authorization server com o authorization_code recebido no passo anterior.
• Se o authorization_code for válido, o authorization server retornará um JSON contendo o access_token e o refresh_token.

🔹 ETAPA 3: Como gerar o Authorization code

Para obter o Authorization code, siga as etapas a seguir:

1. Copie o Link de Convite
2. Abra o navegador
3. Cole o link na URL e dê ENTER
4. Selecione o "Code" gerado
5. Copie esse dado e cole no Excel

Como obter o Authorization code

Cole os valores de "Authorization code", "Client ID" e "Client Secret" em uma Planilha do Excel, exatamente como mostra na imagem a seguir.

Códigos API Bling na Planilha do Excel

🔹 ETAPA 4: Como obter os Tokens de Acesso usando Excel VBA

Agora que você conseguiu o "Autorization code", a próxima etapa é conseguir os tokens de acessos, ou seja, o Access_token e o Refresh_token. O "Autorization code" gerado anteriormente tme duração de 1 minuto apenas, portanto, você precisa usar o code e executar o codigo antes que o tempo expire.

O código VBA abaixo se encarregará de trazer os os valores Access_token e Refresh_token para dentro das células "B5" e "B6" da planilha do Excel. Este código faz uso de uma biblioteca Json que não existe nativamente no Excel. Baixe o arquivo ao final deste post, pois é uma Planilha Excel que já possui esta biblioteca pronta para uso.

E para atualizar o Access_token, use o código a seguir:

Tokens de acesso - Access_token e Refresh_token

🔹 ETAPA 5: Método POST usando VBA - Como cadastrar um Produto na Bling

O código a seguir implementa uma solução completa para cadastrar produtos na API Bling v3 utilizando VBA no Excel. O sistema gerencia todo o ciclo de autenticação OAuth 2. 0, incluindo obtenção inicial de tokens e sua renovação automática quando expirados. Os dados do produto são coletados diretamente de uma planilha e convertidos em formato JSON para envio via método POST, com tratamento adequado de erros e exibição de mensagens amigáveis ao usuário. Esta implementação representa uma abordagem profissional para integração entre planilhas Excel e sistemas de gestão via API REST.

Planilha com dados de exemplo de um produto

Resultado do cadastro para os campos usados na requisição

🔹 ETAPA 6: Método GET usando VBA - Como consultar vários produtos na Bling

O código a seguir tem como objetivo automatizar a consulta de produtos cadastrados no sistema Bling, utilizando sua API RESTful. Ele realiza uma requisição HTTP GET para obter os dados dos produtos (como ID, nome, código, preço, tipo, situação e formato) e os organiza em uma planilha do Excel para facilitar a visualização e análise. O script também inclui tratamento de erros robusto, especialmente para casos de autenticação expirada, onde é capaz de renovar o token de acesso e repetir a requisição automaticamente. Essa automação elimina a necessidade de consultas manuais no sistema, aumentando a eficiência e reduzindo erros humanos, sendo ideal para integração com processos de gestão de estoque, relatórios ou migração de dados.

Produtos na Plataforma Bling

Produtos no Excel - Consulta VBA

🔹 ETAPA 7: Método PATCH usando VBA - Como alterar um registro de Produto na Bling

O código a seguir utiliza o método HTTP PATCH para atualizar um produto existente na plataforma Bling de forma programática, através da API v3. Desenvolvido em VBA (Excel), ele permite a modificação seletiva de campos (como nome, código, preço, tipo, situação e outros), enviando apenas os dados que precisam ser alterados — uma vantagem do verbo PATCH sobre o PUT, que exigiria o envio do recurso completo. O script começa solicitando o ID do produto via InputBox, garantindo flexibilidade ao usuário, e valida se o valor inserido é numérico. Em seguida, monta um payload JSON apenas com os campos preenchidos na planilha "Cadastrar" (linha 2, colunas 1 a 9) e faz a requisição à API. O tratamento de erros é robusto: identifica falhas de autenticação (401) e tenta renovar o token automaticamente, além de extrair mensagens de erro detalhadas da resposta JSON. Ideal para integrações com sistemas de gestão de estoque ou sincronização de dados, essa solução elimina a necessidade de alterações manuais no sistema Bling, reduzindo erros e economizando tempo.

🔹 ETAPA 8: Método DELETE usando VBA - Como remover um produto na Bling

Aqui está o código VBA para deletar um produto usando a API Bling com o método HTTP DELETE:

📥 Recursos Complementares

Faça o download da Planilha Habilitado para macro, disponibilizada no link abaixo. Ao baixar, lembre-se habilitar as macros e o conteúdo. A Planilha á conta com a biblioteca JSON, bem como com as referencias necessários para que o código JSON seja executado com sucesso.