DHL automatyzacje - zamawianie kuriera i etykiety przez API

Automatyzacja wysyłek DHL polega na tym, że przesyłka, etykieta, zamówienie kuriera i powiadomienie klienta powstają bez ręcznego przepisywania danych z zamówienia. Masz na to dwie drogi: gotową integrację DHL w Base lub w sklepie, albo własne połączenie z DHL24 WebAPI, czyli interfejsem API DHL eCommerce Polska. Dla większości sklepów wystarcza integracja w Base, a API ma sens przy własnym systemie magazynowym lub nietypowych procesach.

W tym artykule pokazujemy, jak wygląda zautomatyzowana ścieżka wysyłki DHL od zamówienia do doręczenia, jakie funkcje udostępnia DHL24 WebAPI, kiedy wybrać API, a kiedy gotową integrację, oraz jakie błędy najczęściej zatrzymują automatyczne tworzenie przesyłek. Wszystko z perspektywy sklepu, który sprzedaje we własnym sklepie, na Allegro i obsługuje zamówienia w Base.

[#wazne] W skrócie: DHL automatyzacje to automatyczne tworzenie przesyłek, wydruk etykiet, zamawianie odbioru i przekazywanie numerów do klienta. W Base zrobisz to akcjami automatycznymi na integracji DHL, a we własnym systemie przez DHL24 WebAPI, do którego dostęp przyznaje DHL na wniosek. Kluczem są kompletne dane: wagi, wymiary, telefon i e-mail odbiorcy, punkt odbioru. W Vinson integrujemy wysyłki DHL ze sklepem, Allegro i Base, ale nie jesteśmy partnerem DHL.

Czym są automatyzacje wysyłek DHL i co da się zautomatyzować?

Automatyzacja wysyłek to zestaw reguł i połączeń, które same wykonują powtarzalne kroki po wpłynięciu zamówienia. Zamiast logować się do DHL24, przepisywać adres i drukować etykietę ręcznie, system tworzy przesyłkę w DHL, pobiera etykietę, wysyła ją na drukarkę przy stanowisku pakowania i zapisuje numer przesyłki w zamówieniu.

W przypadku DHL automatyzować można prawie cały proces po stronie nadawcy:

tworzenie przesyłki z danych zamówienia, z wagą, wymiarami i usługami dodatkowymi,
pobieranie i drukowanie etykiet, także seryjnie dla wielu zamówień,
zamawianie kuriera na odbiór i anulowanie zamówienia odbioru,
przekazanie numeru przesyłki do sklepu, Allegro i klienta,
pobieranie statusów i zmiana statusu zamówienia po doręczeniu,
tworzenie przesyłek zwrotnych dla klientów.

Sam proces wygląda podobnie niezależnie od tego, czy korzystasz z Base, wtyczki w sklepie czy własnego API. Różni się tylko to, kto pisze i utrzymuje logikę.

[#chart:kur27a]

Integracja DHL w Base - automatyzacja bez programisty

W Base podłączasz DHL jako integrację kurierską, wpisujesz dane dostępowe z umowy i ustawiasz domyślne parametry paczki, format etykiety oraz dane nadawcy. Potem tworzysz akcje automatyczne: na przykład po zmianie statusu na Do spakowania Base tworzy przesyłkę DHL i drukuje etykietę, a po nadaniu wysyła klientowi e-mail z numerem. Ogólne zasady podłączania przewoźników opisaliśmy w artykule Kurierzy w BaseLinkerze - jak podłączyć InPost, DPD, DHL i inne firmy.

Taka konfiguracja nie wymaga kodu i pokrywa potrzeby większości sklepów. Jeśli masz drugiego przewoźnika, dochodzą reguły wyboru kuriera, które same decydują, czy zamówienie idzie przez DHL, czy przez innego kuriera.

Jak przygotować dane do automatyzacji DHL?

Zanim cokolwiek zautomatyzujesz, sprawdź, czy zamówienia mają komplet danych, których DHL wymaga do utworzenia przesyłki. Automat nie zgadnie wagi paczki ani numeru telefonu odbiorcy. Jeśli tych danych brakuje, przesyłka utknie z błędem, a ktoś w magazynie i tak będzie musiał ją poprawić ręcznie.

Uzupełnij wagi i wymiary produktów w Base lub w sklepie, a dla zestawów ustal wagę paczki.
Sprawdź, czy wszystkie kanały sprzedaży przekazują telefon i e-mail kupującego.
Upewnij się, że sklep zapisuje identyfikator wybranego punktu DHL POP lub automatu DHL BOX 24/7.
Ustal, które zamówienia mają pobranie, a które wymagają ubezpieczenia, i jak to wynika z danych zamówienia.
Przypisz metody dostawy ze sklepu i Allegro do odpowiednich usług DHL.

Ten porządek przyda się niezależnie od tego, czy automatyzację zrobisz w Base, czy przez API. To najczęściej pomijany etap, a od niego zależy, czy po wdrożeniu przesyłki tworzą się same w każdym zamówieniu, czy tylko w części.

Automatyzacja wysyłek DHL polega na tym, że przesyłka, etykieta, zamówienie kuriera i powiadomienie klienta powstają bez ręcznego przepisywania danych z zamówienia. Masz na to dwie drogi: gotową integrację DHL w Base lub w sklepie, albo własne połączenie z DHL24 WebAPI, czyli interfejsem API DHL eCommerce Polska. Dla większości sklepów wystarcza integracja w Base, a API ma sens przy własnym systemie magazynowym lub nietypowych procesach.

W tym artykule pokazujemy, jak wygląda zautomatyzowana ścieżka wysyłki DHL od zamówienia do doręczenia, jakie funkcje udostępnia DHL24 WebAPI, kiedy wybrać API, a kiedy gotową integrację, oraz jakie błędy najczęściej zatrzymują automatyczne tworzenie przesyłek. Wszystko z perspektywy sklepu, który sprzedaje we własnym sklepie, na Allegro i obsługuje zamówienia w Base.

[#wazne] W skrócie: DHL automatyzacje to automatyczne tworzenie przesyłek, wydruk etykiet, zamawianie odbioru i przekazywanie numerów do klienta. W Base zrobisz to akcjami automatycznymi na integracji DHL, a we własnym systemie przez DHL24 WebAPI, do którego dostęp przyznaje DHL na wniosek. Kluczem są kompletne dane: wagi, wymiary, telefon i e-mail odbiorcy, punkt odbioru. W Vinson integrujemy wysyłki DHL ze sklepem, Allegro i Base, ale nie jesteśmy partnerem DHL.

Czym są automatyzacje wysyłek DHL i co da się zautomatyzować?

Automatyzacja wysyłek to zestaw reguł i połączeń, które same wykonują powtarzalne kroki po wpłynięciu zamówienia. Zamiast logować się do DHL24, przepisywać adres i drukować etykietę ręcznie, system tworzy przesyłkę w DHL, pobiera etykietę, wysyła ją na drukarkę przy stanowisku pakowania i zapisuje numer przesyłki w zamówieniu.

W przypadku DHL automatyzować można prawie cały proces po stronie nadawcy:

tworzenie przesyłki z danych zamówienia, z wagą, wymiarami i usługami dodatkowymi,
pobieranie i drukowanie etykiet, także seryjnie dla wielu zamówień,
zamawianie kuriera na odbiór i anulowanie zamówienia odbioru,
przekazanie numeru przesyłki do sklepu, Allegro i klienta,
pobieranie statusów i zmiana statusu zamówienia po doręczeniu,
tworzenie przesyłek zwrotnych dla klientów.

Sam proces wygląda podobnie niezależnie od tego, czy korzystasz z Base, wtyczki w sklepie czy własnego API. Różni się tylko to, kto pisze i utrzymuje logikę.

[#chart:kur27a]

Integracja DHL w Base - automatyzacja bez programisty

W Base podłączasz DHL jako integrację kurierską, wpisujesz dane dostępowe z umowy i ustawiasz domyślne parametry paczki, format etykiety oraz dane nadawcy. Potem tworzysz akcje automatyczne: na przykład po zmianie statusu na Do spakowania Base tworzy przesyłkę DHL i drukuje etykietę, a po nadaniu wysyła klientowi e-mail z numerem. Ogólne zasady podłączania przewoźników opisaliśmy w artykule Kurierzy w BaseLinkerze - jak podłączyć InPost, DPD, DHL i inne firmy.

Taka konfiguracja nie wymaga kodu i pokrywa potrzeby większości sklepów. Jeśli masz drugiego przewoźnika, dochodzą reguły wyboru kuriera, które same decydują, czy zamówienie idzie przez DHL, czy przez innego kuriera.

Jak przygotować dane do automatyzacji DHL?

Zanim cokolwiek zautomatyzujesz, sprawdź, czy zamówienia mają komplet danych, których DHL wymaga do utworzenia przesyłki. Automat nie zgadnie wagi paczki ani numeru telefonu odbiorcy. Jeśli tych danych brakuje, przesyłka utknie z błędem, a ktoś w magazynie i tak będzie musiał ją poprawić ręcznie.

Uzupełnij wagi i wymiary produktów w Base lub w sklepie, a dla zestawów ustal wagę paczki.
Sprawdź, czy wszystkie kanały sprzedaży przekazują telefon i e-mail kupującego.
Upewnij się, że sklep zapisuje identyfikator wybranego punktu DHL POP lub automatu DHL BOX 24/7.
Ustal, które zamówienia mają pobranie, a które wymagają ubezpieczenia, i jak to wynika z danych zamówienia.
Przypisz metody dostawy ze sklepu i Allegro do odpowiednich usług DHL.

Ten porządek przyda się niezależnie od tego, czy automatyzację zrobisz w Base, czy przez API. To najczęściej pomijany etap, a od niego zależy, czy po wdrożeniu przesyłki tworzą się same w każdym zamówieniu, czy tylko w części.

DHL API - co udostępnia DHL24 WebAPI?

DHL24 WebAPI to interfejs DHL eCommerce Polska, przez który system sklepu lub magazynu komunikuje się z DHL bez użycia panelu. Działa w technologii SOAP i jest opisany dokumentem WSDL. Dostęp do niego przyznaje DHL na wniosek klienta biznesowego, a do testów służy osobne środowisko testowe (sandbox) z oddzielnymi danymi logowania. Szczegóły dostępu ustal z opiekunem w DHL (stan na maj 2026 - sprawdź aktualną dokumentację DHL24 WebAPI).

Dokumentacja wymienia kilkadziesiąt metod. Dla automatyzacji sklepu najważniejsze są te, które tworzą przesyłki, zwracają etykiety, zamawiają kuriera i podają statusy. Poniżej grupy funkcji, z których korzystają typowe integracje.

[#chart:kur27b]

Metoda DHL24 WebAPI	Do czego służy w automatyzacji
createShipments	Tworzenie przesyłek z danych zamówień
getLabels	Pobranie etykiet do wydruku
bookCourier	Zamówienie kuriera na odbiór przesyłek
cancelCourierBooking	Anulowanie zamówionego odbioru
deleteShipments	Usunięcie błędnie utworzonych przesyłek
getTrackAndTraceInfo	Pobieranie historii zdarzeń przesyłki
getPostalCodeServices	Sprawdzenie usług dostępnych dla kodu pocztowego
getNearestServicepoints	Wyszukanie najbliższych punktów DHL
createShipmentReturn	Tworzenie przesyłki zwrotnej

Według dokumentacji metoda createShipments przyjmuje w jednym wywołaniu ograniczoną liczbę przesyłek, więc przy seryjnym nadawaniu integracja musi dzielić zamówienia na mniejsze porcje. Walidacja danych działa według tych samych zasad co w panelu DHL24 - jeśli adres lub parametry nie przejdą w panelu, nie przejdą też przez API.

Zamawianie kuriera DHL przez API

Jeśli nie masz stałego, codziennego odbioru w umowie, kuriera trzeba zamówić. Przez API robisz to metodą bookCourier, podając przesyłki i przedział godzin odbioru. Wcześniej warto sprawdzić metodą getPostalCodeServices, jakie godziny odbioru i usługi są dostępne dla kodu pocztowego magazynu. Przy stałym odbiorze krok zamawiania kuriera zwykle odpada, a automatyzacja kończy się na etykiecie i zestawieniu dla kuriera.

Testy integracji z DHL API w sandboxie

Każdą własną integrację z DHL24 WebAPI najpierw uruchamiasz w środowisku testowym. Sprawdź tam tworzenie przesyłek krajowych do drzwi i do punktu, przesyłki z pobraniem, paczki o różnej wadze, pobieranie etykiet w docelowym formacie, zamawianie i anulowanie kuriera oraz obsługę błędów walidacji. Dopiero gdy wszystkie scenariusze przechodzą, przełączasz integrację na środowisko produkcyjne i dane z umowy.

Warto też zaplanować, co integracja robi, gdy DHL odpowie błędem lub nie odpowie wcale. Zamówienie powinno trafić do osobnego statusu z opisem problemu, a nie zniknąć bez śladu. Przy kilkuset paczkach dziennie to różnica między jedną poprawką a wieczornym szukaniem zgubionych zamówień.

[#tip] Zanim zlecisz programowanie własnej integracji z DHL24 WebAPI, sprawdź, czy gotowa integracja DHL w Base nie robi już tego, czego potrzebujesz. Własne API ma sens, gdy masz system WMS lub ERP, nietypowe reguły pakowania albo bardzo duży wolumen, który chcesz obsługiwać bez pośredników.

API DHL czy gotowa integracja - co wybrać?

Własna integracja daje pełną kontrolę, ale wymaga programisty, testów w sandboxie i utrzymania przy każdej zmianie wersji API. Gotowa integracja w Base lub wtyczka w sklepie działa od razu, a aktualizacje bierze na siebie dostawca. Wybór zależy od skali i od tego, gdzie żyje Twoje zamówienie.

Base - gdy zamówienia ze sklepu i marketplace'ów zbierasz w jednym miejscu i chcesz automatyzacji bez kodu,
Wtyczka w sklepie - gdy sprzedajesz głównie w jednym sklepie i nie używasz Base,
DHL24 WebAPI - gdy masz własny WMS lub ERP i zespół, który utrzyma integrację,
Allegro Delivery - gdy wysyłasz zamówienia z Allegro metodami DHL dostępnymi w programie.

Przy wysyłkach z Allegro pamiętaj o spójności metod dostawy. DHL działa w programie Allegro Delivery z kurierem, punktami DHL POP i automatami DHL BOX 24/7, a przy własnej umowie przesyłki tworzysz przez integrację w Base. Metoda dostawy wybrana przez kupującego musi prowadzić do właściwej usługi DHL, inaczej automat utworzy przesyłkę kurierską tam, gdzie klient chciał odebrać paczkę w automacie.

Etykiety DHL - jak zautomatyzować wydruk?

Etykieta to najczęstsze wąskie gardło. Jeśli magazyn pobiera PDF i drukuje go ręcznie, oszczędność z automatycznego tworzenia przesyłek znika. W Base etykiety DHL wysyłasz automatycznie na drukarkę termiczną przez Base Printer, w formacie dopasowanym do drukarki. Konfigurację opisaliśmy w artykule Drukowanie etykiet w BaseLinkerze - Base Printer i drukarka termiczna.

Dobrą praktyką jest drukowanie etykiety razem z dokumentem zamówienia w jednym kroku, na stanowisku, przy którym pracownik pakuje paczkę. Wtedy etykieta zawsze trafia na właściwą paczkę, a ryzyko zamiany spada.

Przy dużej liczbie zamówień przydaje się też seryjny wydruk: magazyn zaznacza grupę zamówień w jednym statusie, a system tworzy przesyłki i drukuje wszystkie etykiety DHL po kolei, w tej samej kolejności co listy kompletacyjne. Przed pierwszym takim wydrukiem sprawdź na kilku zamówieniach, czy format etykiety pasuje do rolki w drukarce i czy kod kreskowy jest czytelny dla skanera kuriera.

Najczęstsze błędy w automatyzacji wysyłek DHL

Automatyzacja działa tak dobrze, jak dane, które dostaje. Większość problemów, które widzimy u klientów, wynika z braków w zamówieniu lub w karcie produktu, a nie z samej integracji. Poniżej typowe objawy i to, co zwykle je naprawia.

[#chart:kur27c]

[#checklista] Przed włączeniem automatyzacji DHL: produkty mają wagi i wymiary, zamówienia zawierają telefon i e-mail odbiorcy, sklep przekazuje identyfikator punktu DHL POP lub automatu, usługi dodatkowe (pobranie, ubezpieczenie) wynikają z danych zamówienia, etykieta drukuje się na właściwej drukarce, a e-mail do klienta zawiera numer i link do śledzenia.

Powiadomienia dla klienta i statusy po nadaniu

Ostatni element automatyzacji to informacja dla klienta. DHL wysyła odbiorcy własne powiadomienia o przesyłce, jeśli w danych jest telefon lub e-mail. Sklep powinien dodatkowo wysłać e-mail z numerem i linkiem do śledzenia. W Base zrobisz to akcją automatyczną po utworzeniu przesyłki, a statusy przewoźnika pozwolą automatycznie oznaczyć zamówienie jako doręczone.

Zwroty DHL - czy da się je zautomatyzować?

Zwroty to druga strona wysyłek, często obsługiwana ręcznie. DHL24 WebAPI ma metody do tworzenia przesyłek zwrotnych, więc integracja może wygenerować etykietę zwrotną, gdy klient zgłosi zwrot w sklepie. W Base połączysz to z modułem zwrotów: zgłoszenie klienta tworzy zwrot, a status przesyłki pokazuje, kiedy paczka wraca do magazynu. Dzięki temu obsługa nie musi pytać klienta o numer nadania.

Automatyzacja DHL przy kilku przewoźnikach

Jeśli obok DHL wysyłasz innym kurierem, automatyzacja musi najpierw zdecydować, który przewoźnik obsłuży zamówienie. W Base robisz to regułami według metody dostawy, wagi, kraju lub kanału sprzedaży, opisanymi w artykule Automatyczny wybór kuriera w Base - reguły wysyłki według wagi, kraju i kanału. Dopiero po przypisaniu przewoźnika uruchamiają się akcje tworzące przesyłkę i drukujące etykietę.

Jak Vinson pomaga zautomatyzować wysyłki DHL

Konfigurujemy DHL w Base, sklepie i na Allegro: tworzenie przesyłek, etykiety na drukarce termicznej, statusy, reguły wyboru kuriera i e-maile do klientów. Gdy potrzebna jest integracja przez API, pomagamy określić zakres i sprawdzić, czy gotowe rozwiązanie nie wystarczy. Nie jesteśmy partnerem DHL, więc patrzymy na koszt i wygodę Twojego zespołu. Zacznij od bezpłatnej konsultacji.

Vinson to agencja e-commerce z Bochni, działająca od 2021 r., certyfikowany partner Base, Allegro Ads Partner+ i autoryzowany partner Shoper, z oceną 4,9/5 ze 171 opinii i ponad 500 firmami w portfolio. Zakres prac przy automatyzacji zamówień opisujemy na stronie wdrożenie Base.

Najczęściej zadawane pytania

Czy DHL ma API dla sklepów internetowych?

Tak. DHL eCommerce Polska udostępnia DHL24 WebAPI, interfejs w technologii SOAP, przez który można tworzyć przesyłki, pobierać etykiety, zamawiać kuriera i sprawdzać statusy. Dostęp przyznaje DHL na wniosek klienta biznesowego, a do testów służy osobne środowisko sandbox.

Jak automatycznie generować etykiety DHL?

Najprościej przez integrację DHL w Base: akcja automatyczna tworzy przesyłkę po zmianie statusu zamówienia, a Base Printer wysyła etykietę na drukarkę termiczną. Alternatywą jest wtyczka DHL w sklepie lub własna integracja z DHL24 WebAPI z metodami createShipments i getLabels.

Czy można zamówić kuriera DHL automatycznie?

Tak. W DHL24 WebAPI służy do tego metoda bookCourier, a anulowanie odbioru umożliwia cancelCourierBooking. Przy stałym, codziennym odbiorze ustalonym w umowie zamawianie kuriera zwykle nie jest potrzebne.

Czy do automatyzacji DHL potrzebny jest programista?

Nie zawsze. Gotowa integracja w Base lub wtyczka w sklepie pozwala zautomatyzować tworzenie przesyłek, etykiety i e-maile bez kodu. Programista jest potrzebny przy własnej integracji z DHL24 WebAPI, na przykład z systemem WMS lub ERP.

Dlaczego przesyłka DHL nie tworzy się automatycznie?

Najczęściej brakuje danych: wagi produktu, telefonu lub e-maila odbiorcy albo identyfikatora punktu odbioru. Drugą przyczyną są nieaktualne dane dostępowe do integracji lub usługa niedostępna dla danego kodu pocztowego. Komunikat błędu w Base lub w odpowiedzi API zwykle wskazuje, które pole poprawić.

Chcesz, żeby przesyłki DHL tworzyły się same, a magazyn tylko pakował? Umów bezpłatną konsultację z Vinson - zaplanujemy automatyzację wysyłek pod Twoje kanały sprzedaży.