# Pendlerpauschale Rechner – Documentation

**Last Updated:** 2026-03-25

## Research gate (data-driven content)

Neue SEO-Blöcke, FAQ-Erweiterungen und Wettbewerbsabgleich sollen **nicht** nur aus Bauchgefühl kommen. Canonical Ablage für Keywords, PAA, Competitor-JSON, SERP-Skeleton und Outline:

- [`docs/content/tools/pendlerpauschale-rechner/`](../../content/tools/pendlerpauschale-rechner/) – u. a. `SERP_ANALYSIS.md`, `CONTENT_OUTLINE.md`, `data/keywords-sistrix.json`, `data/paa-questions.json`, `data/competitor-analysis.json`

**Pflichtpfad:** `php v2/scripts/tools/run-tools-improvement-pipeline.php --tool=pendlerpauschale-rechner` (mindestens Phase 1–2), danach Inhalte auf der Seite und diese Doku mit den Artefakten abstimmen. Live-PAA bei Bedarf per Serper (siehe `TOOLS_SERP_MCP_GUIDE.md`). Manuelle Notizen unten können **ergänzen**, ersetzen aber keine persistierten Pipeline-Outputs.

**Skyscraper / Qualität:** Nach jedem größeren Update `CONTENT_OUTLINE.md` und `competitor-analysis.json` kurz gegenlesen; Ziel ist mehr **Nutzentiefe** (Beispiele, Checklisten, Abgrenzungen) als reine Wortzahl. Mapping: `docs/data/tools-internal-link-mapping.json` → `php v2/scripts/tools/audit-tools-internal-links.php` (scannt inzwischen auch `v2/includes/tools/...`-Partials).

## SERP / PAA notes (refresh periodically)

**Primary keyword:** `pendlerpauschale rechner` (~3.250 Volumen, KD 45 laut [resource-creation-plan.md](../../seo-strategy-2026/plans/resource-creation-plan.md)).

**Related queries / secondary:** `entfernungspauschale rechner`, `pendlerpauschale berechnen`, `pendlerpauschale 2026`, `fahrtkosten steuer absetzen`, `anlage n pendlerpauschale`.

**Competitor patterns (Google DE, Recherche 2026-03):** Handelsblatt, smartsteuer.de, bza.de, bruttonettorechner.plus, Qonto u. a. – typische Eingaben: **km einfach**, **Arbeitstage pro Jahr**, teils **Verkehrsmittel** für **4.500 €-Grenze**, Hinweis **2026 einheitlich 0,38 €/km ab 1. km**.

**PAA-style Fragen (für FAQ-Iteration):** Siehe `docs/content/tools/pendlerpauschale-rechner/data/paa-questions.json` und die Matrix in `SERP_ANALYSIS.md` / `CONTENT_OUTLINE.md`. Kurz: Höhe 2025/2026, Hin- und Rückweg, 4.500 €-Grenze, Homeoffice vs. Pendeln, Anlage N, Steuerwirkung.

Speichere zusätzliche SERP-Roh-Exports (SEMrush/Serper) bei Bedarf unter `docs/seo-strategy-2026/data/` (gitignored) und verlinke hier.

## Rechtliche Grundlagen (Tool-Logik)

**Norm:** § 9 EStG (Entfernungspauschale / sogenannte Pendlerpauschale). Keine individuelle Steuerberatung – Nutzer:innen mit Grenzfällen an Steuerberatung/BMF verweisen.

### Sätze im Rechner

| Steuerjahr | Logik (einfache Entfernung, je km) |
|------------|-------------------------------------|
| **2026**   | 0,38 € **ab dem 1. km** (einheitlich, keine Staffelung mehr; Umsetzung gesetzlicher Änderung ab 2026). |
| **2025**   | 0,30 € für die ersten **20 km** der einfachen Entfernung, **0,38 €** für jeden weiteren vollen km (klassische Staffelung). |

### Formel (Implementierung)

- `betrag_einfach` = Pauschale für **eine** Wegstrecke (Wohnung → erste Tätigkeitsstätte) anhand Jahr + km.
- **Pro Arbeitstag (Hin und Rück):** `betrag_einfach * 2`.
- **Pro Jahr:** `betrag_pro_tag * arbeitstage` (vom Nutzer angegeben; typische Orientierung z. B. 230 Tage – keine gesetzliche Obergrenze für die Eingabe im Rechner).
- **Höchstgrenze 4.500 €:** Wenn Verkehrsmittel-Gruppe **nicht** „eigenes Kfz“ gewählt ist (ÖPNV, Fahrrad, Mitfahrer, etc.), wird das **Jahresergebnis** auf **4.500 €** begrenzt. Bei **eigenem Pkw** gilt im Rechner **keine** **4.500 €**-Kappung.

