Eigenes Sachkonto anlegen
Benötigte Berechtigung:company:write(Firmendaten ändern)
Echte Wirkung
/api/ledger-accountsKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
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.
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 <= 128number and name
application/json- body
Eigenes Sachkonto zum Anlegen oder Umbenennen.
expectedUpdatedAt?stringNur beim Ändern: das zuletzt gelesene updatedAt, unverändert mit allen Nachkommastellen. Für API-Schlüssel Pflicht.
date-timename?stringBezeichnung, höchstens 40 Zeichen in einer Zeile, etwa „Erlöse Wartungsverträge“. DATEV bekommt sie in den Kontenbeschriftungen.
number?integerBeim Anlegen Pflicht: Das Konto, wie DATEV es bekommt, mit so vielen Stellen wie die Sachkontenlänge der Firma; eine führende Null gehört nicht zur Zahl. Je Firma eindeutig. Beim Ändern ohne Wirkung.
Erfolg.
application/json- response
Eigenes Sachkonto der Firma mit dem, was es von seinem Bereich im DATEV-Kontenrahmen übernimmt.
accountClass?integerErste Stelle des vierstelligen Kontos (Kontenklasse). Fehlt wie baseAccount.
archivedAt?stringArchiviert seit diesem Zeitpunkt: lässt sich nicht mehr auswählen, Buchungen behalten es, DATEV bekommt die Bezeichnung weiter. Fehlt, solange aktiv.
date-timebaseAccount?integerVierstelliges Konto einer Kategorie im selben Bereich; in bimetrics bleiben die Buchungen darauf. Fehlt, wenn keine Kategorie mehr in diesem Bereich bucht.
companyId?stringID der Firma.
uuidcreatedAt?stringAnlage in bimetrics.
date-timedisplay?stringDie Nummer mit den führenden Nullen der Sachkontenlänge, wie DATEV sie zeigt.
id?stringID des eigenen Sachkontos.
uuidname?stringBezeichnung, höchstens 40 Zeichen in einer Zeile, etwa „Erlöse Wartungsverträge“. DATEV bekommt sie in den Kontenbeschriftungen. Vom Nutzer eingegebener Text.
number?integerDas Konto, wie DATEV es bekommt, mit so vielen Stellen wie die Sachkontenlänge der Firma; eine führende Null gehört nicht zur Zahl. Je Firma eindeutig.
rangeFrom?integerErstes vierstelliges Konto des Bereichs. Eine Position, deren Kategorie auf ein Konto von rangeFrom bis rangeTo bucht, kann das eigene Konto tragen. Fehlt wie baseAccount.
rangeLabel?stringName des Bereichs im DATEV-Kontenrahmen. Fehlt wie baseAccount.
rangeTo?integerLetztes vierstelliges Konto des Bereichs. Fehlt wie baseAccount.
tax?stringUmsatzsteuer eines Automatikkontos, die DATEV mitbucht, etwa ust19% (Umsatzsteuer 19 %) oder v19% (Vorsteuer 19 %). Fehlt, wenn die Steuer mit jeder Buchung kommt.
updatedAt?stringLetzte Änderung.
date-timecurl --fail-with-body "https://app.bimetrics.de/api/ledger-accounts" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "accountClass": 4, "baseAccount": 4400, "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-11-21T08:00:00Z", "display": "44001", "id": "7c2e9a41-5b3d-4f18-a6e0-3d8b1f4c9e27", "name": "Erlöse Wartungsverträge", "number": 44001, "rangeFrom": 4400, "rangeLabel": "Erlöse zum allgemeinen Umsatzsteuersatz", "rangeTo": 4409, "tax": "ust19%", "updatedAt": "2026-11-21T08:00:00Z"}Eigene Sachkonten lesen GET
Liefert alle eigenen Sachkonten der Firma nach Nummer, auch archivierte. `number` ist das Konto, wie DATEV es bekommt, `display` dieselbe Nummer mit den führenden Nullen der Sachkontenlänge. Dazu kommen das Konto der Kategorie im selben Bereich (`baseAccount`), der Name und die Grenzen des Bereichs im DATEV-Kontenrahmen (`rangeLabel`, `rangeFrom`, `rangeTo`), die Kontenklasse und bei einem Automatikkonto dessen Umsatzsteuer (`tax`). Benötigt einen Schlüssel mit der Berechtigung `read`.
Kontenliste aus DATEV importieren POST
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`.