# Catálogos tarifarios SOAT

Los archivos `soat-YYYY.json` son artefactos determinísticos de runtime para las vigencias
2022–2026. Cada catálogo v2 contiene los mismos 1.771 procedimientos quirúrgicos del Anexo
Técnico 1, incluidos los códigos originales de cuatro dígitos normalizados a cinco posiciones.

La fuente de verdad está versionada en `../sources/`: el manifiesto declara URL, archivo local,
miembro ZIP, función, vigencia y SHA-256 de cada documento oficial. Los comandos disponibles son:

- `make soat-catalog-download`: restaura de forma atómica fuentes ausentes o corruptas y exige el
  hash declarado.
- `make soat-catalog`: regenera los cinco JSON únicamente desde las fuentes locales, sin red.
- `make soat-catalog-check`: reconstruye los catálogos en memoria y compara cada byte con el
  artefacto versionado.

La nomenclatura, descripción y grupo se extraen del XLS oficial 2022. Las tarifas de cirujano,
anestesia, ayudantía, sala y materiales se extraen de la hoja anual correspondiente. En 2026 cada
componente se multiplica por la UVB de la Resolución 3488 de 2025, se redondea individualmente a
la centena y luego se suma para obtener la tarifa base.

El runtime carga exclusivamente los JSON, los indexa por código y nunca usa FAISS, descripciones
ni similitud semántica para asignar un precio.
