Jak połączyć sklep z kurierem DHL

Połączenie sklepu internetowego z kurierem DHL pozwala zautomatyzować wysyłki, ograniczyć błędy i skrócić czas od złożenia zamówienia do nadania paczki. W praktyce oznacza to generowanie listów przewozowych bezpośrednio w panelu sklepu, automatyczny import danych adresowych, śledzenie statusów i sprawne planowanie odbiorów. Poniższy poradnik pokazuje, jak przejść przez proces od wyboru metody, przez konfigurację, po testy i utrzymanie. Kluczem jest dobrze zaplanowana integracja oraz konsekwentne testy.

Przygotowanie: wybór metody i dane od DHL

Warianty połączenia z DHL

Zanim rozpoczniesz konfigurację, wybierz metodę pracy z DHL, dopasowaną do skali i technologii sklepu:

• Wtyczka do platformy e‑commerce – najszybsza droga. Dla WooCommerce, PrestaShop, Magento/Adobe Commerce i Shopify dostępne są aplikacje oficjalne lub partnerskie obsługujące wystawianie listów, stawki i punkty odbioru.
• Integrator zamówień (np. system OMS/WMS lub narzędzie agregujące typu Baselinker) – dobry wybór przy sprzedaży wielokanałowej i większym wolumenie, z dodatkowym routingiem przewoźników.
• Bezpośrednie połączenie przez własne oprogramowanie – pełna kontrola, możliwość dostosowań, wymaga pracy programistycznej i znajomości specyfikacji DHL.

Jaki dział DHL i jaką umowę wybrać

DHL działa w kilku liniach biznesowych. Upewnij się, z którą jednostką podpisujesz umowę i jakiego API dotyczy dokumentacja:

• DHL Parcel (Polska) – przesyłki krajowe i większość europejska, dostęp do portalu nadawczego (np. DHL24) oraz integracji e‑commerce.
• DHL Express – przesyłki międzynarodowe o podwyższonym priorytecie (Time Definite), inny cennik i osobne API.
• DHL eCommerce Solutions – obsługa cross‑border B2C, punkty nadawczo‑odbiorcze, osobne aplikacje i zakres usług.

Poproś opiekuna handlowego o przesłanie: numeru klienta, zakresu usług (np. paczka standard, doręczenie czasowe, odbiór w punkcie), danych dostępowych do panelu i interfejsów, informacji o środowisku testowym oraz o sposobie rozliczeń dodatkowych usług (COD, ubezpieczenia, dopłaty).

Dane dostępu i uprawnienia

Do konfiguracji zazwyczaj potrzebne będą:

• Identyfikator klienta (np. numer rachunku rozliczeniowego/contract number),
• login do panelu nadawcy oraz klucze/hasła do interfejsów (REST/SOAP) przypisane do konta,
• dostęp do środowiska testowego (sandbox) i produkcyjnego,
• uprawnienia do usług dodatkowych: np. pobranie, ubezpieczenie, doręczenie w sobotę, zwrot dokumentów itp.

Ustal, czy będziesz rozliczać jedną, czy wiele lokalizacji nadania. Jeśli masz kilka magazynów, zaplanuj mapowanie kodów nadawcy i adresów “shipper” w zależności od stanu produktów i miejsca kompletacji.

Wymagania operacyjne i sprzęt

Przygotuj wagę weryfikującą, miarkę (wymiary wpływają na wycenę i dopłaty), a w przypadku drukarek termicznych – kompatybilną drukarkę etykiet (ZPL/EPL) lub druk w PDF na A4. Zweryfikuj: godziny graniczne (cut‑off) dla odbioru w Twoim regionie, rodzaje opakowań, procedury dla towarów niestandardowych oraz proces wydruku i archiwizacji list przewozowych i dziennych protokołów odbioru.

Konfiguracja na popularnych platformach e‑commerce

WooCommerce (WordPress)

