# Zuschlagsrechner 2026 Update Summary

**Last Updated:** 2026-03-29

## Overview

Comprehensive update of the Zuschlagsrechner (surcharge calculator) to ensure all surcharge rates, content, FAQs, and documentation reflect verified 2026 German regulations per §3b EStG (steuerfreie Zuschläge) and ArbZG (Arbeitszeitgesetz).

### Ergänzung 2026-03-29 (Traffic / SEO / Schema)

- **15 FAQs** aus einer Quelle (`v2/data/tools_zuschlagsrechner_faq.php`); HTML und FAQPage-JSON-LD identisch.
- **Schema:** `aggregateRating` entfernt; **Article** entfernt; **Calculator** ergänzt; **HowTo** mit `totalTime` **PT3M** und **url** je Step (Anker `#zuschlag-step-*`).
- **Copy:** Modellrechner-Hinweise, §3b-Abs.-2-Hinweis (50 €-Kappung), interne Links zu **Arbeitszeitrechner** und **Brutto-Netto-Rechner**; Research unter `docs/content/tools/zuschlagsrechner/` und Gap-Matrix unter `docs/guides/tools-pages/data/`.

### Follow-up 2026-03-29 (Pending + Next Steps)

- **Schema-Check lokal** dokumentiert in `ZUSCHLAGSRECHNER_2026_NEXT_STEPS.md` (Docker-URL); **Production Rich Results** nach Deploy.
- **GSC/GA:** `zuschlagsrechner-gsc-ga-template.md` um Status-Tabelle und **Seed-Queries** ergänzt; echte Metriken weiter **pending** bis Export.
- **Gap-Matrix:** Actions als erledigt markiert; Betriebs-Next-Steps ergänzt.
- **CONTENT_OUTLINE:** Live-Abgleich-Notiz, PAA→FAQ-Matrix, Unique Value angehakt.
- **FAQ 13 (Minijob):** explizite Pfade zu `/tools/brutto-netto-rechner` und `/tools/minijob-rechner`.

## Research Findings

### Verified 2026 Steuerfreie Zuschläge per §3b EStG

**Nachtzuschlag:**
- **25% steuerfrei** für Arbeit zwischen **20:00-06:00 Uhr**
- **40% steuerfrei** für Arbeit zwischen **0:00-4:00 Uhr**, wenn die Arbeit **vor Mitternacht begonnen wurde**
- ArbZG-Definition: 23:00-06:00 Uhr (gesetzliche Nachtarbeit)

**Sonntagszuschlag:**
- **50% steuerfrei**

**Feiertagszuschlag:**
- **125% steuerfrei** für reguläre Feiertage und **31. Dezember ab 14 Uhr**
- **150% steuerfrei** für besondere Feiertage:
  - 24. Dezember ab 14 Uhr (Heiligabend ab 14:00 Uhr)
  - 25. Dezember (1. Weihnachtsfeiertag)
  - 26. Dezember (2. Weihnachtsfeiertag)
  - 1. Mai (Tag der Arbeit)

**Samstagszuschlag:**
- **Nicht automatisch steuerfrei** - hängt vom Tarifvertrag ab
- Keine gesetzliche Pflicht für Samstagszuschlag
- Üblich: 10-25% je nach Tarifvertrag

**Source:** Bundesfinanzministerium §3b EStG, gesetze-im-internet.de (verified January 2026)

## Critical Issues Fixed

### 1. Feiertagszuschlag Rate Discrepancy ✅ FIXED

**Before:**
- Default: 100%
- Content stated: "bis zu 100% steuerfrei"
- Table showed: "100%"

**After:**
- Default: 100% (kept as common practice)
- Content updated: "bis zu 125% steuerfrei (reguläre Feiertage), bis zu 150% steuerfrei (besondere Feiertage)"
- Table updated: "125% (regulär), 150% (besonders)"
- Added tooltip explaining steuerfreie limits

**Files Updated:**
- `v2/pages/tools_zuschlagsrechner.php` (lines 1563-1564, 1622, 418, 2046, 1895, FAQs)

### 2. Nachtzuschlag Time Period Confusion ✅ FIXED

