People pillar · v0.16.0

pay-equity-audit PayEquityAudit

Pay-equity audit record.

$id · https://corpospec.com/schemas/v0.16.0/pay-equity-audit.schema.json

Fields

Field Type Required Description
entity PathRef yes Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
headcount_fte integer yes
id PathRef yes Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
job_category_breakdown JobCategoryGap[] yes
jurisdiction IsoCountry yes ISO 3166-1 alpha-2 country code.
measurements PayGapMeasurement[] yes
quartiles QuartileGap[] yes
reporting_period_end IsoDate yes ISO 8601 date (YYYY-MM-DD).
reporting_period_start IsoDate yes ISO 8601 date (YYYY-MM-DD).
retention_until IsoDate yes 10-year retention (HGB §257 + audit-trail convention).
status PayAuditStatus yes Audit report lifecycle.
triggers_art10_joint_assessment boolean yes Whether any unjustified gap ≥5% triggers Art. 10.
corrective_plan PathRef? PathRef into the corrective action plan.
filed_at IsoDate?
joint_assessment_ref PathRef? PathRef into the joint pay assessment record.
published_report PathRef? PathRef into the published report (Art. 9 §6 publication duty).

Definitions

Shared types referenced within this schema.

IsoCountry
ISO 3166-1 alpha-2 country code.
pattern: ^[A-Z]{2}$
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
JobCategoryGap
Per-job-category breakdown for "work of equal value" analysis (EU 2023/970 Art. 9 §1c).
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_.-]+)+$
PayAuditStatus
Audit report lifecycle.
PayAxis
Comparison axis.
enum: "gender", "age", "ethnicity", "disability"
PayComponent
Pay component scope.
PayGapMeasurement
One pay-gap measurement.
type: object
QuartileGap
Quartile breakdown (Q1 lowest pay → Q4 highest).
type: object

Reference in your YAML

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