Integrácia DHL Parcel Poland

Modul DHL integruje WooCommerce s REST API DHL Parcel Poland. Generujte etikety, sledujte zásielky a ponúkajte body ServicePoint na pokladni.

Konfigurácia

Prejdite na WooCommerce > Nastavenia > Polski PRO > Doprava.

Autentifikácia API

Nastavenie	Popis
API kľúč DHL	Bearer token z DHL Developer Portal
Číslo konta DHL	Číslo zákazníckeho konta DHL Parcel Poland

API kľúč získate registráciou na developer.dhl.com a vytvorením aplikácie s prístupom k DHL Parcel Poland API.

Zapnutie modulu

Prejdite na Polski PRO > Moduly
Zapnite modul DHL Parcel Poland
Doplňte API kľúč a číslo konta v nastaveniach dopravy

Generovanie etikiet

Etikety generujete z editora objednávky:

Otvorte objednávku v WooCommerce > Objednávky
V sekcii Shipment Tracking vyberte prepravcu DHL
Kliknite na Generovať etiketu
Systém vytvorí zásielku cez DHL REST API a vráti číslo sledovania + odkaz na PDF etiketu

Typy služieb

Typ	Popis
AH	Štandardné doručenie na adresu (predvolené)
AP	Doručenie do ServicePoint / DHL paczkomatu

Pre služby AP (ServicePoint) je potrebné zadať ID odberného miesta.

Údaje zásielky

Modul automaticky preberá z objednávky údaje príjemcu a hmotnosť produktov. Predvolené rozmery balíka: 40x30x20 cm.

DHL ServicePoint

Modul umožňuje vyhľadávanie bodov ServicePoint (POP a DHL paczkomaty):

Vyhľadávanie podľa mesta
Vyhľadávanie podľa GPS súradníc (polomer 5 km)
Vrátené údaje: názov, adresa, typ (POP/paczkomat), súradnice

Sledovanie zásielok

Po vygenerovaní etikety sa číslo sledovania automaticky ukladá. Odkaz na DHL tracking sa generuje vo formáte:

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

Zákazník dostane e-mail s číslom sledovania pri zmene stavu na Odoslané.

Kódy chýb

Kód	Popis	Riešenie
HTTP 401	Nesprávny API kľúč	Skontrolujte Bearer token v nastaveniach
HTTP 400	Nesprávne údaje zásielky	Skontrolujte adresu, PSČ a číslo konta
HTTP 429	Limit požiadaviek API	Počkajte chvíľu a skúste znova

Filtre a akcie

// 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);