FacturaE.Sdk 3.3.3

FacturaE SDK

SDK .NET para facturación electrónica en Colombia y eventos RADIAN con integración a la DIAN.

Instalación

dotnet add package FacturaE.Sdk

Inicio Rápido

Factura Electrónica

var dianClient = new DianClient(new DianClientOptions 
{
    ConnectionString = "Endpoint=https://...",
    Software = new SoftwareDian { ... }
});

var service = new FacturaElectronicaService(dianClient, AmbienteDian.Pruebas);

var factura = new FacturaElectronica { ... };
var response = await service.EnvieAsync(factura);

Eventos RADIAN

Enviar Eventos

var radianService = new RadianService(dianClient, AmbienteDian.Pruebas);

// Inscribir título
var inscripcion = new InscripcionTitulo { ... };
await radianService.EnvieAsync(inscripcion);

// Endosar
var endoso = new Endoso { ... };
await radianService.EnvieAsync(endoso);

// Pagar
var pago = new Pago { ... };
await radianService.EnvieAsync(pago);

Consultar Eventos

// Obtener un evento
var evento = await radianService.GetEventoAsync(cude);

// Obtener evento con tipo específico
var pago = await radianService.GetEventoAsync<Pago>(cude);
var endoso = await radianService.GetEventoAsync<Endoso>(cude);

// Obtener todos los eventos de un título
var eventos = await radianService.GetEventosAsync(cufe);

Eventos RADIAN Soportados

• 034 - AceptacionTacita
• 036 - InscripcionTituloValor
• 037-039, 047 - Endoso (propiedad, garantía, procuración, ordinario)
• 040 - CancelacionEndoso
• 043 - Mandato
• 045 - Pago
• 046 - InformePago
• 048 - Protesto
• 049 - TransferenciaDerechos
• 050 - NotificacionTransferenciaDerechos

Ejemplos de Uso

Inscribir Título Valor Electrónico

var inscripcion = new InscripcionTitulo
{
    Titular = new EntidadTributaria
    {
        Identificacion = "900123456",
        TipoIdentificacion = "31",
        RazonSocial = "MI EMPRESA SAS"
    },
    ValorTotal = 10000000m,
    ValorPagado = 0m,
    FechaEmision = DateTimeOffset.Now.ToOffset(TimeSpan.FromHours(-5))
};

var response = await radianService.EnvieAsync(inscripcion);
if (response.Succeeded)
{
    Console.WriteLine($"Título inscrito: {response.Cude}");
}

Endosar un Título

var endoso = new Endoso
{
    Efecto = EfectoEndoso.EnPropiedad,
    ReferenciaId = "cude-evento-previo",
    Endosante = new EntidadTributaria { ... },
    Endosatario = new EntidadTributaria { ... },
    ValorTotal = 10000000m,
    ValorPagar = 10000000m,
    FechaEmision = DateTimeOffset.Now.ToOffset(TimeSpan.FromHours(-5))
};

await radianService.EnvieAsync(endoso);

Registrar Mandato

var mandato = new Mandato
{
    Mandante = new EntidadTributaria { ... },
    TiempoMandato = TiempoMandato.Ilimitado,
    TipoMandato = TipoMandato.DocumentoGeneral,
    FechaEmision = DateTimeOffset.Now.ToOffset(TimeSpan.FromHours(-5)),
    FechaEfectiva = DateTime.Now
};

await radianService.EnvieAsync(mandato);

Registrar Pago

var pago = new Pago
{
    ReferenciaId = "cude-titulo",
    TipoPago = TipoPago.PagoTotalTitulo,
    PagoTotal = true,
    ValorPagado = 10000000m,
    ValorActual = 10000000m,
    ValorPendiente = 0m,
    FechaEfectiva = DateTime.Now,
    FechaEmision = DateTimeOffset.Now.ToOffset(TimeSpan.FromHours(-5))
};

await radianService.EnvieAsync(pago);

Transferir Derechos Económicos

var transferencia = new TransferenciaDerechos
{
    ReferenciaId = "cude-titulo",
    Emisor = new EntidadTributaria { ... }, // Tenedor actual
    Receptor = new EntidadTributaria { ... }, // Nuevo tenedor
    ConResponsabilidad = false,
    EsTransferenciaParcial = false,
    ValorTotal = 10000000m,
    FechaEmision = DateTimeOffset.Now.ToOffset(TimeSpan.FromHours(-5))
};

await radianService.EnvieAsync(transferencia);

Consultar y Procesar Eventos

// Obtener todos los eventos de un título
var eventos = await radianService.GetEventosAsync(cufe);

foreach (var evento in eventos)
{
    switch (evento)
    {
        case InscripcionTitulo inscripcion:
            Console.WriteLine($"Título: {inscripcion.ValorTotal:C}");
            break;
        case Endoso endoso:
            Console.WriteLine($"Endosado a: {endoso.Endosatario.RazonSocial}");
            break;
        case Pago pago:
            Console.WriteLine($"Pago: {pago.ValorPagado:C}");
            break;
    }
}

// Obtener un evento específico con tipo
var endoso = await radianService.GetEventoAsync<Endoso>(cude);
if (endoso != null)
{
    Console.WriteLine($"Endosante: {endoso.Endosante.RazonSocial}");
    Console.WriteLine($"Endosatario: {endoso.Endosatario.RazonSocial}");
    Console.WriteLine($"Efecto: {endoso.Efecto}");
    Console.WriteLine($"Valor: {endoso.ValorPagar:C}");
}

Generación de Attached Document

// Generar documento adjunto para notificación de evento
var attachedDoc = await radianService.GenereAttachedDocument(cufe, cude);

// Enviar por correo u otro canal
using var reader = new StreamReader(attachedDoc);
var xml = await reader.ReadToEndAsync();

Almacenamiento y Caché de Eventos

// Implementar almacenamiento personalizado
public class DatabaseArchivosRadianSink : IArchivosRadianSink
{
    public async Task StoreAsync(string key, Stream content)
    {
        // Guardar en base de datos
    }

    public async Task<Stream> LoadAsync(string key)
    {
        // Cargar desde base de datos o retornar null
    }
}

// Usar almacenamiento personalizado
var radianService = new RadianService(
    dianClient, 
    AmbienteDian.Pruebas,
    archivosSink: new DatabaseArchivosRadianSink()
);

Callbacks de Eventos

// Reaccionar a envíos exitosos de eventos
var radianService = new RadianService(
    dianClient,
    AmbienteDian.Pruebas,
    onEventoEnviado: async (evento, response) =>
    {
        Console.WriteLine($"Evento {evento.TipoEvento} enviado: {response.Cude}");
        await NotificarInteresados(evento, response);
    }
);

Firmas Digitales

Todos los documentos se firman con XAdES-EPES. Instale su certificado DIAN en el almacén CurrentUser y configure la huella digital:

Software = new SoftwareDian 
{
    Thumbprint = "HUELLA_DIGITAL_CERTIFICADO",
    ...
}

Configuración

var options = new DianClientOptions
{
    ConnectionString = "Endpoint=https://...;AccessKey=...",
    Software = new SoftwareDian
    {
        SoftwareId = Guid.Parse("..."),
        Pin = "...",
        ProviderId = "...",
        Thumbprint = "..."
    }
};