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

# Reglas de auto-categorización

> Categoriza transacciones automáticamente por su descripción.

Una **regla** asigna una categoría a las transacciones que coinciden con un patrón en su descripción.
Al crear una transacción sin categoría, las reglas se aplican solas.

## Anatomía

| Campo         | Descripción                                                                                      |
| ------------- | ------------------------------------------------------------------------------------------------ |
| `matchType`   | Cómo se compara (p. ej. `contains_phrase`).                                                      |
| `pattern`     | El texto a buscar en la descripción ("Uber").                                                    |
| `category`    | La categoría a aplicar, como [ruta](/guias/conceptos/categorias) ("Gastos / Transporte / Apps"). |
| `applyToPast` | Si `true`, al crear/editar la regla también re-etiqueta transacciones existentes.                |

```json theme={null}
{
  "matchType": "contains_phrase",
  "pattern": "Uber",
  "category": "Gastos / Transporte / Apps",
  "applyToPast": true
}
```

## Prueba antes de guardar

* `GET /v1/rules/preview` — muestra qué transacciones **coincidirían** con un filtro que aún no
  guardas (para no aplicar algo demasiado amplio).
* `GET /v1/rules/{id}/matches` — transacciones vivas que coinciden con una regla existente.

## Endpoints

`GET/POST /v1/rules`, `PATCH/DELETE /v1/rules/{id}`. Editar una regla reemplaza su filtro y categoría;
`applyToPast` re-aplica. Borrar una regla **no** descategoriza lo ya etiquetado.

<Tip>
  Úsalo con [`GET /v1/transactions/description-suggestions`](/referencia): al capturar, sugiere
  descripciones ya usadas y la categoría que una regla aplicaría.
</Tip>