Como integrar os dados da SumUp no Visio OS

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

Para integrar os dados da SumUp, a documentação pública dela descreve uma API de histórico de transações por código do estabelecimento, com escopo próprio de permissão; o painel baixa a lista de transações em CSV ou XLS; e há um MCP oficial (páginas consultadas em 12/10/2026). Na camada de Dados do Visio OS, a SumUp 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. SumUp aqui é a maquininha da loja vista como fonte de dados: o que passou, a taxa, o que vai cair e quando.

O que a SumUp publica sobre os próprios dados

A consulta de 12/10/2026 olhou três páginas, e as três apontam para dados.

A API de transações. A documentação de transações do portal de desenvolvedores descreve a consulta ao histórico de transações de um estabelecimento. A chamada pede o código do estabelecimento (merchant code) e o escopo transactions.history.
O painel. A central de ajuda da SumUp diz que o painel baixa a lista de transações em CSV ou XLS.
O MCP. A documentação do servidor MCP está na área de ferramentas para IA do mesmo portal.

Com isso, a SumUp publica três caminhos: API pública, arquivo e MCP.

O código do estabelecimento como unidade

A chave da consulta é o código do estabelecimento. Para a rede, a pergunta é como as lojas se distribuem entre códigos: um código por loja, um código para o grupo, ou algo no meio. A documentação lida não responde, e é o primeiro item do mapeamento.

A resposta decide a leitura. Com um código por loja, a consulta já vem separada por loja. Com um código para várias lojas, a separação precisa vir de outro lugar, como o recorte do PDV ou da conta. Na camada, a loja é a unidade: o que a SumUp entrega é amarrado à loja, e não ao código, e a definição de cada número é a mesma em toda a rede.

O escopo transactions.history

O escopo é o nome da permissão que a API pede para devolver o histórico. O nome está na página; de que forma o escopo é concedido e renovado, a página não informa.

Para o desenho, o que importa é que a consulta é de leitura: a camada pede o histórico e não escreve na SumUp. A IA conectada também só lê.

Como avaliar o caminho da SumUp: 5 critérios

Quantos estabelecimentos SumUp, quantos CNPJs. Cada código de estabelecimento é uma consulta.
Como as lojas se distribuem entre códigos. Um por loja, um por grupo ou uma mistura.
API ou arquivo. A API devolve o histórico por estabelecimento; o CSV ou XLS sai do painel, de quem entra nele.
Que IA já lê a SumUp. Se o time já usa o MCP, defina se a IA continua conectando a cada fornecedor ou passa a conectar uma vez, pela Visio.
Desde quando. A data a partir da qual o histórico de cada loja é completo.

Principais caminhos para integrar os dados da SumUp

Três caminhos nascem na SumUp e o quarto é o que a camada faz com eles.

1. A API pública de histórico de transações

É o caminho de programa. A documentação é pública e a consulta é por estabelecimento. A API devolve o histórico da SumUp; o banco e a nota vêm de outras fontes.

2. O CSV ou XLS baixado no painel

É o caminho de arquivo: alguém entra no painel e baixa a lista de transações em CSV ou XLS. As colunas de cada formato não aparecem na página de ajuda.

3. O MCP oficial da SumUp

É o caminho da IA até a SumUp. Quem o usa pergunta à SumUp e ouve a SumUp. A página lida não detalha o que o servidor expõe.

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

Pelo caminho que a conta permitir, a SumUp entra por loja e por CNPJ, na classe maquininha, na mesma linha do tempo da venda do PDV, do extrato do banco (por Open Finance, com o consentimento do titular da conta) 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 SumUp das suas lojas

Duas IAs, uma pergunta

Quando um fornecedor publica MCP, a operação passa a ter duas formas de a IA chegar ao dado: pelo MCP do fornecedor, que responde pelo que está na SumUp, ou pela camada, que responde pelo que está em todas as fontes. A segunda forma resolve a pergunta que atravessa fontes, como a diferença entre o que a SumUp registrou e o que o banco recebeu.

A camada não substitui o MCP da SumUp: onde o fornecedor publica um MCP, o MCP da Visio opera esse MCP por trás. A pessoa conecta a IA uma vez, e gerencia as conexões num lugar só.

O que fica com a IA e o que fica com a Visio

O desenho de privacidade vale para a SumUp como para qualquer fonte. A conversa fica com a IA da pessoa: a pergunta como foi digitada, o histórico, a resposta. O que chega à Visio é o pedido de dado que a IA faz em nome da pessoa, conferido contra as permissões dela, e cada consulta ao dado fica registrada.

A permissão vai dentro da consulta: o gerente da loja 12 vê a SumUp da loja 12, a gestão vê o grupo, e a mesma regra vale para a IA de cada um.

