Tasvalúo SAI

Métricas

Indicadores agregados de volumen, tiempos y flujo de los avalúos.

Datos agregados para tableros e informes. Requieren metrics:read.

GET/v1/metricasmetrics:read

Indicadores agregados del sistema

GET/v1/metricas/peritosmetrics:read

Actividad de todos los peritos, paginada

GET/v1/metricas/flujometrics:read

Estado de cada avalúo dentro del proceso

Indicadores

GET/v1/metricasmetrics:read

Indicadores agregados del sistema

Volumen, tiempos promedio (en segundos; null si no hay datos en el rango), embudo del flujo, series temporales, reglas más incumplidas, documentos normativos más citados y actividad por perito y por controlador.

  • Las series traen todos los buckets del rango, con ceros en los periodos sin actividad. Cada bucket empieza a la medianoche de la Ciudad de México (America/Mexico_City), expresada en UTC (p. ej. 2026-09-27T06:00:00.000Z).
  • Los dictámenes cuentan los emitidos en el rango, vigentes o ya cerrados; volumen.dictamenes_vigentes da los que siguen vigentes.
  • Los tiempos de evaluación sólo consideran evaluaciones completadas.
  • Límites: reglas top 15, normativas top 10, por_perito y por_controlador top 25.
Parámetros
CampoTipoDescripción
?desdefecha ISO 8601En la query. Inicio del rango (ISO 8601). Por defecto: 90 días antes de hasta.
?hastafecha ISO 8601En la query. Fin del rango (ISO 8601). Por defecto: ahora.
?granularidaddia | semana | mesEn la query. Tamaño de cada bucket de series. (por defecto "dia")
Petición
curl "$API_URL/v1/metricas" \
  -H "x-api-key: $API_KEY"
Respuesta

200 — Indicadores del rango.

{
  "rango": {
    "desde": "2026-06-16T00:00:00.000Z",
    "hasta": "2026-09-14T00:00:00.000Z",
    "granularidad": "semana"
  },
  "volumen": {
    "avaluos_creados": 42,
    "evaluaciones_ejecutadas": 51,
    "certificados_emitidos": 30,
    "reprocesos": 6,
    "dictamenes_emitidos": 25,
    "dictamenes_vigentes": 21,
    "tasa_aprobacion_ia_pct": 71.4,
    "tasa_sin_criticos_ia_pct": 38.1,
    "tasa_aprobacion_control_pct": 88
  },
  "tiempos": {
    "procesamiento_documento_seg": 94,
    "evaluacion_ia_seg": 310,
    "evaluacion_ia_p50_seg": 240,
    "evaluacion_ia_p90_seg": 620,
    "evaluaciones_lentas": 1,
    "correccion_perito_seg": 86400,
    "verificacion_a_dictamen_seg": 1800,
    "certificado_a_dictamen_seg": null,
    "job_latency_ms": 1200
  },
  "flujo": {
    "pendiente_validacion": 5,
    "en_correccion": 6,
    "validado": 8,
    "aprobado_revision_interna": 22,
    "rechazado_control": 3,
    "error": 1
  },
  "series": [
    {
      "bucket": "2026-06-15T06:00:00.000Z",
      "creados": 3,
      "aprobados": 2,
      "correccion": 1,
      "certificados": 2,
      "dictamenes": 1
    }
  ],
  "reglas": [
    {
      "codigo_regla": "MER-005",
      "titulo": "Diferencia > 20% vs unitario de mercado web",
      "severidad": "tecnico",
      "seccion_avaluo": "Enfoque Mercado",
      "total": 12,
      "justificados": 4,
      "pendientes": 8,
      "avaluos_afectados": 11
    }
  ],
  "normativas": [
    {
      "documento": "Metodología SHF",
      "institucion": "SHF",
      "veces": 9
    }
  ],
  "por_perito": [
    {
      "perito_id": "usr_7",
      "avaluos": 10,
      "aprobados": 7,
      "correccion": 2,
      "reprocesos": 1,
      "criticos": 3,
      "ultimo_avaluo_at": "2026-09-01T18:00:00.000Z"
    }
  ],
  "por_controlador": [
    {
      "controlador_id": "ctl_2",
      "controlador_nombre": "Luis R.",
      "dictamenes": 12,
      "dictamenes_vigentes": 10,
      "aprobados": 11,
      "rechazados": 1,
      "verificaciones": 14,
      "verificaciones_fallidas": 0,
      "tiempo_medio_seg": 2400
    }
  ]
}
Errores
HTTPCuándo ocurre
400desde o hasta no son fechas ISO 8601, granularidad no es dia, semana o mes, o se envió un parámetro no permitido.
401API Key ausente, inválida, revocada o expirada.
403La API Key es válida pero le faltan permisos: Faltan scopes: <scope>.
429Se superó el límite de peticiones (rate limit).

Actividad de los peritos

GET/v1/metricas/peritosmetrics:read

Actividad de todos los peritos, paginada

Todos los peritos con avalúos creados en el rango (el por_perito del resumen es sólo un top 25). Los peritos sin avalúos en el rango no aparecen: el API no tiene tabla de personas, la app los completa contra sus usuarios.

