Emitir un e-CF de venta

Emite una factura electrónica (31, 32, 44 o 45), la firma y la envía a la DGII. La respuesta suele llegar con status: pending; el estado se actualiza solo hasta accepted, accepted_with_observations o rejected: recíbelo con un webhook o consúltalo con GET /v1/invoices/{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/invoices

cURL

creditoFiscal

curl --request POST \
  --url https://e-cf.acpay.do/sandbox/v1/invoices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "ecfType": 31,
  "buyer": {
    "taxId": "131793916",
    "name": "Distribuidora del Caribe SRL",
    "email": "[e-mail]"
  },
  "paymentType": "credit",
  "dueDate": "2026-10-31",
  "description": "Servicios de septiembre 2026",
  "items": [
    {
      "description": "Servicio de mantenimiento mensual",
      "quantity": 2,
      "unitPrice": 1500.5
    },
    {
      "description": "Libro de texto",
      "quantity": 1,
      "unitPrice": 850,
      "itbisRate": 0
    }
  ]
}
'

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": "E310000000001",
  "ecfType": 31,
  "buyer": {
    "taxId": "131793916",
    "name": "Distribuidora del Caribe SRL"
  },
  "paymentType": "credit",
  "dueDate": "2026-10-31",
  "items": [
    {
      "description": "Servicio de mantenimiento mensual",
      "quantity": 2,
      "unitPrice": 1500.5,
      "itbisRate": 18,
      "subtotal": 3001
    }
  ]
}

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: 31 crédito fiscal, 32 consumo, 44 regímenes especiales, 45 gubernamental.

Opciones disponibles: 31, 32, 44, 45

Ejemplo:

31

paymentType · enum<string> · requerido

Condición de pago.

Opciones disponibles: cash, credit

Ejemplo:

"credit"

items · object[] · requerido

Líneas de la factura (1 a 500).

Show child attributes

buyer · object

Comprador. Obligatorio salvo en e-CF 32 (consumo); en un 32 de RD$250,000 o más también lo exige la DGII.

Show child attributes

dueDate · string<date>

Fecha de vencimiento (YYYY-MM-DD). Obligatoria si paymentType es credit.

Ejemplo:

"2026-10-31"

description · string

Nota o descripción general de la factura.

Maximum string length: 500

Ejemplo:

"Servicios de septiembre 2026"

Respuesta

201

application/json

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

"E310000000001"

ecfType · enum<number> · requerido

Opciones disponibles: 31, 32, 44, 45

Ejemplo:

31

buyer · object | null · requerido

Show child attributes

paymentType · enum<string> · requerido

Opciones disponibles: cash, credit

Ejemplo:

"credit"

dueDate · string<date> | null · requerido

Ejemplo:

"2026-10-31"

items · object[] · requerido

Show child attributes