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.
- Header X-Api-Key
- 28 eventos webhook
- Entorno de pruebas DGII por empresa
De cero a primer e-CF en tres llamadas
- 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.
- 02 POST /api/v1/consumer-invoices
Manda el comprobante con header X-Api-Key. La respuesta trae DocumentId y ConsultationUrl listos para tu ERP.
- 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.
- Notas de crédito (E34)
Anulaciones y correcciones referenciando el comprobante original.
- Notas de débito (E33)
Cargos adicionales sobre comprobantes existentes.
- Compras (E41)
Registro de comprobantes de compra a proveedores informales no registrados en la DGII.
- Gastos menores (E43)
Registro, anulación y corrección de monto.
- Contactos
Clientes y proveedores con CRUD completo.
- Catálogo y datos maestros
Productos, impuestos, retenciones, unidades, monedas y validación de RNC.
- Webhooks
28 eventos, payload estándar y autenticación BYO-headers.
- Servidor MCP
Conecta Claude u otra IA con OAuth 2.1 y permisos por área.
- 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. |