tagger

Categorización automática de movimientos bancarios con cascada catálogo → patrones → MCC → IA. Cada nivel atrapa lo que el anterior no resolvió.

Documentación esencial

Para developers

Integration guide

Guía completa para integrar tagger desde apps mobile o backends. Auth, payloads de ejemplo, manejo de respuestas async (IA), correcciones de usuario, edge cases.

  • Auth con x-api-key
  • Categorizar movimiento
  • Polling de IA
  • Correcciones
  • Errores comunes
  • Ejemplos cURL/TS
Para operadores y devops

Runbook operacional

Procedimientos de deploy, importación de catálogo, mantenimiento de DB y troubleshooting de errores frecuentes (401, IA timeout, sin categoría).

  • Deploy inicial
  • Importar catálogo
  • Dashboard de capas
  • Métricas y logs
  • Mantenimiento DB
  • Troubleshooting

Empezar según tu rol

Operador de negocio

Cargás catálogo, definís categorías, revisás resultados.

  1. 1
    Importar catálogo o movimientos XLSX/CSV con mapping de columnas
  2. 2
    Definir categorías y patrones CRUD + regex / MCC / marcas
  3. 3
    Ver dashboard + sugerencias % por capa + reglas globales sugeridas

Developer integrador

Conectás tagger desde tu backend o app.

  1. 1
    Leer integration guide Auth, payloads, IA async
  2. 2
    Probar requests en API explorer Ejecutor inline + copy curl
  3. 3

DevOps / SRE

Deployás, monitoreás, mantenés salud del servicio.

  1. 1
    Seguir runbook de deploy docker compose + migrations + seed
  2. 2
    Correr suite de tests masivos latencia, throughput, mismatches
  3. 3
    Troubleshooting de incidentes 401, IA timeout, DB

Cómo decide la categoría — Cascada

CAPA 0

Reglas tuyas

Memoria y reglas personales por usuario. Aprende de correcciones.

CAPA 1

Reglas globales

Patrones regex/literal/contiene curados manualmente.

CAPA 2

MCC

Código MCC del input o inferido por nombre de comercio.

CAPA 3

IA (Ollama)

Fallback async cuando ninguna capa anterior matchea.

Salud del sistema

API
Database
Ollama IA
Categorías
Reglas
Marcas IA

Todas las herramientas