Emitir un comprobante especial

Emite un e-CF 41 (compras a proveedores que no emiten comprobantes), 43 (gastos menores), 46 (exportaciones) o 47 (pagos al exterior), lo firma y lo envía a la DGII. La respuesta suele llegar con status: pending; el estado se actualiza solo: recíbelo con un webhook o consúltalo con GET /v1/special-documents/{id}.

Límite mensual: si alcanzaste el límite mensual de este tipo de e-CF responde 429 sin Retry-After (el 429 por exceso de solicitudes sí lo trae); consulta tu consumo con GET /v1/limits. Consultar, descargar y anular siguen funcionando, y reintentar un documento ya emitido no vuelve a contar. Ese 429 no se guarda: cuando se amplíe el límite puedes reintentar con la misma Idempotency-Key.

POST /v1/special-documents

cURL

compras

curl --request POST \
  --url https://e-cf.acpay.do/sandbox/v1/special-documents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "ecfType": 41,
  "description": "Compra de plátanos a productor informal",
  "total": 11800,
  "itbis": 1800,
  "counterparty": {
    "name": "Juan Pérez",
    "taxId": "00112345678"
  },
  "itbisWithheld": 1800,
  "isrWithheld": 200,
  "goodOrService": "good"
}
'

201

Example

{
  "id": "3f1c2b9e-8a4d-4f6e-9c1a-2b7d5e8f0a13",
  "status": "accepted",
  "statusMessage": null,
  "securityCode": "a1B2c3",
  "stampUrl": "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": "2026-09-27T14:15:00.000Z",
  "issuedAt": "2026-09-27T14:14:58.000Z",
  "environment": "test",
  "currency": "DOP",
  "subtotal": 3001,
  "itbis": 540.18,
  "total": 3541.18,
  "encf": "E410000000001",
  "ecfType": 41,
  "description": "Compra de plátanos a productor informal",
  "counterparty": {
    "name": "Juan Pérez",
    "taxId": "00112345678",
    "foreignId": null,
    "country": null
  },
  "isrWithheld": 0,
  "itbisWithheld": 0
}

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.

Show child attributes

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

201

application/json

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).

Show child attributes

isrWithheld · number · requerido

ISR retenido.

Ejemplo:

0

itbisWithheld · number · requerido

ITBIS retenido.

Ejemplo:

0