# Personalbogen Vorlage

**Last Updated:** 2026-03-19

Template documentation for the Personalbogen Vorlage Google Sheets template. This template is synced from the Excel definition and supports both Excel (.xlsx) and Google Sheets formats.

## Overview

- **Template ID:** `personalbogen-vorlage`
- **Primary Keyword:** Personalbogen Vorlage
- **Category:** employee_management
- **Source:** Synced from definition (`v2/systems/excel-template-generator/data/template-definitions/examples/personalbogen-vorlage.json`)

## Copy URL

```
https://docs.google.com/spreadsheets/d/1JD14uYNgsvqo_X4CD0cigXy6eEFt9I5SQEIhbOK8pHc/copy
```

**Usage:** When a user opens this URL while signed into Google, a copy of the template is created in their Drive. The sheet must be shared with "Anyone with link can view" (or equivalent) for the copy flow to work.

## Sheet Structure

The template includes three sheets:

1. **Anleitung** – Usage instructions with DSGVO note, Steuer-ID (11 digits) hint, Feld-Erklärungen (Steuer-ID, Rentenversicherungsnummer, Geschlecht, Steuerklasse, Wochenstunden), and tailored Ordio CTA (info_cell): "Mit Ordio Digitale Personalakte kannst du Personalbogen und Stammdaten zentral verwalten – DSGVO-konform und jederzeit abrufbar." Steps: 1) Persönliche Daten, 2) Steuer & SV, 3) Beschäftigung, 4) Bankverbindung.

2. **Personalbogen** – Data entry sheet with sections:
   - **Persönliche Daten:** Name, Vorname, Geburtsdatum, Geburtsort, Geschlecht (m/w/d), Staatsangehörigkeit, Straße, PLZ, Ort, Telefon, E-Mail
   - **Steuer:** Steuer-ID (11 Ziffern), Steuerklasse (I–VI), Konfession (römisch-katholisch/evangelisch/ohne), Kinder
   - **Sozialversicherung:** Rentenversicherungsnummer, Krankenkasse
   - **Beschäftigung:** Eintrittsdatum, Vertragsform (befristet/unbefristet), Position, Abteilung, Berufsbezeichnung, Wochenstunden, Arbeitsart (Vollzeit/Teilzeit/Minijob)
   - **Bankverbindung:** IBAN, BIC

3. **Ordio** (ordio_cta) – In-template promotion sheet with headline "Digitale Personalakte mit Ordio", 2–3 benefit bullets, and primary CTA link (https://ordio.com/digitale-personalakte). See [IN_TEMPLATE_ORDIO_CTA_GUIDE.md](../../../../guides/templates/IN_TEMPLATE_ORDIO_CTA_GUIDE.md).

## Data Validation

- **Geschlecht:** Dropdown (m, w, d)
- **Steuerklasse:** Dropdown (I, II, III, IV, V, VI)
- **Konfession:** Dropdown (römisch-katholisch, evangelisch, ohne)
- **Vertragsform:** Dropdown (befristet, unbefristet)
- **Arbeitsart:** Dropdown (Vollzeit, Teilzeit, Minijob)
- **Geburtsdatum, Eintrittsdatum:** Date validation (1900–2100)
- **Steuer-ID:** Custom formula (11 digits, allows spaces, optional when blank)
- **Kinder:** Whole number 0–20 (Kinderfreibeträge)
- **Wochenstunden:** Decimal 0–48 (ArbZG-compliant)

## Example Row

One filled example (Max Mustermann, 1990-01-15, Berlin, etc.) with 2026 Eintrittsdatum.

## DSGVO / Legal Notes

- DSGVO-konform: Erfasse nur Daten, die für das Beschäftigungsverhältnis erforderlich sind.
- Legal notice in metadata: "DSGVO-konform. Erfasse nur Daten, die für das Beschäftigungsverhältnis erforderlich sind."

## Registry and Mapping

- **Registry:** `v2/systems/excel-template-generator/data/template-registry.json` (status: published)
- **Google Sheets mapping:** `v2/data/google-sheets-template-ids.json`
- **Sync behavior:** Sync will update the Google Sheet when the definition changes. Use `--force` for immediate overwrite.

## Sync Command

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

## Prerequisites for Sync

The sheet must be shared with the service account (Editor) for sync to succeed:
- **Service account:** `ordio-seo-analytics@ordio-472310.iam.gserviceaccount.com`
- **Permission:** Editor
