bimetricsEntwickler
Kassenbuch

Z-Bon herunterladen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/cash-imports/{id}/file

Liefert die Datei des Z-Bons so, wie sie hochgeladen wurde.

Benötigt einen Schlüssel mit der Berechtigung read.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Pfadparameter

id*string

ID des Tagesabschlusses (UUID).

Formatuuid

Query-Parameter

download?string

1 liefert die Datei als Download mit Dateinamen.

Antworten

Der Z-Bon, wie er hochgeladen wurde.

response?unknownapplication/octet-stream
Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/cash-imports/497f6eca-6276-4993-bfeb-53cbbbba6f08/file" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
null

Tagesabschluss ü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`.