mivita/dev/2026-01-22/packstation-anleitung.md
2026-02-20 17:55:06 +01:00

161 lines
4.3 KiB
Markdown

# 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