Gerar DANFSe a partir do XML
Documento Auxiliar da NFS-e — leiaute da Nota Técnica 008
Você tem o arquivo XML da nota de serviço — aquele que o sistema gera e ninguém consegue ler. Cole aqui e ele vira o documento da nota: o papel que dá pra conferir, imprimir, anexar no e-mail e mandar pro cliente. É o DANFSe, o equivalente do DANFE para a nota de serviço.
Virou problema de todo mundo agora porque a API oficial que gerava esse PDF foi suspensa em 03/08/2026 (a NT 008 v1.00 previa 1º/07, a v1.01 adiou para 15/07 e a v1.02 fixou 03/08): cada sistema passou a ter que desenhar o documento sozinho, seguindo o leiaute da NT 008 (adequação em 03/08/2026). Aqui ele sai nos 13 blocos oficiais, com 93 campos lidos das tags que a nota técnica indica — e o que nenhum gerador faz: cada código fiscal vira link para a ficha que explica o que ele determina.
A montagem roda localmente no seu navegador. Nenhum dado do XML é transmitido — pode usar nota com dados reais.
Perguntas frequentes
Como gerar o DANFSe a partir do XML?
Cole o conteúdo do XML da NFS-e no campo acima e clique em Gerar DANFSe. A geração é online, grátis e roda no seu navegador: o arquivo não é enviado a servidor nenhum, nem ao nosso. O documento sai organizado nos treze blocos previstos pela Nota Técnica 008 — cabeçalho, dados da NFS-e, prestador, tomador, destinatário, intermediário, serviço prestado, tributação municipal do ISSQN, tributação federal, tributação IBS/CBS, valor total, informações complementares e canhoto — e pode ser impresso ou salvo em PDF pelo próprio navegador.
Por que a API oficial de geração do DANFSe parou de funcionar?
Porque foi suspensa — "sobrestada", no termo da nota técnica — e a data mudou duas vezes. A NT 008 v1.00, de 5 de maio de 2026, marcava 1º de julho; a v1.01, de 30 de junho, prorrogou para 15 de julho; e a v1.02, de 14 de julho, fixou 3 de agosto de 2026, que é a data que vale. As três versões praticamente só alteraram esse prazo. Até lá o PDF do DANFSe podia ser obtido do Ambiente Nacional pela API; a partir daí a responsabilidade de gerar o documento passou aos sistemas emissores, no leiaute padronizado pela própria NT 008. Na prática, quem antes só chamava a API agora precisa desenhar o documento.
Este DANFSe é igual ao oficial?
Ele segue o leiaute da NT 008 na estrutura: os mesmos blocos, na mesma ordem, com os rótulos oficiais e os campos mínimos que cada bloco exige, lidos exatamente das tags que a nota técnica indica. O que não reproduzimos é a medida em centímetros de cada quadro — e a própria NT diz, no item 2.4.5, que os tamanhos ali sugeridos "não são obrigatórios". Para uso fiscal formal, gere o documento pelo seu emissor; aqui a finalidade é conferir e ler a nota.
O XML sai do meu computador?
Não. Toda a leitura acontece no seu navegador em JavaScript local — o arquivo não é transmitido a servidor nenhum, nem ao nosso. Dá pra abrir nota com dados reais de cliente sem preocupação. É a mesma garantia do nosso validador de XML.
O que os códigos clicáveis mostram?
Cada código fiscal que aparece no documento vira link para a ficha correspondente: o código de tributação nacional abre a ficha do cTribNac, o código da NBS abre a ficha da NBS, o item da lista de serviços abre a ficha da LC 116, e o CST e o cClassTrib do grupo IBS/CBS abrem a tabela oficial de classificação tributária. É a diferença entre ver "160101" impresso e entender o que aquele número determina.
De onde vêm os campos usados na montagem?
Da Nota Técnica nº 008 versão 1.02, que é a especificação técnica do DANFSe publicada pela Secretaria-Executiva do Comitê Gestor da NFS-e. A tabela do item 2.4.5 traz, para cada campo do documento, o caminho no XML que o alimenta — são 93 campos mapeados em 13 blocos. Os nomes das tags são conferidos contra o pacote de esquemas XSD oficial, porque há divergência de grafia entre os dois documentos: a NT escreve vPIS e vCOFINS, o schema define vPis e vCofins.
Continue por aqui
- → Validador de XML da NFS-e — confira a nota antes de transmitir
- → Decompor a chave de acesso — as 50 posições, campo a campo
- → Erros da NFS-e — o que cada código significa e a regra que dispara
- → Código de tributação nacional