**Quellenabgleich:** Sätze und Verkehrsmittel-Logik regelmäßig mit § 9 EStG und BMF-Schreiben abgleichen (Jahresupdate).

## Tests (Rechner)

```bash
npm run test:pendler-calculator
```

Deckt Kernformeln (2025-Staffelung, 2026 einheitlich, 4.500 €-Kappung, Hin-/Rück-Faktor 2) ab – bei Logikänderungen in `calculator.js` das Skript `v2/scripts/tools/test-pendlerpauschale-calculator.mjs` mitpflegen.

**Manuell / Browser:** Eingaben, URL-Parameter (`km`, `tage`, `jahr`, `modus=pkw|sonst`), **Adresszeile** wird bei gültiger Eingabe per `history.replaceState` mit den gleichen Parametern synchronisiert (Teilen nutzt dieselbe Query). **PDF/CSV** sind **gated** über `POST /v2/api/collect-lead.php` (Pflichtfelder **Name** und **E-Mail**, `tool_name`: `Pendlerpauschale-Rechner`, optional `hubspotConsent` wie in anderen Tools). Nach erfolgreicher Antwort (`success === true`) erfolgt der Download clientseitig (CSV mit Semikolon + UTF-8-BOM; PDF per jsPDF). **Teilen:** `navigator.share` falls verfügbar, sonst Zwischenablage; Zusatzbutton **Link kopieren** wenn kein nativer Share. **localStorage (Wiederholbesuch):** `pendlerpauschale_export_email`, `pendlerpauschale_export_name`, `pendlerpauschale_export_submitted` – bei gesetztem Flag entfällt das Modal, Export läuft direkt. GTM: `GTMFormTracker.trackAPIForm` für den Export wie Einkommensteuer-Rechner. Konsole frei von **Alpine**-Fehlern. Auf localhost erscheinen ggf. HubSpot/Meta-Hinweise (http / Tracking) – auf Produktion mit https prüfen.

## Wartung / Jahresupdate

- Sätze und ggf. Cap nur in `v2/js/pendlerpauschale/constants.js` pflegen.
- Nach gesetzlichen Änderungen: Meta-Titel, Intro, FAQ, JSON-LD und Lexikon-Verlinkung prüfen.
- Siehe auch `.cursor/rules/index-pages-annual-update.mdc` und Tools-SEO-Regeln.

## Export / Teilen (Stand 2026-03)

- **PDF & CSV:** gated über [GATED_EXPORT_MODAL_SPEC.md](./GATED_EXPORT_MODAL_SPEC.md); jsPDF wird von der Seite per CDN (cdnjs) nachgeladen.
- **Keine Homeoffice-Pauschale-Rechnung** im Tool (nur Verweis im Content).

## Nächste Schritte (nach Deploy)

- **Rich Results (FAQPage + HowTo):** [Test mit Live-URL](https://search.google.com/test/rich-results?url=https%3A%2F%2Fwww.ordio.com%2Ftools%2Fpendlerpauschale-rechner) – nach Deploy erneut ausführen; bei Änderungen an `schema-graph.json` / sichtbarem FAQ immer prüfen.
- **Validierung lokal / CI:** `python3 v2/scripts/tools/audit-tools-content-blocks.py pendlerpauschale-rechner --format-check` und `php v2/scripts/tools/validate-tool-content-completeness.php --tool=pendlerpauschale-rechner` (PAA-Logik ist zwischen beiden abgestimmt).
- Lighthouse / CWV auf Mobile spot-check (Ziel: LCP, CLS wie andere Tools).
- Keywords aus `docs/seo/semrush-position-tracking-keywords-500.txt` ins SEMrush-Projekt übernehmen.
- Nächstes priorisiertes Tool siehe [TOOLS_PRIORITIZATION_2026.md](../../content/tools/TOOLS_PRIORITIZATION_2026.md) (z. B. Prozentrechner, Zuschlagsrechner, Urlaubsgeld-Rechner laut Plan).