OPOS — Offene Posten

Aggregiert alle Buchungen aller Geschäftsjahre der Connection und gibt den Stand der offenen Posten pro Personenkonto zurück — gruppiert nach (Personenkonto, Belegnummer), sortiert nach |Saldo| absteigend.

Intern werden Geschäftsjahre + Kontenplan + alle GJ-Buchungen parallel von DATEV gefetched (typisch 15-30s für mittelgroße Mandanten). EBs werden nach DATEV-Konvention (saldo-neutrales SOLL/HABEN-Paar pro Personenkonto) korrekt behandelt; bei Konten mit Vor-Sync-Aktivität erscheint ein EB-RESIDUAL-Posten.

Bekannte Limitation: der Endpoint erfasst nur klassische 9-stellige Personenkonten. Mandanten mit eigenen 8-stelligen Forderungs-/Verbindlichkeits-Sachkonten (z.B. 15970000 Forderungen gg. XYZ) sehen darüber nicht alle ihre OPs — solche Konten sind über die SuSa direkt abrufbar.

Kosten: 5 Credits

GET /v2/datev-rewe-read/opos

OPOS — Offene Posten

cURL

curl --request GET \
  --url https://api.business-os.de/v2/datev-rewe-read/opos \
  --header 'x-api-key: <api-key>'

200

Example

{
  "data": {
    "stichtag": "2026-12-31",
    "konten": [
      {
        "kontonummer": "100012345",
        "bezeichnung": "Mustermann GmbH",
        "isDebitor": true,
        "totalSaldo": 12450.5,
        "posten": [
          {
            "beleg": "R-2024-003",
            "belegdatum": "2024-03-15",
            "buchungstext": "Lizenzgebühr Q1 2024",
            "saldo": 4500
          }
        ]
      }
    ],
    "sumDebitoren": 24500,
    "sumKreditoren": -8200
  },
  "business-os": {
    "neuesGuthaben": 123
  }
}

Authorizations

x-api-key · string · header · required

Dein Business OS API Key. Erstelle einen unter app.business-os.de → API Keys.

Query Parameters

connectionId · string<uuid> · required

UUID der DATEV-Verbindung. Abrufbar über den /connections-Endpunkt des jeweiligen Moduls (z. B. GET /v2/datev-duo/connections).

Example:

"abbc18fd-ba5e-4dfd-afc4-9dec0c0ad145"

companyId · string

Mandanten-ID im Format <Beraternummer>-<Mandantennummer>. Nur nötig wenn die Connection mehrere Mandanten umfasst (Steuerberater-Account) und nicht der Default-Mandant gemeint ist. Ohne diesen Parameter nutzt DATEV den beim OAuth gewählten Default-Mandanten — der hat aber je nach Setup keine Export-Subscription, dann kommt 403 zurück.

Example:

"386587-29183"

stichtag · string<date>

OP-Stichtag (YYYY-MM-DD). Default: heute. Filter belegdatum <= stichtag.

filter · enum<string> · default: all

Optionaler Server-Filter: debitors (nur erste Ziffer 1-6), creditors (7-9), all (default).

Available options: all, debitors, creditors

eb · enum<string> · default: reconcile

Behandlung der Eröffnungsbilanz-Werte. reconcile (default): EBs werden mit Detail-Posten verrechnet; ein Restbetrag erscheint als EB-RESIDUAL-Posten. raw: EBs werden als reguläre Posten unter beleg = '0' ausgegeben (Debug/Wirtschaftsprüfung).

Available options: reconcile, raw

quelle · string · default: API

Kennzeichnung der Aufrufquelle für die Nutzungsanalyse. Standard bei Weglassen: API (direkter API-Aufruf). Für Automationen aus Make z. B. Make angeben.

Example:

"Make"

Response

200

application/json

OP-Stand pro Personenkonto

data · object

Show child attributes

business-os · object

Show child attributes