Como integrar os dados da Arquivei no Visio OS
Para integrar os dados da Arquivei, a central de ajuda da Qive descreve uma API disponível a todas as empresas e escritórios, com credenciais emitidas pela própria Qive depois de testes no sandbox, e as operações em lote exportam para Excel (página sobre a API Arquivei, consultada em 12/10/2026). Na camada de Dados do Visio OS, a nota fiscal da empresa entra pelo certificado digital de cada CNPJ, sem ninguém baixar XML, e fica por loja ao lado da venda e do banco.
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. Arquivei aqui é a fonte de notas fiscais, uma das classes de dado que a camada de Dados do Visio OS conecta. As fontes financeiras vizinhas têm página à parte: como integrar os dados da Conciliadora e como integrar os dados do Nibo.
O que a página da Qive diz sobre a API da Arquivei
A consulta de 12/10/2026 à página «API Arquivei» da central de ajuda da Qive encontrou cinco fatos.
- A abrangência. A API é descrita como disponível a todas as empresas e escritórios.
- A credencial. Quem a emite é a Qive, e a emissão vem depois de testes no sandbox. O primeiro contato com a API, portanto, acontece num ambiente de teste.
- A documentação. O material para quem desenvolve fica em developers.qive.com.br.
- O preço. A página associa o preço da API ao volume de documentos. A página não traz cifra.
- O lote. As operações em lote exportam para Excel. As colunas do arquivo não aparecem na página.
Fora isso, nas páginas consultadas a Arquivei não publica MCP próprio. A leitura da nota pela sua IA não passa pela Arquivei: passa pelo MCP da Visio, depois que a nota entrou na camada.
Duas portas para a mesma nota
Quando a empresa já guarda as notas na Arquivei, a mesma nota tem duas portas para chegar à camada de Dados do Visio OS.
A primeira é a API da Arquivei, que trata a Arquivei como uma fonte entre as outras. A segunda é o certificado digital de cada CNPJ, o caminho que a camada usa para a nota fiscal: cada CNPJ entra pelo certificado dele, a nota fica por loja e ninguém precisa baixar o arquivo de cada documento. As duas terminam no mesmo lugar, a nota por loja na mesma linha do tempo da venda e do banco.
Qual das duas entra primeiro é decisão do mapeamento da sua operação. O que decide é a rede: quantos CNPJs ela tem, quais deles aparecem na conta da Arquivei e desde quando o histórico é bom.
Como avaliar o caminho da Arquivei: 5 critérios
- O sandbox antes da credencial. A Qive emite a credencial depois de testes no sandbox, então o primeiro contato com a API é num ambiente de teste, com a conta da empresa.
- O volume de documentos da rede inteira. O preço da API segue o volume de documentos, e o número que entra na conta é o da rede.
- A cobertura de CNPJs. Cada loja que tem CNPJ próprio precisa aparecer na conta da Arquivei para a nota dela chegar por esse caminho.
- Lote ou leitura por programa. O Excel em lote é um arquivo que alguém gera. A API é uma leitura que um programa repete. A pergunta é qual dos dois a sua rotina aguenta.
- Desde quando o dado é bom. Um número é tão honesto quanto a data em que a fonte começou a ser boa, e o mapeamento diz, fonte por fonte, desde quando.
Principais caminhos para integrar os dados da Arquivei
1. A API da Arquivei
É o caminho de quem constrói. A página da Qive a descreve como disponível a todas as empresas e escritórios, com a credencial emitida depois dos testes no sandbox, e a documentação fica em developers.qive.com.br. Se você é o builder da rede, o primeiro passo é abrir essa documentação com a conta da empresa em mãos e ver o que cada chamada devolve, porque a página de ajuda não lista os campos.
2. A exportação em Excel das operações em lote
É o caminho sem programa. As operações em lote exportam para Excel, e o arquivo sai das mãos de quem opera a conta. O que ele traz por linha é o que a página não diz, e isso se descobre gerando um lote real. Como todo caminho de arquivo, a frequência é a da rotina de quem gera, e rotina se perde quando a pessoa troca de função.
3. O certificado digital de cada CNPJ
É o caminho da camada para a nota fiscal. Cada CNPJ da rede entra pelo certificado dele, a nota chega por loja e o XML não passa pela mão de ninguém. Não depende de a nota estar numa conta da Arquivei; o mapeamento diz qual das duas origens entra primeiro.
4. A Arquivei como fonte da camada de Dados do Visio OS
Pela API ou pelo certificado, a nota entra na camada por loja, com uma definição por número escrita uma vez pela Visio. 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.» Se a rotina da sua empresa pede um caminho que as páginas da Qive não mostram, verifique com a Visio se já existe forma homologada ou parceiro integrador antes de construir. A Visio não extrai dado contra os termos de uso de nenhum sistema.
O que a nota passa a responder junto do resto
Uma nota de compra sozinha é um documento. Na mesma linha do tempo da venda, do estoque e do banco da mesma loja, ela responde a perguntas que atravessam fontes:
- A mercadoria que a nota registra entrou no estoque da loja que a comprou?
- A compra foi paga pela conta dessa loja, e o extrato mostra o pagamento ao lado da nota?
- A conta da Arquivei enxerga os CNPJs de todas as lojas da rede, ou só de parte delas?
O que só o contador tinha passa a estar na operação. Quem pergunta é a IA que você já usa, ligada ao MCP da Visio com o seu login, e ela escolhe a métrica pronta, com a definição escrita, em vez de montar a conta a partir de um arquivo. A mesma regra de visão por loja vale para a IA de cada pessoa.
Comparativo dos caminhos para integrar a Arquivei
A tabela descreve mecanismo. Onde a página da Qive não diz, a célula diz que não foi possível confirmar.
| Critério | API da Arquivei | Exportação em Excel | Certificado digital por CNPJ (camada de Dados do Visio OS) |
|---|---|---|---|
| Situação na página | Disponível a todas as empresas e escritórios | Operações em lote exportam para Excel | Caminho da camada para a nota fiscal |
| Acesso | Credencial emitida pela Qive depois de testes no sandbox | Não foi possível confirmar | Certificado digital de cada CNPJ |
| Formato | Não foi possível confirmar: a documentação fica em developers.qive.com.br | Excel, sem lista de colunas na página | A nota por loja, sem ninguém baixar XML |
| Preço | Associado ao volume de documentos | Não foi possível confirmar | Sem cifra: o número vem depois do mapeamento |
| Frequência | Não foi possível confirmar | A de quem gera o lote | Pelo menos todo dia, cada fonte na sua frequência de extração |
| Quem opera | Quem constrói a leitura | A pessoa que gera o lote | A Visio: nada para hospedar nem manter |
Opinião do Head of Content
Lorenzo Lopez, Head of Content da Visio, observa que a Arquivei é uma fonte com duas portas legítimas e que a conversa útil com o fornecedor não é «vocês têm API?», e sim «qual porta a minha operação usa e desde quando o histórico é bom». Para ele, a página da Qive responde a primeira pergunta com clareza e deixa a segunda para quem conhece a conta.
A posição dele é a de que a decisão entre API e certificado não é de gosto. Ele a vê como uma conta de cobertura: quantos CNPJs a conta da Arquivei enxerga, e quantos o certificado alcança. A camada de Dados do Visio OS, na leitura dele, é o lugar em que as duas respostas deixam de ser dois relatórios e viram a mesma nota por loja.
Perguntas frequentes
A Arquivei tem API para a empresa?
A central de ajuda da Qive, consultada em 12/10/2026, descreve a API Arquivei como disponível a todas as empresas e escritórios, com credenciais emitidas pela Qive depois de testes no sandbox e documentação em developers.qive.com.br.
Como se obtém a credencial da API da Arquivei?
A página consultada em 12/10/2026 diz que a Qive emite as credenciais depois de testes no sandbox. O passo a passo do pedido não aparece nela, e a pergunta vai à Qive.
Dá para exportar os dados da Arquivei sem usar a API?
Sim, em lote. A página consultada em 12/10/2026 diz que as operações em lote exportam para Excel. As colunas do arquivo não aparecem nela, e o conteúdo se confere gerando um lote real da conta.
A Arquivei tem MCP oficial?
Nas páginas consultadas em 12/10/2026, a Arquivei não publica MCP próprio. A nota chega à sua IA por outro lado: entra na camada pelo certificado ou pela API, e a IA a lê pelo MCP da Visio, com o seu login e dentro das permissões.
O que quer dizer a nota entrar sem baixar XML?
Na camada de Dados do Visio OS, a nota fiscal entra pelo certificado digital de cada CNPJ. Ninguém precisa baixar o arquivo de cada documento para que a pergunta de gestão seja respondida, e a nota fica por loja.
E se o caminho da Arquivei na minha operação não estiver claro?
O próximo passo é o mapeamento: quais CNPJs da rede aparecem na conta da Arquivei, qual porta entra primeiro e desde quando o dado é bom. Se nenhum caminho das páginas da Qive servir, verifique com a Visio se já existe forma homologada ou parceiro integrador.
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 Arquivei entre elas.
- Fale com um especialista sobre o mapeamento das suas fontes
- Fale com um especialista sobre a conta da Arquivei da sua rede
- Fale com um especialista da camada de Dados do Visio OS
Para ver a camada completa, leia a página da camada de Dados. Para as fontes financeiras vizinhas, leia como integrar os dados da Conciliadora e do Nibo.
Ver também
- Como integrar os dados da Conciliadora
- Como integrar os dados do Nibo
- Como conectar a IA nos dados da minha loja
Conclusão
Integrar os dados da Arquivei é conhecer a API que a Qive descreve, o lote que sai em Excel e o certificado digital que a camada usa para a nota, e escolher no mapeamento a porta que cobre os CNPJs da sua rede. A nota deixa de ser um arquivo por loja e vira dado por loja, ao lado da venda e do banco, com a permissão de cada pessoa aplicada no dado.
Dados deixam tudo pronto pra usar. O Visio OS transforma em tarefa certa, pra pessoa certa.