# TVöD-SuE May 2026 Implementation Guide

**Last Updated:** 2026-01-07  
**Target Implementation Date:** April 25-30, 2026  
**Effective Date:** May 1, 2026 (Entgelttabelle), January 1, 2026 (Jahressonderzahlung)

## Overview

This guide provides step-by-step instructions for implementing the TVöD-SuE Entgelttabelle updates effective May 1, 2026, and Jahressonderzahlung changes effective January 1, 2026.

## Pre-Implementation Checklist

- [ ] Review all documentation files
- [ ] Verify source URLs are still accessible
- [ ] Confirm effective dates haven't changed
- [ ] Backup current `v2/pages/tools_tvoed_sue.php` file
- [ ] Create git branch: `feature/tvoed-sue-may-2026-update`
- [ ] Review `TVOED_SUE_2026_VERIFICATION.md` for all verified values
- [ ] Review `TVOED_SUE_MAY_2026_CHANGES.md` for complete change list

## Implementation Steps

### Step 1: Update JavaScript Data Object Version

**File:** `v2/pages/tools_tvoed_sue.php`  
**Line:** 884  
**Change:**

```javascript
// OLD:
"version": "2026-01-01",

// NEW:
"version": "2026-05-01",
```

### Step 2: Update VKA Entgelttabelle Values

**File:** `v2/pages/tools_tvoed_sue.php`  
**Lines:** 891-907  
**Action:** Replace all 96 values with May 2026 values

**Example for S2 (Lines 892):**

```javascript
// OLD:
"S2": { "1": 2829.14, "2": 2948.41, "3": 3036.64, "4": 3132.45, "5": 3240.19, "6": 3347.95 },

// NEW:
"S2": { "1": 2908.36, "2": 3030.97, "3": 3121.67, "4": 3220.16, "5": 3330.92, "6": 3441.69 },
```

**Reference:** Use `TVOED_SUE_2026_VERIFICATION.md` for complete value mapping.

**All S-Gruppen to Update:**

- S2: Lines 892
- S3: Lines 893
- S4: Lines 894
- S7: Lines 895
- S8a: Lines 896
- S8b: Lines 897
- S9: Lines 898
- S11a: Lines 899
- S11b: Lines 900
- S12: Lines 901
- S13: Lines 902
- S14: Lines 903
- S15: Lines 904
- S16: Lines 905
- S17: Lines 906
- S18: Lines 907

### Step 3: Update Bund Entgelttabelle Values

**File:** `v2/pages/tools_tvoed_sue.php`  
**Lines:** 909-925

**Action:**

1. Update S2-S14 to match VKA values (currently identical, verify)
2. **Replace placeholder values for S15-S18 with VKA values**

**Example for Bund S15 (Lines 922):**

```javascript
// OLD (placeholder):
"S15": { "1": 5100.00, "2": 5250.00, "3": 5400.00, "4": 5550.00, "5": 5700.00, "6": 5850.00 },

// NEW (use VKA values):
"S15": { "1": 4112.68, "2": 4393.93, "3": 4691.87, "4": 5034.44, "5": 5585.57, "6": 5823.86 },
```

**Bund S15-S18 Placeholder Replacement:**

- S15: Replace lines 922 with VKA S15 values
- S16: Replace lines 923 with VKA S16 values
- S17: Replace lines 924 with VKA S17 values
- S18: Replace lines 925 with VKA S18 values (including Stufe 6: null → 6963.31)

### Step 4: Update Jahressonderzahlung Percentages

**File:** `v2/pages/tools_tvoed_sue.php`  
**Lines:** 991-1003

**VKA Section (Lines 992-996):**

```javascript
// OLD:
"VKA": {
    "EG_1_8": 0.25,
    "EG_9_11": 0.30,
    "EG_12_13": 0.35,
    "EG_14_15": 0.40
},

// NEW:
"VKA": {
    "EG_1_8": 0.90,
    "EG_9_11": 0.85,
    "EG_12_13": 0.85,
    "EG_14_15": 0.85
},
```

**Bund Section (Lines 998-1002):**

```javascript
// OLD:
"Bund": {
    "EG_1_8": 0.25,
    "EG_9_11": 0.30,
    "EG_12_13": 0.35,
    "EG_14_15": 0.40
},

// NEW:
"Bund": {
    "EG_1_8": 0.90,
    "EG_9_11": 0.85,
    "EG_12_13": 0.85,
    "EG_14_15": 0.85
},
```

### Step 5: Update HTML Table Values - Erzieher Table

**File:** `v2/pages/tools_tvoed_sue.php`  
**Lines:** 2923-2949

**Update all 18 hardcoded values:**

**S2 (Lines 2925-2930):**

```html
<!-- OLD -->
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="1">
  2.829,14 €
</td>
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="2">
  2.948,41 €
</td>
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="3">
  3.036,64 €
</td>
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="4">
  3.132,45 €
</td>
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="5">
  3.240,19 €
</td>
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="6">
  3.347,95 €
</td>

<!-- NEW -->
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="1">
  2.908,36 €
</td>
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="2">
  3.030,97 €
</td>
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="3">
  3.121,67 €
</td>
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="4">
  3.220,16 €
</td>
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="5">
  3.330,92 €
</td>
<td class="px-4 py-3 text-center font-medium" data-sgroup="S2" data-stufe="6">
  3.441,69 €
</td>
```

