> ## Documentation Index
> Fetch the complete documentation index at: https://dev.acpay.do/llms.txt
> Use this file to discover all available pages before exploring further.

# API de facturación electrónica

> Emite y consulta comprobantes fiscales electrónicos (e-CF) ante la DGII de República Dominicana con una sola API REST.

Con el API de AC-PAY emites facturas, notas de crédito y débito y comprobantes especiales, y recibes su estado ante la DGII sin volverte proveedor certificado: lo eres a través de AC-PAY.

> [card] [Inicio rápido](https://dev.acpay.do/guias/inicio-rapido.md)
>
> Tu primera factura en el sandbox, en cinco pasos.

> [card] Referencia de la API
>
> En la pestaña **Referencia de la API**: cada endpoint con sus campos, ejemplos y un panel para probarlo con tu llave de prueba.

> [card] [Webhooks](https://dev.acpay.do/guias/webhooks.md)
>
> Recibe los cambios de estado y verifica cada entrega.

> [card] [Pasar a producción](https://dev.acpay.do/guias/pasar-a-produccion.md)
>
> La lista de verificación antes de usar tu llave live.

## Ambientes

| Ambiente | URL base | Llave | Comprobantes |
| - | - | - | - |
| Sandbox (pruebas) | `https://e-cf.acpay.do/sandbox/v1` | `acpay_test_...` | Van al ambiente de pruebas de la DGII, sin validez fiscal. |
| Producción | `https://e-cf.acpay.do/v1` | `acpay_live_...` | Van a la DGII, con validez fiscal. |

Una llave de un ambiente se rechaza en el otro con `401`.

## Lo esencial

* **Autenticación:** `Authorization: Bearer <llave>` en cada solicitud.
* **Idempotencia:** todo `POST` lleva `Idempotency-Key`. Repetir la misma solicitud con la misma llave no emite dos veces. Ver [Idempotencia](https://dev.acpay.do/guias/idempotencia.md).
* **Estados:** el estado ante la DGII se actualiza solo; recíbelo por [webhook](https://dev.acpay.do/guias/webhooks.md) en vez de consultar en bucle.
* **Errores:** siempre `{ "error": { "status", "message", "details" } }`. Ver [Errores y límites](https://dev.acpay.do/guias/errores-y-limites.md).
* **Trazabilidad:** cada respuesta trae `X-Request-Id`. Inclúyelo al reportar un problema.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.