Saltar al contenido principal
POST

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"

Cuerpo

application/json
​
ecfType
enum<number>
requerido

Tipo: 41 compras, 43 gastos menores, 46 exportaciones, 47 pagos al exterior.

Opciones disponibles:
41,
43,
46,
47
Ejemplo:

41

​
description
string
requerido

Descripción del bien o servicio.

Maximum string length: 500
Ejemplo:

"Compra de plátanos a productor informal"

​
total
number
requerido

Total en RD$, con ITBIS (máximo 2 decimales).

Rango requerido: 0 < x <= 99999999.99
Ejemplo:

11800

​
itbis
number
predeterminado:0

ITBIS incluido en total (máximo 2 decimales, no mayor que total).

Rango requerido: 0 <= x <= 99999999.99
Ejemplo:

1800

​
counterparty
object

Contraparte. Obligatoria en 41 (con taxId), 46 y 47 (con foreignId y country); no se envía en 43.

​
isrWithheld
number

ISR retenido en RD$ (máximo 2 decimales). Solo en e-CF 41 y 47.

Rango requerido: 0 <= x <= 99999999.99
Ejemplo:

1000

​
itbisWithheld
number

ITBIS retenido en RD$ (máximo 2 decimales). Solo en e-CF 41.

Rango requerido: 0 <= x <= 99999999.99
Ejemplo:

1800

​
goodOrService
enum<string>

Si el comprobante ampara un bien o un servicio.

Opciones disponibles:
good,
service

Respuesta

Comprobante creado y enviado a la DGII.

​
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:

"E410000000001"

​
ecfType
enum<number>
requerido

41 compras, 43 gastos menores, 46 exportaciones, 47 pagos al exterior.

Opciones disponibles:
41,
43,
46,
47
Ejemplo:

41

​
description
string
requerido
Ejemplo:

"Compra de plátanos a productor informal"

​
counterparty
object | null
requerido

null en e-CF 43 (gastos menores).

​
isrWithheld
number
requerido

ISR retenido.

Ejemplo:

0

​
itbisWithheld
number
requerido

ITBIS retenido.

Ejemplo:

0