Saltar al contenido principal
POST
Anular un e-CF

Autorizaciones

Authorization
string
header
requerido

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

Encabezados

Idempotency-Key
string
requerido

Identificador único que generas por operación (p. ej. un UUID), de 1 a 255 caracteres ASCII imprimibles. Si repites la solicitud con la misma llave en las siguientes 24 h recibes la respuesta original (con Idempotent-Replayed: true) sin ejecutarla de nuevo.

Ejemplo:

"5b0f7c1e-2f7a-4d8e-9d3c-7f1e2a9b4c60"

Parámetros de ruta

id
string<uuid>
requerido

Identificador del documento (UUID).

Ejemplo:

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

Cuerpo

application/json

Sin cuerpo. Cualquier propiedad enviada se rechaza con 400.

The body is of type object.

Respuesta

Documento anulado.

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 asignado. null mientras no se haya asignado.

Ejemplo:

"E310000000001"

ecfType
enum<number>
requerido
Opciones disponibles:
31,
32,
44,
45
Ejemplo:

31

buyer
object | null
requerido
paymentType
enum<string>
requerido
Opciones disponibles:
cash,
credit
Ejemplo:

"credit"

dueDate
string<date> | null
requerido
Ejemplo:

"2026-10-31"

items
object[]
requerido