bimetricsEntwickler
Eigene Sachkonten

Eigenes Sachkonto umbenennen

Als Markdown ansehen

Benötigte Berechtigung:company:write(Firmendaten ändern)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
put/api/ledger-accounts/{id}

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

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

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 eigenen Sachkontos (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

Request-Body

name; expectedUpdatedAt from the last read

application/json
  1. body

Eigenes Sachkonto zum Anlegen oder Umbenennen.

expectedUpdatedAt?string

Nur beim Ändern: das zuletzt gelesene updatedAt, unverändert mit allen Nachkommastellen. Für API-Schlüssel Pflicht.

Formatdate-time
name?string

Bezeichnung, höchstens 40 Zeichen in einer Zeile, etwa „Erlöse Wartungsverträge“. DATEV bekommt sie in den Kontenbeschriftungen.

number?integer

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

Antworten

Erfolg.

application/json
  1. response

Eigenes Sachkonto der Firma mit dem, was es von seinem Bereich im DATEV-Kontenrahmen übernimmt.

accountClass?integer

Erste Stelle des vierstelligen Kontos (Kontenklasse). Fehlt wie baseAccount.

archivedAt?string

Archiviert seit diesem Zeitpunkt: lässt sich nicht mehr auswählen, Buchungen behalten es, DATEV bekommt die Bezeichnung weiter. Fehlt, solange aktiv.

Formatdate-time
baseAccount?integer

Vierstelliges Konto einer Kategorie im selben Bereich; in bimetrics bleiben die Buchungen darauf. Fehlt, wenn keine Kategorie mehr in diesem Bereich bucht.

companyId?string

ID der Firma.

Formatuuid
createdAt?string

Anlage in bimetrics.

Formatdate-time
display?string

Die Nummer mit den führenden Nullen der Sachkontenlänge, wie DATEV sie zeigt.

id?string

ID des eigenen Sachkontos.

Formatuuid
name?string

Bezeichnung, höchstens 40 Zeichen in einer Zeile, etwa „Erlöse Wartungsverträge“. DATEV bekommt sie in den Kontenbeschriftungen. Vom Nutzer eingegebener Text.

number?integer

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.

rangeFrom?integer

Erstes 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?string

Name des Bereichs im DATEV-Kontenrahmen. Fehlt wie baseAccount.

rangeTo?integer

Letztes vierstelliges Konto des Bereichs. Fehlt wie baseAccount.

tax?string

Umsatzsteuer eines Automatikkontos, die DATEV mitbucht, etwa ust19% (Umsatzsteuer 19 %) oder v19% (Vorsteuer 19 %). Fehlt, wenn die Steuer mit jeder Buchung kommt.

updatedAt?string

Letzte Änderung.

Formatdate-time
Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/ledger-accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "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 Wartung und Service",  "number": 44001,  "rangeFrom": 4400,  "rangeLabel": "Erlöse zum allgemeinen Umsatzsteuersatz",  "rangeTo": 4409,  "tax": "ust19%",  "updatedAt": "2026-11-21T09:30:00Z"}

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

Eigenes Sachkonto archivieren POST

Archiviert ein eigenes Sachkonto: Es lässt sich nicht mehr auswählen, Buchungen behalten es, und DATEV bekommt seine Bezeichnung weiter. Gelöscht wird es nie. Ist es schon archiviert, ändert sich nichts. Benötigt einen Schlüssel mit der Berechtigung `company:write`.