Entity · cost_types

Cost Type Schema

Schema-ID

cost_type

Collection

cost_types

Permissions

Lesencost_type_view
Anlegencost_type_create
Änderncost_type_edit
Löschencost_type_delete

Felder

Cost Type Schema

cost_types4 Permissions

Kostenart — klassifiziert „was für ein Aufwand/Ertrag" eine Buchung repräsentiert. Gemappt auf SKR04-Konto für DATEV-Export. Tenants starten mit ~25 MSP-Branchen-Defaults. Siehe ADR 0116a + Spec controlling-module.md.

codestringerforderlich

Eindeutiger Code innerhalb des Tenants (z.B. „PERS.GEHALT", „MAT.HARDWARE"). Großbuchstaben, Ziffern, Punkt, Bindestrich, Unterstrich.

1–50 ZeichenPatternread-only

nameobjecterforderlich

Mehrsprachiger Anzeigename (DE Pflicht, EN Pflicht).

destringerforderlich

1–200 Zeichen

enstringerforderlich

1–200 Zeichen

kindstringerforderlich

Kategorie für Aggregations-Reports (BWA-Block, Auswertung pro Kostenart-Gruppe). ERLOES = Ertrag, alle anderen = Aufwand.

Werte

PERSONALMATERIALFREMDLEISTUNGABSCHREIBUNGMIETE_LEASINGLIZENZREISEKOSTENMARKETINGSTEUERVERSICHERUNGZINSENERLOESSONSTIGES

skr04Accountstringoptional

SKR04-Kontonummer für DATEV-Export. 4-8-stellig (4 = Hauptkonto, 8 = Personenkonto). Optional nur, weil Tenants individuelle Kostenarten ohne direkten Buchungsmapping pflegen können (z.B. interne Verrechnungs-Kostenart).

Patternnullable

descriptionstringoptional

Optionale Beschreibung / Kontierungs-Hinweis.

max 2000 Zeichennullable

isActivebooleanoptional

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

Default: true

isRevenuebooleanoptional

True bei Erlös-Kostenarten (kind=ERLOES). Wird beim Posting-Generator für Soll/Haben-Logik genutzt und in der BWA als Ertrag aggregiert.

Default: false

sortOrderintegeroptional

Optionale manuelle Sortierreihenfolge. Default = nach kind, dann 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_types — Liste, paginiert + filterbar
GET /api/v1/cost_types/<id> — Einzelne Entity
POST /api/v1/cost_types — Anlegen
PATCH /api/v1/cost_types/<id> — Teil-Update
DELETE /api/v1/cost_types/<id> — Soft-Delete
GET /api/v1/cost_types/<id>/timeline — Audit + Aktivitäten