Como integrar os dados do Nibo no Visio OS

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

Para integrar os dados do Nibo, a documentação pública dele traz duas APIs, a Nibo Empresa e a Nibo Obrigações, ambas com API Key e filtros OData, e os relatórios exportam em XLSX, CSV ou PDF (páginas consultadas em 12/10/2026). Levado à camada de Dados do Visio OS, o Nibo entra por API como fonte financeira, 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.

Duas APIs com o mesmo nome de família

Quem procura a API do Nibo encontra mais de uma. O portal do desenvolvedor documenta a API Nibo Empresa e a API Nibo Obrigações, e a primeira dúvida de quem integra é qual das duas a pergunta pede. O que cada uma devolve está na documentação do Nibo.

Uma observação prática: o endereço do portal, developer.nibo.com.br, redireciona para nibo.readme.io. Quem salva o link para a equipe técnica deve salvar o endereço final, para não depender do redirecionamento.

Escolher a API certa resolve o acesso ao Nibo, mas a pergunta de gestão de uma rede passa também pelo PDV, pelo extrato bancário, pela nota de compra e pelo delivery. Na camada de Dados do Visio OS, o Nibo entra como uma dessas fontes, por loja, com cada número definido uma vez pela Visio.

O que o Nibo documenta

As páginas públicas do Nibo trouxeram, em 12/10/2026, três fatos.

O primeiro são as APIs. O portal do desenvolvedor (portal do desenvolvedor do Nibo, consultado em 12/10/2026) documenta a API Nibo Empresa e a API Nibo Obrigações, com API Key e filtros OData.

O segundo é a exportação. A central de ajuda (ajuda.nibo.com.br, consultada em 12/10/2026) indica que os relatórios exportam em XLSX, CSV ou PDF. A página não lista as colunas de cada relatório.

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

Qual das duas APIs a pergunta pede

A escolha começa pela pergunta. Antes de abrir a documentação, vale escrevê-la e só então procurar, em cada API, o recurso que a atende.

Uma pergunta sobre os lançamentos financeiros da loja vai procurar o recurso correspondente na documentação. Qual API o tem, está nas páginas do Nibo.
Uma pergunta sobre obrigações vai à outra API, se o recurso estiver lá. Isso também está na documentação.
Uma pergunta que cruza os dois assuntos pode pedir as duas APIs. A autenticação por API Key e os filtros OData são citados para as duas; a página não diz se a mesma chave serve às duas.

Em qualquer dos casos, o mapeamento da Visio registra, fonte por fonte, qual recurso atende qual pergunta, e a camada mantém a definição de cada número.

Como avaliar o caminho do Nibo: 5 critérios

Qual API. Nibo Empresa ou Nibo Obrigações; escreva a pergunta antes de escolher.
A API Key. Registre quem do grupo a recebe, de onde ela vem (a página consultada não diz) e onde fica guardada.
Os filtros OData. Eles permitem pedir só o recorte que a pergunta precisa; quem constrói precisa conhecê-los.
Por CNPJ e por loja. Cada CNPJ e cada loja precisam aparecer separados na análise.
O formato do arquivo. Se a rotina for por exportação, XLSX e CSV são planilhas, e o PDF serve a quem lê.

Principais caminhos para integrar os dados do Nibo

Os caminhos são as duas APIs do Nibo, o arquivo exportado e, por cima deles, a camada.

1. A API Nibo Empresa

É o caminho de programa da primeira API do portal, com API Key e filtros OData. Quem constrói por aqui lê a documentação em nibo.readme.io, guarda a chave e monta a leitura. A API devolve o dado do Nibo; a definição de cada número, o cruzamento com o extrato e a permissão por loja ficam com quem constrói.

2. A API Nibo Obrigações

É a segunda API, também com API Key e filtros OData. Ela só entra no plano se a pergunta do grupo estiver no recurso dela. Como as duas aparecem juntas na documentação, o registro de qual foi usada para qual pergunta evita que a integração dependa da memória de uma pessoa.

3. A exportação de relatórios em XLSX, CSV ou PDF

É o caminho de arquivo, e o único em que a página cita três formatos. Quem opera a conta exporta o relatório, na frequência dele. O XLSX e o CSV podem ser processados como planilha e alimentam uma rotina; o PDF fica para conferência de quem lê. O que cada relatório traz, a página não diz.

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

O Nibo entra na camada por API, com o dado por CNPJ e por loja, e passa a ser lido junto do PDV, do extrato (Open Finance, com o consentimento do titular) e da nota (certificado digital de cada CNPJ).

A promessa de integração é a da 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. Se nenhum dos caminhos acima couber, verifique com a Visio se já existe forma homologada ou parceiro integrador, porque a Visio não extrai dado contra os termos de uso de um sistema.

O que o Nibo passa a responder, e onde o dado financeiro fica

