# Offene Posten zum Stichtag lesen (https://developer.bimetrics.de/reference/open-items/get-open-items)

`GET https://app.bimetrics.de/api/open-items`

operationId: `getOpenItems` · Berechtigung (Scope): `read` · Bereich: Offene Posten

Liefert die Offene-Posten-Liste (OPOS) zu einem Stichtag: mit `side=customers`, was jeder Kunde noch schuldet, mit `side=suppliers`, was die Firma jedem Lieferanten noch schuldet. Je Personenkonto enthält sie die Summe, die Summen je Altersstufe und die offenen Posten mit Fälligkeit und Tagen überfällig. Gezählt wird jede Buchung auf einem Personenkonto bis einschließlich Stichtag, mit den Zuordnungen von heute: Bankzahlungen nach Wertstellung, erfasste Zahlungen nach ihrem Zahltag. Die Summe eines Kontos (`totalMinor`) ist deshalb sein Saldo, wie ihn der DATEV-Export bis zu diesem Tag ergibt. Nach einer Teilzahlung bleibt ein Beleg mit seinem Rest offen. Ist eine Zahlung mehreren Belegen zugeordnet und bleibt ein Rest, steht er als ein Sammelposten da (`kind` `collection`). Skonto, eine Ausbuchung und eine zugeordnete Gutschrift mindern den offenen Betrag wie eine Zahlung; eine Überzahlung ist ein negativer Posten, also ein Guthaben. Alle Beträge sind Euro-Cent: positiv ist, was der Kunde schuldet oder was die Firma dem Lieferanten schuldet. Bei einem Beleg in Fremdwährung nennt der Posten zusätzlich den Belegbetrag in dieser Währung. Nicht in der Liste stehen Abschlagsrechnungen vor ihrer Zahlung, die bimetrics bei Soll-Versteuerung und als Kleinunternehmer erst mit der Zahlung bucht, und Belege, die ein Buchungsfehler am Buchen hindert. `downPayments` und `bookingErrors` nennen Zahl und Summe. Ein anderer Wert für `side` oder ein ungültiger Stichtag ergibt `400 OpenItemsInvalidQuery`, `context.field` nennt das Feld. Alle Rollen dürfen die Liste abrufen, auch die Steuerberatung.

Benötigt einen Schlüssel mit der Berechtigung `read`.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `side` | query | ja | string | `customers` für die Kunden (Debitoren), `suppliers` für die Lieferanten (Kreditoren). |
| `asOf` | query | nein | string | Stichtag als `JJJJ-MM-TT`, etwa `2026-12-31`. Ohne den Parameter gilt heute (deutsche Zeit). |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/open-items" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: OpenItems |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diesen Endpunkt (`APIKeyPermissionDenied`, `context.scope` nennt sie; Berechtigungen sind fest: neuen Schlüssel anlegen, austauschen, alten widerrufen), der Endpunkt ist für API-Schlüssel nicht freigegeben (`APIKeyPermissionDenied` ohne `context.scope`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

#### Felder der Antwort 200 (`OpenItems`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `asOf` | NaiveDate | Der Stichtag. |
| `bookingErrors` | OpenItemsLeftOut | Belege bis zum Stichtag, die ein Buchungsfehler am Buchen hindert, etwa eine fehlende USt-IdNr. Sie fehlen in der Liste, bis der Fehler behoben ist. |
| `buckets` | OpenItemsBuckets | Beträge in Cent je Altersstufe. |
| `downPayments` | OpenItemsLeftOut | Abschlagsrechnungen bis zum Stichtag mit ihrem unbezahlten Rest. Bei Soll-Versteuerung und als Kleinunternehmer bucht bimetrics sie erst mit der Zahlung, deshalb fehlen sie in der Liste; bei Ist-Versteuerung stehen sie in der Liste und zählen hier nicht. Nur bei `customers`. |
| `generatedAt` | string (date-time) | Zeitpunkt der Abfrage. |
| `groups` | Array<OpenItemsAccount>, kann null sein | Die Personenkonten mit offenen Posten, nach Namen sortiert, das Sammelkonto zuletzt. |
| `side` | string: `customers`, `suppliers` | `customers` oder `suppliers`. |
| `totalMinor` | integer | Summe aller offenen Posten in Cent; negativ ist ein Guthaben. |
| `waitingForEuro` | OpenItemsLeftOut | Belege in fremder Währung ohne Euro-Betrag, deren Buchungen der DATEV-Export samt ihrer Zuordnung weglässt, solange DATEV sie nicht hat und der Euro-Betrag nicht feststeht. Die Liste lässt sie deshalb auch weg. Hat DATEV den Beleg schon, fehlen nur seine späteren Zahlungen. `count` ist die Zahl dieser Belege, `amountMinor` der Saldo ihrer weggelassenen Buchungen auf den Personenkonten. Das ist kein Belegbetrag und kann negativ sein. |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json
