Z-Bon als Bilder
Benötigte Berechtigung:read(Daten lesen)
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.
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).
uuidErfolg.
application/json- response
Der Z-Bon als Bilder.
lines?array<>Bei einem Tag aus einer Kassendatei statt Seiten seine Buchungszeilen, ohne den Link zum Beleg.
pages?array<>|Die Seiten in ihrer Reihenfolge: bei einem PDF als PNG, höchstens die ersten fünf, bei einem Foto ein JPEG.
rows?array<string>Bei einem Kassenabschluss aus einem DSFinV-K-Export die gelesenen Zeilen seiner Dateien, je Zeile Datei, Zeilennummer und Felder; Namen von Kunden und Personal liest bimetrics nicht.
curl --fail-with-body "https://app.bimetrics.de/api/cash-imports/497f6eca-6276-4993-bfeb-53cbbbba6f08/pages" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "pages": [ { "content": "/9j/4AAQSkZJRg==", "mime": "image/jpeg" } ]}Z-Bon herunterladen GET
Liefert die Datei des Z-Bons so, wie sie hochgeladen wurde. Benötigt einen Schlüssel mit der Berechtigung `read`.
Tagesabschluss prüfen POST
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`.