Checklist de go-live e-CF en República Dominicana: de staging a producción DGII

Por Ing. Carlos Méndez | 7 de septiembre de 2026

Ing. Carlos Méndez es arquitecto de software con más de 10 años integrando sistemas fiscales en América Latina. Ha liderado implementaciones de facturación electrónica en Colombia, México y Centroamérica para ISVs de mediana y gran escala.

La integración funciona en staging. Los casos de prueba DGII pasan. El equipo está listo para publicar en producción. Pero entre 'funciona en QA' y 'listo para producción' hay una brecha real: certificados distintos, credenciales distintas, secuencias distintas, y un conjunto de condiciones de producción que staging no replica. Un go-live mal ejecutado puede resultar en e-CF enviados con credenciales incorrectas, secuencias duplicadas o documentos rechazados masivamente en el primer día de operación.

Este checklist cubre las 35 verificaciones críticas organizadas en cinco áreas: certificados y autenticación, configuración de producción, pruebas pre-lanzamiento, monitoreo post-lanzamiento, y plan de contingencia. Cada área incluye el criterio de aceptación específico que debe cumplirse antes del go-live.

Área 1 — Certificados digitales y autenticación

✔ El certificado digital de producción está instalado en el servidor y es accesible por el proceso de firma. Verificar que la clave privada tiene los permisos correctos (solo lectura para el usuario del proceso, sin escritura pública). ✔ La fecha de vencimiento del certificado es mayor a 18 meses desde la fecha de go-live. Si es menor, planificar la renovación inmediatamente. ✔ El RNC en el certificado de producción coincide exactamente con el RNCEmisor que aparecerá en todos los e-CF. ✔ Las credenciales OAuth2 de producción (client_id y client_secret) están almacenadas en el gestor de secretos de producción, no en archivos de configuración versionados. ✔ El sistema obtuvo exitosamente un access_token de producción usando las credenciales reales, verificado con una llamada de prueba al endpoint de producción.

Área 2 — Configuración del sistema de producción

✔ El endpoint de transmisión está configurado como ecf.dgii.gov.do (producción), no ecfqa.dgii.gov.do (QA). Verificar con una variable de entorno explícita (DGII_ENVIRONMENT=production). ✔ Las secuencias eNCF de producción autorizadas por la DGII están configuradas correctamente en el sistema. El contador de secuencia comienza desde 1 (E310000000001 para tipo 31) o desde el primer número autorizado si la secuencia no empieza en 1. ✔ El mecanismo de control de secuencia es atómico: usa una transacción de base de datos o un lock distribuido para garantizar que dos solicitudes concurrentes no obtengan el mismo número de eNCF. ✔ Los RNC de prueba usados en staging han sido eliminados de cualquier lista de RNC válidos en producción. ✔ El sistema de logging de producción captura: timestamp, eNCF, código de rastreo DGII, estado y latencia de cada transmisión, con retención mínima de 5 años para cumplimiento fiscal.

Área 3 — Pruebas pre-lanzamiento en producción

✔ Se emitió al menos 1 e-CF tipo 31 real en producción con una transacción de valor mínimo y se verificó que la DGII lo aceptó con estado definitivo. Este e-CF debe ser declarado y no debe anularse a menos que haya un motivo fiscal válido. ✔ Se probó el flujo de nota de crédito tipo 34 en producción referenciando el e-CF de prueba, si el go-live lo requiere. ✔ El timeout del cliente HTTP hacia la DGII está configurado entre 30 y 60 segundos (no menos, para no generar timeouts prematuros en respuestas lentas de la DGII). ✔ El flujo de polling de estado funciona correctamente en producción: se probó forzando un estado pendiente y verificando que el worker consulta y actualiza el estado en la base de datos. ✔ La renovación automática del token OAuth2 funciona en producción: se verificó que el sistema renueva el token antes de que expire sin interrumpir transmisiones en curso.

Área 4 — Homologación y habilitación DGII

✔ La DGII emitió la aprobación formal de homologación por escrito. No asumir que los casos de prueba pasados en QA implican aprobación; la DGII emite un documento formal que debe conservarse. ✔ El RNC del emisor está habilitado como contribuyente electrónico en el portal DGII. Verificable en el padrón de contribuyentes electrónicos público de la DGII. ✔ Las secuencias eNCF de producción han sido solicitadas y aprobadas por la DGII para cada tipo de e-CF que el sistema emitirá. ✔ El equipo de soporte del ISV conoce el proceso de reporte de incidentes a la DGII y tiene el contacto del área técnica de la DGII.

