API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · cost_centers

Cost Center Schema

Schema-ID
cost_center
Collection
cost_centers
Permissions
  • Lesencost_center_view
  • Anlegencost_center_create
  • Änderncost_center_edit
  • Löschencost_center_delete

Felder

Cost Center Schema

cost_centers4 Permissions

Kostenstelle (CC) — hierarchische Organisationseinheit für Controlling. Trägt Verantwortung für Budget und Aufwand. Wird von Position/OU vererbt und kann an Atom-Records (time_record, invoice_in_line, asset, ...) explizit gesetzt werden. Siehe ADR 0116a + Spec controlling-module.md.

codestringerforderlich

Eindeutiger Code innerhalb des Tenants (z.B. „K-100", „SERV.STD", „GF"). Großbuchstaben, Ziffern, Punkt, Bindestrich, Unterstrich.

1–50 ZeichenPatternread-only
namestringerforderlich

Anzeigename der Kostenstelle.

1–200 Zeichen
descriptionstringoptional

Optionale Beschreibung / Verantwortungsbereich.

max 2000 Zeichennullable
parentCostCenterIduuidoptional

Eltern-Kostenstelle für hierarchische Struktur (Holding → Bereich → Abteilung → Team). NULL = Top-Level. Reports rollen automatisch hoch.

nullable
ownerUserIduuidoptional

Verantwortliche/r für diese Kostenstelle. Sieht in seinem Dashboard Budget vs. Ist und bekommt Frühwarnungen bei Abweichung.

nullable
isActivebooleanoptional

Inaktive Kostenstellen können nicht mehr neu zugeordnet werden, bleiben aber für historische Buchungen erhalten.

Default: true
validFromdateoptional

Erster Tag, ab dem die Kostenstelle gültig ist.

nullable
validTodateoptional

Letzter Tag der Gültigkeit. NULL = unbegrenzt.

nullable
defaultBudgetEURnumberoptional

Optionales Standard-Jahresbudget als Anker. Granulares Budget pro Monat × Kostenart wird in budget_line gepflegt (siehe ADR 0116a).

≥ 0nullable
sortOrderintegeroptional

Optionale manuelle Sortierreihenfolge innerhalb der Hierarchie-Ebene. Default = alphabetisch nach Code.

nullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/cost_centers — Liste, paginiert + filterbar
  • GET /api/v1/cost_centers/<id> — Einzelne Entity
  • POST /api/v1/cost_centers — Anlegen
  • PATCH /api/v1/cost_centers/<id> — Teil-Update
  • DELETE /api/v1/cost_centers/<id> — Soft-Delete
  • GET /api/v1/cost_centers/<id>/timeline — Audit + Aktivitäten

Suche