# 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
