Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 3 additions & 7 deletions app/docs/gelijkwaardige-beloning/README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,7 @@
# Inquiry Pay Equity v2.0

:::caution DISCLAIMER
The SETU Standard for Inquiry Pay Equity v2.0 is currently under review.

The public consultation period runs from 6 Feb till 27 Feb 2026.
:::info
Version 2.0 of the Inquiry Pay Equity standard was published on March 11, 2026. On this page, you will find all information regarding this standard, including the various [scenarios](./scenarios.md) and [business processes](./sequence%20diagrams/sequence%20diagrams.md) it covers, [usage notes](./usage-notes/rates.md) for implementing the standard, and a [changelog](./releaseNotes.md) detailing all changes from version 1.0 to 2.0 as well as future updates.
:::

## Introduction
Expand Down Expand Up @@ -66,6 +64,4 @@ The exchange of pay equity (Inquiry Pay Equity) data involves communication betw
The new Inquiry Pay Equity SETU standard is based on a standardized SETU language in which concepts and relationships with associated terminology and definitions are specified. The SETU reuses the terminology and definitions of the latest version 4.3 of the international HR Open standard as much as possible for its SETU language. Where necessary, additional relationships have been established in the SETU language between existing HR Open concepts, or new concepts have been introduced. Definitions have also been improved and made more suitable for the inquiry pay equity context.

## Public consultation
For version 2.0 of the Inquiry Pay Equity standard, a public consultation will be performed from 6 Feb till 27 Feb 2026.

Interested parties are invited to review the delivered standard and provide review comments. Those responses will be considered by the SETU, discussed with the working group and, where necessary, the draft version adjusted before final publication.
For version 2.0 of the Inquiry Pay Equity standard, a public consultation is performed from 6 Feb till 27 Feb 2026.
6 changes: 0 additions & 6 deletions app/docs/gelijkwaardige-beloning/public-consultation.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,5 @@
# Public consultation

:::caution DISCLAIMER
The SETU Standard for Inquiry Pay Equity v2.0 is currently under review.

The public consultation period runs from 6 Feb till 27 Feb 2026.
:::

## Where to find the specification?

The management and maintenance of this message specification is carried out in our [SETU standards portal](https://setu.semantic-treehouse.nl/). The message specification can be found here:
Expand Down
41 changes: 21 additions & 20 deletions app/docs/gelijkwaardige-beloning/releaseNotes.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ This documentation page records the changes made to the SETU Standard for Inquir

## From v1.0 to v2.0

Version 2.0 of the Inquiry Pay Equity specification represents a significant improvement of the standard, addressing over 80 solved issues. This release focuses on three key themes:
Version 2.0 of the Inquiry Pay Equity specification represents a significant improvement of the standard, addressing over 100 solved issues. This release focuses on three key themes:

1. **Data consistency** - Harmonizing data types and structures across all blocks
2. **Expressiveness** - Adding capabilities to capture complex compensation scenarios
Expand Down Expand Up @@ -92,27 +92,28 @@ New top-level `baseDefinition[]` array to explicitly define what components are
```json
"baseDefinition": [{
"baseType": "actualWage",
"remuneration": true,
"holidayAllowance": true,
"paidLeaveDays": false,
"allAllowances": false,
"allowances": {
"typeCode": ["EA101", "EA102"]
},
"remunerationIndicator": true,
"holidayAllowanceIndicator": true,
"paidLeaveDayIndicator": false,
"allAllowancesIndicator": false,
"allowances": [
{ "typeCode": "EA101" },
{ "typeCode": "EA102" }
],
"referenceDate" : {
"occurenceType":"..",
"occurrenceType":"..",
}
}]
```

#### Supplementary Arrangements ([#49](https://github.com/setu-standards/inquiry-pay-equity/issues/49))
#### Supplementary Arrangement ([#49](https://github.com/setu-standards/inquiry-pay-equity/issues/49))

New `supplementaryArrangements[]` section for RVU (early retirement), generation pact, and other arrangements:
New `supplementaryArrangement[]` section for RVU (early retirement), generation pact, and other arrangements:

```json
"supplementaryArrangements": [{
"supplementaryArrangement": [{
"name": "Generatiepact 80-90-100",
"type_code": { "value": "GenerationPact"}
"typeCode": "GenerationPact"
}]
```

Expand All @@ -125,7 +126,7 @@ New `lineId` field on line items enables cross-referencing between allowances:
"line": [{
"lineId": { "value": "shift-allowance-1" },
"reference": [{
"targetId": { "value": "base-hourly-rate" }
"id": { "value": "base-hourly-rate" }
}]
}]
}]
Expand All @@ -152,7 +153,7 @@ New `proportional` object on amount blocks to indicate pro-rata calculation:
New `leaveDayValue` on individual leave types (ADV, paid leave, special leave, holidays, WAZO) instead of a single global value:

