Ambientes y empresa de pruebas
La DGII tiene tres ambientes:
| Ambiente | En la API | Para qué |
|---|---|---|
| Pruebas | TestEcf |
Desarrollar y probar tu integración. No tiene validez fiscal. |
| Certificación | CertEcf |
El proceso de certificación de la DGII para ser emisor electrónico. |
| Producción | Ecf |
Comprobantes reales. |
El ambiente lo define la empresa
Sección titulada «El ambiente lo define la empresa»Una factura no tiene un parámetro de ambiente: se emite en el ambiente de la empresa de la API key (o la del
companyId). Para probar, usa una key de tu empresa de pruebas; para producción, una key de tu empresa real. Tu
código no cambia.
La empresa de pruebas
Sección titulada «La empresa de pruebas»En el portal, Empresas → Empresa de pruebas crea una copia de tu empresa (mismo RNC y certificado) que emite siempre en TesteCF. Tiene sus propias secuencias de pruebas, y sus comprobantes nunca se mezclan con los reales.
En TesteCF la DGII no autoriza secuencias: tú defines el rango de cada tipo (por ejemplo, del 1 al 1,000,000) y lo registras en la ficha de la empresa de pruebas → Secuencias. En producción, en cambio, las secuencias las autoriza la DGII.
Pasar a producción
Sección titulada «Pasar a producción»Tu código no cambia, pero la empresa sí tiene que estar lista. Antes de emitir en producción:
- Tu empresa está certificada por la DGII como emisor electrónico. Una parte se hace ante la DGII y el portal te guía en el proceso; ver Certificación.
- La empresa real emite en Producción (
Ecf). Revísalo en el portal, en la ficha de la empresa. - Tiene sus secuencias e-NCF de producción, autorizadas por la DGII y registradas en la ficha de la empresa → Secuencias. Las de TesteCF y CerteCF no sirven en producción. Si tu sistema pone su propio e-NCF, ver Numeración.
- Usas una API key de la empresa real (no la de la empresa de pruebas).
Cómo saber en qué ambiente está algo
Sección titulada «Cómo saber en qué ambiente está algo»- La respuesta del envío, las consultas y los webhooks traen
environment(TestEcf,CertEcfoEcf). - Los listados aceptan el filtro
?environment=Ecf. - Un webhook recibe por defecto solo producción (
Ecf). Para recibir los de pruebas, agrégaleTestEcfen el portal (Webhooks → Ambientes).
Certificación
Sección titulada «Certificación»La certificación para ser emisor electrónico se hace en parte ante la DGII y en parte en el portal:
- Ante la DGII: la postulación como emisor electrónico, los sets de pruebas en su Portal de Certificación (CerteCF) y la declaración jurada.
- En el portal de ecf-hub: una guía paso a paso del proceso, que además genera, firma y envía los comprobantes de los sets por ti.
No se hace por la API.