Um dashboard Sankhya não começa no gráfico. Ele começa escolhendo a origem, entendendo entidades como TGFCAB, TGFITE e TGFVAR e definindo se o indicador representa pedido, faturamento, financeiro ou estoque.
O Power BI pode consumir uma camada preparada por API, banco analítico ou arquivo agendado. A melhor opção depende de volume, licença, frequência e liberdade para criar views sem prejudicar a base operacional.
Opções oficiais de extração
O serviço loadRecords consulta entidades mapeadas, como Produtos/TGFPRO e Parceiros/TGFPAR, com filtros e campos explícitos. Para uma view preparada, loadView permite consultar a estrutura, mas a documentação alerta que não há paginação nativa; o integrador deve implementar a janela de linhas e cuidar do desempenho.
O Extrator de Dados do Sankhya também exporta Excel, XML, JSON ou CSV para download ou repositório e pode atender um relatório diário com menor complexidade. A escolha não deve ser guiada por tempo real se a decisão só ocorre uma vez por dia.
Modelo comercial que não duplica números
A documentação das operações comerciais identifica TGFCAB como cabeçalho, TGFITE como itens e TGFVAR como ligação entre documentos de origem e destino. Um pedido pode gerar várias notas; somar cabeçalho de pedido com nota sem esse relacionamento duplica valor.
O modelo analítico separa fatos por granularidade e mantém dimensões de parceiro, produto, empresa, vendedor, natureza e centro de resultado. Medidas declaram se usam data de negociação, faturamento, vencimento ou baixa.
Carga incremental
Endpoints recentes oferecem modifiedSince em algumas entidades, condicionado ao Log de Alterações. Onde isso não existe, usamos data de alteração, janela móvel ou reconciliação por período. O pipeline aplica upsert por chave e reprocessa alguns dias para capturar mudanças atrasadas.
A carga registra quantidade lida e gravada, maior timestamp, falhas e duração. Token, paginação e limite ficam centralizados; os relatórios não repetem credenciais e chamadas independentes.
Power BI, gateway e segurança
A camada tratada pode estar em SQL, data warehouse ou arquivos versionados. Power BI recebe tabelas enxutas e medidas homologadas. Se a fonte estiver em rede privada, o gateway usa conta de serviço e atualização agendada.
Permissões por empresa, filial ou área precisam existir tanto na extração quanto no modelo. Exportar toda a base e esconder colunas no visual não é uma política de segurança.
Primeiro painel
Escolha uma pergunta, como carteira versus faturamento e margem por vendedor. Valide totais com consultas do ERP e amostras de documentos ligados por TGFVAR antes de publicar.
No diagnóstico, avaliamos versão, autorização de API, entidades, views existentes, volume e frequência. O resultado inclui pipeline, dicionário de indicadores, alertas de atualização e painel, não apenas um arquivo PBIX.