FiscalFlow
FiscalFlow emite y recibe comprobantes fiscales electrónicos (e-CF) ante la DGII por ti. Tu sistema envía una factura como JSON; FiscalFlow arma el XML según el esquema de la DGII, lo firma con el certificado digital del contribuyente, lo transmite, y te devuelve el veredicto, el PDF fiscal con código QR y el XML firmado.
Hay dos formas de conectarte, y no se excluyen:
- API REST — para cualquier sistema propio. Es lo que documenta el resto de este portal.
- Conector de Odoo — un módulo que se instala en Odoo y emite al confirmar la factura, sin escribir código.
El modelo mental
Casi todos los problemas de integración salen de una sola idea mal entendida:
la DGII casi nunca responde en el momento. Cuando envías un e-CF, la DGII
acusa recibo con un trackId y resuelve después — segundos, a veces minutos.
El único canal que responde de inmediato es el de resumen B2C (RFCE), que aplica a las
facturas de consumo E32 por debajo de RD$250,000.
Por eso un documento nace en estado processing y no en accepted.
Tu integración tiene que estar preparada para eso desde el primer día: no bloquees la venta
esperando el veredicto, y no asumas que un 202 es un rechazo.
Ciclo de vida de un e-CF explica el ciclo completo
y las tres formas de enterarte del resultado.
Vocabulario
| Termino | Qué es |
|---|---|
| e-CF | El comprobante en sí: un XML firmado digitalmente que representa una transacción. Cada tipo tiene su propio esquema (E31 factura de crédito fiscal, E32 factura de consumo, E33 nota de débito, E34 nota de crédito, y el resto). |
| e-NCF | El número del comprobante: E + tipo + 10 dígitos, por ejemplo E310000000001. Sale de un rango que la DGII autoriza al contribuyente. Quien lo administra eres tú, no FiscalFlow. |
| trackId | El acuse que devuelve la DGII al recibir un envío. No es una aceptación: es el número con el que se consulta el veredicto después. |
| RNC | Registro Nacional de Contribuyentes. Nueve dígitos para empresas, once para personas físicas (cédula). FiscalFlow solo acepta esas dos longitudes. |
| ARECF | Acuse de recibo. Cuando llega un e-CF a tu buzón, FiscalFlow lo genera y firma automáticamente. |
| ACECF | Aprobación comercial. Es un paso distinto del ARECF y es decisión tuya: aceptas o rechazas el documento por motivos comerciales. Ver Recibir e-CF. |
| ANECF | Anulación. Deja sin efecto un e-CF ya aceptado. Ver Anular un e-CF. |
| RFCE | Resumen de factura de consumo electrónica. El canal síncrono para E32 por debajo del umbral. |
URL base
Todas las llamadas van al mismo host, en HTTPS:
https://api.fiscalflowsupport.comEl ambiente de la DGII no se elige con una URL distinta, sino con el prefijo de tu API key. Ver Autenticación.
Por dónde seguir
- Inicio rápido — emitir tu primer e-CF en pruebas, de principio a fin.
- Ciclo de vida de un e-CF — estados, trackId y cómo enterarte del veredicto.
- Emitir un e-CF — la referencia completa del payload.
- Errores y rechazos — qué significa cada mensaje de la DGII y qué hacer.
Las cuentas las crea el equipo de FiscalFlow: no hay registro público. Para solicitar acceso, escribe a [email protected].