Tagesabschluss übernehmen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/cash-imports/{id}/applyKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Bucht den Tagesabschluss so, wie previewCashImport ihn gezeigt hat, in einem Schritt. Ins Kassenbuch kommt nur Bargeld: der Baranteil des Umsatzes, bares Trinkgeld fürs Team und seine Auszahlung, Auszahlungen, Lohn, Geld von und zur Bank, Privatentnahmen und -einlagen, die Kassendifferenz. Kartenzahlungen buchen auf Geldtransit (SKR03 1360, SKR04 1460), als Zahlart eingelöste Mehrzweck-Gutscheine auf „Ausgegebene Geschenkgutscheine“ (1796, 3786), Trinkgeld fürs Team auf durchlaufende Posten (1590, 1370), Lohn auf „Verbindlichkeiten aus Lohn und Gehalt“ (1740, 3720). Jede Zeile bucht am Kassentag, ohne Debitor oder Kreditor und mit eigenem Buchungstext. Eine Auszahlung wartet ohne Buchung auf ihren Beleg. Die Route lehnt ab, solange eine Prüfung anhält oder fragt, wenn sich Werte oder Bestand seit der Prüfung geändert haben (valuesHash, expectedBalanceMinor), und für die Steuerberatung (403 CashBookOwnerOnly). Danach lässt sich der Tagesabschluss nur noch als Ganzes stornieren. 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 Tagesabschlusses (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 <= 128values and confirmedFields of the preview with its valuesHash; expectedBalanceMinor from the preview
application/json- body
Die Übernahme eines geprüften Tagesabschlusses.
confirmedFields?array<string>Die bestätigten Werte wie bei der Prüfung.
expectedBalanceMinor?integerPflicht: balanceBeforeMinor aus der Prüfung; kam inzwischen eine Buchung dazu, lehnt die Route ab.
values?Die Werte wie bei der Prüfung.
valuesHash?stringPflicht: valuesHash aus previewCashImport mit denselben Werten.
Erfolg.
application/json- response
Ein Tagesabschluss mit Prüfung und dem, was die Übernahme bucht.
balanceAfterMinor?integerBestand nach der Übernahme in Cent.
balanceBeforeMinor?integerBestand der Kasse jetzt in Cent.
checks?array<>|Die Prüfungen in ihrer Reihenfolge.
entries?array<>|Die Einträge, die die Übernahme bucht, mit Nummer neu; nach der Übernahme die gebuchten.
fields?array<>|Jeder Wert mit seiner Quelle.
import?Der Tagesabschluss.
lastTipsFor?stringWem das Trinkgeld beim letzten Tagesabschluss der Kasse gehörte: team oder owner; der einzige Vorschlag aus einem früheren Abschluss.
"team""owner"ready?booleantrue, wenn keine Prüfung mehr anhält oder fragt.
replayed?booleantrue bei einer Wiederholung mit demselben Idempotency-Key.
values?Die geprüften Werte; mit Änderungen an previewCashImport zurück oder an applyCashImport.
valuesHash?stringPrüfwert dieser Werte für applyCashImport.
curl --fail-with-body "https://app.bimetrics.de/api/cash-imports/497f6eca-6276-4993-bfeb-53cbbbba6f08/apply" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "balanceAfterMinor": 156175, "balanceBeforeMinor": 106325, "checks": [], "entries": [ { "bookings": [ { "account": 1000, "accountContra": 8400, "amountMinor": 51800, "flags": "ust19%", "text": "Z-1187 Umsatz 19 % bar" }, { "account": 1360, "accountContra": 8400, "amountMinor": 80250, "flags": "ust19%", "text": "Z-1187 Umsatz 19 % Karte" }, { "account": 1796, "accountContra": 8400, "amountMinor": 6000, "flags": "ust19%", "text": "Z-1187 Umsatz 19 % Gutschein" } ], "entry": { "amountMinor": 51800, "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39", "cashImportId": "4a8c2e6f-1b3d-4f57-9a0c-2e4f6a8b0c13", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-11-12T19:12:00Z", "entryDate": { "day": 12, "month": 11, "year": 2026 }, "id": "8b2d4f60-3c5e-4a71-9b0d-1f3a5c7e9b20", "kind": "sales", "number": "KB-2026-0429", "origin": "web", "text": "Barumsatz aus Z-1187", "updatedAt": "2026-11-12T19:12:00Z", "year": 2026 } } ], "fields": [], "import": { "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39", "createdAt": "2026-11-12T19:10:00Z", "day": { "day": 12, "month": 11, "year": 2026 }, "fileName": "z-bon-1187.jpg", "fileType": "photo", "id": "4a8c2e6f-1b3d-4f57-9a0c-2e4f6a8b0c13", "origin": "web", "registerId": "1", "sha256": "9f2c4e6a8b0d1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a", "sizeBytes": 812345, "source": "zbon", "status": "applied", "textSource": "pdf", "unsure": 2, "uploadedBy": "Jana Kröger", "values": { "day": { "quote": "12.11.2026 19:04", "sure": true, "value": "2026-11-12" }, "movements": [ { "amount": { "minor": 950, "quote": "Entnahme 9,50", "sure": false }, "in": false, "kind": "payout", "kindSure": false, "label": "Entnahme", "text": "Post" } ], "payments": { "card": [ { "amount": { "minor": 80250, "quote": "EC 802,50", "sure": true }, "label": "EC" } ], "cash": { "minor": 51800, "quote": "Bar 518,00", "sure": true }, "voucher": { "minor": 6000, "quote": "Gutschein 60,00", "sure": true } }, "registerId": { "quote": "Kasse 1", "sure": true, "value": "1" }, "revenue": [ { "gross": { "minor": 138050, "quote": "MwSt 19% 1.380,50", "sure": true }, "rate": 19 } ], "tips": {}, "zNumber": { "quote": "Z-Nr. 1187", "sure": true, "value": "1187" } }, "zNumber": 1187, "zSeries": 1 }, "ready": false, "values": { "closingBalanceMinor": 156175, "day": { "day": 12, "month": 11, "year": 2026 }, "movements": [ { "amountMinor": 950, "kind": "payout", "text": "Entnahme Post" } ], "openingBalanceMinor": 106325, "payments": { "cardMinor": 80250, "cashMinor": 51800, "voucherMinor": 6000 }, "registerId": "1", "revenue": [ { "grossMinor": 138050, "rate": 19 } ], "tips": {}, "zNumber": 1187 }, "valuesHash": "abababababababababababababababababababababababababababababababab"}Tagesabschluss abrufen GET
Liefert den Stand des Tagesabschlusses und, sobald der Z-Bon gelesen ist, seine Werte: Z-Nummer, Tag, Umsatz je Steuersatz, Zahlarten, Trinkgeld, Gutscheine, Bargeldbewegungen, Differenz und Kassenbestand. Zu jedem Wert gehören die Textstelle (`quote`) und die Angabe, ob er sicher ist (`sure`). Sicher ist ein Betrag nur, wenn er rechnerisch zu einer Summe auf dem Z-Bon passt. Z-Nummer, Tag und Kassen-ID sind nur sicher, wenn sie aus der Textschicht eines PDFs stammen; die Kennzeichnung als Korrektur (`correction`) kann es auch bei einem Foto sein. Die Art einer Bewegung ist nur sicher, wenn der Z-Bon sie eindeutig nennt. `unsure` zählt die Werte und Arten, die der Nutzer noch bestätigen muss. `readFailure` nennt bei `status: failed` den Grund: `unreadable`, `no_z_number`, `not_a_z_bon` oder `unavailable`. Benötigt einen Schlüssel mit der Berechtigung `read`.
Z-Bon herunterladen GET
Liefert die Datei des Z-Bons so, wie sie hochgeladen wurde. Benötigt einen Schlüssel mit der Berechtigung `read`.