93 lines
2.6 KiB
Markdown
93 lines
2.6 KiB
Markdown
# DHL Sendungs-Stornierung - Troubleshooting
|
|
|
|
## Problem: "RF-UndefinedResource" Fehler
|
|
|
|
### Aktuelle Situation:
|
|
- **Config:** Sandbox-Modus aktiv (`DHL_SANDBOX=true`)
|
|
- **Base URL:** `https://api-sandbox.dhl.com`
|
|
- **Sendung:** ID 11, Nr. `0034043333301020021021115`
|
|
- **Status:** `created` (stornierbar)
|
|
- **Fehler:** "RF-UndefinedResource"
|
|
|
|
### Ursachen:
|
|
|
|
#### 1. **Sandbox-Einschränkungen**
|
|
Im DHL Sandbox-Modus:
|
|
- Sendungen sind nur für begrenzte Zeit verfügbar
|
|
- Test-Sendungen werden nach kurzer Zeit automatisch gelöscht
|
|
- Stornierung ist nur innerhalb weniger Stunden möglich
|
|
|
|
#### 2. **Zeitfenster überschritten**
|
|
- Sendung erstellt: `2026-01-23 13:08:07`
|
|
- Wenn mehr als 2-3 Stunden vergangen: Nicht mehr stornierbar
|
|
|
|
#### 3. **Sandbox vs. Production Mismatch**
|
|
- Sendung im Sandbox erstellt
|
|
- Versuch im Production-Modus zu stornieren (oder umgekehrt)
|
|
|
|
### Lösungen:
|
|
|
|
#### Option 1: Neue Test-Sendung erstellen
|
|
```bash
|
|
# Neue Sendung erstellen und SOFORT stornieren (innerhalb von Minuten)
|
|
# Im DHL Cockpit: Neue Sendung erstellen → Sofort Storno-Button klicken
|
|
```
|
|
|
|
#### Option 2: Production-Modus testen (nur mit echten Credentials!)
|
|
```env
|
|
# .env
|
|
DHL_SANDBOX=false
|
|
DHL_BASE_URL=https://api-eu.dhl.com
|
|
DHL_API_KEY=<production_key>
|
|
DHL_USERNAME=<production_user>
|
|
DHL_PASSWORD=<production_password>
|
|
```
|
|
|
|
#### Option 3: Status manuell setzen (nur für Entwicklung)
|
|
```bash
|
|
php artisan tinker
|
|
```
|
|
```php
|
|
$shipment = Acme\Dhl\Models\DhlShipment::find(11);
|
|
$shipment->update(['status' => 'canceled']);
|
|
```
|
|
|
|
### Empfehlung:
|
|
|
|
**Für Sandbox-Tests:**
|
|
1. Sendung erstellen
|
|
2. **SOFORT** (innerhalb von 1-2 Minuten) stornieren
|
|
3. Nicht länger warten
|
|
|
|
**Für Production:**
|
|
- Stornierung funktioniert zuverlässig innerhalb von 24 Stunden
|
|
- Sendungen bleiben länger in der API verfügbar
|
|
|
|
### Debug-Commands:
|
|
|
|
```bash
|
|
# Prüfe Sendung
|
|
php artisan tinker --execute="
|
|
\$s = Acme\Dhl\Models\DhlShipment::find(11);
|
|
echo 'Status: ' . \$s->status . PHP_EOL;
|
|
echo 'Created: ' . \$s->created_at . PHP_EOL;
|
|
echo 'Age: ' . \$s->created_at->diffForHumans() . PHP_EOL;
|
|
"
|
|
|
|
# Prüfe Config
|
|
php artisan tinker --execute="
|
|
\$c = (new \App\Http\Controllers\SettingController())->getDhlConfig();
|
|
echo 'Mode: ' . (\$c['base_url'] == 'https://api-sandbox.dhl.com' ? 'SANDBOX' : 'PRODUCTION') . PHP_EOL;
|
|
"
|
|
```
|
|
|
|
### Workaround für alte Sandbox-Sendungen:
|
|
|
|
Da alte Sandbox-Sendungen nicht mehr storniert werden können, setzen wir den Status manuell:
|
|
|
|
```php
|
|
// Alle alten "created" Sendungen als "failed" markieren
|
|
Acme\Dhl\Models\DhlShipment::where('status', 'created')
|
|
->where('created_at', '<', now()->subHours(6))
|
|
->update(['status' => 'failed']);
|
|
```
|