Kassendatei verwerfen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/cash-import-files/{id}/discardKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Verwirft die Datei und ihre offenen Tagesentwürfe. Das Original und das Protokoll bleiben erhalten. Sobald ein Kassentag aus der Datei gebucht wurde, ist das Verwerfen gesperrt. Inhaber und Nutzer dürfen verwerfen. Verwende bei einer Wiederholung 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 der Kassendatei (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 <= 128Erfolg.
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-import-files/497f6eca-6276-4993-bfeb-53cbbbba6f08/discard" -X POST \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001"{ "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": "discarded", "uploadedBy": "Jana Kröger", "vendor": "belbo"}Kassentage übernehmen POST
Übernimmt die in der Dateivorschau als bereit markierten Kassentage in Datumsfolge bis zum ersten Halt. Inhaber und Nutzer bestätigen mit `batchHash` und `expectedBalanceMinor` aus der Vorschau. Eine Änderung erfordert eine neue Vorschau. Für eine Wiederholung gilt derselbe Idempotency-Key. Ein übernommener Tag lässt sich nur als Ganzes stornieren. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.
Tagesabschluss abrufen GET
Liefert den Stand des Tagesabschlusses und, sobald der Z-Bon gelesen ist, seine Werte: Z-Nummer, Tag, Umsatz je Steuersatz, Zahlarten, Trinkgeld, Gutscheine, Bargeldbewegungen, Differenz und Kassenbestand. Zu jedem Wert gehören die Textstelle (`quote`) und die Angabe, ob er sicher ist (`sure`). Sicher ist ein Betrag nur, wenn er rechnerisch zu einer Summe auf dem Z-Bon passt. Z-Nummer, Tag und Kassen-ID sind nur sicher, wenn sie aus der Textschicht eines PDFs stammen; die Kennzeichnung als Korrektur (`correction`) kann es auch bei einem Foto sein. Die Art einer Bewegung ist nur sicher, wenn der Z-Bon sie eindeutig nennt. `unsure` zählt die Werte und Arten, die der Nutzer noch bestätigen muss. `readFailure` nennt bei `status: failed` den Grund: `unreadable`, `no_z_number`, `not_a_z_bon` oder `unavailable`. Benötigt einen Schlüssel mit der Berechtigung `read`.