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

Collective Agreement Schema

Schema-ID
collective_agreement
Collection
collective_agreements
Permissions
  • Lesencollective_agreement_view
  • Anlegencollective_agreement_manage
  • Änderncollective_agreement_manage
  • Löschencollective_agreement_manage

Felder

Collective Agreement Schema

collective_agreements4 Permissions

Schema for validating collective agreement (Tarifvertrag) entities

namestringerforderlich

Name des Tarifvertrags (z. B. "IG Metall NRW 2025")

1–200 Zeichen
organizationstringerforderlich

Tarifpartner (Gewerkschaft/Arbeitgeberverband), z. B. "IG Metall"

1–200 Zeichen
validFromstringerforderlich

ISO 8601 Beginn der Gültigkeit

Pattern
validTostringerforderlich

ISO 8601 Ende; "9999-12-31" = unbefristet (Sentinel)

Pattern
overridesobjectoptional

Tarif-Overrides gegenüber Model und gesetzlichen Defaults. Nicht gesetzte Felder = Fallback auf Model/ArbZG.

nullable
maxDailyHoursnumberoptional

Tarifliche Tageshöchstarbeitszeit (darf ArbZG § 3 nicht überschreiten)

0 – 10
maxWeeklyHoursAveragednumberoptional

Tarifliche Wochenhöchstarbeitszeit im Durchschnitt (darf ArbZG § 3 nicht überschreiten)

0 – 48
averagingPeriodMonthsnumberoptional

Ausgleichszeitraum für Wochenhöchstarbeitszeit (ArbZG: 6 Monate)

1 – 12
breakRulesobjectoptional

Tarifliche Pausenregeln; müssen ArbZG § 4 verstärken, nicht abschwächen

after6HoursMinutesnumberoptional
≥ 30
after9HoursMinutesnumberoptional
≥ 45
minSegmentMinutesnumberoptional
≥ 15
maxConsecutiveWorkMinutesnumberoptional
≥ 0
restPeriodobjectoptional

Tarifliche Ruhezeit (ArbZG § 5: mind. 11h, ggf. 10h)

minHoursBetweenShiftsnumberoptional
≥ 10
reducedToHoursnumberoptional
≥ 10
reducedAllowedbooleanoptional
nightWorkLimitsobjectoptional

Tarifliche Nachtarbeitsgrenzen (ArbZG § 6)

maxHoursPerNightnumberoptional
0 – 10
averagingPeriodMonthsnumberoptional
≥ 1
nightWindowStartstringoptional
Pattern
nightWindowEndstringoptional
Pattern
medicalExamRequiredbooleanoptional
minWeeklyHoursnumberoptional

Tarifliche Mindestwochenstunden für Vollzeit

≥ 0
maxWeeklyHoursnumberoptional

Tarifliche Höchstwochenstunden (harte Obergrenze, nicht Durchschnitt)

≥ 0
overtimeSurchargePercentnumberoptional

Überstundenzuschlag in Prozent

≥ 0
nightSurchargePercentnumberoptional

Nachtarbeitszuschlag in Prozent

≥ 0
weekendSurchargePercentnumberoptional

Wochenend-Zuschlag in Prozent

≥ 0
holidaySurchargePercentnumberoptional

Feiertagszuschlag in Prozent

≥ 0
surchargeStackingModestringoptional

Wie Zuschläge bei Überschneidung kombinieren. MAX = Zeit-Zuschläge konkurrieren (gängig); ADDITIVE = alle addieren.

Werte
MAXADDITIVE
minVacationDaysnumberoptional

Tariflicher Urlaubsanspruch (BUrlG § 3: mind. 20 bei 5-Tage, 24 bei 6-Tage)

≥ 20
notesstringoptional

Zusätzliche Hinweise zum Tarifvertrag

max 4000 Zeichennullable

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

Suche