Requisitos y estado del emisor

Antes de crear credenciales, identifica el estado fiscal del contribuyente. El acceso técnico a la API no convierte por sí mismo a una empresa en emisor electrónico.

Elige el punto de partida

Estado	Qué significa	Próximo paso
Aún no es emisor electrónico	No existe habilitación para emitir e-CF con validez fiscal.	Trabajar en sandbox y completar el proceso aplicable ante la DGII.
Está en certificación	Puede ejecutar pruebas oficiales, pero no emitir en producción.	Usar credenciales y certificado del ambiente de certificación.
Ya es emisor electrónico	La DGII lo autorizó y dispone de tipos y secuencias habilitadas.	Verificar evidencia, certificado y rangos antes de activar producción.
Opera mediante un proveedor autorizado	La habilitación depende del expediente y relación aprobada con ese proveedor.	Confirmar que CierreListo puede operar legal y técnicamente ese contribuyente.

No marques producción por declaración

Indicar “ya soy emisor” no basta. CierreListo debe verificar la habilitación, el ambiente, los tipos e-CF, el certificado y las secuencias antes de permitir una emisión real.

Requisitos del piloto

1. Cuenta y contribuyente

   La cuenta de CierreListo debe tener acceso al contribuyente correcto y una persona responsable debe aprobar la integración. Incluso en sandbox, la credencial queda vinculada al UUID, RNC, razón social y tipos e-CF permitidos de ese contribuyente; esos datos no se aceptan desde el cuerpo de la solicitud.

2. Alcance comercial

   Confirma tipos de comprobante, volumen esperado, horario operativo y sistema que conservará la operación comercial original.

3. Identificador inmutable

   Cada operación necesita un external_id estable. No uses un número que pueda reciclarse o cambiar después de emitir.

4. Ambiente

   Se asignan credenciales independientes para sandbox, certificación y producción. El ambiente no se elige dentro del cuerpo de una solicitud.

5. Certificado y secuencias

   Precertificación, certificación y producción requieren la preparación que corresponda al ambiente, incluida la identidad pública, la numeración y, cuando aplique, el certificado y las secuencias. No se reutilizan secuencias ni certificados entre ambientes. Sandbox no requiere esos recursos porque no reserva e-NCF ni crea una factura comercial numerada.

6. Manejo de estados

   La integración debe soportar respuestas asíncronas, idempotencia y reconciliación. En ambientes que producen eventos también debe aceptar webhooks repetidos.

Responsabilidad compartida

El integrador controla: datos comerciales, mapeo desde su sistema, external_id, prevención de doble envío y conciliación con sus registros.

CierreListo controla: validación fiscal, cálculo determinista, construcción y firma, envío, seguimiento, artefactos y evidencia.

La DGII determina: la autorización del emisor y el resultado fiscal oficial.

Qué identidad usa sandbox

Sandbox conserva el RNC y la razón social del contribuyente asignado a la credencial. Para ejecutar el preflight sin exponer una dirección privada, CierreListo usa internamente una dirección sintética identificada como sandbox. Esa dirección no se persiste como configuración, no se muestra como artefacto fiscal y nunca se promueve a otro ambiente.

Checklist para avanzar

• Contribuyente y responsable identificados.
• Estado del emisor verificado con evidencia.
• Tipos e-CF del piloto acordados.
• Fuente de verdad por etapa documentada.
• Estrategia de corte y doble emisión aprobada.
• Ambiente inicial confirmado.
• Contacto técnico y fiscal definido.

Continuar con los ambientes →

Fuentes oficiales

• Biblioteca de facturación electrónica de la DGII
• Documentación sobre comprobantes fiscales electrónicos
• Cambio de proveedor durante la certificación