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

# Categorizar transacciones automáticamente

> Crea una regla, pruébala y aplícala al historial.

Objetivo: que todo lo que diga "Uber" quede en "Gastos / Transporte / Apps" — hoy y hacia atrás.

<Steps>
  <Step title="Prueba el filtro antes de guardarlo">
    Mira qué transacciones coincidirían, para no aplicar algo demasiado amplio:

    ```bash theme={null}
    curl "https://api.finzaria.com/v1/rules/preview?matchType=contains_phrase&pattern=Uber" \
      -H "Authorization: Bearer $FINZARIA_API_KEY"
    ```
  </Step>

  <Step title="Crea la regla y aplícala al pasado">
    ```bash theme={null}
    curl https://api.finzaria.com/v1/rules \
      -H "Authorization: Bearer $FINZARIA_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "matchType": "contains_phrase",
        "pattern": "Uber",
        "category": "Gastos / Transporte / Apps",
        "applyToPast": true
      }'
    ```

    Con `applyToPast: true`, las transacciones existentes que digan "Uber" quedan categorizadas al
    instante. Desde ahora, las nuevas sin categoría se categorizan solas al crearse.
  </Step>

  <Step title="Verifica">
    ```bash theme={null}
    curl "https://api.finzaria.com/v1/rules/{id}/matches" \
      -H "Authorization: Bearer $FINZARIA_API_KEY"
    ```

    Lista las transacciones vivas que coinciden con la regla.
  </Step>
</Steps>

<Note>
  Borrar una regla **no** descategoriza lo ya etiquetado. Editarla (`PATCH`) reemplaza filtro y
  categoría; con `applyToPast` re-aplica. Ver el concepto de [reglas](/guias/conceptos/reglas).
</Note>