Najczęściej stosuje się oficjalne/partnerskie wtyczki DHL Parcel lub integratory:

• Zainstaluj i aktywuj wtyczkę z repozytorium lub od dostawcy. Zadbaj o zgodność wersji PHP i WooCommerce.
• Wprowadź dane klienta i klucze. Wybierz środowisko testowe do pierwszej konfiguracji.
• Skonfiguruj metody wysyłki: krajowe, zagraniczne, odbiór w punkcie. Ustal, czy ceny mają się liczyć dynamicznie z API stawek, czy wg tabeli stawek własnych.
• Dobierz domyślny typ paczki i algorytm pakowania (na podstawie wagi, wymiarów, liczby sztuk). Zmapuj kategorie produktów wykluczonych (np. ADR).
• Włącz automatyczne generowanie etykiety po zmianie statusu zamówienia (np. “W realizacji”), albo tryb ręczny.
• Skonfiguruj nadania zbiorcze, druk protokołu dziennego i planowanie odbioru kuriera.
• Przeprowadź testy: zamówienie, generacja listu, druk, śledzenie i anulacja.

Shopify

W Shopify instalujesz aplikację DHL (Express/Parcel/eCommerce – zgodnie z umową). Zwróć uwagę, czy plan sklepu pozwala na prezentację stawek przewoźnika w checkout (Carrier Calculated Shipping). Kroki:

• Zainstaluj aplikację z Shopify App Store, nadaj wymagane uprawnienia.
• Dodaj dane konta DHL i wybierz usługi dostępne dla kraju wysyłki i adresów docelowych.
• Skonfiguruj profil wysyłkowy i stawki: dynamiczne z DHL lub stałe. Określ rozmiary paczek i reguły pakowania.
• Włącz generowanie listów w panelu zamówień, etykiety drukuj z aplikacji lub przez PrintNode/drukarkę ZPL.
• Włącz śledzenie i powiadomienia e‑mail/SMS z linkiem do trackingu DHL.

PrestaShop

Dostępne są moduły DHL Parcel/Express i integratory:

• Zainstaluj moduł, wprowadź dane konta i wybierz środowisko testowe.
• Skonfiguruj przewoźników w PrestaShop i przypisz ich do stref/krajów oraz metod płatności (np. blokada pobrania poza PL).
• Utwórz profile paczek, reguły kosztów (waga, wartość koszyka, kody pocztowe), limity wymiarów.
• W panelu zamówień włącz tworzenie listu i druk, generuj protokoły oraz zgłaszaj odbiór kuriera.

Magento/Adobe Commerce

Ze względu na złożoność warto korzystać z modułów enterprise‑grade:

• Zainstaluj moduł, skonfiguruj multi‑origin shipping, mapowanie magazynów do kont DHL.
• Połącz metody dostawy z atrybutami produktu (wymiary, waga, towar wrażliwy), zdefiniuj fallback, gdy brakuje danych.
• Włącz prezentację punktów odbioru na stronie koszyka/checkout i zapisz wybór w atrybucie zamówienia.
• Skonfiguruj automatyzacje: autogeneracja listu, reguły łączenia zamówień, druk na kolejkach (np. przez RabbitMQ).

Integratory i OMS/WMS

Jeśli korzystasz z integratora, połącz sklep, marketplace’y i DHL w jednym miejscu. Zaletą jest centralne mapowanie metod, masowe akcje, kolejkowanie i monitorowanie błędów. Wybierz strategię priorytetyzacji przewoźników (np. reguły koszt/czas) i fallback na inną firmę przy niedostępności usług.

Połączenie bezpośrednie: praca z API DHL

Architektura i uwierzytelnianie

Po uzyskaniu dokumentacji sprawdź wymagane endpointy: tworzenie przesyłki, pobranie etykiety, tracking, planowanie odbioru i manifest. Dostęp realizowany jest zazwyczaj poprzez tokenowe lub basic‑auth. Przechowuj sekrety w bezpiecznym sejfie (np. KMS/Secrets Manager), rotuj je i ograniczaj uprawnienia środowisk. Dla jasności nazewnictwa – w dokumentacji i kodzie stosuj spójne definicje pól adresowych i usług.

