Eigenes Sachkonto archivieren
Benötigte Berechtigung:company:write(Firmendaten ändern)
Echte Wirkung
/api/ledger-accounts/{id}/archiveKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID des eigenen Sachkontos (UUID).
uuidIdempotency-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 <= 128Erfolg.
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/497f6eca-6276-4993-bfeb-53cbbbba6f08/archive" -X POST \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001"{ "accountClass": 4, "archivedAt": "2026-11-21T10:00:00Z", "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-21T10:00:00Z"}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`.
Eigenes Sachkonto zurückholen POST
Holt ein archiviertes eigenes Sachkonto zurück, es lässt sich danach wieder auswählen. Ist es nicht archiviert, ändert sich nichts. Benötigt einen Schlüssel mit der Berechtigung `company:write`.