Cómo activar el sandbox de la DGII para pruebas de e-CF: guía paso a paso

Por Ing. Carlos Méndez | 18 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.

Sumario: El sandbox de la DGII para e-CF no es de acceso instantáneo: requiere solicitud formal y tarda entre 3 y 10 días hábiles en activarse. Las credenciales son distintas a las de producción. Algunos PSFEs ofrecen sandbox propio de acceso inmediato como alternativa para acelerar el desarrollo.

El primer día de desarrollo de una integración e-CF en República Dominicana, el arquitecto técnico busca el sandbox de la DGII esperando encontrar un portal con registro inmediato y credenciales instantáneas. Lo que encuentra es un proceso formal que requiere hasta 10 días hábiles. Para un ISV con fechas de entrega, esas dos semanas pueden ser críticas. Este artículo documenta el proceso correcto para solicitar el sandbox DGII, qué esperar en cada paso, y cómo avanzar en el desarrollo mientras el acceso está siendo procesado.

Al terminar de leer sabrás: el proceso de solicitud del sandbox DGII paso a paso, los tiempos reales de activación, las limitaciones del sandbox frente a producción, y las alternativas para iniciar el desarrollo antes de tener acceso al sandbox oficial.

Proceso de solicitud del sandbox DGII para e-CF

Paso 1: Requisitos previos

Antes de solicitar el sandbox, el ISV o el contribuyente debe tener: (1) RNC activo y vigente registrado en la DGII, (2) estar registrado en el Portal de Facturación Electrónica de la DGII con usuario y contraseña, (3) tener definido el tipo de integración (directa o a través de PSFE), ya que la solicitud de sandbox varía según la ruta. Los ISVs que desarrollan software para múltiples clientes pueden solicitar un RNC de pruebas dedicado para el equipo de desarrollo.

Paso 2: Solicitud formal en el Portal de la DGII

La solicitud se realiza en el portal ecf.dgii.gov.do, sección 'Habilitación de Contribuyente' o 'Ambiente de Pruebas'. Completar el formulario de solicitud con: RNC del contribuyente, datos de contacto del equipo técnico, tipo de software que se va a integrar, y nombre del ISV si aplica. La DGII envía confirmación por correo electrónico del recibo de la solicitud.

Paso 3: Período de validación (3-10 días hábiles)

La DGII revisa la solicitud manualmente. El tiempo de activación varía entre 3 y 10 días hábiles dependiendo del volumen de solicitudes y el tipo de contribuyente. Contribuyentes grandes (tipo de contribuyente A o B) tienden a tener tiempos de respuesta más rápidos. La DGII no ofrece un portal de seguimiento del estado de la solicitud: el ISV debe esperar la notificación por correo electrónico.

Paso 4: Recepción de credenciales del sandbox

Al ser aprobada, la DGII envía las credenciales del sandbox por correo electrónico al contacto técnico registrado. Las credenciales incluyen: token de autenticación para el ambiente de pruebas, URL del endpoint del sandbox (diferente al de producción), y en algunos casos un RNC de pruebas o rango de secuenciales para el sandbox. Las credenciales del sandbox NO son las mismas que las de producción y no son intercambiables.

Limitaciones del sandbox DGII vs. producción

El sandbox de la DGII tiene diferencias importantes respecto al ambiente de producción que el ISV debe conocer antes de planificar sus pruebas:

Sin validez fiscal: Los e-CF emitidos en sandbox no tienen efectos tributarios. No aparecen en el historial fiscal del contribuyente.

Diferencias de comportamiento: El sandbox puede tener mensajes de error con texto diferente al de producción, o puede omitir ciertos errores que sí aparecen en producción. Los ISVs reportan que algunos errores de validación de campos solo se manifiestan en producción.

Mayor latencia: El sandbox tiene recursos infraestructurales menores que producción. Los tiempos de respuesta en sandbox son generalmente más altos (2-8 segundos) y no representan los tiempos reales de producción en condiciones normales.

Disponibilidad no garantizada: El sandbox de la DGII puede estar inactivo sin previo aviso durante fines de semana o períodos de mantenimiento. No tiene los compromisos de disponibilidad del ambiente de producción.

