¿Cómo pruebo antes de pasar a producción?

Realiza el proceso por etapas:

Genera un token Bearer para la organización que vas a integrar.

Usa mode: "Test" para validar la autenticación, la estructura del JSON, los cálculos y las consultas. Los documentos de este ambiente no producen efectos legales.

Prueba casos exitosos y errores esperados para confirmar cómo responde tu integración ante 400, 401, 422, 429 y fallas temporales.

Consulta los documentos por ID y por prefijo y consecutivo para comprobar la trazabilidad.

Usa mode: "Habilitation" para realizar las pruebas previas ante la Dian.

En habilitación incluye el testSetId asignado por la Dian. Debe ser un Guid o UUID válido.

Verifica que prefijos, consecutivos, resolución, catálogos y datos tributarios correspondan al ambiente.

Cambia a mode: "Production" únicamente cuando la organización esté habilitada y la integración haya superado las pruebas.

Ejemplo para habilitación:

{
  "mode": "Habilitation",
  "testSetId": "2f1c9f76-7a37-4d93-9e79-2fbe7b7a7b1a"
}

Antes de producción también conviene probar el control de duplicados, los reintentos, la contingencia Dian y el almacenamiento seguro del token.

Consulta las guías de modos de ambiente e ID del set de pruebas.