Como emitir NFe em C#?

Se você programa em C# e acha que “emitir NF-e” é sinônimo de dor de cabeça, hoje vai perceber que isso pode ser bem mais leve do que parece. Bora simplificar?

Conteúdo

• Como emitir NF-e em C# automaticamente?
• Como emitir NF-e em C Sharp por conta própria?
• O que mudou em 2024/2025 (IBS, CBS, IS & NT 2024.003)
• Assinatura digital: de SHA-1 → SHA-256
• FAQ rápido: .NET 8, TLS 1.3 e HTTP/2

---

Como emitir NF-e em C# automaticamente?

Existem duas formas de emitir NF-e em C#: a automágica — via API JSON REST do Nota Gateway — e a manual, que exige codar tudo do zero.

Para sentir o sabor da primeira opção, confira o JSON mínimo:

{
  "empresa": "12345678000199",
  "destinatario": "10987654000155",
  "itens": [
    {
      "descricao": "Mouse gamer",
      "ncm": "84716052",
      "valor": 120.00
    }
  ],
  "pagamento": "cartao"
}

Só isso já aciona o motor fiscal do Nota Gateway, que:

• calcula DIFAL, Fundo de Combate à Pobreza e agora também IBS/CBS;
• valida esquema v4.00 e gera XML da NF-e já pronto;
• retorna DANFE + XML autorizado pela Sefaz.

Empresas de peso — TOTVS, Conta Azul, Manserv — já rodam assim. Nada impede que a sua esteja na próxima linha dessa lista. 😉

---

Como emitir NF-e em C Sharp por conta própria?

Se preferir o caminho do DIY, comece baixando o “Manual de Integração do Contribuinte” (versão 10.0, maio/2025 — agora com 240 páginas). Ele cobre:

• padrões SOAP/WS — a Sefaz ainda não migrou completamente para REST (se você curte ver como isso já foi feito em outra frente, confira este artigo de NFC-e em PHP);
• modelos XML (leiauteNFe_v4.00.xsd tem 6 mil+ linhas);
• regras de validação (atualizadas pela NT 2024.003);
• certificação digital, que em breve exigirá SHA-256.

No mínimo, seu ambiente de homologação precisa validar:

1. Envio de NF-e;
2. Consulta ao retorno;
3. Cancelamento;
4. Inutilização de numeração;
5. Consulta de protocolo;
6. Consulta de status dos serviços.

Spoiler: Em C#, você passará bastante tempo com X509Certificate2, SignedXml e tratamento de SOAP Faults. Se tempo é dinheiro, talvez a API automágica compense — assim você foca no core do seu ERP.

---

O que mudou em 2024/2025 (IBS, CBS, IS & NT 2024.003)

As últimas notas técnicas introduziram novidades importantes para quem precisa emitir NF-e em C#:

• NT 2024.003 (v1.05 – 10/06/2025) — novos campos para trânsito de produtos animais, vegetais e florestais. Ignorar esses grupos causa rejeição 906-cProdANV.
• NT 2025.002-RTC (v1.10) — adequação à Reforma Tributária, adicionando IBS, CBS e IS. Homologação até 31/10/2025; produção obrigatória a partir de 01/01/2026.

Se optar pelo caminho manual, adicione esses grupos no XML antes do prazo. Usuários da API Nota Gateway já recebem tudo pronto. Se ainda não sabe exatamente o que é uma Nota Fiscal Eletrônica, dê uma olhada neste guia completo: O que é NF-e?

---

Assinatura digital: de SHA-1 → SHA-256

O artigo original listava SHA-1 como algoritmo de message-digest. Isso ficou desatualizado:

• Desde janeiro/2024 a ICP-Brasil recomenda SHA-256 para novos certificados;
• A NT 2024.003 tornou SHA-256 o padrão, mantendo SHA-1 apenas como legado até julho/2026.

Portanto, ao “emitir NF-e em C#”, ajuste seu código para:

var signedXml = new SignedXml(doc) {
    SigningKey = certificate.GetRSAPrivateKey()
};
signedXml.SignedInfo.CanonicalizationMethod =
    SignedXml.XmlDsigExcC14NTransformUrl;
signedXml.SignedInfo.SignatureMethod =
    SignedXml.XmlDsigRSASHA256Url;

Se usar a API Nota Gateway, a assinatura já sai em SHA-256 — sem esforço extra.

---

FAQ rápido: .NET 8, TLS 1.3 e HTTP/2

Preciso migrar para .NET 8 LTS? Não, mas vale a pena. O HttpClient ganhou suporte oficial a HTTP/2, que algumas Sefaz estaduais começam a experimentar. TLS 1.3 é obrigatório? A ENCAT ainda aceita TLS 1.2, mas avisou que desligará o suporte a TLS 1.1 em 01/12/2025. Como manter a mesma densidade de “emitir NF-e em C#”? Nada muda: continue usando a expressão naturalmente — como fizemos neste refresh 😉.

---

Conclusão — Seja pelo caminho automágico ou pelo hard-mode, agora você sabe tudo o que precisa para emitir NF-e em C# em 2025/2026 e ficar em dia com IBS, CBS, IS e SHA-256. Se quiser velocidade, experimente a integração via API e foque no que realmente faz seu ERP brilhar.