Tipos de inmueble
La clasificación SHF de los inmuebles y cuáles se aceptan hoy.
La clasificación SHF del inmueble. clave es el número del campo 1.10 del avalúo, del
1 al 7.
Consultar
/v1/tipos-inmuebleavaluos:readCatálogo de tipos de inmueble válidos
curl "$API_URL/v1/tipos-inmueble" -H "x-api-key: $API_KEY"[
{ "clave": 2, "codigo": "CASA_HABITACION", "nombre": "Casa habitación", "categoria": "vivienda", "n8n_scraping_type": "casa" },
{ "clave": 4, "codigo": "DEPARTAMENTO_CONDOMINIO", "nombre": "Departamento en condominio", "categoria": "vivienda", "n8n_scraping_type": "departamento" }
]| Campo | Qué es |
|---|---|
clave | Número del campo 1.10 del PDF. |
codigo | Código del API. POST /v1/avaluos/procesar lo devuelve en property_type. GET /v1/control/inbox y GET /v1/metricas/flujo lo devuelven en tipo_inmueble, y GET /v1/metricas/flujo lo acepta como filtro ?tipo_inmueble=. |
nombre | Nombre para mostrar. |
categoria | Agrupación: terreno, vivienda u otro. |
n8n_scraping_type | Qué tipo de comparables se buscan en la etapa de mercado: casa, terreno, departamento, mixto u otro, o null cuando no aplica (p. ej. la clave 5, OTRO). |
El catálogo
| Clave | Código | Nombre | Categoría | ¿Se acepta hoy? |
|---|---|---|---|---|
| 1 | TERRENO | Terreno | terreno | No |
| 2 | CASA_HABITACION | Casa habitación | vivienda | Sí |
| 3 | CASA_HABITACION_CONDOMINIO | Casa habitación en condominio | vivienda | Sí |
| 4 | DEPARTAMENTO_CONDOMINIO | Departamento en condominio | vivienda | Sí |
| 5 | OTRO | Otro | otro | No |
| 6 | VIVIENDA_MULTIPLE | Vivienda Múltiple | vivienda | Sí |
| 7 | TERRENO_MAS_VIVIENDA_PROYECTADA | Terreno más vivienda proyectada | terreno | No |
Consulta siempre GET /v1/tipos-inmueble para conocer los activos: la tabla puede cambiar.
Los avalúos de terreno se rechazan hoy
Las claves 1, 5 y 7 están inactivas. Un PDF con alguna de ellas en el campo 1.10 responde
422 TIPO_INMUEBLE_NO_VALIDO al crearse. Si necesitas procesarlos, pide al equipo de
Tasvalúo que las active.
Cómo se usa al crear un avalúo
Con POST /v1/avaluos/procesar se lee la clave del campo 1.10
del PDF, y es obligatoria:
- Si el campo no se encuentra:
422 TIPO_INMUEBLE_NO_DETECTADO. - Si la clave no está activa:
422 TIPO_INMUEBLE_NO_VALIDO.
En los dos casos el avalúo no se crea. Al re-subir una versión corregida
se aplican los mismos 422: la versión no se registra y el avalúo conserva su tipo. Si la
versión se acepta, el tipo del avalúo pasa a ser el del PDF nuevo.
El tipo determina qué comparables de mercado se usan en la evaluación.
Administrar
Con catalogos:write: POST, PATCH y DELETE en /v1/catalogos/tipos-inmueble.
| Campo | Regla |
|---|---|
clave | Entero de 1 a 7. |
codigo | 2 a 40 caracteres. Se guarda en mayúsculas. |
nombre | Al menos 2 caracteres. |
categoria | terreno, vivienda u otro. |
activo | true o false. Ojo: en este catálogo el campo es activo, no activa. |
Para aceptar avalúos de un tipo inactivo:
curl -X PATCH "$API_URL/v1/catalogos/tipos-inmueble/{id}" \
-H "x-api-key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"activo": true}'| HTTP | code | Causa |
|---|---|---|
409 | CODIGO_DUPLICADO / CLAVE_DUPLICADA | Ya existe ese código o clave. |
404 | TIPO_INMUEBLE_NO_ENCONTRADO | El id no existe. |
Fichas completas en la referencia.