Como integrar os dados do Cardápio Web no Visio OS

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

Integrar os dados do Cardápio Web começa pelo caminho que a documentação dele descreve: a integradora cadastra um aplicativo com o suporte, o Cardápio Web gera o client_id, as permissões e a redirect URI ficam definidas nesse cadastro, e o proprietário do estabelecimento autoriza por OAuth com PKCE. O token de acesso dura 2 horas, e os módulos são Loja, Catálogo e Pedidos (página consultada em 22/10/2026).

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. O Cardápio Web é a fonte e a camada de Dados do Visio OS é o destino: a camada 1 de 9 do Visio OS, que recebe a fonte por loja, com uma definição por número, e deixa o dado pronto para a IA que você já usa ler pelo MCP.

Por que os dados do Cardápio Web precisam sair do próprio Cardápio Web

Uma plataforma de cardápio digital responde sobre o que ela mesma registra: o catálogo que a loja publica, os pedidos que entram e a unidade que os recebeu. A pergunta que a rede faz na segunda-feira não cabe dentro dela. Comparar o que a loja vendeu no salão com o que vendeu no delivery, conferir se o pedido do marketplace caiu na conta certa, olhar a venda por hora contra a escala do turno: cada uma dessas perguntas atravessa mais de um sistema.

O custo disso é conhecido por quem toca operação. Toda pergunta que cruza duas fontes começa por uma extração: alguém entra no sistema, baixa um relatório, junta com o arquivo do outro sistema, e chega a um número que a próxima pessoa não consegue repetir. Quando a resposta sai de um arquivo colado na IA, a IA inventa a junção entre os arquivos, lê o arquivo inteiro e responde com convicção, e duas pessoas chegam a dois números. O dado viaja sem permissão de ninguém e sem registro.

Para uma rede que usa o Cardápio Web, ele carrega pedido, catálogo e loja no mesmo lugar. Colocar isso ao lado do PDV, do banco, da nota e do que o time fez no turno, por loja, na mesma linha do tempo é o trabalho da camada de Dados. A comparação entre lojas só funciona quando o dado de cada uma significa a mesma coisa, e é disso que trata juntar os dados de todas as lojas em um lugar só.

Como avaliar o caminho do Cardápio Web: 5 critérios

Cinco critérios mostram o que cada caminho entrega de verdade. Onde a documentação do fornecedor não traz o fato, o critério vira uma pergunta para o mapeamento da operação, não uma suposição.

Quem libera o acesso. Um caminho pode começar no suporte do fornecedor, no painel do próprio cliente ou num cadastro de parceiro. No Cardápio Web, a documentação consultada em 22/10/2026 descreve a integradora cadastrando o aplicativo com o suporte, com o client_id gerado pelo Cardápio Web, e a autorização saindo do proprietário do estabelecimento por OAuth com PKCE. Vale perguntar quem, na sua operação, é o proprietário que autoriza cada loja.
O que sai do sistema. Não é só o formato do arquivo: é o que o módulo cobre. A documentação do Cardápio Web, na mesma consulta, lista os módulos Loja, Catálogo e Pedidos. Saber se o número que você precisa mora em um deles é pergunta para o mapeamento.
Se vem por loja. Um dado que chega sem a loja identificada não serve para uma rede: ele não entra na mesma linha do tempo das outras fontes e não responde comparação entre unidades. A loja é a unidade da camada de Dados, e isso vale para a nota de cada CNPJ, para o extrato de cada conta e para o pedido de cada unidade.
Quem mantém a conexão viva. O token de acesso do Cardápio Web dura 2 horas, segundo a documentação consultada em 22/10/2026, e a página não diz quem o renova. Na camada, a frequência de extração é da Visio: pelo menos todo dia, cada fonte na sua.
O que fica de fora. Nenhum caminho cobre tudo o que a operação produz. O que o fornecedor não expõe pelo caminho documentado entra pelo mapeamento, que define fonte por fonte como cada uma conecta, e o que continua fora fica dito antes, não depois.

Principais caminhos para os dados do Cardápio Web

São quatro caminhos, e eles não competem: cada um responde uma pergunta diferente. Os três primeiros são do fornecedor, com a página consultada em 22/10/2026. O quarto é o que a camada de Dados acrescenta depois que o dado já existe.

1. A API, como a documentação do Cardápio Web descreve

Na página consultada em 22/10/2026, o acesso passa por cadastro de integradora. O desenho que ela descreve tem três peças: a integradora cadastra o aplicativo com o suporte, o Cardápio Web gera o client_id, e as permissões e a redirect URI são definidas nesse cadastro. Depois disso, o proprietário do estabelecimento autoriza por OAuth com PKCE. O token de acesso dura 2 horas, e os módulos citados são Loja, Catálogo e Pedidos.

2. A exportação do próprio sistema

As páginas consultadas em 22/10/2026 não mencionam exportação de dados do Cardápio Web. Na camada, onde um sistema de varejo oferece exportação ou relatório, esse é um dos caminhos pelos quais a fonte entra, ao lado da API. A definição do caminho do Cardápio Web fica no mapeamento da operação.

O arquivo exportado envelhece: o dado é verdadeiro no dia em que foi gerado, e cada pergunta nova pede outra exportação.

3. O MCP do fornecedor

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

A camada de Dados lê a fonte pela API ou pela exportação e serve a operação inteira pelo Visio MCP, com um login só. E onde o sistema do cliente já 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 entre os dois caminhos está em MCP é a mesma coisa que API.

4. O Cardápio Web como fonte da camada de Dados do Visio OS

