People pillar · v0.16.0

payslip Payslip

Per-person payslip.

$id · https://corpospec.com/schemas/v0.16.0/payslip.schema.json

Fields

Field Type Required Description
deductions Deduction[] yes
employer_contributions EmployerContribution[] yes
gross MonetaryAmount yes A monetary value with currency.
id PathRef yes Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
net MonetaryAmount yes A monetary value with currency.
person PathRef yes Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pii_class PiiClass yes Personal-data classification on every record carrying personal data, per BDR 0070 / BDR 0069 / BDR 0078. Used by `corpospec-report` to gate rendering and by the privacy pillar's RoPA records to determine safeguards.
retention_until IsoDate yes Default pay_date + 10 years per §257 HGB.
run PathRef yes PathRef into the PayrollRun this payslip belongs to.
total_employer_cost MonetaryAmount yes A monetary value with currency.
document PathRef? PathRef into the encrypted PDF.

Definitions

Shared types referenced within this schema.

Deduction
One employee-side deduction line.
type: object
DeductionKind
Employee-side deduction kind on a payslip.
EmployerContribution
One employer-side contribution line.
type: object
EmployerContributionKind
Employer-side contribution kind.
IsoCurrency
ISO 4217 currency code.
pattern: ^[A-Z]{3}$
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
MonetaryAmount
A monetary value with currency.
type: object
PathRef
Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
PiiClass
Personal-data classification on every record carrying personal data, per BDR 0070 / BDR 0069 / BDR 0078. Used by `corpospec-report` to gate rendering and by the privacy pillar's RoPA records to determine safeguards.

Reference in your YAML

# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/payslip.schema.json