n8n-nodes-nfse

🚀 Consultoria e Implantação

Este node é Open-Source e gratuito para a comunidade.

Porém, se você é um empresário, agência ou contabilidade e precisa de ajuda especializada para implantar a automação fiscal na sua empresa (Integração com Hotmart, Shopify, Stripe, WooCommerce, ERPs, etc), nossa equipe está pronta para te atender.

Entre em contato para orçamentos de implantação B2B:

• 💼 Responsável: Amaury Gomes Ibanez
• 🌐 Site: agnez.com.br
• 📱 WhatsApp: +55 (67) 99104-4105

Nós pegamos na sua mão e automatizamos todo o seu faturamento de ponta a ponta, sem dor de cabeça com certificados ou rejeições da Receita.

Emissor oficial e 100% nativo em TypeScript/Node.js para a NFS-e Padrão Nacional (Portal da NFS-e / SEFIN Nacional / ADN da Receita Federal).

Esqueça o ACBrLib, DLLs em C/C++, máquinas virtuais ou containers paralelos com Wine: este nó realiza toda a leitura do Certificado Digital A1, assinatura digital ICP-Brasil (XMLDSig) e comunicação segura mTLS diretamente no fluxo do n8n.

⚡ Principais Recursos

• 🇧🇷 Padrão Nacional Oficial: Conexão direta com a SEFIN Nacional da Receita Federal (Ambiente de Dados Nacional - ADN).
• 🔐 Certificado Digital A1 Nativo (.pfx/.p12): Suporte a upload via Base64 seguro ou caminho de arquivo local com senha protegida.
• ✍️ Assinatura Digital ICP-Brasil (XMLDSig): Assinatura da <infDPS> e do <pedRegEvento> em conformidade estrita com C14N e RSA-SHA256 (Padrão RTC v1.01).
• 🌐 Comunicação Segura mTLS (Mutual TLS): Conexão HTTPS com autenticação mútua de certificado digital.
• 📄 Geração Local do DANFSE em PDF e HTML: Gera o DANFSE oficial em PDF de alta fidelidade e/ou HTML responsivo com QR Code oficial de conferência pública na Receita Federal.
• 🎨 100% Customizável via HTML/CSS: Permite desenhar layouts próprios de DANFSE utilizando tags dinâmicas {{...}}.
• 🚫 Cancelamento de Notas: Registro e consulta de eventos oficiais de cancelamento (101101).
• 🔎 Consultas Completas: Consulta de notas autorizadas e histórico de eventos com descompactação automática do XML GZIP.

📦 Instalação

No painel do seu n8n:

1. Vá em Settings (Configurações) > Community Nodes.
2. Clique em Install a community node.
3. Digite:

   n8n-nodes-nfse

4. Concorde com os termos e clique em Install.

🛠️ Operações Suportadas

| Operação | Descrição | Saídas Geradas | | :--- | :--- | :--- | | Emitir NFS-e (DPS) | Constrói a DPS, assina digitalmente com o Certificado A1, transmite via mTLS para a SEFIN Nacional e autoriza a NFS-e. | Chave de Acesso (50 dígitos), Número da NFS-e, XML da DPS assinada, XML da NFS-e autorizada e link público de consulta. | | Consultar NFS-e por Chave | Consulta uma NFS-e existente na SEFIN Nacional pela Chave de 50 dígitos. Opcionalmente já gera o DANFSE em PDF ou HTML. | Dados da nota, XML oficial descompactado, e opcionalmente arquivo binário do DANFSE (danfse em PDF / danfse_html em HTML). | | Cancelar NFS-e | Emite o evento oficial de cancelamento da NFS-e (RTC v1.01 - Código 101101) assinado com o Certificado Digital A1. | Retorno oficial da SEFIN com protocolo de cancelamento, status e resposta da Receita Federal. | | Consultar Eventos da Nota | Consulta o histórico e detalhes dos eventos registrados na SEFIN Nacional (como o evento de cancelamento ou substituição). | Status do evento, resposta da SEFIN e XML do evento assinado descompactado (xmlEvento). | | Gerar DANFSE (PDF / HTML) | Gera o espelho fiscal oficial da NFS-e com QR Code de autenticidade, em PDF, HTML ou ambos. | Arquivo binário danfse (PDF), danfse_html (HTML) e string HTML completa em JSON (danfseHtml). |

🔐 Configuração das Credenciais

1. Adicione uma credencial do tipo NFS-e Nacional (Certificado A1 & SEFIN) no n8n.
2. Preencha os campos:
   • Formato do Certificado:
     • Base64 (Recomendado): Cole o conteúdo do arquivo .pfx codificado em Base64 (ideal para n8n em containers Docker, Easypanel, Coolify ou Kubernetes).
     • Caminho em disco: Informe o caminho absoluto do arquivo no servidor (ex: /home/node/.n8n/certificados/meu_cert.pfx).
   • Senha do Certificado: Senha de proteção da chave privada.
   • CNPJ do Prestador: 14 dígitos numéricos do emitente.
   • Código do Município Emissor (IBGE): Código de 7 dígitos do município da empresa (ex: 3550308 para São Paulo, 5003702 para Dourados, 3304557 para Rio de Janeiro).
   • Nome do Município e UF (Opcional): Ex: Dourados - MS ou São Paulo - SP para exibição no cabeçalho do DANFSE.
   • Ambiente: 2 - Homologação (para testes) ou 1 - Produção (notas reais com validade jurídica).
   • Regime Tributário: Simples Nacional (ME/EPP), MEI ou Tributação Normal (Lucro Presumido / Lucro Real).
   • CNAE Principal (Opcional): Código da sua atividade econômica (ex: 6201-5/01).

📄 Geração do DANFSE (PDF e HTML)

A operação Gerar DANFSE oferece dois modos de funcionamento e múltiplos formatos de saída:

1. Modos de Geração:

• Modo Automático (automatico) [Recomendado]:
  • Informe apenas a Chave de Acesso (50 dígitos) da NFS-e.
  • O nó conecta via mTLS à SEFIN Nacional, recupera o XML oficial autorizado e extrai automaticamente todos os dados (prestador, tomador, endereço completo, valores, retenções e tributos).
  • Dica: Você também pode passar o campo opcional XML Autorizado (Opcional) caso já possua o XML da nota no fluxo (economizando uma chamada à SEFIN).
• Modo Manual (manual):
  • Permite gerar o DANFSE informando diretamente os dados da nota (Número, Tomador, Documento, Valor, Descrição e Opções de Endereço/Tributos).

2. Formatos de Saída (danfseFormato):

• PDF (Padrão): Gera o arquivo binário .pdf na propriedade binária danfse (pronto para ser enviado via e-mail, Telegram, Google Drive, WhatsApp ou salvo em disco).
• HTML: Gera o arquivo binário .html na propriedade danfse_html e disponibiliza o código HTML puro no JSON de saída (danfseHtml), ideal para exibir em portais web ou embutir em corpo de e-mails.
• PDF e HTML (Ambos): Gera ambos os arquivos simultaneamente.

👤 Autor

Amaury Gomes Ibanez

• GitHub: @amaurygomes
• E-mail: [email protected]
• Websites: agnez.com.br • amaurygomes.com.br

📄 Licença

Uso gratuito permitido para automações no n8n. Proibida engenharia reversa e utilização para criação de plataformas concorrentes de emissão fiscal (SaaS). Consulte LICENSE.md para os termos completos.