From eabd419f6dc0094a2737fa1653bf7a390b96c0f5 Mon Sep 17 00:00:00 2001 From: Gabriel Garcia Date: Wed, 14 Oct 2026 05:35:32 +0200 Subject: [PATCH 1/2] chore(example): bump MEX contract_details schema version to 8 Pin Mexico to contract_details v8 in the example app and document v3-v8 in the MEX schema changelog and the version matrix. Co-Authored-By: Claude Sonnet 5.5 --- .../eor/contract-details/countries/MEX.md | 132 +++++++++++++++++- .../eor/contract-details/countries/README.md | 2 +- .../flows/Onboarding/jsonSchemaVersions.ts | 2 +- 3 files changed, 130 insertions(+), 6 deletions(-) diff --git a/docs/schema-changes/eor/contract-details/countries/MEX.md b/docs/schema-changes/eor/contract-details/countries/MEX.md index 12b391f10..e0445fa76 100644 --- a/docs/schema-changes/eor/contract-details/countries/MEX.md +++ b/docs/schema-changes/eor/contract-details/countries/MEX.md @@ -4,11 +4,135 @@ Schema versions for employee onboarding in México. ## Current Version -**Contract Details:** v2 (Since SDK 1.24.0) +**Contract Details:** v8 ## Contract Details -### v2 - Current (Since SDK 1.24.0, March 2026) +### v8 - Current + +**What changed:** + +- `christmas_bonus` is now covered by the extreme-salary acknowledgement: a warning and a required checkbox appear when the annual salary is at or above the USD 1,000,000 equivalent. Additive and flag-gated, so no action is required unless a submitted salary crosses that threshold. +- The Christmas bonus description now calls it the 13th month salary, typically 15 to 30 days' salary. Copy only. + +**Migration:** + +```tsx + +``` + +--- + +### v7 + +**What changed:** + +- `annual_gross_salary` adds high-salary reserve messaging, grouped with `annual_bonus_ack` and `ergonomic_chair_ack` in a fieldset titled "Annual gross salary" (now driven by the field's presentation settings instead of `annual_gross_salary_fieldset`). Additive and flag-gated. +- The form moves to the JSON Schema Form v1 engine. Validation and form generation follow v1 semantics. + +**Migration:** + +```tsx + +``` + +--- + +### v6 + +**What changed:** + +- Admin-only fixed-term contracts: `contract_duration_type` is still indefinite-only for employers, but Remote Admins can set a fixed term with unlimited maximum duration. +- `contract_end_date` and its "deprecated, Mexico doesn't allow fixed-term" definition are removed from the schema (inferred from the schema diff). + +**Migration:** + +```tsx + +``` + +--- + +### v5 + +**What changed:** + +- The `non_compete`, `non_solicitation` and `non_interference` components added in v4 are removed again. Payloads must not send non-compete fields. + +**Migration:** + +```tsx + +``` + +--- + +### v4 + +**What changed:** + +- Adds the shared `non_compete`, `non_solicitation` and `non_interference` components after the contract duration fields (inferred from the schema diff). + +**Migration:** + +```tsx + +``` + +--- + +### v3 + +**What changed:** + +- Adds the required `ergonomic_chair_ack` acknowledgement: the employer confirms they will reimburse up to 3,000 MXN for an ergonomic chair if the employee works remotely. Submits that omit it fail validation. +- The indefinite-only contract duration is now expressed with `indefinite_duration_only` instead of `contract_duration_options` and a forced-value statement (inferred from the schema diff). + +**Migration:** + +```tsx + +``` + +--- + +### v2 (Since SDK 1.24.0, March 2026) **What changed:** @@ -18,11 +142,11 @@ Schema versions for employee onboarding in México. ```tsx ``` diff --git a/docs/schema-changes/eor/contract-details/countries/README.md b/docs/schema-changes/eor/contract-details/countries/README.md index f66255eb7..1b0b2c5d6 100644 --- a/docs/schema-changes/eor/contract-details/countries/README.md +++ b/docs/schema-changes/eor/contract-details/countries/README.md @@ -68,7 +68,7 @@ These countries have upgraded to different versions, check each guide to know ho | Lebanon | LBN | v2 | March 2026 | | Mauritius | MUS | v2 | March 2026 | | Malaysia | MYS | v2 | March 2026 | -| Mexico | MEX | v2 | March 2026 | +| Mexico | MEX | v8 | October 2026 | | Netherlands | NLD | v6 | October 2026 | | Nigeria | NGA | v5 | October 2026 | | Norway | NOR | v2 | March 2026 | diff --git a/example/src/flows/Onboarding/jsonSchemaVersions.ts b/example/src/flows/Onboarding/jsonSchemaVersions.ts index 2870a70ab..ddcdf1a3a 100644 --- a/example/src/flows/Onboarding/jsonSchemaVersions.ts +++ b/example/src/flows/Onboarding/jsonSchemaVersions.ts @@ -221,7 +221,7 @@ export const ONBOARDING_JSON_SCHEMA_VERSION_BY_COUNTRY = { }, MEX: { // Mexico - contract_details: 2, + contract_details: 8, }, MKD: { // North Macedonia From f2ab673480303cf7537e44010539b9aba00d0dc9 Mon Sep 17 00:00:00 2001 From: Gabriel Garcia Date: Wed, 14 Oct 2026 05:47:19 +0200 Subject: [PATCH 2/2] docs(MEX): fix the doubled braces in the migration snippets Co-Authored-By: Claude Sonnet 5.5 --- .../eor/contract-details/countries/MEX.md | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/schema-changes/eor/contract-details/countries/MEX.md b/docs/schema-changes/eor/contract-details/countries/MEX.md index e0445fa76..818430d36 100644 --- a/docs/schema-changes/eor/contract-details/countries/MEX.md +++ b/docs/schema-changes/eor/contract-details/countries/MEX.md @@ -19,11 +19,11 @@ Schema versions for employee onboarding in México. ```tsx ``` @@ -40,11 +40,11 @@ Schema versions for employee onboarding in México. ```tsx ``` @@ -61,11 +61,11 @@ Schema versions for employee onboarding in México. ```tsx ``` @@ -81,11 +81,11 @@ Schema versions for employee onboarding in México. ```tsx ``` @@ -101,11 +101,11 @@ Schema versions for employee onboarding in México. ```tsx ``` @@ -122,11 +122,11 @@ Schema versions for employee onboarding in México. ```tsx ``` @@ -142,11 +142,11 @@ Schema versions for employee onboarding in México. ```tsx ```