Como integrar os dados do TOTVS no Visio OS
Para integrar os dados do TOTVS, o caminho público é o das APIs documentadas no TDN e em api.totvs.com.br, consumidas pelo TOTVS API Services, que exige licença de produto compatível e plano contratado na Central do Cliente; do lado do arquivo, a página consultada fala de relatórios do Chef Web em Excel ou CSV (páginas consultadas em 12/10/2026). Levado à camada de Dados do Visio OS, o TOTVS entra por API e o dado fica por loja, com a mesma definição da rede.
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.
A documentação é aberta e o consumo é por contrato
Poder ler a documentação de uma API e poder usá-la são coisas diferentes, e a página do TOTVS API Services deixa a diferença à vista. As APIs estão documentadas no TDN e em api.totvs.com.br, onde qualquer pessoa as encontra. O consumo, porém, depende de duas condições de contrato: uma licença de produto compatível e um plano contratado na Central do Cliente.
Por isso a primeira conversa é contratual antes de técnica, e a pergunta é simples: a licença que temos serve para o consumo, e há plano contratado?
A pergunta de gestão de uma rede passa por mais do que o TOTVS: o extrato bancário, a nota de compra, o delivery, a escala. A camada de Dados do Visio OS recebe o TOTVS como uma dessas fontes, por loja, com cada número definido uma vez pela Visio.
O que o TOTVS documenta
As páginas públicas da TOTVS, em 12/10/2026, trouxeram três fatos.
O primeiro é a API. A página sobre o TOTVS API Services (sobre o TOTVS API Services, consultada em 12/10/2026) diz que as APIs estão documentadas no TDN e em api.totvs.com.br e que o consumo pelo TOTVS API Services exige licença de produto compatível e plano contratado na Central do Cliente.
O segundo é a exportação. A central de atendimento da TOTVS (centraldeatendimento.totvs.com, consultada em 12/10/2026) indica que o Chef Web imprime relatórios em Excel ou CSV. É um fato sobre esse produto. Para outros produtos da TOTVS, não foi possível confirmar o que as páginas consultadas dizem sobre exportação.
O terceiro é uma falta: o TOTVS não publica MCP próprio nas páginas consultadas.
Licença compatível e plano contratado: as duas perguntas da Central do Cliente
Cada condição da página tem um dono dentro do grupo, e vale registrar quem é antes de planejar o código.
- A licença de produto compatível pertence a quem contratou o produto TOTVS que a rede usa. A página não lista quais produtos são compatíveis, e essa lista é uma pergunta para a TOTVS.
- O plano contratado na Central do Cliente é o segundo item. A página não diz o que cada plano inclui.
Num grupo com várias lojas, vale saber se elas compartilham contrato ou têm contratos separados, já que licença e plano são condições do contrato. A permissão por usuário, loja e 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.
Como avaliar o caminho do TOTVS: 6 critérios
- Qual produto TOTVS. A página trata do TOTVS API Services e, na exportação, do Chef Web. Confirme em qual produto a sua rede roda.
- A licença. Ela precisa ser compatível com o consumo. Quem contratou o produto sabe responder.
- O plano. Ele é contratado na Central do Cliente. Registre quem tem acesso a ela.
- O recurso certo. A documentação do TDN diz quais recursos a API cobre; a pergunta escolhe entre eles.
- Por loja. Com mais de um contrato, o dado é separado por loja antes da análise do grupo.
- Quem acompanha. Licença e plano mudam com o contrato, e alguém do grupo precisa acompanhar.
Principais caminhos para integrar os dados do TOTVS
Dois caminhos vêm da TOTVS; o terceiro vale quando eles não servem, e o quarto é a camada.
1. O TOTVS API Services, com licença e plano
É o caminho de programa. A documentação é pública, e o consumo passa pela licença compatível e pelo plano contratado. Quem constrói por aqui lê o TDN, confirma o contrato, monta a leitura e a mantém. O dado do TOTVS chega pela API; receita líquida, cruzamento com o banco e a nota e permissão por loja ficam de fora dela.
2. Os relatórios do Chef Web em Excel ou CSV
É o caminho de arquivo, registrado na página para o Chef Web: quem opera o sistema gera o relatório em Excel ou CSV. A frequência é a dessa pessoa, e o conteúdo de cada relatório não aparece na página consultada. Para outros produtos da TOTVS, o arquivo precisa ser confirmado na tela do sistema.
3. O caminho homologado ou o parceiro integrador
Se a licença não é compatível, se o plano não existe ou se o produto da rede não é o que a página cobre, resta 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 TOTVS.
4. O TOTVS como fonte da camada de Dados do Visio OS
Na camada, o TOTVS é lido por API e o dado fica por loja, na mesma linha do tempo do extrato (Open Finance, com o 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. Os termos de uso e o contrato do sistema valem para a Visio como valem para qualquer um, e quais fontes estão ligadas numa operação é definido no mapeamento daquele cliente.
Quem enxerga o quê depois que o TOTVS entra
Uma rede com muitas lojas não quer que todo mundo veja tudo. Quando o TOTVS entra na camada, a permissão vai junto com o dado, por usuário, por loja e por app, e é aplicada dentro de cada consulta.
O gerente da loja 12 vê as vendas, a escala e o ponto da loja 12 e não vê a folha nem as vendas do grupo. A gestão vê o grupo inteiro. A mesma regra vale para a IA de cada um: ela responde com o login e as permissões de quem pergunta. Quem sai da empresa é desligado uma vez, e não sistema por sistema.
Esse desenho independe do que o TOTVS exige para o consumo. A licença e o plano decidem se o dado sai do TOTVS; a camada decide quem, dentro do grupo, o enxerga depois que ele chega. A IA conectada pelo MCP da Visio lê a métrica já calculada, e o registro de cada consulta fica guardado.
Onde o TOTVS entra no Visio OS
A camada de Dados é a primeira das nove camadas do Visio OS e a base das outras: ela alimenta cada Tool. Sem ela, cada Tool é uma ilha, sem comparação entre lojas e sem ciclo fechado. Por isso o que o TOTVS liberar não serve a uma pergunta só, e passa a servir a todas as Tools que leem a camada. É a licença e o plano do contrato que decidem quanto dessa base chega do TOTVS. O dado fica na nuvem que o grupo já usa, isolado por empresa e cifrado em repouso e no acesso, e o registro de acesso é centralizado.
Comparativo dos caminhos para integrar o TOTVS
Cada coluna é um caminho que as páginas da TOTVS descrevem. Onde elas não dizem, a célula diz que não foi possível confirmar.
| Critério | TOTVS API Services | Relatórios do Chef Web em Excel ou CSV | MCP do fornecedor | Camada de Dados do Visio OS |
|---|---|---|---|---|
| O que expõe | APIs documentadas no TDN e em api.totvs.com.br | Relatórios do Chef Web; o conteúdo, não foi possível confirmar | Não há, nas páginas consultadas | O que o caminho escolhido entrega, estruturado por loja |
| Quem libera | Licença de produto compatível e plano contratado na Central do Cliente | Quem opera o sistema | Não se aplica | A Visio, a partir do mapeamento |
| Formato | Não foi possível confirmar: fica na documentação do TDN | Excel ou CSV | 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 o contrato | A pessoa que gera o relatório | 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 página do TOTVS API Services une duas coisas ao responder «como integrar os dados do TOTVS»: a documentação das APIs, aberta, e a condição de contrato que acompanha o consumo. Para ele, o guia deve começar pela condição, porque licença e plano determinam se o resto do caminho existe para aquela rede.
A posição dele é a de que o leitor ganha ao levar a licença e o plano para a primeira conversa, antes do time técnico abrir o TDN. Ele vê a camada de Dados do Visio OS como o lugar onde o que o TOTVS liberar passa a ser lido por loja e por permissão, ao lado do banco e da nota.
Perguntas frequentes
O TOTVS tem API para integrar os dados?
Sim. A página sobre o TOTVS API Services, consultada em 12/10/2026, diz que as APIs estão documentadas no TDN e em api.totvs.com.br.
Preciso de licença e de plano para usar as APIs do TOTVS?
Segundo a página consultada em 12/10/2026, o consumo pelo TOTVS API Services exige licença de produto compatível e plano contratado na Central do Cliente. A página não lista os produtos compatíveis nem o que cada plano inclui.
Dá para exportar os dados do TOTVS sem usar a API?
Para o Chef Web, sim. A central de atendimento da TOTVS, consultada em 12/10/2026, indica que ele imprime relatórios em Excel ou CSV. Para outros produtos da TOTVS, não foi possível confirmar nas páginas consultadas.
O TOTVS tem MCP oficial?
Nas páginas consultadas em 12/10/2026, o TOTVS não publica MCP próprio. Quem pergunta à IA lê o TOTVS depois que o dado passa pela camada, e o acesso é o MCP da Visio, com o seu login.
E se o caminho do TOTVS na minha operação não estiver claro?
As páginas consultadas tratam do TOTVS API Services e do Chef Web. Se a sua operação usa outro produto da TOTVS, 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 TOTVS entre elas.
- Fale com um especialista sobre o mapeamento das suas fontes
- Fale com um especialista e leve a licença e o plano do TOTVS para a conversa
- Fale com um especialista da camada de Dados do Visio OS
Para ver a camada inteira, abra a página da camada de Dados.
Ver também
- Como integrar os dados do Sankhya
- Como integrar os dados do Linx
- Como integrar os dados da Alterdata
- Como conectar a IA aos dados da minha rede de lojas
Conclusão
Integrar os dados do TOTVS é partir do contrato: a documentação das APIs é aberta, e o consumo pede licença de produto compatível e plano contratado. O Chef Web tem o caminho do arquivo em Excel ou CSV. O que o TOTVS liberar entra numa camada que o estrutura por loja, com a permissão de cada pessoa aplicada no dado, ao lado do banco e da nota.
Dados deixam tudo pronto pra usar. O Visio OS transforma em tarefa certa, pra pessoa certa.