bimetricsEntwickler
Kassenbuch

Bargeld in die Kasse prüfen

Als Markdown ansehen

Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)

Echte Wirkung

Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
get/api/banktransaction/{id}/cash-in-preview

Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.

Eine Barabhebung kommt in einem Schritt ins Kassenbuch: Ein Eintrag transit_in bucht Kasse an Geldtransit (1360 in SKR03, 1460 in SKR04), und der Bankumsatz wird ihm als cash_transit zugeordnet, also Geldtransit an Bank. Beides gelingt zusammen oder gar nicht. Es geht nur ein gebuchter, noch nicht zugeordneter Abgang in Euro. Der Kassentag liegt höchstens 7 Tage vom Buchungstag entfernt, nicht vor dem Beginn der Kasse und in einem offenen Monat. Eine Kasse mit Kassensystem nimmt keine Handbuchung, ihr Bargeld kommt über den Z-Bon. Buchen dürfen Inhaber und Nutzer, nicht die Steuerberatung. Rückgängig macht man es wie bisher: Zuordnung mit DELETE /api/match/{id} lösen, dann den Eintrag mit POST /api/cash-book-entries/{id}/reverse stornieren. Die Vorschau führt die Buchung probeweise aus und nimmt sie zurück. Sie lehnt deshalb ab, was auch das Buchen ablehnt, mit context.message als Satz der App. Sie nennt Kassentag und passende Tage (firstDate, lastDate), den Bestand vorher und nachher, beide Buchungen mit Soll und Haben, die schon an DATEV exportierten Monate (exportedMonths, die Buchungen gehen dann als Nachtrag mit dem nächsten Export des Monats) und den planHash. waiting nennt Einträge Bank ↔ Kasse mit diesem Betrag, die schon auf den Umsatz warten. Statt neu zu buchen, ordnest du einen davon mit POST /api/cash-book-entries/{id}/bank-transaction zu.

Benötigt einen Schlüssel mit der Berechtigung matching:write.

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 Bankumsatzes der Abhebung (UUID).

Formatuuid

Query-Parameter

cashBookId*string

ID des Kassenbuchs (UUID).

entryDate?string

Kassentag als JJJJ-MM-TT. Ohne ihn nimmt die Vorschau den Buchungstag, ist dessen Monat abgeschlossen, heute, sonst den ersten passenden Tag.

Antworten

Erfolg.

application/json
  1. response

Bargeld in die Kasse: Vorschau oder Buchung.

balanceAfterMinor?integer

Bestand der Kasse danach in Cent.

balanceBeforeMinor?integer

Bestand der Kasse vorher in Cent; bei replayed der von jetzt abzüglich des Betrags.

bookings?array<>|

Geldtransit an Bank am Tag der Wertstellung, Kasse an Geldtransit am Kassentag.

cashBookId?string

ID des Kassenbuchs (UUID).

Formatuuid
cashBookName?string

Name des Kassenbuchs.

entry?

Der Eintrag transit_in; in der Vorschau heißt seine Nummer neu.

entryDate?

Der Kassentag.

exportedMonths?array<string>|

Monate (JJJJ-MM) dieser Buchungen, die DATEV schon hat.

firstDate?

Erster passender Kassentag.

lastDate?

Letzter passender Kassentag, höchstens heute.

matchId?string

Nach dem Buchen: die Zuordnung cash_transit.

Formatuuid
planHash?string

SHA-256 der Vorschau.

replayed?boolean

Wiederholung mit demselben Idempotency-Key.

transaction?

Die Abhebung.

waiting?array<>|

