Saltar a contenido

e-CF 33 — Nota de Débito Electrónica

POST /api/v1/documents/33
Authorization: Bearer <su-token>
Content-Type: application/json

El emisor.rnc del cuerpo dice de qué empresa es el comprobante y, a la vez, en nombre de quién se emite: la API comprueba que su token esté habilitado para esa empresa (cómo funciona).

Aumenta el valor de un comprobante ya emitido: intereses por mora, diferencias de precio a favor del vendedor, cargos omitidos. Siempre hace referencia al documento que modifica.

Para disminuir o anular, use la Nota de Crédito (34).

Particularidades

Aspecto Regla
Numeración id_doc.e_ncf (E33 + 10 dígitos) y id_doc.fecha_vencimiento_secuencia (dd-MM-aaaa) obligatorios: la numeración la lleva su sistema. Ver numeracion.md.
referencia Obligatoria. Debe indicar el NCF modificado, su fecha y el código de modificación.
codigo_modificacion Sólo 1–4. El código 5 es exclusivo de la Factura de Crédito Fiscal.
Formas de pago La forma 5 (bonos) no aplica: está reservada a la Factura de Consumo.
Comprador Opcional, pero conviene enviarlo (debe coincidir con el del documento original).
Líneas de detalle Máximo 1.000.

El bloque referencia

"referencia": {
  "ncf_modificado": "E310000000001",        // NCF del comprobante original
  "fecha_ncf_modificado": "20-07-2026",     // su fecha de emisión, dd-MM-aaaa
  "codigo_modificacion": "3",               // 3 = Corrige montos
  "razon_modificacion": "Ajuste de precio acordado con el cliente"
}

El ncf_modificado puede ser de serie E (13 caracteres, electrónico), B (11, no electrónico) o A/P (19), porque puede estar modificando un comprobante anterior a la facturación electrónica.

Código Cuándo usarlo en una nota de débito
1 Anula el comprobante original.
2 Corrige sólo texto (sin efecto en montos).
3 Corrige montos — el caso habitual.
4 Reemplaza un NCF emitido en contingencia.

Ejemplo

Cargo adicional de RD$2.000 + ITBIS sobre una factura ya emitida.

{
  "emisor": {
    "rnc": "133802074"
  },
  "comprador": {
    "rnc": "131880738",
    "razon_social": "COMERCIO, SRL"
  },
  "id_doc": {
    "e_ncf": "E330000000001",
    "fecha_vencimiento_secuencia": "31-12-2028",
    "indicador_monto_gravado": 0,
    "tipo_ingresos": "01",
    "tipo_pago": "1"
  },
  "items": [
    {
      "nombre": "Ajuste por diferencia de precio",
      "cantidad": 1,
      "unidad_medida": "43",
      "precio_unitario": 2000.00,
      "monto": 2000.00,
      "indicador_facturacion": 1,
      "indicador_bien_servicio": "1"
    }
  ],
  "totales": {
    "monto_gravado_total": 2000.00,
    "itbis1": 18,
    "total_itbis": 360.00,
    "monto_total": 2360.00,
    "monto_gravado_i1": 2000.00,
    "total_itbis1": 360.00
  },
  "referencia": {
    "ncf_modificado": "E310000000001",
    "fecha_ncf_modificado": "20-07-2026",
    "codigo_modificacion": "3",
    "razon_modificacion": "Ajuste de precio acordado con el cliente"
  }
}

Archivo: ejemplos/ecf-33-minimo.json

El detalle describe el ajuste, no la factura original: sólo lo que se está cargando de más.

En la representación impresa

La RI de una nota de débito muestra, bajo el e-NCF, el NCF Modificado y la descripción del código de modificación en palabras (p. ej. "Corrige montos del NCF modificado").

TrackID. La respuesta 202 siempre trae track_id: null: la transmisión ocurre después, en segundo plano. Al transmitirse, este tipo completo recibe su TrackID y el documento pasa a in_process_dgii (dónde aparece el TrackID).

Errores frecuentes

Cada mensaje llega en un 422 dentro de document.errors (y, por campo, en document.detailed_errors); la forma completa está en Cómo responde la API.

Mensaje Causa
El campo información de referencia es obligatorio. Toda nota de débito debe indicar qué documento modifica.
El campo fecha del NCF modificado no corresponde con el formato d-m-Y. Use dd-MM-aaaa (ej. 20-07-2026).
El campo código de modificación seleccionado es inválido. En las notas sólo se admiten 1–4.
El campo tipo de ingresos es obligatorio. Es obligatorio también en las notas.
Hay ítems gravados con ITBIS, así que el indicador de monto gravado (id_doc.indicador_monto_gravado) es obligatorio: 0 si los montos de las líneas no incluyen ITBIS, 1 si lo incluyen. Falta id_doc.indicador_monto_gravado. La DGII lo exige cuando hay ítems gravados (Formato e-CF, campo 7) y, si no viene, rechaza el comprobante con el código 176.
El campo fecha límite de pago es obligatorio cuando tipo de pago es 2. Una venta a crédito siempre declara su fecha_limite_pago.
La fecha límite de pago (…) no puede ser anterior a la fecha de emisión, que es la de hoy (…). id_doc.fecha_limite_pago está en el pasado. Con tipo_pago 2 (crédito) es obligatoria y tiene que ser igual o posterior a hoy.

Referencias