UruFacturaSDK 1.0.0

UruFacturaSDK 🇺🇾

La vía rápida hacia la Facturación Electrónica en Uruguay

UruFactura SDK es una librería open-source .Net 10 C# de alto nivel diseñada para simplificar la integración de sistemas locales con el ecosistema de la DGI. Olvídate de lidiar con la complejidad manual de los sobres SOAP o la estructura rígida de los esquemas XML; esta herramienta actúa como un puente amigable entre tu lógica de negocio y los requisitos impositivos uruguayos.

🚀 Características Principales

📦 Estructura del Proyecto

UruFacturaSDK/
├── src/
│   └── UruFacturaSDK/
│       ├── Configuration/      # UruFacturaConfig
│       ├── Enums/              # TipoCfe, TipoIva, FormaPago, Moneda, Ambiente
│       ├── Exceptions/         # Excepciones tipadas del SDK
│       ├── Models/             # Cfe, Cae, Receptor, LineaDetalle, RespuestaDgi
│       ├── Xml/                # CfeXmlBuilder (generación XML DGI)
│       ├── Signature/          # CfeFirmante (XAdES-BES)
│       ├── Soap/               # DgiSoapClient (comunicación con DGI)
│       ├── Cae/                # CaeManager (gestión de CAE)
│       ├── Pdf/                # CfePdfGenerator (PDF A4 y térmico)
│       └── UruFacturaClient.cs # Facade principal del SDK
└── tests/
    └── UruFacturaSDK.Tests/    # Tests unitarios xUnit

🛠️ Uso Rápido

1. Configurar el cliente

var config = new UruFacturaConfig
{
    RutEmisor           = "210000000012",
    RazonSocialEmisor   = "Mi Empresa S.A.",
    DomicilioFiscal     = "Av. 18 de Julio 1234",
    Ciudad              = "Montevideo",
    Departamento        = "Montevideo",
    Ambiente            = Ambiente.Homologacion,
    RutaCertificado     = "/ruta/al/certificado.p12",
    PasswordCertificado = "mi_password",
};

using var client = new UruFacturaClient(config);

2. Crear y enviar un e-Ticket

using UruFacturaSDK.Models; // Cae, LineaDetalle, Receptor, RefCfe

// Registrar CAE
client.Cae.RegistrarCae(new Models.Cae
{
    NroSerie        = "CAE2025001",
    TipoCfe         = TipoCfe.ETicket,
    RangoDesde      = 1,
    RangoHasta      = 1000,
    FechaVencimiento = new DateTime(2026, 12, 31),
});

// Crear comprobante
var eticket = client.CrearETicket();
eticket.Numero = 1;
eticket.Detalle.Add(new LineaDetalle
{
    NroLinea      = 1,
    NombreItem    = "Servicio de consultoría",
    Cantidad      = 1,
    PrecioUnitario = 1000m,
    IndFactIva    = TipoIva.Basico,
});

// Generar XML, firmar y enviar
var xmlFirmado = client.GenerarYFirmar(eticket);
var respuesta  = await client.EnviarCfeAsync(eticket);

if (respuesta.Exitoso)
    Console.WriteLine($"✅ Aceptado: {respuesta.Mensaje}");

3. Generar PDF

// PDF A4
byte[] pdfA4 = client.GenerarPdfA4(eticket);
await File.WriteAllBytesAsync("eticket.pdf", pdfA4);

// PDF Térmico (ticket 80mm)
byte[] pdfTermico = client.GenerarPdfTermico(eticket);
await File.WriteAllBytesAsync("eticket_termico.pdf", pdfTermico);

4. Nota de crédito con referencia

var nc = client.CrearNotaCreditoETicket();
nc.Numero = 1;
nc.Referencias.Add(new RefCfe
{
    TipoCfe  = TipoCfe.ETicket,
    Serie    = "A",
    NroCfe   = 42,
    FechaCfe = new DateTime(2025, 6, 15),
    Razon    = "Devolución de mercadería",
});
nc.Detalle.Add(new LineaDetalle
{
    NroLinea       = 1,
    NombreItem     = "Devolución producto",
    Cantidad       = 1,
    PrecioUnitario = 500m,
    IndFactIva     = TipoIva.Basico,
});

5. Verificar estado de CAEs

var advertencias = client.Cae.ObtenerAdvertencias();
foreach (var advertencia in advertencias)
    Console.WriteLine(advertencia);

Console.WriteLine(client.Cae.ResumenEstado());

📄 Tipos de CFE soportados

🔧 Requisitos

• .NET 10 SDK
• Certificado digital DGI (.p12 / .pfx)
• CAE vigente emitido por la DGI

🧪 Tests

dotnet test tests/UruFacturaSDK.Tests/

📝 Licencia

MIT — ver LICENSE