Verzugszinsen und Pauschale ein- oder ausschalten
Benötigte Berechtigung:invoices:draft(Rechnungsentwürfe verwalten)
Echte Wirkung
/api/reminder/settings/chargesKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Idempotency-Key*stringStabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt.
^[!-~]+$1 <= length <= 128application/json- body
Verzugszinsen und Pauschale für alle noch nicht ausgestellten Mahnungen.
flatRateEnabled?booleanPauschale von 40 € nach § 288 Abs. 5 BGB ab Verzug fordern, nur gegenüber Unternehmen.
interestEnabled?booleanVerzugszinsen nach § 288 BGB ab Verzug fordern.
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/charges" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "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" ]}Frist, Text und Gebühren der Mahnstufen lesen GET
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`.
Frist, Text und Mahngebühr einer Mahnstufe ändern PUT
Frist und Text gelten für neue Entwürfe. Die Mahngebühr gilt für alle noch nicht ausgestellten Mahnungen der Stufe; ausgestellte bleiben unverändert. Ohne Frist, Text und Gebühr gilt wieder der Standard, auch für die Gebühr. Unbekannte Platzhalter werden abgelehnt. Nur für den Inhaber. Benötigt einen Schlüssel mit der Berechtigung `invoices:draft`.