Secciones
Las partes en que se divide un avalúo.
Las secciones en que se divide un avalúo SHF: carátula, escritura, cuadro de áreas, enfoque de mercado… Sirven para ubicar los hallazgos dentro del documento.
Consultar
curl "$API_URL/v1/catalogos/secciones" -H "x-api-key: $API_KEY"[
{
"id": "8a1b2c3d-4e5f-4a6b-9c7d-0e1f2a3b4c5d",
"key": "cuadro_areas",
"nombre": "CUADRO DE AREAS",
"aliases": ["CUADRO DE ÁREAS"],
"tipo": "texto",
"orden": 7,
"activa": true,
"created_at": "2026-05-02T17:00:00.000Z"
}
]Necesita el scope catalogos:read. Se puede filtrar por ?tipo= y por ?activa=true o
?activa=false (sólo las dadas de baja). Vienen ordenadas por
orden, que es el orden en que aparecen en el avalúo.
| Campo | Qué es |
|---|---|
key | Identificador único de la sección. |
nombre | Nombre como aparece en el documento. |
aliases | Otras formas en que la sección puede aparecer escrita. |
tipo | Cómo se lee: texto, ocr_documento (página escaneada), plano, ocr_imagen (fotografías). |
orden | Posición en el avalúo, desde 1. |
Administrar
Con catalogos:write: POST, PATCH y DELETE en /v1/catalogos/secciones.
| Campo | Regla |
|---|---|
key | Obligatorio y único. |
nombre | Al menos 2 caracteres. |
aliases | Lista de textos sin repetir. |
tipo | Uno de los valores anteriores. |
orden | Entero, al menos 1. |
Añadir alias mejora el reconocimiento de la sección en PDFs que la escriben distinto.
| HTTP | code | Causa |
|---|---|---|
409 | KEY_DUPLICADA | Ya existe una sección con esa key. |
404 | SECCION_NO_ENCONTRADA | El id no existe. |
Fichas completas en la referencia.