Kostenstelle oder Verteilung archivieren
Benötigte Berechtigung:company:write(Firmendaten ändern)
Echte Wirkung
/api/cost-centers/{id}/archiveKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Archiviert eine Kostenstelle oder Verteilung: Sie lässt sich nicht mehr auswählen, Belege und Buchungen behalten sie, auch im DATEV-Export. Gelöscht wird sie nie. Eine Kostenstelle, die noch zu einer aktiven Verteilung gehört, archivierst du erst nach dieser Verteilung, sonst 409 CostCenterRejected. Ist sie 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 der Kostenstelle oder Verteilung (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
Kostenstelle oder Verteilung der Firma.
archivedAt?stringArchiviert seit diesem Zeitpunkt: lässt sich nicht mehr auswählen, Belege behalten sie. Fehlt, solange aktiv.
date-timecode?stringNur bei einer Kostenstelle: die KOST1 im DATEV-Export, 1 bis 8 Ziffern ohne führende Null oder 1 bis 8 Buchstaben ohne Umlaute, je Firma eindeutig. Fehlt bei einer Verteilung.
companyId?stringID der Firma.
uuidcreatedAt?stringAnlage in bimetrics.
date-timedocuments?integerZahl der Belege, die sie tragen, ohne gelöschte.
id?stringID der Kostenstelle oder Verteilung.
uuidkind?stringcenter für eine Kostenstelle, distribution für eine Verteilung.
"center""distribution"name?stringName, höchstens 60 Zeichen, etwa „Standort Nord“.
shares?array<>Nur bei einer Verteilung: die Kostenstellen mit ihren Anteilen, zusammen 10000 Basispunkte. Fehlt bei einer Kostenstelle.
updatedAt?stringLetzte Änderung.
date-timeused?booleantrue, sobald ein Beleg oder eine Buchung sie trägt, auch über eine Verteilung oder bei einem gelöschten Beleg mit Buchungen. Dann stehen Nummer und Anteile fest.
curl --fail-with-body "https://app.bimetrics.de/api/cost-centers/497f6eca-6276-4993-bfeb-53cbbbba6f08/archive" -X POST \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001"{ "archivedAt": "2026-11-12T10:00:00Z", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-11-12T08:05:00Z", "documents": 3, "id": "0e7d4b29-81c5-4f3a-9b6e-d2a8f5c17e94", "kind": "distribution", "name": "Gemeinsam", "shares": [ { "basisPoints": 5000, "costCenterId": "5b0f8c3e-2a71-4d9e-8f16-7c4a9e2d3b58" }, { "basisPoints": 5000, "costCenterId": "c93e1a47-6d02-4b8f-a5e3-1f7b2c9d4e60" } ], "updatedAt": "2026-11-12T10:00:00Z", "used": true}Kostenstelle oder Verteilung ändern PUT
Ersetzt Name und Nummer einer Kostenstelle bzw. Name und Anteile einer Verteilung; `kind` bleibt, wie es ist. Schick deshalb immer alle Werte, auch die unveränderten. Den Namen kannst du jederzeit ändern. Nummer und Anteile stehen fest, sobald ein Beleg oder eine Buchung die Kostenstelle oder Verteilung trägt (`used`), damit ein erneuter Export alter Monate dieselben Zeilen ergibt. Eine Änderung daran lehnt die Route mit `409 CostCenterRejected` ab. Für andere Anteile legst du eine neue Verteilung an und archivierst die alte. `expectedUpdatedAt` ist das gelesene `updatedAt`; hat sich der Eintrag seitdem geändert, antwortet die Route mit `409 VersionConflict` und ändert nichts. Eine ID einer anderen Firma ergibt `404 CostCenterNotFound`. Benötigt einen Schlüssel mit der Berechtigung `company:write`.
Kostenstelle oder Verteilung zurückholen POST
Holt eine archivierte Kostenstelle oder Verteilung zurück, sie lässt sich danach wieder auswählen. Eine Verteilung geht nur zurück, solange ihre Kostenstellen nicht archiviert sind, sonst `400 CostCenterRejected`. Benötigt einen Schlüssel mit der Berechtigung `company:write`.