Reglas de auto-categorización - Finzaria

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 (“Gastos / Transporte / Apps”).
`applyToPast`	Si `true`, al crear/editar la regla también re-etiqueta transacciones existentes.

{
  "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.

Úsalo con GET /v1/transactions/description-suggestions: al capturar, sugiere descripciones ya usadas y la categoría que una regla aplicaría.