Samos.Fiscal.Framework 1.0.0

Samos Fiscal Framework - .NET Framework 4.7.2

?? Vers�o da biblioteca Samos Fiscal otimizada para .NET Framework 4.7.2

?? Sobre Este Projeto

Este � um projeto separado que compartilha o c�digo-fonte com o projeto principal Samos Fiscal, mas � compilado especificamente para .NET Framework 4.7.2.

Por que um projeto separado?

• ? Compatibilidade m�xima com aplica��es legadas
• ? Manuten��o simplificada - c�digo fonte compartilhado
• ? Sem warnings de nullable reference types
• ? Otimizado para .NET Framework 4.7.2
• ? Independente - n�o interfere no projeto .NET 10

?? Caracter�sticas

?? Como Usar

1. Compilar o Projeto

# Na pasta do projeto Framework
cd "Samos Fiscal Framework"
dotnet build

# Ou na raiz da solu��o
dotnet build "Samos Fiscal Framework/Samos Fiscal Framework.csproj"

2. Refer�ncia em Projeto .NET Framework

No seu projeto .csproj:

<ItemGroup>
  <ProjectReference Include="..\Samos Fiscal Framework\Samos Fiscal Framework.csproj" />
</ItemGroup>

Ou adicione a DLL manualmente:

<ItemGroup>
  <Reference Include="SamosFiscal.Framework">
    <HintPath>..\bin\SamosFiscal.Framework.dll</HintPath>
  </Reference>
</ItemGroup>

3. Usar no C�digo

using System;
using System.Threading.Tasks;
using SamosFiscal.Application.Services;
using SamosFiscal.Domain.Entities;
using SamosFiscal.Domain.Interfaces;

namespace MeuProjeto
{
    class Program
    {
        static async Task Main(string[] args)
        {
            // Verificar vers�o
            var info = SamosFiscal.Framework.LibraryInfo.GetInfo();
            Console.WriteLine(info);

            // Criar servi�os
            var xmlService = new XmlNFeService();
            var assinaturaService = new AssinaturaDigitalService();
            
            // Usar normalmente como no .NET 10
            // ...
        }
    }
}

?? Estrutura do Projeto

Samos Fiscal Framework/
??? Samos Fiscal Framework.csproj    # Projeto .NET Framework 4.7.2
??? LibraryInfo.cs                   # Informa��es da biblioteca
??? README.md                        # Esta documenta��o
??? [Linked Files]                   # Links para c�digo fonte do projeto principal
    ??? Domain/                      # Entidades, interfaces, constantes
    ??? Application/                 # Servi�os de aplica��o
    ??? Infrastructure/              # Reposit�rios, SEFAZ, etc.
    ??? Examples/                    # Exemplos de uso

IMPORTANTE: Os arquivos de c�digo n�o s�o copiados fisicamente. O projeto usa linked files (links simb�licos) para o c�digo fonte do projeto principal.

?? Diferen�as em Rela��o ao Projeto .NET 10

??? Compila��o e Gera��o de DLL

Compilar em Debug

dotnet build
# Sa�da: bin\Debug\net472\SamosFiscal.Framework.dll

Compilar em Release

dotnet build -c Release
# Sa�da: bin\Release\net472\SamosFiscal.Framework.dll

Gerar Pacote NuGet

dotnet pack -c Release
# Sa�da: bin\Release\Samos.Fiscal.Framework.1.0.0.nupkg

? Funcionalidades Dispon�veis

Todas as funcionalidades do projeto principal est�o dispon�veis:

• ? Emiss�o de NF-e (Nota Fiscal Eletr�nica)
• ? Emiss�o de NFC-e (Nota Fiscal de Consumidor Eletr�nica)
• ? C�lculo de Impostos (ICMS, IPI, PIS, COFINS, etc.)
• ? Assinatura Digital (Certificado A1/A3)
• ? Comunica��o SEFAZ (Autoriza��o, consulta, eventos)
• ? Eventos (Cancelamento, Carta de Corre��o)
• ? Conting�ncia (EPEC, FS-DA, SVC)
• ? Impress�o DANFE (NF-e em A4, NFC-e em bobina 80mm)
• ? Reforma Tribut�ria (IBS, CBS)
• ? Inutiliza��o de Numera��o
• ? Valida��o de XML
• ? Armazenamento de XMLs

?? Documenta��o

A documenta��o completa est� no projeto principal:

• ?? README Principal
• ?? Instala��o
• ?? Estrutura do Projeto
• ?? Reforma Tribut�ria
• ?? Impress�o de DANFE
• ?? Exemplos de Uso

?? Testar a Biblioteca

Criar Projeto de Teste

# Criar projeto de teste console em .NET Framework 4.7.2
mkdir TesteSamosFiscalFramework
cd TesteSamosFiscalFramework
dotnet new console --framework net472

# Adicionar refer�ncia
dotnet add reference "../Samos Fiscal Framework/Samos Fiscal Framework.csproj"

C�digo de Teste

using System;
using SamosFiscal.Framework;

class Program
{
    static void Main(string[] args)
    {
        Console.WriteLine("=== Teste Samos Fiscal Framework ===");
        Console.WriteLine();
        Console.WriteLine(LibraryInfo.GetInfo());
        Console.WriteLine();
        Console.WriteLine("Biblioteca carregada com sucesso!");
        Console.ReadKey();
    }
}

?? Sincroniza��o de C�digo

O c�digo � automaticamente sincronizado atrav�s de linked files:

1. Edita no projeto principal (.NET 10) ? Reflete automaticamente no Framework
2. Edita no projeto Framework ? Reflete automaticamente no principal
3. Um �nico c�digo-fonte para ambas as vers�es

?? Requisitos

Para Compilar

• ? .NET SDK 8.0+ (para suporte a multi-targeting)
• ? .NET Framework 4.7.2 Developer Pack

Para Executar (Aplica��o Final)

• ? .NET Framework 4.7.2 Runtime (j� instalado no Windows 10+)

?? Troubleshooting

Erro: "N�o foi poss�vel localizar SDK do .NET Framework"

Solu��o: Instale o .NET Framework 4.7.2 Developer Pack:

https://dotnet.microsoft.com/download/dotnet-framework/net472

Erro: "Os arquivos linked n�o s�o encontrados"

Solu��o: Certifique-se de que a estrutura de pastas est� correta:

Samos Fiscal/
??? Domain/
??? Application/
??? Infrastructure/
??? Samos Fiscal Framework/
    ??? Samos Fiscal Framework.csproj

Warnings CS8632

Solu��o: J� suprimidos no .csproj. Se ainda aparecerem, adicione:

<NoWarn>CS8632;CS1591</NoWarn>

?? Roadmap

• Projeto separado para .NET Framework 4.7.2
• Shared code via linked files
• Supress�o de warnings
• Documenta��o espec�fica
• Testes unit�rios espec�ficos
• Pacote NuGet publicado
• Exemplos de integra��o

?? Suporte

• ?? Email: suporte@websamos.com.br
• ?? Website: https://websamos.com.br
• ?? Documenta��o: Ver pasta Examples/

?? Licen�a

MIT License - Samos Inform�tica Ltda � 2025

Desenvolvido com ?? para m�xima compatibilidade com .NET Framework 4.7.2