Anular un e-CF

Anular un e-CF

curl --request POST \
  --url https://e-cf.acpay.do/sandbox/v1/invoices/{id}/void \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '{}'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({})
};

fetch('https://e-cf.acpay.do/sandbox/v1/invoices/{id}/void', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://e-cf.acpay.do/sandbox/v1/invoices/{id}/void"

payload = {}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://e-cf.acpay.do/sandbox/v1/invoices/{id}/void",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

using RestSharp;


var options = new RestClientOptions("https://e-cf.acpay.do/sandbox/v1/invoices/{id}/void");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Idempotency-Key", "<idempotency-key>");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "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
    }
  ]
}

{
  "error": {
    "status": 400,
    "message": "La solicitud no es válida.",
    "details": [
      "items.0.quantity: debe ser un número entero.",
      "dueDate: es obligatoria cuando paymentType es credit."
    ]
  }
}

{
  "error": {
    "status": 401,
    "message": "Esta llave pertenece a otro ambiente."
  }
}

{
  "error": {
    "status": 403,
    "message": "La llave no tiene permiso para esta operación."
  }
}

{
  "error": {
    "status": 404,
    "message": "Documento no encontrado."
  }
}

{
  "error": {
    "status": 409,
    "message": "Hay una solicitud en curso con esta Idempotency-Key."
  }
}

{
  "error": {
    "status": 422,
    "message": "Esta Idempotency-Key ya se usó con otra solicitud."
  }
}

{
  "error": {
    "status": 429,
    "message": "Demasiadas solicitudes. Intenta de nuevo más tarde."
  }
}

{
  "error": {
    "status": 502,
    "message": "El servicio de facturación electrónica tuvo un error inesperado. Intenta de nuevo más tarde."
  }
}

{
  "error": {
    "status": 503,
    "message": "El servicio de facturación electrónica no está disponible. Intenta de nuevo en unos minutos."
  }
}

POST

invoices

{id}

void

Anular un e-CF

curl --request POST \
  --url https://e-cf.acpay.do/sandbox/v1/invoices/{id}/void \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '{}'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({})
};

fetch('https://e-cf.acpay.do/sandbox/v1/invoices/{id}/void', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://e-cf.acpay.do/sandbox/v1/invoices/{id}/void"

payload = {}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://e-cf.acpay.do/sandbox/v1/invoices/{id}/void",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

using RestSharp;


var options = new RestClientOptions("https://e-cf.acpay.do/sandbox/v1/invoices/{id}/void");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Idempotency-Key", "<idempotency-key>");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "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
    }
  ]
}

{
  "error": {
    "status": 400,
    "message": "La solicitud no es válida.",
    "details": [
      "items.0.quantity: debe ser un número entero.",
      "dueDate: es obligatoria cuando paymentType es credit."
    ]
  }
}

{
  "error": {
    "status": 401,
    "message": "Esta llave pertenece a otro ambiente."
  }
}

{
  "error": {
    "status": 403,
    "message": "La llave no tiene permiso para esta operación."
  }
}

{
  "error": {
    "status": 404,
    "message": "Documento no encontrado."
  }
}

{
  "error": {
    "status": 409,
    "message": "Hay una solicitud en curso con esta Idempotency-Key."
  }
}

{
  "error": {
    "status": 422,
    "message": "Esta Idempotency-Key ya se usó con otra solicitud."
  }
}

{
  "error": {
    "status": 429,
    "message": "Demasiadas solicitudes. Intenta de nuevo más tarde."
  }
}

{
  "error": {
    "status": 502,
    "message": "El servicio de facturación electrónica tuvo un error inesperado. Intenta de nuevo más tarde."
  }
}

{
  "error": {
    "status": 503,
    "message": "El servicio de facturación electrónica no está disponible. Intenta de nuevo en unos minutos."
  }
}

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

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.

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

Facturas electrónicas (e-CF)

Notas de crédito y débito

Comprobantes especiales

Secuencias

Límites

Webhooks

Estado

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta