Kontoauszug übernehmen
Benötigte Berechtigung:statements:import(Kontoauszüge einlesen)
Echte Wirkung
/api/bankstatement/applyKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Übernimmt, was die Vorschau gezeigt hat: Jede neue Zeile wird zum Umsatz mit Buchung und automatischer Zuordnung, im Hintergrund. Das lässt sich nicht rückgängig machen. Ohne Vorschau mit genau diesem Konto und dieser Zuordnung aus den letzten 60 Minuten: 409 BankStatementPreviewRequired. Prüf-Fälle werden nur geschrieben, wenn includeReviewPositions sie nennt, und nur solche, die die Vorschau gezeigt hat. Unter 50 % lesbaren Zeilen oder ohne etwas zu übernehmen: 409 BankStatementNothingToApply. Beim Einlesen vergleicht bimetrics noch einmal, die Zahlen können also abweichen; getStatementImport nennt das Ergebnis. Dieselbe Datei wird nur einmal übernommen (409 BankStatementAlreadyImported).
Benötigt einen Schlüssel mit der Berechtigung statements:import.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Idempotency-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 <= 128Upload, Konto, Zuordnung der Spalten und Prüf-Fälle
application/json- body
Was übernommen werden soll: genau das der Vorschau.
account?Das Konto der Vorschau.
includeReviewPositions?array<integer>|pos der Prüf-Fälle, die trotzdem übernommen werden sollen. Nur solche, die die Vorschau gezeigt hat.
mapping?Die Zuordnung der Vorschau.
reviewPositions?array<integer>Wird mit einem Schlüssel nicht beachtet: bimetrics nimmt die gezeigten Prüf-Fälle aus der Vorschau.
uploadId?stringID des Uploads.
uuidErfolg.
application/json- response
Ein übernommener Import.
accountName?stringName des Kontos.
bankAccountId?stringID des Kontos.
uuidcanRetry?booleanDer Import lässt sich wiederholen.
createdAt?stringZeitpunkt der Übernahme.
date-timecreatedBy?stringWer übernommen hat.
errorCode?|Grund bei failed.
fileName?stringName der Datei.
finishedAt?|Ende des Imports.
date-timefrom?stringErster Buchungstag der Datei, leer vor dem Vergleich.
id?stringID des Imports.
uuidjobId?stringID des Hintergrundauftrags.
uuidprogress?Fortschritt.
result?|Das Ergebnis, sobald der Import fertig ist.
state?stringqueued, running, waiting, done oder failed.
to?stringLetzter Buchungstag der Datei.
waitReason?|Worauf der Import wartet, etwa den Bankabruf.
curl --fail-with-body "https://app.bimetrics.de/api/bankstatement/apply" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "accountName": "Girokonto", "bankAccountId": "6d3a90f2-1e74-4b8c-a5d0-93c7f2e41b68", "canRetry": false, "createdAt": "2026-11-05T09:15:00Z", "createdBy": "Hans Beispiel", "errorCode": null, "fileName": "umsaetze.csv", "finishedAt": null, "from": "2026-09-01", "id": "1b7e4f30-5c2a-4d18-9e63-7a0c2f815d44", "jobId": "c92e1d07-48b6-4f1a-8d35-2b6a9e07f3c1", "progress": { "done": 0, "total": 0 }, "result": null, "state": "queued", "to": "2026-09-30", "waitReason": null}Konten ohne Bankverbindung lesen GET
Listet die aktiven Bankkonten ohne Bankverbindung mit dem Zeitraum ihrer Umsätze und dem letzten Import. Benötigt einen Schlüssel mit der Berechtigung `read`.
Grenzen lesen GET
Sagt, ob das Einlesen eingeschaltet ist, und nennt die Grenzen für eine Datei. Benötigt einen Schlüssel mit der Berechtigung `read`.