Como integrar o TOTVS (Protheus, RM, Datasul) ao Power BI

O ERP está cheio de dado, mas a diretoria continua pedindo planilha#

Se a sua empresa roda no TOTVS (Protheus, RM ou Datasul), o dado da operação inteira já está lá: vendas, estoque, financeiro, compras, produção. O problema é tirar isso do ERP e transformar em painel que a gestão olha toda semana, sem alguém exportar relatório e montar planilha na mão. Este artigo explica os caminhos reais de integração do TOTVS com o Power BI, os cuidados específicos do Protheus e como chegar a dashboards em que a diretoria confia.

Por onde o Power BI conversa com o TOTVS#

Existem três caminhos, do mais direto ao mais robusto:

1. Direto no banco de dados#

O TOTVS roda sobre um banco relacional (normalmente SQL Server ou Oracle). O Power BI se conecta direto a esse banco e lê as tabelas. É o caminho mais usado por dar acesso a todo o dado, com desempenho bom quando bem modelado. Para o Power BI na nuvem alcançar um banco que está na sua rede, usa-se o gateway de dados on-premises.

2. Pelas APIs do TOTVS#

O TOTVS expõe APIs REST e serviços de integração. É um caminho mais governado (respeita as regras do ERP) e útil quando você não quer, ou não pode, acessar o banco direto. Em troca, costuma cobrir um recorte do dado, não o banco inteiro.

3. Por um data warehouse (o mais robusto)#

Em vez de o Power BI bater direto no ERP toda hora, um processo de ETL leva o dado do TOTVS para um data warehouse (no Azure, no Microsoft Fabric ou em SQL Server). O Power BI lê do warehouse. Isso protege o ERP de carga, guarda histórico e permite cruzar o TOTVS com outras fontes. É o caminho para ambientes maiores e para quem quer uma base de dados de verdade.

O detalhe que trava quem tenta sozinho: as tabelas do Protheus#

Aqui está o que diferencia um projeto bem feito de uma dor de cabeça. O Protheus não guarda o dado em tabelas com nomes óbvios. Ele usa códigos: clientes ficam na SA1, produtos na SB1, itens de nota de saída na SD2, e assim por diante. Cada campo também tem um código (como A1_NOME). Sem conhecer essa estrutura e o dicionário de dados (as tabelas SX2 e SX3, que descrevem tabelas e campos), você monta um relatório que parece certo e entrega número errado.

Além disso, há particularidades que precisam de cuidado:

• Filial e compartilhamento: o Protheus separa dado por filial, e ignorar isso soma o que não devia.
• Registros deletados: o campo D_E_L_E_T_ marca exclusão lógica; esquecer dele conta lançamento que não existe mais.
• Regras de negócio no ERP: muito cálculo (imposto, custo, saldo) segue a lógica do Protheus, que precisa ser reproduzida com fidelidade.

O RM e o Datasul têm as suas próprias estruturas, cada um com a sua lógica. Em todos, o segredo é o mesmo: modelar com quem conhece a tabela certa, não sair puxando campo pelo nome que parece.

O que dá para enxergar (casos de uso)#

Com o TOTVS integrado ao Power BI, a gestão passa a acompanhar em tempo de agir:

• Comercial: venda por filial, vendedor, produto e cliente, com margem real.
• Financeiro: contas a pagar e receber, fluxo de caixa, inadimplência.
• Estoque e compras: giro, cobertura, ruptura e custo de aquisição.
• Produção (Datasul/Protheus manufatura): ordens, apontamento e eficiência.
• Painel da diretoria: os indicadores do negócio inteiro em uma só tela confiável.

Os cuidados que evitam retrabalho#

1. Não sobrecarregue o ERP. Consultas pesadas direto no banco de produção derrubam o desempenho de quem usa o Protheus. Por isso o data warehouse ou janelas de atualização bem planejadas.
2. Atualização incremental. Recarregar tudo toda vez não escala. Trazer só o que mudou mantém o painel rápido.
3. Fonte única de verdade. Modelar uma vez, com as regras certas, e servir a todos, em vez de cada área puxar o seu número de um jeito.
4. Governança e acesso. Dado financeiro e de cliente pede controle de quem vê o quê (RLS) e adequação à LGPD.

Como a Fynx faz#

A Fynx é Microsoft Solutions Partner (Data & AI) e integra o TOTVS ao Power BI com o cuidado que o ERP exige: conhecemos a estrutura de tabelas do Protheus, do RM e do Datasul, respeitamos filial, exclusão lógica e as regras de negócio, e montamos a fonte única de verdade, direto no banco, por API ou com data warehouse no Azure e no Microsoft Fabric, conforme o seu caso. O resultado é o dashboard que a diretoria usa, batendo com o ERP. É parte da nossa implantação de Power BI e da engenharia de dados, e a manutenção contínua entra no Fynx Care.

Quer ligar o seu TOTVS ao Power BI sem número errado? Conte o seu cenário (qual produto, qual banco, o que precisa enxergar) e devolvemos um plano. Fale com a gente.