Como integrar os dados do Rappi no Visio OS

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

Para integrar os dados do Rappi, o caminho que ele documenta é uma API de referência pública cujas credenciais só saem depois de contato com o ponto focal da Rappi e de aprovação, e o segundo caminho é o resumo de pagamento que o Portal Partners deixa baixar (páginas consultadas em 12/10/2026). Leve o que sair de qualquer um dos dois à camada de Dados do Visio OS, e o Rappi vira uma fonte por loja, ao lado do PDV e do banco da mesma loja, na mesma linha do tempo.

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 camada de Dados do Visio OS é a camada 1 de 9 do sistema e conecta toda fonte que o seu negócio roda, estrutura e deixa pronto pra IA. Esta é a página da fonte Rappi, no cluster de delivery com a página-mãe como integrar os dados do delivery, como integrar os dados do Aiqfome e como conectar o iFood.

A referência é pública, a credencial é por aprovação

A Rappi publica uma referência de API em um portal próprio (Portal de desenvolvedores da Rappi, consultado em 12/10/2026). A página informa que as credenciais só são liberadas depois do contato com o ponto focal da Rappi e de aprovação. Ler o que a API cobre é possível; usá-la depende de uma pessoa da Rappi dizer sim.

Para quem planeja, a consequência é de calendário. O prazo da integração por API deixa de ser só o do time do grupo e passa a incluir uma conversa e uma decisão do lado da Rappi. A página não informa quanto tempo isso leva, e este guia não inventa uma estimativa.

A referência diz o que a API cobre: pedidos, cardápio, disponibilidade, lojas, webhooks e financeiro. A lista junta itens de quem opera o canal e itens de quem lê o resultado dele. O que cada item devolve, campo a campo, está na documentação da Rappi, que é a fonte para quem vai construir. A Rappi também não publica um MCP próprio nas páginas consultadas.

Operar o canal e ler o canal são trabalhos diferentes

Cardápio, disponibilidade e lojas são itens de quem gerencia a operação dentro do aplicativo. Pedidos e financeiro são itens de quem quer saber o que aconteceu. A API da Rappi reúne os dois grupos, e o que interessa à pergunta de gestão é o segundo.

Isso importa por uma razão de desenho. A camada serve o dado, e a sua IA lê pelo MCP da Visio: não escreve no sistema, não cria tarefa e não muda meta. Mudar o cardápio ou a disponibilidade de uma loja é um ato dentro da Rappi, fora do que se pergunta à operação. A leitura e a escrita ficam em lugares diferentes, e é por isso que a conta fecha.

Os webhooks, que a referência lista, são o aviso que um sistema manda a outro quando algo acontece. Como a camada usa um aviso desses é assunto do mapeamento daquela operação, e a página da Rappi não descreve a frequência com que o dado chega. A frequência de extração, na camada, é pelo menos todo dia, cada fonte na sua.

Como avaliar o caminho do Rappi: 6 critérios

Quem aprova o acesso. O ponto focal da Rappi. O prazo do grupo passa a ser, em parte, o dela.
O que atravessa. Pedidos e financeiro são perguntas diferentes; a conexão precisa trazer o que a sua pergunta usa.
Por loja. O número só serve se cair na loja certa, com o mesmo significado do PDV e do banco.
Separado na origem. Delivery e balcão não se misturam na entrada.
O formato do que se baixa. O Portal Partners deixa baixar um resumo de pagamento, mas a página não indica o formato.
Quem mantém. A Rappi muda a documentação, e alguém do lado do grupo precisa ser dono do vínculo.

Principais caminhos para integrar os dados do Rappi

São quatro caminhos. Os três primeiros nascem na Rappi. O quarto é o que a camada de Dados faz com qualquer um deles.

1. A API, com credenciais pelo ponto focal

É o caminho de programa, e o mérito está no desenho: pedidos e financeiro estão na lista de cobertura, e a referência é pública, de modo que o time lê o que existe antes de pedir acesso. O custo está na entrada. Sem o contato com o ponto focal e a aprovação, as credenciais não saem. A sequência é ler a referência, procurar o ponto focal, esperar a decisão e só então desenhar o que a leitura traz.

2. O resumo de pagamento do Portal Partners

É o caminho de arquivo. O Portal Partners tem a opção «Baixe a relação de vendas» (Pagamentos no Portal Partners, consultado em 12/10/2026), e o resumo de pagamento é baixável. A página não indica o formato do arquivo. Por isso este guia não afirma se é planilha, texto ou outro. A vantagem do caminho é não depender da aprovação de credenciais de API. A limitação é dupla: o formato é desconhecido até alguém baixar, e a frequência é a de quem baixa.

3. O caminho homologado ou o parceiro integrador

Se a aprovação das credenciais demora e o arquivo pede gente demais, existe o caminho homologado, feito com quem faz o sistema ou com um parceiro integrador. Antes de abrir a conversa com a Rappi, verifique com a Visio se já existe forma homologada ou parceiro integrador para o Rappi. A Visio não extrai dado contra os termos de uso de um sistema: o que a Rappi não libera não entra por outra porta.

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

