Financials pillar · v0.16.0
year-end-form YearEndForm
One year-end form per person per jurisdiction per year.
$id · https://corpospec.com/schemas/v0.16.0/year-end-form.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| currency | IsoCurrency | yes | ISO 4217 currency code. |
| entity | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| gross_taxable | number | yes | Gross taxable wages. |
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| income_tax_withheld | number | yes | Income tax withheld. |
| issued_on | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| jurisdiction | IsoCountry | yes | ISO 3166-1 alpha-2 country code. |
| kind | YearEndFormKind | yes | Year-end form kind. |
| 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 | Retention until (10y per HGB §257 / AO §147). |
| social_contributions_withheld | number | yes | Social security / NIC contributions. |
| status | YearEndFormStatus | yes | Lifecycle. |
| statutory_due_date | IsoDate | yes | Statutory due date (DE: 28 Feb; US W-2: 31 Jan; UK P60: 31 May). |
| tax_year | integer | yes | Tax year covered (calendar year for DE/US/NL; Apr-Apr for UK). |
| document_ref | PathRef? | — | PathRef into the issued document PDF / XML. |
| other_withholdings | number? | — | Other withholdings (church tax, solidarity, etc.). |
| payroll_runs | PathRef[] | — | PathRefs to underlying payroll-run records. |
Definitions
Shared types referenced within this schema.
IsoCountry
ISO 3166-1 alpha-2 country code.
pattern: ^[A-Z]{2}$
IsoCurrency
ISO 4217 currency code.
pattern: ^[A-Z]{3}$
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
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.
YearEndFormKind
Year-end form kind.
YearEndFormStatus
Lifecycle.
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/year-end-form.schema.json