Frist, Text und Gebühren der Mahnstufen lesen
Benötigte Berechtigung:sales:read(Ausgangsrechnungen und Entwürfe lesen)
Liefert für die Stufen 0 bis 3 Titel, Frist in Tagen, Text und Mahngebühr, mit denen neue Mahnungen beginnen, dazu die erlaubten Platzhalter, die Schalter für Verzugszinsen und Pauschale und den heute gültigen Basiszinssatz.
Benötigt einen Schlüssel mit der Berechtigung sales:read oder read.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Erfolg.
application/json- response
Frist, Text und Mahngebühr je Mahnstufe, dazu Verzugszinsen und Pauschale.
baseRatePercent?stringHeute gültiger Basiszinssatz in Prozent als Dezimaltext, zum Beispiel 1.52; leer, wenn er bimetrics noch nicht bekannt ist.
flatRateEnabled?booleantrue, wenn Mahnungen ab Verzug die Pauschale von 40 € nach § 288 Abs. 5 BGB fordern, nur gegenüber Unternehmen und einmal je Rechnung; sie schließt Mahngebühren ein. Standardmäßig aus.
interestEnabled?booleantrue, wenn Mahnungen ab Verzug Verzugszinsen fordern: 9 Prozentpunkte über dem Basiszinssatz gegenüber Unternehmen, sonst 5. Standardmäßig aus.
levels?array<>|Die Stufen 0 bis 3.
placeholders?array<string>|Erlaubte Platzhalter ohne Klammern, zum Beispiel Frist.
curl --fail-with-body "https://app.bimetrics.de/api/reminder/settings" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "baseRatePercent": "1.52", "flatRateEnabled": false, "interestEnabled": true, "levels": [ { "custom": true, "deadlineDays": 7, "feeEnabled": true, "feeMinor": 250, "level": 2, "text": "Die Rechnung {Rechnungsnummer} ist noch offen. Bitte überweisen Sie {Gesamtbetrag} bis spätestens {Frist}.", "title": "2. Mahnung" } ], "placeholders": [ "Rechnungsnummer", "Offener Betrag", "Gesamtbetrag", "Frist" ]}Mehrere Mahnungs-PDFs als ZIP laden GET
Liefert die gespeicherten Original-PDFs von bis zu 50 ausgestellten oder zurückgezogenen Mahnungen in einer ZIP-Datei, mit denselben Bytes wie downloadReminderPDF. Mehr als 50 IDs: `400 BulkLimitExceeded`. Ist eine Mahnung ein Entwurf, antwortet die Route mit `400`; fehlt eine oder gehört sie zu einer anderen Firma, mit `404`. Dann gibt es keine ZIP-Datei. Es wird nichts versendet. Benötigt einen Schlüssel mit der Berechtigung `sales:read` oder `read`.
Verzugszinsen und Pauschale ein- oder ausschalten PUT
Schaltet für alle noch nicht ausgestellten Mahnungen Verzugszinsen nach § 288 BGB und die Pauschale von 40 € (nur gegenüber Unternehmen, einmal je Rechnung) ein oder aus. Gefordert wird beides erst ab Verzug, also nach Ablauf der Frist der ersten Mahnung. Ausgestellte Mahnungen bleiben unverändert. Nur für den Inhaber. Benötigt einen Schlüssel mit der Berechtigung `invoices:draft`.