> ## 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.

# Gestión de expedientes

> Crea, actualiza y envía expedientes de fraude a reguladores.

Un **expediente** es el registro regulatorio de un incidente de fraude. Los expedientes suelen crearse automáticamente con [`report-fraud`](/es/guides/report-fraud), pero también puedes crearlos y gestionarlos directamente.

<Note>
  Los endpoints de expedientes pertenecen a la **superficie de gestión** y se autentican con JWT de sesión del panel, no con claves API. Consulta [Autenticación](/es/concepts/authentication).
</Note>

## Ciclo de vida

```
draft → in_review → submitted → resolved
                              ↘ archived
```

| Estado API | Significado |
| - | - |
| `borrador` | Borrador — aún en armado |
| `en_revision` | En revisión interna |
| `enviado` | Enviado al regulador |
| `resuelto` | Resuelto |
| `archivado` | Archivado |

<Note>
  Los valores de estado son enums API en español para flujos regulatorios LATAM. Mapéalos mentalmente al ciclo de vida en inglés arriba.
</Note>

## Crear un expediente

```bash theme={null}
curl -X POST "$CLAUSUM_API_BASE/api/v1/cases" \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "incident_date": "2026-05-20",
    "incident_type": "transferencia_no_autorizada",
    "amount": 250000,
    "currency": "CLP",
    "jurisdiction": "CL",
    "victim_name": "Jane Doe",
    "victim_email": "jane@example.com",
    "priority": "alta",
    "description": "Unauthorized wire transfer following phishing."
  }'
```

### Jurisdicciones y monedas

| Jurisdicción | País | Moneda común |
| - | - | - |
| `CL` | Chile | `CLP` |
| `MX` | México | `MXN` |
| `BR` | Brasil | `BRL` |
| `PE` | Perú | `PEN` |
| `CO` | Colombia | `COP` |
| `UY` | Uruguay | `UYU` |
| `AR` | Argentina | `ARS` |

**Tipos de incidente** (enum API — valores en español):

| Valor | Significado en inglés |
| - | - |
| `phishing` | Phishing |
| `ingenieria_social` | Ingeniería social |
| `transferencia_no_autorizada` | Transferencia no autorizada |
| `robo_identidad` | Robo de identidad |
| `fraude_interno` | Fraude interno |
| `otro` | Otro |

## Listar y filtrar

```bash theme={null}
curl "$CLAUSUM_API_BASE/api/v1/cases?status=en_revision&jurisdiction=CL&limit=50" \
  -H "Authorization: Bearer $DASHBOARD_JWT"
```

Admite `status`, `priority`, `jurisdiction`, `search`, `from_date`, `to_date`, `limit`, `offset`, `sort_by` y `sort_order`.

## Actualizar un expediente

```bash theme={null}
curl -X PATCH "$CLAUSUM_API_BASE/api/v1/cases/$CASE_ID" \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "status": "en_revision", "priority": "urgente" }'
```

## Enviar al regulador

```bash theme={null}
curl -X POST "$CLAUSUM_API_BASE/api/v1/cases/$CASE_ID/submit" \
  -H "Authorization: Bearer $DASHBOARD_JWT"
```

Devuelve `409 Conflict` si el expediente ya fue enviado.

## Estadísticas

Obtén conteos agregados para paneles:

```bash theme={null}
curl "$CLAUSUM_API_BASE/api/v1/cases/stats" \
  -H "Authorization: Bearer $DASHBOARD_JWT"
```

```json theme={null}
{
  "total": 128,
  "by_status": { "borrador": 12, "en_revision": 30, "enviado": 70, "resuelto": 16 },
  "by_priority": { "baja": 20, "normal": 60, "alta": 38, "urgente": 10 },
  "total_amount": 48750000
}
```

## Evidencia y transacciones

Cada expediente puede contener evidencia y transacciones vinculadas:

* `GET/POST /api/v1/cases/{id}/evidence`
* `GET/POST /api/v1/cases/{id}/transactions`
* `GET /api/v1/cases/{id}/activity` — registro de actividad paginado

Explóralos en la [Referencia de API](/es/api-reference/introduction).


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