> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fyvel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Offene Posten

> DATEV Offene Posten per MCP lesen und Fyvel-Workflow-Annotationen pflegen.

# 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`](/mcp/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`](/mcp/companies) — `companyUuid` und `openItemsEligible` prüfen
2. Optional [`list_accounts`](/mcp/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