PalmeaGroup.DGII.Client 1.0.4

PalmeaGroup.Dgii.Client

Cliente para consultas web a la DGII (Republica Dominicana).

Caracteristicas

• Realiza consultas RNC, NCF y e-NCF contra la pagina de consultas publicas de la DGII.
• Implementado como cliente HTTP con IHttpClientFactory y politicas de reintento (Polly).
• Parsing tolerante de HTML a XML con helpers seguros (evita NullReference/ParseException).
• Logging estructurado para diagnosticos cuando el parseo falla.

Instalaci�n

• Anade el proyecto al Solution o compilalo como paquete NuGet. El ensamblado/namespace raiz es PalmeaGroup.Dgii.Client.

Registro en DI (ejemplo)

En Program.cs / startup:

using PalmeaGroup.Dgii.Client.Extensions;
using PalmeaGroup.Dgii.Client;

var builder = WebApplication.CreateBuilder(args);

// Registra named HttpClient con Polly y soporte de cookies
builder.Services.AddDgiiWrapper();

// Registra servicio
builder.Services.AddTransient<IServicioConsultasDgii, ServicioConsultasWebDgii>();

var app = builder.Build();

Uso (ejemplo)

public class Example
{
    private readonly IServicioConsultasDgii _dgii;

    public Example(IServicioConsultasDgii dgii) => _dgii = dgii;

    public async Task Run(CancellationToken ct)
    {
        var result = await _dgii.ConsultarENcf("123456789", "E0000000001", "", "", ct);
        if (result.Success)
        {
            Console.WriteLine($"Estado: {result.Estado}");
        }
        else
        {
            Console.WriteLine($"Mensaje: {result.Message}");
        }
    }
}

Notas sobre modelos (DTOs)

• Los DTOs estan en PalmeaGroup.Dgii.Client.Dtos.
• Propiedades importantes son anulables (string?, decimal?, DateTime?) porque la pagina puede devolver valores ausentes o con formato distinto.
• Se eliminaron acentos en nombres de propiedades publicas para interoperabilidad. Ejemplos:
  • ValidoHasta (antes ValidoHasta)
  • NombreORazonSocial (antes NombreORazonSocial)
  • Categoria (antes Categoria)

Logging y seguridad

• El servicio acepta ILogger<ServicioConsultasWebDgii> para registrar advertencias cuando el parseo falla.
• Evita loggear datos sensibles en produccion; se recomienda configurar un sink separado para diagnosticos y/o aplicar redaccion sobre RNC y codigos de seguridad.

Tests

• Hay un proyecto de tests de ejemplo en tests/PalmeaGroup.Dgii.Client.Tests.
• Ejecutar:

dotnet test ./tests/PalmeaGroup.Dgii.Client.Tests

Sugerencias futuras

• A�adir m�s pol�ticas Polly (circuit-breaker, jitter), configuraci�n desde IConfiguration.
• Mayor cobertura de tests con HTML de ejemplo (fixtures) y tests de integraci�n con handler mock.
• Empaquetar como NuGet y publicar con metadata adecuada.

Licencia

• C�digo del repositorio: revisa la licencia del proyecto (no incluida por defecto en este repo).