Como integrar os dados da SULTS no Visio OS

por Lorenzo Lopez Head of Content, Visio 1 de nov. de 2026

Os dados da SULTS entram na camada de Dados do Visio OS pelo caminho que a documentação do fornecedor descreve: uma API REST pública, com token gerado pelo usuário administrador em Segurança > API > Gestão de Tokens, e cada versão com token e URL base próprios. A partir daí, o que a SULTS registra por loja passa a ficar na mesma linha do tempo da venda, do banco e da nota, e a IA que você já usa lê o conjunto pelo MCP da Visio, com o seu login.

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 importa integrar os dados da SULTS ao resto da operação

Uma rede que roda SULTS tem lá dentro o registro de unidades, chamados, checklist, compras, implantação, projetos e expansão, como a documentação da versão 1 da API lista. Nenhuma dessas trilhas responde sozinha à pergunta que a gestão faz: se a loja que abriu chamados vendeu menos, se a unidade que atrasou a implantação demorou mais para bater a meta, se a compra da semana conversa com o que o PDV registrou.

O dado existe, mas mora num sistema. Do lado de fora dele, o caminho curto é exportar e colar numa IA, e sobre uma exportação a IA inventa a junção entre arquivos, lê o arquivo inteiro e responde com convicção. Duas pessoas chegam a dois números, o arquivo morre na máquina de alguém e a próxima pergunta recomeça a extração.

Integrar a fonte muda a natureza da pergunta. Em vez de pedir a três pessoas três versões do mesmo número, a gestão pergunta à operação na IA que já usa, com as permissões de quem pergunta, e a resposta vem da camada, com a definição de cada número escrita uma vez. A loja é a unidade: o que a SULTS registra por unidade fica ao lado do que o PDV vendeu, do que o banco mostrou e do que a nota comprovou, na mesma linha do tempo.

Como avaliar o caminho do SULTS: 5 critérios

Cinco critérios mostram o que o caminho de acesso do SULTS entrega antes de qualquer decisão, e onde a página pública do fornecedor consultada em 22/10/2026 não traz o fato, o critério vira pergunta para o mapeamento.

Quem libera o acesso. A página descreve o usuário administrador gerando o token em Segurança > API > Gestão de Tokens. Quem tem esse perfil na sua operação se confirma no mapeamento.
Que formato sai. A documentação pública fala em API REST, com documentação em developers.sults.com.br. O formato de uma exportação a página não descreve.
Se vem por loja. A versão 1 da API cobre Unidades, Chamados, Checklist, Compras, Implantação, Projetos e Expansão. O que cada um desses conjuntos carrega por unidade é o que a documentação detalha e o mapeamento confirma na sua operação.
Quem mantém. A documentação é versionada, com token e URL base por versão. A página não diz quem mantém a integração depois de feita.
O que fica de fora. A página não informa se exige plano para liberar a API. É a primeira pergunta do mapeamento, porque muda o desenho do acesso.

Principais caminhos para os dados do SULTS

Quatro caminhos existem, cada um com o que a página pública do fornecedor diz, consultada em 22/10/2026, e com o que muda quando a fonte entra na camada de Dados do Visio OS.

1. A API, como a documentação pública descreve

A documentação pública em developers.sults.com.br apresenta a API REST e o caminho da credencial: o usuário administrador gera o token em Segurança > API > Gestão de Tokens. Cada versão, v1 e v2, tem token e URL base próprios, e a v1 cobre Unidades, Chamados, Checklist, Compras, Implantação, Projetos e Expansão.

O que a página não diz é o que o token alcança em cada um desses conjuntos e o que a versão 2 acrescenta. O mapeamento responde isso com a sua operação na frente, e a Visio integra a fonte pelo caminho que existe.

2. A exportação

A página consultada em 22/10/2026 não descreve exportação. O que a documentação cobre é a API. Um caminho de exportação, quando existir na sua instalação, é assunto do mapeamento: a Visio usa exportação ou relatório onde a API não alcança, e é isso que a camada faz com qualquer fonte.

O que muda quando a fonte entra por aí é o ritmo. A camada atualiza pelo menos todo dia, cada fonte na sua frequência de extração, e o mapeamento diz, fonte por fonte, desde quando o dado é bom.

3. O MCP do fornecedor

As páginas consultadas em 22/10/2026 não mencionam um MCP próprio do SULTS. Um MCP de fornecedor, quando existe, é o caminho da sua IA até aquele sistema e responde pelo que está dentro dele: um ERP sobre MCP responde sobre o próprio ERP e não traz as outras fontes.

Onde um sistema que a sua operação já usa tem MCP próprio, o MCP da Visio opera esse MCP por trás: a IA conecta uma vez e você gerencia num lugar só. A diferença está no alcance, não na conexão.

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

A camada de Dados do Visio OS conecta toda fonte que o negócio roda, estrutura e deixa pronto pra IA. O SULTS entra como uma dessas fontes: o que ele registra por unidade fica junto do PDV, do banco, da nota, do delivery, do ponto e do que o time faz trabalhando, por loja, na mesma linha do tempo.

Estruturar é o trabalho que ninguém vê, em quatro partes: cada número com uma definição escrita uma vez pela Visio; todas as fontes juntas por loja, na mesma linha do tempo; as contas pesadas pré-calculadas; a permissão de quem pergunta dentro da consulta, por usuário, por loja e por app. A sua IA escolhe a métrica pronta, com a definição escrita, por uma dimensão pronta, e a camada monta a consulta com a permissão dentro.

