Como integrar os dados da Conciliadora no Visio OS

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

Para integrar os dados da Conciliadora, o caminho que a documentação pública dela descreve é a API REST/OData com API Key, que consulta vendas, pagamentos e conciliação e também recebe o envio de vendas em XML; o material de treinamento cita ainda filtrar e exportar informações de vendas e pagamentos, sem indicar o formato (páginas consultadas em 12/10/2026). Levada à camada de Dados do Visio OS, a Conciliadora entra por API como fonte, por CNPJ e por loja, ao lado da venda e do banco, 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 conciliação é uma fonte que já cruza as outras

Entre as fontes de uma loja, a conciliação tem uma particularidade: ela já nasce de um cruzamento. A Conciliadora trabalha com vendas, pagamentos e o que se concilia entre eles, segundo a descrição da API.

Isso não dispensa a camada: o cruzamento da Conciliadora é o dela, na definição dela. A gestão de uma rede pergunta atravessando o PDV, o extrato, a nota de compra e o delivery, todos pela mesma definição de número. Na camada de Dados do Visio OS, a Conciliadora entra como uma dessas fontes, por loja.

O que a Conciliadora documenta

Em 12/10/2026, as páginas públicas da Conciliadora trouxeram três fatos.

O primeiro é a API. A documentação (documentação da API da Conciliadora, consultada em 12/10/2026) a descreve como pública, REST e OData, com API Key, para consulta de vendas, pagamentos e conciliação e para envio de vendas em XML.

O segundo é a exportação. O material de treinamento (conciliadora.com.br/ead, consultado em 12/10/2026) cita filtrar e exportar informações de vendas e pagamentos, sem indicar o formato do arquivo. Qual formato, não foi possível confirmar.

O terceiro é uma falta: a Conciliadora não publica MCP próprio nas páginas consultadas.

Consultar e enviar são duas funções da mesma API

A descrição da API reúne duas funções que servem a pessoas diferentes. Consultar vendas, pagamentos e conciliação é a função de quem quer ler. Enviar vendas em XML é a função de quem alimenta a Conciliadora com as vendas da loja.

Para um grupo que quer perguntar à sua IA sobre a operação, a função que interessa é a primeira. O envio de vendas é outra tarefa, e a documentação dela é de quem a executa. A sua IA, conectada pelo MCP da Visio, só lê: ela não escreve na Conciliadora.

Dois detalhes ficam fora da documentação consultada: como se obtém a API Key e o que cada consulta devolve em campos. Ambos são perguntas para a Conciliadora, e o mapeamento da Visio registra as duas respostas antes de a integração começar.

Como avaliar o caminho da Conciliadora: 5 critérios

Qual das duas funções. Para ler o dado, a consulta; o envio de vendas é outro trabalho.
De quem é a API Key. Registre quem do grupo a recebe e onde ela fica guardada.
O que a pergunta cruza. Vendas, pagamentos e conciliação são três recursos. Escolha o que a pergunta usa.
Por CNPJ e por loja. O dado é separado por CNPJ e por loja antes de qualquer comparação.
Desde quando. Registre o início da série de cada loja.

Principais caminhos para integrar os dados da Conciliadora

Dois caminhos nascem na Conciliadora, o terceiro entra quando eles não servem e o quarto é a camada.

1. A API REST/OData com API Key

É o caminho de programa. A documentação é pública, e a autenticação é por chave. A forma OData é uma regra de consulta que quem constrói precisa conhecer. A API devolve o que a Conciliadora tem; receita líquida, o cruzamento com o extrato e a permissão por loja ficam fora dela.

2. A exportação de vendas e pagamentos

É o caminho de arquivo. O material de treinamento cita filtrar e exportar informações de vendas e pagamentos, sem indicar o formato. Quem opera a conta exporta, na frequência dele. Sem o formato na página, o arquivo precisa ser visto uma vez na tela, por quem tem o acesso, para saber o que ele traz.

3. O caminho homologado ou o parceiro integrador

Se nem a chave nem o arquivo se encaixam no desenho do grupo, existe 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 a Conciliadora.

4. A Conciliadora como fonte da camada de Dados do Visio OS

Pelo caminho que a conta permitir, a Conciliadora é lida por API e entra por loja, com vendas, pagamentos e conciliação ao lado do PDV, do extrato (Open Finance, com o consentimento do titular) e da nota (certificado digital de cada CNPJ).

A promessa de integração da Visio é esta: 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. A Visio não extrai dado contra os termos de uso de um sistema.

O que a conciliação passa a responder ao lado da venda e do banco

A conciliação ganha outra utilidade quando deixa de ser um relatório de fechamento e passa a ser uma trilha na linha do tempo da loja.

