Skip to main content

​
Zuordnung

Die Zuordnungs-Tools spiegeln die Seite Zuordnung in Fyvel wider. Sie lesen importierte Buchungen, zeigen KI-Vorschläge an und setzen oder entfernen Kategorien.

​
Verfügbare Tools

  • list_mapping_transactions
  • retrain_ai_mapping_suggestions
  • accept_ai_mapping_suggestions
  • set_booking_categories (assign with categoryUuid, or clear assignments when categoryUuid is null)
  • ignore_bookings (nur wenn mappingIgnoreEnabled bei list_companies true ist)
  • unignore_bookings

​
Scope

Zuordnung ist unternehmensbezogen. Du brauchst dafür eine companyUuid.

​
Was list_mapping_transactions kann

list_mapping_transactions ist paginiert und unterstützt die wichtigsten Filter aus der Web-App:
  • Suche
  • berücksichtigte oder ausgeschlossene Konten
  • zugeordnete oder nicht zugeordnete Buchungen (mapped: unmapped, mapped, both — mapped enthält ignorierte Buchungen)
  • Filter nach Kategorien, optional inkl. ignorierter Buchungen (includeIgnored)
  • Buchungen mit KI-Vorschlägen
  • Mindest-Confidence für Vorschläge
  • Sortierung
Standardmäßig liefert das Tool vor allem nicht zugeordnete Buchungen auf berücksichtigten Konten. Das entspricht dem typischen Arbeitsvorrat in der Zuordnung.

​
Typische Anwendungsfälle

  1. list_mapping_transactions
  2. passende Kategorie bestimmen — oder ignore_bookings, wenn die Buchung bewusst ohne Kategorie bleiben soll und mappingIgnoreEnabled für das Unternehmen true ist
  3. set_booking_categories (mit categoryUuid; zum Entfernen categoryUuid null)
  4. optional KI-Vorschläge neu trainieren oder gesammelt akzeptieren
Ignorierte Buchungen sind in Berichten weiterhin dem Konto zugeordnet (ohne Kategorie) und zählen nicht als offene Zuordnung. unignore_bookings holt sie zurück in die Warteschlange und funktioniert unabhängig vom Flag. ignore_bookings schlägt fehl, wenn Ignorieren für das Unternehmen deaktiviert ist.

​
Hinweise

  • Die Tools ändern Fyvel-Zuordnungen, nicht die ursprünglichen Upload-Dateien
  • KI-Vorschläge können explizit akzeptiert oder neu trainiert werden
  • Kategorien stammen aus list_categories