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

Monthly Closing Schema

Schema-ID
monthly_closing
Collection
monthly_closings
Permissions
  • Lesenmonthly_closing_view
  • Anlegentime_account_close
  • Änderntime_account_close
  • Löschentime_account_close

Felder

Monthly Closing Schema

monthly_closings4 Permissions

Periodenabschluss eines Zeitkontos mit Lock-Level

userIduuiderforderlich
accountIduuiderforderlich

Referenz auf time_account._id

yearintegererforderlich
2020 – 2100
monthintegererforderlich
1 – 12
lockLevelstringerforderlich
Werte
OPENCLOSEDEXPORTEDHARD_LOCKED
Default: "OPEN"read-only
closedAtdatetimeoptional
read-onlynullable
closedBystringoptional
max 64 Zeichenread-onlynullable
payrollExportedAtdatetimeoptional
read-onlynullable
payrollExportRefstringoptional

Batch-ID / Referenz der Payroll-Schnittstelle (z.B. DATEV-Batch-Nr.)

max 200 Zeichenread-onlynullable
summaryobjectoptional

Aggregat des Monats. Wird beim CLOSED-Übergang geschrieben und bei Ripple-Recalc aktualisiert.

read-onlynullable
sollMinutesintegeroptional
≥ 0Default: 0
actualMinutesintegeroptional
≥ 0Default: 0
deltaMinutesintegeroptional

Kombinierter Tagesdelta-Saldo (actual − soll) — Backwards-Compat. Ab ADR 0050a zerlegt in flexDeltaMinutes − shortfallMinutes + overtimeDeltaMinutes.

Default: 0
flexDeltaMinutesintegeroptional

Σ Mehrstunden innerhalb des Gleitzeitrahmens. Bestandteil der FLEX-Konto-Buchung. Siehe ADR 0050a.

≥ 0Default: 0
overtimeDeltaMinutesintegeroptional

Σ Stunden außerhalb des Gleitzeitrahmens (vor Multiplikator). Quelle für die OVERTIME-Konto-Buchung. Siehe ADR 0050a.

≥ 0Default: 0
overtimeCreditedMinutesintegeroptional

Tatsächlich auf das OVERTIME-Konto gebuchte Minuten (saldo-wirksam) = overtimeDeltaMinutes × outsideFlexMultiplier. Bei Approval-Mode (Phase 2): 0 wenn die Buchung PENDING ist; wird beim Approve auf den korrekten Wert gesetzt. Siehe ADR 0050a.

≥ 0Default: 0
overtimePendingMinutesintegeroptional

Auf Genehmigung wartende Minuten (Phase 2 ADR 0050a). Sind in `overtimeDeltaMinutes` enthalten, aber noch NICHT in `overtimeCreditedMinutes`. Werden beim Approve in overtimeCreditedMinutes überführt.

≥ 0Default: 0
shortfallMinutesintegeroptional

Σ Minus-Stunden des Monats. Wird vom flexDeltaMinutes abgezogen, bevor auf das FLEX-Konto gebucht wird. Siehe ADR 0050a.

≥ 0Default: 0
vacationDaysnumberoptional
≥ 0Default: 0
sickDaysnumberoptional
≥ 0Default: 0
holidayDaysnumberoptional
≥ 0Default: 0
balanceBeforeCloseintegeroptional
Default: 0
balanceAfterCloseintegeroptional
Default: 0
surchargeBreakdownobjectoptional
nullable
baseMinutesintegeroptional
≥ 0Default: 0
nightMinutesintegeroptional
≥ 0Default: 0
weekendMinutesintegeroptional
≥ 0Default: 0
holidayMinutesintegeroptional
≥ 0Default: 0
overtimeMinutesintegeroptional
≥ 0Default: 0
insideFlexWindowMinutesintegeroptional

Summe der Ist-Minuten innerhalb des Gleitzeitrahmens im Monat (nur bei FLEXTIME mit gesetztem flexWindow).

≥ 0Default: 0
outsideFlexWindowMinutesintegeroptional

Summe der Ist-Minuten außerhalb des Gleitzeitrahmens im Monat. Quelle für `summary.overtimeDeltaMinutes` — fließt ab ADR 0050a in das OVERTIME-Konto.

≥ 0Default: 0
appliedPercentsobjectoptional
nightnumberoptional
≥ 0
weekendnumberoptional
≥ 0
holidaynumberoptional
≥ 0
overtimenumberoptional
≥ 0
surchargeAmountCentsintegeroptional
≥ 0Default: 0
recalculationPendingbooleanoptional

Wird auf true gesetzt, wenn eine rückwirkende Änderung erkannt wurde. Der Retro-Worker arbeitet die Neuberechnung ab.

Default: false
recalculationReasonstringoptional

Freitext zur Ursache (z.B. "Krankmeldung 12.03. nachgereicht")

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

Suche