Skip to main content

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.

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
  • filterall (default), debitors (erste Ziffer 1-6) oder creditors (7-9)
  • ebreconcile (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 direkt abrufbar.

Response

{
  "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
  }
}

Verbrauch

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.