SfeRepGrafica.Core 2.1.0

SfeRepGrafica

Libreria .NET para la generacion de representaciones graficas (PDF) de facturas electronicas bajo la normativa del Sistema de Facturacion Electronica (SFE) de Bolivia.

Descripcion

SfeRepGrafica genera documentos PDF a partir de datos de facturacion, soportando multiples tipos de documentos fiscales definidos por el SIN (Servicio de Impuestos Nacionales). La libreria implementa el patron Strategy para generar dos formatos de factura:

• Ejecutiva (Carta): Factura en formato carta estandar (Letter) con cabecera, datos del cliente, detalle de productos, totales, leyendas y codigo QR.
• POS (Rollo): Factura en formato rollo/ticket para impresoras termicas POS.

Estructura del Proyecto

SfeRepGraficaSolution.sln
├── SfeRepGrafica.Core/          # Libreria principal (NuGet package)
│   ├── Engine/                  # FacturaCreator, DTO, enums
│   ├── Enum/                    # TipoDocumentoSectorEnum (53 tipos de documento)
│   ├── Helpers/                 # FacturaFonts, ITextShapHelper, ImageManager, QR
│   ├── Impresion/               # IImpresionFactura, FacturaEjecutiva, FacturaPos
│   └── Value/                   # Configuracion por tipo de documento fiscal
├── SfeRepGrafica.Client/        # Cliente de prueba (consola)
├── SfeRepGrafica.Api.Test/      # API de prueba
└── SfeRepGrafica.Test/          # Tests unitarios (MSTest)

Requisitos

• .NET 10.0 SDK
• Visual Studio 2022+ o VS Code

Instalacion

Como paquete NuGet

El proyecto SfeRepGrafica.Core genera un paquete NuGet al compilar:

dotnet build SfeRepGrafica.Core/SfeRepGrafica.Core.csproj -c Release

El paquete se genera en SfeRepGrafica.Core/bin/Release/SfeRepGrafica.Core.2.1.0.nupkg.

Referencia directa al proyecto

<ProjectReference Include="path/to/SfeRepGrafica.Core/SfeRepGrafica.Core.csproj" />

Uso

using SfeRepGrafica.Core.Engine;
using SfeRepGrafica.Core.Enum;

// Crear el generador
var facturaGenerador = new FacturaCreator();

// Preparar los datos de la factura
var datos = new FacturaRepGrafDto
{
    NombreEmpresa = "Mi Empresa S.R.L.",
    DatosSucursal = "Casa Matriz",
    DatosDetalleSucursal = "Av. Principal #123",
    TipoDocumentoSector = TipoDocumentoSectorEnum.FacturaCompraVenta,
    NitEmisor = "1234567890",
    Autorizacion = "27141900292138",
    NroFactura = 1001,
    NombreCliente = "Juan Perez",
    NitCliente = "9876543",
    Leyenda = "Ley N 453: Puedes presentar tu reclamo...",
    LeyendaTipoNegocio = "CONTRIBUYENTE REGIMEN GENERAL",
    FechaEmision = DateTime.Now,
    Qr = "https://sfe.impuestos.gob.bo/...",
    // ... demas campos
};

// Generar PDF formato Ejecutiva (Carta)
byte[] pdfCarta = facturaGenerador.GenerarRepresentacionGrafica(
    EnumFacturaTipo.EJECUTIVA, datos);

// Generar PDF formato POS (Rollo/Ticket)
byte[] pdfPos = facturaGenerador.GenerarRepresentacionGrafica(
    EnumFacturaTipo.POS, datos);

// Guardar el PDF
File.WriteAllBytes("factura.pdf", pdfCarta);

Merge de multiples PDFs

using SfeRepGrafica.Core.Helpers;

var pdfs = new List<byte[]> { pdf1, pdf2, pdf3 };
byte[] merged = ITextShapHelper.MergePDFs(pdfs);

Generar codigo QR

byte[] qrPng = ITextShapHelper.GenerarQr("datos-para-el-qr");

Tipos de Documento Soportados

La libreria soporta los 49 tipos de documentos fiscales definidos en TipoDocumentoSectorEnum (codigos 1-53 con saltos), incluyendo:

Cada tipo de documento tiene su propia configuracion de detalle (columnas, campos, formato) definida en ConfigRepGraficaDetalleValue.

Dependencias

Build y Tests

# Compilar la solucion
dotnet build SfeRepGraficaSolution.sln

# Ejecutar tests
dotnet test SfeRepGrafica.Test/SfeRepGrafica.Test.csproj

Autor

Deyvi Josue Ortiz Vidaurre

Configuraciones de Detalle por Tipo

Cada tipo de documento se mapea a una de 9 configuraciones de detalle en ConfigRepGraficaDetalleValue:

Version

2.1.0