**S3 (Lines 2934-2939):** Update with values: 3.119,87 €, 3.320,05 €, 3.506,28 €, 3.677,28 €, 3.755,52 €, 3.848,98 €

**S4 (Lines 2943-2948):** Update with values: 3.291,46 €, 3.504,21 €, 3.698,06 €, 3.829,61 €, 3.956,37 €, 4.156,33 €

**Reference:** Use `TVOED_SUE_2026_VERIFICATION.md` for complete value mapping.

### Step 6: Update HTML Table Values - Sozialpädagogen Table

**File:** `v2/pages/tools_tvoed_sue.php`  
**Lines:** 2976-3002

**Update all 18 hardcoded values:**

**S7 (Lines 2978-2983):** Update with values: 3.426,93 €, 3.649,60 €, 3.871,14 €, 4.098,95 €, 4.270,11 €, 4.528,02 €

**S8a (Lines 2987-2992):** Update with values: 3.509,44 €, 3.738,13 €, 3.976,82 €, 4.207,08 €, 4.432,16 €, 4.668,84 €

**S8b (Lines 2996-3001):** Update with values: 3.578,87 €, 3.812,64 €, 4.091,94 €, 4.503,48 €, 4.892,59 €, 5.190,90 €

### Step 7: Update HTML Table Values - Leitungen Table

**File:** `v2/pages/tools_tvoed_sue.php`  
**Lines:** 3029-3118

**Update all 60 hardcoded values:**

**S9 (Lines 3031-3036):** Update with values: 3.648,68 €, 3.887,42 €, 4.166,69 €, 4.580,02 €, 4.970,99 €, 5.272,60 €

**S11a (Lines 3040-3045):** Update with values: 3.846,25 €, 4.106,12 €, 4.291,48 €, 4.766,33 €, 5.138,69 €, 5.362,12 €

**S11b (Lines 3049-3054):** Update with values: 3.915,12 €, 4.181,19 €, 4.368,13 €, 4.844,78 €, 5.217,14 €, 5.440,57 €

**S12 (Lines 3058-3063):** Update with values: 3.967,57 €, 4.237,49 €, 4.590,75 €, 4.903,53 €, 5.290,81 €, 5.454,65 €

**S13 (Lines 3067-3072):** Update with values: 3.978,03 €, 4.248,70 €, 4.617,39 €, 4.915,26 €, 5.287,64 €, 5.473,83 €

**S14 (Lines 3076-3081):** Update with values: 4.073,39 €, 4.351,17 €, 4.682,24 €, 5.019,00 €, 5.391,41 €, 5.652,06 €

**S15 (Lines 3085-3090):** Update with values: 4.112,68 €, 4.393,93 €, 4.691,87 €, 5.034,44 €, 5.585,57 €, 5.823,86 €

**S16 (Lines 3094-3099):** Update with values: 4.263,29 €, 4.557,82 €, 4.885,49 €, 5.287,64 €, 5.734,48 €, 6.002,61 €

**S17 (Lines 3103-3108):** Update with values: 4.352,39 €, 4.654,62 €, 5.138,69 €, 5.436,63 €, 6.032,40 €, 6.382,42 €

**S18 (Lines 3112-3117):** Update with values: 4.720,52 €, 4.840,79 €, 5.436,63 €, 5.883,46 €, 6.553,73 €, 6.963,31 €

### Step 8: Update FAQ Content - Jahressonderzahlung

**File:** `v2/pages/tools_tvoed_sue.php`  
**Lines:** 3348-3351

**Change:**

```html
<!-- OLD -->
<li><strong>EG 1-8 (S2-S8b):</strong> 25% des Tabellenentgelts</li>
<li><strong>EG 9-11 (S9-S11b):</strong> 30% des Tabellenentgelts</li>
<li><strong>EG 12-13 (S12-S13):</strong> 35% des Tabellenentgelts</li>
<li><strong>EG 14-15 (S14-S18):</strong> 40% des Tabellenentgelts</li>

<!-- NEW -->
<li><strong>EG 1-8 (S2-S8b):</strong> 90% des Tabellenentgelts</li>
<li><strong>EG 9-11 (S9-S11b):</strong> 85% des Tabellenentgelts</li>
<li><strong>EG 12-13 (S12-S13):</strong> 85% des Tabellenentgelts</li>
<li><strong>EG 14-15 (S14-S18):</strong> 85% des Tabellenentgelts</li>
```

### Step 9: Update Schema Markup - FAQPage

**File:** `v2/pages/tools_tvoed_sue.php`  
**Line:** 824

**Change:**

