# Mahnkosten einer Zuordnung prüfen (https://developer.bimetrics.de/reference/matches/preview-match-reminder-charges)

`GET https://app.bimetrics.de/api/match/{id}/reminder-charges-preview`

operationId: `previewMatchReminderCharges` · Berechtigung (Scope): `read` · Bereich: Zuordnungen

Sagt, ob sich die Zahlung über dem Rechnungsbetrag als Mahnkosten und Zinsen der zuletzt ausgestellten, nicht zurückgezogenen Mahnung buchen lässt, und liefert, was der Nutzer vorher bestätigt: Mahnungs- und Rechnungsnummer, Mehrbetrag, Aufteilung und Konten. Es braucht genau eine Ausgangsrechnung und einen gebuchten Euro-Eingang, kein Skonto und keine erfassten Zahlungen. Der Mehrbetrag darf höchstens so hoch sein wie Gebühren, Pauschale und Zinsen der Mahnung; ausgeglichen werden erst die Kosten, dann die Zinsen. Passt die Zuordnung nicht, antwortet die API mit `eligible: false` und nennt in `refusal` den Code. Verändert nichts.

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 |
| --- | --- | --- | --- | --- |
| `id` | path | ja | string (uuid) | ID des Objekts in dieser Firma (UUID). |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/match/{id}/reminder-charges-preview" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: ReminderChargesPreview |
| 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 |
| 404 | Nicht gefunden (`NotFound`). | `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 (`ReminderChargesPreview`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `eligible` | boolean | True, wenn `settleMatchReminderCharges` den Mehrbetrag jetzt buchen kann. |
| `expectedVersions` | object | Für `settleMatchReminderCharges`, unverändert. |
| `exportedBookings` | boolean | True, wenn beteiligte Buchungen schon an DATEV exportiert sind. Über die API steht `eligible` dann auf false. In der App bleiben die Buchungen stehen, und Mahnkosten und Zinsen kommen mit dem Datum der Zahlung dazu. DATEV bekommt sie erst, wenn der Monat der Zahlung noch einmal exportiert wird. |
| `finalizedBookings` | boolean | True, wenn beteiligte Buchungen festgeschrieben sind. Sie bleiben stehen, Storno und Neubuchung entstehen nur, wenn sich für DATEV etwas ändert; Mahnkosten und Zinsen sind neue Buchungen. |
| `refusal` | string | Bei `eligible: false`: der Fehlercode, mit dem der Aufruf abgelehnt würde. |
| `reminderCharges` | ReminderChargeSettlement | Was bimetrics buchen würde. |

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