O que a pergunta em linguagem normal alcança

Com a SumUp na linha do tempo, as perguntas deixam de depender de quem segura a planilha. A pessoa pergunta na IA que já usa, com o seu login, e faz perguntas como o recorte de dia contra noite por loja, para ver se os gerentes estão no piso no pico, ou a comparação regional sem as lojas em reforma. A resposta vem em minutos, e não em dias, porque o dado já chegou pronto.

Há ainda o fluxo de volta: cada Tool do Visio OS que o time usa escreve de volta o que produz, e esse dado entra na base e deixa o resto mais inteligente.

Segurança do dado da SumUp na camada

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. A Visio não tem certificação própria: as certificações são do provedor de nuvem, e a Visio diz isso. Exportar um CSV do painel e circular o arquivo é o jeito menos seguro de mover o dado.

Quem já usa Power BI ou Looker Studio

O painel que o time de dados já mantém continua. Pelo caminho da SumUp que a conta permitir, o dado chega pronto à camada, e o painel passa a ler pela API da camada, por loja e com a mesma definição de cada número. A SumUp deixa de ser mais uma fonte para o painel juntar à mão.

Desde quando o dado da SumUp é bom

Uma loja que abriu o estabelecimento SumUp no meio do ano tem um histórico que começa nessa data. O mapeamento da Visio registra, fonte por fonte, desde quando o dado é bom, e a sua IA respeita isso ao comparar lojas. Duas lojas com históricos de tamanhos diferentes só se comparam com as duas datas na resposta, e a camada as mostra. A frequência de extração é da Visio: pelo menos todo dia, cada fonte na sua, sem promessa de atualização instantânea.

Comparativo dos caminhos para integrar a SumUp

A tabela lista o que as páginas da SumUp descrevem, consultadas em 12/10/2026.

Critério	API de transações	Painel (CSV ou XLS)	MCP oficial
O que entrega	O histórico de transações do estabelecimento	A lista de transações	O que o servidor expõe; o detalhe, não mencionado nas páginas públicas
Como se acessa	Código do estabelecimento e escopo transactions.history	Login no painel	Conforme a documentação do servidor
Formato	Resposta da API	CSV ou XLS	Não se aplica
Cruza com PDV e banco	Só se o time construir a junção	Só se alguém juntar os arquivos	Não: responde pelo que está na SumUp

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que a SumUp publica três caminhos de uma vez: API pública, arquivo e MCP. Para ele, quem busca «como integrar os dados da SumUp» precisa primeiro escolher o caminho pela pergunta que quer responder, e só depois pela facilidade de cada um.

A posição dele é a de que um MCP de fornecedor é uma boa notícia e não uma resposta completa: ele leva a IA até a SumUp, e a pergunta de gestão atravessa mais de uma fonte. Ele vê a camada de Dados do Visio OS como o lugar onde as duas coisas se juntam, a SumUp com o seu MCP e o resto da operação com a mesma definição de número.

Perguntas frequentes

A SumUp tem API pública para integrar os dados?

Tem. A documentação consultada em 12/10/2026 descreve uma chamada de histórico de transações por código do estabelecimento (merchant), com um escopo próprio de permissão, chamado transactions.history.

Dá para baixar as transações da SumUp em arquivo?

Dá. A central de ajuda da SumUp, consultada em 12/10/2026, diz que o painel permite baixar a lista de transações em CSV ou XLS.

A SumUp tem MCP oficial?

Tem. A SumUp documenta um servidor MCP oficial na área de ferramentas para IA do portal de desenvolvedores, segundo a página consultada em 12/10/2026. É um fato sobre o fornecedor, e não sobre a Visio.

Se a SumUp já tem MCP, ainda preciso da camada?

O MCP da SumUp leva a IA até a SumUp e responde pelo que está nela. Para a pergunta que cruza a SumUp com o PDV, o banco e a nota, a camada junta as fontes por loja, e o MCP da Visio, quando o fornecedor publica um, opera esse MCP por trás.

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

O próximo passo é o mapeamento: quais estabelecimentos SumUp a operação tem, em quais lojas e como cada um conecta. 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 estabelecimentos SumUp a operação tem, em quais lojas, e de como cada um conecta.

Fale com um especialista e mapeie os estabelecimentos SumUp da operação

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

Ver também

Conclusão

Integrar os dados da SumUp é partir do que ela mesma publica, uma API de transações, o arquivo do painel e um MCP, e perguntar o que cada caminho deixa de fora: a conta bancária, o PDV e a nota. A camada responde a essa pergunta por loja, e a SumUp passa a ser uma trilha da linha do tempo, não uma consulta isolada.

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.