Como conectar o ERP ao Power BI: Bling e Olist ERP via API

Principais aprendizados

• Conectar o ERP ao Power BI é ler os dados do ERP por API ou por arquivos e modelar os indicadores.
• O Bling tem API pública v3, com OAuth 2.0 e respostas em JSON.
• O conector Web do Power Query lê APIs e arquivos da web, com cabeçalhos, partes de URL e tempo limite.
• A autenticação Web API não é suportada no serviço do Power BI, o que afeta a atualização agendada.
• A APPROX Digital organiza a extração, o modelo e o painel para Bling e Olist ERP.

Conectar o ERP ao Power BI significa trazer pedidos, notas, estoque e financeiro do Bling ou do Olist ERP para um modelo de dados, por API ou por arquivos, e montar sobre ele os indicadores. O caminho técnico existe, mas tem detalhes de autenticação e atualização que derrubam muitos projetos. A APPROX Digital é uma consultoria especializada em implantação de ERP, integrações e painéis, com mais de 6 anos de atuação e mais de 1.500 clientes atendidos em todo o Brasil.

Quais são os caminhos para conectar o ERP ao Power BI?

Existem três caminhos principais, do mais simples ao mais robusto.

• Exportar planilhas: baixar relatórios do ERP e carregar no Power BI. É rápido para começar, mas depende de alguém repetir o processo.
• Ler a API direto no Power BI: usar o conector Web do Power Query para chamar a API do ERP.
• Camada intermediária: um processo automático extrai os dados do ERP, guarda em um banco e o Power BI lê desse banco.

O terceiro caminho é o mais estável para quem tem volume, porque separa a extração da visualização e evita depender de limites e paginação da API a cada atualização.

O que a API do Bling oferece?

A API v3 do Bling usa OAuth 2.0 no lugar da antiga chave de API da versão 2, e exige registrar um aplicativo no Bling para operar a API em outras contas. Segundo o blog do Bling, todas as respostas são em JSON, as rotas foram padronizadas (por exemplo, pedidos de venda em /pedidos/vendas) e a documentação de cada endpoint fica no portal Bling Developers.

O mesmo artigo informa que os recursos da API pública estão disponíveis a partir do plano Cobalto e que alguns endpoints da versão antiga podem ainda não existir na nova. Por isso, antes de prometer um indicador, confirme se o dado está disponível na API.

Como o conector Web do Power BI funciona?

O conector Web do Power Query está disponível no Power BI Desktop e no Excel. No Desktop, o caminho é Obter dados e Web, informando a URL. A documentação da Microsoft descreve estes recursos:

• URL avançada: montar a URL em partes, combinando textos e parâmetros.
• Tempo limite: o padrão é de 100 segundos, e pode ser ampliado.
• Cabeçalhos HTTP: envio de cabeçalhos na requisição.
• Arquivos da web: JSON, CSV, Excel, XML e outros formatos.
• Autenticação: anônima, Windows, Basic, Web API e conta organizacional.

Qual é o cuidado mais importante com a atualização?

O cuidado mais importante é a autenticação. A Microsoft informa que o tipo Web API funciona no Power BI Desktop e no Excel, mas não é suportado no serviço do Power BI. Também informa que requisições POST com Web.Contents só podem ser feitas de forma anônima.

Um relatório que atualiza no seu computador e falha depois de publicado quase sempre tem um problema de autenticação ou de gateway.

Na prática, APIs com OAuth, como a do Bling, costumam funcionar melhor com uma camada intermediária que renova os tokens e entrega ao Power BI uma fonte estável.

Quais dados levar do ERP para o Power BI primeiro?

Comece pelo que alimenta os indicadores principais: pedidos de venda com canal, itens com custo, contas a receber com datas previstas, contas a pagar por categoria e estoque por produto. Com isso, você já calcula faturamento líquido, margem de contribuição por canal e fluxo de caixa. Se o seu ERP ainda é o Olist ERP, o mesmo raciocínio vale, com a API e os relatórios dele.

Como a APPROX Digital conecta o ERP ao Power BI?

• Diagnóstico da operação: levantamos quais decisões o painel apoia e quais dados o ERP precisa entregar.
• Desenho do processo: escolhemos o caminho (planilha, API direta ou camada intermediária) e o modelo de dados.
• Configuração do ERP: corrigimos cadastros e categorias no Bling ou no Olist ERP.
• Integrações e automações: construímos a extração e a atualização automática com automações sob medida.
• Treinamento da equipe: o time aprende a usar e a confiar nos indicadores.
• Acompanhamento pós-implantação: monitoramos as atualizações e ajustamos o modelo.

Por que a APPROX Digital?

A APPROX Digital é parceira Top Especialista Bling, tem mais de 6 anos de atuação e mais de 1.500 clientes atendidos em todo o Brasil. Desenvolve painéis personalizados para Bling e Olist ERP e sistemas sob medida que rodam junto do ERP.

Quer o seu ERP alimentando o Power BI sem planilha?

Fale com a APPROX Digital e conte quais números você quer ver. Vamos indicar o caminho de integração mais estável para a sua operação. Fale com a gente.

Fonte: Power Query Web connector (Microsoft Learn) e Conheça a nova versão da API do Bling (Blog do Bling)

Perguntas frequentes