Exportar relatório do Protheus, ajustar colunas no Excel e atualizar o Power BI funciona até o arquivo mudar, o responsável entrar de férias ou duas áreas escolherem filtros diferentes. A integração correta começa definindo qual informação será lida, com qual frequência e qual camada pode receber a carga sem pressionar o ERP.
Protheus não é uma única base genérica: release, módulos, dicionário, campos customizados e exclusão lógica alteram a leitura. Por isso, o caminho mais curto nem sempre é apontar o Power BI diretamente para tabelas operacionais.
Quatro caminhos possíveis
Quando a API REST disponível cobre as entidades e o histórico necessário, ela preserva autenticação e um contrato de dados. O framework do Protheus documenta APIs REST, token OAuth e consulta genérica, mas cada endpoint precisa ser verificado contra a LIB e a configuração instaladas.
Outras opções são uma réplica ou usuário de banco estritamente de leitura, datasets ou objetos do Smart View, e exportações agendadas para uma área intermediária. Para grande volume histórico, uma carga incremental para um banco analítico costuma ser mais previsível do que centenas de consultas do relatório contra a produção.
Modelo de dados antes do dashboard
Um painel comercial normalmente relaciona pedido, item, cliente, vendedor, produto e documento fiscal. Não basta juntar SC5, SC6 e SA1: é preciso respeitar filial, exclusão lógica, chaves compostas, status e o caminho entre pedido, liberação e faturamento. Campos customizados devem entrar no dicionário do projeto.
O modelo analítico guarda dimensões estáveis e fatos em granularidade declarada. Pedido e faturamento não podem ser somados como se fossem o mesmo evento. A medida de carteira usa itens abertos; a de receita usa documento emitido conforme regra contábil aprovada.
Atualização incremental e desempenho
Em vez de reler anos de movimento, a carga mantém uma marca de última alteração, busca uma janela de segurança e reaplica registros por chave. Exclusões lógicas e alterações retroativas exigem reconciliação periódica. O processo registra início, fim, volume e maior data efetivamente carregada.
Se a origem for banco, consultas pesadas devem rodar na réplica ou em horários acordados e usar índices compatíveis. Se for API, paginação, limite, expiração de token e retentativa precisam estar no conector, não escondidos no Power Query de cada analista.
Homologação dos indicadores
Cada medida precisa fechar com uma referência conhecida: faturamento de um dia, carteira de um vendedor, saldo de um produto e uma nota específica. Divergências são documentadas por regra, e não corrigidas com filtros invisíveis no painel.
Também definimos segurança por filial ou área, credenciais do gateway, horário de atualização e aviso de dado atrasado. O usuário deve saber se está vendo 8h00 de hoje ou o fechamento de ontem.
Escopo inicial recomendado
Comece com uma decisão, como acompanhar carteira e faturamento por vendedor, e com um período suficiente para validar mudanças de status. Mapeamos release, banco homologado, dicionário SX, customizações e disponibilidade de REST, Smart View ou réplica.
O resultado do piloto deve ser um pipeline reutilizável, um dicionário de medidas e um painel conciliado. Depois, estoque, compras ou financeiro podem reaproveitar a mesma camada sem criar outra verdade paralela.