XML de NF-e em lote: NSU e diferenças para NFC-e
GESTÃO DE DOCUMENTOS FISCAIS

XML de NF-e em lote: NSU e diferenças para NFC-e

Baixar XML de NF-e em lote pode significar capturar documentos de uma fonte oficial ou exportar arquivos já armazenados em um sistema. Separar essas etapas ajuda a identificar por que uma nota está ausente no fechamento.

Captura e exportação são etapas distintas

A captura obtém os documentos disponíveis ao interessado, conforme as regras da fonte e da integração. A exportação seleciona arquivos do acervo do sistema para download. Um ZIP completo do ponto de vista da exportação ainda pode conter apenas parte das notas esperadas pela empresa.

Para uma nota específica, veja o guia de obtenção de XML de NF-e, NFS-e e CT-e. Aqui, o foco é a continuidade da rotina e a conferência do lote.

Consulta sequencial da NF-e por NSU

Na distribuição de NF-e, a consulta sequencial usa o NSU para continuar a leitura dos documentos disponíveis ao interessado. O certificado identifica o acesso; isso não significa que cada consulta exija uma assinatura XML de evento.

O informe oficial sobre uso da distribuição explica a continuidade pelo ultNSU retornado e o tratamento de consumo indevido. Consulte as regras vigentes antes de configurar intervalos e novas tentativas.

O retorno pode incluir resumos, documentos e eventos conforme a situação. Não interprete todo registro recebido como o XML completo de uma NF-e, nem a consulta como recuperação garantida de todo o histórico.

O que conferir na configuração

  • Identificação: empresa consultada, vínculo com os documentos e certificado compatível.
  • Continuidade: posição de leitura persistida e tratamento de retomada após falha.
  • Limites: respeito aos retornos e às regras da fonte, sem repetir consultas indiscriminadamente.
  • Manifestação: distinção entre Ciência e eventos conclusivos, com configuração e responsáveis definidos.
  • Armazenamento: registro dos arquivos obtidos, eventos e pendências de processamento.

O certificado A1 é um requisito do fluxo de cadastro de certificado do Flow Fiscal. Outros produtos e serviços podem ter compatibilidades diferentes. Veja o comparativo de certificados A1 e A3.

Como obter XML de NFC-e

Não presuma que a NFC-e será obtida pela mesma distribuição de NF-e. Para o estabelecimento emissor, comece pelo sistema de emissão e pelas cópias de segurança. Para outro interessado, solicite o arquivo ao emitente ou confira o serviço autorizado aplicável.

O QR Code serve à consulta pública e não garante download do XML. São Paulo, por exemplo, apresenta um Sistema de Apoio à Escrituração da NFC-e, com serviços para contribuintes recuperarem chaves e arquivos. Esse exemplo não deve ser generalizado para todas as unidades federativas ou para acesso anônimo.

Checklist de exportação e fechamento

  1. Defina empresa, período, critério de data e tipos de documento.
  2. Confira a última consulta e suas pendências antes de exportar.
  3. Compare os documentos encontrados com os controles da empresa.
  4. Exporte o lote e confira seus arquivos, identificadores e situações.
  5. Registre o que falta e quem buscará cada documento.
  6. Confirme que a contabilidade ou o sistema de destino conseguiu importar o material.
Guarda e conferência: automação não garante créditos tributários ou ausência de autuação. Defina a guarda dos arquivos e suas cópias de segurança conforme as obrigações aplicáveis à empresa e o contrato de armazenamento.

Como avaliar o Flow Fiscal para essa rotina

Confirme os documentos cobertos, fontes consultadas, certificado, histórico disponível e recursos de exportação do plano. NF-e, CT-e e NFS-e têm serviços próprios; o suporte a um deles não comprova acesso irrestrito aos demais. Peça uma demonstração do fluxo de conferência e integração de que sua empresa precisa.

Para organizar a entrega ao escritório, consulte o guia de XML para contabilidade.

Perguntas frequentes

Baixar em lote significa obter todos os XMLs do mês?

Não. O lote contém os documentos disponíveis no serviço ou armazenados no sistema e selecionados na exportação. Confira o período, os CNPJs e os documentos esperados para identificar pendências.

Preciso informar cada chave na consulta sequencial de NF-e?

A consulta sequencial de distribuição usa a posição de NSU e a identificação do interessado, sem digitar cada chave. Ela continua sujeita às regras de acesso e disponibilidade do serviço.

O QR Code da NFC-e garante o download do XML?

Não. O QR Code leva à consulta pública. A obtenção do XML depende dos serviços e requisitos da unidade federativa ou de uma cópia fornecida pelo emitente.

Qual certificado usar na automação?

Confirme a compatibilidade do serviço e do software. O Flow Fiscal utiliza certificado A1 no fluxo de cadastro de certificado; não generalize esse requisito para todas as soluções nem trate todo A3 como exclusivamente físico.

NFS-e e CT-e vêm pelo mesmo serviço da NF-e?

Não trate os três documentos como uma única integração. NF-e, CT-e e NFS-e têm serviços e regras próprios. Confirme quais fontes o sistema consulta e quais documentos disponibiliza ao seu CNPJ.

Como conferir o resultado da exportação?

Compare as chaves ou identificadores, tipos e situações dos documentos com o conjunto esperado. Verifique duplicidades, arquivos incompletos e pendências; confirme também a importação pelo destinatário do lote.

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.

Consulte os requisitos de conexão e as condições do teste.