BerlinettaBerlinetta

Blog9 min czytania

Integracja DHL z WooCommerce: jak nadawać paczki z zamówień

Integracja DHL z WooCommerce krok po kroku: umowa, numer SAP, klucze API z DHL24, metody dostawy, pierwsza etykieta i najczęstsze błędy przy nadawaniu.

Zespół BerlinettySprzedaż wielokanałowa w praktyce

W tym artykule

Żeby połączyć DHL ze sklepem WooCommerce, potrzebujesz umowy z DHL eCommerce Polska, aktywnego konta w DHL24 z numerem klienta (SAP) i kluczy API wygenerowanych w tym koncie. Mając te trzy rzeczy, podłączasz przewoźnika do miejsca, w którym obsługujesz zamówienia. Jeśli sprzedajesz nie tylko w sklepie, ale też na Allegro, Erli czy OLX, najwygodniej połączyć WooCommerce i DHL w jednym panelu, takim jak Berlinetta. Etykiety DHL drukujesz wtedy dla wszystkich zamówień z jednej listy, a nie osobno w każdym kanale. Poniżej znajdziesz wymagania, kolejne kroki, sposób na sprawdzenie pierwszej przesyłki i błędy, które najczęściej blokują nadawanie.

Krótko mówiąc

  • Do integracji potrzebujesz umowy z DHL eCommerce Polska, konta w DHL24, numeru klienta SAP oraz kluczy API v2 i API PS (dla punktów DHL POP i automatów DHL BOX).
  • Klucze generujesz sam w DHL24: ikona profilu → Moje Dane → Klucze APIv2 / API PS. Hasło zapisz od razu, bo DHL24 go nie przechowuje.
  • Konto testowe (sandbox) i konto produkcyjne to dwa osobne konta z osobnymi kluczami. Pomylenie ich to najczęstsza przyczyna błędu autoryzacji.
  • W Berlinettcie podłączasz WooCommerce i DHL do jednego panelu, a etykietę tworzysz prosto z zamówienia, także dla zamówień z Allegro, Erli i OLX.
  • Abonament Berlinetty zaczyna się od 89 zł netto miesięcznie, bez opłaty od zamówienia, a pierwsze 30 dni testujesz za darmo.

Którą usługę DHL podłączasz

Zanim zaczniesz, ustal, z którą firmą DHL masz umowę. W Polsce sklepy internetowe najczęściej korzystają z DHL eCommerce Polska: to przesyłki krajowe kurierem pod drzwi i do punktów odbioru, a także paczki do krajów Unii Europejskiej. DHL Express to osobna usługa, przeznaczona głównie do szybkich przesyłek międzynarodowych, także poza UE, z odprawą celną. Ma osobne konto i osobne dane dostępowe.

Ten poradnik dotyczy DHL eCommerce Polska, bo z niego korzysta większość małych i średnich sklepów wysyłających paczki w kraju. Jeżeli masz obie umowy, sprawdź, które dane wpisujesz w integracji. Klucze z jednego konta nie zadziałają w drugim.

W umowie z DHL eCommerce Polska znajdziesz nazwy usług, które możesz nadawać. Oficjalna instrukcja integracji DHL dla WooCommerce wymienia między innymi:

  • DHL Parcel Polska (AH): podstawowa przesyłka krajowa,
  • DHL Parcel 9 i DHL Parcel 12: doręczenie do godziny 9 lub 12,
  • doręczenie wieczorne (DW),
  • DHL Parcel Connect (EK) i DHL Parcel International (PI): przesyłki zagraniczne,
  • DHL Parcel Premium,
  • dostawa do punktu DHL POP.

Nie każda umowa obejmuje wszystkie te usługi. Jeżeli w sklepie pokażesz klientowi doręczenie do 9, a Twoja umowa go nie przewiduje, przesyłki nie da się nadać. Dlatego listę metod dostawy w sklepie układasz na podstawie umowy, a nie listy wszystkich usług DHL.

Czego potrzebujesz przed podłączeniem DHL

Przygotuj wszystko przed konfiguracją. Każdy brak zatrzyma Cię w połowie pracy.

Umowa i numer klienta SAP

Numer SAP to Twój numer klienta w DHL. Dostajesz go po podpisaniu umowy. DHL zaznacza, że klucze API do integracji są dostępne tylko dla zalogowanych użytkowników z aktywną umową i numerem SAP. Samo konto w DHL24 bez umowy nie wystarczy, żeby nadawać paczki z zamówień.

Konto w DHL24

