Como integrar os dados da Stone no Visio OS
Para integrar os dados da Stone, as páginas públicas dela descrevem três caminhos: a API de Conciliação, que entrega um XML do D-1 a cliente credenciado; o relatório de vendas, baixado em PDF, XLS ou CSV; e a API da conta, que a Stone dá por parceria (páginas consultadas em 12/10/2026). Na camada de Dados do Visio OS, a Stone entra como fonte por loja, pelo caminho que a conta permitir, junto com a venda do PDV e o extrato 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. Stone aqui é a adquirente de cartão da loja, vista como fonte de dados: o que passou, a taxa, o que vai cair e quando.
O que a Stone publica sobre os próprios dados
A consulta de 12/10/2026 olhou três páginas, uma por caminho.
- A API de Conciliação. A página de perguntas e respostas da API de Conciliação descreve a entrega de um XML do D-1 a cliente credenciado e a AffiliationKey, a chave pedida ao contato comercial da Stone.
- O relatório de vendas. A página de ajuda da Stone mostra como acessar o relatório de vendas, que sai em PDF, XLS ou CSV.
- A API da conta. A documentação da conta existe, e a Stone a oferece por parceria.
A Stone não publica MCP próprio nessas páginas.
O D-1: o dia anterior como unidade
O D-1 é o dia anterior ao da consulta, e é a medida do que a API de Conciliação entrega: um XML por dia, do dia que fechou. Isso define o desenho de leitura de um jeito que as outras fontes não definem. A Stone não entrega o que acabou de acontecer: entrega o que fechou ontem.
Para a pergunta sobre o dia que fechou, o XML do D-1 é a medida. Para o dia em curso, o dado vem do PDV, que a camada extrai mais vezes por dia, e o banco entra na frequência de extração dele.
A frequência de extração da Visio é pelo menos todo dia, cada fonte na sua, e casa com um arquivo que sai uma vez por dia. Atualização instantânea não é promessa, nem da Stone nem da Visio.
A AffiliationKey e o contato comercial
A API de Conciliação não é aberta: o acesso é de cliente credenciado, e a AffiliationKey é pedida ao contato comercial da Stone. Isso é o que a página diz. Por quanto tempo a chave vale e em quanto tempo ela sai, a página não informa, e esse é o tipo de detalhe que o mapeamento registra conta a conta em vez de supor.
Se a rede tem mais de uma afiliação Stone, a pergunta se repete para cada uma, e cada chave precisa chegar à camada associada à loja que ela atende.
A conta Stone e a maquininha Stone
A Stone tem uma segunda API na documentação que a consulta encontrou: a da conta, em docs.openbank.stone.com.br, que ela oferece por parceria. A API de Conciliação, por sua vez, entrega o XML do D-1 a cliente credenciado. Os campos de cada uma não aparecem nas páginas consultadas, e é a pergunta da loja que decide qual das duas serve.
Na camada, o extrato do banco de cada loja entra por Open Finance, com o consentimento do titular, enquanto a venda e o repasse da maquininha entram pela fonte Stone. São duas trilhas, e a linha do tempo as junta.
Como avaliar o caminho da Stone: 6 critérios
- Quantas afiliações Stone, quantos CNPJs. Uma chave por afiliação muda o desenho entre uma rede e uma loja.
- Se a operação é cliente credenciado. É a condição da API de Conciliação.
- A chave. A AffiliationKey é pedida ao contato comercial da Stone, e a página não diz em quanto tempo ela sai.
- Quando o D-1 é suficiente. Se a pergunta aceita o dia fechado, o XML basta; se não, o PDV complementa.
- O formato do relatório. PDF, XLS ou CSV; veja um arquivo real de cada, porque a página não mostra as colunas.
- Desde quando. A data em que o dado de cada loja é completo.
Principais caminhos para integrar os dados da Stone
Três caminhos nascem na Stone e o quarto é o que a camada faz com eles.
1. A API de Conciliação, com XML do D-1
É o caminho de programa e o mais próximo do que a Stone documenta para dados. O credenciamento vem primeiro; depois, um XML por dia. O layout do XML não aparece nas páginas consultadas, e é um exemplar real que define a leitura.
2. O relatório de vendas em PDF, XLS ou CSV
É o caminho de arquivo: alguém acessa o relatório e baixa, em PDF, XLS ou CSV. As colunas de cada formato não aparecem na página de ajuda.
3. A API da conta, por parceria
É o caminho da conta. Existe a documentação, e a Stone a dá por parceria. Para a pergunta de vendas, o caminho é outro.
4. A Stone como fonte da camada de Dados do Visio OS
Pelo caminho que a conta permitir, a Stone entra por loja e por CNPJ, na classe maquininha, na mesma linha do tempo da venda do PDV, do extrato do banco e da nota (pelo 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.
Fale com um especialista sobre a Stone das suas lojas
O relatório diário deixa de ser tarefa de alguém
Um XML que sai todo dia pede alguém que o abra, leia e confira. Esse é o trabalho que a camada tira das pessoas: o dado fica pronto antes de o gestor pedir, e quem decide pergunta em vez de pedir a quem segura a planilha. Quando a pessoa que montava o relatório sai da empresa, o contexto fica, porque a regra de leitura está na camada e não na cabeça dela.
A IA conectada só lê: não escreve na Stone, não cria tarefa e não muda meta.
As exceções que são suas
A rede que compara lojas pela Stone enfrenta o caso da loja que fechou nove dias para reforma, ou da que mudou de endereço. Essas exceções pertencem à análise de quem pergunta, e não à verdade compartilhada. Na IA do usuário, ele as tira em linguagem normal e ensina a IA a olhar do seu jeito; o número da plataforma fica limpo para todo mundo. A estratégia mora na IA de cada um, e a rotina na plataforma.
Com que frequência e com que segurança
A frequência de extração é da Visio: pelo menos todo dia, cada fonte na sua. A venda entra mais vezes por dia, e o banco e a nota entram na frequência de extração deles; o dado fica pronto quando o trabalho precisa. O XML do D-1 se encaixa nessa lógica como uma fonte de ritmo diário.
Sobre segurança, o que a Visio pode dizer é que o dado fica na nuvem que o grupo já usa, isolado por empresa, cifrado em repouso e no acesso, com o registro de acesso centralizado. O DPA é público e a Visio é a operadora do dado.
Desde quando o dado da Stone é bom
Uma loja que migrou de adquirente para a Stone no meio do ano tem uma série que começa nesse dia. O mapeamento da Visio registra, fonte por fonte, desde quando o dado é bom, e a sua IA respeita isso ao comparar lojas. A data em que o XML de cada afiliação passou a ser entregue é um dado do mapeamento, e não uma suposição. Duas lojas com datas diferentes só se comparam com as duas datas na resposta, e a camada as mostra.
Comparativo dos caminhos para integrar a Stone
A tabela lista o que as páginas da Stone descrevem, consultadas em 12/10/2026.
| Critério | API de Conciliação | Relatório de vendas | API da conta |
|---|---|---|---|
| O que entrega | XML do D-1 | O relatório de vendas | Dado da conta; os campos, não mencionado nas páginas públicas |
| Como se acessa | Cliente credenciado, com AffiliationKey pedida ao contato comercial | Pelo acesso ao relatório de vendas | Por parceria |
| Formato | XML | PDF, XLS ou CSV | Não mencionado nas páginas públicas |
| Frequência | O D-1, o dia anterior | Quando alguém baixa | Não mencionado nas páginas públicas |
Nas três páginas, a Stone não publica MCP próprio.
Opinião do Head of Content
Lorenzo Lopez, Head of Content da Visio, observa que a Stone é a fonte em que o tempo está no nome do caminho: o D-1 diz, na própria sigla, que o arquivo é do dia que fechou. Para ele, um guia sobre «como integrar os dados da Stone» começa por esse fato, porque ele decide para que pergunta a fonte serve.
A posição dele é a de que a chave pedida ao contato comercial é parte do desenho, e não um detalhe de cadastro. Ele vê a camada de Dados do Visio OS como o lugar onde o dia fechado da Stone encontra o dia em curso do PDV, sem que alguém precise montar a planilha que os une.
Perguntas frequentes
A Stone tem API para integrar os dados?
Tem, por credenciamento. A página de perguntas e respostas da API de Conciliação, consultada em 12/10/2026, diz que ela entrega um XML do D-1 a cliente credenciado, e que a chave de afiliação (AffiliationKey) é pedida ao contato comercial da Stone.
O que é o D-1 na API de Conciliação da Stone?
É o dia anterior. Segundo a página consultada em 12/10/2026, a API entrega o XML do D-1, ou seja, o arquivo do dia anterior ao da consulta.
Em que formatos sai o relatório de vendas da Stone?
Em PDF, XLS ou CSV, segundo a página de ajuda da Stone consultada em 12/10/2026.
A Stone tem MCP oficial?
Nas páginas consultadas em 12/10/2026, a Stone não publica MCP próprio. Para a sua IA ler a Stone, o dado entra na camada e sai pelo MCP da Visio, com o seu login, em modo de leitura.
E se o caminho da Stone na minha operação não estiver claro?
O próximo passo é o mapeamento: quais afiliações Stone a operação tem, em quais lojas e qual caminho cada uma comporta. 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.
Próximos passos
O primeiro passo é o mapeamento de quais afiliações Stone a operação tem, em quais lojas, e de qual caminho cada uma comporta.
Para ver a camada completa, leia a página da camada de Dados.
Ver também
- Como integrar os dados da maquininha de cartão
- Como integrar os dados da Conciliadora
- Como integrar os dados da Getnet
- Como integrar os dados do extrato bancário
Conclusão
Integrar os dados da Stone é ler o dia que fechou: um XML do D-1 por credenciamento, o relatório de vendas em arquivo ou a conta por parceria. A camada põe esse dia fechado ao lado do dia em curso do PDV e do extrato do banco, por loja, e a Stone passa a ser uma trilha da linha do tempo.
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.