Formato de Documentos e-CF

JSON completo para cada uno de los 10 tipos de Comprobante Fiscal Electrónico que emite DGII, listo para enviar a POST /api/ecf/emitir. Nombres y descripciones verificados literal contra el manual oficial de DGII — no son una traducción libre.

Todos los ejemplos omiten encf a propósito — si no lo envías, se asigna automáticamente de tu secuencia. Si tu integración necesita controlar el número exacto (por ejemplo, para reintentar un envío fallido con el mismo eNCF), puedes enviarlo tú.

31 · Factura de Crédito Fiscal Electrónica

El comprobante B2B principal — cuando tu comprador es otra empresa (o persona) con RNC y necesita crédito fiscal para su ITBIS. rnc_comprador es obligatorio.

{
  "tipoeCF": 31,
  "fecha_emision": "2026-07-21",
  "rnc_comprador": "101234567",
  "razon_social_comprador": "Ferretería Popular SRL",
  "condicion_pago": 1,
  "tipo_pago": 1,
  "items": [
    { "descripcion": "Cemento gris 42.5kg", "cantidad": 50, "precio_unitario": 285.00, "itbis": 18 },
    { "descripcion": "Varilla 3/8 x 20ft", "cantidad": 20, "precio_unitario": 410.50, "itbis": 18, "descuento": 200.00 }
  ]
}

Campo	Notas
`rnc_comprador`	requerido
`razon_social_comprador`	opcional
`condicion_pago`	opcional — 1 Contado, 2 Crédito, 3 Gratuito
`fecha_vencimiento`	opcional — solo si `condicion_pago=2`
`tipo_pago`	opcional — 1 Efectivo, 2 Cheque, 3 Tarjeta débito/crédito, etc.

32 · Factura de Consumo Electrónica

El comprobante B2C — venta a consumidor final. A diferencia de los demás tipos, el comprador va en un objeto anidado comprador y es completamente opcional (una venta de mostrador no siempre tiene los datos del cliente).

{
  "tipoeCF": 32,
  "fecha_emision": "2026-07-21",
  "comprador": {
    "rnc": "40212345678",
    "razon_social": "Juan Pérez",
    "correo": "juan.perez@example.com"
  },
  "items": [
    { "descripcion": "Lenovo P16 (RZ2B72XP)", "cantidad": 1, "precio_unitario": 1440.68, "itbis": 18 }
  ]
}

Campo (dentro de `comprador`)	Notas
`rnc`	opcional — o cédula
`razon_social`, `identificador_extranjero`, `contacto`, `correo`, `direccion`, `municipio`, `provincia`	todos opcionales

Automático: si el monto_total es menor a RD$250,000, tu request a /emitir se procesa como RFCE (resumen) en vez de e-CF completo — así lo exige DGII. No tienes que decidirlo tú ni cambiar el endpoint.

33 · Nota de Débito Electrónica

Aumenta el monto de un e-CF ya emitido (cargo adicional, interés por mora, etc.). Siempre referencia el documento original.

{
  "tipoeCF": 33,
  "fecha_emision": "2026-07-21",
  "rnc_comprador": "101234567",
  "razon_social_comprador": "Ferretería Popular SRL",
  "encf_referenciado": "E310000025002",
  "codigo_modificacion": 5,
  "items": [
    { "descripcion": "Interés por mora — factura E310000025002", "cantidad": 1, "precio_unitario": 850.00, "itbis": 18 }
  ]
}

Campo	Notas
`rnc_comprador`	requerido
`encf_referenciado`	requerido — el eNCF del documento que estás modificando
`fecha_encf_referenciado`	opcional — por defecto la fecha de hoy
`codigo_modificacion`	opcional, por defecto `1` — ver códigos de modificación

34 · Nota de Crédito Electrónica

Reduce o anula un e-CF ya emitido (devolución, descuento posterior, error de facturación). Mismo formato que la Nota de Débito — la diferencia es que aquí el monto resta del documento original.

{
  "tipoeCF": 34,
  "fecha_emision": "2026-07-21",
  "rnc_comprador": "101234567",
  "razon_social_comprador": "Ferretería Popular SRL",
  "encf_referenciado": "E310000025002",
  "codigo_modificacion": 2,
  "items": [
    { "descripcion": "Devolución — 5 sacos de cemento", "cantidad": 5, "precio_unitario": 285.00, "itbis": 18 }
  ]
}

Códigos de modificación (aplican a notas 33/34): 1 Descuento · 2 Devolución · 3 Error de la RC · 4 Anulación · 5 Interés por mora · 6 Otros cargos · 7 Cambio de entrega · 8 Variación de precio.

41 · Compras Electrónico

Para registrar compras a proveedores informales o no registrados como emisores electrónicos — el comprobante lo genera quien compra, no quien vende.

