Einzahlung aus der Kasse buchen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/banktransaction/{id}/cash-depositKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Eine Bareinzahlung kommt in einem Schritt aus dem Kassenbuch: Ein Eintrag transit_out bucht Geldtransit an Kasse, und der Bankumsatz wird ihm als cash_transit zugeordnet, also Bank an Geldtransit. Beides gelingt zusammen oder gar nicht. Es geht nur ein gebuchter, noch nicht zugeordneter Eingang in Euro, und nur, wenn der Bestand der Kasse am Kassentag und danach nicht unter null fällt. Für Kassentag, Kassensystem, Rechte und Storno gilt dasselbe wie bei cash-in. Sende cashBookId, entryDate, expectedBalanceMinor und planHash aus der bestätigten Vorschau, mit Header Idempotency-Key. Hat sich seitdem etwas geändert, antwortet die Route mit 409 CashBookRejected.
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 Bankumsatzes der Einzahlung (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 <= 128cash book, cash day, balance and planHash of the preview
application/json- body
Bestätigung der Vorschau.
cashBookId?stringID des Kassenbuchs (UUID).
uuidentryDate?Kassentag der Vorschau.
expectedBalanceMinor?integerbalanceBeforeMinor der Vorschau.
planHash?stringplanHash der Vorschau.
Erfolg.
application/json- response
Bargeld in die Kasse: Vorschau oder Buchung.
balanceAfterMinor?integerBestand der Kasse danach in Cent.
balanceBeforeMinor?integerBestand der Kasse vorher in Cent; bei replayed der von jetzt abzüglich des Betrags.
bookings?array<>|Geldtransit an Bank am Tag der Wertstellung, Kasse an Geldtransit am Kassentag.
cashBookId?stringID des Kassenbuchs (UUID).
uuidcashBookName?stringName des Kassenbuchs.
entry?Der Eintrag transit_in; in der Vorschau heißt seine Nummer neu.
entryDate?Der Kassentag.
exportedMonths?array<string>|Monate (JJJJ-MM) dieser Buchungen, die DATEV schon hat.
firstDate?Erster passender Kassentag.
lastDate?Letzter passender Kassentag, höchstens heute.
matchId?stringNach dem Buchen: die Zuordnung cash_transit.
uuidplanHash?stringSHA-256 der Vorschau.
replayed?booleanWiederholung mit demselben Idempotency-Key.
transaction?Die Abhebung.
waiting?array<>|Offene Einträge mit diesem Betrag, die schon auf den Umsatz warten.
curl --fail-with-body "https://app.bimetrics.de/api/banktransaction/497f6eca-6276-4993-bfeb-53cbbbba6f08/cash-deposit" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "balanceAfterMinor": 12000, "balanceBeforeMinor": 42000, "bookings": [ { "amountMinor": 30000, "bookingDate": { "day": 12, "month": 11, "year": 2026 }, "creditAccount": 1460, "creditName": "Geldtransit", "debitAccount": 1801, "debitName": "Geschäftskonto", "text": "Bareinzahlung Filiale" }, { "amountMinor": 30000, "bookingDate": { "day": 12, "month": 11, "year": 2026 }, "creditAccount": 1600, "creditName": "Handkasse", "debitAccount": 1460, "debitName": "Geldtransit", "text": "Geld aufs Geschäftskonto" } ], "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39", "cashBookName": "Handkasse", "entry": { "amountMinor": -30000, "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": "3f1d2c7a-8b9e-4a51-b6c2-0e4f8a9d7b13", "kind": "transit_out", "number": "KB-2026-0005", "origin": "api", "text": "Geld aufs Geschäftskonto", "updatedAt": "2026-11-13T09:05:00Z", "year": 2026 }, "entryDate": { "day": 12, "month": 11, "year": 2026 }, "exportedMonths": [], "firstDate": { "day": 5, "month": 11, "year": 2026 }, "lastDate": { "day": 19, "month": 11, "year": 2026 }, "matchId": "5b7d9f1e-2a4c-4e6b-8d0f-1a3c5e7b9d24", "planHash": "abababababababababababababababababababababababababababababababab", "transaction": { "accountName": "Geschäftskonto", "amountMinor": 30000, "bookingDate": { "day": 12, "month": 11, "year": 2026 }, "id": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033", "text": "Bareinzahlung Filiale" }, "waiting": []}Antwort zum DATEV-Weg prüfen POST
Prüft eine Antwort wie `PUT /api/settings/datev` und sagt, was sie ändert, ohne etwas zu speichern. `unchanged` ist `true`, wenn sie ab diesem Tag schon gilt. Benötigt einen Schlüssel mit der Berechtigung `read`.
Einzahlung aus der Kasse prüfen GET
Eine Bareinzahlung kommt in einem Schritt aus dem Kassenbuch: Ein Eintrag `transit_out` bucht Geldtransit an Kasse, und der Bankumsatz wird ihm als `cash_transit` zugeordnet, also Bank an Geldtransit. Beides gelingt zusammen oder gar nicht. Es geht nur ein gebuchter, noch nicht zugeordneter Eingang in Euro, und nur, wenn der Bestand der Kasse am Kassentag und danach nicht unter null fällt. Für Kassentag, Kassensystem, Rechte und Storno gilt dasselbe wie bei `cash-in`. Die Vorschau führt die Buchung probeweise aus und nimmt sie zurück, sie lehnt also ab, was auch das Buchen ablehnt. Ihre Antwort ist dieselbe wie bei `cash-in-preview`; `waiting` nennt offene Einträge `transit_out` mit diesem Betrag. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.