23-01-2026

2026-01-23 17:35:23 +01:00 · 2026-01-23 17:35:23 +01:00 · a8b395e20d
commit a8b395e20d
parent a939cd51ef
248 changed files with 29342 additions and 4805 deletions
--- a/dev/22-01-2026/packstation-anleitung.md
+++ b/dev/22-01-2026/packstation-anleitung.md
@ -0,0 +1,161 @@
+# DHL Packstation / Paketbox - Korrekte Eingabe
+
+## ❌ HÄUFIGER FEHLER
+
+**Fehler:** `Packstation-Nummer muss eine 3-stellige Zahl zwischen 100 und 999 sein`
+
+**Ursache:** Die Packstation-NUMMER (am Gerät) wird mit der DHL Postnummer (Kundennummer) verwechselt!
+
+---
+
+## ✅ KORREKTE EINGABE
+
+### Was ist was?
+
+| Feld | Was eintragen | Beispiel | Wo zu finden |
+|------|---------------|----------|--------------|
+| **DHL Postnummer** | 6-10-stellige Kundennummer | `1234567890` | DHL App / Registrierung |
+| **Straße / Nr.** | Packstation + 3-stellige Nummer | `Packstation 145` | Gelbes Schild am Gerät |
+| **PLZ / Ort** | Standort der Packstation | `12345 Berlin` | Gelbes Schild am Gerät |
+
+---
+
+## 📋 SCHRITT-FÜR-SCHRITT ANLEITUNG
+
+### 1. DHL Postnummer (oben im Formular)
+```
+✅ Richtig: 1234567890
+✅ Richtig: 123456
+❌ Falsch:  145 (das ist die Packstation-Nummer!)
+```
+
+### 2. Lieferadresse → Straße / Nr.
+```
+✅ Richtig: Packstation 145
+✅ Richtig: Paketbox 278
+❌ Falsch:  Packstation 12345 (zu lang!)
+❌ Falsch:  Packstation (Nummer fehlt!)
+```
+
+### 3. Lieferadresse → PLZ / Ort
+```
+✅ Richtig: 33739 Bielefeld (Standort der Packstation)
+❌ Falsch:  10115 Berlin (Ihre Wohnadresse)
+```
+
+---
+
+## 🔍 WO FINDE ICH DIE NUMMERN?
+
+### Packstation-Nummer (3-stellig: 100-999)
+📍 **Am gelben DHL-Schild** auf dem Packstation-Gerät
+```
+┌─────────────────────────┐
+│  DHL Packstation        │
+│  Nr. 145                │ ← DIESE NUMMER!
+│  Hauptstraße 1          │
+│  12345 Beispielstadt    │
+└─────────────────────────┘
+```
+
+### DHL Postnummer (6-10-stellig)
+📱 **In der DHL App** unter "Mein Konto" → "Postnummer"
+🌐 **Auf dhl.de** nach der Registrierung
+📧 **Per E-Mail** nach Aktivierung
+
+---
+
+## 💡 BEISPIELE
+
+### Beispiel 1: Standard Packstation
+```
+[Formular]
+DHL Postnummer:    1234567890
+──────────────────────────────
+Straße / Nr.:      Packstation 145
+PLZ:               33739
+Ort:               Bielefeld
+```
+
+### Beispiel 2: Paketbox
+```
+[Formular]
+DHL Postnummer:    9876543210
+──────────────────────────────
+Straße / Nr.:      Paketbox 278
+PLZ:               10115
+Ort:               Berlin
+```
+
+### Beispiel 3: Kurze Postnummer (auch gültig)
+```
+[Formular]
+DHL Postnummer:    123456
+──────────────────────────────
+Straße / Nr.:      Packstation 500
+PLZ:               80331
+Ort:               München
+```
+
+---
+
+## ⚠️ HÄUFIGE FEHLER & LÖSUNGEN
+
+| Fehler | Problem | Lösung |
+|--------|---------|--------|
+| "lockerID must be 100-999" | Packstation-Nummer zu lang/kurz | Nur 3 Ziffern eingeben (z.B. "145") |
+| "postNumber must be 6-10 digits" | Postnummer zu kurz/lang | 6-10 Ziffern, keine Leerzeichen |
+| "RF-UndefinedResource" | Packstation existiert nicht | PLZ & Ort der Packstation prüfen |
+
+---
+
+## 🛠️ TECHNISCHE DETAILS (für Entwickler)
+
+### DHL API v2 Locker Schema
+```json
+{
+  "consignee": {
+    "name": "Max Mustermann",
+    "lockerID": 145,              // Integer 100-999
+    "postNumber": "1234567890",   // String 6-10 digits
+    "postalCode": "12345",
+    "city": "Beispielstadt",
+    "country": "DEU"
+  }
+}
+```
+
+### Validierung
+```php
+// Packstation-Nummer: 3-stellig
+if ($lockerID < 100 || $lockerID > 999) {
+    throw new InvalidArgumentException('Packstation-Nummer muss 3-stellig sein');
+}
+
+// DHL Postnummer: 6-10 Ziffern
+if (!preg_match('/^[0-9]{6,10}$/', $postNumber)) {
+    throw new InvalidArgumentException('DHL Postnummer muss 6-10 Ziffern haben');
+}
+```
+
+---
+
+## 🎯 CHECKLISTE VOR DEM ABSENDEN
+
+- [ ] DHL Postnummer ist 6-10-stellig (z.B. `1234567890`)
+- [ ] Straße enthält "Packstation" + 3-stellige Nummer (z.B. `Packstation 145`)
+- [ ] PLZ + Ort ist der **Standort der Packstation**, nicht Ihre Wohnadresse
+- [ ] Alle Felder sind ausgefüllt
+
+---
+
+## 📞 SUPPORT
+
+Bei Fragen zur DHL Postnummer:
+- 📞 DHL Hotline: 0228 4333112
+- 🌐 dhl.de/packstation
+- 📱 DHL App → Mein Konto
+
+Bei technischen Problemen:
+- Prüfen Sie zuerst die Eingabe anhand dieser Anleitung
+- Screenshots des Fehlers und der Eingabe helfen bei der Fehlersuche