Como integrar os dados do Delivery Direto no Visio OS

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

Integrar os dados do Delivery Direto no Visio OS começa pelo caminho que a página do fornecedor descreve: credenciais de parceiro, token por OAuth2 e o header X-DeliveryDireto-ID. Na camada de Dados do Visio OS, o dado entra por loja, com uma definição por número, e a IA que você já usa lê pelo MCP, 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. No caso do Delivery Direto, a página consultada em 22/10/2026 descreve credenciais que saem de um formulário para desenvolvedores parceiros, com análise em até 7 dias úteis.

Por que os dados do Delivery Direto importam para a rede

Toda rede que usa o Delivery Direto decide com dois conjuntos de números: o que acontece no balcão e o que passa pelo delivery. Enquanto o segundo fica só na ferramenta do fornecedor, a comparação entre lojas para na metade, e a pergunta que interessa, qual loja vai bem no salão e mal no delivery e por quê, não tem onde ser respondida.

O problema não é o fornecedor, é o lugar onde o dado mora. Um relatório dentro de uma ferramenta responde sobre aquela ferramenta. A decisão de escala, de compra e de meta precisa do número do delivery ao lado da venda do PDV, da nota e do extrato da mesma loja, na mesma linha do tempo. É o que faz a junção de todas as lojas em um lugar só valer a pena.

Quando essa junção não existe, cada pergunta que atravessa duas fontes vira uma extração. A pessoa baixa um relatório, cola na IA que já usa, chega a uma análise, e o arquivo morre ali; a pergunta seguinte recomeça a extração. Duas pessoas perguntam a mesma coisa e chegam a dois números, e o contexto vai embora com quem sai.

Integrar não é ter mais um relatório: é o número do delivery chegar junto com os outros, no mesmo momento em que o time olha a loja.

Como avaliar o caminho do Delivery Direto: 5 critérios

Cinco critérios mostram se o caminho serve à operação. Cada um tem resposta na página do fornecedor ou vira pergunta para o mapeamento.

Quem libera o acesso. A página consultada em 22/10/2026 descreve credenciais CLIENT_ID e CLIENT_SECRET que saem de um formulário para desenvolvedores parceiros, com análise em até 7 dias úteis. O acesso depende de uma aprovação, e o prazo é do fornecedor.
Que formato sai. As respostas da API são somente em JSON, segundo a mesma página. Formato aberto é o que permite cruzar o dado depois sem trabalho manual.
Se vem por loja. A página documenta Store API, Admin API, Open Delivery e webhooks. O recorte por loja é o que o mapeamento confirma antes de a integração começar, porque é ele que faz a comparação entre unidades funcionar.
Quem mantém a conexão. O token vem por OAuth2 na rota /token, e cada chamada leva o header X-DeliveryDireto-ID. A página não diz quem mantém a integração depois disso.
O que o caminho não cobre sozinho. Nenhuma integração de um fornecedor entrega, por si, o PDV, o banco e a nota da mesma loja. Esse é o critério que separa uma conexão de uma camada de dados.

Principais caminhos para integrar os dados do Delivery Direto

Quatro caminhos aparecem quando a pergunta é como os dados do Delivery Direto chegam à operação. Cada um resolve um problema diferente, e a escolha não é de gosto: é o que a página do fornecedor documenta e o que a camada acrescenta depois.

1. A API, como a página do fornecedor descreve

Segundo a página do Delivery Direto consultada em 22/10/2026 (credenciais de acesso), as credenciais CLIENT_ID e CLIENT_SECRET saem de um formulário para desenvolvedores parceiros, com análise em até 7 dias úteis. O token vem por OAuth2 em /token, e cada chamada leva o header X-DeliveryDireto-ID. A documentação pública cobre Store API, Admin API, Open Delivery e webhooks, e as respostas são somente em JSON.

O desenho tem três peças: a credencial de aplicação, a troca por token e um identificador por chamada. O prazo de análise de até 7 dias úteis é do fornecedor.

2. A exportação, quando o sistema oferece

As páginas consultadas em 22/10/2026 não mencionam exportação de arquivo no Delivery Direto. Se a operação já baixa algum arquivo do fornecedor, o mapeamento identifica de onde ele sai e com que frequência.

Exportação tem um limite conhecido de quem já trabalha com dado de loja: ela fotografa um momento. A camada trabalha com frequência de extração, pelo menos todo dia, cada fonte na sua, e o mapeamento diz, fonte por fonte, desde quando o dado é bom.

3. O MCP do fornecedor

O MCP é o caminho da sua IA até uma fonte: a pessoa conecta, entra com o login e pergunta em linguagem normal. As páginas do Delivery Direto consultadas em 22/10/2026 não mencionam um MCP próprio.

Quando um fornecedor publica um MCP, ele responde sobre o que está naquele sistema. Um MCP do Delivery Direto responderia sobre o Delivery Direto, e não sobre o PDV, o banco ou a nota da mesma loja. É por isso que a camada de Dados existe: onde o sistema já tem MCP próprio, o MCP da Visio opera esse MCP por trás, e a IA conecta uma vez, não uma por fornecedor.

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