Offene Einträge mit diesem Betrag, die schon auf den Umsatz warten.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/banktransaction/497f6eca-6276-4993-bfeb-53cbbbba6f08/cash-in-preview?cashBookId=string" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "balanceAfterMinor": 42000,  "balanceBeforeMinor": 12000,  "bookings": [    {      "amountMinor": 30000,      "bookingDate": {        "day": 12,        "month": 11,        "year": 2026      },      "creditAccount": 1801,      "creditName": "Geschäftskonto",      "debitAccount": 1460,      "debitName": "Geldtransit",      "text": "Bargeldauszahlung Geldautomat"    },    {      "amountMinor": 30000,      "bookingDate": {        "day": 12,        "month": 11,        "year": 2026      },      "creditAccount": 1460,      "creditName": "Geldtransit",      "debitAccount": 1600,      "debitName": "Handkasse",      "text": "Geld vom Geschäftskonto"    }  ],  "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39",  "cashBookName": "Handkasse",  "entry": {    "amountMinor": 30000,    "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39",    "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5",    "createdAt": "2026-11-13T09:05:00Z",    "entryDate": {      "day": 12,      "month": 11,      "year": 2026    },    "id": "3f1d2c7a-8b9e-4a51-b6c2-0e4f8a9d7b13",    "kind": "transit_in",    "number": "neu",    "origin": "api",    "text": "Geld vom Geschäftskonto",    "updatedAt": "2026-11-13T09:05:00Z",    "year": 2026  },  "entryDate": {    "day": 12,    "month": 11,    "year": 2026  },  "exportedMonths": [],  "firstDate": {    "day": 5,    "month": 11,    "year": 2026  },  "lastDate": {    "day": 19,    "month": 11,    "year": 2026  },  "planHash": "abababababababababababababababababababababababababababababababab",  "transaction": {    "accountName": "Geschäftskonto",    "amountMinor": -30000,    "bookingDate": {      "day": 12,      "month": 11,      "year": 2026    },    "id": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033",    "text": "Bargeldauszahlung Geldautomat"  },  "waiting": []}

Bargeld in die Kasse buchen POST

Eine Barabhebung kommt in einem Schritt ins Kassenbuch: Ein Eintrag `transit_in` bucht Kasse an Geldtransit (1360 in SKR03, 1460 in SKR04), und der Bankumsatz wird ihm als `cash_transit` zugeordnet, also Geldtransit an Bank. Beides gelingt zusammen oder gar nicht. Es geht nur ein gebuchter, noch nicht zugeordneter Abgang in Euro. Der Kassentag liegt höchstens 7 Tage vom Buchungstag entfernt, nicht vor dem Beginn der Kasse und in einem offenen Monat. Eine Kasse mit Kassensystem nimmt keine Handbuchung, ihr Bargeld kommt über den Z-Bon. Buchen dürfen Inhaber und Nutzer, nicht die Steuerberatung. Rückgängig macht man es wie bisher: Zuordnung mit `DELETE /api/match/{id}` lösen, dann den Eintrag mit `POST /api/cash-book-entries/{id}/reverse` stornieren. Sende `cashBookId`, `entryDate`, `expectedBalanceMinor` und `planHash` aus der bestätigten Vorschau. Hat sich seitdem etwas geändert, antwortet die Route mit `409 CashBookRejected`. Dann die Vorschau neu holen und bestätigen lassen. Die Antwort nennt Eintrag samt Nummer, Zuordnung (`matchId`) und Buchungen. Bei einer Wiederholung schickst du denselben Idempotency-Key, die Antwort trägt dann `replayed` und den Bestand von jetzt. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.

Bankumsatz einer Buchung Bank ↔ Kasse zuordnen POST

Ordnet einem Eintrag zwischen Geschäftskonto und Kasse seinen Bankumsatz zu, als Zuordnung der Art `cash_transit` („Geldtransit Kasse“). Der Bankumsatz bucht dann gegen Geldtransit (1360 in SKR03, 1460 in SKR04), wo der Eintrag die Kassenseite gebucht hat; zusammen steht Geldtransit auf null. Der Umsatz braucht den Gegenbetrag des Eintrags, jeder Eintrag hat höchstens einen; ein stornierter Eintrag nimmt keinen. Es gelten die Sperren jeder Zuordnung. Lösen geht wie bei jeder Zuordnung mit `DELETE /api/match/{id}`, danach fehlt der Bankumsatz am Eintrag wieder. Buchen 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`.