Kontenliste aus DATEV importieren
Benötigte Berechtigung:company:write(Firmendaten ändern)
Echte Wirkung
/api/ledger-accounts/importKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Nimmt die Kontenliste der Kanzlei als UTF-8-Text: die Kontenbeschriftungen aus DATEV (EXTF, Kategorie 20) oder Zeilen Konto;Kontobeschriftung, eine erste Zeile mit Spaltennamen ist erlaubt. Eine DATEV-Datei muss die Sachkontenlänge der Firma haben, sonst wird nichts importiert. Jede Zeile läuft durch die Regeln von POST /api/ledger-accounts: Die Nummer hat genau so viele Stellen wie die Sachkontenlänge der Firma (4 bis 8, in den DATEV-Einstellungen der App). Ihre ersten vier Stellen sind ein Erlös- oder Aufwandskonto im Bereich eines Kontos, auf das eine Kategorie bucht. Über vier Stellen sind die angehängten Stellen nie alle 0, denn dann wäre es das Standardkonto selbst: Bei Länge 5 ist 44000 das Konto 4400, 44001 ein eigenes. Bei Länge 4 ist es ein freies Konto des Bereichs, auf das keine Kategorie bucht. Nummern, die die Firma schon hat, bleiben unverändert (exists), Zeilen gegen die Regeln überspringt der Import mit Grund (skipped), etwa die Standardkonten einer DATEV-Datei; alle anderen legt er in einem Schritt an (created). Mit dryRun meldet er nur, was geschehen würde. Bei einer Wiederholung schickst du denselben Idempotency-Key.
Benötigt einen Schlüssel mit der Berechtigung company:write.
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 <= 128account list and dryRun
application/json- body
Kontenliste der Kanzlei zum Import.
csv?stringDie Liste als Text: Kontenbeschriftungen aus DATEV oder Zeilen Konto;Kontobeschriftung, Trenner Semikolon, Felder dürfen in Anführungszeichen stehen. Höchstens 2000 Konten.
dryRun?booleantrue: nur prüfen und melden, nichts anlegen.
Erfolg.
application/json- response
Ergebnis des Imports je Zeile.
created?integerAngelegt (bei dryRun: anzulegen).
exists?integerSchon vorhanden, unverändert.
rows?array<>|Die gelesenen Zeilen der Liste.
skipped?integerÜbersprungen.
curl --fail-with-body "https://app.bimetrics.de/api/ledger-accounts/import" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "created": 1, "exists": 0, "rows": [ { "line": 3, "name": "Erlöse Wartungsverträge", "number": 44001, "status": "created" }, { "line": 4, "message": "44000 ist ein Standardkonto aus dem DATEV-Kontenrahmen. Nimm eine eigene Nummer darunter, zum Beispiel 44001.", "name": "Erlöse 19 %", "number": 44000, "status": "skipped" } ], "skipped": 1}Eigenes Sachkonto anlegen POST
Legt ein eigenes Sachkonto mit Nummer und Bezeichnung an. Die Nummer hat genau so viele Stellen wie die Sachkontenlänge der Firma (4 bis 8, in den DATEV-Einstellungen der App). Ihre ersten vier Stellen sind ein Erlös- oder Aufwandskonto im Bereich eines Kontos, auf das eine Kategorie bucht. Über vier Stellen sind die angehängten Stellen nie alle 0, denn dann wäre es das Standardkonto selbst: Bei Länge 5 ist 44000 das Konto 4400, 44001 ein eigenes. Bei Länge 4 ist es ein freies Konto des Bereichs, auf das keine Kategorie bucht. Die Nummer steht danach fest, sie ist je Firma eindeutig, auch gegenüber archivierten. Die Bezeichnung geht mit dem nächsten DATEV-Export an DATEV. Verstößt die Anfrage gegen eine Regel, antwortet die Route mit `400 LedgerAccountRejected`, `context.field` nennt das Feld und `context.message` den Satz der App; eine vergebene Nummer ergibt `409 LedgerAccountRejected`. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `company:write`.
Eigenes Sachkonto umbenennen PUT
Ändert die Bezeichnung eines eigenen Sachkontos; DATEV bekommt sie mit dem nächsten Export. Die Nummer steht fest; `number` wird hier ignoriert, weil Buchungen und exportierte Monate sie tragen. Für eine andere Nummer legst du ein neues Konto an und archivierst das alte. `expectedUpdatedAt` ist das gelesene `updatedAt`; hat sich das Konto seitdem geändert, antwortet die Route mit `409 VersionConflict` und ändert nichts. Eine ID einer anderen Firma ergibt `404 LedgerAccountNotFound`. Benötigt einen Schlüssel mit der Berechtigung `company:write`.