Como integrar os dados da nota fiscal eletrônica no Visio OS
Para integrar os dados da nota fiscal eletrônica, a nota de compra entra na camada de Dados do Visio OS pelo certificado digital de cada CNPJ, sem ninguém baixar XML, e fica por loja ao lado da venda, do estoque e do banco. É o caminho de quem tem uma rede: cada CNPJ entra pelo certificado dele, e a pergunta que atravessa a nota e o resto deixa de começar por uma extração.
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. Esta é a página-mãe da nota fiscal: trata da nota como classe de fonte e do certificado como caminho. Quem usa um serviço específico que guarda notas, como a Arquivei, encontra o que é próprio dele em como integrar os dados da Arquivei.
A nota fiscal como uma das classes de fonte
A camada de Dados do Visio OS é a camada 1 de 9 do sistema e conecta, nas palavras da Visio, toda fonte que o seu negócio roda. As classes são estas: ERP e PDV, nota fiscal, bancos, delivery, os aplicativos que o time usa, câmeras e sensores, e o uso das próprias ferramentas. A nota fiscal é a que traz para dentro da operação o que só o contador tinha.
Da nota chegam a compra e a venda por CNPJ. Isso importa para quem toca várias lojas porque a unidade da camada é a loja: a nota de cada CNPJ entra pelo certificado dele, e a análise do grupo atravessa as lojas porque cada uma significa a mesma coisa.
Por que o certificado digital, e não o arquivo
O caminho da nota é regulado, e o que a camada usa é o certificado digital do CNPJ. Disso saem três consequências práticas.
Cada CNPJ entra por conta própria. Uma rede com vários CNPJs não depende de alguém reunir os arquivos de todos: o certificado de cada um é a chave da nota dele.
Ninguém baixa XML. A nota de compra não chega por um arquivo que uma pessoa pega, abre e guarda. Chega por loja, e o XML deixa de ser tarefa de alguém.
A nota fica ao lado do resto. Compra, venda, estoque e banco da mesma loja ficam na mesma linha do tempo, com uma definição por número escrita uma vez pela Visio.
Há um limite que não muda: a Visio não faz scraping contra os termos de uso de nenhum sistema. A nota fiscal tem um caminho próprio, o do certificado, e é por ele que a camada entra.
O que só o contador tinha
Na lista do que conta como dado, a camada coloca os sistemas (venda, compra, nota, banco, ponto, estoque, impostos) e, entre eles, o que só o contador tem. A nota fiscal é a porta mais direta para esse conjunto. Quando ela entra por loja, a pergunta «quanto a loja 12 comprou e de quem» deixa de ser um pedido ao escritório e vira uma pergunta que quem decide faz na própria IA.
Esse movimento é o que a Visio chama de dado pronto antes de você pedir. O relatório que alguém remontava a partir de extrato, nota e do que o contador devolve passa a ser consulta.
A nota e o extrato na mesma loja
A nota diz o que foi comprado e de quem. O extrato bancário, que entra pela camada por Open Finance, com o consentimento do titular da conta, diz o que saiu da conta da loja. A venda diz o que entrou. As três trilhas ficam na mesma linha do tempo, por loja, e a pergunta que cruza as três deixa de ser um pedido a três pessoas com três versões do mesmo número.
O que a camada promete e o que deixa de fora na nota
A frequência de extração é da Visio: pelo menos todo dia, cada fonte na sua. A promessa não é de atualização instantânea. A nota é dado da operação, e o dado pessoal que entra fica cifrado e com acesso registrado, com a Visio como operadora e o DPA público. E a camada não extrai nota contra os termos de uso de sistema nenhum: se o certificado não serve a um caso, o caminho é a forma homologada ou o parceiro integrador.
Como avaliar o caminho da nota fiscal: 4 critérios
- Quantos CNPJs a rede tem. A nota entra por CNPJ, então o número de lojas com CNPJ próprio é o tamanho do trabalho de cobertura.
- Compra, venda ou as duas. A camada traz a compra e a venda por CNPJ, e a pergunta de gestão diz por qual das duas começar.
- Ao lado de quê a nota precisa ficar. Estoque, banco e venda da mesma loja são o que transforma o documento em resposta.
- Desde quando o dado é bom. O mapeamento diz, fonte por fonte, desde quando, e a sua IA respeita isso.
Principais caminhos para integrar os dados da nota fiscal eletrônica
1. O certificado digital de cada CNPJ
É o caminho da camada para a nota fiscal. A nota entra pelo certificado de cada CNPJ, sem baixar XML, e fica por loja. É o desenho da classe, e o mapeamento diz, fonte por fonte, quais já estão ligadas e desde quando o dado é bom.
2. A API de quem guarda as notas
Quando a empresa já tem as notas num serviço que as guarda e que oferece API, o serviço vira uma fonte entre as outras, e o caminho dele é o da página pública do fornecedor, com data de consulta. O exemplo da fonte específica desse tipo é a Arquivei.
3. O arquivo exportado pelo sistema
Onde não há API, a exportação ou o relatório do sistema leva a nota até a camada: arquivo XML, JSON, planilha ou relatório agendado. É um caminho de arquivo, com a frequência de quem o gera.
4. O caminho homologado ou o parceiro integrador
Quando nenhum dos anteriores serve, o desenho é o caminho de extração homologado, feito com quem faz o sistema ou com um parceiro integrador. A regra é perguntar antes de construir: verifique com a Visio se já existe forma homologada para o seu caso.
O que a nota passa a responder junto do resto
Uma nota sozinha informa um valor e um fornecedor. Ao lado da venda, do estoque e do banco da mesma loja, ela responde a perguntas de operação:
- Quanto cada loja comprou no mês, e o estoque dela refletiu essa compra?
- Qual a diferença entre o que a nota de compra registra e o que o extrato mostra como pago?
- Quais lojas do grupo compram do mesmo fornecedor, e a venda delas acompanha a compra?
Quem pergunta recebe a fatia que o login permite: a nota da loja para o gerente, as das lojas dele para o supervisor, todas para a direção. A IA lê a métrica pronta pelo MCP da Visio e, quando o dado não permite a resposta, diz que não dá, em vez de inventar a conta a partir de um arquivo.
Comparativo dos caminhos para integrar a nota fiscal eletrônica
A tabela descreve mecanismo. Onde o caminho depende do sistema de origem, a célula diz isso, e o que não foi possível confirmar fica dito.
| Critério | Certificado digital por CNPJ (camada de Dados do Visio OS) | API de quem guarda as notas | Exportação ou relatório do sistema |
|---|---|---|---|
| Quando se aplica | Nota fiscal de qualquer CNPJ da rede | O sistema de origem tem API pública | O sistema de origem não tem API |
| Acesso | Certificado digital de cada CNPJ | Depende do fornecedor | Quem opera o sistema de origem |
| Formato | A nota por loja, sem ninguém baixar XML | Depende do fornecedor | Arquivo XML, JSON, planilha ou relatório agendado |
| Frequência | Pelo menos todo dia, cada fonte na sua frequência de extração | Depende do fornecedor | A de quem gera o arquivo |
| Fica ao lado de | Venda, estoque e banco da mesma loja | Depende do mapeamento | Depende do mapeamento |
| Quem mantém | A Visio: nada para hospedar nem manter | Quem constrói a leitura | A pessoa que gera o arquivo |
Opinião do Head of Content
Lorenzo Lopez, Head of Content da Visio, observa que, na nota fiscal, o caminho regulado cabe numa frase: um certificado por CNPJ e uma nota por loja. Para ele, o que a rede precisa decidir sobre a nota é cobertura: quais CNPJs entram, e desde quando.
A posição dele é a de que o valor da nota está no que ela faz ao lado de outras fontes. Ele considera que a camada de Dados do Visio OS acerta ao tratar a nota como uma trilha na mesma linha do tempo da venda e do banco, e não como um relatório à parte para o contador.
Perguntas frequentes
A camada traz a nota de compra e a de venda?
A camada traz a compra e a venda por CNPJ. A nota de compra fica por loja, ao lado da venda, do estoque e do banco da mesma loja.
Preciso baixar o XML de cada nota?
Não. A nota fiscal entra na camada de Dados do Visio OS pelo certificado digital de cada CNPJ, e ninguém precisa baixar o arquivo de cada documento.
E se a minha rede tem mais de um CNPJ?
Cada CNPJ entra pelo certificado dele, e a nota fica por loja. O mapeamento diz, fonte por fonte, quais já estão ligadas e desde quando o dado é bom.
Com que frequência a nota é atualizada?
Pelo menos todo dia, cada fonte na sua frequência de extração. A frequência de extração é da Visio, e a promessa não é de atualização instantânea.
E se o caminho da nota fiscal eletrônica na minha operação não estiver claro?
O próximo passo é o mapeamento: quais CNPJs a rede tem, qual certificado cobre cada um e qual sistema guarda as notas hoje. Se o caminho pedir uma forma homologada, verifique com a Visio se ela já existe ou se há um 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 nota fiscal entre elas.
- Fale com um especialista sobre o mapeamento das suas fontes
- Fale com um especialista sobre os CNPJs 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 uma fonte específica de notas, leia como integrar os dados da Arquivei.
Ver também
- Como integrar os dados da Arquivei
- Como integrar os dados da Conciliadora
- Como conectar a IA nos dados da minha loja
Conclusão
Integrar os dados da nota fiscal eletrônica é entrar pelo certificado digital de cada CNPJ e deixar a nota por loja, ao lado da venda, do estoque e do banco. O que só o contador tinha passa a estar na operação, com a permissão de cada pessoa aplicada no dado e a sua IA lendo a métrica pronta pelo MCP.
Dados deixam tudo pronto pra usar. O Visio OS transforma em tarefa certa, pra pessoa certa.