bimetricsEntwickler
Kontoauszüge

Import wiederholen

Als Markdown ansehen

Benötigte Berechtigung:statements:import(Kontoauszüge einlesen)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
post/api/bankstatement/imports/{id}/retry

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

Startet einen fehlgeschlagenen Import neu, mit derselben Datei, demselben Konto und derselben Zuordnung, wie „Erneut versuchen“ in der App. Geschriebene Zeilen entstehen nicht doppelt. Einen laufenden Import lässt die Route, wie er ist.

Benötigt einen Schlüssel mit der Berechtigung statements:import.

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

Formatuuid

Header-Parameter

Idempotency-Key*string

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

Muster^[!-~]+$
Länge1 <= length <= 128

Antworten

Erfolg.

application/json
  1. response

Ein übernommener Import.

accountName?string

Name des Kontos.

bankAccountId?string

ID des Kontos.

Formatuuid
canRetry?boolean

Der Import lässt sich wiederholen.

createdAt?string

Zeitpunkt der Übernahme.

Formatdate-time
createdBy?string

Wer übernommen hat.

errorCode?|

Grund bei failed.

fileName?string

Name der Datei.

finishedAt?|

Ende des Imports.

Formatdate-time
from?string

Erster Buchungstag der Datei, leer vor dem Vergleich.

id?string

ID des Imports.

Formatuuid
jobId?string

ID des Hintergrundauftrags.

Formatuuid
progress?

Fortschritt.

result?|

Das Ergebnis, sobald der Import fertig ist.

state?string

queued, running, waiting, done oder failed.

to?string

Letzter Buchungstag der Datei.

waitReason?|

Worauf der Import wartet, etwa den Bankabruf.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/bankstatement/imports/497f6eca-6276-4993-bfeb-53cbbbba6f08/retry" -X POST \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001"
Beispielantwort
{  "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}

Originaldatei eines Imports laden GET

Liefert die Datei eines übernommenen Imports Byte für Byte. Benötigt einen Schlüssel mit der Berechtigung `read`.

Kontoauszug ansehen POST

Liest den Anfang der Datei und schlägt Spalten (`mapping`), Format und Zielkonto vor, mit bis zu 20 Zeilen, wie bimetrics sie liest. Es wird nichts gespeichert. Mit `mapping` im Anfrageinhalt liest die Route die Zeilen mit dieser Zuordnung. Benötigt einen Schlüssel mit der Berechtigung `statements:import`.