Skip to main content

​
Eigene Buchungen

Diese Tools arbeiten mit Eigenen Buchungen in Fyvel. Sie lesen und verändern manuell gepflegte Buchungen, nicht die ursprünglich importierten Buchhaltungsdateien.

​
Verfügbare Tools

  • list_manual_uploads - verfügbare Bereiche für Eigene Buchungen eines Unternehmens
  • create_manual_upload - neuen Bereich für Eigene Buchungen anlegen (entspricht „Neue Gruppe” auf der Eigene-Buchungen-Seite)
  • list_manual_transactions - Buchungen in einem Bereich (uploadUuid)
  • append_manual_transactions - neue Buchungen hinzufügen
  • patch_manual_transactions - bestehende Buchungen ändern
  • remove_manual_transactions - Buchungen entfernen

​
Bereiche (Uploads)

Eigene Buchungen werden in Bereichen gruppiert — dieselben Gruppen wie in der Web-App unter Eigene Buchungen (z. B. ein Bereich pro Monat oder Thema). Jeder Bereich hat eine uploadUuid. Mit create_manual_upload legst du einen leeren Bereich an; mit list_manual_uploads listest du bestehende Bereiche auf.

​
Scope

Eigene Buchungen sind unternehmensbezogen. Gib immer eine companyUuid aus list_companies mit. Für alle Aufrufe außer list_manual_uploads und create_manual_upload brauchst du zusätzlich eine uploadUuid aus list_manual_uploads oder aus der Antwort von create_manual_upload.

​
Wichtige Hinweise

  • Schreib-Tools ändern nur die manuelle Buchungsebene in Fyvel.
  • Sende bei Änderungen nur die Zeilen, die du hinzufügen, ändern oder entfernen möchtest.
  • Pro neuer Zeile in append_manual_transactions muss genau eines von amountDebit oder amountCredit größer null sein.
  • Die Organisation ergibt sich aus dem MCP-Bearer-Token.

​
Typischer Ablauf

Neuer Bereich mit Buchungen:
  1. list_companies
  2. create_manual_upload mit companyUuid und name → uploadUuid aus der Antwort
  3. append_manual_transactions mit companyUuid, uploadUuid und den neuen Zeilen
Bestehender Bereich:
  1. list_companies
  2. list_manual_uploads mit companyUuid
  3. gewünschte uploadUuid auswählen
  4. list_manual_transactions zum Lesen oder eine Mutation (append_*, patch_*, remove_*)