bimetricsEntwickler
Kassenbuch

Tagesabschlüsse eines Monats

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

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

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.

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 Kassenbuchs (UUID).

Formatuuid

Query-Parameter

month*string

Monat als JJJJ-MM, etwa 2026-11.

Antworten

Erfolg.

application/json
  1. response

Tagesabschlüsse eines Monats und offene Entwürfe.

files?array<>

Offene Kassendateien mit ihrem Stand, neueste zuerst und unabhängig von ihrem Zeitraum: die aus openFiles, hier mit Zeitraum und Stand, und bestätigte mit Tagen, die noch zu übernehmen sind. Fehlt, wenn keine offen ist.

items?array<>|

Neueste zuerst, ohne values.

openFiles?array<>

Kassendateien, deren Konten (bei DSFinV-K die Kasse) auf die Bestätigung durch den Inhaber warten, neueste zuerst und unabhängig von ihrem Zeitraum. Sie haben noch keinen Tagesabschluss und halten den Monatsabschluss an. Fehlt, wenn keine wartet.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/cash-books/497f6eca-6276-4993-bfeb-53cbbbba6f08/imports?month=string" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "items": [    {      "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39",      "createdAt": "2026-11-12T19:10:00Z",      "fileName": "z-bon-1187.jpg",      "fileType": "photo",      "id": "4a8c2e6f-1b3d-4f57-9a0c-2e4f6a8b0c13",      "origin": "web",      "sha256": "9f2c4e6a8b0d1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a",      "sizeBytes": 812345,      "source": "zbon",      "status": "reading",      "unsure": 0,      "uploadedBy": "Jana Kröger"    }  ]}

Kassendatei hochladen POST

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

Z-Bon hochladen POST

Speichert den Z-Bon eines Kassensystems unverändert und mit seiner SHA-256-Prüfsumme in einer Kasse der Art `register`. Im Hintergrund liest bimetrics ihn dann: erst den Text, dann die Werte, jeden mit der Textstelle, aus der er stammt. Die Antwort kommt mit `status: reading`; `getCashImport` liefert die Werte, sobald `status` `read` ist, meist nach 10 bis 30 Sekunden. Gebucht wird noch 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`.