NFS-e Nacional: captura, requisitos e sistemas | Flow Fiscal
LEGISLAÇÃO E TECNOLOGIA

Captura de NFS-e Nacional: requisitos, Qive e Flow Fiscal

A captura de NFS-e Nacional deve ser avaliada pela origem do documento, pela autorização de acesso e pela cobertura do sistema contratado. A existência de uma API nacional não garante acesso a qualquer nota, recuperação de todo o histórico ou disponibilidade imediata.

Este guia é publicado pela FideFlow e apresenta requisitos técnicos e critérios para avaliar a Qive e o Flow Fiscal. Não descreve uma integração entre as duas plataformas.

O que o ADN disponibiliza ao contribuinte

O Ambiente de Dados Nacional (ADN) participa do compartilhamento de documentos da NFS-e. O manual oficial das APIs para contribuintes descreve consultas de documentos em que o contribuinte figura como emitente, tomador ou intermediário, além de eventos vinculados à chave da nota.

O manual também prevê consultas com certificado de CNPJ da mesma raiz do contribuinte consultado, sujeitas à validação do serviço. Essa regra não equivale a uma permissão para consultar CNPJs sem vínculo. Confira a documentação técnica vigente antes de definir a integração.

Como avaliar a disponibilidade de uma nota

  1. Identifique o documento: registre chave, data, prestador, tomador e origem. Confirme que a empresa foi identificada no papel correto.
  2. Confira o acesso: verifique certificado, validade, CNPJ consultado e configuração do canal utilizado.
  3. Confira o processamento: examine a última consulta e o retorno. Uma nota ausente no painel não prova que ela não existe.
  4. Trate as diferenças: preserve a origem do arquivo e confronte divergências de valores, situação ou retenções com o responsável fiscal.

O que a Qive documenta para NFS-e

No guia de consulta de NFS-e da Qive, a empresa descreve consulta nacional com certificado A1 e configurações municipais pelo NFSe Connect. Quando há cidade configurada nesse canal, o guia informa prioridade para os dados municipais.

A documentação apresenta consultas periódicas e condições para documentos retroativos; portanto, não deve ser interpretada como promessa de captura instantânea de qualquer histórico. Confirme os requisitos da cidade e as condições do plano. Essas são informações publicadas pela Qive, não resultados de um teste realizado neste artigo.

O que verificar no Flow Fiscal

Consulte a apresentação do Flow Fiscal para serviços e descreva sua operação antes de contratar. Peça confirmação dos canais disponíveis para os seus documentos, do certificado exigido e dos recursos incluídos no plano.

  • Há cobertura para notas tomadas, prestadas ou ambas no seu cenário?
  • Quais fontes e municípios atendem aos documentos que você precisa?
  • Qual histórico pode ser consultado e qual precisa ser importado?
  • Como o painel informa falhas, notas pendentes e atualização da consulta?
  • Quais etapas financeiras estão disponíveis e quais dependem de configuração ou conferência?
Captura e apuração são etapas diferentes. Receber o XML não comprova que pagamentos, retenções ou guias foram calculados corretamente. Valide os dados e o fluxo financeiro aplicável à empresa.

Como comparar os sistemas com evidências

Use uma amostra de documentos da sua rotina que você tenha autorização para testar. Registre quais foram encontrados, a origem de cada um e as diferenças em relação ao resultado esperado. Inclua uma nota cancelada ou substituída quando disponível, para verificar como a situação é exibida.

Compare também exportação, permissões e tratamento de duplicidades. Guarde o resultado da demonstração junto à proposta comercial. A escolha deve considerar os fluxos demonstrados e o escopo contratado, sem presumir cobertura universal pelo nome “nacional”.

Perguntas frequentes

A API do ADN permite consultar notas de qualquer empresa?

Não. O manual dos contribuintes descreve o acesso a documentos em que o contribuinte participa como emitente, tomador ou intermediário. A consulta depende das regras de identificação e certificado do serviço.

NFS-e Nacional significa captura instantânea?

Não. A emissão, a disponibilização pela fonte e o processamento no sistema são etapas distintas. Confira a última consulta, os retornos e o prazo de atualização informado pelo fornecedor.

Capturar uma NFS-e já gera o pagamento e as guias de retenção?

A captura do documento não comprova a execução dessas etapas. Verifique os recursos contratados, o mapeamento dos dados, as permissões e a conferência fiscal antes de usar as informações no financeiro.

O que confirmar antes de contratar captura de NFS-e?

Informe o CNPJ, o papel da empresa nas notas, os municípios, os certificados e o histórico necessário. Peça a confirmação da cobertura, da configuração e do tratamento de notas ausentes ou divergentes.

Voltar para o Blog Fiscal

Pare de caçar XML dos seus fornecedores

Organize os XMLs e acompanhe a captura dos documentos disponíveis ao seu CNPJ no Flow Fiscal. A cobertura depende do tipo de documento, da fonte consultada e da configuração. Confira os requisitos de certificado A1, os recursos de manifestação e as condições do plano.

Testar grátis por 3 dias úteis Ver como funciona →
Consulte os requisitos de conexão e as condições do teste.