O que é o DFeBR.Net?
É um framework para emissão e logística de documentos fiscais para a plataforma .NET. Simples, eficiente, extensível e robusto, conta com as melhores abordagens em termos de design patterns para garantir ao desenvolvedor segurança e confiabilidade no funcionamento.
A quem se destina?
Desenvolvedores da plataforma .NET que atuam na área de automação comercial, sendo compatível com .NET Framework 4.x e .NET Core, através do .NET Standard 2.
Tecnologias e evoluções
O novo DFeBR.Net é a baseado no antigo Zeus.DFe Framework, criado por uma nova equipe de desenvolvedores extremamente capacitados para entregar a melhor solução possível em termos de tecnologia e arquitetura de software. Dentre as várias evoluções feitas, a mais significativa é a total compatibilidade com .NET Core e .NET 4.x, alem de diversas mudanças internas que tornam o novo framework extremamente confiável para o desenvolvedor. Incluímos também um novo conceito para construção dos objetos de documentos fiscais. Como é sabido que a estrutura de uma NFe é extensa e complexa, trabalhamos duro para simplificar o máximo possível a implementação e os resultados foram incríveis.
Transição menos dolorosa entre as versões dos serviços
A arquitetura do novo projeto facilita a transição ou migração de versões do serviços. Sempre que for implementada uma versão mais nova dos documentos fiscais, basta alterar a chamada das classes de construção do documento. Ex.:
new DetalheNFe40(...); //construtor do detalhe da NFe 4.0
new DetalheNFe50(...); //construtor do detalhe da NFe 5.0Exemplo simples de uso
Configuração do framework
A configuração do framework é feita através da classe "EmissorServicoConfig". Nos pontos onde se vê "..." são parâmetros de métodos.
private EmissorServicoConfig GetConfig()
{
var config = new EmissorServicoConfig(...);
config.ConfiguraEmitente(...);
config.ConfiguraCertificadoA1Repositorio("serial do certificado");
config.ConfiguraCSC("CscID", "CscToken");
config.ConfiguraArquivoRetorno(true, @"C:\XML\");
return config;
}Construindo os "pedaços" da nota fiscal
Cada seção da nota fiscal é constituida por classes distintas, específicas da versão do serviço, que simplifica a confecção da estrutura Ex.:
private DetalheNFe40 GetDetalhe()
{
var detalhe = new DetalheNFe40(...); //dados basicos do produto
detalhe.SetICMS20(...); //dados para o ICMS20
detalhe.SetIPI(...); //dados para o IPI
detalhe.SetPISOutr(...); //dados para PIS
detalhe.SetII(...); //dados para II
detalhe.SetCOFINSOutr(...); //dados para COFINS
return detalhe;
}Emitindo sua primeira NFe
Segundo as dicas acima, você deve construir seus objetos para confecção da NFe e informá-los na classe "NFeBuilder", e por fim, submetê-la ao serviço de autorização
private IServicoStrategy ObterServico()
{
return new ServNFe4(GetConfig());
}
public void EmitirNFeComBuilder()
{
NFeBuilder builder = new NFeBuilder(GetConfig());
builder.SetIdentificacao(new IdentificacaoNFe40(...));
builder.SetDestinatario(new DestinatarioNFe40(...));
builder.AddDetalhe(GetDetalhe());
builder.SetTotal(new TotalNFe40(.....));
builder.SetTransporte(new TransporteNFe40());
builder.SetCobranca(GetCobranca());
builder.AddPagamento(GetPagamento());
builder.SetResponsavel(new ResponsavelTecNFe40(....));
var servNfe = ObterServico();
IRetAutorz retorno = servNfe.Autorizar(builder.NFe);
}Caso prefira, você também pode manipular diretamente as classes originais que compõe a NFe e submetê-las ao serviço de autorização da mesma forma, porém a quantidade e complexidade do código vai ser consideravelmente maior.
Principais mantenedores
O novo projeto conta com uma equipe seleta de experientes desenvolvedores da plataforma .NET, pessoas com alta carga de conhecimento e extremamente capacitados para entregar a comunidade a melhor solução possível para facilitar o árduo trabalho de emissão de documentos fiscais.
A equipe está organizada por áreas de projeto, cujo elas são:
“Core-Framework” - Camada de mais baixo nível do projeto, responsável por de fato fazer todo o processo de transmissão de documentos e manipulação de XML’s
“Support-Layers” - Camada de mais alto nível do projeto, responsável por interagir direta/indiretamente com o desenvolvedor-usuário, afim de garantir que todas as informações que chegarem no “Core-Framework” estejam devidamente tratadas e válidas.
“Code Revisor” - Membros do projeto responsáveis pela revisão de código enviado pela comunidade a fim de contribuir com o projeto.
“Suporte Fiscal e Regras de Negócio” - Membros do projeto responsáveis por estar antenados as legislações fiscais e orquestrar a correta implementação das evoluções mais recentes estabelecidas pelas Sefaz’es.
Os membros são:
Eduardo Moreira “Core-Framework”
Henrique Felipe “Core-Framework”
Leo Vitor Sousa “Support-Layers”
Marco P. Viana “Suporte Fiscal e Regras de Negócio”
Paulo Cesar Filho “Code Revisor, Core-Framework, Support-Layers "
Ricardo I.T.S.A “Support-Layers”
Rodrigo Navas “Core-Framework”
Valnei Batista “Core-Framework”
Vigo Marcelo “Support-Layers, Core-Framework"
Marcos Vinícius “Support-Layers”