DHL24 to panel klienta DHL eCommerce Polska. Zarządzasz w nim przesyłkami i generujesz klucze do integracji. Jeśli nie masz jeszcze konta, zarejestrujesz je na dhl24.com.pl, a następnie powiążesz je z numerem klienta z umowy.

Klucze API v2 i API PS

API to sposób, w jaki program (sklep albo system do obsługi zamówień) wymienia dane z DHL bez Twojego udziału. Dokumentacja API DHL rozróżnia dwa zestawy danych:

  • API v2: usługi kurierskie, czyli tworzenie przesyłek i etykiet,
  • API PS: punkty DHL POP i automaty DHL BOX 24/7, potrzebne, jeśli klient ma odebrać paczkę w punkcie.

Jeżeli wysyłasz tylko kurierem pod drzwi, wystarczy API v2. Gdy chcesz oferować odbiór w punkcie, potrzebujesz obu zestawów. Warto, bo DHL podaje, że ma w Polsce ponad 20 000 punktów partnerskich DHL POP na stacjach paliw, w sklepach i salonach prasowych.

Sklep gotowy na zmiany

Integracja DHL z WooCommerce krok po kroku

Poniżej opisujemy połączenie przez Berlinettę: sklep WooCommerce i DHL podłączasz do jednego panelu, a paczki nadajesz z listy zamówień. Kroki po stronie DHL są takie same przy każdej integracji z DHL eCommerce Polska.

1. Wygeneruj klucze w DHL24

Zaloguj się do DHL24 kontem produkcyjnym, czyli tym powiązanym z umową. Według pomocy technicznej DHL24 klucze znajdziesz po kliknięciu ikony profilu w górnym rogu: Moje Dane → Klucze APIv2 / API PS.

Kliknij „Generuj” przy każdym kluczu, którego potrzebujesz. Dostaniesz login i hasło. Tu jest pierwsza pułapka: instrukcja DHL24 zaznacza, że panel nie zapisuje haseł. Skopiuj je od razu do menedżera haseł. Jeśli je zgubisz, musisz wygenerować nowe klucze i zaktualizować je wszędzie, gdzie były użyte.

Nie wklejaj loginu, hasła ani numeru SAP do maili i zgłoszeń technicznych. Na zrzutach ekranu zasłaniaj te dane.

1. Wygeneruj klucze w DHL24

2. Połącz WooCommerce z Berlinettą

Podłącz sklep na WooCommerce, żeby zamówienia trafiały do wspólnej listy razem z zamówieniami z Allegro, Erli, OLX i innych kanałów. Opis połączenia znajdziesz na stronie integracji WooCommerce z Allegro i kurierami. Konto testowe zakładasz sam i możesz pracować od razu, bez wdrożenia.

Na tym etapie zyskujesz coś, czego sama wtyczka kurierska w sklepie nie daje: zamówienia z każdego kanału obsługujesz w ten sam sposób. Pakowacz nie przełącza się między panelem WooCommerce, Allegro i DHL24.

3. Dodaj DHL jako przewoźnika

W Berlinettcie podłączasz DHL na stronie integracji z DHL, gdzie są też etykiety i zamawianie podjazdu kuriera. Szczegółową konfigurację, ekran po ekranie, opisujemy w poradniku Integracja DHL eCommerce ze sklepem.

DHL to jedna z 6 firm kurierskich dostępnych w Berlinettcie, obok InPost, GLS, DPD, Poczty Polskiej i FedEx. Do tego dochodzą brokerzy Furgonetka i Base.courier. Jeśli kiedyś dodasz drugiego przewoźnika, zrobisz to w tym samym panelu.

4. Ustaw metody dostawy w sklepie

Klient wybiera sposób dostawy w koszyku WooCommerce, więc metody DHL muszą być widoczne w strefach wysyłki sklepu (WooCommerce → Ustawienia → Wysyłka). Ustal:

  1. Nazwy metod, które klient zrozumie, np. „Kurier DHL” i „DHL POP: odbiór w punkcie”.
  2. Ceny dla klienta: osobno dla kuriera, punktu i pobrania. Sprawdź je z cennikiem z umowy, żeby nie dopłacać do wysyłki.
  3. Strefy: Polska osobno, kraje UE osobno. Ryczałtowa cena wysyłki za granicę często nie pokrywa kosztu paczek do dalszych krajów.
  4. Tylko usługi z umowy: nie pokazuj doręczenia do 9 ani wieczornego, jeśli ich nie masz.

5. Nadaj pierwszą paczkę z zamówienia

