Skip to content

Repository files navigation

🚀 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

<PackageReferenceInclude="Hercules.NET.NFe.NFCe"Version="2025.7.15.1635" />
<PackageReferenceInclude="System.Security.Cryptography.Xml"Version="9.0.7" />
<PackageReferenceInclude="FastReport.OpenSource"Version="2022.2.2" />
<PackageReferenceInclude="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=newDFe.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:

varconfiguracao=newConfiguracaoServico(){cUF=DFe.Classes.Entidades.Estado.SP,// Altere para seu estadotpAmb=DFe.Classes.Flags.TipoAmbiente.Homologacao,// Ou Producao// ... outras configurações}

4. Executar o Projeto

dotnet run

📁 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.

About

Demonstracao do uso do Zeus Fiscal para emissao de nota fiscal

Resources

Stars

10 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages