Como integrar os dados do BTG Pactual no Visio OS

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

Para integrar os dados do BTG Pactual no Visio OS, o caminho começa pela documentação que o próprio banco publica: conta PJ do BTG, cadastro como desenvolvedor e um aplicativo criado no Developer Console, com autenticação OAuth 2.0 pelo BTG Id. A camada de Dados do Visio OS recebe essa fonte por loja e deixa o dado pronto pra IA que você já usa.

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 este guia separa o que a página pública do BTG Pactual documenta sobre acesso aos dados daquilo que a camada faz com o dado depois que ele entra.

Por que os dados do BTG Pactual importam para a operação da rede

Numa rede que opera com o BTG Pactual, o saldo e o extrato de cada conta fazem parte da resposta que a gestão precisa: quanto entrou, quanto saiu, o que casou com a venda do dia e o que não casou. Enquanto esse dado mora num lugar separado, a pergunta que o cruza com a venda começa por uma extração.

O problema não é o banco, é o que cerca o dado bancário. A conta é de cada CNPJ, a venda é de cada PDV, a nota é de cada loja, e a pergunta que a direção faz, se a região caiu ou se o caixa da loja fecha, atravessa as três. Cada travessia começa por uma extração.

A camada de Dados do Visio OS parte de outro lugar: em vez de a pessoa buscar o extrato, a fonte entra uma vez, por loja, e fica ao lado do resto na mesma linha do tempo, com uma definição por número escrita uma vez. A partir daí, a sua IA lê a operação com o seu login, e o extrato deixa de ser um arquivo que alguém abre e passa a ser uma trilha que responde junto com a venda.

Como avaliar o caminho do BTG Pactual: 5 critérios

Cinco critérios mostram o que o caminho de acesso do BTG Pactual entrega, antes de qualquer decisão de fornecedor. Cada um tem uma pergunta para levar ao mapeamento quando a página pública não responde.

Quem libera o acesso. Pela página do BTG Pactual, o acesso à API exige conta PJ do BTG, cadastro como desenvolvedor e a criação de um aplicativo no Developer Console, feita por usuário administrador ou vinculado à conta. Quem, na sua rede, é esse usuário é pergunta para o mapeamento.
Que formato sai. A página do BTG Pactual descreve a autenticação OAuth 2.0 pelo BTG Id e lista as APIs de Banking PJ, com boletos, saldo e extrato, Pix, pagamentos e webhooks. O detalhe do conteúdo de cada resposta se confirma no mapeamento, fonte por fonte.
Se vem por loja. A API é da conta PJ, e a pergunta que a rede faz é por loja. O que a camada acrescenta é o recorte: cada conta no seu lugar, ao lado da venda e da nota daquela loja, na mesma linha do tempo.
Quem mantém. A página descreve a criação do aplicativo em Sandbox e Produção e não diz quem o mantém depois. Essa pergunta vai para o mapeamento.
O que fica de fora. A página consultada em 22/10/2026 descreve o acesso por API e não menciona exportação de arquivo nem um MCP próprio do BTG Pactual (developers do BTG). O que não está na página é pergunta para o mapeamento.

Principais caminhos para integrar os dados do BTG Pactual

Quatro caminhos aparecem quando se olha o BTG Pactual como fonte de dado de uma rede de lojas. Os três primeiros são o que a página pública do banco descreve, ou deixa de descrever; o quarto é o que a camada faz com o dado que chega.

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

A página do BTG Pactual, consultada em 22/10/2026 (empresas.btgpactual.com/developers), diz que o portal de documentação é público e lista Banking PJ, com boletos, saldo e extrato, Pix, pagamentos e webhooks. Diz também que o acesso exige conta PJ do BTG, cadastro como desenvolvedor e a criação de um aplicativo no Developer Console, em Sandbox e Produção, por usuário administrador ou vinculado à conta, com autenticação OAuth 2.0 pelo BTG Id.

A página não detalha é o que cada resposta traz e como o seu extrato se organiza por loja; isso é trabalho de mapeamento, feito fonte por fonte, com a sua operação.

2. A exportação

A página do BTG Pactual consultada em 22/10/2026 descreve o acesso por API e não menciona exportação de arquivo. O caminho de cada fonte é definido no mapeamento, e a camada trata um arquivo, se a rede o tiver, como mais uma fonte, por loja.

3. O MCP do fornecedor

MCP é o caminho da sua IA até os dados de uma fonte. A página do BTG Pactual consultada em 22/10/2026 não menciona um MCP próprio do banco O que existe, documentado na mesma página, é a API de Banking PJ com autenticação OAuth 2.0.

Na camada de Dados, a sua IA conecta uma vez à Visio, com o login da Visio, e lê a operação que está na camada. Onde um fornecedor publica MCP próprio, o MCP da Visio opera esse MCP por trás, e você gerencia num lugar só. O caminho do BTG Pactual, especificamente, se confirma no mapeamento.

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

Aqui o dado deixa de ser uma consulta isolada e passa a ser uma trilha da loja. A camada conecta toda fonte que o seu negócio roda, estrutura e deixa pronto pra IA: cada número com uma definição escrita uma vez pela Visio, todas as fontes juntas por loja na mesma linha do tempo, as contas pesadas pré-calculadas e a permissão de quem pergunta dentro da consulta, por usuário, por loja e por app, aplicada no dado.

