# Mahnstufe als PDF ansehen (https://developer.bimetrics.de/reference/receivables/preview-reminder-level)

`POST https://app.bimetrics.de/api/reminder/settings/{level}/preview`

operationId: `previewReminderLevel` · Berechtigung (Scope): `sales:read` · Bereich: Forderungen und Mahnungen

Rendert eine Mahnung der Stufe mit Beispieldaten im Layout der Firma, auch mit noch nicht gespeicherten Werten. Eine eingeschaltete Mahngebühr steht als eigene Zeile darin. Speichert nichts.

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

### Authentifizierung

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

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `level` | path | ja | integer | Mahnstufe: 0 Zahlungserinnerung, 1 bis 3 Mahnung. |

### Request-Body (`application/json`)

 

Schema `UpdateReminderLevel`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `deadlineDays` | integer | Zahlungsfrist in Tagen, 1 bis 365. |
| `feeEnabled` | boolean | Mahngebühr ein oder aus; ohne Angabe bleibt der gespeicherte Wert. |
| `feeMinor` | integer | Mahngebühr in Cent, 0 bis 5000; nur tatsächliche Kosten wie Porto. Ohne Angabe bleibt der gespeicherte Wert. |
| `text` | string | Text mit erlaubten Platzhaltern, höchstens 12.000 Zeichen. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/reminder/settings/{level}/preview" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"and","children":[],"limit":50,"offset":0}'
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: ReminderLevelPreview |
| 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 diese Route (`APIKeyPermissionDenied`), 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 (`ReminderLevelPreview`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `pages` | Array<PDFPreviewPage>, kann null sein | Geordnete Bildseiten aus genau diesen PDF-Bytes. |
| `pdf` | PreviewFile | Vollständige PDF-Datei als Base64. |

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