Skip to main content

​
Offene Posten

Offene Posten (Forderungen und Verbindlichkeiten) stammen aus DATEV Connect. MCP liefert die synchronisierten Salden und Zeilen; Schreib-Tools ändern nur Fyvel-Status, Kommentare und Tags — nicht DATEV und nicht externe Systeme (z. B. Stripe).

​
Voraussetzungen

  • DATEV Connect für die Gesellschaft eingerichtet
  • Offene Posten für Debitoren und/oder Kreditoren in den DATEV-Unternehmenseinstellungen aktiviert
  • MCP-Nutzer mit Berechtigung Offene Posten → Ansehen (Lesen) bzw. Verwalten (Schreiben)
Eligibility pro Gesellschaft siehe list_companies: openItemsEligible, openItemsReceivablesEnabled, openItemsPayablesEnabled, openItemsConnectAvailable.

​
Tools

​
Lesen

  • list_open_items — paginierte Liste (Ansicht Konto oder Beleg), Filter u. a. nach Art, Fälligkeit, Suche
  • get_open_item — Detail zu einem stableKey inkl. Zeilen, effektiver Annotation und kurzer Aktivität
  • list_open_item_lines — Zeilen eines Personenkontos, standardmäßig aus dem letzten Geschäftsjahr (max. 500)
  • list_open_item_statuses — gültige Status-Schlüssel vor Schreibvorgängen (archivierte Schlüssel werden beim Schreiben abgelehnt)

​
Schreiben (nur Fyvel-Workflow)

  • upsert_open_item_document_annotation — Status, Kommentar oder Tags auf Belegebene
  • upsert_open_item_partner_annotation — Partner-Standard für ein Personenkonto
  • clear_open_item_document_annotation — Beleg-Override entfernen (Partner-Default gilt wieder)

​
Typischer Ablauf

  1. list_companies — companyUuid und openItemsEligible prüfen
  2. Optional list_accounts — Personenkontonamen zu Kontonummern
  3. list_open_items mit itemKind (receivable / payable) und passender viewMode
  4. Bei Bedarf get_open_item mit stableKey aus der Liste
  5. Nach Abgleich mit externen Daten optional Annotation setzen (list_open_item_statuses → Upsert)

​
fiscalYearId

In beiden Listen-Tools optional. Bei list_open_items ohne Angabe: alle synchronisierten Geschäftsjahre. Bei list_open_item_lines ohne Angabe: das letzte Geschäftsjahr mit Zeilen zu diesem Personenkonto — das tatsächlich gelesene Jahr steht im Feld fiscalYearId der Antwort.

​
Hinweise zur Abstimmung

  • Belegreferenz oft in documentField1; offener Saldo in openAmount (Listen) bzw. Zeilenbeträge im Detail
  • Listen und Zeilen liefern standardmäßig nur offene Posten; für ausgeglichene Posten isCleared explizit setzen
  • Annotationen gehören an den primären Belegschlüssel: stableKey aus list_open_items (Belegansicht) bzw. primaryStableKey im Detail
  • newComment ersetzt den angezeigten Kommentar und schreibt zusätzlich einen Eintrag in die Aktivität
  • Tags eignen sich für externe Referenzen (z. B. Stripe-Invoice-IDs); tags ersetzt die komplette Liste, ohne tags bleiben vorhandene Tags erhalten