Ambientes
Cada ambiente representa un propósito distinto. El host y la credencial determinan dónde se procesa una solicitud; el cuerpo no puede cambiar de ambiente.
Matriz de ambientes
Sección titulada «Matriz de ambientes»| Ambiente | Conexión DGII | Uso |
|---|---|---|
| Desarrollo interno | No | Desarrollo del equipo de CierreListo. No está disponible al integrador. |
| Sandbox de CierreListo | No | Validación determinista, idempotencia y consultas sin efectos fiscales. |
| Precertificación | Según habilitación | Preparación y verificación antes de los casos oficiales. |
| Certificación DGII | Sí | Casos oficiales de un contribuyente en proceso de certificación. |
| Producción | Sí | Operaciones con posible efecto fiscal para un contribuyente habilitado. |
URLs base previstas
Sección titulada «URLs base previstas»Las URLs definitivas se publican dentro del contrato OpenAPI cuando el ambiente está disponible. La separación prevista es:
sandbox.api.cierrelisto.comprecert.api.cierrelisto.comcert.api.cierrelisto.comapi.cierrelisto.com
Aislamiento obligatorio
Sección titulada «Aislamiento obligatorio»Un ambiente tiene sus propios:
- datos y artefactos;
- cuenta de servicio y API key;
- certificado y secuencias, cuando existe conexión DGII;
- límites y registros de auditoría;
- destinos webhook, cuando el ambiente los produce.
Una credencial de sandbox nunca debe autenticar en certificación o producción.
Sandbox determinista
Sección titulada «Sandbox determinista»El sandbox existe para probar la integración de tu sistema, no la disponibilidad de la DGII. Sus validaciones permiten reproducir:
- aceptación;
- rechazo de validación;
- colisión de idempotencia.
La credencial sigue vinculada a un contribuyente real de la cuenta: CierreListo toma de ese vínculo el UUID, RNC, razón social y tipos e-CF permitidos. No necesitas configurar identidad pública, prefijo comercial, numeración, certificado ni secuencias para comenzar. La dirección necesaria para el preflight es sintética y exclusiva del proceso interno de sandbox.
Los resultados sintéticos se identifican como tales y no generan e-NCF, XML firmado ni PDF fiscal.
Los endpoints de artefactos responden 409 artifact_not_ready en lugar de fabricar evidencia DGII.
Sandbox v1 tampoco produce eventos webhook: confirma el resultado sintético mediante las
operaciones de consulta.
Los escenarios fiscales asíncronos —rechazo DGII, resultado tardío o incierto— se validan en un ambiente DGII habilitado o en pruebas internas controladas; no se prometen como fixtures públicos hasta estar definidos en OpenAPI.
Promoción entre ambientes
Sección titulada «Promoción entre ambientes»No copies una base de datos de sandbox a producción. Promueve la configuración y el aprendizaje:
- valida el mapeo en sandbox;
- prueba firma, deduplicación y recuperación de webhooks en un ambiente DGII habilitado;
- completa los casos oficiales aplicables en certificación;
- verifica habilitación, certificado y secuencias;
- crea credenciales nuevas de producción;
- ejecuta una prueba controlada y reconcilia los tres sistemas.