```json
"adv": [{
"workingHoursReduction": [{
"amount": { "value": 24, "unitCode": "hour" },
"leaveDayValue": {
"value": 180,
Expand All @@ -172,7 +173,7 @@ Special leave restructured as an array with full amount specification:
"value": 2,
"unitCode": "day"
},
"intervalCode": {
"interval": {
"value": "1",
"unitCode": "item"
},
Expand All @@ -187,15 +188,15 @@ Special leave restructured as an array with full amount specification:
New dedicated `wazo[]` array for maternity/paternity leave arrangements:

```json
"wazo": [{
"additionalParentalLeave": [{
"name": "Additional birth leave",
"amount": {
"value": 5,
"unitCode": "day"
},
"conditions": [{
"conditionType": "Occurence",
"occurenceType": "...",
"conditionType": "Occurrence",
"occurrenceType": "...",
}]
}]
```
Expand All @@ -210,7 +211,7 @@ Expanded `workDuration` with interval specification:
"value": 40,
"unitCode": "hour"
},
"intervalCode": {
"interval": {
"value": 1,
"unitCode": "week"
},
Expand Down
7 changes: 0 additions & 7 deletions app/docs/gelijkwaardige-beloning/scenarios.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,5 @@
# Scenarios

:::caution DISCLAIMER
The SETU Standard for Inquiry Pay Equity v2.0 is currently under review.

The public consultation period runs from 6 Feb till 27 Feb 2026.
:::


:::info DOCUMENTATION
The message models can be found in [Semantic Treehouse](https://setu.semantic-treehouse.nl/specifications). There you can also find example messages and validation artifacts in both XML and JSON.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,5 @@
# Sequence diagrams

:::caution DISCLAIMER
The SETU Standard for Inquiry Pay Equity v2.0 is currently under review.

The public consultation period runs from 6 Feb till 27 Feb 2026.
:::


:::info DOCUMENTATION
The message models can be found in [Semantic Treehouse](https://setu.semantic-treehouse.nl/specifications). There you can also find example messages and validation artifacts in both XML and JSON.

Expand Down
9 changes: 1 addition & 8 deletions app/docs/gelijkwaardige-beloning/usage-notes/conditions.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,5 @@
# Conditions

:::caution DISCLAIMER
The SETU Standard for Inquiry Pay Equity v2.0 is currently under review.

The public consultation period runs from 6 Feb till 27 Feb 2026.
:::


:::info DOCUMENTATION
The message models can be found in [Semantic Treehouse](https://setu.semantic-treehouse.nl/specifications). There you can also find example messages and validation artifacts in both XML and JSON.

Expand Down Expand Up @@ -115,7 +108,7 @@ Specifies a condition that is met on a specific date.
{
"conditionType": "Occurrence",
"occurrence": {
"occurrenceType": "SingleOccurence", // A one-time occurrence.
"occurrenceType": "SingleOccurrence", // A one-time occurrence.
"date": "2026-12-15" // The specific fixed date.
}
}
Expand Down
52 changes: 19 additions & 33 deletions app/docs/gelijkwaardige-beloning/usage-notes/rates.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,5 @@
# Pay Equity Structure

:::caution DISCLAIMER
The SETU Standard for Inquiry Pay Equity v2.0 is currently under review.

The public consultation period runs from 6 Feb till 27 Feb 2026.
:::

:::info DOCUMENTATION
The message models can be found in [Semantic Treehouse](https://setu.semantic-treehouse.nl/specifications). There you can also find example messages and validation artifacts in both XML and JSON.

Expand Down Expand Up @@ -44,7 +38,7 @@ Most components using this structure will include some or all of the following k
- **Unit Code (`unitCode`):** The unit of the value (e.g., `Percentage`, `Euro`, `Hour`, `Day`).
- **Base Amount (`baseAmount`):** If the `value` is a percentage or derived, this specifies the base for the calculation (e.g., `ActualWage`, `Fixed`).
- **Proportional (`proportional`):** Indicates whether the amount is calculated proportionally based on part-time percentage or employment duration.
- **Interval Code (`intervalCode`):** Defines the interval over which the `amount` is applied or earned (e.g., `1` `Hour` means per hour; `0.5` `Year` means per half year).
- **Interval (`interval`):** Defines the interval over which the `amount` is applied or earned (e.g., `1` `Hour` means per hour; `0.5` `Year` means per half year).
- **Conditions (`conditions`):** Specifies any conditions that must be met for this particular line to apply (see the "Conditions" documentation page for more details).
- **References (`reference`):** Allows linking this regulation to others, for instance, to define calculation dependencies (e.g., an allowance being compounded on another).
- **Other specific fields:** Depending on the component (e.g., `waitingDays` for `sickPay`, `payDate` for `holidayAllowance`).
Expand All @@ -68,10 +62,7 @@ The following JSON snippet, taken from an `allowance` component, illustrates how
"validFrom": "2025-01-01",
"validTo": "2025-12-31"
},
"typeCode": {
// Code identifying the type of allowance (from SETU codelist).
"value": "HT320" // Example: Code for shift/irregular hours allowance.
},
"typeCode": "HT320", // Example: Code for shift/irregular hours allowance.
"period": [
// Defines when this allowance is applicable ('earned').
{
Expand Down Expand Up @@ -137,7 +128,7 @@ The `line` array within a component defines the actual benefit(s). The following
"baseType": "GrossSalary"
}
},
"intervalCode": {
"interval": {
"value": 1, // For every 1 unit.
"unitCode": "Hour" // Unit is hour (i.e., per hour of overtime worked).
},
Expand All @@ -159,14 +150,14 @@ The `line` array within a component defines the actual benefit(s). The following
"unitCode": "Fixed" // It's a fixed amount of time, not percentage based.
}
},
"intervalCode": {
"interval": {
"value": 1, // For every 1 unit.
"unitCode": "Hour" // Unit is hour (i.e., per hour of overtime worked).
},
"conditions": [
// Conditions for choosing this line.
{
"conditionType": "textCondition",
"conditionType": "Text",
"description": "Overtime compensation as time-off, if chosen by employee and operationally feasible."
}
]
Expand Down Expand Up @@ -202,10 +193,7 @@ Allowances are additional payments made to employees for specific reasons, such
"validFrom": "2026-01-01",
"validTo": "2027-12-31"
},
"typeCode": {
// Type of allowance.
"value": "HT320" // Example: Shift/irregular hours code.
},
"typeCode": "HT320", // Example: Shift/irregular hours code.
"period": [
// When this surcharge is earned.
{
Expand All @@ -231,7 +219,7 @@ Allowances are additional payments made to employees for specific reasons, such
"unitCode": "Fixed" // Indicates it's a fixed Euro amount.
}
},
"intervalCode": {
"interval": {
"value": 1,
"unitCode": "Hour" // 5 Euro per hour worked during the weekend.
}
Expand Down Expand Up @@ -259,9 +247,7 @@ Reimbursements cover expenses incurred by employees, such as travel costs. The `
"validFrom": "2026-01-01",
"validTo": "2027-12-31"
},
"typeCode": {
"value": "EA103" // Example: Code for travel costs home-work.
},
"typeCode": "EA103", // Example: Code for travel costs home-work.
"period": [
/* ... applicable workdays ... */
],
Expand All @@ -272,10 +258,10 @@ Reimbursements cover expenses incurred by employees, such as travel costs. The `
"baseAmount": {
"unitCode": "Fixed" // Indicates it's a fixed Euro amount.
},
"intervalCode": { "value": 1, "unitCode": "Day" },
"interval": { "value": 1, "unitCode": "Day" },
"conditions": [
{
"conditionType": "textCondition",
"conditionType": "Text",
"description": "For travel > 50 km"
}
]
Expand All @@ -285,10 +271,10 @@ Reimbursements cover expenses incurred by employees, such as travel costs. The `
"baseAmount": {
"unitCode": "Fixed" // Indicates it's a fixed Euro amount.
},
"intervalCode": { "value": 1, "unitCode": "Kilometer" },
"interval": { "value": 1, "unitCode": "Kilometer" },
"conditions": [
{
"conditionType": "textCondition",
"conditionType": "Text",
"description": "For travel < 20 km or bicycle"
}
]
Expand Down Expand Up @@ -333,7 +319,7 @@ Sick pay regulations define how employees are compensated during periods of illn
"value": 3201 // Optional: Example monthly rate.
}
},
"intervalCode": { "value": 1, "unitCode": "Month" },
"interval": { "value": 1, "unitCode": "Month" },
"conditions": [
{
"conditionType": "Occurrence",
Expand Down Expand Up @@ -375,7 +361,7 @@ Leave regulations cover various types of time off, such as annual vacation, publ
"name": ["Christmas Day", "Easter", "etc."],
"conditions": [
{
"conditionType": "textCondition",
"conditionType": "Text",
"description": "If holiday falls on a workday"
}
]
Expand All @@ -385,14 +371,14 @@ Leave regulations cover various types of time off, such as annual vacation, publ
// General paid leave (vacation days).
{
"amount": { "value": 25, "unitCode": "Day" }, // E.g., 25 days.
"intervalCode": { "value": 1, "unitCode": "Year" }, // 25 days per year.
"interval": { "value": 1, "unitCode": "Year" }, // 25 days per year.
}
],
"adv": [
/* ... Arbeidsduurverkorting (reduction in working hours) details ... */
"workingHoursReduction": [
/* ... reduction in working hours details ... */
],
"leaveDayValue": { "value": 133.0, "unitCode": "Euro" }, // Financial value of one leave day.
"wazo": [
"additionalParentalLeave": [
{
"name": "Parental leave supplement",
"amount": { "value": 3, "unitCode": "Day" }
Expand All @@ -409,7 +395,7 @@ Leave regulations cover various types of time off, such as annual vacation, publ
"baseType": "GrossSalary"
},

"intervalCode": {
"interval": {
"value": 1,
"unitCode": "hour"
}
Expand Down
5 changes: 0 additions & 5 deletions app/sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -84,11 +84,6 @@ module.exports = {
collapsed: true,
link: {type: 'doc', id: 'gelijkwaardige-beloning/README'},
items: [
{
type: "doc",
label: "Public Consultation",
id: "gelijkwaardige-beloning/public-consultation",
},
{
type: "doc",
label: "Scenarios",
Expand Down