Saltar al contenido principal
Cada comprobante (factura, nota o comprobante especial) tiene un status que refleja su situación ante la DGII. AC-PAY lo actualiza solo, en segundo plano: no necesitas consultar en bucle.

​
El recorrido normal

  1. POST /v1/invoices responde 201 con status: pending.
  2. La DGII responde y el estado cambia a accepted, accepted_with_observations o rejected.
  3. Si registraste un webhook, recibes ecf.accepted o ecf.rejected con el nuevo estado.

​
Rechazado o con error: no es lo mismo

  • rejected es una decisión de la DGII sobre el contenido. Repetir el mismo comprobante no lo arregla: corrige los datos y emite uno nuevo.
  • error es un fallo del envío, no del contenido. POST /v1/invoices/{id}/retry (o /v1/notes/{id}/retry, /v1/special-documents/{id}/retry) lo reenvía con el mismo e-NCF, sin cuerpo.

​
Anular y corregir

  • Anular un e-CF aceptado: POST /v1/invoices/{id}/void, sin cuerpo. Recibes ecf.cancelled por webhook.
  • Corregir montos o textos de una factura ya aceptada: emite una nota de crédito (POST /v1/invoices/{id}/credit-notes, E34) o de débito (POST /v1/invoices/{id}/debit-notes, E33). Cada nota tiene su propio estado y su propio recorrido.
modificationCode de las notas: 1 anulación total, 2 corrige textos, 3 corrige montos, 4 reemplazo de un comprobante en contingencia. Se emiten por líneas (items) o por monto (amount con ITBIS y itbis opcional), nunca con ambos.

​
Tipos de e-CF