Área 5 — Monitoreo y plan de contingencia post-lanzamiento

✔ Existe un dashboard de monitoreo en tiempo real que muestra: tasa de éxito de transmisión (objetivo: >99%), latencia p95 de respuesta DGII, documentos en estado pendiente por más de 5 minutos, y errores por tipo. ✔ Hay alertas configuradas para: tasa de rechazo mayor al 1% en una ventana de 15 minutos, más de 5 documentos en estado pendiente por más de 10 minutos, y cualquier error HTTP 5xx de la DGII. ✔ Existe un plan de contingencia documentado para el escenario de caida de la API DGII: modo de factura en contingencia (emisión sin validación real-time con transmisión diferida), con los pasos exactos para activarlo y desactivarlo. ✔ El equipo de soporte de primer nivel tiene documentado el catálogo de errores DGII más frecuentes con el diagnóstico y solución para cada uno. ✔ Se realizó una sesión de war-game donde el equipo simuló un rechazo masivo de e-CF en producción y verificó que el proceso de detección, escalamiento y corrección funciona correctamente.

Criterio de go/no-go: cómo tomar la decisión

El go-live solo debe ejecutarse si todas las verificaciones de las Áreas 1 a 4 están completas. El Área 5 puede tener hasta 2 items pendientes en el momento del go-live si existe un plan escrito de completarlos dentro de las 48 horas siguientes. No hacer go-live si: el certificado de producción no está instalado, las secuencias eNCF no están autorizadas, el primer e-CF de prueba en producción fue rechazado, o la aprobación de homologación de la DGII no fue recibida.

El go-live de e-CF en producción tiene implicaciones fiscales inmediatas: el primer e-CF emitido con el RNC real es un documento tributario válido. A diferencia de staging, no hay forma de 'borrar' documentos emitidos en producción. Cada e-CF emitido por error requiere una nota de crédito y genera un registro fiscal permanente en la DGII.

Preguntas frecuentes

¿Cuánto tiempo antes del go-live debo solicitar las secuencias eNCF de producción a la DGII?

Las secuencias eNCF de producción se solicitan una vez que la DGII aprueba la homologación. El tiempo de asignación varía, pero en general la DGII las proporciona dentro de los 5 a 10 días hábiles posteriores a la aprobación. Incluir esta gestión en el cronograma de go-live y no asumir que las secuencias estarán disponibles el mismo día que se soliciten.

¿Cómo puedo hacer una prueba de transmisión en producción sin impacto fiscal real?

No existe un modo 'sandbox' dentro del ambiente de producción DGII. Cualquier e-CF transmitido al endpoint de producción con un RNC real es un documento fiscal válido. La práctica recomendada es realizar la primera transmisión de producción con una factura real de valor mínimo entre el ISV y el emisor (si el ISV es persona jurídica), o con el primer cliente real del da. Esta factura debe ser declarada normalmente.

¿Qué diferencia hay entre la homologación DGII y estar listo para go-live?

La homologación DGII valida que el sistema del ISV genera y transmite e-CF correctamente en el ambiente de pruebas. Estar listo para go-live requiere adicionalmente: certificado de producción instalado, secuencias de producción asignadas, credenciales de producción configuradas, monitoreo operativo activo, y plan de contingencia documentado. La homologación aprobada es condición necesaria pero no suficiente para el go-live.

¿Es posible revertir el go-live si la integración tiene problemas en las primeras horas de producción?

No existe un mecanismo de rollback para e-CF en producción. Los documentos ya aceptados por la DGII son permanentes. Si se detecta un problema grave en las primeras horas, el curso de acción es: detener la emisión de nuevos e-CF, diagnosticar y corregir el problema, y reanudar la emisión con el error corregido. Los e-CF emitidos durante el período de error deben ser evaluados individualmente para determinar si requieren notas de crédito correctivas.

Sobre el autor

Ing. Carlos Méndez es arquitecto de software con más de 10 años integrando sistemas fiscales en América Latina. Ha liderado implementaciones de facturación electrónica en Colombia, México y Centroamérica para ISVs de mediana y gran escala.