Fehlenden Beleg vormerken
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/banktransaction/{id}/receipt-requestKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Merkt einen Umsatz ohne Beleg als „Beleg vorgemerkt“ vor, mit Tag der Wiedervorlage und optionaler Notiz. Ersetzt einen bestehenden Merker. Der Merker gilt nur, solange der Umsatz keine Zuordnung hat: Sobald der Umsatz zugeordnet wird, egal auf welchem Weg, endet der Merker von selbst. Wird die Zuordnung wieder gelöst, gilt er wieder mit seinem Tag. Ab dem Tag der Wiedervorlage zählt der Umsatz auf der Startseite unter receipt_requests_due. Keine Buchung, keine Nachricht an Dritte.
Benötigt einen Schlüssel mit der Berechtigung matching:write.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID des Umsatzes.
uuidIdempotency-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 <= 128Wiedervorlage und Notiz
application/json- body
Merker setzen oder ersetzen.
followUpOn?|Tag der Wiedervorlage, heute bis ein Jahr im Voraus (Europe/Berlin). Ohne Angabe in 14 Tagen.
note?stringOptionale Notiz, eine Zeile, höchstens 300 Zeichen, zum Beispiel „Rechnung per Mail angefragt“.
Erfolg.
application/json- response
Der Merker nach der Änderung.
receiptRequest?|Der Merker; null, wenn er entfernt wurde oder nicht mehr gilt.
transactionId?stringID des Umsatzes.
uuidcurl --fail-with-body "https://app.bimetrics.de/api/banktransaction/497f6eca-6276-4993-bfeb-53cbbbba6f08/receipt-request" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "receiptRequest": { "due": false, "followUpOn": { "day": 5, "month": 12, "year": 2026 }, "note": "Rechnung per Mail angefragt", "requestedAt": "2026-11-21T09:30:00Z" }, "transactionId": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033"}Merker für fehlenden Beleg entfernen DELETE
Entfernt den Merker des Umsatzes, auch wenn der Umsatz inzwischen zugeordnet ist oder nicht mehr in der Liste steht. Ohne Merker bleibt alles unverändert. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.
Erinnerung an den Lieferanten abbrechen DELETE
Bricht die geplante Erinnerung zur Anfrage ab. Der Merker bleibt. Ohne geplante Erinnerung bleibt alles unverändert; ein Umsatz einer anderen Firma antwortet mit 404. Benötigt einen Schlüssel mit der Berechtigung `mail:send`.