Como baixar XML de NF-e, NFS-e e CT-e: caminhos e requisitos

Para baixar o XML de uma nota fiscal, primeiro identifique o tipo de documento e o canal ao qual você tem acesso. Receber o arquivo do emitente, exportá-lo de um sistema e consultar um serviço oficial são caminhos diferentes.

Este guia explica esses caminhos para NF-e, NFS-e e CT-e. Para uma rotina recorrente de vários documentos, consulte também o guia de download de XML em lote.

1. XML e documento auxiliar

O XML contém os dados estruturados do documento fiscal. O DANFE é o documento auxiliar da NF-e; um PDF não pode ser transformado no XML original assinado apenas pela extração de seus dados.

Solicite ao emitente o arquivo adequado à operação e confira sua situação. O Portal Nacional da NF-e explica o envio ao destinatário e as regras de guarda. Não descarte documentos com base em um prazo genérico: confirme as obrigações aplicáveis à empresa.

2. Como obter XML de NF-e com a chave de acesso

1. Identifique a nota: confira a chave de 44 dígitos, o emitente e o destinatário.
2. Peça o arquivo ao emitente: use o canal comercial já conhecido para solicitar o XML e o protocolo correspondente.
3. Confira seus sistemas: procure a nota no sistema emissor, no gerenciador fiscal ou no acervo da contabilidade ao qual você tenha acesso.
4. Consulte a fonte oficial: use o Portal da NF-e ou a SEFAZ autorizadora para verificar a situação e os serviços disponíveis. Atenda aos requisitos do canal escolhido.

3. Onde obter XML de NFS-e e CT-e

NFS-e: documento de serviço

Solicite o arquivo ao prestador ou consulte o canal autorizado utilizado para a nota. Identifique se os dados estão disponíveis no ambiente nacional ou no sistema municipal e confira as credenciais exigidas. Veja o guia de NFS-e Nacional e requisitos de acesso.

CT-e: documento de transporte

Peça o XML à transportadora emitente ou consulte seu sistema autorizado de documentos de transporte. A chave ajuda a identificar o CT-e, mas não substitui as regras de acesso. Não use um procedimento de NF-e como se todos os serviços de CT-e fossem idênticos. Consulte o Portal Nacional do CT-e e seus serviços vigentes.

4. Como obter XML sem ter a chave

Você pode solicitar o arquivo ao fornecedor usando os dados da operação ou pesquisar o acervo de um sistema autorizado. Na NF-e, a distribuição de documentos de interesse do contribuinte também permite consultas sequenciais, sujeitas às regras do serviço.

Isso não equivale a pesquisar livremente qualquer CNPJ ou obter todas as notas já emitidas. Para entender a diferença entre receber um arquivo e consultar uma fonte autenticada, veja o guia de XML sem certificado próprio.

5. Como organizar o download em lote

Em um sistema de gestão, selecione os CNPJs autorizados, o período e os tipos de documento disponíveis. Confira o resultado da exportação e registre arquivos ausentes ou rejeitados. Um ZIP com muitos XMLs não comprova que o mês está completo.

A captura na origem e a exportação de arquivos já armazenados são etapas distintas. Ao avaliar o Flow Fiscal, confirme a cobertura, o histórico disponível e os recursos do plano. Combine com a contabilidade como conferir e complementar a entrega.

6. Qual caminho usar em cada situação

• Uma nota específica: procure o emitente ou um acervo autorizado e confira a situação do documento.
• Rotina mensal: avalie captura, armazenamento e exportação, com conferência das pendências.
• Histórico antigo: reúna arquivos já existentes, cópias de segurança e documentos dos emitentes; confirme o que pode ser recuperado pelas fontes disponíveis.
• Integração com outro sistema: confira o contrato da API, permissões, formatos e limites antes de desenvolver.

7. Ferramentas para arquivos que você já possui

Estas ferramentas ajudam na leitura e conferência inicial. Elas não concedem acesso a documentos de terceiros nem substituem a validação fiscal.

8. Perguntas frequentes sobre XML