Na camada de Dados do Visio OS, o Delivery Direto entra como uma fonte entre as que a operação já roda, ao lado do PDV, do banco, da nota fiscal e do que o time faz nas ferramentas. O dado fica por loja, na mesma linha do tempo, com uma definição por número escrita uma vez pela Visio. Quais fontes estão ligadas em cada operação é definido no mapeamento.

A leitura é pelo Visio MCP. A pessoa adiciona a Visio à IA que já usa, entra com o login da Visio, e a IA lista as lojas, as métricas e as dimensões que aquele login pode ver e as consulta, só leitura. A permissão vai por usuário, por loja e por app, aplicada no dado, inclusive quando quem pergunta é a IA. A sua IA escolhe a métrica pronta, com a definição escrita, e a camada monta a consulta com a permissão dentro.

O efeito prático é a pergunta que antes pedia uma extração: comparar a região sem as lojas em reforma, olhar o dia contra a noite por loja, decidir a compra da semana. A resposta vem com as suas permissões, e a sua conversa fica com a sua IA. Para entender o desenho inteiro, vale ler o que é camada de dados e, se o assunto for ligar a IA, como conectar a IA nos dados da minha loja.

Para ver como o Delivery Direto entra na leitura da sua operação, Fale com um especialista.

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

A tabela compara os caminhos pelo que a página do fornecedor documenta e pelo desenho da camada de Dados do Visio OS.

Critério	API do Delivery Direto	Exportação	MCP do fornecedor	Camada de Dados do Visio OS
Quem libera	Formulário de parceiro, com análise em até 7 dias úteis	Conforme o sistema	Conforme o sistema	O mapeamento das fontes, com a Visio
Formato	JSON, com OAuth2 e o header X-DeliveryDireto-ID	Conforme o sistema	Conforme o sistema	Dado estruturado por loja
Por loja	Conforme o sistema	Conforme o sistema	Conforme o sistema	A loja é a unidade
Quem mantém	Conforme o sistema	Conforme o sistema	Conforme o sistema	A Visio

Os dois primeiros caminhos respondem sobre o Delivery Direto e param ali. A camada acrescenta o que falta para decidir: a fonte na mesma linha do tempo das outras, a definição escrita uma vez e a permissão dentro da consulta.

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que a pergunta sobre integrar o Delivery Direto pode ser lida como um problema de credencial, quando é um problema de lugar. Para ele, o formulário de parceiro e o token são a parte visível; o que decide o resultado é onde o dado do delivery vai morar depois que a credencial chega.

Na leitura dele, a camada de Dados do Visio OS trata a fonte por loja e escreve a definição de cada número uma vez, porque isso transforma uma integração de fornecedor em uma peça da mesma linha do tempo da venda. A posição dele é a de que o leitor deve decidir pelo que precisa responder no fechamento do mês, e não pelo caminho que parece mais curto no começo.

Perguntas frequentes

Preciso ser parceiro do Delivery Direto para ler os dados por API?

Pelo que a página do fornecedor descreve, sim. As credenciais CLIENT_ID e CLIENT_SECRET saem de um formulário para desenvolvedores parceiros, com análise em até 7 dias úteis, e a documentação pública cobre Store API, Admin API, Open Delivery e webhooks.

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

É o mapeamento que responde: ele identifica se existe arquivo, relatório ou outra forma de saída na sua operação, de onde ela vem e com que frequência. As páginas consultadas em 22/10/2026 não mencionam exportação de arquivo. Vale lembrar que um arquivo baixado à mão fotografa um momento, enquanto a camada trabalha com frequência de extração, pelo menos todo dia, cada fonte na sua.

O que muda quando os dados do Delivery Direto entram por loja?

Muda a pergunta que passa a ter resposta. Com o dado por loja, na mesma linha do tempo da venda, da nota e do extrato, a comparação entre unidades funciona porque cada uma significa a mesma coisa, e o recorte que a pessoa precisa (por região, sem as lojas em reforma, dia contra noite) é feito na IA, com o login dela. O número compartilhado não muda. O caminho para esse padrão está em como ter o mesmo número para todo mundo na rede.

O Delivery Direto tem MCP oficial?

As páginas consultadas em 22/10/2026 não mencionam um MCP próprio do Delivery Direto. O que a página documenta é a API, com credencial de parceiro, token por OAuth2 e o header X-DeliveryDireto-ID. Um MCP de fornecedor, quando existe, é um fato sobre aquele fornecedor e responde sobre o que está no sistema dele.

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

O caminho é o mapeamento: quais fontes a operação já tem, como cada uma conecta e o que o Delivery Direto acrescenta à leitura por loja. O mapeamento também diz desde quando o dado de cada fonte é bom.

Próximos passos

O próximo passo é o mapeamento das fontes da sua operação, com o Delivery Direto entre elas: o que já existe, como cada uma conecta e o que muda quando o dado chega por loja. 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 suas fontes.

Ver também

Conclusão

Integrar os dados do Delivery Direto no Visio OS começa pela API que a página do fornecedor documenta, com credencial de parceiro, token por OAuth2 e o header X-DeliveryDireto-ID, e termina com o dado por loja, na mesma linha do tempo da venda, da nota e do banco. A IA que você já usa lê o resultado pelo MCP, com o seu login e as suas permissões, e a resposta não termina numa tabela: o Visio OS leva a decisão adiante. 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.