Otwórz zamówienie, sprawdź adres, telefon i wagę, wybierz usługę DHL i utwórz etykietę. Numer przesyłki zostaje przy zamówieniu, więc nie przepisujesz go ręcznie do sklepu ani do maila dla klienta. Opis nadawania, druku etykiet i pracy z kilkoma przewoźnikami znajdziesz w funkcji wysyłka i etykiety kurierskie.

Kolejne kroki nadania paczki przez DHL

Jeśli pakujecie w kilka osób, pomoże Manager pakowania z premiami dla pakowaczy, a fakturę lub paragon wystawisz z tego samego zamówienia, z wysyłką do KSeF (Krajowego Systemu e-Faktur, czyli państwowej platformy do faktur ustrukturyzowanych).

6. Sprawdź, czy wszystko działa

Po pierwszych przesyłkach sprawdź trzy rzeczy:

  • Etykieta: czy drukuje się czytelnie i w formacie pasującym do Twojej drukarki.
  • Numer przesyłki: czy jest przy zamówieniu i czy klient dostał go w powiadomieniu.
  • Odbiór paczki: czy kurier ją zabrał. Etykieta potwierdza tylko przygotowanie przesyłki, a nie przekazanie jej kurierowi. Statusy w sklepie ustaw tak, żeby „wysłane” znaczyło, że paczka faktycznie wyjechała.

Jeśli chcesz najpierw przetestować integrację bez nadawania prawdziwych paczek, użyj środowiska testowego DHL. Pomoc DHL24 wyjaśnia, że konto testowe zakładasz osobno na sandbox.dhl24.com.pl, a testowy numer klienta DHL dodaje po zgłoszeniu przez formularz kontaktowy. Samo przełączenie opcji „tryb testowy” nie tworzy konta testowego.

Najczęstsze błędy i jak ich uniknąć

Problem Co zwykle jest przyczyną Co zrobić
„Nieprawidłowe dane autoryzacyjne” Klucze z sandboxa wpisane w trybie produkcyjnym albo odwrotnie Sprawdź, z którego konta pochodzą klucze, i wpisz pasujące
Brak dostępu do kluczy w DHL24 Konto bez aktywnej umowy lub bez numeru SAP Powiąż konto z numerem klienta z umowy
Zgubione hasło do klucza DHL24 nie przechowuje haseł Wygeneruj nowe klucze i podmień je w integracji
Nie można nadać do punktu Brak kluczy API PS Wygeneruj klucz API PS i dodaj go do integracji
Usługa odrzucona Usługa niewidoczna w umowie Usuń ją z metod dostawy albo rozszerz umowę
Paczka do kraju spoza UE stoi Brak danych celnych lub faktury Uzupełnij opis towaru, wartość i fakturę przed nadaniem
Numer śledzenia przepisywany ręcznie Etykiety tworzone w DHL24, poza zamówieniem Twórz etykietę z zamówienia, wtedy numer zapisze się sam

W sandboxie mapa punktów może pokazywać mniej lokalizacji niż w rzeczywistości. To normalne w środowisku testowym i nie świadczy o błędzie integracji. Po przejściu na konto produkcyjne widzisz pełną sieć punktów.

Wtyczka w sklepie czy jeden panel do wysyłek

DHL możesz podłączyć bezpośrednio do WooCommerce, instalując wtyczkę kurierską w sklepie. Takie rozwiązanie obsługuje jednak tylko zamówienia z tego jednego sklepu i tylko jednego przewoźnika. Gdy sprzedajesz w kilku kanałach, liczba wtyczek i paneli rośnie razem z liczbą kanałów.

Co jest dla Ciebie ważne Wtyczka DHL w WooCommerce Berlinetta
Zamówienia z Allegro, Erli, OLX Nie, tylko ze sklepu Tak, na jednej liście z WooCommerce
Inni kurierzy Każdy przez osobną wtyczkę 6 firm kurierskich i 2 brokerów w jednym panelu
Faktury z KSeF Osobne narzędzie Z zamówienia, z połączeniem z inFaktem i Subiektem nexo PRO
Wspólny stan magazynu Tylko w sklepie Wspólny stan i ceny na ofertach we wszystkich kanałach
Magazyn i pakowanie Brak Plan hali i Manager pakowania
Zwroty i reklamacje Osobno w każdym kanale W jednym miejscu

Podobny układ dotyczy innych przewoźników. Jeśli wysyłasz też DPD, zobacz, jak wygląda integracja DPD z WooCommerce.