Aqui o mecanismo muda de natureza. O dado do Cardápio Web entra por loja, na mesma linha do tempo das outras fontes, com uma definição por número escrita uma vez pela Visio. As contas pesadas ficam prontas, e a permissão vai dentro da consulta, por usuário, por loja e por app, aplicada no dado.

O resultado: a comparação entre lojas funciona, porque o pedido do delivery, a venda do salão, o extrato e a nota da mesma loja querem dizer a mesma coisa. A IA que você já usa lê a operação pelo MCP, com o seu login, e recebe a métrica pronta em vez de adivinhar a junção a partir de um arquivo. A definição completa dessa base está em o que é camada de dados, e o passo a passo para ligar a IA está em como conectar a IA nos dados da minha loja.

Para ver como o caminho do Cardápio Web fica na sua operação, fale com um especialista.

Comparativo: API do Cardápio Web, exportação, MCP do fornecedor e camada de Dados

A tabela compara caminhos, não fornecedores.

Critério	API do Cardápio Web	Exportação	MCP do fornecedor	Camada de Dados do Visio OS
Quem libera	A integradora cadastra o app com o suporte, e o proprietário do estabelecimento autoriza por OAuth com PKCE	Conforme o sistema	As páginas consultadas em 22/10/2026 não mencionam um MCP próprio	O mapeamento da operação, fonte por fonte, com a Visio
Formato	Os módulos Loja, Catálogo e Pedidos	Conforme o sistema	Conforme o sistema	Por loja, na mesma linha do tempo, com uma definição por número
Por loja	Conforme o sistema	Conforme o sistema	Conforme o sistema	A loja é a unidade, e a permissão é por loja
Quem mantém	Conforme o sistema	Conforme o sistema	Conforme o sistema	A Visio: a infraestrutura é da Visio pra rodar

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que a pergunta sobre integrar o Cardápio Web chega como pergunta técnica, e que o teste útil é outro: o que a rede quer conseguir perguntar depois que o dado estiver dentro. Para ele, a resposta que interessa não é a lista de módulos nem o tempo de vida do token, e sim se, no fim, uma loja pode ser comparada com outra sem que alguém baixe dois relatórios.

A posição dele é a de que o caminho do fornecedor e o caminho da camada resolvem problemas diferentes e precisam ser decididos nessa ordem. Na leitura dele, quem escolhe começar pela camada ganha a estrutura antes da primeira pergunta, porque cada número já tem definição escrita e a permissão já vai dentro da consulta.

Para ele, o critério de decisão do leitor é o uso, não a elegância da conexão. Se a pergunta da semana atravessa o Cardápio Web e outras fontes, a integração isolada não a responde.

Perguntas frequentes

Preciso ser parceiro do Cardápio Web para ler os dados por API?

A documentação consultada em 22/10/2026 descreve o acesso assim: a integradora cadastra o aplicativo com o suporte, o Cardápio Web gera o client_id, e as permissões e a redirect URI são definidas nesse cadastro. Depois disso, o proprietário do estabelecimento autoriza por OAuth com PKCE, e o token de acesso dura 2 horas. A autorização fica com o proprietário do estabelecimento.

Se a API não for o caminho da minha loja, como a camada resolve?

As páginas consultadas em 22/10/2026 não mencionam exportação de dados do Cardápio Web. Na camada de Dados, cada fonte entra pelo caminho que existe, e o mapeamento diz qual é o do Cardápio Web na sua operação: a classe é a mesma que vale para qualquer sistema de varejo, por API onde há uma e por exportação ou relatório onde há.

Por que a loja precisa ser a unidade do dado do Cardápio Web?

Porque é a loja que a rede compara. Com o dado por loja, na mesma linha do tempo das outras fontes e com uma definição por número escrita uma vez, a comparação entre unidades funciona, e a permissão passa a ser por usuário, por loja e por app, aplicada no dado. O gerente vê a loja dele, e a gestão vê o grupo, com a mesma definição de cada número.

O Cardápio Web tem MCP oficial?

As páginas consultadas em 22/10/2026 não mencionam um MCP próprio do Cardápio Web. O caminho que liga a IA que você já usa aos dados da operação é o Visio MCP, que lê a operação que está na camada com o login de quem pergunta, só leitura, dentro das permissões, e vem incluído em todos os planos do Visio OS.

Por onde começa o mapeamento do Cardápio Web?

O mapeamento começa pelas fontes que a operação já tem e por como cada uma conecta. É nele que se define, fonte por fonte, desde quando o dado é bom, e é nele que a classe vira o caminho concreto da sua rede, com a loja como unidade e a permissão aplicada no dado.

Próximos passos

O caminho do Cardápio Web começa no mapeamento das fontes da sua operação, e não numa promessa de número. 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 como o Cardápio Web entra na camada de Dados do Visio OS ao lado do PDV, do banco e da nota.

Ver também

Conclusão

Integrar os dados do Cardápio Web tem dois tempos. O primeiro é o caminho do fornecedor, que a documentação consultada em 22/10/2026 descreve assim: aplicativo cadastrado pela integradora, client_id gerado pelo Cardápio Web, autorização do proprietário do estabelecimento por OAuth com PKCE, token de 2 horas e os módulos Loja, Catálogo e Pedidos. O segundo é o que a operação faz com esse dado depois: por loja, na mesma linha do tempo das outras fontes, com uma definição por número e a permissão dentro da consulta, para que a IA que você já usa leia o resultado pelo MCP com o seu login. Fale com um especialista da camada de Dados do Visio OS para começar pelo mapeamento.

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