Power BI com Sankhya: painéis de vendas, compras e estoque

Para montar painéis de vendas, compras e estoque com Power BI e Sankhya, o modelo precisa ler cinco grupos de tabelas do Sankhya Om: o cabeçalho e os itens de notas e pedidos (TGFCAB e TGFITE), os tipos de operação (TGFTOP), a ligação entre pedido e nota (TGFVAR) e o saldo de estoque (TGFEST), com os cadastros de produtos e parceiros como dimensões. O visual é a parte fácil. No Sankhya, pedido de venda, nota de venda, compra e devolução ficam todos na mesma tabela de cabeçalho, e quem separa um do outro é o tipo de operação. Um painel que soma a TGFCAB sem filtrar a operação certa conta a mesma venda duas vezes, uma no pedido e outra na nota. O acesso aos dados também pede atenção: para clientes a partir de fevereiro de 2023, a Sankhya considera a integração direta com o banco fora das suas diretrizes e indica o API Gateway.
TOP (tipo de operação) é o cadastro do Sankhya que parametriza cada movimento: se é entrada ou saída, se mexe no estoque, se gera financeiro, entre outras regras. Ela fica na tabela TGFTOP e se liga a cada nota e pedido pelo campo CODTIPOPER do cabeçalho.
Quais tabelas do Sankhya entram no painel?
Os nomes abaixo aparecem na documentação de operações comerciais do portal de desenvolvedores da Sankhya, consultada em novembro de 2026. Customizações e campos adicionais mudam de uma base para outra, então use a lista como ponto de partida do mapeamento, e não como dicionário fechado.
- TGFCAB (cabeçalho): uma linha por pedido ou nota, identificada pelo número único NUNOTA, com parceiro (CODPARC), vendedor (CODVEND), tipo de operação (CODTIPOPER), data de negociação (DTNEG), valor e status.
- TGFITE (itens): os produtos de cada documento, ligados ao cabeçalho pelo NUNOTA e pela sequência, com quantidade negociada (QTDNEG), preço unitário (VLRUNIT) e valor total.
- TGFTOP (tipos de operação): a parametrização de cada movimento, com o tipo de movimento (TIPMOV) e as indicações de que a operação atualiza estoque ou financeiro.
- TGFVAR (ligações entre documentos): guarda de qual documento de origem nasceu cada documento de destino, como orçamento e pedido, pedido e nota, nota e devolução.
- TGFEST (estoque): a quantidade de cada produto por empresa e local, com a parte reservada em campo próprio.
- TGFPRO e TGFPAR (cadastros): produtos e parceiros, clientes e fornecedores no mesmo cadastro. Viram dimensões do modelo junto com vendedor (TGFVEN), empresa e calendário.
Por que as vendas aparecem em dobro no painel?
É o erro mais comum no primeiro painel feito sobre o Sankhya. Como o pedido de venda e a nota que o fatura moram na TGFCAB, a consulta que soma o valor de todos os documentos do mês junta as duas coisas. O filtro tem de vir da TOP: o painel de faturamento lê só as operações de venda que emitem nota, e o painel de carteira lê só os pedidos. O campo TIPMOV ajuda nessa separação, mas cada empresa cria e usa as suas TOPs. O jeito seguro é montar, com o comercial e o fiscal, uma tabela que classifica cada TOP ativa como venda, devolução, pedido, compra, transferência ou outra.
Três cuidados completam esse filtro:
- A TOP tem histórico: a TGFTOP guarda uma versão da parametrização a cada alteração, com a data no campo DHALTER. A ligação certa com o cabeçalho usa o código e essa data (CODTIPOPER e DHTIPOPER). Ligar só pelo código multiplica as linhas de toda TOP que já foi alterada alguma vez.
- Nem todo documento está confirmado: nota pendente ainda pode ser alterada ou excluída. O faturamento do painel deve considerar só o status que a empresa trata como confirmado, ou o número de hoje muda amanhã sem ninguém saber por quê.
- Pedido faturado em partes: a própria documentação da Sankhya lembra que um pedido pode virar várias notas. A carteira em aberto sai da diferença entre a quantidade pedida e a soma do que já foi faturado nas notas ligadas a ele pela TGFVAR.
A junção que respeita o histórico da TOP fica assim, numa consulta de extração ou na camada que recebe os dados:
SELECT
C.NUNOTA, C.DTNEG, C.CODPARC, C.CODVEND,
T.DESCROPER, T.TIPMOV,
I.SEQUENCIA, I.CODPROD, I.QTDNEG, I.VLRTOT
FROM TGFCAB C
JOIN TGFTOP T
ON T.CODTIPOPER = C.CODTIPOPER
AND T.DHALTER = C.DHTIPOPER
JOIN TGFITE I
ON I.NUNOTA = C.NUNOTAOs filtros de período, de status e de TOP entram depois, com a sintaxe de data do banco da sua instalação.
Como fica o filtro de TOP em um exemplo?
Os números a seguir foram montados para mostrar o problema e não vêm de nenhum cliente. Uma distribuidora registrou em outubro 1.100 pedidos de venda, que somaram R$ 4,6 milhões, e emitiu R$ 4,1 milhões em notas de venda. No mesmo mês teve R$ 180 mil em devoluções e R$ 350 mil em transferências entre filiais, que também geram nota.
A consulta que soma a TGFCAB do mês sem olhar a TOP mostra R$ 9,23 milhões, mais que o dobro do real. Filtrando só as notas de venda, o painel mostra R$ 4,1 milhões, e tirando as devoluções, R$ 3,92 milhões de faturamento líquido. Os R$ 500 mil entre pedidos e notas são, em boa parte, carteira ainda não faturada, que merece uma página própria com a idade de cada pedido. Divergências assim derrubam a confiança no painel logo na primeira reunião, como contamos em por que os números do Power BI não batem com o ERP.
Como conectar o Power BI ao Sankhya?
A orientação oficial pesa nessa escolha. Nas boas práticas de integração da Sankhya, integrações pelo banco de dados estão em desacordo com as diretrizes para clientes a partir de 1º de fevereiro de 2023, e o caminho indicado é o API Gateway. O motivo declarado é que o acesso direto passa por fora das regras de negócio do ERP e deixa o banco inteiro exposto, inclusive folha de pagamento e fluxo de caixa.
- API Gateway com carga para uma base central: um processo agendado se autentica no gateway (OAuth com client credentials e um token gerado no próprio Sankhya Om), lê as entidades em páginas e grava os dados num banco ou data warehouse da empresa. O Power BI lê dessa base. É o caminho alinhado com a Sankhya e o que permite cruzar o ERP com planilhas, e-commerce ou sistemas de transporte.
- Leitura de uma cópia do banco: em instalações antigas ainda há painéis lendo uma réplica com usuário somente leitura. Antes de seguir por aí, confirme com a Sankhya, e com o seu contrato, se isso vale para o seu caso.
- Dashboards do próprio Sankhya Om: o ERP tem dashboards configuráveis. Para um indicador que usa só dados do ERP e é visto por quem já trabalha nele, isso pode bastar.
O limite publicado do gateway é de 1.000 requisições por minuto, com até 10 MB por requisição. Para um painel atualizado algumas vezes por dia, sobra folga, desde que a carga traga só o que mudou desde a última execução em vez de reler todo o histórico a cada vez.
O que mostrar em cada painel?
- Vendas: faturamento líquido de devoluções por vendedor, cliente, produto e grupo, margem quando o custo do produto é confiável, e a carteira de pedidos em aberto com a idade de cada um.
- Compras: pedidos de compra emitidos e ainda não recebidos, prazo entre o pedido e a nota de entrada por fornecedor e a evolução do preço pago em cada item.
- Estoque: saldo disponível (estoque menos reservado) por empresa e local, cobertura em dias pela média de vendas e itens sem saída há mais de 90 dias.
O painel de margem segue a mesma lógica de margem por produto, cliente e vendedor no Power BI para distribuidoras. No Sankhya, o vendedor já vem no cabeçalho da nota, o que poupa uma ligação.
Como montar o projeto, passo a passo?
- Classificar as TOPs: listar as operações usadas nos últimos dois anos e marcar cada uma como venda, devolução, pedido, compra, transferência, remessa ou outra, junto com o comercial e o fiscal.
- Definir o acesso: pedir as credenciais do gateway, criar um usuário técnico com permissão só de leitura nas tabelas necessárias e combinar a frequência da carga.
- Montar a base central: carga incremental de cabeçalhos, itens, ligações e estoque, guardando o dado como veio do ERP.
- Modelar: fatos de vendas, compras, carteira e estoque, com produto, parceiro, vendedor, empresa e calendário como dimensões.
- Conferir com o ERP: comparar o faturamento de um mês fechado com o relatório oficial do Sankhya, empresa por empresa, antes de publicar.
- Combinar a rotina: definir quem olha cada painel, em que reunião e quem responde quando um número parecer errado.
Se a sua empresa usa o Sankhya e os números de vendas, compras e estoque ainda saem de exportações para o Excel, fale com um especialista da Insight Pro em integração com Sankhya. No diagnóstico gratuito do serviço de Engenharia de Dados, revisamos com você as TOPs ativas e a forma de acesso disponível no seu ambiente, testamos a ligação entre pedido e nota com uma amostra real e mostramos quais painéis podem entrar no ar primeiro, com prazo e investimento. Para conversar, use o formulário de contato.
Leia também




