Home Original page

GitHub - Hercules-NET/DemoNFe: Demonstracao do uso do Zeus Fiscal para emissao de nota fiscal

🚀 Demo NFe com Zeus Fiscal

VEJA O VIDEO: https://www.youtube.com/watch?v=ifak7tPhS5I

📋 Sobre o Projeto

Este é um projeto de demonstração que implementa a emissão de Nota Fiscal Eletrônica (NFe) utilizando a biblioteca Zeus Fiscal. O projeto demonstra o processo completo de:

  • ✅ Configuração do ambiente NFe
  • ✅ Geração de NFe
  • ✅ Assinatura digital
  • ✅ Validação XML
  • ✅ Envio para SEFAZ
  • ✅ Geração de DANFE (PDF)

⚠️ ATENÇÃO: Este projeto está configurado para o ambiente de homologação e apenas para estudo, não utilize em PRODUÇÃO!

🎯 Funcionalidades

  • Emissão de NFe 4.0: Compatível com o layout mais atual
  • Assinatura Digital: Suporte a certificados A1 (PFX)
  • Validação Automática: Validação de schemas XML
  • Impressão DANFE: Geração de PDF com FastReport
  • Ambiente de Homologação: Configurado para testes seguros
  • Visualização Automática: Abertura automática de XMLs e PDFs

🛠️ Tecnologias Utilizadas

  • .NET 9: Framework mais recente
  • C# 13.0: Linguagem de programação
  • Zeus Fiscal (Hercules.NET.NFe.NFCe): Biblioteca principal para NFe
  • FastReport OpenSource: Para geração de relatórios DANFE
  • System.Security.Cryptography.Xml: Para assinatura digital

📦 Dependências

<PackageReference Include="Hercules.NET.NFe.NFCe" Version="2025.7.15.1635" />
<PackageReference Include="System.Security.Cryptography.Xml" Version="9.0.7" />
<PackageReference Include="FastReport.OpenSource" Version="2022.2.2" />
<PackageReference Include="FastReport.OpenSource.Export.PdfSimple" Version="2022.2.2" />

⚡ Quick Start

1. Pré-requisitos

  • .NET 9 SDK
  • Visual Studio 2022 ou VS Code
  • Certificado digital A1 (PFX) válido
  • Acesso à internet para comunicação com SEFAZ

2. Configuração do Certificado

  1. Coloque seu certificado .pfx no diretório do projeto

  2. Edite o arquivo Program.cs na seção de configuração:

    Certificado = new DFe.Utils.ConfiguracaoCertificado()
{
    TipoCertificado = DFe.Utils.TipoCertificado.A1ByteArray,
    ArrayBytesArquivo = File.ReadAllBytes("CAMINHO/PARA/SEU/CERTIFICADO.pfx"),
    Senha = "SUA_SENHA_AQUI",
    // ... outras configurações
}

3. Configuração do Estado

Ajuste as configurações para seu estado:

var configuracao = new ConfiguracaoServico()
{
    cUF = DFe.Classes.Entidades.Estado.SP, // Altere para seu estado
    tpAmb = DFe.Classes.Flags.TipoAmbiente.Homologacao, // Ou Producao
    // ... outras configurações
}

4. Executar o Projeto

📁 Estrutura do Projeto

HerculesZeusDfeDemo/
├── Program.cs              # Arquivo principal com fluxo de emissão
├── FactoryNfe.cs          # Factory para criação de NFe
├── Helpers.cs             # Utilitários para visualização
├── Schemas/               # Schemas XSD para validação
├── NFe/                   # Templates de relatórios
│   └── NFeRetrato.frx     # Template DANFE
├── *.dll                  # DLL do ZeusFiscal ao buildar os projetos referentes
└── HerculesZeusDfeDemo.csproj

📚 Recursos Adicionais

🤝 Contribuindo

  1. Fork o projeto
  2. Crie uma feature branch (git checkout -b feature/AmazingFeature)
  3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
  4. Push para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

📝 Licença

Este projeto é distribuído sob a licença MIT. Veja LICENSE para mais informações.

⭐ Gostou do projeto? Dê uma estrela no repositório!

🔔 Mantenha-se atualizado sobre as novidades do Zeus Fiscal seguindo o projeto no GitHub.