Tagesabschluss prüfen
Benötigte Berechtigung:read(Daten lesen)
Prüft einen gelesenen Tagesabschluss und zeigt, was die Übernahme buchen würde, ohne etwas zu schreiben: die Einträge mit ihren Buchungen am Kassentag, den Bestand danach, zu jedem Wert seine Quelle (fields) und die Prüfungen (checks). Ohne values nimmt die Prüfung die gelesenen Werte. Danach schickst du values aus der Antwort mit Änderungen zurück, wählst die Art jeder Bewegung, ergänzt Bewegungen, die der Z-Bon nicht druckt (source: manual), und nennst in confirmedFields die unsicheren Werte, die der Nutzer so bestätigt hat. ready ist true, wenn nichts mehr anhält oder fragt; valuesHash und balanceBeforeMinor gehen dann an applyCashImport. Steuersätze kommen nur aus dem Z-Bon, nie aus früheren Belegen. Ist der Tagesabschluss schon übernommen, liefert die Route seine Werte und Einträge.
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 Tagesabschlusses (UUID).
uuidvalues as the preview gave them, with changes, chosen kinds, added movements and answers; confirmedFields
application/json- body
Die Werte, die der Nutzer bestätigt hat.
confirmedFields?array<string>Pfade der unsicheren Werte, die der Nutzer so bestätigt hat, wie sie gelesen wurden, etwa zNumber, payments.card oder movements.0.kind (path in fields); movements, wenn er bei einem nicht lesbaren Z-Bon geantwortet hat, dass keine Ein- oder Auszahlungen darauf stehen.
values?Die Werte aus previewCashImport mit Änderungen, gewählten Arten, ergänzten Bewegungen und Antworten; ohne sie gelten die gelesenen Werte.
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/preview" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'{ "balanceAfterMinor": 156175, "balanceBeforeMinor": 106325, "checks": [ { "field": "movements.0.kind", "key": "kind", "level": "ask", "message": "„Entnahme“ über 9,50 €: Wofür war das Geld?" }, { "field": "payments", "key": "sums", "level": "ok", "message": "Bar, Karte und Gutscheine ergeben den Umsatz von 1.380,50 €." } ], "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": "neu", "origin": "web", "text": "Barumsatz aus Z-1187", "updatedAt": "2026-11-12T19:12:00Z", "year": 2026 } } ], "fields": [ { "path": "payments.cash", "quote": "Bar 518,00", "source": "read" }, { "path": "movements.0.kind", "quote": "Entnahme 9,50", "source": "unsure" } ], "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": "read", "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 }, "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"}Z-Bon als Bilder GET
Liefert den Z-Bon zum Ansehen ohne PDF-Anzeige: die Seiten eines PDFs als PNG-Bilder, höchstens die ersten fünf wie beim Lesen, ein Foto aufrecht gedreht und verkleinert als JPEG. Die Datei selbst liefert `getCashImportFile` unverändert. Abrufen dürfen es alle Rollen. Benötigt einen Schlüssel mit der Berechtigung `read`.
Tagesabschluss stornieren oder verwerfen POST
Verwirft einen Entwurf, der noch nicht übernommen ist (`reading`, `read`, `failed`), ohne Grund; er bleibt als `discarded` erhalten. Hat der Nutzer die Werte eines nicht lesbaren Z-Bons schon eingetragen, schickst du sie in `values` mit, dann behält bimetrics sie mit Z-Nummer und Tag. Einen übernommenen Tagesabschluss storniert die Route als Ganzes mit Grund: Jeder Eintrag bekommt sein Storno mit eigener Nummer am Kassentag, seine Buchungen werden gespiegelt, danach lässt sich derselbe Z-Bon neu übernehmen. Einzelne Einträge eines Tagesabschlusses storniert `reverseCashBookEntry` nicht (`409 CashBookDayClosingEntry`). Abgelehnt wird das Storno, solange einem Geldtransit ein Bankumsatz zugeordnet ist. Stornieren und verwerfen dürfen Inhaber und Nutzer. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.