# Offene Posten als PDF (https://developer.bimetrics.de/reference/open-items/download-open-items-pdf)

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

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

Liefert dieselbe Liste wie `GET /api/open-items` als PDF, zum Ausdrucken oder Weitergeben, etwa an die Steuerberatung. Oben stehen Firma, Stichtag und der Tag, dessen Zuordnungen gelten, dann die Summen je Altersstufe. Danach folgt je Personenkonto eine Tabelle mit Beleg, Name, Belegdatum, Fälligkeit, Tagen überfällig und offenem Betrag, am Ende Hinweise auf fehlende Abschlagsrechnungen und Belege mit Buchungsfehler. Das PDF wird bei jedem Aufruf neu aus den Buchungen erstellt. Fehler wie bei `GET /api/open-items`. 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). |
| `download` | query | nein | string | `1` liefert die Datei als Download mit Dateinamen. |

### Beispiel

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

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Die Offene-Posten-Liste als PDF, frisch aus den Buchungen erstellt. | `application/pdf`: string (binary) |
| 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 |

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