{
  "tipoeCF": 41,
  "fecha_emision": "2026-07-21",
  "rnc_comprador": "101234567",
  "razon_social_comprador": "Agricultor Local (informal)",
  "items": [
    { "descripcion": "Compra de guineos — 200 unidades", "cantidad": 200, "precio_unitario": 12.00, "itbis": 0 }
  ]
}

Campo	Notas
`rnc_comprador`	requerido — aquí es tu propio RNC como comprador registrando la compra

43 · Gastos Menores Electrónico

Para gastos pequeños sin comprobante formal del proveedor (hasta el tope que fija DGII). Es el único tipo, junto al 44, donde no hace falta identificar al comprador.

{
  "tipoeCF": 43,
  "fecha_emision": "2026-07-21",
  "items": [
    { "descripcion": "Peaje autopista Duarte", "cantidad": 1, "precio_unitario": 100.00, "itbis": 0 }
  ]
}

44 · Régimenes Especiales Electrónica

Para contribuyentes bajo un régimen especial de tributación reconocido por DGII. No requiere datos de comprador.

{
  "tipoeCF": 44,
  "fecha_emision": "2026-07-21",
  "items": [
    { "descripcion": "Servicio bajo régimen especial", "cantidad": 1, "precio_unitario": 5000.00, "itbis": 0 }
  ]
}

45 · Gubernamental Electrónico

Para transacciones con entidades del gobierno dominicano.

{
  "tipoeCF": 45,
  "fecha_emision": "2026-07-21",
  "rnc_comprador": "401500001",
  "razon_social_comprador": "Ministerio de Obras Públicas",
  "items": [
    { "descripcion": "Suministro de materiales de construcción", "cantidad": 1, "precio_unitario": 350000.00, "itbis": 18 }
  ]
}

Campo	Notas
`rnc_comprador`	requerido

46 · Comprobante para Exportaciones Electrónico

Para ventas al exterior. A diferencia de los tipos B2B locales, aquí lo obligatorio es la razón social del comprador, no su RNC (un cliente en el extranjero normalmente no tiene uno).

{
  "tipoeCF": 46,
  "fecha_emision": "2026-07-21",
  "razon_social_comprador": "Global Trading Corp",
  "items": [
    { "descripcion": "Café orgánico — 500kg", "cantidad": 500, "precio_unitario": 8.50, "itbis": 0 }
  ]
}

Campo	Notas
`razon_social_comprador`	requerido
`rnc_comprador`	opcional

47 · Comprobante para Pagos al Exterior Electrónico

Para pagos o servicios prestados a un beneficiario en el exterior. El más particular de los 10: pide dirección y país del comprador, y soporta retención de ISR por ítem.

{
  "tipoeCF": 47,
  "fecha_emision": "2026-07-21",
  "razon_social_comprador": "Cloud Services LLC",
  "direccion_comprador": "1209 Orange St, Wilmington, DE",
  "pais_comprador": "US",
  "items": [
    {
      "descripcion": "Licencia de software anual",
      "cantidad": 1,
      "precio_unitario": 12000.00,
      "itbis": 0,
      "retencion": { "indicador": "1", "monto": 3480.00 }
    }
  ]
}

Campo	Notas
`razon_social_comprador`	requerido
`direccion_comprador`, `pais_comprador`	opcional — `pais_comprador` por defecto `US`
`items[].retencion.indicador` / `.monto`	opcional — retención de ISR sobre ese ítem

Formato de ítems (todos los tipos)

La estructura de cada objeto dentro de items[] es la misma en los 10 tipos.

Campo	Notas
`descripcion`	requerido
`cantidad`	requerido
`precio_unitario`	requerido
`itbis`	opcional, por defecto `18` — porcentaje: `0`, `16` o `18`
`descuento`	opcional — monto de descuento en ese ítem
`codigo`	opcional — tu código interno de producto
`unidad` / `unidad_medida`	opcional
`indicador_bien_servicio`	opcional, por defecto `1` — 1 Bien, 2 Servicio, 3 Otros

Secciones especiales por tipo

Qué necesita cada tipo más allá de lo común (fecha_emision + items, siempre requeridos).

Sección	31	32	33	34	41	43	44	45	46	47
RNC de comprador requerido	✓	—	✓	✓	✓	—	—	✓	—	—
Razón social de comprador requerida	—	—	—	—	—	—	—	—	✓	✓
Comprador en objeto anidado	—	✓	—	—	—	—	—	—	—	—
Sin datos de comprador	—	—	—	—	—	✓	✓	—	—	—
`encf_referenciado` requerido	—	—	✓	✓	—	—	—	—	—	—
Puede procesarse como RFCE	—	✓	—	—	—	—	—	—	—	—
Retención de ISR por ítem	—	—	—	—	—	—	—	—	—	✓
País / dirección del comprador	—	—	—	—	—	—	—	—	—	✓