Para ver como a sua operação ficaria com o SULTS ao lado das outras fontes, fale com um especialista.

Comparativo: API do SULTS, exportação, MCP do fornecedor e a camada de Dados

A tabela compara os caminhos pelo que a página pública do SULTS descreve e pelo que a camada de Dados do Visio OS faz com qualquer fonte. Célula sem fato na página diz «Conforme o sistema».

Critério	API do SULTS	Exportação do SULTS	MCP do fornecedor	Camada de Dados do Visio OS
Quem libera	O usuário administrador, com token em Segurança > API > Gestão de Tokens	Conforme o sistema	Conforme o sistema	Um login para a operação, com permissão por usuário, por loja e por app
Formato	API REST, com documentação pública em developers.sults.com.br	Conforme o sistema	Conforme o sistema	Dado estruturado por loja, lido pela API ou pelo MCP da Visio
Por loja	A versão 1 cobre Unidades, Chamados, Checklist, Compras, Implantação, Projetos e Expansão	Conforme o sistema	Conforme o sistema	Todas as fontes juntas por loja, na mesma linha do tempo
Quem mantém	Conforme o sistema	Conforme o sistema	Conforme o sistema	A Visio mantém a infraestrutura: nada para hospedar nem pipeline para manter

O que muda quando o SULTS entra por loja

O que a SULTS registra por unidade ganha sentido quando encontra as outras trilhas da mesma loja. Um chamado aberto na semana em que a venda caiu, um item de checklist reprovado no dia em que o fluxo na porta subiu, uma compra que não aparece no estoque contado: são perguntas que atravessam dois sistemas, e toda pergunta que atravessa dois sistemas começa por uma extração quando não existe camada.

Com a fonte por loja, na mesma linha do tempo, a comparação entre lojas funciona, porque cada loja significa a mesma coisa. O supervisor vê as lojas dele, a direção vê todas, com a mesma definição de cada número. A permissão vai dentro da consulta, inclusive quando quem pergunta é a sua IA pelo MCP: ela vê só a fatia que o login vê.

As suas exceções ficam suas. A loja que mudou de endereço, a que ficou fechada em reforma, as duas realocadas pertencem à sua análise e não à verdade compartilhada: na sua IA você as tira em linguagem normal e o número da plataforma fica limpo para todo mundo. O caminho para juntar as fontes de todas as lojas em um lugar só está descrito em como juntar os dados de todas as lojas em um lugar só.

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que a documentação da SULTS nomeia o lugar da credencial, Segurança > API > Gestão de Tokens, e diz que cada versão tem token e URL base próprios. Para ele, são esses os pontos a levar para o mapeamento.

A posição dele é a de que o dado de um sistema de gestão de rede vale pelo que ele encontra do outro lado. Na leitura dele, a camada de Dados do Visio OS trata a loja como unidade e escreve a definição de cada número uma vez, porque o chamado, o checklist e a compra de uma unidade passam a responder junto com a venda daquela unidade, e não em um relatório separado.

Perguntas frequentes

Como a documentação do SULTS descreve o acesso à API?

Dá para tirar os dados do SULTS sem usar a API?

A página consultada em 22/10/2026 não descreve exportação: o que ela documenta é o acesso por API. Se a sua instalação oferece relatório ou exportação, isso é assunto do mapeamento, porque a camada usa exportação ou relatório onde a API não alcança, e o mapeamento diz qual é o caso da sua operação.

O que muda quando os dados do SULTS entram por loja?

Muda a pergunta que dá para fazer. O que o sistema registra por unidade passa a ficar na mesma linha do tempo da venda, do banco, da nota e do que o time faz trabalhando, com uma definição por número escrita uma vez. A comparação entre lojas funciona, e a permissão por usuário, por loja e por app vai dentro da consulta.

A SULTS tem MCP para a minha IA ler esses dados?

As páginas consultadas em 22/10/2026 não mencionam um MCP próprio do SULTS. O caminho da sua IA até a operação é o MCP da Visio: você adiciona a Visio à IA que já usa, entra com o seu login e pergunta, e o que a SULTS registra chega estruturado por loja, junto das outras fontes. Onde um sistema tem MCP próprio, o MCP da Visio opera esse MCP por trás, e a IA conecta uma vez.

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

O próximo passo é o mapeamento: quais fontes a operação já tem e como cada uma conecta. Ele responde o que a página pública não diz, como a exigência ou não de plano para a API e o que o token alcança em cada conjunto.

Próximos passos

O caminho começa pelo mapeamento das fontes: o que a sua operação já tem, por qual via cada sistema entrega o dado e o que a página pública do fornecedor não responde. 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. Fale com um especialista sobre o mapeamento das fontes da sua operação.

Para entender o que a camada faz com o dado depois que ele entra, leia o que é camada de dados. Para o passo a passo de ligar a IA à operação, leia como conectar a IA nos dados da minha loja.

Ver também

Conclusão

Os dados da SULTS entram pelo caminho que a documentação dela descreve, com o token gerado pelo administrador e cada versão com a sua URL base, e o que isso muda é o que vem depois: a fonte por loja, na mesma linha do tempo das outras, com uma definição por número e a permissão dentro da consulta. A IA que você já usa lê o conjunto pelo MCP da Visio, com o seu login, e as suas exceções ficam na sua conversa. Fale com um especialista da camada de Dados do Visio OS.

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