# Stundennachweis Vorlage

**Last Updated:** 2026-03-26

Template documentation for the Stundennachweis Vorlage (Excel + Google Sheets). Die Vorlage ist schlanker als die Stundenzettel Excel-Vorlage: Fokus **Nachweis/Dokumentation** und Monatsübersicht, ohne DATEV-Charts.

## Publication ship (2026-03-26)

End-to-end Veröffentlichung der Landingpage `/vorlagen/stundennachweis-vorlage` (Routing, Sitemap, llms, Templates-Index, OG, HubSpot `pageNameMap`, Content-Blöcke, FAQs, Pillar-Link). Datenordner: `content/content.md`, `CONTENT_OUTLINE.md`, `SERP_ANALYSIS.md`, `data/seo-meta.json`, `data/section-briefs.json`; nach Sync: [`content-blocks.json`](content-blocks.json) (gleicher Ordner wie diese Datei).

**AEO/GEO:** Answer-first Blöcke, Tabellen/Listen, PAA-Abdeckung in Outline; keine Keyword-Füllwörter über `competitive-depth` Maximum (Validator `validate-template-content-blocks.php`).

**Lokaler Smoke (2026-03-26, `http://localhost:8003`):** Seite 200, Titel korrekt, Karussell „Weitere kostenlose Vorlagen“ vor „Häufig gestellte Fragen“, FAQ-Antworten als Fließtext (kein sichtbares Ro-HTML), „Als Excel herunterladen“ öffnet Gate/Formular. HTML-JSON-LD enthält u. a. `WebPage`, `DigitalDocument`, `SoftwareApplication`, `FAQPage`, `BreadcrumbList`.

**Nach Deploy (Produktion):** [Google Rich Results Test](https://search.google.com/test/rich-results?url=https%3A%2F%2Fwww.ordio.com%2Fvorlagen%2Fstundennachweis-vorlage) mit Live-URL erneut ausführen; bei Abweichungen Schema in `v2/config/template-schema-generator.php` und sichtbare FAQ prüfen.

## Overview

- **Template ID:** `stundennachweis-vorlage`
- **Definition version:** 1.1.0 (Registry/JSON `metadata.version`)
- **Primary Keyword:** Stundennachweis Vorlage
- **Category:** `time_tracking`
- **Source:** Definition unter [`v2/systems/excel-template-generator/data/template-definitions/examples/stundennachweis-vorlage.json`](../../../../v2/systems/excel-template-generator/data/template-definitions/examples/stundennachweis-vorlage.json)

## Copy URL (Google Sheets)

```
https://docs.google.com/spreadsheets/d/18YHS4e7R6QYGlSIShXSKv-LYH2d9VDckDvJGfZ8uETA/copy
```

**Nutzung:** Mit Google-Konto öffnen – es wird eine Kopie in deinem Drive erstellt. Das Original muss für Nutzer mit Link kopierbar sein („Bearbeiten“ bzw. Zugriff für den Dienst-Account, siehe unten).

## Sheet-Struktur

1. **Anleitung** – Schritte, Hinweise zu ArbZG-Pausen, Hinweis zu leeren Zeilen, Abgrenzung zur Stundenzettel-Vorlage, Ordio-Hinweis (`info_cell`), Sprunglinks zu den anderen Blättern (Zeilen A20/A21).
2. **Stundennachweis** – Tabelle bis Zeile 32: Datum, Startzeit, Endzeit, Pause (Min), **Arbeitszeit (Std)** (Formel), Art (Normal, Urlaub, Krank, Feiertag), Bemerkung. **Beispielzeilen** (u. a. Normal, Urlaub, Krank, Feiertag ohne Zeiten, langer Arbeitstag). Wochenenden grau hervorgehoben; **Statusfarben** für Spalte „Art“ und **Pause-Warnung** (rote Schrift), wenn Netto >6h bzw. >9h bei zu kurzer Pause; Netto >8h / >10h in Spalte E farblich markiert (ArbZG-Orientierung).
3. **Übersicht** – Mitarbeitername, Monat (Freitext); **Summe Nettoarbeitszeit**; **Tage mit Datum**; **Ø Stunden pro erfasstem Tag**; **Max. Tagesstunden**; **Anzahl Tage mit Netto >10 h**; **Summe Netto nur bei Art „Normal“** (für Auswertungen ohne Abwesenheit).
4. **Ordio** – In-Template-CTA zu [Arbeitszeiterfassung](https://ordio.com/arbeitszeiterfassung).

## Excel-Datei

Generiert nach:

```bash
php v2/systems/excel-template-generator/scripts/template-cli.php generate \
  v2/systems/excel-template-generator/data/template-definitions/examples/stundennachweis-vorlage.json \
  v2/systems/excel-template-generator/output/generated-templates/stundennachweis-vorlage.xlsx
```

## Registry und Mapping

- **Registry:** [`v2/systems/excel-template-generator/data/template-registry.json`](../../../../v2/systems/excel-template-generator/data/template-registry.json)
- **Google Sheets:** [`v2/data/google-sheets-template-ids.json`](../../../../v2/data/google-sheets-template-ids.json) (`spreadsheet_id` `18YHS4e7R6QYGlSIShXSKv-LYH2d9VDckDvJGfZ8uETA`, kein `source: "external"` – Sync überschreibt das Ziel-Sheet).
- **Ordio-CTA-Mapping:** [`v2/data/template-ordio-feature-mapping.json`](../../../../v2/data/template-ordio-feature-mapping.json) → `template_overrides.stundennachweis-vorlage`

## Sync-Befehl

```bash
php v2/scripts/templates/sync-google-sheets-templates.php --template=stundennachweis-vorlage --force
```

## Voraussetzungen für Sync

- Service-Account **`ordio-seo-analytics@ordio-472310.iam.gserviceaccount.com`** als **Bearbeiter** auf der Zieltabelle.
- Google API-Credentials wie in der Projekt-Doku ([GOOGLE_SHEETS_INTEGRATION.md](../../google-sheets-integration/GOOGLE_SHEETS_INTEGRATION.md)).

## Validierung

- Einzel-Template: `php v2/systems/excel-template-generator/scripts/template-cli.php validate …/stundennachweis-vorlage.json …/stundennachweis-vorlage.xlsx`
- Nach Sync: `php v2/scripts/templates/validate-google-sheets-sync.php` (falls für dieses Template konfiguriert)
- Content: `php v2/scripts/templates/sync-template-content-blocks.php --template=stundennachweis-vorlage`
- `php v2/scripts/templates/validate-template-content-blocks.php --template=stundennachweis-vorlage`
- `php v2/scripts/templates/validate-template-content-completeness.php --template=stundennachweis-vorlage`
- `php v2/scripts/templates/validate-template-internal-links.php --template=stundennachweis-vorlage`
- `php v2/scripts/templates/compare-template-to-competitors.php --template=stundennachweis-vorlage`
- FAQ: `php v2/scripts/templates/validate-template-faq-schema.php --template=stundennachweis-vorlage` und `validate-template-faq-quality.php`
- LLMS: `python3 v2/scripts/llms/validate-llms-metadata.py --report`
- Redirects: `python3 v2/scripts/dev-helpers/test-landing-page-redirects.py`

## Weitere interne Notizen

- [`data/SHEET_DISCOVERY.md`](data/SHEET_DISCOVERY.md) – Export/Parität
- [`data/KEYWORD_SEO.md`](data/KEYWORD_SEO.md) – SEO-Abgrenzung