Ambientes de Trabajo en Etribux
Etribux ofrece tres ambientes completamente independientes y aislados, replicando con exactitud la topología oficial de la Dirección General de Impuestos Internos (DGII).
Cada ambiente cuenta con su propia base de datos, servicio de firma digital, aislamiento de certificados y canales de comunicación con la DGII.
Matriz Comparativa de Ambientes
| Parámetro | Pre-certificación (testecf) | Certificación (certecf) | Producción (ecf) |
|---|---|---|---|
| URL Base API | https://api.etribux.com/testecf/api/v1 | https://api.etribux.com/certecf/api/v1 | https://api.etribux.com/ecf/api/v1 |
| URL Portal Web | https://portal.etribux.com | https://portal.etribux.com | https://portal.etribux.com |
| Propósito | Desarrollo, pruebas libres e integración técnica inicial | Ejecución del Set de Pruebas oficial de la DGII | Facturación tributaria real con valor fiscal legal |
| Certificado Digital | Certificado de prueba o autofirmado | Certificado digital X.509 de producción emitido por CA autorizada | Certificado digital X.509 de producción emitido por CA autorizada |
| Secuencias e-NCF | RNCs y secuencias ficticias o de prueba | RNC real de la empresa con secuencias del Set de Pruebas DGII | RNC real con rangos de secuencias serie E autorizados por la DGII |
| Reutilización de e-NCF | Permitida para pruebas continuas | Permitida durante la repetición de sets | ESTRICTAMENTE PROHIBIDA (una secuencia usada queda quemada) |
| Impacto Fiscal | Cero impacto | Cero impacto (ambiente de homologación DGII) | Valor fiscal definitivo ante el Estado Dominicano |
1. Pre-certificación (testecf)
El ambiente testecf es tu banco de pruebas libre:
- Puedes emitir documentos con RNCs ficticios o de prueba.
- Puedes probar errores deliberadamente (montos fuera de tolerancia, tasas inválidas) para verificar cómo reacciona tu sistema.
- Las secuencias de e-NCF pueden repetirse sin penalización para agilizar el desarrollo de tu ERP o POS.
- La API responde con códigos de seguridad simulados y URLs de consulta en el portal de pruebas de la DGII.
# Ejemplo de llamada de salud en pre-certificación
curl -X GET "https://api.etribux.com/testecf/api/v1/health" \
-H "Authorization: Bearer <TU_TOKEN_TESTECF>"
2. Certificación (certecf)
El ambiente certecf es el entorno donde se lleva a cabo el proceso formal de homologación con la DGII:
- Requiere el certificado digital real de la empresa solicitante.
- Aquí se emite la matriz de comprobantes asignada en tu Set de Pruebas DGII.
- Se validan los acuses comerciales y la simulación de contingencia.
- Una vez que la DGII verifica todos los comprobantes de este ambiente, emite la Resolución de Autorización como emisor electrónico.
:::caution Certificados en Certificación
La DGII exige que el certificado digital utilizado en certecf sea un certificado digital de firma tributaria emitido por una entidad de certificación acreditada en República Dominicana (Avansi, Digifirma, etc.).
:::
3. Producción (ecf)
El ambiente ecf es donde opera la facturación electrónica en vivo:
- Cada comprobante emitido aquí tiene plena validez legal y tributaria.
- Las secuencias de e-NCF deben ser previamente autorizadas por la DGII para tu empresa en la serie E (
E31...,E32..., etc.). - Regla de oro: Un e-NCF emitido o rechazado en producción no se puede volver a utilizar. Si un comprobante es rechazado por un error en tu ERP, ese número de secuencia debe registrarse como anulado ante la DGII. Por ello, recomendamos utilizar el endpoint de pre-validación (
validate=true) antes de emitir comprobantes críticos.