bimetricsEntwickler
Umsätze

Fehlenden Beleg vormerken

Als Markdown ansehen

Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
put/api/banktransaction/{id}/receipt-request

Kein 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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Pfadparameter

id*string

ID des Umsatzes.

Formatuuid

Header-Parameter

Idempotency-Key*string

Stabiler 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.

Muster^[!-~]+$
Länge1 <= length <= 128

Request-Body

Wiedervorlage und Notiz

application/json
  1. body

Merker setzen oder ersetzen.

followUpOn?|

Tag der Wiedervorlage, heute bis ein Jahr im Voraus (Europe/Berlin). Ohne Angabe in 14 Tagen.

note?string

Optionale Notiz, eine Zeile, höchstens 300 Zeichen, zum Beispiel „Rechnung per Mail angefragt“.

Antworten

Erfolg.

application/json
  1. response

Der Merker nach der Änderung.

receiptRequest?|

Der Merker; null, wenn er entfernt wurde oder nicht mehr gilt.

transactionId?string

ID des Umsatzes.

Formatuuid
Beispielanfrage
curl --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 '{}'
Beispielantwort
{  "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"}