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 de e-CF de la secuencia. Hay una sola por tipo.

Opciones disponibles:
31,
32,
33,
34,
41,
43,
44,
45,
46,
47
Ejemplo:

31

rangeFrom
integer
requerido

Primer número del rango autorizado. El primer e-CF de este tipo usará este número.

Rango requerido: 1 <= x <= 2147483647
Ejemplo:

1

rangeTo
integer
requerido

Último número del rango autorizado. Igual o mayor que rangeFrom.

Rango requerido: 1 <= x <= 2147483647
Ejemplo:

1000

expiresAt
string<date>

Vencimiento que autorizó la DGII (YYYY-MM-DD). Obligatorio salvo en los e-CF 32 y 34. Se puede emitir hasta el final de ese día, hora de República Dominicana.

Ejemplo:

"2027-12-31"

Respuesta

Secuencia registrada.

ecfType
integer
requerido

Tipo de e-CF de la secuencia (31, 32, 33, 34, 41, ...).

Ejemplo:

31

prefix
string
requerido

Prefijo del e-NCF.

Ejemplo:

"E31"

rangeFrom
integer
requerido

Primer número del rango autorizado.

Ejemplo:

1

rangeTo
integer
requerido

Último número del rango autorizado.

Ejemplo:

1000

nextNumber
integer
requerido

Número que tomará el próximo e-CF de este tipo.

Ejemplo:

58

remaining
integer
requerido

Números disponibles en el rango.

Ejemplo:

943

expiresAt
string<date-time> | null
requerido

Día de vencimiento del rango, a medianoche UTC: se puede emitir hasta el final de ese día en hora de República Dominicana. null si no vence (e-CF 32 y 34).

Ejemplo:

"2027-12-31T00:00:00.000Z"

active
boolean
requerido

Si la secuencia está activa.

Ejemplo:

true

usable
boolean
requerido

Si se puede emitir con ella ahora: activa, no vencida y con números disponibles.

Ejemplo:

true