**Before:**
- Content mentioned: "23:00-06:00 Uhr"
- FAQ incorrectly stated: "ab 20:00 Uhr gibt es keinen steuerfreien Nachtzuschlag"
- No mention of 40% special case

**After:**
- Content clarified: Steuerfreie Periode 20:00-06:00 Uhr (bis zu 25% steuerfrei), ArbZG-Definition 23:00-06:00 Uhr
- FAQ corrected: "Ja, der Nachtzuschlag ist bereits ab 20:00 Uhr steuerfrei!"
- Added content about 40% rate for 0:00-4:00 Uhr special case

**Files Updated:**
- `v2/pages/tools_zuschlagsrechner.php` (lines 1533, 1536, 426, 458, 1190, 1783, 1832, 1873, FAQs, tooltips)

### 3. Missing Special Holiday Rates ✅ ADDED

**Before:**
- No mention of 150% rate for special holidays

**After:**
- Added dedicated content section explaining special holiday rates (150%)
- Listed dates: 24.12 ab 14 Uhr, 25./26.12, 1. Mai
- Explained difference from regular holidays (125%)

**Files Updated:**
- `v2/pages/tools_zuschlagsrechner.php` (new section added after line 1633)

### 4. Missing 40% Nachtzuschlag Rate ✅ ADDED

**Before:**
- No mention of 40% rate for 0:00-4:00 Uhr night work

**After:**
- Added dedicated content section explaining 40% Nachtzuschlag rate
- Explained conditions: Arbeit muss vor Mitternacht begonnen haben
- Provided examples

**Files Updated:**
- `v2/pages/tools_zuschlagsrechner.php` (new section added after special holidays section)

### 5. Samstagszuschlag Clarification ✅ FIXED

**Before:**
- Content showed: "25% steuerfrei"
- Table showed: "Steuerfrei" badge

**After:**
- Content updated: "Nicht automatisch steuerfrei - hängt vom Tarifvertrag ab"
- Table updated: "Nicht automatisch steuerfrei" badge (yellow)
- Clarified: "Keine gesetzliche Pflicht - nur bei Tarifvertrag oder Arbeitsvertrag"

**Files Updated:**
- `v2/pages/tools_zuschlagsrechner.php` (lines 1577-1579, 1627-1628, 2047, FAQs)

## Code Changes

### Schema Updates

**File:** `v2/pages/tools_zuschlagsrechner.php`
- Line 407: Updated `datePublished` from `'2025-01-01'` to `'2026-01-01'`

### Content Updates

**File:** `v2/pages/tools_zuschlagsrechner.php`

1. **Feiertagszuschlag Rates:**
   - Line 1563-1564: Updated "Steuerfrei bis: 100%" → "Steuerfrei bis: 125% (reguläre Feiertage), 150% (besondere Feiertage)"
   - Line 1622: Updated table cell from "100%" → "125% (regulär), 150% (besonders)"
   - Line 418: Updated FAQ schema answer with complete rate information
   - Line 2046: Updated FAQ answer with 125%/150% rates
   - Line 1895: Updated summary text

2. **Nachtzuschlag Time Periods:**
   - Line 1533: Updated description to clarify steuerfreie Periode vs. ArbZG definition
   - Line 1190: Updated tooltip text
   - Line 426: Updated FAQ schema answer
   - Line 458: Fixed incorrect FAQ answer (was saying "ab 20:00 Uhr gibt es keinen steuerfreien Nachtzuschlag")
   - Line 1783: Updated example text
   - Line 1832: Updated hint text
   - Line 1873: Updated legal reference text

3. **Samstagszuschlag:**
   - Line 1577-1579: Updated to clarify no legal requirement
   - Line 1627-1628: Updated table to show "Nicht automatisch steuerfrei"
   - Line 2047: Updated FAQ answer

4. **New Content Sections:**
   - Added "Besondere Feiertage" section (after line 1633)
   - Added "40% Nachtzuschlag Regel" section (after special holidays section)

5. **Tooltips:**
   - Updated Nachtzuschlag tooltip to mention 40% special case
   - Updated Feiertagszuschlag tooltip to explain 125%/150% limits
   - Updated Samstagszuschlag tooltip to clarify steuerfrei status

