Saltar al contenido principal
GET
Listar las notas de una factura

Autorizaciones

Authorization
string
header
requerido

Llave de API de AC-PAY del ambiente de esta URL.

Parámetros de ruta

id
string<uuid>
requerido

Identificador del documento (UUID).

Ejemplo:

"3f1c2b9e-8a4d-4f6e-9c1a-2b7d5e8f0a13"

Respuesta

id
string<uuid>
requerido
Ejemplo:

"3f1c2b9e-8a4d-4f6e-9c1a-2b7d5e8f0a13"

status
enum<string>
requerido

pending: enviado, esperando a la DGII (se actualiza solo en segundo plano, y también al consultar). accepted / accepted_with_observations: válido. rejected: la DGII lo rechazó (ver statusMessage). cancelled: anulado. error: no se pudo procesar (se puede reintentar).

Opciones disponibles:
pending,
accepted,
accepted_with_observations,
rejected,
cancelled,
error
Ejemplo:

"accepted"

statusMessage
string | null
requerido

Detalle del estado (motivo de rechazo u observaciones).

Ejemplo:

null

securityCode
string | null
requerido

Código de seguridad del e-CF (va impreso en la representación impresa).

Ejemplo:

"a1B2c3"

stampUrl
string | null
requerido

URL de consulta de la DGII (contenido del código QR).

Ejemplo:

"https://ecf.dgii.gov.do/testecf/ConsultaTimbre?RncEmisor=101000000&RncComprador=131793916&ENCF=E310000000001&FechaEmision=27-09-2026&MontoTotal=3541.18&FechaFirma=27-09-2026%2010:15:00&CodigoSeguridad=a1B2c3"

signedAt
string<date-time> | null
requerido
Ejemplo:

"2026-09-27T14:15:00.000Z"

issuedAt
string<date-time>
requerido
Ejemplo:

"2026-09-27T14:14:58.000Z"

environment
enum<string>
requerido
Opciones disponibles:
test,
live
Ejemplo:

"test"

currency
enum<string>
requerido
Opciones disponibles:
DOP
Ejemplo:

"DOP"

subtotal
number
requerido

Monto sin ITBIS.

Ejemplo:

3001

itbis
number
requerido

ITBIS total.

Ejemplo:

540.18

total
number
requerido

Total con ITBIS.

Ejemplo:

3541.18

encf
string | null
requerido

e-NCF de la nota. null mientras no se haya asignado.

Ejemplo:

"E340000000003"

ecfType
enum<number>
requerido

33 nota de débito, 34 nota de crédito.

Opciones disponibles:
33,
34
Ejemplo:

34

invoiceId
string<uuid>
requerido

Factura que modifica la nota.

Ejemplo:

"3f1c2b9e-8a4d-4f6e-9c1a-2b7d5e8f0a13"

invoiceEncf
string | null
requerido

e-NCF de la factura modificada.

Ejemplo:

"E310000000001"

modificationCode
enum<number>
requerido

1 anulación total, 2 corrige textos, 3 corrige montos, 4 reemplazo de un comprobante en contingencia.

Opciones disponibles:
1,
2,
3,
4
Ejemplo:

3

reason
string
requerido
Ejemplo:

"Devolución parcial de mercancía"

items
object[]
requerido