Zum Hauptinhalt springen

​
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)
  • set_booking_ignore (ignored: true nur wenn mappingIgnoreEnabled bei list_companies true ist; ignored: false hebt Ignorieren und die Kategorie auf)

​
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 set_booking_ignore mit ignored: true, 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. set_booking_ignore mit ignored: false holt sie zurück in die Warteschlange, löscht dabei auch die Kategorie und funktioniert unabhängig vom Flag. ignored: true schlägt fehl, wenn Ignorieren für das Unternehmen deaktiviert ist. Vorschläge erscheinen erst nach dem nächsten Retrain wieder.

​
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