Parámetros
CampoTipoDescripción
?desdestringEn la query. ISO 8601. Por defecto: hace 90 días.
?hastastringEn la query. ISO 8601. Por defecto: ahora.
?perito_idstringEn la query. Uno o varios peritos (metadata.perito_id): lista separada por comas o parámetro repetido. Máximo 100.
?ordenavaluos | aprobados | correccion | reprocesos | criticos | ultimo_avaluo_atEn la query. (por defecto "avaluos")
?direccionasc | descEn la query. (por defecto "desc")
?pageintegerEn la query. Página a devolver (desde 1). (mín. 1) (por defecto 1)
?page_sizeintegerEn la query. Elementos por página. (mín. 1) (máx. 100) (por defecto 20)
Petición
curl "$API_URL/v1/metricas/peritos?desde=2026-06-01&hasta=2026-06-30&perito_id=usr_7%2Cusr_9" \
  -H "x-api-key: $API_KEY"
Respuesta

200 — Página de actividad por perito.

{
  "data": [
    {
      "perito_id": "usr_7",
      "avaluos": 10,
      "aprobados": 7,
      "correccion": 2,
      "reprocesos": 1,
      "criticos": 3,
      "ultimo_avaluo_at": "2026-09-01T18:00:00.000Z"
    }
  ],
  "page": 1,
  "page_size": 20,
  "total": 1,
  "total_pages": 1
}
Errores
HTTPCuándo ocurre
400orden o direccion fuera de lista, más de 100 perito_id, desde o hasta no son fechas ISO 8601, page es menor que 1, page_size está fuera de 1–100 o se envió un parámetro no permitido.
401API Key ausente, inválida, revocada o expirada.
403La API Key es válida pero le faltan permisos: Faltan scopes: <scope>.
429Se superó el límite de peticiones (rate limit).

Avalúos por etapa del flujo

GET/v1/metricas/flujometrics:read

Estado de cada avalúo dentro del proceso

Tabla paginada y filtrable del flujo global, ordenada por defecto por última actualización (más reciente primero): pendiente de validación, en corrección, validado, aprobado para revisión interna, rechazado por control o error.

Parámetros
CampoTipoDescripción
?etapapendiente_validacion | en_correccion | validado | aprobado_revision_interna | rechazado_control | errorEn la query. Sólo los avalúos en esa etapa del flujo. Un valor desconocido responde 400.
?desdestringEn la query. Creados a partir de esta fecha, ISO 8601 (2026-06-24 o 2026-06-24T18:30:00Z).
?hastastringEn la query. Creados hasta esta fecha, ISO 8601 (2026-06-24 o 2026-06-24T18:30:00Z).
?estadopending | processing | requires_correction | approved | errorEn la query. Estado del avalúo. Se combina con etapa en AND; una combinación imposible devuelve cero filas.
?perito_idstringEn la query. Uno o varios peritos (metadata.perito_id): lista separada por comas o parámetro repetido. Máximo 100.
?institucionstringEn la query. Código de la institución (GET /v1/instituciones).
?tipo_inmueblestringEn la query. Código del tipo de inmueble (GET /v1/tipos-inmueble).
?ordenupdated_at | created_at | folioEn la query. Columna de orden; el desempate es estable por id. (por defecto "updated_at")
?direccionasc | descEn la query. (por defecto "desc")
?searchstringEn la query. Filtra por folio: coincidencias que lo contengan, sin distinguir mayúsculas.
?pageintegerEn la query. Página a devolver (desde 1). (mín. 1) (por defecto 1)
?page_sizeintegerEn la query. Elementos por página. (mín. 1) (máx. 100) (por defecto 20)
Petición
curl "$API_URL/v1/metricas/flujo?desde=2026-06-01&hasta=2026-06-30&perito_id=usr_7%2Cusr_9&institucion=BBVA_MEXICO&tipo_inmueble=CASA_HABITACION&search=000123" \
  -H "x-api-key: $API_KEY"
Respuesta

200 — Página del flujo global.

{
  "data": [
    {
      "folio": "26091000123",
      "estado": "approved",
      "etapa": "validado",
      "perito_id": "usr_7",
      "institucion": "BBVA",
      "tipo_inmueble": "CASA_HABITACION",
      "documento_version": 2,
      "certificado_emitido_at": "2026-09-01T18:00:00.000Z",
      "dictamen": null,
      "dictamen_at": null,
      "controlador_nombre": null,
      "created_at": "2026-08-30T15:00:00.000Z",
      "updated_at": "2026-09-01T18:00:00.000Z"
    }
  ],
  "page": 1,
  "page_size": 20,
  "total": 57,
  "total_pages": 3
}
Errores
HTTPCuándo ocurre
400etapa, estado, orden o direccion fuera de lista, desde o hasta no son fechas ISO 8601, page es menor que 1, page_size está fuera de 1–100 o se envió un parámetro no permitido.
401API Key ausente, inválida, revocada o expirada.
403La API Key es válida pero le faltan permisos: Faltan scopes: <scope>.
429Se superó el límite de peticiones (rate limit).

Configuración

Parámetros del motor de evaluación que se pueden ajustar sin desplegar.

Códigos de error

Cada código de negocio, cuándo aparece y cómo resolverlo.

On this page

IndicadoresActividad de los peritosAvalúos por etapa del flujo