Bankumsatz einer Buchung Bank ↔ Kasse zuordnen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/cash-book-entries/{id}/bank-transactionKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID des Eintrags (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 <= 128the bank transaction
application/json- body
Bankumsatz eines Eintrags Bank ↔ Kasse.
transactionId?stringPflicht: ID des Bankumsatzes mit dem Gegenbetrag des Eintrags.
uuidErfolg.
application/json- response
Zugeordneter Bankumsatz eines Eintrags.
entryId?stringID des Eintrags.
uuidmatchId?stringID der Zuordnung cash_transit; mit DELETE /api/match/{id} gelöst.
uuidreplayed?booleantrue bei einer Wiederholung.
transactionId?stringID des Bankumsatzes.
uuidcurl --fail-with-body "https://app.bimetrics.de/api/cash-book-entries/497f6eca-6276-4993-bfeb-53cbbbba6f08/bank-transaction" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "entryId": "3f1d2c7a-8b9e-4a51-b6c2-0e4f8a9d7b13", "matchId": "5b7d9f1e-2a4c-4e6b-8d0f-1a3c5e7b9d24", "transactionId": "8c1e4b2a-6f3d-4e7a-9b15-2d4c6e8f0a13"}Kontoauszug hochladen POST
Speichert eine Datei der Bank, gelesen und gebucht wird noch nichts. Eine Datei, die bimetrics nicht lesen kann, wird mit dem Grund abgelehnt (`422`), zu große mit `413 BankStatementTooLarge`. Dieselbe Datei, noch nicht übernommen, ergibt denselben Upload und keine neue Zeile. `sameFile` nennt einen Import, der diese Datei schon übernommen hat. Nicht übernommene Dateien löscht bimetrics nicht von selbst. Benötigt einen Schlüssel mit der Berechtigung `statements:import`.
Passende Bankumsätze zu Bank ↔ Kasse GET
Liefert zu einem Eintrag zwischen Geschäftskonto und Kasse (`transit_in`, `transit_out` oder Anfangsbestand vom Geschäftskonto) die Bankumsätze, die dazu passen: Gegenbetrag (zu 300 € in die Kasse eine Abhebung über −300 €), gebucht bis sieben Tage vor oder nach dem Kassentag (beim Anfangsbestand bis 60 Tage vor dem Beginn), auch schon anders zugeordnete mit `assigned`. Höchstens 10, freie zuerst, dann der nächste Tag. Benötigt einen Schlüssel mit der Berechtigung `read`.