Nächste Mahnung einer Rechnung als PDF ansehen
Benötigte Berechtigung:sales:read(Ausgangsrechnungen und Entwürfe lesen)
Zeigt die Mahnung, die runReminders für diese Rechnung jetzt ausstellen würde, als PDF und Bildseiten. Stufe, Frist, Text und Mahngebühr kommen aus den Einstellungen der Stufe, Verzugszinsen und Pauschale aus den Schaltern der Firma. Ausstellungsdatum ist heute, das Layout ist das für neue Mahnungen. Die Nummer fehlt noch, sie entsteht beim Ausstellen; das PDF trägt den Vermerk ENTWURF. item ist die Zeile wie in change eines dryRun, mit derselben version. Bekäme die Rechnung im Lauf keine Mahnung, antwortet die Route mit 409 ReminderNotAllowed, context.reason nennt den Grund wie skipped.reason. Speichert nichts, keine Buchung, kein Versand.
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.
id*stringID der Rechnung (sourceDraftId der Forderung).
uuidErfolg.
application/json- response
Die Mahnung, die der Mahnlauf jetzt ausstellen würde; nichts wird gespeichert.
item?Zeile wie in change eines dryRun, mit derselben version.
pages?array<>|Geordnete Bildseiten aus genau diesen PDF-Bytes.
pdf?Vollständige PDF-Datei als Base64, ohne Nummer, mit dem Vermerk ENTWURF.
curl --fail-with-body "https://app.bimetrics.de/api/receivable/497f6eca-6276-4993-bfeb-53cbbbba6f08/reminder-preview" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "item": { "chargesMinor": 528, "customerName": "Brauhaus Elbwiese GmbH", "dueDate": { "day": 15, "month": 9, "year": 2026 }, "email": "buchhaltung@example.com", "feeMinor": 250, "flatRateMinor": 0, "hasEmail": true, "interestMinor": 278, "issueDate": { "day": 8, "month": 10, "year": 2026 }, "level": 1, "number": "RE-2026-0142", "openMinor": 107100, "paymentDeadline": { "day": 18, "month": 10, "year": 2026 }, "sourceDraftId": "821c3664-640a-4e10-b120-a4ff713532f8", "title": "1. Mahnung", "totalMinor": 107628, "version": "abcdef012345" }, "pages": [ { "content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+XlS8AAAAASUVORK5CYII=", "mime": "image/png" } ], "pdf": { "dataBase64": "JVBERi0xLjcKJUVPRgo=", "filename": "mahnung-entwurf.pdf", "mime": "application/pdf" }}Mahnsperre setzen PUT
Sperrt die Rechnung für Mahnungen, mit optionalem Grund und letztem Tag (until, einschließlich, Europe/Berlin). Ersetzt eine bestehende Sperre. Solange sie gilt: canRemind=false, reminderBlockReason=reminder_hold, nicht in review=reminders; Anlegen und Ausstellen einer Mahnung antworten mit 409 ReminderNotAllowed. Keine Buchung, keine Nachricht; Verzug und Zinsen laufen weiter. Benötigt einen Schlüssel mit der Berechtigung `invoices:draft`.
Mahnungen und Entwürfe suchen GET
Liefert Mahnungsentwürfe, ausgestellte und zurückgezogene Mahnungen. status=all schließt den unveränderlichen Verlauf ein. Ein dokumentierter externer Versand ist kein Versandauftrag oder Zustellnachweis. Benötigt einen Schlüssel mit der Berechtigung `sales:read` oder `read`.