Por qualquer dos caminhos, a camada lê o Rappi por loja, na mesma linha do tempo, com uma definição por número escrita uma vez pela Visio: o que é receita líquida, quais impostos, qual taxa de delivery. O delivery é uma classe de fonte, e o Rappi entra pelo caminho que existe: por API onde há uma, por exportação ou relatório onde não há, e por um caminho de extração homologado quando nenhum dos dois serve.

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 Rappi passa a responder junto do resto

A conexão do Rappi responde uma coisa e, somada às outras fontes, responde outras. A sua IA, ligada à camada pelo MCP da Visio, com o seu login, lê a métrica já calculada.

O canal sozinho. Por loja, o que o Rappi vendeu, o que cobrou e quando pagou.
Com o PDV. Entra o balcão: delivery e balcão seguem separados na origem e se somam ou se comparam por loja.
Rappi, PDV e banco. Entra o extrato, por Open Finance, com o consentimento do titular da conta. A pergunta passa a ser o que a Rappi pagou e o que de fato caiu na conta da loja.
Rappi e outros apps de delivery. Quando a mesma loja vende por mais de um app, cada um entra como fonte própria e a pergunta atravessa os dois. A lógica geral dessa soma está na página-mãe do cluster.

A permissão vai dentro da consulta. O gerente vê a loja dele, o supervisor vê as dele, e a gestão vê todas, e a regra vale para a IA de cada um.

Comparativo dos caminhos para integrar o Rappi

A tabela descreve mecanismo. Onde a página da Rappi não diz, a célula diz que não foi possível confirmar.

Critério	API da Rappi	Resumo de pagamento do Portal Partners	Camada de Dados do Visio OS
Quem libera	A Rappi, pelo ponto focal, com aprovação	Quem opera a conta no Portal Partners	A Visio, a partir do mapeamento das fontes
O que se documenta	Pedidos, cardápio, disponibilidade, lojas, webhooks e financeiro	Resumo de pagamento baixável	O que o caminho escolhido entrega, estruturado por loja
Formato	Não foi possível confirmar: fica na documentação da Rappi	Não foi possível confirmar: a página não indica	Pelo caminho que existe, na mesma linha do tempo
Frequência	Não foi possível confirmar	A de quem baixa	Pelo menos todo dia, cada fonte na sua frequência de extração
Por loja	Se o time construir	Não foi possível confirmar o campo	Sim, a loja é a unidade
Permissão	A da credencial aprovada	A de quem tem o arquivo	Por usuário, por loja e por app, aplicada no dado
Quem mantém	O time do grupo	A pessoa que baixa	A Visio: nada para hospedar nem manter

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que a Rappi mostra uma distinção que fica escondida na palavra integração: integrar para operar o canal e integrar para entender o canal são projetos diferentes, mesmo quando a API é a mesma. Para ele, o texto sobre a Rappi só é útil se disser qual dos dois está sendo ensinado.

A posição dele é a de que o grupo deve pedir as credenciais pelo ponto focal sem esperar a camada, porque o calendário é da Rappi, e entregar o resultado a uma estrutura que o leia por loja. Ele reconhece o mérito da referência pública, que deixa o time avaliar antes de pedir acesso, e vê a camada de Dados do Visio OS como o lugar onde pedidos e financeiro do Rappi passam a valer junto com o resto da operação.

Perguntas frequentes

A Rappi tem API para integrar os dados?

Sim. A referência pública consultada em 12/10/2026 lista pedidos, cardápio, disponibilidade, lojas, webhooks e financeiro. As credenciais só saem depois de contato com o ponto focal da Rappi e de aprovação.

A Rappi tem MCP?

Nas páginas consultadas em 12/10/2026, a Rappi não publica um MCP próprio. A sua IA lê o dado da Rappi pelo MCP da Visio, depois que ele entrou na camada, com o seu login e só dentro das permissões.

Dá para integrar os dados do Rappi sem API, por relatório?

A camada lê uma fonte por exportação ou relatório onde não há API. O Portal Partners deixa baixar o resumo de pagamento, mas a página consultada em 12/10/2026 não indica o formato do arquivo. Teste com um período fechado antes de planejar a rotina.

A IA pode mudar o cardápio ou a disponibilidade da loja na Rappi?

Não. A IA lê: não escreve no sistema, não cria tarefa e não muda meta. A análise é onde o trabalho dela termina, e a tarefa nasce na plataforma, pela lógica do sistema.

Quem decide o prazo da integração por API do Rappi?

A aprovação das credenciais é da Rappi, pelo ponto focal, e a página consultada em 12/10/2026 não informa quanto tempo isso leva. O mapeamento parte do que a operação já tem e de como cada fonte conecta; verifique com a Visio se já existe forma homologada ou parceiro integrador.

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 Rappi entre elas.

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

Ver também

Conclusão

Integrar os dados do Rappi é pedir as credenciais pelo caminho que a Rappi define ou baixar o resumo de pagamento do Portal Partners, e entregar o resultado a uma camada que o estruture por loja, separado do balcão, ao lado do PDV e do banco. Cada fonte a mais é mais pergunta respondida na IA que você já usa.

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