Alternativas para avanzar mientras se espera el sandbox DGII

Mientras se espera la activación del sandbox DGII, el ISV puede avanzar en varias áreas sin necesitar acceso al entorno oficial:

1. Desarrollar y validar la generación del XML: El XSD oficial de la DGII está disponible públicamente. El ISV puede implementar la construcción del XML y validarlo contra el XSD localmente. Esto detecta el 60-70% de los errores de estructura antes de necesitar el sandbox.

2. Implementar y probar la firma digital: La firma XAdES-BES puede desarrollarse y probarse con certificados de prueba (auto-firmados o de CA de pruebas) sin acceso al sandbox. La verificación local de la firma valida que el proceso criptográfico es correcto.

3. Sandbox de PSFE autorizado: Algunos PSFEs autorizados por la DGII ofrecen su propio sandbox de acceso inmediato que simula el comportamiento del servicio de autorización. Esta alternativa permite avanzar en la lógica de procesamiento de respuestas, reintentos y contingencia sin esperar el sandbox oficial.

Checklist antes del primer envío al sandbox DGII

Antes de enviar el primer e-CF al sandbox de la DGII, verificar: (1) El XML pasa la validación contra el XSD de la DGII para el tipo de e-CF. (2) Los totales (MontoGravadoTotal, ITBIS, MontoTotal) cuadran matemáticamente con los ítems. (3) La firma XAdES-BES pasa la verificación local. (4) El XML está codificado en UTF-8 sin BOM. (5) El certificado digital es el correspondiente al RNC del emisor de pruebas. (6) El secuencial del e-CF está dentro del rango de pruebas asignado por la DGII. (7) El endpoint usado es el del sandbox, no el de producción.

Preguntas frecuentes sobre el sandbox DGII para e-CF

¿Cuánto tiempo tarda la DGII en activar el acceso al sandbox para pruebas de e-CF?

El proceso de activación del sandbox de la DGII toma entre 3 y 10 días hábiles desde la solicitud formal. El tiempo depende del volumen de solicitudes en la DGII y del tipo de contribuyente. Grandes contribuyentes con ejecutivo asignado en la DGII pueden tener tiempos más cortos. No hay portal de seguimiento de la solicitud: la notificación llega por correo electrónico al contacto técnico registrado.

¿Cómo puedo obtener un RNC de pruebas para el sandbox sin usar el RNC real de un cliente?

La DGII puede asignar un RNC de pruebas dedicado para el equipo de desarrollo del ISV mediante solicitud explícita en el formulario de habilitación. Este RNC de pruebas no corresponde a ningún contribuyente real y solo tiene validez en el ambiente de sandbox. Si el ISV ya tiene un cliente habilitado para e-CF en producción, puede usar sus credenciales de sandbox para desarrollar y probar sin afectar su ambiente productivo.

¿Qué diferencia hay entre el certificado digital que uso en sandbox y el que usaré en producción?

En el sandbox, algunos ISVs usan un certificado de pruebas proporcionado por la CA o por el propio sandbox de la DGII. En producción, el certificado debe ser emitido por una CA aprobada por el INDOTEL y estar vinculado al RNC del contribuyente real. Los certificados de sandbox no tienen validez en producción. La recomendación es usar en sandbox un certificado real del contribuyente (pero en el ambiente de pruebas) para que las pruebas sean lo más fidedignas posible a la realidad de producción.

¿Es posible probar todos los tipos de e-CF (31, 32, 33, 34, 41, 43, 44, 45, 47) en el sandbox de la DGII?

En principio sí, pero el ISV necesita un rango de secuenciales asignado para cada tipo que va a probar. La DGII asigna rangos de pruebas para los tipos más comunes (31, 32, 33, 34) de forma estándar. Para tipos especiales (43, 44, 45, 47), el ISV puede necesitar solicitar explícitamente rangos de pruebas adicionales. Es recomendable probar al menos los tipos 31, 32, 33 y 34 en sandbox antes de ir a producción, ya que son los más frecuentes y tienen las validaciones más críticas.