bimetricsEntwickler
Kostenstellen

Kostenstelle oder Verteilung zurückholen

Als Markdown ansehen

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

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
post/api/cost-centers/{id}/unarchive

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

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.

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 der Kostenstelle oder Verteilung (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

Antworten

Erfolg.

application/json
  1. response

Kostenstelle oder Verteilung der Firma.

archivedAt?string

Archiviert seit diesem Zeitpunkt: lässt sich nicht mehr auswählen, Belege behalten sie. Fehlt, solange aktiv.

Formatdate-time
code?string

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

ID der Firma.

Formatuuid
createdAt?string

Anlage in bimetrics.

Formatdate-time
documents?integer

Zahl der Belege, die sie tragen, ohne gelöschte.

id?string

ID der Kostenstelle oder Verteilung.

Formatuuid
kind?string

center für eine Kostenstelle, distribution für eine Verteilung.

Wert in"center""distribution"
name?string

Name, 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?string

Letzte Änderung.

Formatdate-time
used?boolean

true, 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.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/cost-centers/497f6eca-6276-4993-bfeb-53cbbbba6f08/unarchive" -X POST \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001"
Beispielantwort
{  "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:05:00Z",  "used": true}

Kostenstelle oder Verteilung archivieren POST

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

Firma lesen GET

Liefert Name, Kontenrahmen, Buchführungswährung, Versteuerung, die Art der Umsätze und die Nummernkreise von Rechnungen und Angeboten, dazu die Rechtsform und die Stammdaten, die auf jeder Rechnung stehen: Geschäftsführung, Handelsregister, Anschrift, USt-IdNr. und Steuernummer. Leere Angaben fehlen. Diese Angaben liest auch `get_company_context` über MCP. Unter `settings` stehen die Firmendaten so, wie `PATCH /api/company/` sie nimmt, mit ihrer `version`. Benötigt einen Schlüssel mit der Berechtigung `read`.