Do lado de quem pergunta, a mudança é direta. O gerente vê a loja dele, o supervisor vê as dele, a direção vê todas, na mesma plataforma e com a mesma definição de cada número, e a sua IA responde com o login e as permissões de quem pergunta. O extrato bancário fica ao lado da venda, da nota e do delivery daquela loja.

Para ver como isso fica na prática da sua rede, fale com um especialista.

Comparativo: os caminhos do BTG Pactual e a camada de Dados do Visio OS

A tabela compara o que a página pública do BTG Pactual sustenta em cada caminho com o que a camada de Dados entrega. Onde a página não afirma, a célula diz isso.

Critério	API do BTG Pactual	Exportação	MCP do fornecedor	Camada de Dados do Visio OS
Quem libera	Conta PJ do BTG, cadastro de desenvolvedor e aplicativo no Developer Console, por usuário administrador ou vinculado à conta	Conforme o sistema	Conforme o sistema	Conforme o sistema
Formato	Documentação pública do BTG Pactual, com autenticação OAuth 2.0 pelo BTG Id	Conforme o sistema	Conforme o sistema	Dado estruturado por loja, com uma definição por número
Por loja	Conforme o sistema	Conforme o sistema	Conforme o sistema	Por loja, na mesma linha do tempo da venda e da nota
Quem mantém	Conforme o sistema	Conforme o sistema	Conforme o sistema	Conforme o sistema

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que a página do BTG Pactual descreve o que é preciso para acessar a API, em que ambientes o aplicativo roda e como a autenticação funciona. Para ele, isso é a primeira metade da conversa, a do acesso.

A segunda metade é a do uso. Na leitura dele, o que importa é o dado bancário entrar por loja, com a mesma definição de receita que a venda usa, e ficar disponível para a IA que a gestão já usa.

Perguntas frequentes

Como a documentação do BTG Pactual descreve o acesso à API?

A página consultada em 22/10/2026 diz que o portal de documentação é público e lista Banking PJ, com boletos, saldo e extrato, Pix, pagamentos e webhooks. Diz também que o acesso exige conta PJ do BTG, cadastro como desenvolvedor e a criação de um aplicativo no Developer Console, em Sandbox e Produção, por usuário administrador ou vinculado à conta, com autenticação OAuth 2.0 pelo BTG Id.

Existe exportação dos dados do BTG Pactual para quem não tem time de TI?

A página consultada em 22/10/2026 descreve o acesso por API e não menciona exportação de arquivo O caminho de cada fonte é definido no mapeamento da operação.

O que muda quando os dados do BTG Pactual entram por loja?

Muda a pergunta que se consegue fazer. A conta PJ vira uma trilha da loja, ao lado da venda, da nota e do delivery, na mesma linha do tempo e com uma definição por número escrita uma vez; o gerente vê a loja dele, a direção vê todas, e a sua IA responde com o login de quem pergunta.

Existe MCP do próprio BTG Pactual para a minha IA ler?

A página consultada em 22/10/2026 não menciona um MCP próprio do BTG Pactual O que a operação usa é o MCP da Visio, que liga a IA que você já usa à camada de Dados com o seu login, e onde um fornecedor publica MCP próprio, o MCP da Visio opera esse MCP por trás. O caminho do BTG Pactual nesse ponto se confirma no mapeamento.

E se o caminho do BTG Pactual na minha operação não estiver claro?

O mapeamento resolve isso: ele lista quais fontes a operação já tem e como cada uma conecta, fonte por fonte, e diz desde quando o dado de cada uma é bom. É o próximo passo do contato com a Visio, e é o que transforma a dúvida sobre um fornecedor específico num desenho de integração para a sua rede.

Próximos passos

O caminho para integrar o BTG Pactual na sua operação começa pelo mapeamento das fontes: quais contas a rede tem, por loja, e como cada uma conecta. 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 fontes da sua rede.

Para o mapeamento do BTG Pactual, as perguntas que a página deixa abertas são estas: qual usuário administrador, ou vinculado à conta PJ, cria o aplicativo no Developer Console; se a rede começa em Sandbox antes de Produção; quais das APIs de Banking PJ a rede quer ler, entre boletos, saldo e extrato, Pix, pagamentos e webhooks; e como cada conta PJ se liga a uma loja na linha do tempo. Cada resposta define como o BTG Pactual entra ao lado das outras fontes, e o que a página não responde fica como pergunta, e não como afirmação.

Para ver a camada inteira, leia o que é camada de dados. Para o passo a passo das fontes que entram junto com o banco, leia como integrar PDV, ERP, banco e nota fiscal.

Ver também

Conclusão

Integrar os dados do BTG Pactual no Visio OS começa pelo que a página do banco já documenta: conta PJ, cadastro de desenvolvedor, aplicativo no Developer Console em Sandbox e Produção, com autenticação OAuth 2.0 pelo BTG Id. O que a camada acrescenta é o depois: a fonte entra por loja, com uma definição por número, e a sua IA lê o resultado pelo MCP com o seu login, sem ninguém exportar arquivo no caminho. 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.