```javascript
// OLD:
"text": "Die Jahressonderzahlung wird basierend auf dem durchschnittlichen Monatsbruttogehalt der Monate Juli, August und September berechnet. Der Prozentsatz variiert je nach Entgeltgruppe: EG 1-8 (S2-S8b): 25%, EG 9-11 (S9-S11b): 30%, EG 12-13 (S12-S13): 35%, EG 14-15 (S14-S18): 40%. Die Zahlung erfolgt typischerweise im November und ist eine wichtige Komponente des TVöD-SuE Gehalts."

// NEW:
"text": "Die Jahressonderzahlung wird basierend auf dem durchschnittlichen Monatsbruttogehalt der Monate Juli, August und September berechnet. Der Prozentsatz variiert je nach Entgeltgruppe: EG 1-8 (S2-S8b): 90%, EG 9-11 (S9-S11b): 85%, EG 12-13 (S12-S13): 85%, EG 14-15 (S14-S18): 85%. Die Zahlung erfolgt typischerweise im November und ist eine wichtige Komponente des TVöD-SuE Gehalts."
```

### Step 10: Update Content Sections

**File:** `v2/pages/tools_tvoed_sue.php`  
**Line:** 2146

**Change:**

```html
<!-- OLD -->
Die Jahressonderzahlung wird im November ausgezahlt und beträgt je nach
Entgeltgruppe 25-40% deines Monatsgehalts. Bei Teilzeit wird sie anteilig
gekürzt.

<!-- NEW -->
Die Jahressonderzahlung wird im November ausgezahlt und beträgt je nach
Entgeltgruppe 85-90% deines Monatsgehalts. Bei Teilzeit wird sie anteilig
gekürzt.
```

**File:** `v2/pages/tools_tvoed_sue.php`  
**Lines:** 3148-3150 (if applicable)

Update any other references to "25-40%" to "85-90%".

## Post-Implementation Testing

### Testing Checklist

- [ ] Test calculator with all S-Gruppen × Stufen combinations
- [ ] Verify Tabellenentgelt values match Entgelttabelle
- [ ] Verify Jahressonderzahlung calculations:
  - [ ] EG 1-8 (S2-S8b): Should be 90% of Tabellenentgelt
  - [ ] EG 9-15 (S9-S18): Should be 85% of Tabellenentgelt
- [ ] Test part-time calculations (Beschäftigungsumfang < 100%)
- [ ] Test VKA vs Bund switching
- [ ] Verify HTML table displays match JavaScript data
- [ ] Test FAQ content displays correctly
- [ ] Verify schema markup validates correctly
- [ ] Cross-browser testing (Chrome, Firefox, Safari, Edge)
- [ ] Mobile responsiveness testing

### Calculation Verification

**Test Case 1: S2 Stufe 1, VKA, 100% Beschäftigungsumfang**

- Tabellenentgelt: 2.908,36 €
- Jahressonderzahlung: 2.908,36 € × 0.90 = 2.617,52 €
- Expected: ✅ Verify

**Test Case 2: S9 Stufe 3, VKA, 100% Beschäftigungsumfang**

- Tabellenentgelt: 4.166,69 €
- Jahressonderzahlung: 4.166,69 € × 0.85 = 3.541,69 €
- Expected: ✅ Verify

**Test Case 3: S18 Stufe 6, Bund, 50% Beschäftigungsumfang**

- Tabellenentgelt: 6.963,31 € × 0.50 = 3.481,66 €
- Jahressonderzahlung: 6.963,31 € × 0.85 × 0.50 = 2.959,41 €
- Expected: ✅ Verify

## Rollback Instructions

If issues are discovered after implementation:

1. **Revert Git Commit:**

   ```bash
   git log --oneline  # Find commit hash
   git revert <commit-hash>
   ```

2. **Manual Rollback:**

   - Restore backup of `v2/pages/tools_tvoed_sue.php`
   - Or manually revert all changes using this guide in reverse

3. **Verify Rollback:**
   - Test calculator with old values
   - Verify calculations match previous behavior
   - Check HTML tables display old values

## Deployment Checklist

- [ ] All code changes committed
- [ ] All tests passed
- [ ] Code review completed
- [ ] Documentation updated
- [ ] Deploy to staging environment
- [ ] Staging tests passed
- [ ] Deploy to production
- [ ] Production smoke tests passed
- [ ] Monitor for errors (first 24 hours)
- [ ] Monitor user feedback

## Related Cursor Rules

When working with TVöD-SuE calculator implementation, the following Cursor rules apply:

- **[tools-pages-reference.mdc](../../../.cursor/rules/tools-pages-reference.mdc)** - Testing patterns and troubleshooting
- **[tools-pages-core-validation.mdc](../../../.cursor/rules/tools-pages-core-validation.mdc)** - Validation patterns
- **[tools-pages-documentation.mdc](../../../.cursor/rules/tools-pages-documentation.mdc)** - Documentation maintenance patterns

## Related Documentation

- `TVOED_SUE_2026_VERIFICATION.md` - Complete verification spreadsheet
- `TVOED_SUE_MAY_2026_CHANGES.md` - Complete change log
- `TVOED_SUE_CURRENT_IMPLEMENTATION.md` - Current implementation analysis
- `TVOED_SUE_MAY_2026_UPDATE_CHECKLIST.md` - Comprehensive checklist
- `TVOED_SUE_MAY_2026_TESTING.md` - Detailed testing requirements