DHL Parcel Poland Integration

Das DHL-Modul verbindet WooCommerce mit der REST-API von DHL Parcel Poland. Erstellen Sie Etiketten, verfolgen Sie Sendungen und bieten Sie ServicePoint-Standorte an der Kasse an.

Konfiguration

Gehen Sie zu WooCommerce > Einstellungen > Polski PRO > Versand.

API-Authentifizierung

Einstellung	Beschreibung
DHL-API-Schlüssel	Bearer-Token aus dem DHL Developer Portal
DHL-Kontonummer	Kundenkontonummer bei DHL Parcel Poland

Den API-Schlüssel erhalten Sie, indem Sie sich unter developer.dhl.com registrieren und eine Anwendung mit Zugriff auf die DHL Parcel Poland API erstellen.

Modul aktivieren

Gehen Sie zu Polski PRO > Module
Aktivieren Sie das Modul DHL Parcel Poland
Tragen Sie den API-Schlüssel und die Kontonummer in den Versandeinstellungen ein

Etiketten erstellen

Etiketten erstellen Sie im Bestellungseditor:

Öffnen Sie eine Bestellung unter WooCommerce > Bestellungen
Wählen Sie im Abschnitt Shipment Tracking den Versanddienstleister DHL
Klicken Sie auf Etikett erstellen
Das System erstellt eine Sendung über die DHL REST-API und gibt eine Sendungsnummer sowie einen Link zum PDF-Etikett zurück

Servicearten

Art	Beschreibung
AH	Standardzustellung an eine Adresse (Standard)
AP	Zustellung an einen DHL ServicePoint / Paketautomaten

Für AP-Services (ServicePoint) müssen Sie die ID des Abholpunkts angeben.

Sendungsdaten

Das Modul übernimmt die Empfängerdaten und das Produktgewicht automatisch aus der Bestellung. Standard-Paketmaße: 40x30x20 cm.

DHL ServicePoint

Das Modul ermöglicht die Suche nach ServicePoint-Standorten (DHL POPs und Paketautomaten):

Suche nach Stadt
Suche nach GPS-Koordinaten (Radius 5 km)
Zurückgegebene Daten: Name, Adresse, Typ (POP/Paketautomat), Koordinaten

Sendungsverfolgung

Nach dem Erstellen eines Etiketts wird die Sendungsnummer automatisch gespeichert. Der DHL-Tracking-Link wird im folgenden Format erzeugt:

https://www.dhl.com/pl-pl/home/sledzenie-przesylek.html?tracking-id={number}

Der Kunde erhält eine E-Mail mit der Sendungsnummer, wenn sich der Status auf Versendet ändert.

Fehlercodes

Code	Beschreibung	Lösung
HTTP 401	Ungültiger API-Schlüssel	Prüfen Sie den Bearer-Token in den Einstellungen
HTTP 400	Ungültige Sendungsdaten	Prüfen Sie Adresse, Postleitzahl und Kontonummer
HTTP 429	API-Anfragelimit	Warten Sie einen Moment und versuchen Sie es erneut

Filter und Aktionen

// Filter shipment data before sending it to DHL
add_filter('polski_pro/shipping/dhl/parcel_data', function (array $data, WC_Order $order): array {
    $data['service_type'] = 'AP'; // Force delivery to a ServicePoint
    $data['servicepoint_id'] = 'PL-12345';
    return $data;
}, 10, 2);