Emite e-CF desde tu sistema con un solo POST

{ "rangos": [ { "desde": "E310000000038", "hasta": "E310000000500" } ] }

{
  "id": "8a4e45f7-ad12-4dab-86f6-3c14ff036abd",
  "estado": "Aceptada",
  "rangos": ["E310009100002-E310009100020"],
  "cantidad": 19,
  "mensajes": ["Las secuencias fueron anuladas correctamente."],
  "creadoEn": "2026-10-30T20:40:19-04:00"
}

{
  "ecf": {
    "Encabezado": {
      "IdDoc": { "TipoeCF": 31, "IndicadorMontoGravado": 0, "TipoIngresos": "01", "TipoPago": 2, "FechaLimitePago": "29-11-2026", "TerminoPago": "30 días" },
      "Emisor": {
        "RazonSocialEmisor": "Tu Empresa SRL",
        "NombreComercial": "Tu Empresa",
        "DireccionEmisor": "Av. Winston Churchill 1099, Santo Domingo",
        "NumeroFacturaInterna": "FACT-000123",
        "FechaEmision": "30-10-2026"
      },
      "Comprador": { "RNCComprador": "131880681", "RazonSocialComprador": "DOCUMENTOS ELECTRONICOS DE 03" },
      "Totales": { "MontoGravadoTotal": "2500.00", "MontoGravadoI1": "2500.00", "ITBIS1": 18, "TotalITBIS": "450.00", "TotalITBIS1": "450.00", "MontoTotal": "2950.00" }
    },
    "DetallesItems": {
      "Item": [
        { "NumeroLinea": 1, "IndicadorFacturacion": 1, "NombreItem": "Servicio de mantenimiento preventivo", "IndicadorBienoServicio": 2, "CantidadItem": 1, "PrecioUnitarioItem": "1500.00", "MontoItem": "1500.00" },
        { "NumeroLinea": 2, "IndicadorFacturacion": 1, "NombreItem": "Filtro de aire", "IndicadorBienoServicio": 1, "CantidadItem": 2, "PrecioUnitarioItem": "500.00", "MontoItem": "1000.00" }
      ]
    }
  }
}

{
  "ecf": {
    "Encabezado": {
      "IdDoc": {
        "TipoeCF": 32, "IndicadorMontoGravado": 0, "TipoIngresos": "01", "TipoPago": 1,
        "TablaFormasPago": { "FormaDePago": [ { "FormaPago": 1, "MontoPago": "500.00" }, { "FormaPago": 3, "MontoPago": "90.00" } ] }
      },
      "Emisor": { "RazonSocialEmisor": "Tu Empresa SRL", "DireccionEmisor": "Av. Winston Churchill 1099, Santo Domingo", "FechaEmision": "30-10-2026" },
      "Totales": { "MontoGravadoTotal": "500.00", "MontoGravadoI1": "500.00", "ITBIS1": 18, "TotalITBIS": "90.00", "TotalITBIS1": "90.00", "MontoTotal": "590.00" }
    },
    "DetallesItems": {
      "Item": [
        { "NumeroLinea": 1, "IndicadorFacturacion": 1, "NombreItem": "Café americano", "IndicadorBienoServicio": 1, "CantidadItem": 2, "PrecioUnitarioItem": "150.00", "MontoItem": "300.00" },
        { "NumeroLinea": 2, "IndicadorFacturacion": 1, "NombreItem": "Sándwich de pollo", "IndicadorBienoServicio": 1, "CantidadItem": 1, "PrecioUnitarioItem": "200.00", "MontoItem": "200.00" }
      ]
    }
  }
}

{
  "ecf": {
    "Encabezado": {
      "IdDoc": { "TipoeCF": 32, "IndicadorMontoGravado": 0, "TipoIngresos": "01", "TipoPago": 1, "TablaFormasPago": { "FormaDePago": [ { "FormaPago": 2, "MontoPago": "295000.00" } ] } },
      "Emisor": { "RazonSocialEmisor": "Tu Empresa SRL", "DireccionEmisor": "Av. Winston Churchill 1099, Santo Domingo", "FechaEmision": "30-10-2026" },
      "Comprador": { "RNCComprador": "131880681", "RazonSocialComprador": "DOCUMENTOS ELECTRONICOS DE 03" },
      "Totales": { "MontoGravadoTotal": "250000.00", "MontoGravadoI1": "250000.00", "ITBIS1": 18, "TotalITBIS": "45000.00", "TotalITBIS1": "45000.00", "MontoTotal": "295000.00" }
    },
    "DetallesItems": {
      "Item": [ { "NumeroLinea": 1, "IndicadorFacturacion": 1, "NombreItem": "Equipo de cómputo", "IndicadorBienoServicio": 1, "CantidadItem": 1, "PrecioUnitarioItem": "250000.00", "MontoItem": "250000.00" } ]
    }
  }
}

