Pacioli API e-CF

E34 — Nota de Crédito Electrónica

← Volver al índice

Para qué sirve

Anula total o parcialmente un comprobante ya emitido: devoluciones, descuentos posteriores, errores de monto o de texto. Siempre referencia el comprobante original.

Cuándo NO usarlo

Campos

Obligatorios

Campo Notas
tipo_ecf = "34", encf (E34…), fecha_emision
tipo_pago Obligatorio en el XSD del E34. Sin él, 422.
direccion_emisor, monto_total, valor_pagar, totales, detalle
ncf_modificado e-NCF (o NCF) del comprobante que se anula/modifica.
fecha_ncf_modificado Fecha de emisión de ese comprobante.
codigo_modificacion 1 anula, 2 corrige texto, 3 corrige montos, 4 reemplaza NCF de contingencia, 5 referencia a Factura de Consumo. Ver tabla.

Si falta alguno de los tres campos de referencia, la respuesta es 500 con el mensaje El campo ... es obligatorio para Notas de Crédito (tipo 34).

Opcionales: razon_modificacion (máx. 90), indicador_nota_credito (se calcula si no lo envías), datos del comprador (recomendado: los mismos del original), totales de retención/percepción, fecha_limite_pago.

No aplican (se ignoran): fecha_vencimiento, termino_pago, formas_pago (el E34 no lleva tabla de formas de pago), y en el emisor municipio_emisor, provincia_emisor, correo_emisor, website_emisor y el nombre comercial.

Totales

Los montos son lo que se acredita, en positivo, calculados igual que en E31.

Particularidades

IndicadorNotaCredito automático

Si no envías indicador_nota_credito, el API lo calcula comparando fecha_emision con fecha_ncf_modificado: 0 si hay 30 días o menos, 1 si hay más de 30. En el ejemplo 2 (2026-10-02 → 2026-11-20, 49 días) sale 1.

Espera a que el original esté aceptado

Antes de enviar la nota de crédito a la DGII, el sistema busca el comprobante original (mismo RNC, mismo ambiente) en este sistema:

Situación del original Qué pasa con la nota de crédito
Aceptado, Aceptado Condicional o Recibido Se envía. (Recibido no es estado final del original —ver estados—, pero basta para enviar la nota.)
Todavía en curso (pendiente, enviado, En Proceso…) Se queda en pendiente con el mensaje Esperando que DGII acepte el documento original ... y se reintenta.
Rechazado o fallido fallido: El documento original ... no ha sido aceptado por DGII.
No existe en este sistema fallido: El documento original ... no existe en el sistema.
ncf_modificado empieza por B01 o B02 (NCF no electrónico) Se envía sin verificar.

Por eso puedes anular una venta segundos después de emitirla: la nota espera al original. Una nota de crédito sobre un e-CF que no se emitió por este sistema termina en fallido.

Ejemplo 1: anulación total de E310000000001

{
  "factura": {
    "tipo_ecf": "34",
    "encf": "E340000000001",
    "fecha_emision": "2026-10-06",
    "indicador_monto_gravado": 0,
    "tipo_ingresos": "01",
    "tipo_pago": "1",
    "direccion_emisor": "Av. Winston Churchill 1099, Santo Domingo",
    "rnc_comprador": "131000001",
    "razon_social_comprador": "CLIENTE EJEMPLO SRL",
    "ncf_modificado": "E310000000001",
    "fecha_ncf_modificado": "2026-10-01",
    "codigo_modificacion": "1",
    "razon_modificacion": "Anulacion total de la factura",
    "monto_gravado_total": 16700.00,
    "monto_gravado_i1": 16700.00,
    "total_itbis": 3006.00,
    "total_itbis1": 3006.00,
    "monto_total": 19706.00,
    "valor_pagar": 19706.00
  },
  "detalle": [
    {
      "numero_linea": 1,
      "nombre_item": "Servicio de consultoria",
      "indicador_bien_servicio": 2,
      "indicador_facturacion": 1,
      "cantidad": 10,
      "unidad_medida": "19",
      "precio_unitario": 1500.00,
      "monto_item": 15000.00
    },
    {
      "numero_linea": 2,
      "nombre_item": "Memoria USB 64GB",
      "indicador_bien_servicio": 1,
      "indicador_facturacion": 1,
      "cantidad": 2,
      "unidad_medida": "43",
      "precio_unitario": 850.00,
      "monto_item": 1700.00
    }
  ]
}

Ejemplo 2: devolución parcial de E310000000002, después de 30 días

{
  "factura": {
    "tipo_ecf": "34",
    "encf": "E340000000002",
    "fecha_emision": "2026-11-20",
    "indicador_monto_gravado": 0,
    "tipo_ingresos": "01",
    "tipo_pago": "1",
    "direccion_emisor": "Av. Winston Churchill 1099, Santo Domingo",
    "rnc_comprador": "131000001",
    "razon_social_comprador": "CLIENTE EJEMPLO SRL",
    "ncf_modificado": "E310000000002",
    "fecha_ncf_modificado": "2026-10-02",
    "codigo_modificacion": "3",
    "razon_modificacion": "Devolucion de 1 laptop",
    "monto_gravado_total": 33250.00,
    "monto_gravado_i1": 33250.00,
    "total_itbis": 5985.00,
    "total_itbis1": 5985.00,
    "monto_total": 39235.00,
    "valor_pagar": 39235.00
  },
  "detalle": [
    {
      "numero_linea": 1,
      "nombre_item": "Devolucion Laptop 14 pulgadas",
      "indicador_bien_servicio": 1,
      "indicador_facturacion": 1,
      "cantidad": 1,
      "unidad_medida": "43",
      "precio_unitario": 35000.00,
      "descuento": 1750.00,
      "monto_item": 33250.00
    }
  ]
}

Respuesta esperada

201 como en el README. El estado queda en pendiente hasta que el original esté aceptado; luego Aceptado.