Integracja DHL Parcel Poland

Moduł DHL integruje WooCommerce z REST API DHL Parcel Poland. Generuj etykiety, śledź przesyłki i oferuj punkty ServicePoint na checkoucie.

Konfiguracja

Przejdź do WooCommerce > Ustawienia > Polski PRO > Wysyłka.

Uwierzytelnianie API

Ustawienie	Opis
Klucz API DHL	Bearer token z DHL Developer Portal
Numer konta DHL	Numer konta klienta DHL Parcel Poland

Klucz API uzyskasz rejestrując się na developer.dhl.com i tworząc aplikację z dostępem do DHL Parcel Poland API.

Włączenie modułu

Przejdź do Polski PRO > Moduły
Włącz moduł DHL Parcel Poland
Uzupełnij klucz API i numer konta w ustawieniach wysyłki

Generowanie etykiet

Etykiety generujesz z poziomu edytora zamówienia:

Otwórz zamówienie w WooCommerce > Zamówienia
W sekcji Shipment Tracking wybierz przewoźnika DHL
Kliknij Generuj etykietę
System utworzy przesyłkę przez DHL REST API i zwróci numer śledzenia + link do etykiety PDF

Typy usług

Typ	Opis
AH	Standardowa dostawa pod adres (domyślny)
AP	Dostawa do ServicePoint / paczkomatu DHL

Dla usług AP (ServicePoint) wymagane jest podanie ID punktu odbioru.

Dane przesyłki

Moduł automatycznie pobiera z zamówienia dane odbiorcy i wagę produktów. Domyślne wymiary paczki: 40x30x20 cm.

DHL ServicePoint

Moduł umożliwia wyszukiwanie punktów ServicePoint (POP i paczkomaty DHL):

Wyszukiwanie po mieście
Wyszukiwanie po współrzędnych GPS (promień 5 km)
Zwracane dane: nazwa, adres, typ (POP/paczkomat), współrzędne

Śledzenie przesyłek

Po wygenerowaniu etykiety numer śledzenia jest automatycznie zapisywany. Link do trackingu DHL jest generowany w formacie:

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

Klient otrzymuje email z numerem śledzenia przy zmianie statusu na Wysłane.

Kody błędów

Kod	Opis	Rozwiązanie
HTTP 401	Nieprawidłowy klucz API	Sprawdź Bearer token w ustawieniach
HTTP 400	Nieprawidłowe dane przesyłki	Sprawdź adres, kod pocztowy i numer konta
HTTP 429	Limit zapytań API	Poczekaj chwilę i spróbuj ponownie

Filtry i akcje

// Filtruj dane przesyłki przed wysłaniem do DHL
add_filter('polski_pro/shipping/dhl/parcel_data', function (array $data, WC_Order $order): array {
    $data['service_type'] = 'AP'; // Wymuś dostawę do ServicePoint
    $data['servicepoint_id'] = 'PL-12345';
    return $data;
}, 10, 2);