InLiveTools.EmissorFiscal 1.0.40

InLiveTools.EmissorFiscal

Biblioteca .NET para emissão de NFC-e (Nota Fiscal de Consumidor Eletrônica, modelo 65): calcula os impostos, monta e assina o XML, transmite à SEFAZ de forma síncrona e trata o cancelamento — tudo a partir de um objeto de venda, sem acesso a banco de dados.

Feita para quem precisa emitir NFC-e a partir de um PDV, e-commerce ou serviço próprio e quer manter a regra de negócio da aplicação separada do núcleo fiscal.

Recursos

• Emissão de NFC-e (modelo 65) para o Simples Nacional.
• Cálculo dos impostos do item (ICMS/CSOSN, PIS, COFINS) e dos valores da Lei da Transparência (IBPT).
• Assinatura digital (XML-DSig) com certificado A1.
• Geração do QR Code e da URL de consulta da NFC-e.
• Transmissão síncrona à SEFAZ e leitura do retorno (autorização, rejeição, denegação).
• Cancelamento por evento (110111), com o XML do procEventoNFe pronto para arquivamento.
• Multi-target: netstandard2.0 e net10.0.
• Sem dependência de banco de dados: a biblioteca recebe os dados da venda já resolvidos e devolve o XML assinado/autorizado. A regra de negócio da sua aplicação fica fora do núcleo fiscal.

Instalação

dotnet add package InLiveTools.EmissorFiscal

Ou via PackageReference:

<PackageReference Include="InLiveTools.EmissorFiscal" Version="1.0.37" />

Pré-requisitos

• Certificado digital A1 (.pfx) válido do emitente.
• CSC (Código de Segurança do Contribuinte) e o seu identificador (IdCSC), obtidos no portal da SEFAZ da UF do emitente.
• Inscrição Estadual ativa e credenciamento do emitente para NFC-e na sua UF.

Emitindo uma NFC-e

using System.IO;
using InLiveTools.EmissorFiscal.Nfce;
using InLiveTools.EmissorFiscal.Nfce.Modelos;

var emissor = new EmissorNFCe();

var configuracao = new ConfiguracaoEmissaoNFCe
{
    Ambiente = AmbienteFiscal.Homologacao,          // AmbienteFiscal.Producao quando for valer
    CertificadoArquivoBytes = File.ReadAllBytes("certificado.pfx"),
    CertificadoSenha = "senha-do-certificado",
    IdentificadorCsc = "000001",                    // IdCSC informado no portal da SEFAZ
    Csc = "SEU-CODIGO-DE-SEGURANCA-DO-CONTRIBUINTE",
    ResponsavelTecnico = new ResponsavelTecnicoNFCe
    {
        Cnpj = "00000000000000",
        Contato = "Suporte Tecnico",
        Email = "suporte@suaempresa.com.br",
        Telefone = "1130000000"
    }
};

var documento = new DocumentoVendaNFCe
{
    Serie = 1,
    NumeroNF = 123,                                 // numeração reservada pela sua aplicação
    Emitente = new EmitenteNFCe
    {
        Cnpj = "00000000000000",
        RazaoSocial = "Loja Exemplo LTDA",
        NomeFantasia = "Loja Exemplo",
        InscricaoEstadual = "000000000000",
        Regime = RegimeTributario.SimplesNacional,
        Logradouro = "Rua Exemplo",
        Numero = "100",
        Bairro = "Centro",
        CodigoMunicipio = 3550308,                  // código IBGE do município
        NomeMunicipio = "Sao Paulo",
        Uf = "SP",
        CodigoUf = 35,                              // código IBGE da UF
        Cep = "01001000"
    },
    Itens =
    {
        new ItemVendaNFCe
        {
            Codigo = "7891234",
            Descricao = "Produto de exemplo",
            UnidadeComercial = "UN",
            Quantidade = 1,
            ValorUnitario = 10.00m,
            ValorBruto = 10.00m,
            Ncm = "22021000",
            Cfop = "5102",
            OrigemMercadoria = 0,
            SituacaoTributariaIcms = "102"          // CSOSN (Simples Nacional)
        }
    },
    Pagamentos =
    {
        new PagamentoNFCe { Forma = FormaPagamentoNFCe.Dinheiro, Valor = 10.00m }
    }
};

var resultado = emissor.Emitir(documento, configuracao);

if (resultado.Autorizada)
{
    // resultado.ChaveAcesso     -> chave de acesso (44 dígitos)
    // resultado.NumeroProtocolo -> protocolo de autorização
    // resultado.XmlAutorizado   -> nfeProc (NFe + protocolo), guarde por 5 anos
    // resultado.QrCodeUrl / resultado.UrlConsulta -> impressão do DANFE NFC-e
}
else
{
    // resultado.Desfecho -> Rejeitada, Denegada ou FalhaComunicacao
    // resultado.CStat / resultado.Motivo -> retorno da SEFAZ
    // resultado.XmlAssinado permanece disponível para arquivamento / retransmissão
}

Desfechos da emissão

O retorno (ResultadoEmissaoNFCe.Desfecho) distingue os quatro estados que exigem tratamento diferente:

Em qualquer desfecho em que o XML chegou a ser montado, XmlAssinado é preenchido — útil para arquivamento e futura retransmissão sem regenerar o documento.

Cancelando uma NFC-e

var cancelamento = new CancelamentoNFCe
{
    ChaveAcesso = resultado.ChaveAcesso,
    ProtocoloAutorizacao = resultado.NumeroProtocolo,
    CnpjEmitente = "00000000000000",
    CodigoUf = 35,
    Justificativa = "Cancelamento a pedido do consumidor apos a venda"   // 15 a 255 caracteres
};

var retorno = emissor.Cancelar(cancelamento, configuracao);

if (retorno.Aceito)
{
    // retorno.XmlEvento -> procEventoNFe (evento + retorno), guarde por 5 anos
}

Prazo: o cancelamento só é aceito pela SEFAZ dentro do prazo legal, contado a partir da autorização. Validar o prazo antes de chamar Cancelar é responsabilidade da sua aplicação.

Mantida pela InLive Consultoria

Esta biblioteca é desenvolvida e mantida pela InLive Consultoria.

🌐 www.inlive.com.br

Sobre a InLive Consultoria

A InLive Consultoria atua no desenvolvimento de sistemas integrados que geram inteligência estratégica e corporativa, com foco em redes de franquias.

Somos uma empresa criativa, com expertise no desenvolvimento de softwares para as plataformas web, mobile e desktop.

Licença

Distribuída sob a licença MIT.