W API wyraźnie rozdziel środowiska: SANDBOX do testów i PRODUCTION do nadawania. W testach korzystaj z danych adresowych i zakresów kodów pocztowych wskazanych w dokumentacji, aby uzyskać realistyczne odpowiedzi.

Jeśli planujesz rozbudowę o dodatkowe systemy (WMS, BI), zaprojektuj cienką warstwę usługową po swojej stronie, która ekranizuje szczegóły DHL i ułatwia wymianę przewoźnika bez zmian w sklepie.

W tej sekcji kluczowe pojęcia to API i poprawna autoryzacja – od nich zależy stabilność i bezpieczeństwo całego procesu.

Tworzenie przesyłki

Minimalnie wymagane pola to: nadawca, odbiorca, wymiary/masa, zawartość, wartość (dla ubezpieczenia i odprawy), metoda doręczenia (kurier, punkt), usługi dodatkowe. Dobre praktyki:

• Waliduj kody pocztowe i numery telefonów po stronie sklepu; ogranicz błędy 4xx z API.
• Standaryzuj nazwy i długości pól adresowych (imię/nazwisko, ulica + nr, miasto, kraj, e‑mail, telefon).
• Zdefiniuj limity wymiarów i wagę wolumetryczną, aby zapobiegać dopłatom.
• Dla płatności za pobraniem wypełnij pola usługi COD (pobranie) oraz numer rachunku, na który mają trafić środki.
• Jeżeli oferujesz ochronę wartości, dodaj ubezpieczenie z właściwą sumą i walutą.
• Wysyłki międzynarodowe: określ zawartość towarów (HS code, kraj pochodzenia, wartość, ilości), tryb handlowy (dokumenty/towary), Incoterms.

Etykiety i druk

Po utworzeniu przesyłki pobierz etykietę w formacie wspieranym przez Twoją drukarkę: PDF (A4) lub ZPL/EPL (termiczna). Zaplanuj proces drukowania masowego, kolejki wydruku i retry. Przechowuj miniatury/numery listów w bazie zamówień, aby umożliwić ponowny wydruk bez kolejnego requestu do API. Uzgodnij rozmiar i orientację etykiet, a także miejsce umieszczenia dodatkowych naklejek (np. ostrożnie, szkło).

Odbiór, manifest i EDI

Zwykle codzienny odbiór wymaga zgłoszenia kuriera i wygenerowania protokołu nadania. Upewnij się, że Twoje API‑flow obsługuje tworzenie i druk manifestu (zestawienie paczek), a w razie braku wizyty kuriera – umożliwia zmianę terminu. Przekazanie danych EDI przyspiesza sortowanie, więc zamykaj manifest przed cut‑off, aby przesyłki trafiły do sieci tego samego dnia.

Śledzenie i powiadomienia

Po otrzymaniu numeru listu aktywuj tracking. Wykorzystaj webhooki lub pull‑tracking w interwałach dopasowanych do SLA. Użytkownika informuj o kluczowych statusach: przyjęcie, w doręczeniu, awizo, doręczone, wstrzymane. Integruj link do trackingu w e‑mail/SMS i w koncie klienta. Dobrą praktyką jest obsługa stanów wyjątkowych (np. niepełny adres) z propozycją szybkiej korekty przez panel klienta.

Na tym etapie ważne są dwa elementy: ciągłe śledzenie zmian statusów oraz asynchroniczne webhooki redukujące opóźnienia i obciążenie serwera.

Zwroty i międzynarodowe formalności

