Jak połączyć DHL24 z easySales: kompletny przewodnik konfiguracji
Połącz DHL24 (DHL eCommerce Polska) z easySales: klucz WebAPI i numer klienta, usługi, pobranie z ubezpieczeniem, punkty DHL i komunikaty zwracane przez DHL.
Co daje Ci połączenie z DHL24
DHL24 to usługa paczkowa DHL eCommerce w Polsce, do przesyłek krajowych i do innych krajów Europy. Po połączeniu z easySales tworzy etykietę do zamówienia z listy zamówień albo ze strony zamówienia, dodaje do zamówienia numer przesyłki DHL i przekazuje go do marketplace’u lub sklepu, z którego pochodzi zamówienie.
DHL24 to nie DHL Express: DHL Express to osobna integracja w easySales, z własną kartą.
Dwie rzeczy, które warto wiedzieć na start:
- easySales łączy się kluczem DHL24 WebAPI, a nie Twoim loginem do dhl24.com.pl. Klucz WebAPI i hasło do niego DHL wydaje na wniosek. Potrzebujesz też swojego numeru klienta DHL (SAP), który ma 7 cyfr.
- Jedno połączenie wysyła jedną usługą DHL. Każde połączenie ma jedną wartość w polu Dostępne usługi i musi ona pasować do zamówienia — usługa krajowa nie doręcza za granicę, a przesyłka do punktu DHL wymaga usługi punktowej. Utwórz osobne połączenie dla każdej usługi, z której korzystasz.
Zanim zaczniesz
Umowa z DHL eCommerce Polska
Z 7-cyfrowym numerem klienta DHL (SAP).
Dostęp do DHL24 WebAPI
Klucz WebAPI i hasło, które DHL wydaje na wniosek.
Adres odbioru w Polsce
Adres, spod którego DHL odbiera Twoje paczki.
Krok 1 — Poproś DHL o dostęp do WebAPI
- Poproś DHL eCommerce o dostęp do DHL24 WebAPI przez formularz kontaktowy DHL, wybierając kategorię WebAPI - uzyskanie dostępu.
- DHL prześle Ci klucz WebAPI i hasło do niego. Login i hasło do Twojego konta dhl24.com.pl tu nie działają.
- Przygotuj swój numer klienta DHL (SAP): 7-cyfrowy numer Twojej umowy z DHL.
Krok 2 — Połącz DHL24 w easySales
Przejdź do Integracje → Kurierzy, wyszukaj dhl24 i kliknij Połącz na karcie DHL24 — albo Edytuj, jeśli DHL24 był już podłączony.
Uzupełnij dane połączenia:
| Pole | Co wpisać |
|---|---|
| Alias |
Nazwa, po której rozpoznasz połączenie przy wyborze, np. DHL24 Warszawa.
|
| Klucz API | Klucz WebAPI od DHL. |
| Hasło API | Hasło WebAPI od DHL. |
| Numer konta klienta DHL | Twój 7-cyfrowy numer klienta DHL (SAP). To płatnik każdej etykiety z tego połączenia. |
Krok 3 — Paczka, usługi i nadawca
| Pole | Do czego służy |
|---|---|
| Rozmiar paczki | Co zwykle wysyłasz: kopertę, paczkę albo paletę. Większość sprzedawców wybiera Parcel. |
| Dodatkowe usługi | Dodawane do każdej etykiety z tego połączenia: Evening Delivery, Saturday Delivery, Saturday Shipment (odbiór w sobotę) i Insurance. Wybierz tylko te, które obejmuje Twoja umowa z DHL. |
| Dostępne usługi | Usługa DHL każdej etykiety z tego połączenia — zobacz listę poniżej. |
| Format AWB | A4 do drukarki biurowej, A6 do drukarki etykiet. |
| Waluta ubezpieczenia | Waluta wartości ubezpieczenia, domyślnie PLN. Wartość ubezpieczenia to suma zamówienia. |
Usługi, które możesz wybrać w polu Dostępne usługi:
| Usługa | Do czego |
|---|---|
| Domestic shipment | Standardowe doręczenie na terenie Polski. |
| Premium shipment | Doręczenie premium DHL na terenie Polski. |
| Domestic 09 / Domestic 12 | Doręczenie na terenie Polski do 9:00 / do 12:00. |
| Evening delivery shipment | Doręczenie wieczorne na terenie Polski. |
| Shipment delivered to point | Doręczenie do punktu DHL POP lub DHL BOX 24/7. |
| Connect shipment | Doręczenie drogowe do innych krajów Europy. |
| Connect Plus shipment / Connect Plus Pallet shipment | Usługa DHL Connect Plus dla paczek / dla palet. |
| International shipment | Międzynarodowa usługa paczkowa DHL. |
Nadawca to adres, spod którego DHL odbiera Twoje paczki:
| Pole | Co wpisać |
|---|---|
| Imię i nazwisko kontaktu | Osoba, z którą DHL kontaktuje się pod adresem odbioru. |
| Telefon kontaktu | Jej numer telefonu. |
| Adres, Miasto, Kod pocztowy | Adres odbioru w Polsce. |
Kliknij Zapisz. Błędny klucz WebAPI lub błędne hasło wyjdą na jaw dopiero przy pierwszej etykiecie: DHL odrzuci ją z komunikatem Nieprawidlowe dane autoryzacyjne.
Aby wysyłać inną usługą albo z innego adresu odbioru, otwórz połączenie i kliknij Klonuj, a potem nadaj kopii własną nazwę i zmień to, co się różni.
Tworzenie etykiet
- Szybkie tworzenie z listy zamówień korzysta ze wszystkiego, co zapisano w połączeniu. Waga to waga produktów w zamówieniu, rozdzielona na paczki.
- Ze strony zamówienia możesz przed utworzeniem etykiety zmienić wagę, liczbę paczek i kopert, ich rozmiary, kwotę pobrania, wartość ubezpieczenia i usługi dodatkowe.
Pobranie jest dodawane, gdy zamówienie jest płatne przy odbiorze; kwota to suma zamówienia.
Gdy etykieta zostanie odrzucona
Odpowiedź DHL pojawia się na zamówieniu, w języku polskim. Najczęściej zobaczysz:
| Komunikat | Co zrobić |
|---|---|
| Nieprawidlowe dane autoryzacyjne | Błędny Klucz API lub Hasło API — często w miejsce klucza WebAPI wpisano login do dhl24.com.pl. Wpisz w połączeniu dane WebAPI od DHL i zapisz. |
| Błędy walidacji przesyłki: Usługa niedostępna dla danego kraju. | Usługa z połączenia nie doręcza do kraju zamówienia. Utwórz etykietę połączeniem z usługą międzynarodową, np. Connect shipment lub International shipment. |
| Błędy walidacji przesyłki: Przy zwrocie pobrania wymagane jest ubezpieczenie przesyłki. | Przesyłka pobraniowa musi być ubezpieczona. Zaznacz Insurance w polu Dodatkowe usługi w połączeniu i utwórz etykietę ponownie. |
| Błędy walidacji przesyłki: Podany numer punktu serwisowego jest błędny bądź niedostępny dla zadanych usług | Punkt DHL w zamówieniu jest błędny albo nie obsługuje tej usługi. Na stronie zamówienia wybierz inny punkt i utwórz etykietę połączeniem z usługą Shipment delivered to point. |
| Błędy walidacji przesyłki: Zawartość pola Preawiz Odb Nr Tel musi być liczbą. | Numer telefonu klienta zawiera znaki inne niż cyfry. Popraw go w zamówieniu — same cyfry. |
| Błędy walidacji przesyłki: Wartość w polu Telefon jest za krótka (minimalna liczba znaków to 8). | Numer telefonu klienta jest za krótki. Popraw go w zamówieniu. |
| Błędy walidacji przesyłki: Niepoprawny kod pocztowy dla wybranego kraju. | Kod pocztowy nie istnieje w kraju doręczenia. Popraw go w adresie dostawy zamówienia. |