Visión general
Los cuatro catálogos, para qué sirve cada uno y cómo consultarlos.
Los catálogos definen los valores válidos que usa el API: qué instituciones y tipos de inmueble se aceptan, qué reglas generan hallazgos y en qué secciones se divide un avalúo.
Instituciones
Bancos y entidades que encargan avalúos. Campo 1.16 del PDF.
Tipos de inmueble
Clasificación SHF, claves 1 a 7. Campo 1.10 del PDF.
Reglas
Las reglas que producen hallazgos, identificadas por código.
Secciones
Las partes en que se divide un avalúo.
Dos formas de consultarlos
| Consulta básica | Catálogo completo | |
|---|---|---|
| Para | Llenar selectores de tu interfaz | Administrar los catálogos |
| Rutas | GET /v1/instituciones · GET /v1/tipos-inmueble | /v1/catalogos/{catalogo} |
| Scope | avaluos:read | catalogos:read y catalogos:write |
| Filas | Sólo activas | Todas, incluidas las inactivas |
| Escritura | No | Alta, edición y baja |
# Para un selector
curl "$API_URL/v1/tipos-inmueble" -H "x-api-key: $API_KEY"
# Catálogo completo, incluidas las inactivas
curl "$API_URL/v1/catalogos/tipos-inmueble" -H "x-api-key: $API_KEY"Todas las fichas están en la referencia de catálogos.
Administrar
Con catalogos:write cada catálogo admite:
| Operación | Método |
|---|---|
| Alta | POST /v1/catalogos/{catalogo} |
| Edición parcial | PATCH /v1/catalogos/{catalogo}/{id} |
| Baja | DELETE /v1/catalogos/{catalogo}/{id} |
Las reglas se identifican por su código (/v1/catalogos/reglas/MER-005); los demás, por su
id (UUID).
DELETE es una baja, no un borrado
DELETE marca la fila como inactiva y responde 200 con la fila actualizada. La fila
deja de aparecer en la consulta básica, pero sigue existiendo para los avalúos que ya la
usan. Para reactivarla, edítala con activa: true (o activo: true en tipos de inmueble).
Los cambios tardan hasta 60 segundos
La consulta básica se guarda en caché durante 60 segundos. Un alta o una baja puede tardar
ese tiempo en reflejarse en GET /v1/instituciones y GET /v1/tipos-inmueble.