Kassendatei hochladen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/cash-books/{id}/import-filesKein Testversand aus der Dokumentation: Jeder Aufruf legt einen echten Beleg an. Nutze das Codebeispiel mit einer Datei, die wirklich in die Firma gehört.
Speichert den DATEV-Export eines Kassensystems (Buchungsstapel, EXTF), etwa aus Belbo, unverändert mit seiner SHA-256-Prüfsumme in einer Kasse der Art register und liest ihn sofort, ohne KI. Kennt die Kasse die Rolle jedes Kontos der Datei, wird jeder Kassentag ein Entwurf eines Tagesabschlusses mit sicheren Werten (status: read). Sonst wartet die Datei mit einem Vorschlag je Konto auf die Bestätigung durch den Inhaber (status: mapping, confirmRegisterFileAccounts). Einen Tag, der mit denselben Zeilen schon übernommen ist, legt bimetrics nicht noch einmal an (known). Abgelehnt wird eine Datei, die kein Buchungsstapel mit SKR03 oder SKR04 ist, nicht über ein Kassenkonto bucht (SKR03 1000 bis 1099, SKR04 1600 bis 1699), Buchungen mehrerer Kostenstellen oder Kassenkonten enthält, ein Belegdatum außerhalb ihres Zeitraums hat oder die Kennung einer anderen Kasse trägt. Ein DSFinV-K-Export (Fassung 2.x oder 3.0, ZIP mit index.xml) ergibt je Kassenabschluss einen Entwurf mit Z-Nummer; seine Kennung ist die Seriennummer der Kasse (KASSE_SERIENNR), und den ersten Export einer Kasse bestätigt der Inhaber (status: mapping, ohne Konten). Abgelehnt wird ein Export mehrerer Kassen, in fremder Währung oder einer, dessen Summen je Abschluss nicht aufgehen. Gebucht wird nichts. Hochladen dürfen Inhaber und Nutzer, nicht die Steuerberatung. 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 Kassenbuchs (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 <= 128multipart/form-data- body
file*unknownDer DATEV-Buchungsstapel des Kassensystems als CSV oder sein DSFinV-K-Export als ZIP, so wie es sie exportiert, höchstens 30 MB (entpackt 200 MB).
Erfolg.
application/json- response
Eine Kassendatei: was bimetrics aus ihr gelesen hat, die Rollen ihrer Konten und ihre Kassentage.
accounts?array<>|Die Gegenkonten der Datei mit Bezeichnung und Rolle.
balanceBeforeMinor?integerBestand vor dem ersten Tag in Cent.
batchHash?stringPrüfsumme der gemeinsam übernehmbaren Tage. Fehlt, wenn kein Tag bereit ist.
cashAccount?integerKassenkonto der Datei; 0 bei DSFinV-K.
cashBookId?stringKassenbuch der Art register.
uuidchart?stringKontenrahmen der Datei: SKR03 oder SKR04; fehlt bei DSFinV-K.
"SKR03""SKR04"confirmedAt?stringZeitpunkt, zu dem der Inhaber die Rollen der Konten bestätigt hat.
date-timeconfirmedBy?stringName des Inhabers, der die Rollen bestätigt hat.
createdAt?stringZeitpunkt des Hochladens.
date-timedays?array<>|Die Kassentage der Datei; ein Tag ohne Buchungen steht nicht darin.
fileKey?stringKennung der Kasse aus Kassensystem und Kostenstelle (KOST1), etwa „belbo · KOST1 30“; bei DSFinV-K die Seriennummer der Kasse. Berater- und Mandantennummer gehören der Steuerkanzlei und zählen nicht.
fileName?stringName der Datei beim Hochladen.
format?stringdatev: DATEV-Buchungsstapel; dsfinvk: DSFinV-K-Export.
"datev""dsfinvk"id?stringID der Kassendatei.
uuidknown?integerZahl der Tage, die mit denselben Zeilen schon übernommen sind und deshalb keinen Entwurf bekommen.
origin?stringWeg des Hochladens: web, api oder mcp.
periodFrom?Beginn des Zeitraums laut Kopf der Datei.
periodTo?Ende des Zeitraums laut Kopf der Datei.
sameFile?Dieselbe Datei wurde schon einmal hochgeladen und nicht verworfen.
sha256?stringSHA-256 der Datei; sie wird nie ersetzt.
sizeBytes?integerGröße der Datei in Byte.
status?stringmapping (die Konten warten auf ihre Rollen, beim ersten DSFinV-K-Export die Kasse auf ihre Bestätigung), read (jeder Kassentag ist ein Tagesabschluss) oder discarded (verworfen).
"mapping""read""discarded"uploadedBy?stringName der Person, die die Datei hochgeladen hat.
vendor?stringKassensystem laut Kopf der Datei, etwa belbo.
curl --fail-with-body "https://app.bimetrics.de/api/cash-books/497f6eca-6276-4993-bfeb-53cbbbba6f08/import-files" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -F "auto[]=@rechnung.pdf"{ "accounts": [ { "account": 1360, "label": "EC-Karte", "lines": 6, "proposed": true, "role": "transit" }, { "account": 1363, "label": "Kauf auf Rechnung", "lines": 1, "proposed": true, "role": "on_account" }, { "account": 1718, "label": "Behandlungspakete", "lines": 4, "proposed": true, "role": "prepaid" }, { "account": 4980, "label": "Sonstiger Betriebsbedarf", "lines": 3, "proposed": true, "role": "payout" }, { "account": 8400, "label": "Umsatzerlöse 19 %", "lines": 17, "proposed": true, "role": "revenue" } ], "balanceBeforeMinor": 0, "cashAccount": 1000, "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39", "chart": "SKR03", "createdAt": "2026-04-02T09:20:00Z", "days": [ { "cashMinor": 0, "day": { "day": 3, "month": 3, "year": 2026 }, "lines": 10, "revenueMinor": 0, "unsupported": 0 }, { "cashMinor": 0, "day": { "day": 4, "month": 3, "year": 2026 }, "lines": 11, "revenueMinor": 0, "unsupported": 0 } ], "fileKey": "belbo · KOST1 30", "fileName": "belbo-export-2026-03.csv", "format": "datev", "id": "5d1f3b7a-2c4e-4a68-8b0d-3f5a7c9e1b24", "known": 0, "origin": "web", "periodFrom": { "day": 1, "month": 3, "year": 2026 }, "periodTo": { "day": 31, "month": 3, "year": 2026 }, "sha256": "3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c1e3b5d", "sizeBytes": 18597, "status": "mapping", "uploadedBy": "Jana Kröger", "vendor": "belbo"}Kassenbuch-Einträge prüfen POST
Prüft Einträge wie `POST /api/cash-books/{id}/entries` und sagt, was sie buchen würden (`bookings`) und wie viel Geld danach in der Kasse ist, ohne etwas zu schreiben. Die Nummern heißen in der Vorschau `neu`. Benötigt einen Schlüssel mit der Berechtigung `read`.
Tagesabschlüsse eines Monats GET
Listet die Tagesabschlüsse einer Kasse für den angefragten Monat auf, dazu alle Entwürfe, die noch gelesen werden oder auf Bestätigung warten. Die neuesten stehen oben. Die Werte liefert nur `getCashImport`. Benötigt einen Schlüssel mit der Berechtigung `read`.