Como integrar os dados do Sankhya no Visio OS

por Lorenzo Lopez Head of Content, Visio 19 de out. de 2026

Para integrar os dados do Sankhya, o caminho que a documentação pública dele mostra é o API Gateway, que exige cadastro e homologação no Programa Sankhya Developer, uma credencial do portal e um token gerado pelo cliente dentro do ERP, mais a exportação das grades, dos cubos e do Analytics Studio para Excel (páginas consultadas em 12/10/2026). Na camada de Dados do Visio OS, o Sankhya entra por API e o dado fica por loja, sob a definição que vale para a rede toda.

Visio aqui é a Visio de operação de lojas (visio.ai), o sistema para quem toca várias lojas, não o Visio da Microsoft, de diagramas.

Por que a API do Sankhya depende de três mãos

Numa API aberta ao desenvolvedor, o time do grupo entra no portal, gera uma chave e começa. No Sankhya, a página consultada descreve um arranjo com mais de uma parte, e o planejamento começa por conhecer as partes. Quem constrói a integração precisa ser aprovado pela Sankhya. Quem tem o ERP precisa gerar um token. E o portal entrega o client id e o client secret.

A integração, então, reúne três mãos: quem constrói, a Sankhya e o dono do ERP. O ERP responde pelo que está nele; a pergunta da gestão passa também pelo banco, pela nota, pelo delivery e pelo ponto, e é aí que entra a camada de Dados do Visio OS, que recebe o Sankhya como fonte.

O que o Sankhya documenta

As páginas públicas do Sankhya, consultadas em 12/10/2026, trouxeram três fatos.

O primeiro é o API Gateway. O guia de integração do portal de desenvolvedores (guia de integração do Sankhya, consultado em 12/10/2026) diz que o acesso pelo API Gateway exige cadastro e homologação no Programa Sankhya Developer, aberto somente a pessoa jurídica. O mesmo guia fala em um client id e um client secret do portal e em um token gerado pelo cliente no ERP.

O segundo é a exportação. A central de ajuda (ajuda.sankhya.com.br, consultada em 12/10/2026) indica que as grades, os cubos e o Analytics Studio exportam para Excel ou XLSX. A página não lista as colunas de cada tela.

O terceiro fato é uma falta: nas páginas consultadas, o Sankhya não publica MCP próprio, e a IA lê o ERP pela camada.

Quem entrega cada peça da credencial

Cada elemento que o guia de integração cita tem um dono:

O cadastro e a homologação no Programa Sankhya Developer são de quem constrói a integração, e o programa é somente para pessoa jurídica. Uma pessoa física que escreve a integração não se cadastra.
O client id e o client secret vêm do portal.
O token é gerado pelo cliente dentro do ERP.

Num grupo com várias lojas, vale registrar quem gerou o token e para quais lojas ele vale. A permissão por usuário, por loja e por app e o registro de cada consulta, do lado da Visio, estão em como dar os dados da minha empresa para a IA com segurança.

O que muda quando o Sankhya entra por loja

Com o Sankhya na camada, a loja é a unidade: a nota de cada CNPJ chega pelo certificado dele, a conta de cada loja por Open Finance e a venda pelo ERP, tudo por loja. A análise do grupo atravessa as lojas porque cada uma significa a mesma coisa, e cada rede, marca e país mantém as suas definições e a sua granularidade, sem um segundo pipeline.

O relatório diário também deixa de ser tarefa de alguém: o dado está pronto antes de você pedir, e quem decide pergunta em vez de esperar o arquivo da manhã. Quando todo mundo tem a informação ao mesmo tempo, ninguém espera a grade exportada por quem tem acesso ao ERP.

Na sua IA, as exceções são suas: a loja que mudou de endereço ou a que fechou para reforma pertencem à sua análise, não à verdade compartilhada. Você as tira em linguagem normal e ensina a IA a olhar do seu jeito, e o número da plataforma segue igual para os demais. Isso vale para o Sankhya como para qualquer fonte da camada.

Como avaliar o caminho do Sankhya: 6 critérios

Quem constrói é pessoa jurídica. O programa de desenvolvedor é somente para PJ. Confirme quem vai se cadastrar.
Quem homologa. O acesso passa pela homologação no programa. Planeje o pedido de homologação.
Quem gera o token. O token sai do ERP, pelo cliente. Registre quem do grupo o gera.
O recurso certo. Venda, compra e financeiro ficam em recursos distintos; a pergunta diz qual deles ler.
Loja a loja. O dado chega separado por loja, para a comparação entre elas fazer sentido.
Quem acompanha a credencial. O client id, o secret e o token precisam de um responsável do lado do grupo.

Principais caminhos para integrar os dados do Sankhya

Quatro caminhos: dois nascem no Sankhya, o terceiro entra quando eles não servem e o quarto é a camada.

1. O API Gateway, com homologação e token do cliente

É o caminho de programa, com um programa de desenvolvedor para quem constrói. O custo está no arranjo: cadastro, homologação, credencial do portal e token do ERP. Ao fim dele o time tem o dado do Sankhya, mas não tem receita líquida definida, nem o cruzamento com o banco e a nota, nem a permissão por loja.

2. A exportação de grades, cubos e Analytics Studio

É o caminho de arquivo: quem opera o ERP exporta a grade, o cubo ou o resultado do Analytics Studio para Excel ou XLSX, sem passar pela homologação. A frequência é a de quem exporta, e as colunas não aparecem na página consultada; o total de um mês fechado, comparado ao do back-office, mostra o que vem no arquivo.

