README.md

EficazFramework.SPED

Bem vindo ao projeto EficazFramework.SPED.

Este projeto tem por finalidade facilitar as tarefas de leitura, auditoria e escrita das mais diversas escriturações e arquivos eletrônicos governamentais.

Desenvolvida para seguir a versão recente do .NET, pretende-se atender a todas as plataformas por ele antendidas, evitando instruções específicas que possam limitar seu uso apenas em Windows Desktop, como nas versões anteriores.

Esta versão conta atualmente com uma quantidade maior de instruções sem plataforma específica, e foi estruturada para utilização dos recursos de Implantação e Entrega Contínua de aplicações (Azure DevOps).

Documentação

	Schema	Serviços	Uso em Produção	WebServices
CT-e e CT-eOS			✅	⚠️
DAPI (MG)			✅	N/A
e-CredAc, portarias CAT 83/09 e 207/09			✅	N/A
e-Ressarcimento portaria CAT 42/18			✅	N/A
ECD			✅	N/A
ECF			✅	N/A
EFD ICMS / IPI			✅	N/A
EFD Contribuições			✅	N/A
EFD Reinf			✅	✅
e-Social			⚠️	⚠️
GIA (SP)			✅	N/A
GNRE			✅	⚠️
GIA (SP)			✅	N/A
NF-e / NFC-e			✅	✅
NFS-e			⚠️	⚠️
Livro Caixa Digital do Produtor Rural			✅	N/A
Classes complementares			N/A	N/A

Exemplos de Uso

Layouts baseados em arquivos de Texto (txt):

Leitura

System.IO.Stream stream = System.IO.File.OpenRead(@"C:\SPED\SPED-EFD-ICMS-IPI.txt");  
EficazFramework.SPED.Schemas.EFD_ICMS_IPI.Escrituracao escrituracao = new();  
escrituracao.Encoding = System.Text.Encoding.Default; //opcional  
await escrituracao.LeArquivo(stream);  

Escrita

EficazFramework.SPED.Schemas.EFD_ICMS_IPI.Escrituracao escrituracao = new();  
escrituracao.Encoding = System.Text.Encoding.Default; //opcional  
escrituracao.Versao = "017"; //opcional  

var reg0000 = new Registro0000(null, escrituracao.Versao)  
{  
    Finalidade = Primitives.Finalidade.Original,  
    DataInicial = new System.DateTime(2022, 7, 1),  
    DataFinal = new System.DateTime(2022, 7, 31),  
    RazaoSocial = "Empresa Exemplo S/A",  
    CNPJ = "00123456000100",  
    UF = "MG",  
    InscricaoEstadual = "00112345600001",  
    MunicipioCodigo = "3129707",  
    Perfil = Perfil.B,  
    Atividade = Primitives.TipoAtividade.Outros  
};  
escrituracao.Blocos["0"].Registros.Add(reg0000);  

// TODO: Adicionar demais registros em seus respectivos blocos...  

await escrituracao.EscreveArquivo(System.IO.File.Create(@"C:\SPED\SPED-EFD-ICMS-IPI.txt"));  

Layouts baseados em arquivos xml:

Leitura

using EficazFramework.SPED.Schemas.EFD_Reinf;

System.IO.Stream stream = System.IO.File.OpenRead(@"C:\SPED\SPED-EFD-REINF-EVT-R1000.xml");
var evento = new R1000()
{
    Versao = Versao.v2_01_02
};
evento.Read(stream);
stream.Dispose();

Escrita

using EficazFramework.SPED.Schemas.EFD_Reinf;

var evento = new R1000()
{
    Versao = Versao.v2_01_02,
    evtInfoContri = new R1000_EventoInfoContribuinte()
    {
        ideEvento = new IdentificacaoEvento()
        {
            tpAmb = Ambiente.ProducaoRestrita_DadosReais,
            procEmi = EmissorEvento.AppContribuinte,
            verProc = "2.2"
        },
        ideContri = new IdentificacaoContribuinte()
        {
            tpInsc = PersonalidadeJuridica.CNPJ,
            nrInsc = "12345678"
        },
        infoContri = new R1000EventoInfoContribuinte()
        {
            Item = new R1000Inclusao() // R1000Alteracao() ou R1000Exclusao()
            {
                idePeriodo = new IdentificacaoPeriodo()
                {
                    iniValid = $"{DateTime.Now.AddMonths(-1):yyyy-MM}"
                },
                infoCadastro = new R1000InfoCadastro()
                {
                    classTrib = "99",
                    indEscrituracao = ObrigatoriedadeECD.EntregaECD,
                    indDesoneracao = DesoneracaoCPRB.NaoAplicavel,
                    indAcordoIsenMulta = AcordoInternacionalIsencaoMulta.SemAcordo,
                    indSitPJ = SituacaoPessoaJuridica.Normal,
                    indSitPJSpecified = true,
                    contato = new R1000InfoCadastroContato()
                    {
                        nmCtt = "Pierre de Fermat",
                        cpfCtt = "47363361886",
                        foneFixo = "3535441234",
                        email = "[email protected]"
                    },
                    softHouse = new R1000InfoCadastroSoftwareHouse()
                }
            }
        }
    }
};

var xmlString = evento.ToString();
System.IO.Stream stream = System.IO.File.Create(@"C:\SPED\SPED-EFD-REINF-EVT-R1000.xml");

// Escrita, opção 1:
System.Xml.XmlDocument doc = new();
doc.LoadXml(xmlString);
doc.Save(stream);

// Outra forma de escrita:
using (var writer = new System.IO.StreamWriter(stream, System.Text.Encoding.UTF8))
{
    await writer.WriteAsync(xmlString);
    await writer.FlushAsync();
    writer.Dispose();
}

Pré-Requisitos

Versão	Versão do .NET	Suporte
6.3.x	.NET 8; .NET 9	✅
6.2.x	.NET 7; .NET 8	❌
6.1.x	.NET 6; .NET 7	❌
6.0.x	.NET 6	❌

Contribuições

• Ficaremos felizes por receber contribuições visando enriquecer a qualidade do projeto, além de manter os schemas das escriturações sempre atualizado com os layouts definidos pelos agentes reguladores.
• Por gentileza solicitamos a leitura das Diretrizes de Contribuição antes de iniciar.