Przygotuj proces RMA: tworzenie etykiety zwrotnej, wybór opcji (kurier/punkt), ograniczenia czasowe, weryfikację stanu produktu. Dla sprzedaży poza UE skonfiguruj generowanie dokumentów celnych (CN22/CN23, faktura handlowa), określ wartości i kody towarów (HS), kraj pochodzenia i warunki dostawy. Zadbaj o zgodność danych między systemem sklepu a dokumentami przewozowymi.

Testy, jakość i utrzymanie

Plan testów funkcjonalnych

Zanim uruchomisz produkcję, przygotuj scenariusze pokrywające różne przypadki:

• Różne metody dostawy: kurier do drzwi, odbiór w punkcie, międzynarodowe.
• Zakres wagi i wymiarów, wiele opakowań, produkty podatne na uszkodzenia.
• Płatności: przedpłata, płatność przy odbiorze, zamówienia mieszane.
• Procesy operacyjne: autogeneracja listu, wydruk zbiorczy, zamknięcie manifestu, zmiana terminu odbioru.
• Wyjątki: błąd autoryzacji, brak stawek, nieprawidłowy adres, anulacja przesyłki, duplikaty.

Testy wydajności i skala

Sprawdź przepustowość: ile zamówień na minutę jesteś w stanie przetworzyć w piku. Wdróż kolejkowanie (np. job queue) dla tworzenia listów i synchronizacji statusów. Zaplanuj retry z backoffem i idempotencję requestów (unikaj dublowania przesyłek). Monitoruj czas odpowiedzi API oraz wykorzystanie limitów.

Monitorowanie i alerting

Loguj kluczowe zdarzenia: próby utworzenia przesyłki, odpowiedzi API, generację etykiet, zamykanie manifestów, błędy. Buduj alerty, gdy rośnie odsetek błędów 4xx/5xx, spada skuteczność druków, przekroczone są SLA doręczeń, lub opóźniają się webhooki. Udostępnij panel operacyjny z widokiem statusów i kolejek.

Najczęstsze problemy i rozwiązania

• Błąd autoryzacji – sprawdź poprawność kluczy, środowisko (sandbox vs prod), uprawnienia do usług.
• Brak stawek – brak wymiarów/wagi, nieobsługiwany kierunek, nieprawidłowy kod pocztowy lub metoda płatności niezgodna z usługą.
• Druk etykiet – niezgodny format (ZPL vs PDF), błąd drukarki, zły rozmiar, brak fontów/ikon.
• Nieudane odbiory – zmień okno czasowe, potwierdź adres, sprawdź czy manifest został zamknięty.
• Rozbieżności statusów – zsynchronizuj czas serwera, zwiększ częstotliwość trackingu lub skonfiguruj webhooki.

Bezpieczeństwo i zgodność

Dane adresowe to dane osobowe – stosuj minimalizację zakresu i przechowuj je tak długo, jak to konieczne operacyjnie. Szyfruj transmisję i dane w spoczynku, ogranicz dostęp pracownikom (zasada najmniejszych uprawnień), maskuj numery telefonów w logach. Regularnie przeprowadzaj audyty dostępu i rotację sekretów.

Optymalizacja kosztów i doświadczenia klienta

• Dynamiczne wyceny – włącz stawki on‑line dla precyzyjnych kosztów w koszyku.
• Pakowanie – mapuj produkty do opakowań, ogranicz “powietrze” w paczkach, zmniejsz dopłaty.
• Opcje doręczeń – oferuj odbiór w punktach POP, okna czasowe, przekierowanie doręczenia.
• Komunikacja – wysyłaj czytelne powiadomienia o statusach i przewidywanym czasie doręczenia.

Procedury awaryjne

Przygotuj plan B: drugi przewoźnik, nadawanie przez portal webowy, ręczne drukowanie listów z szablonów, lokalne cache’owanie stawek. Określ, kiedy i jak przełączasz się na tryb awaryjny oraz jak odtwarzasz backlog po powrocie systemu.

Operacja end‑to‑end: od koszyka do doręczenia

Mapowanie metod dostawy i płatności

