Reglas

Cada hallazgo de una evaluación trae un codigo_regla. Este catálogo explica qué significa cada código, su severidad y si admite justificación.

Cómo leer un código

MER-005 → prefijo de tres letras + tres dígitos. El prefijo indica la etapa:

Prefijo	Etapa	Qué revisa
`DOC`	`documental`	Expediente completo y legible.
`DAT`	`datos`	Datos del avalúo contra escritura y carátula.
`CAL`	`calculos`	Aritmética del avalúo.
`MER`	`mercado`	Coherencia con el mercado.
`REG`	`reglas`	Normativa SHF y CNBV.
`SIS`	—	Problemas generales del procesamiento.

Un código no se reutiliza nunca: si una regla se retira, su número queda reservado.

Consultar

GET/v1/catalogos/reglas/{codigo}catalogos:read

Una regla por su código

curl "$API_URL/v1/catalogos/reglas/MER-005" -H "x-api-key: $API_KEY"

200 OK

{
  "codigo_regla": "MER-005",
  "etapa": "mercado",
  "nombre": "Diferencia > 20% vs unitario de mercado web",
  "descripcion": null,
  "severidad_base": "tecnico",
  "fuente": "SHF",
  "nivel_jerarquia": 1,
  "permite_justificacion": true,
  "persiste_en": "evaluation_errors",
  "activa": true,
  "parametros": { "umbral_pct": 20 },
  "notas": null,
  "created_at": "2026-05-02T17:00:00.000Z",
  "updated_at": "2026-09-01T10:12:00.000Z"
}

Para la lista completa: GET /v1/catalogos/reglas, filtrable con ?etapa=mercado y ?activa=false (sólo las retiradas). Necesita el scope catalogos:read.

Campo	Qué es
`severidad_base`	La severidad con la que nace el hallazgo: `critico`, `tecnico` o `forma`.
`permite_justificacion`	`false` en reglas que no admiten justificación.
`fuente`	Origen normativo: `SHF`, `CNBV`, `BANCO` o `TVO`. Puede ser `null`.
`nivel_jerarquia`	Prioridad de la fuente: SHF 1, CNBV 2, BANCO 3, TVO 4.
`persiste_en`	`evaluacion_antecedentes` indica que la regla produce material de consulta, no un hallazgo que bloquee.
`parametros`	Umbrales propios de la regla.

Administrar

Con catalogos:write:

curl -X POST "$API_URL/v1/catalogos/reglas" \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "codigo_regla": "DAT-019",
    "nombre": "Número exterior no coincide con escritura",
    "severidad_base": "tecnico",
    "fuente": "SHF",
    "permite_justificacion": true,
    "persiste_en": "evaluation_errors"
  }'

etapa y nivel_jerarquia los calcula el API a partir del prefijo y de fuente. Enviarlos da 400.
En PATCH no se puede cambiar codigo_regla.
DELETE retira la regla (activa: false). Para reactivarla: PATCH con {"activa": true}.

HTTP	`code`	Causa
`409`	`REGLA_DUPLICADA`	El código ya existe, aunque esté retirado.
`404`	`REGLA_NO_ENCONTRADA`	El código no existe.

Fichas completas en la referencia.

Reglas

Cómo leer un código

Consultar

Administrar

On this page