NFSe Downloader

Guia rápido

NF-e ou NFS-e?

As duas são notas fiscais eletrônicas, mas vivem em sistemas diferentes, de administrações diferentes. Descobrir qual é a sua leva dez segundos — e define qual ferramenta baixa o XML.

O jeito mais rápido: conte a chave

Toda nota fiscal eletrônica tem uma chave de acesso numérica. O tamanho dela responde a pergunta sem margem de dúvida:

Se a chave tem…É uma…O PDF se chamaQuem administra
44 dígitosNF-e (produto) ou CT-e (transporte)DANFE / DACTESEFAZ do estado
50 dígitosNFS-e (serviço)DANFSePortal Nacional / município

Sem a chave em mãos, o atalho é o conteúdo: vendeu um produto, é NF-e; prestou um serviço, é NFS-e. Consultoria, manutenção, obra, aula, frete municipal e honorários são serviços.

Por que isso importa na hora de baixar

Não existe um lugar único que entregue as duas. Cada administração mantém a própria API de distribuição, com layout e autenticação próprios — por isso são ferramentas separadas. O que se repete nos dois casos é o certificado digital ICP-Brasil: o mesmo A1 ou A3 serve para os dois.

Onde baixar o XML de cada uma

Serviço

NFS-e

Notas emitidas e recebidas do Portal Nacional, em lote, direto pela API oficial. XML autenticado, DANFSe em PDF e resumo em Excel, organizados por competência.

Instalar a extensão de NFS-e

Ou entenda antes como funciona o download em lote.

Produto e transporte

NF-e e CT-e

Documentos destinados ao seu CNPJ pela distribuição da SEFAZ, com o mesmo certificado. É outro produto nosso, feito especificamente para o ambiente estadual.

Ver o NFe/CTe Downloader

Também busca por chave de acesso, quando você tem só o número.

“Recebi um XML e não sei qual é”

Abra o arquivo no Bloco de Notas e olhe a primeira tag depois do cabeçalho. Se encontrar <nfeProc> ou <NFe>, é NF-e. Se encontrar <NFSe> ou <DPS>, é NFS-e do padrão nacional. Se o XML não abre ou o sistema recusa a importação, o problema costuma ser outro — veja as causas de falha de schema.

Perguntas frequentes

Qual a diferença entre NF-e e NFS-e?

A NF-e (modelo 55) documenta a circulação de mercadorias e é competência dos estados, administrada pelas SEFAZ. A NFS-e documenta prestação de serviços e é competência dos municípios, hoje centralizada no Portal Nacional da NFS-e. São sistemas separados, com layouts, chaves e formas de download diferentes.

Como saber se a minha nota é NF-e ou NFS-e?

Pela chave de acesso. A chave da NF-e tem 44 dígitos; a da NFS-e tem 50. Se você só tem o PDF, olhe o nome do documento: DANFE é NF-e, DANFSe é NFS-e. E se a nota descreve um serviço prestado em vez de um produto vendido, é NFS-e.

Dá para baixar o XML das duas no mesmo lugar?

Não. Como são sistemas de administrações diferentes, cada um tem sua própria API de distribuição e exige uma ferramenta específica. O certificado digital ICP-Brasil, porém, é o mesmo nos dois casos.

Preciso de certificado digital para baixar os XMLs?

Sim, nos dois casos. Tanto a distribuição da NF-e quanto a da NFS-e são autenticadas por certificado ICP-Brasil A1 ou A3. Sem ele é possível apenas consultar notas individuais nos portais públicos, uma a uma.

E a CT-e, onde entra?

A CT-e (Conhecimento de Transporte Eletrônico, modelo 57) documenta serviços de transporte e também é estadual, distribuída pela SEFAZ junto com a NF-e. Quem precisa de CT-e usa a mesma ferramenta da NF-e.