Conciliadora e PDV. A venda que o PDV registrou fica ao lado da venda que a Conciliadora recebeu, loja a loja. A comparação entre as duas é feita na pergunta.
Conciliadora e banco. Entra o extrato de cada conta por Open Finance. O que foi conciliado fica ao lado do que de fato creditou.
Conciliadora e ERP. O lançamento do ERP fica por CNPJ ao lado do que a Conciliadora tem. A pergunta passa a ser qual das duas fontes está certa naquele dia, e não qual das duas planilhas abrir primeiro.

Em qualquer combinação, a sua IA lê a métrica já calculada, com o seu login.

Desde quando o dado da Conciliadora é bom

Para uma fonte de conciliação, a data de início da série pesa. Se uma loja passou a alimentar a Conciliadora depois das outras, a série dela é mais curta, e comparar essa loja com uma de série longa só vale quando a data de início aparece na resposta.

O mapeamento da Visio registra, fonte por fonte, desde quando o dado é bom, e a sua IA respeita essa data ao responder. A frequência de extração é da Visio: pelo menos todo dia, cada fonte na sua. A Visio não promete atualização instantânea, e quem lê a resposta sabe de quando é cada número e de qual fonte vem.

Do arquivo à métrica pronta

Se a rotina do grupo for o arquivo exportado da Conciliadora, a IA que o lê precisa inventar a junção com o PDV e com o banco, lê o arquivo inteiro e responde com convicção, e duas pessoas chegam a dois números. Sobre a camada, a IA escolhe a métrica pronta, com a definição escrita, por uma dimensão pronta, e devolve o mesmo número a todo mundo. Quando não dá, ela diz que não dá, em vez de montar a conta a partir de um arquivo. Isso vale para a conciliação como para qualquer outra fonte da camada, e a diferença aparece na primeira pergunta que cruza duas fontes.

A definição vem da Visio, que escreve uma vez o que é receita líquida, quais impostos entram e qual é a taxa de delivery. A conciliação da Conciliadora passa a ser lida dentro dessa definição, ao lado das outras fontes, e a pergunta do grupo deixa de depender de quem montou a planilha. O extrato de cada conta entra por Open Finance, com o consentimento do titular, e fica ao lado do que a Conciliadora marcou como conciliado. Tudo por loja e por CNPJ, na mesma linha do tempo, com a data de início de cada série registrada no mapeamento.

Comparativo dos caminhos para integrar a Conciliadora

A tabela lista os caminhos que as páginas da Conciliadora descrevem. O que elas não dizem aparece como não foi possível confirmar.

Critério	API REST/OData	Exportação de vendas e pagamentos	MCP do fornecedor	Camada de Dados do Visio OS
O que expõe	Consulta de vendas, pagamentos e conciliação; envio de vendas em XML	Informações de vendas e pagamentos, filtradas	Não há, nas páginas consultadas	O que o caminho escolhido entrega, estruturado por loja
Quem libera	API Key; como obtê-la, não foi possível confirmar	Quem opera a conta	Não se aplica	A Visio, a partir do mapeamento
Formato	REST e OData; o formato de resposta, não foi possível confirmar	Não foi possível confirmar	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 a chave	A pessoa que exporta	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 «como integrar os dados da Conciliadora» pede uma distinção que a documentação da API faz sem destacar: consultar e enviar são funções diferentes, e só a primeira serve a quem quer ler o dado. Para ele, o guia deve separar as duas logo de início.

A posição dele é a de que a conciliação rende mais quando entra ao lado do PDV e do banco, e não quando é lida sozinha. Ele vê a camada de Dados do Visio OS como o lugar onde a Conciliadora passa a ser uma trilha entre as outras, por loja, com uma definição por número.

Perguntas frequentes

A Conciliadora tem API para integrar os dados?

Sim. A documentação da Conciliadora, consultada em 12/10/2026, descreve uma API pública, REST e OData, com API Key.

A API da Conciliadora serve para ler ou para enviar dados?

Para os dois, segundo a documentação consultada em 12/10/2026: ela consulta vendas, pagamentos e conciliação e também recebe o envio de vendas em XML. Para ler o dado, a função é a consulta.

Dá para exportar os dados da Conciliadora sem usar a API?

Há indicação de que sim. O material de treinamento da Conciliadora, consultado em 12/10/2026, cita filtrar e exportar informações de vendas e pagamentos, mas não indica o formato do arquivo.

A Conciliadora tem MCP oficial?

Nas páginas consultadas em 12/10/2026, a Conciliadora não publica MCP próprio. Para a sua IA ler a Conciliadora, o dado passa pela camada e sai pelo MCP da Visio, com o seu login.

E se o caminho da Conciliadora na minha operação não estiver claro?

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, a Conciliadora entre elas.

A camada completa está na página da camada de Dados.

Ver também

Conclusão

Integrar os dados da Conciliadora é usar a função de consulta da API REST/OData, com API Key, ou o arquivo exportado da Conciliadora, e colocar o resultado numa camada que o estruture por CNPJ e por loja, com a mesma definição, ao lado do PDV, do extrato e da nota. A conciliação deixa de ser um relatório de fechamento e passa a ser uma das trilhas da linha do tempo da loja.

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