Zdefiniuj w sklepie metody dostawy odpowiadające usługom DHL oraz ich ograniczenia (kraje, kody pocztowe, waga/wymiary). Powiąż metody płatności – np. COD tylko dla przesyłek krajowych i kuriera do drzwi. Zadbaj o jasne nazwy i opisy (czas dostawy, warunki, koszty dodatkowe), aby zmniejszyć porzucenia koszyka.

Reguły pakowania i atrybuty produktu

Wprowadź w systemie atrybuty: waga jednostkowa, wymiary, kategoria wrażliwości. Zbuduj reguły pakowania: jedna paczka do określonej wagi, dzielenie na wiele paczek, paczki niestandardowe. Jeśli wysyłasz zestawy lub produkty wieloelementowe, zdefiniuj ich logikę (np. łączenie w jedną paczkę lub osobne etykiety).

Proces kompletacji i kontroli jakości

Po opłaceniu zamówienia system tworzy zlecenie magazynowe: picking, packing, weryfikacja wagi i wymiarów, druk etykiety i dokumentów dodatkowych. Rekomendowana jest kontrola różnic: jeśli waga zmierzona różni się od kalkulowanej, wyświetl ostrzeżenie i pozwól na korektę przed generacją listu.

Odbiór przez kuriera i dokumenty

Po zapakowaniu wygeneruj list przewozowy i dołącz go do paczki, wydrukuj protokół dzienny i zamknij manifest. Ustal godzinę graniczną kompletacji, która gwarantuje odbiór tego samego dnia. W przypadku braku odbioru – nadaj przesyłki w najbliższym punkcie nadawczym lub przesuń wizytę kuriera.

Śledzenie i obsługa posprzedażowa

Udostępnij klientowi link do trackingu w e‑mailu i w koncie klienta. Wysyłaj proaktywne powiadomienia przy statusach krytycznych (awizo, nieudane doręczenie), oferuj szybkie przekierowanie lub zmianę terminu. Po doręczeniu poproś o ocenę dostawy i zbieraj dane do optymalizacji procesu.

Zwroty i wymiany

W panelu klienta przygotuj ścieżkę zwrotu: wybór zamówienia, powód, automatyczna etykieta zwrotna lub kod nadania w punkcie, śledzenie przesyłki zwrotnej i automatyczne zwroty środków po weryfikacji. Włącz raporty RMA, by identyfikować produkty o podwyższonym wskaźniku zwrotów i poprawiać opisy lub pakowanie.

Wskazówki praktyczne i dobre nawyki

Przejrzystość komunikacji w koszyku

Wyświetlaj przewidywany czas dostawy, koszty dodatkowe (np. dopłaty za duże gabaryty), dostępność punktów odbioru po kodzie pocztowym. Udostępnij politykę dostaw i zwrotów, aby zminimalizować pytania do supportu.

Dane i analityka

Mierz KPI: odsetek doręczeń D+1, średni koszt wysyłki, odsetek paczek niedoręczonych, czas od złożenia zamówienia do nadania, skuteczność powiadomień. Zbieraj metryki z API i sklepu do wspólnego dashboardu; koreluj z godzinami cut‑off, obłożeniem magazynu i wydajnością drukarek.

Sezonowość i skalowanie

Na szczyty sprzedażowe przygotuj reguły automatyzacji: dynamiczne zawężenie metod, wcześniejsze cut‑offy, priorytety paczek ekspresowych, dodatkowe okna odbioru. Zapewnij redundancję drukarek etykiet, zapas rolek/taśm, alternatywny łącznik internetowy i procedury dla pracy offline.

Zgodność towarowa

Upewnij się, które towary wymagają specjalnego traktowania (np. ADR, litowe baterie, płyny). Skonfiguruj blokady metod lub automatyczne przełączanie na usługę zgodną z regulacjami. Dokumentuj wyjątki i trzymaj listę kontrolną przy przyjęciu dostaw i kompletacji.