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
128 changes: 126 additions & 2 deletions docs/schema-changes/eor/contract-details/countries/MEX.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
<OnboardingFlow
options={{
jsonSchemaVersionByCountry: {
MEX: { contract_details: 8 },
},
}}
/>
```

---

### 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
<OnboardingFlow
options={{
jsonSchemaVersionByCountry: {
MEX: { contract_details: 7 },
},
}}
/>
```

---

### 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
<OnboardingFlow
options={{
jsonSchemaVersionByCountry: {
MEX: { contract_details: 6 },
},
}}
/>
```

---

### 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
<OnboardingFlow
options={{
jsonSchemaVersionByCountry: {
MEX: { contract_details: 5 },
},
}}
/>
```

---

### 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
<OnboardingFlow
options={{
jsonSchemaVersionByCountry: {
MEX: { contract_details: 4 },
},
}}
/>
```

---

### 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
<OnboardingFlow
options={{
jsonSchemaVersionByCountry: {
MEX: { contract_details: 3 },
},
}}
/>
```

---

### v2 (Since SDK 1.24.0, March 2026)

**What changed:**

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,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 | v5 | October 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 |
Expand Down
2 changes: 1 addition & 1 deletion example/src/flows/Onboarding/jsonSchemaVersions.ts
Original file line number Diff line number Diff line change
Expand Up @@ -221,7 +221,7 @@ export const ONBOARDING_JSON_SCHEMA_VERSION_BY_COUNTRY = {
},
MEX: {
// Mexico
contract_details: 2,
contract_details: 8,
},
MKD: {
// North Macedonia
Expand Down
Loading