Samos.Fiscal 1.0.0

Samos Fiscal

Biblioteca Profissional para Emissão de NF-e e NFC-e

Empresa: Samos Informática LTDA Versão: 1.0.0 Plataforma: .NET 10 Status: Produção

📘 Visão Geral

O Samos Fiscal é uma biblioteca .NET completa para emissão de NF-e e NFC-e, desenvolvida com foco em:

• Conformidade total com a legislação fiscal brasileira
• Compatibilidade com a Reforma Tributária
• Arquitetura profissional (Clean Architecture + SOLID)
• Facilidade de integração com ERPs, PDVs e sistemas legados
• Pronta para uso em produção

A biblioteca cuida de todo o ciclo de vida do documento fiscal eletrônico, desde o cálculo tributário até a comunicação com a SEFAZ e impressão do DANFE.

✨ Principais Funcionalidades

• Emissão de NF-e (Modelo 55)

• Emissão de NFC-e (Modelo 65)

• Geração de XML no layout oficial 4.0

• Assinatura digital com certificado A1 ou A3

• Comunicação com a SEFAZ de todos os estados

• Cálculo automático de impostos:

  • ICMS (normal, ST, DIFAL, FCP)
  • IPI
  • PIS
  • COFINS
  • ISS

• Suporte a regimes tributários:

  • Simples Nacional
  • Lucro Presumido
  • Lucro Real

• Contingência automática (SVRS, SVC-RS, SCAN, EPEC, FS-DA)

• Cancelamento, inutilização e carta de correção (CCe)

• Geração e impressão de DANFE (A4 e Bobina 80mm)

• Exportação de DANFE para PDF e imagem

• Logs e tratamento robusto de erros

🏗️ Arquitetura

O projeto segue rigorosamente o padrão Clean Architecture, garantindo:

• Separação total de responsabilidades
• Baixo acoplamento
• Alta testabilidade
• Facilidade de manutenção e evolução

Samos Fiscal/
├── Domain/          # Entidades, regras de negócio e contratos
├── Application/     # Casos de uso e serviços
├── Infrastructure/ # Comunicação SEFAZ e detalhes técnicos
├── Examples/        # Exemplos de uso
└── Tests/           # Testes unitários

Princípios Aplicados

• SOLID
• DDD (Domain Driven Design)
• Injeção de Dependência
• Async/Await em todas as operações de I/O

📦 Instalação via NuGet

dotnet add package SamosFiscal

Ou pelo Visual Studio:

Gerenciar Pacotes NuGet → Buscar por SamosFiscal

⚙️ Pré-requisitos

• .NET 10 SDK ou superior

• Certificado digital ICP-Brasil:

  • A1 (arquivo .pfx)
  • A3 (token ou smartcard)

• Acesso à internet para comunicação com a SEFAZ

🚀 Quick Start

1️⃣ Criar configuração do emissor

var configuracao = new ConfiguracaoEmissor
{
    CNPJ = "12.345.678/0001-90",
    UF = "SP",
    Ambiente = AmbienteSefaz.Homologacao,

    TipoCertificado = TipoCertificado.A1,
    CertificadoDigitalA1 = File.ReadAllBytes("certificado.pfx"),
    SenhaCertificado = "senha",

    SerieNFe = 1,
    SerieNFCe = 1,
    ProximoNumeroNFe = 1,
    ProximoNumeroNFCe = 1
};

2️⃣ Inicializar serviços

var notaFiscalService = new NotaFiscalService(
    new CalculoTributarioService(),
    new XmlNFeService(),
    new AssinaturaDigitalService(),
    new SefazComunicacaoService(),
    new NotaFiscalRepositoryInMemory(),
    new EventoRepositoryInMemory(),
    new ArmazenamentoXmlService(),
    new ContingenciaService()
);

3️⃣ Emitir uma NF-e

var resultado = await notaFiscalService.EmitirNotaFiscalAsync(notaFiscal, configuracao);

if (resultado.Sucesso)
{
    Console.WriteLine("NF-e autorizada com sucesso!");
    Console.WriteLine(resultado.NotaFiscal.ChaveAcesso);
}

🖨️ Impressão de DANFE

NF-e (A4)

var danfeService = new DanfeService();
await danfeService.ImprimirDanfeAsync(notaFiscal);

NFC-e (Bobina 80mm)

var danfeNFCeService = new DanfeNFCeService();
await danfeNFCeService.ImprimirDanfeNFCeAsync(notaFiscal);

Exportar para PDF

await danfeService.GerarPdfAsync(notaFiscal, "danfe.pdf");

📊 Reforma Tributária e Compliance

A biblioteca está 100% aderente às normas fiscais vigentes, incluindo:

• DIFAL (EC 87/2015) – 100% UF destino
• FCP por estado
• ICMS-ST com MVA
• Alíquotas interestaduais (4%, 7%, 12%)
• CST e CSOSN atualizados
• NCM e CEST obrigatórios

⚠️ Recomendação: sempre valide regras específicas com seu contador.

🧪 Testes

O projeto possui testes unitários cobrindo:

• Geração de XML
• Cálculo de impostos
• Validações fiscais
• Regras por estado

dotnet test

🔐 Segurança

• Assinatura digital obrigatória
• Certificados ICP-Brasil
• Comunicação segura (TLS 1.2+)
• Logs para auditoria fiscal

📄 Licença

Este projeto é de propriedade da Samos Informática LTDA.

O uso comercial, redistribuição ou modificação deve respeitar os termos definidos pela empresa.

📞 Suporte

• Empresa: Samos Informática LTDA
• E-mail: suporte@websamos.com.br

✅ Conclusão

O Samos Fiscal é uma solução robusta, moderna e confiável para emissão de documentos fiscais eletrônicos no Brasil, pronta para atender sistemas de qualquer porte.

Desenvolvido com excelência técnica e compromisso com a legislação brasileira 🇧🇷