Dado financeiro pede uma pergunta antes das outras: onde ele fica e quem o vê. A resposta da Visio é objetiva. O dado fica na nuvem que o grupo já usa, isolado por empresa, cifrado em repouso e no acesso. O registro de acesso é centralizado e cada consulta fica registrada. O DPA é público, e a Visio é a operadora do dado. Certificação própria não há; as certificações são do provedor de nuvem, e a Visio diz isso.

Com isso posto, o Nibo responde a perguntas que antes exigiam exportar. Ao lado do extrato, o que o Nibo registrou pode ser lido contra o que a conta recebeu. Ao lado do PDV, o financeiro de cada loja acompanha a venda dela. A conversa da sua IA fica com a sua IA; à Visio chega o pedido de dado, conferido contra as permissões de quem pergunta.

O MCP da Visio vem incluído em todos os planos do Visio OS, e a IA conectada por ele só lê.

Duas maneiras de ler o Nibo depois que ele entra

Com o Nibo na camada, a leitura acontece por dois caminhos. No primeiro, tudo no Visio OS: as Tools da Visio usam o dado, e a rotina da loja mora na plataforma. No segundo, na sua IA, via MCP: a pessoa conecta a IA que já usa, entra com o login da Visio, pergunta o que pode ver e faz a pergunta em linguagem normal, com as suas exceções.

Quem já tem um painel não precisa trocá-lo. O Power BI e o Looker Studio continuam, e passam a ler, pela API, um dado que já chegou pronto, por loja e com a mesma definição. Não há conector pronto para o painel do grupo.

A estratégia fica na sua IA e a rotina fica na plataforma. O número da plataforma continua limpo para todo mundo, e as exceções de cada análise ficam com quem as faz.

Comparativo dos caminhos para integrar o Nibo

A tabela compara o que as páginas do Nibo descrevem. Onde elas não dizem, a célula diz que não foi possível confirmar.

Critério	API Nibo Empresa	API Nibo Obrigações	Exportação de relatórios	Camada de Dados do Visio OS
O que expõe	A API documentada no portal; o conteúdo, não foi possível confirmar	A API documentada no portal; o conteúdo, não foi possível confirmar	Relatórios do Nibo; as colunas, não foi possível confirmar	O que o caminho escolhido entrega, estruturado por loja
Quem libera	API Key; como obtê-la, não foi possível confirmar	API Key; como obtê-la, não foi possível confirmar	Quem opera a conta	A Visio, a partir do mapeamento
Formato	Filtros OData; o formato de resposta, não foi possível confirmar	Filtros OData; o formato de resposta, não foi possível confirmar	XLSX, CSV ou PDF	Pelo caminho que existe, na mesma linha do tempo
Por loja	Se o time construir	Se o time construir	Manual	Sim, com a mesma definição da rede
Quem mantém	O time do grupo, com a chave	O time do grupo, com a chave	A pessoa que exporta	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 do Nibo» tem uma resposta que começa antes da integração: o portal documenta duas APIs, e o leitor precisa saber qual delas atende à pergunta dele. Para ele, o guia deve mandar o leitor escrever a pergunta primeiro e só depois abrir a documentação.

A posição dele é a de que o dado financeiro rende mais ao lado do PDV e do extrato do que sozinho, e de que o leitor ganha ao registrar qual API foi usada para qual pergunta. Ele vê a camada de Dados do Visio OS como o lugar onde o Nibo passa a ser lido por loja, com a permissão de cada pessoa aplicada no dado.

Perguntas frequentes

O Nibo tem API para integrar os dados?

Sim. O portal do desenvolvedor do Nibo, consultado em 12/10/2026, documenta a API Nibo Empresa e a API Nibo Obrigações, com API Key e filtros OData.

O Nibo tem mais de uma API?

Tem duas documentadas no portal consultado em 12/10/2026: a API Nibo Empresa e a API Nibo Obrigações. O que cada uma devolve está na documentação do Nibo, em nibo.readme.io. O endereço developer.nibo.com.br redireciona para esse, e vale guardar o endereço final.

Como obtenho a API Key do Nibo?

A página consultada em 12/10/2026 cita a API Key, mas não diz de onde ela vem nem quem a emite. Confirme com o Nibo antes de planejar a integração.

Dá para exportar os dados do Nibo sem usar a API?

Sim. A central de ajuda do Nibo, consultada em 12/10/2026, indica que os relatórios exportam em XLSX, CSV ou PDF. A página não lista as colunas de cada relatório.

O Nibo tem MCP oficial?

Nas páginas consultadas em 12/10/2026, o Nibo não publica MCP próprio. Para o dado do Nibo, a IA o lê já estruturado na camada, por meio do MCP da Visio e com o seu login.

E se o caminho do Nibo 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, o Nibo entre elas.

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

Ver também

Conclusão

Integrar os dados do Nibo é escolher, pela pergunta, entre a API Nibo Empresa, a API Nibo Obrigações e o arquivo exportado em XLSX, CSV ou PDF, e entregar o resultado a uma camada que o estruture por CNPJ e por loja, com a permissão de cada pessoa aplicada no dado. O financeiro do Nibo passa a ser lido ao lado do PDV, do extrato e da nota.

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