{
  "ecf": {
    "Encabezado": {
      "IdDoc": { "TipoeCF": 34, "IndicadorNotaCredito": 0, "IndicadorMontoGravado": 0, "TipoIngresos": "01", "TipoPago": 1 },
      "Emisor": { "RazonSocialEmisor": "Tu Empresa SRL", "DireccionEmisor": "Av. Winston Churchill 1099, Santo Domingo", "FechaEmision": "30-10-2026" },
      "Comprador": { "RNCComprador": "131880681", "RazonSocialComprador": "DOCUMENTOS ELECTRONICOS DE 03" },
      "Totales": { "MontoGravadoTotal": "500.00", "MontoGravadoI1": "500.00", "ITBIS1": 18, "TotalITBIS": "90.00", "TotalITBIS1": "90.00", "MontoTotal": "590.00" }
    },
    "DetallesItems": {
      "Item": [ { "NumeroLinea": 1, "IndicadorFacturacion": 1, "NombreItem": "Devolución: filtro de aire", "IndicadorBienoServicio": 1, "CantidadItem": 1, "PrecioUnitarioItem": "500.00", "MontoItem": "500.00" } ]
    },
    "InformacionReferencia": { "NCFModificado": "E310000000001", "FechaNCFModificado": "30-10-2026", "CodigoModificacion": 3, "RazonModificacion": "Devolución de mercancía" }
  }
}

using System.Net.Http.Headers;
using System.Net.Http.Json;
using System.Text.Json;

var http = new HttpClient { BaseAddress = new Uri("https://test.ncf.do") };
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("NCF_CLAVE"));

var factura = new
{
    ecf = new
    {
        Encabezado = new
        {
            IdDoc = new { TipoeCF = 31, IndicadorMontoGravado = 0, TipoIngresos = "01", TipoPago = 1 },
            Emisor = new { RazonSocialEmisor = "Tu Empresa SRL", DireccionEmisor = "Av. Winston Churchill 1099, Santo Domingo", FechaEmision = "30-10-2026" },
            Comprador = new { RNCComprador = "131880681", RazonSocialComprador = "DOCUMENTOS ELECTRONICOS DE 03" },
            Totales = new { MontoGravadoTotal = "1000.00", MontoGravadoI1 = "1000.00", ITBIS1 = 18, TotalITBIS = "180.00", TotalITBIS1 = "180.00", MontoTotal = "1180.00" },
        },
        DetallesItems = new
        {
            Item = new[] { new { NumeroLinea = 1, IndicadorFacturacion = 1, NombreItem = "Servicio", IndicadorBienoServicio = 2, CantidadItem = 1, PrecioUnitarioItem = "1000.00", MontoItem = "1000.00" } },
        },
    },
};

using var pedido = new HttpRequestMessage(HttpMethod.Post, "/api/v1/ecf") { Content = JsonContent.Create(factura) };
pedido.Headers.Add("Idempotency-Key", "FACT-000123"); // el número de la factura en tu sistema
using var respuesta = await http.SendAsync(pedido);
var cuerpo = await respuesta.Content.ReadAsStringAsync();
if (!respuesta.IsSuccessStatusCode)
    throw new InvalidOperationException($"ncf.do respondió {(int)respuesta.StatusCode}: {cuerpo}");

using var json = JsonDocument.Parse(cuerpo);
var id = json.RootElement.GetProperty("id").GetString();         // guárdalo para consultar
var encf = json.RootElement.GetProperty("encf").GetString();     // a la factura impresa
var qr = json.RootElement.GetProperty("urlTimbre").GetString();  // contenido del QR

const base = "https://test.ncf.do";
const encabezados = { Authorization: `Bearer ${process.env.NCF_CLAVE}` };

async function emitir(factura, numeroInterno) {
  const r = await fetch(`${base}/api/v1/ecf`, {
    method: "POST",
    headers: { ...encabezados, "Idempotency-Key": numeroInterno, "Content-Type": "application/json" },
    body: JSON.stringify(factura),
  });
  const cuerpo = await r.json();
  if (!r.ok) throw new Error(`${r.status} ${cuerpo.detail} ${JSON.stringify(cuerpo.errors ?? {})}`);
  return cuerpo; // id, encf, codigoSeguridad, fechaHoraFirma, urlTimbre
}

async function esperarDgii(id) {
  for (let i = 0; i < 12; i++) {
    await new Promise((listo) => setTimeout(listo, i === 0 ? 5000 : 30000));
    const ecf = await (await fetch(`${base}/api/v1/ecf/${id}`, { headers: encabezados })).json();
    if (!["Pendiente", "EnProceso"].includes(ecf.dgii.estado)) return ecf; // Aceptado, Rechazado…
  }
  return null; // sigue en proceso: revisarla más tarde
}

import json
import os

import requests

base = "https://test.ncf.do"
encabezados = {"Authorization": f"Bearer {os.environ['NCF_CLAVE']}"}

with open("factura.json", encoding="utf-8") as archivo:
    factura = json.load(archivo)

r = requests.post(
    f"{base}/api/v1/ecf",
    json=factura,
    headers={**encabezados, "Idempotency-Key": "FACT-000123"},
    timeout=30,
)
cuerpo = r.json()
if not r.ok:
    raise RuntimeError(f"{r.status_code}: {cuerpo.get('detail')} {cuerpo.get('errors')}")

print(cuerpo["encf"], cuerpo["codigoSeguridad"], cuerpo["urlTimbre"])

# Emitir (la factura en factura.json)
curl -X POST https://test.ncf.do/api/v1/ecf \
  -H "Authorization: Bearer $NCF_CLAVE" \
  -H "Idempotency-Key: FACT-000123" \
  -H "Content-Type: application/json" \
  -d @factura.json

# Consultar su estado con el id de la respuesta
curl https://test.ncf.do/api/v1/ecf/aa81bdd3-6f78-4e09-9f9a-993b6d30170e \
  -H "Authorization: Bearer $NCF_CLAVE"