Kassenbuch-Eintrag korrigieren
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/cash-book-entries/{id}/correctKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Korrigiert einen Eintrag in einem Schritt, wie „Korrigieren“ in der App: Ein Storno mit eigener Nummer und dem Grund gleicht den Eintrag aus, ein neuer Eintrag mit den richtigen Werten verweist auf ihn (correctsEntryId). Beide werden zusammen gebucht oder keiner. Der alte Eintrag bleibt unverändert sichtbar, nichts wird überschrieben. Korrigieren lässt sich ein eigener Eintrag ohne Beleg: Ausgabe, Privateinlage, Privatentnahme und Geld von oder zur Bank. Eine Barzahlung zu einem Beleg (auch jede Einnahme), eine Zeile eines Tagesabschlusses, ein Anfangsbestand, eine Kassendifferenz und ein Storno nicht (409 CashBookRejected); dort bleibt das Storno. Das Storno trägt den Kassentag des Eintrags, nach dem Monatsabschluss den heutigen Tag. Der richtige Eintrag nimmt den Tag aus entry, nur in einem offenen Monat. Auch nach beiden darf der Bestand nirgends unter 0 € fallen. Korrigieren 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 des Eintrags (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 right values and the reason
application/json- body
Korrektur eines Eintrags: die richtigen Werte und der Grund.
entry?Der richtige Eintrag, wie bei createCashBookEntries, ohne Beleg.
expectedBalanceMinor?integerDer zuletzt gelesene Bestand vor der Korrektur in Cent, aus der Monatsansicht oder listCashBooks, nicht balanceMinor der Vorschau. Hat er sich seitdem geändert, antwortet die Route mit 409 CashBookRejected.
reason?stringPflicht: was am Eintrag falsch war, höchstens 120 Zeichen. Er steht am Storno.
Erfolg.
application/json- response
Gebuchte oder geprüfte Einträge.
balanceMinor?integerGeld in der Kasse danach, in Cent.
bookings?array<>Nur in der Vorschau: die Buchungszeilen der Einträge ohne Beleg.
entries?array<>|Die Einträge; bei einer Wiederholung mit demselben Idempotency-Key leer.
exported?booleanNur in der Vorschau: true, wenn ein Eintrag in einem Zeitraum liegt, der schon an DATEV exportiert ist. Er kommt dann erst mit, wenn die Firma den Monat noch einmal exportiert.
exportedMonths?array<string>Nur in der Vorschau einer Korrektur: die schon an DATEV exportierten Monate (JJJJ-MM), in die Storno oder richtige Buchung fallen.
replayed?booleantrue bei einer Wiederholung.
curl --fail-with-body "https://app.bimetrics.de/api/cash-book-entries/497f6eca-6276-4993-bfeb-53cbbbba6f08/correct" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "balanceMinor": 18800, "entries": [ { "amountMinor": 2000, "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-11-13T09:05:00Z", "entryDate": { "day": 12, "month": 11, "year": 2026 }, "id": "6e8a0c2d-4f1b-4d3e-9a5c-7b9d1f3a5c27", "kind": "reversal", "number": "KB-2026-0003", "origin": "api", "reversesEntryId": "3f1d2c7a-8b9e-4a51-b6c2-0e4f8a9d7b13", "text": "Storno KB-2026-0002: Betrag vertippt", "updatedAt": "2026-11-13T09:05:00Z", "year": 2026 }, { "amountMinor": -1200, "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "correctsEntryId": "3f1d2c7a-8b9e-4a51-b6c2-0e4f8a9d7b13", "createdAt": "2026-11-13T09:05:00Z", "entryDate": { "day": 12, "month": 11, "year": 2026 }, "id": "9a4c2e6b-1d3f-4b5a-8c7e-0f2a4c6e8b19", "kind": "private_out", "number": "KB-2026-0004", "origin": "api", "text": "Privatentnahme", "updatedAt": "2026-11-13T09:05:00Z", "year": 2026 } ]}Passende Bankumsätze zu Bank ↔ Kasse GET
Liefert zu einem Eintrag zwischen Geschäftskonto und Kasse (`transit_in`, `transit_out` oder Anfangsbestand vom Geschäftskonto) die Bankumsätze, die dazu passen: Gegenbetrag (zu 300 € in die Kasse eine Abhebung über −300 €), gebucht bis sieben Tage vor oder nach dem Kassentag (beim Anfangsbestand bis 60 Tage vor dem Beginn; liegt der Kassentag im ersten offenen Monat nach einem abgeschlossenen, ab dem Ersten des abgeschlossenen Monats), auch schon anders zugeordnete mit `assigned`. Höchstens 10, freie zuerst, dann der nächste Tag. Benötigt einen Schlüssel mit der Berechtigung `read`.
Korrektur eines Kassenbuch-Eintrags prüfen POST
Prüft eine Korrektur wie `correctCashBookEntry` und zeigt das Storno und den richtigen Eintrag mit ihren Buchungen und dem Bestand danach, ohne etwas zu schreiben. Eine Nummer haben beide erst beim Buchen. Korrigieren lässt sich ein eigener Eintrag ohne Beleg: Ausgabe, Privateinlage, Privatentnahme und Geld von oder zur Bank. Eine Barzahlung zu einem Beleg (auch jede Einnahme), eine Zeile eines Tagesabschlusses, ein Anfangsbestand, eine Kassendifferenz und ein Storno nicht (`409 CashBookRejected`); dort bleibt das Storno. Das Storno trägt den Kassentag des Eintrags, nach dem Monatsabschluss den heutigen Tag. Der richtige Eintrag nimmt den Tag aus `entry`, nur in einem offenen Monat. Auch nach beiden darf der Bestand nirgends unter 0 € fallen. Abrufen dürfen es alle Rollen. Benötigt einen Schlüssel mit der Berechtigung `read`.