SDK C# / .NET

dotnet add package EcfService.Sdk --version 0.2.0

using EcfService.Sdk;

using var client = new EcfClient("ecf_...");
var health = await client.HealthAsync();

// Inyección: reutiliza sockets / IHttpClientFactory
builder.Services.AddHttpClient<EcfClient>((sp, http) =>
{
    http.BaseAddress = new Uri("https://api.emite.do/api/v1/");
    http.DefaultRequestHeaders.Add("X-API-Key", config["Emite:ApiKey"]);
});
// Luego: new EcfClient(httpClient) — no dispose el HttpClient del factory

using EcfService.Sdk;
using EcfService.Sdk.Models;

using var client = new EcfClient("ecf_...");

var payload = new EcfPayloadBuilder(EcfType.E31)
    .IdDoc(new Dictionary<string, object?>
    {
        ["eNCF"] = "E310000000001",
        ["FechaVencimientoSecuencia"] = "31-12-2028",
        ["IndicadorMontoGravado"] = 0,
        ["TipoIngresos"] = IncomeType.Operational,
        ["TipoPago"] = PaymentType.Cash,
    })
    .Emisor(new Dictionary<string, object?>
    {
        ["RNCEmisor"] = "130478031",
        ["RazonSocialEmisor"] = "Mi Empresa SRL",
        ["FechaEmision"] = DateTime.Today.ToString("dd-MM-yyyy"),
    })
    .Comprador(new Dictionary<string, object?>
    {
        ["RNCComprador"] = "131098193",
        ["RazonSocialComprador"] = "Cliente SRL",
    })
    .Totales(new Dictionary<string, object?>
    {
        ["MontoTotal"] = 11800.0,
        ["TotalITBIS"] = 1800.0,
    })
    .AddItem(new Dictionary<string, object?>
    {
        ["NumeroLinea"] = 1,
        ["NombreItem"] = "SERVICIO DEMO",
        ["IndicadorFacturacion"] = BillingIndicator.Itbis18,
        ["IndicadorBienoServicio"] = BienOServicio.Service,
        ["CantidadItem"] = 1.0,
        ["MontoItem"] = 10000.0,
    })
    .Build();

EcfDocument doc = await client.Ecf.CreateAsync(
    idempotencyKey: "INV-2026-0001",
    ecfType: EcfType.E31,
    payload: payload,
    environment: EcfEnvironment.Test
);
Console.WriteLine($"{doc.PublicId} {doc.Status}"); // Received

doc = await client.Ecf.GetAsync(doc.PublicId);
byte[] xml = await client.Ecf.DownloadXmlAsync(doc.PublicId);

var profile = await client.Client.CompanyAsync();
var emisor = Emisor.Build(profile, new Dictionary<string, object?>
{
    ["FechaEmision"] = "15-08-2026",
});

var profile = await client.Client.CompanyAsync();
var seqs = await client.Client.SequencesAsync(activeOnly: true);
var inbox = await client.Client.InboxAsync(acked: false);
await client.Client.AckInboxAsync(inbox.Items[0].PublicId);

await client.Ecf.SubmitAcecfAsync(
    idempotencyKey: "ac-001",
    encf: "E310000000001",
    rncEmisor: "130478031",
    rncComprador: "131098193",
    fechaEmision: "15-08-2026",
    montoTotal: "11800.00",
    estado: "1"
);

await client.Ecf.CancelSequencesAsync("an-001", new[]
{
    new CancellationLine
    {
        EcfType = EcfType.E31,
        SequenceFrom = "E310000000010",
        SequenceTo = "E310000000012",
        Quantity = 3
    }
});

using EcfService.Sdk.Webhooks;

var wh = await client.Client.CreateWebhookAsync(
    "https://mi-app.example/webhooks/ecf",
    new List<string> { "accepted", "conditionally_accepted", "rejected" }
);
bool ok = WebhookVerifier.VerifySignature(
    requestBody,
    Request.Headers["X-ECF-Signature"].ToString(),
    wh.Secret
);