bimetricsEntwickler
Kontoauszüge

Nicht gelesene Zeilen laden

Als Markdown ansehen

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

Echte Wirkung

Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
post/api/bankstatement/unread

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

Liefert die Zeilen, die bimetrics mit dieser Zuordnung nicht lesen kann, im Original, davor Zeile und Grund; bei CAMT und MT940 nur Zeile und Grund. Die ersten 50 mit Grund stehen auch in unreadSample der Vorschau.

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.

Antworten

Die nicht gelesenen Zeilen als CSV.

response?unknowntext/csv
Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/bankstatement/unread" -X POST \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
null

Vorschau eines Kontoauszugs POST

Liest die ganze Datei und vergleicht sie mit den Umsätzen des Kontos, ohne etwas zu buchen: neu, schon da, zu prüfen (`review`) oder vorgemerkt, nicht gelesene Zeilen, Salden, DATEV-Hinweise und Warnungen. bimetrics merkt sich diese Vorschau 60 Minuten für `applyStatement`, mit genau diesem Konto und dieser Zuordnung. Liest gerade eine andere Vorschau: `409 BankStatementBusy`, in einer Minute erneut. Benötigt einen Schlüssel mit der Berechtigung `statements:import`.

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