---
title: "Documentación API"
description: "API REST, webhooks por evento y referencia de e-CF para integrar facturación electrónica DGII en República Dominicana."
canonical: https://factura.com.do/desarrolladores
lang: es
generator: factura.com.do docs-index
---

Documentación API 

#  Construye tu integración con la API V1 de factura.com.do 

Una API REST, 28 eventos webhook y referencia honesta de qué publicamos hoy y qué todavía no. Todo lo que tu equipo necesita para conectar a la facturación electrónica DGII en República Dominicana.

[ Empezar ahora ](/desarrolladores/quickstart) [ Ver autenticación ](/desarrolladores/autenticacion) 

- Header X-Api-Key
- 28 eventos webhook
- Entorno de pruebas DGII por empresa

## De cero a primer e-CF en tres llamadas

1. 01  
**Obtén tu X-Api-Key**  
Un administrador del espacio de trabajo genera la llave desde la app. La copia se ve solo una vez; guárdala en tu gestor de secretos.
2. 02  
**POST /api/v1/consumer-invoices**  
Manda el comprobante con header X-Api-Key. La respuesta trae DocumentId y ConsultationUrl listos para tu ERP.
3. 03  
**Suscribe el webhook dgii.aprobado**  
Cuando la DGII responde, te enviamos un POST con el evento y el payload. Tu sistema concilia y libera el flujo a cobranza.

## Todo lo que documenta esta sección

Cada tarjeta abre la página con detalle: contratos, ejemplos en curl y TypeScript, y notas honestas sobre qué hay y qué no.

- [ **Facturas E31, E32 y casos especiales** Crédito fiscal, consumo, regímenes especiales, gubernamental, exportación y pagos al exterior. ](/desarrolladores/facturas)
- [ **Notas de crédito (E34)** Anulaciones y correcciones referenciando el comprobante original. ](/desarrolladores/notas-credito)
- [ **Notas de débito (E33)** Cargos adicionales sobre comprobantes existentes. ](/desarrolladores/notas-debito)
- [ **Compras (E41)** Registro de comprobantes de compra a proveedores informales no registrados en la DGII. ](/desarrolladores/compras)
- [ **Gastos menores (E43)** Registro, anulación y corrección de monto. ](/desarrolladores/gastos)
- [ **Contactos** Clientes y proveedores con CRUD completo. ](/desarrolladores/contactos)
- [ **Catálogo y datos maestros** Productos, impuestos, retenciones, unidades, monedas y validación de RNC. ](/desarrolladores/catalogo)
- [ **Webhooks** 28 eventos, payload estándar y autenticación BYO-headers. ](/desarrolladores/webhooks)
- [ **Servidor MCP** Conecta Claude u otra IA con OAuth 2.1 y permisos por área. ](/desarrolladores/ciclo-ecf)
- [ **Ciclo del e-CF** De POST a la API V1 al acuse final de la DGII. ](/)

## Lo que publicamos hoy y lo que todavía no

Esta sección documenta lo que ya está vivo en /api/v1/. Mantenemos el otro lado de la tabla porque la honestidad evita sorpresas en producción.

| Hoy NO publicamos                                              | Hoy en /api/v1/                                                   |
| -------------------------------------------------------------- | ----------------------------------------------------------------- |
| Self-serve API key issuance vía endpoint público.              | Header X-Api-Key con vigencia configurable.                       |
| SDK oficial con runtime client distribuido en npm.             | REST con JSON: cualquier cliente HTTP la consume.                 |
| Verificación HMAC ni firma del payload.                        | 28 eventos webhook por suscripción manual.                        |
| Reintentos automáticos del lado del servidor para webhooks.    | Envío a la DGII y consulta periódica del estado en segundo plano. |
| Entorno de pruebas público con base URL distinta.              | Entorno de pruebas DGII por empresa (testecf).                    |
| Header de versión ni política formal de deprecación publicada. | Versionado /api/v1/ explícito.                                    |
| Header Idempotency-Key ni rate limit publicado.                | Paginación pageNumber/pageSize/search.                            |

Siguiente paso 

## Continúa por aquí

- [  Autenticación Cómo se autentica una llamada y qué responder ante un 401. ](/desarrolladores/autenticacion)
- [  Quickstart De cero a primer e-CF firmado en cinco minutos. ](/desarrolladores/quickstart)
- [  Webhooks Suscríbete a los 28 eventos disponibles. ](/desarrolladores/webhooks)
- [  Errores Forma del envelope, códigos HTTP y troubleshooting. ](/desarrolladores/errores)