6. **FAQ Updates:**
   - Updated Excel FAQ answer with correct rates (125%/150%)
   - Updated all Nachtzuschlag FAQs with accurate time periods
   - Updated Samstagszuschlag FAQ with legal status clarification

### Calculator Defaults

**File:** `v2/js/tools-zuschlags-calculator.js`
- **Decision:** Kept Feiertagszuschlag default at 100% (common practice)
- **Rationale:** Users can adjust, content clarifies steuerfreie limits (125%/150%)

## Documentation Updates

### Updated Files

1. **`docs/guides/tools-pages/zuschlagsrechner-documentation.md`**
   - Updated "Last Updated" date to 2026-01-21
   - Updated Default Surcharge Rates section with verified 2026 rates and steuerfreie limits

2. **`docs/guides/tools-pages/FINAL_2026_RESEARCH_REPORT.md`**
   - Added Zuschlagsrechner section with verified rates
   - Documented all updates made
   - Marked as ✅ COMPLETED

3. **`docs/guides/tools-pages/TOOL_BY_TOOL_ANALYSIS.md`**
   - Updated Zuschlagsrechner section with detailed change log
   - Documented all file locations and line numbers
   - Marked as ✅ COMPLETED

## Verification

### Year References ✅

- ✅ No "2025" references found in PHP file
- ✅ No "2025" references found in JS file
- ✅ All meta tags show "2026"
- ✅ Schema datePublished updated to "2026-01-01"

### Code Quality ✅

- ✅ No linter errors
- ✅ No console.log statements found
- ✅ Minified files regenerated successfully

### Content Accuracy ✅

- ✅ All rate references match §3b EStG
- ✅ Nachtzuschlag time periods clarified
- ✅ Special holiday rates documented
- ✅ Samstagszuschlag legal status clarified
- ✅ All FAQs accurate and complete

## Decisions Made

1. **Feiertagszuschlag Default Rate:** Kept at 100% (common practice), updated content to clarify 125%/150% steuerfreie limits
2. **Nachtzuschlag Time Period:** Clarified both ArbZG (23:00-06:00) and steuerfrei (20:00-06:00) periods
3. **Special Holiday Rates:** Added dedicated section for clarity
4. **Samstagszuschlag Steuerfrei Status:** Added prominent note that steuerfrei status depends on tariff/contract

## Testing Requirements

See `ZUSCHLAGSRECHNER_2026_NEXT_STEPS.md` for comprehensive testing checklist.

### Key Test Scenarios

1. **Default Rates:** Verify calculator works with default rates (25%, 50%, 100%, 25%)
2. **Custom Rates:** Test with custom rates (125%, 150%)
3. **Multiple Types:** Test with multiple surcharge types simultaneously
4. **Exports:** Verify CSV and PDF exports show correct rates
5. **Edge Cases:** Zero hours, very high rates, decimal hours

## Files Modified

### PHP Files
- `v2/pages/tools_zuschlagsrechner.php` (multiple sections updated)

### JavaScript Files
- `v2/js/tools-zuschlags-calculator.js` (no changes needed - defaults correct)

### Documentation Files
- `docs/guides/tools-pages/zuschlagsrechner-documentation.md`
- `docs/guides/tools-pages/FINAL_2026_RESEARCH_REPORT.md`
- `docs/guides/tools-pages/TOOL_BY_TOOL_ANALYSIS.md`

### Generated Files
- `v2/js/tools-zuschlags-calculator.min.js` (regenerated via npm run minify)

## Summary

All critical issues have been resolved:
- ✅ Feiertagszuschlag rates corrected (125%/150%)
- ✅ Nachtzuschlag time periods clarified
- ✅ Special holiday rates documented
- ✅ 40% Nachtzuschlag rate explained
- ✅ Samstagszuschlag legal status clarified
- ✅ All FAQs updated
- ✅ Schema datePublished updated
- ✅ Documentation updated
- ✅ Code quality verified

The Zuschlagsrechner now accurately reflects verified 2026 German regulations per §3b EStG and ArbZG.