DHL, WooCommerce i Allegro w jednym panelu

W Berlinettcie podłączasz sklep WooCommerce, DHL i pozostałe kanały sprzedaży do jednego panelu. Etykietę tworzysz z zamówienia, niezależnie od tego, czy przyszło ze sklepu, z Allegro czy z Erli. Każdy pakiet zawiera wszystkie integracje, dowolną liczbę pracowników i kont, magazyn, sprzedaż B2B i KSeF, bez płatnych dodatków.

Pulpit Berlinetty: sprzedaż z dziś z wykresem, zamówienia spakowane i wysłane, statusy zamówień, skróty i najnowsze zamówienia.

Cena zależy tylko od liczby zamówień w miesiącu: Berlinetta 250 kosztuje 89 zł netto miesięcznie lub 890 zł netto rocznie, Berlinetta 500 to 129 zł netto miesięcznie, a Berlinetta 2000 to 249 zł netto miesięcznie. Nie płacisz prowizji ani opłaty od zamówienia, a pierwsze 30 dni testujesz bezpłatnie. Sprawdź pakiety i załóż konto testowe.

Nasze zdanie o integracji DHL

Podłączenie DHL do sklepu to zwykle pierwszy krok, który właściciel sklepu robi, żeby przestać przepisywać adresy do DHL24. Problem wraca jednak, gdy pojawia się drugi kanał sprzedaży. Zamówienia z Allegro, Erli czy OLX nie trafiają do wtyczki w WooCommerce i znowu ktoś przepisuje dane albo przełącza się między panelami.

Dlatego budujemy Berlinettę wokół jednej listy zamówień. Produkt opisujesz raz, z jego karty wystawiasz oferty we wszystkich kanałach, a wspólny stan i ceny same trafiają na oferty. Paczkę DHL nadajesz z zamówienia, fakturę wystawiasz z tego samego miejsca, a zwrot obsługujesz bez szukania, skąd przyszło zamówienie.

Uważamy też, że cena systemu nie powinna rosnąć z każdą paczką. Płacisz za liczbę zamówień w miesiącu, bez opłaty od zamówienia, a kolejne integracje dokładamy na życzenie klientów.

Zespół Berlinetta

Źródła

  1. 1.DHL24: Pomoc techniczna, integracje i klucze API
  2. 2.Narzędzia DHL: jak zintegrować sklep internetowy i uzyskać dostęp do WebAPI
  3. 3.Narzędzia DHL: dokumentacja API
  4. 4.Instrukcja integracji DHL dla WooCommerce
  5. 5.DHL eCommerce Polska: punkty partnerskie DHL POP

Pytania

Najczęstsze pytania

Czy do integracji DHL z WooCommerce potrzebuję umowy z DHL?

Tak. Klucze API, bez których integracja nie utworzy etykiety, są dostępne tylko dla kont z aktywną umową i numerem klienta SAP. Bez umowy możesz założyć jedynie konto testowe w sandboxie i sprawdzić działanie połączenia.

Gdzie w DHL24 znajdę klucze API?

Po zalogowaniu kliknij ikonę profilu w górnym rogu i przejdź do Moje Dane → Klucze APIv2 / API PS. Po kliknięciu „Generuj” dostaniesz login i hasło. Zapisz hasło od razu, bo DHL24 go nie przechowuje.

Czy mogę nadawać paczki DHL do punktów odbioru?

Tak, jeśli wygenerujesz klucz API PS i Twoja umowa obejmuje doręczenie do punktu DHL POP. Klient wybiera wtedy punkt w koszyku, a Ty nadajesz paczkę z zamówienia tak samo jak przesyłkę kurierską.

Czy w Berlinettcie nadam paczkę DHL także dla zamówienia z Allegro?

Tak. Berlinetta zbiera zamówienia z Allegro, Erli, OLX i sklepu WooCommerce na jednej liście, a etykietę DHL tworzysz z każdego z nich. Możesz też korzystać z Wysyłam z Allegro, jeśli wolisz nadawać przez program Allegro.

Ile kosztuje Berlinetta przy integracji z DHL?

Wszystkie integracje, w tym DHL i WooCommerce, są w każdym pakiecie. Cena zależy tylko od liczby zamówień w miesiącu i zaczyna się od 89 zł netto miesięcznie, bez opłaty od zamówienia. Pierwsze 30 dni są bezpłatne.

Sprzedajesz w kilku miejscach naraz?

Obsługuj Allegro, Erli, własny sklep i kurierów w jednym panelu. Bez przepisywania danych.