# AC-PAY Desarrolladores - [API de facturación electrónica](https://ac-core.mintlify.app/index.md): Emite y consulta comprobantes fiscales electrónicos (e-CF) ante la DGII de República Dominicana con una sola API REST. - [Inicio rápido](https://ac-core.mintlify.app/guias/inicio-rapido.md): Tu primera factura electrónica en el sandbox, en cinco pasos. - [Integrar con un asistente de IA](https://ac-core.mintlify.app/guias/integrar-con-ia.md): Toda la documentación en Markdown para que tu asistente de código (Claude, ChatGPT, Cursor, Copilot) integre el API sin adivinar. - [Estados de un e-CF](https://ac-core.mintlify.app/guias/estados.md): Qué significa cada estado de un e-CF ante la DGII y qué hacer en cada caso. - [Idempotencia](https://ac-core.mintlify.app/guias/idempotencia.md): Cómo reintentar una solicitud sin emitir dos comprobantes. - [Webhooks](https://ac-core.mintlify.app/guias/webhooks.md): Recibe los cambios de estado de tus e-CF y verifica cada entrega. - [Errores y límites](https://ac-core.mintlify.app/guias/errores-y-limites.md): Forma de los errores, códigos, reintentos y límites mensuales. - [Pasar a producción](https://ac-core.mintlify.app/guias/pasar-a-produccion.md): Lista de verificación antes de cambiar a tu llave de producción. - [Listar e-CF de venta](https://ac-core.mintlify.app/api-reference/facturas-electrónicas-e-cf/listar-e-cf-de-venta.md): Devuelve, paginados, los e-CF de venta de tu comercio. Filtra por estado, tipo, rango de fecha de emisión (inclusive) o comprador. - [Emitir un e-CF de venta](https://ac-core.mintlify.app/api-reference/facturas-electrónicas-e-cf/emitir-un-e-cf-de-venta.md): 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}`. - [Consultar un e-CF](https://ac-core.mintlify.app/api-reference/facturas-electrónicas-e-cf/consultar-un-e-cf.md): Devuelve el documento y su estado ante la DGII. Si está `pending`, la consulta actualiza el estado. - [Anular un e-CF](https://ac-core.mintlify.app/api-reference/facturas-electrónicas-e-cf/anular-un-e-cf.md): Anula ante la DGII un e-CF aceptado. No lleva cuerpo. Devuelve el documento con `status: cancelled`. - [Reintentar el envío de un e-CF](https://ac-core.mintlify.app/api-reference/facturas-electrónicas-e-cf/reintentar-el-envío-de-un-e-cf.md): Reenvía a la DGII, con el mismo e-NCF, un e-CF cuyo envío falló (`status: error`). Úsalo en vez de emitir uno nuevo para no dejar huecos en tu secuencia. Un e-CF `rejected` no se reintenta: corrige los datos y emite otro. No lleva cuerpo. - [Descargar la representación impresa (PDF)](https://ac-core.mintlify.app/api-reference/facturas-electrónicas-e-cf/descargar-la-representación-impresa-pdf.md): Archivo `.pdf` como adjunto. - [Descargar el XML firmado](https://ac-core.mintlify.app/api-reference/facturas-electrónicas-e-cf/descargar-el-xml-firmado.md): XML del e-CF tal como se envió a la DGII, como adjunto `.xml`. - [Emitir una nota de crédito (E34)](https://ac-core.mintlify.app/api-reference/notas-de-crédito-y-débito/emitir-una-nota-de-crédito-e34.md): Emite una nota de crédito que modifica la factura `{id}` (descuentos, devoluciones o anulación). Se emite por líneas (`items`) o por monto (`amount`), no con ambos. La respuesta suele llegar con `status: pending`; el estado se actualiza solo: recíbelo con un webhook o consúltalo con `GET /v1/notes/{… - [Emitir una nota de débito (E33)](https://ac-core.mintlify.app/api-reference/notas-de-crédito-y-débito/emitir-una-nota-de-débito-e33.md): Emite una nota de débito que modifica la factura `{id}` (cargos o intereses no facturados). Se emite por líneas (`items`) o por monto (`amount`), no con ambos. La respuesta suele llegar con `status: pending`; el estado se actualiza solo: recíbelo con un webhook o consúltalo con `GET /v1/notes/{id}`. - [Listar las notas de una factura](https://ac-core.mintlify.app/api-reference/notas-de-crédito-y-débito/listar-las-notas-de-una-factura.md): Notas de crédito y débito que modifican la factura `{id}`, de la más reciente a la más antigua. - [Consultar una nota](https://ac-core.mintlify.app/api-reference/notas-de-crédito-y-débito/consultar-una-nota.md): Devuelve la nota y su estado ante la DGII. Si está `pending`, la consulta actualiza el estado. - [Reintentar el envío de una nota](https://ac-core.mintlify.app/api-reference/notas-de-crédito-y-débito/reintentar-el-envío-de-una-nota.md): Reenvía a la DGII, con el mismo e-NCF, una nota cuyo envío falló (`status: error`). Una nota `rejected` no se reintenta: corrige los datos y emite otra. No lleva cuerpo. - [Descargar el XML firmado de una nota](https://ac-core.mintlify.app/api-reference/notas-de-crédito-y-débito/descargar-el-xml-firmado-de-una-nota.md): XML de la nota tal como se envió a la DGII, como adjunto `.xml`. - [Emitir un comprobante especial](https://ac-core.mintlify.app/api-reference/comprobantes-especiales/emitir-un-comprobante-especial.md): 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/specia… - [Consultar un comprobante especial](https://ac-core.mintlify.app/api-reference/comprobantes-especiales/consultar-un-comprobante-especial.md): Devuelve el comprobante y su estado ante la DGII. Si está `pending`, la consulta actualiza el estado. - [Reintentar el envío de un comprobante especial](https://ac-core.mintlify.app/api-reference/comprobantes-especiales/reintentar-el-envío-de-un-comprobante-especial.md): Reenvía a la DGII, con el mismo e-NCF, un comprobante cuyo envío falló (`status: error`). Uno `rejected` no se reintenta: corrige los datos y emite otro. No lleva cuerpo. - [Descargar el XML firmado de un comprobante especial](https://ac-core.mintlify.app/api-reference/comprobantes-especiales/descargar-el-xml-firmado-de-un-comprobante-especial.md): XML del comprobante tal como se envió a la DGII, como adjunto `.xml`. - [Listar las secuencias de e-NCF](https://ac-core.mintlify.app/api-reference/secuencias/listar-las-secuencias-de-e-ncf.md): Rangos de e-NCF autorizados a tu comercio por tipo de e-CF, con el próximo número, los disponibles y su vencimiento. Revisa `usable` antes de emitir un tipo. - [Consultar los límites mensuales de emisión](https://ac-core.mintlify.app/api-reference/límites/consultar-los-límites-mensuales-de-emisión.md): Límite mensual de cada tipo de e-CF, lo emitido en el mes en curso y lo que queda disponible. Solo aparecen los tipos con límite; un tipo que no aparece no tiene límite. En el ambiente de pruebas `enforced` es `false`: los límites no se aplican. - [Listar los webhooks](https://ac-core.mintlify.app/api-reference/webhooks/listar-los-webhooks.md): Webhooks registrados por tu comercio (sin su secreto). - [Registrar un webhook](https://ac-core.mintlify.app/api-reference/webhooks/registrar-un-webhook.md): Registra una URL HTTPS que recibirá los eventos indicados. La respuesta incluye `secret`, con el que verificas la firma `X-Acpay-Signature` de cada evento: **solo se devuelve aquí**, guárdalo de inmediato. Ver "Cómo recibir y verificar los eventos" en esta sección. - [Consultar un webhook](https://ac-core.mintlify.app/api-reference/webhooks/consultar-un-webhook.md): Devuelve el webhook (sin su secreto) y sus entregas más recientes, con el estado y los intentos de cada una. - [Borrar un webhook](https://ac-core.mintlify.app/api-reference/webhooks/borrar-un-webhook.md): Borra el webhook: deja de recibir eventos, incluidos los reintentos pendientes. Responde `204` sin cuerpo. Para dejar de recibir eventos temporalmente, usa `PATCH` con `active: false`. - [Modificar un webhook](https://ac-core.mintlify.app/api-reference/webhooks/modificar-un-webhook.md): Cambia la URL, los eventos o si está activo (`active: false` lo pausa sin borrarlo). Solo se modifican los campos enviados; envía al menos uno. No exige `Idempotency-Key`: repetir la misma solicitud deja el webhook igual. El secreto no cambia. - [Enviar un evento de prueba](https://ac-core.mintlify.app/api-reference/webhooks/enviar-un-evento-de-prueba.md): Envía ahora a la URL del webhook un evento `test` (`data: { "message": "..." }`), firmado igual que los reales, y devuelve si tu endpoint respondió `2xx`. Úsalo para probar tu verificación de firma. No lleva cuerpo. - [Estado del servicio](https://ac-core.mintlify.app/api-reference/estado/estado-del-servicio.md): No requiere autenticación. - [Novedades](https://ac-core.mintlify.app/novedades.md): Cambios del API de facturación electrónica y de este portal. ## OpenAPI Specs - [ecf](/api-reference/ecf.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.