Ciclo de vida de un avalúo
Los estados por los que pasa un avalúo, qué los provoca y qué hacer en cada uno.
Un avalúo recorre siempre el mismo camino: se sube el PDF, se lee, se evalúa, se atienden
los hallazgos, se certifica y un controlador dictamina. El campo status del avalúo te dice
en qué punto está.
subir PDF
│
▼
pending ─► processing ─┬─► approved ──► certificado ──► dictamen del controlador
│ ▲ │
│ │ justificar todo │ rechazado
│ │ y emitir certificado │
│ │ ▼
├─► requires_correction ◄──────────────┘
│ │
│ └── subir versión corregida ──► processing
│
└─► error (fallo del servicio)Los estados
status | Qué significa | Qué hacer |
|---|---|---|
pending | El avalúo se creó y el PDF espera a procesarse. | Esperar. |
processing | Se está leyendo el PDF o evaluando. | Seguir el avance. |
requires_correction | Se detuvo: el PDF no sirve, quedan hallazgos pendientes o el controlador lo rechazó. | Ver dónde se detiene. |
approved | Evaluación sin hallazgos pendientes, o certificado emitido. | Emitir el certificado, si aún no existe. |
error | Falló el servicio, no el avalúo. | Reintentar más tarde o reportarlo. |
Las fases
1. Alta
Subes el PDF y el API crea el avalúo. Responde de inmediato; nada se ha evaluado todavía. → Crear un avalúo
2. Lectura del documento
El API lee el PDF y comprueba que sirve para evaluarse: que sea legible, que sea el avalúo
correcto y que tenga las secciones esperadas. El avance está en document.estado.
Si encuentra problemas, los deja en document.errores, el avalúo pasa a
requires_correction y la evaluación no se ejecuta.
3. Evaluación
Si el documento quedó limpio, la evaluación arranca sola. Tiene cinco etapas y produce los
hallazgos y el veredicto. El avance está en latest_evaluation.
→ Interpretar resultados
4. Hallazgos y certificado
Cada hallazgo se corrige (subiendo una versión nueva del PDF) o se justifica. Cuando no
queda ninguno pendiente, puede_certificar pasa a true y se emite el certificado
firmado.
→ Justificar hallazgos ·
Certificado
5. Control
Un controlador verifica que el PDF sigue siendo el certificado y emite el dictamen:
aprobado o rechazado.
→ Control y dictamen
Dónde se detiene
Los tres casos dejan el avalúo en requires_correction, pero se resuelven distinto.
Distínguelos así:
| Causa | Cómo detectarla | Cómo seguir |
|---|---|---|
| El PDF no sirve | document.errores no está vacío | Subir un PDF corregido. |
| Hallazgos pendientes | hallazgos_pendientes > 0 | Justificar cada hallazgo o subir un PDF corregido. |
| Rechazo del controlador | dictamen_control.dictamen es rechazado | Corregir según dictamen_control.motivo_rechazo y subir una versión nueva. |
Subir una versión nueva reinicia el circuito
Una versión nueva del PDF revoca el certificado vigente y cierra el dictamen vigente: vuelve a pasar por lectura, evaluación, certificado y control. Las justificaciones que ya escribiste se conservan y se aplican a los mismos hallazgos.
Campos de ayuda para tu interfaz
GET /v1/avaluos/{folio} trae campos pensados para decidir qué mostrar sin calcular nada:
| Campo | Úsalo para |
|---|---|
document.puede_evaluar | Habilitar un botón "Evaluar" manual. |
hallazgos_pendientes | Mostrar cuántos hallazgos faltan por atender. |
puede_certificar | Habilitar el botón "Emitir certificado". |
certificado | Mostrar y descargar el certificado vigente, o null si no hay. |
dictamen_control | Mostrar el dictamen del controlador y su motivo, o null. |