Beleg einer Auszahlung zurücknehmen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/cash-book-entries/{id}/document/reverseKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Nimmt den Beleg einer Auszahlung mit Grund zurück, wie „Beleg zurücknehmen“ in der App: Die Barzahlung des Belegs oder die Buchungen des Eigenbelegs werden am Kassentag gespiegelt, die ursprünglichen bleiben sichtbar. Danach steht die Auszahlung wieder mit receiptMissing. Ist der Monat abgeschlossen, antwortet die Route mit 409 CashBookRejected; die Berichtigung klärt dann die Steuerberatung. POST /api/match/payment/reverse nimmt die Barzahlung eines solchen Belegs nicht zurück, nur diese Route. Zurücknehmen dürfen Inhaber und Nutzer, nicht die Steuerberatung (403 CashBookOwnerOnly). Bei einer Wiederholung schickst du denselben Idempotency-Key.
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 der Auszahlung (UUID).
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 <= 128the receipt in force and the reason
application/json- body
Rücknahme des Belegs einer Auszahlung.
reason?stringPflicht: warum der Beleg zurückgenommen wird, höchstens 120 Zeichen.
settlementId?stringPflicht: settlement.id der Auszahlung, wie zuletzt gelesen. Gilt inzwischen ein anderer Beleg, lehnt bimetrics mit 409 ab.
uuidErfolg.
application/json- response
Die Auszahlung mit ihrem Beleg.
bookings?array<>|Die Buchungen des Belegs am Kassentag; leer nach der Rücknahme.
entry?Die Auszahlung mit settlement, nach der Rücknahme mit receiptMissing.
replayed?booleantrue bei einer Wiederholung.
curl --fail-with-body "https://app.bimetrics.de/api/cash-book-entries/497f6eca-6276-4993-bfeb-53cbbbba6f08/document/reverse" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "bookings": [], "entry": { "amountMinor": -950, "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39", "cashImportId": "6d2f8b1c-3e5a-4c7d-9f20-8b4e1a6c3d57", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-11-13T09:05:00Z", "entryDate": { "day": 12, "month": 11, "year": 2026 }, "id": "3f1d2c7a-8b9e-4a51-b6c2-0e4f8a9d7b13", "kind": "expense", "number": "KB-2026-0007", "origin": "api", "receiptMissing": true, "text": "Auszahlung aus Z-1186: Porto", "updatedAt": "2026-11-13T09:05:00Z", "year": 2026 }}Beleg einer Auszahlung zuordnen POST
Ordnet einer Auszahlung aus einem Tagesabschluss (`receiptMissing`) ihren Beleg zu, wie „Zuordnen“ und „Eigenbeleg erstellen“ in der App. Mit `documentId` bucht bimetrics die Barzahlung eines offenen Eingangsbelegs, Kreditor an Kasse, wie `POST /api/match/payment`; `expectedVersion` und `expectedAmountOpenMinor` sind die zuletzt gelesenen Werte. Der offene Betrag muss die Auszahlung decken. Ohne Beleg bucht ein Eigenbeleg (`category` und `ownReceipt`) die Ausgabe ohne Vorsteuer, wie eine Ausgabe ohne Beleg. Beides zusammen oder keins ergibt `400 CashBookRejected`. Betrag und Tag kommen aus der Auszahlung: Gebucht wird am Kassentag, ein neuer Eintrag entsteht nicht. Eine Auszahlung hat höchstens einen Beleg. Nur im offenen Monat, auch in einem stillgelegten Kassenbuch. Lohn und ausgezahltes Trinkgeld brauchen keinen Beleg. Zuordnen dürfen Inhaber und Nutzer, nicht die Steuerberatung (`403 CashBookOwnerOnly`). Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.
Kassenbuch-Eintrag stornieren POST
Storniert einen Eintrag mit Grund, auch Wochen später: Ein neuer Eintrag mit eigener Nummer gleicht ihn aus und trägt den Kassentag des Eintrags, seine Buchungen werden gespiegelt. Ist der Monat des Eintrags abgeschlossen, kommt das Storno mit heutigem Datum in den laufenden Monat. In einem stillgelegten Kassenbuch lässt sich nichts mehr stornieren. Bei einem Eintrag mit Beleg nimmt das Storno die Barzahlung am Beleg zurück, am selben Tag wie das Storno. Jeder Eintrag lässt sich einmal stornieren, ein Storno nie. Auch nach dem Storno darf der Bestand nirgends unter 0 € fallen. Ist dem Eintrag ein Bankumsatz zugeordnet, lehnt die Route ab, bis die Zuordnung gelöst ist. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.