Instalación

Requisitos previos

Antes de instalar el SDK, asegurate de tener:

• .NET 10 SDK o superior (descargar)
• Un certificado digital en formato .p12 / .pfx emitido por una CA reconocida por AGESIC
• Un CAE vigente otorgado por DGI

Note

¿Todavía no tenés el certificado o CAE? Podés usar el ambiente de Homologación de DGI para hacer pruebas sin documentos reales. Consultá la Guía de Certificación DGI.

---

Elegir el paquete

UruFactura SDK se distribuye en dos variantes NuGet:

Paquete	Descripción	Cuándo usarlo
UruFacturaSDK	Paquete completo con generación de PDF A4 y térmico (QuestPDF + SkiaSharp + ZXing)	Uso general
UruFacturaSDK.Lite	Sin dependencias de PDF. Incluye ICfePdfGenerator para inyectar tu propio generador	Microservicios, Azure Functions, entornos con restricciones de peso

---

Instalar el paquete NuGet

Paquete completo

dotnet add package UruFacturaSDK

Paquete Lite

dotnet add package UruFacturaSDK.Lite

Package Manager Console

Install-Package UruFacturaSDK
# o para la versión Lite:
Install-Package UruFacturaSDK.Lite

PackageReference (csproj)

<!-- Paquete completo -->
<PackageReference Include="UruFacturaSDK" Version="*" />

<!-- Paquete Lite -->
<PackageReference Include="UruFacturaSDK.Lite" Version="*" />

Tip

Para fijar una versión específica en producción, reemplazá * por el número de versión que encontrás en la página de NuGet, por ejemplo Version="1.0.0".

---

Verificar la instalación

Después de instalar, verificá que el paquete esté disponible:

dotnet list package

Deberías ver algo como:

> UruFacturaSDK    1.0.0

---

Configuración básica

1. Importar los namespaces necesarios

   using UruFacturaSDK;
   using UruFacturaSDK.Configuration;
   using UruFacturaSDK.Models;
   using UruFacturaSDK.Enums;

2. Crear la configuración del emisor

   var config = new UruFacturaConfig
   {
       RutEmisor           = "210000000012",      // 12 dígitos, sin puntos ni guión
       RazonSocialEmisor   = "Mi Empresa S.A.",
       DomicilioFiscal     = "Av. 18 de Julio 1234",
       Ciudad              = "Montevideo",
       Departamento        = "Montevideo",
       Ambiente            = Ambiente.Homologacion, // ← Usar Homologacion para pruebas
       RutaCertificado     = "/ruta/al/certificado.p12",
       PasswordCertificado = Environment.GetEnvironmentVariable("CERT_PASSWORD")!,
   };

   Caution

   Nunca almacenés PasswordCertificado en texto plano en el código fuente. Usá variables de entorno, user secrets de .NET, o un gestor de secretos como Azure Key Vault.

3. Instanciar el cliente

   Constructor (paquete completo)

   // Todas las implementaciones predeterminadas, incluyendo PDF
   using var client = new UruFacturaClient(config);

   Builder (recomendado)

   // Paquete completo con PDF
   using var client = UruFacturaClientBuilder.WithDefaults(config)
       .WithDefaultPdf()
       .Build();
   
   // Paquete Lite (sin PDF, o con generador personalizado)
   using var client = UruFacturaClientBuilder.WithDefaults(config)
       .Build();

   El cliente implementa IDisposable, por lo que se recomienda usarlo dentro de un bloque using.

4. Registrar un CAE

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

---

Integración con ASP.NET Core / Dependency Injection

Si estás usando ASP.NET Core, podés registrar el cliente en el contenedor de DI:

Program.cs

builder.Services.AddSingleton<UruFacturaConfig>(sp =>
{
    return new UruFacturaConfig
    {
        RutEmisor           = builder.Configuration["UruFactura:RutEmisor"]!,
        RazonSocialEmisor   = builder.Configuration["UruFactura:RazonSocial"]!,
        DomicilioFiscal     = builder.Configuration["UruFactura:Domicilio"]!,
        Ciudad              = builder.Configuration["UruFactura:Ciudad"]!,
        Departamento        = builder.Configuration["UruFactura:Departamento"]!,
        Ambiente            = Enum.Parse<Ambiente>(builder.Configuration["UruFactura:Ambiente"]!),
        RutaCertificado     = builder.Configuration["UruFactura:RutaCertificado"]!,
        PasswordCertificado = builder.Configuration["UruFactura:PasswordCertificado"]!,
    };
});

// Registrar como IUruFacturaClient para inyección por interfaz
builder.Services.AddSingleton<IUruFacturaClient>(sp =>
{
    var config = sp.GetRequiredService<UruFacturaConfig>();
    return UruFacturaClientBuilder.WithDefaults(config)
        .WithDefaultPdf()   // omitir si usás UruFacturaSDK.Lite
        .Build();
});

appsettings.json

{
  "UruFactura": {
    "RutEmisor": "210000000012",
    "RazonSocial": "Mi Empresa S.A.",
    "Domicilio": "Av. 18 de Julio 1234",
    "Ciudad": "Montevideo",
    "Departamento": "Montevideo",
    "Ambiente": "Homologacion",
    "RutaCertificado": "/ruta/al/certificado.p12"
  }
}

// appsettings.Production.json (o secrets.json)
{
  "UruFactura": {
    "PasswordCertificado": "tu_contraseña_segura"
  }
}

---

Próximos pasos

• Uso Rápido → — Emitir tu primer CFE
• Configuración → — Todas las opciones de configuración