Ir al contenido

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.

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.

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.

Tu código no cambia, pero la empresa sí tiene que estar lista. Antes de emitir en producción:

  1. 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.
  2. La empresa real emite en Producción (Ecf). Revísalo en el portal, en la ficha de la empresa.
  3. 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.
  4. Usas una API key de la empresa real (no la de la empresa de pruebas).
  • La respuesta del envío, las consultas y los webhooks traen environment (TestEcf, CertEcf o Ecf).
  • Los listados aceptan el filtro ?environment=Ecf.
  • Un webhook recibe por defecto solo producción (Ecf). Para recibir los de pruebas, agrégale TestEcf en el portal (Webhooks → Ambientes).

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.