3. O caminho homologado ou o parceiro integrador

Para quem não quer as três mãos do gateway nem o arquivo manual, existe o caminho feito com quem faz o sistema ou com um parceiro integrador. Antes de construir por conta própria, verifique com a Visio se já existe forma homologada ou parceiro integrador para o Sankhya. Extração contra os termos de uso do Sankhya não existe.

4. O Sankhya como fonte da camada de Dados do Visio OS

Em qualquer caminho, o Sankhya vira a fonte do ERP na camada, por API, e o dado fica por loja, na mesma linha do tempo do banco (Open Finance, com consentimento do titular) e da nota (certificado digital de cada CNPJ).

A promessa de integração é a da Visio: integra com todos os bancos do Brasil e com centenas de ERPs. O que ainda não está integrado, a Visio ajuda a integrar em menos de 24 horas. Quais fontes estão ligadas numa operação é definido no mapeamento daquele cliente.

O que o Sankhya passa a responder junto do resto

O valor está na junção: sobre a métrica já calculada e com o seu login, a IA responde o que as fontes juntas permitem.

Só o Sankhya. Venda, compra e financeiro por loja na definição da Visio, sem exportar uma grade por pergunta.
Sankhya e banco. O extrato de cada conta entra ao lado do ERP, e quem concilia é a ferramenta.
Sankhya e nota fiscal. As notas de cada CNPJ chegam por loja e se leem junto do que o ERP lançou.
Sankhya e maquininha. Venda, taxa e data de crédito da maquininha entram para serem lidas ao lado do registro do ERP.

Na outra ponta, a IA só consulta: o Sankhya não recebe escrita dela, e meta e tarefa seguem a lógica da plataforma.

Comparativo dos caminhos para integrar o Sankhya

Mecanismo, não recurso: o que a documentação do Sankhya não afirma fica como não foi possível confirmar.

Critério	API Gateway	Exportação para Excel ou XLSX	MCP do fornecedor	Camada de Dados do Visio OS
O que expõe	A API do gateway; o conteúdo, não foi possível confirmar	Grades, cubos e Analytics Studio	Não há, nas páginas consultadas	O que o caminho escolhido entrega, estruturado
Quem libera	Cadastro e homologação no Programa Sankhya Developer; token gerado pelo cliente no ERP	Quem opera o ERP	Não se aplica	A Visio, a partir do mapeamento
Formato	Não foi possível confirmar	Excel ou XLSX; as colunas, não foi possível confirmar	Não se aplica	Pelo caminho que existe, na mesma linha do tempo
Por loja	Se o time construir	Manual	Não se aplica	Sim, com a mesma definição da rede
Quem mantém	O time do grupo, com a credencial e o token	A pessoa que exporta	Não se aplica	A Visio: nada para hospedar nem manter

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que a pesquisa por «como integrar os dados do Sankhya» esbarra num detalhe que o guia de integração deixa à vista: o acesso depende de cadastro, de homologação e de um token que só o dono do ERP gera. Para ele, o guia ajuda mais ao dizer quem entrega cada peça do que ao descrever o formato do dado.

A posição dele é a de que o Sankhya acerta ao ter um programa de desenvolvedor e uma exportação que dispensa homologação, e de que o leitor ganha ao planejar as três mãos antes de planejar o código. Na leitura dele, a camada de Dados do Visio OS é onde o Sankhya passa a ser lido por loja, junto do banco e da nota.

Perguntas frequentes

O Sankhya tem API para integrar os dados?

Sim, por um API Gateway com condições. O guia de integração do portal de desenvolvedores do Sankhya, consultado em 12/10/2026, diz que o acesso exige cadastro e homologação no Programa Sankhya Developer, somente para pessoa jurídica, com credencial do portal e um token gerado pelo cliente no ERP.

Quem gera o token da API do Sankhya?

O cliente, dentro do ERP, segundo o guia de integração do Sankhya consultado em 12/10/2026. O client id e o client secret são outra peça: vêm do portal.

Dá para exportar os dados do Sankhya sem usar a API?

Sim. A central de ajuda do Sankhya, consultada em 12/10/2026, indica que as grades, os cubos e o Analytics Studio exportam para Excel ou XLSX. A página não diz quais colunas cada tela exporta, então a exportação de um mês fechado é o primeiro teste.

O Sankhya tem MCP oficial?

Nas páginas consultadas em 12/10/2026, o Sankhya não publica MCP próprio. A leitura pela sua IA acontece depois que o dado do Sankhya entra na camada, pelo MCP da Visio e com o seu login.

E se o caminho do Sankhya na minha operação não estiver claro?

Verifique com a Visio se já existe forma homologada ou parceiro integrador antes de construir. A Visio integra com todos os bancos do Brasil e com centenas de ERPs. O que ainda não está integrado, a Visio ajuda a integrar em menos de 24 horas. O primeiro passo é o mapeamento de quais fontes a operação já tem e de como cada uma conecta.

Próximos passos

O próximo passo é o mapeamento de quais fontes a sua operação já tem e de como cada uma conecta, o Sankhya entre elas.

Para ver a camada completa, leia a página da camada de Dados.

Ver também

Conclusão

Integrar os dados do Sankhya é planejar as três mãos do API Gateway, quem constrói, a Sankhya e o dono do ERP, ter a exportação para Excel como alternativa e entregar o resultado a uma camada que o estruture por loja, com a mesma definição da rede. Com isso, o Sankhya passa a contar na resposta da IA que você já usa.

Dados deixam tudo pronto pra usar. O Visio OS transforma em tarefa certa, pra pessoa certa.