Korrektur eines Kassenbuch-Eintrags prüfen
Benötigte Berechtigung:read(Daten lesen)
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.
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).
uuidthe 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/preview" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'{ "balanceMinor": 18800, "bookings": [ { "account": 1600, "accountContra": 2100, "amountMinor": 2000, "text": "Storno KB-2026-0002: Betrag vertippt" }, { "account": 1600, "accountContra": 2100, "amountMinor": -1200, "text": "Privatentnahme" } ], "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": "neu", "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": "neu", "origin": "api", "text": "Privatentnahme", "updatedAt": "2026-11-13T09:05:00Z", "year": 2026 } ]}Kassenbuch-Eintrag korrigieren POST
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`.
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`.