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

# Offene Posten (OPOS)

> Read: Stand der offenen Posten pro Personenkonto aus DATEV Rechnungswesen aggregiert auslesen.

## Definition

Mit diesem Modul kannst du den **Stand der offenen Posten (OPOS)** pro Personenkonto zu einem bestimmten Stichtag abrufen. Intern werden Geschäftsjahre, Kontenplan und alle Buchungen parallel aus DATEV geladen, nach `(Personenkonto, Belegnummer)` gruppiert und nach absolutem Saldo absteigend sortiert. Eröffnungsbilanz-Werte werden nach DATEV-Konvention (saldo-neutrales SOLL/HABEN-Paar pro Personenkonto) korrekt verarbeitet.

## API

Die öffentliche Schnittstelle ist **`GET /v2/datev-rewe-read/opos`**. Optional sind:

* `stichtag` (YYYY-MM-DD, Default: heute) — Filter `belegdatum <= stichtag`
* `filter` — `all` (default), `debitors` (erste Ziffer 1-6) oder `creditors` (7-9)
* `eb` — `reconcile` (default, EBs mit Detail-Posten verrechnet, Restbetrag als `EB-RESIDUAL`) oder `raw` (EBs als reguläre Posten unter `beleg = '0'`, für Debug/Wirtschaftsprüfung)

## Bekannte Limitation

Der Endpoint erfasst nur **klassische 9-stellige Personenkonten** (DATEV-Standard: erste Ziffer 1-6 = Debitor, 7-9 = Kreditor — kontenrahmen-unabhängig). Mandanten mit eigenen 8-stelligen Forderungs-/Verbindlichkeits-Sachkonten (z.B. `15970000 Forderungen gg. Mustermann GmbH`) sehen darüber nicht alle ihre OPs — solche Konten sind über die [Sachkonto-Salden](/modules/DATEV-Rechnungswesen/summen-und-salden) direkt abrufbar.

## Response

<ResponseExample>
  ```200 - Erfolg theme={null}
  {
    "data": {
      "stichtag": "2026-12-31",
      "konten": [
        {
          "kontonummer": "100012345",
          "bezeichnung": "Mustermann GmbH",
          "isDebitor": true,
          "totalSaldo": 12500.00,
          "posten": [
            {
              "beleg": "RE-2026-042",
              "belegdatum": "2026-11-15",
              "saldo": 12500.00,
              "buchungstext": "Beratungsleistung Q4"
            }
          ]
        }
      ]
    },
    "business-os": {
      "neuesGuthaben": 331
    }
  }
  ```
</ResponseExample>

## Verbrauch

<Check>
  Für das Ausführen dieses Moduls werden **5 Credits** berechnet — der Endpoint aggregiert intern Geschäftsjahre, Kontenplan und alle Buchungen aller Geschäftsjahre. Deinen detaillierten Verbrauch kannst du in deinem Dashboard ansehen.
</Check>