> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clausum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Analítica de prevención y explicabilidad

> KPIs partner, exportación de explicabilidad de assess y replay de solo lectura para disputas y auditoría.

## KPIs de prevención

`GET /api/v1/merchant/prevention-stats` devuelve métricas agregadas del bucle **assess → recomendación de expediente → outcome**:

* **assessments** — conteos de decisión y tasa de bloqueo
* **case\_recommendations** — eventos de recomendación, pendientes sin expediente, expedientes auto-creados
* **outcomes** — feedback reportado vía `POST /api/v1/assess/outcome`

Requiere clave secreta (`clm_sk_*`) con `stats:read`.

```bash theme={null}
curl -s -H "Authorization: Bearer $CLM_SECRET_KEY" \
  "https://dashboard.clausum.ai/api/v1/merchant/prevention-stats?from=2026-09-01T00:00:00Z"
```

### Filtro por subcomercio PSP

Los PSP pueden acotar KPIs a un comercio hijo:

```bash theme={null}
curl -s -H "Authorization: Bearer $CLM_SECRET_KEY" \
  "https://dashboard.clausum.ai/api/v1/merchant/prevention-stats?submerchant_id=<psp_submerchants.uuid>"
```

## Exportación de explicabilidad

Para chargebacks, solicitudes regulatorias o auditoría interna:

```bash theme={null}
curl -s -H "Authorization: Bearer $CLM_SECRET_KEY" \
  "https://dashboard.clausum.ai/api/v1/merchant/assess-sessions/ps_abc123/explainability"
```

Exportación CSV:

```bash theme={null}
curl -s -H "Authorization: Bearer $CLM_SECRET_KEY" \
  "https://dashboard.clausum.ai/api/v1/merchant/assess-sessions/ps_abc123/explainability?format=csv" \
  -o explainability.csv
```

El paquete incluye metadata de integridad SHA-256 para flujos de archivo.

## Replay de solo lectura

Compara el conjunto de reglas de hoy contra una sesión histórica sin persistir:

```bash theme={null}
curl -s -X POST -H "Authorization: Bearer $CLM_SECRET_KEY" \
  "https://dashboard.clausum.ai/api/v1/merchant/assess-sessions/ps_abc123/replay"
```

La respuesta incluye `diff.decision_changed`, `diff.score_delta`, y códigos de señal agregados/eliminados.

## Operaciones

Orden SQL de producción y monitoreo de cron: consulta **`docs/PRODUCTION_CORE_LOOP_CHECKLIST.md`** en el repositorio.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.