Z-Bon herunterladen
Benötigte Berechtigung:read(Daten lesen)
Liefert die Datei des Z-Bons so, wie sie hochgeladen wurde.
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).
uuiddownload?string1 liefert die Datei als Download mit Dateinamen.
Der Z-Bon, wie er hochgeladen wurde.
response?unknownapplication/octet-streamcurl --fail-with-body "https://app.bimetrics.de/api/cash-imports/497f6eca-6276-4993-bfeb-53cbbbba6f08/file" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"nullTagesabschluss übernehmen POST
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`.
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`.