DHL Express API

Globe Pickup Points integruje się z DHL Express przez API MyDHL, umożliwiając ekspresową wysyłkę na cały świat bezpośrednio z Shopify. Dzięki tej integracji możesz:

Eksportować zamówienia do DHL Express i natychmiast otrzymywać numer śledzenia
Drukować etykiety wysyłkowe w Shopify
Dostarczać na adres klienta lub do punktu DHL Express Service Point
Wysyłać pełne dane celne (kody HS, warunki DDP lub DAP) w przesyłkach międzynarodowych

Włączanie integracji z API DHL Express

W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Dodaj nowego przewoźnika i wybierz DHL Express.
Wybierz Środowisko — Produkcyjne dla przesyłek rzeczywistych lub Programistyczne (test) dla środowiska testowego MyDHL. Dane uwierzytelniające testowe i produkcyjne są różne.
Wprowadź swoją Nazwę użytkownika i Hasło — dane uwierzytelniające API DHL Express z Developer Portal DHL lub od opiekuna Twojego konta DHL.
Wprowadź swój Numer konta — konto DHL Express, na które rozliczane są przesyłki.
Wypełnij dane nadawcy używane jako nadawca na każdej etykiecie: Nazwa nadawcy, Adres nadawcy (ulica i numer), Miasto nadawcy, Kod pocztowy nadawcy, Kraj nadawcy, Telefon nadawcy i Email nadawcy. Na liście krajów dostępne są tylko kraje obsługiwane przez tę integrację.
Wprowadź Domyślny opis zawartości przesyłki — krótki opis zawartości przesyłki na potrzeby odprawy celnej (na przykład Goods lub Clothing). Jest to obowiązkowe: zamówienie bez opisu — domyślnego lub własnego — nie zostanie wyeksportowane.
Opcjonalnie, w ustawieniach zaawansowanych, ustaw Domyślny kod HS i Domyślną wagę (kg) używane, gdy produkty ich nie mają.
Skonfiguruj według potrzeb opcje Automatycznie realizuj zamówienia, Automatycznie oznaczaj zamówienia numerem śledzenia i Własny tag po eksporcie.
Przypisz metody wysyłki Shopify do usług DHL Express włączonych na Twoim koncie.

Eksportowanie i drukowanie etykiet

Możesz eksportować zamówienia do DHL Express i drukować etykiety wysyłkowe bezpośrednio z Shopify, zarówno masowo, jak i indywidualnie. Ogólny przepływ pracy opisujemy w artykule Tworzenie etykiet wysyłkowych.

Każde zamówienie jest wysyłane jako jedna paczka. DHL zwraca numer śledzenia i plik PDF etykiety w tej samej odpowiedzi, więc etykiety są gotowe do druku natychmiast po eksporcie. Jeśli włączona jest opcja Automatycznie realizuj zamówienia, realizacja jest tworzona z numerem śledzenia i linkiem do śledzenia DHL.

Czego ta integracja nie robi: nie zamawia odbioru przez kuriera. Przesyłki są tworzone bez żądania odbioru — odbiór ustalaj z DHL tak, jak zwykle.

Typy usług

Usługa	Opis
DHL Express Worldwide	Standardowa ekspresowa dostawa od drzwi do drzwi
DHL Express Worldwide – Service Point (D2SVP)	Dostawa do punktu DHL Express Service Point
DHL Express 12:00	Dostawa z gwarantowanym terminem do 12:00
DHL Express 10:30	Dostawa z gwarantowanym terminem do 10:30
DHL Express 9:00	Dostawa z gwarantowanym terminem do 09:00
DHL Economy Select	Usługa ekonomiczna

Globe dobiera kod produktu DHL odpowiadający relacji — krajowej, wewnątrzunijnej lub światowej — na podstawie wybranej przez Ciebie usługi. Usługa musi być nadal aktywna na Twoim koncie DHL; DHL odrzuca przesyłki dla produktów, na które nie masz umowy.

Service Point a dostawa do domu

Service Point (D2SVP) — paczka jest dostarczana do punktu DHL Express Service Point wybranego przez klienta podczas realizacji zamówienia. Globe wysyła 6-znakowy identyfikator placówki MyDHL wraz z usługą dodatkową Service Point od DHL, dzięki czemu etykieta zawiera oznaczenie SPD. Service Point jest ustawiany jako odbiorca, a własny adres klienta jest wysyłany jako kupujący, czego DHL wymaga dla tej usługi.
Dostawa do domu — wszystkie pozostałe usługi dostarczają na adres wysyłki klienta.

Eksport do Service Point wymaga prawdziwego punktu DHL Express, pobranego z mapy punktów odbioru DHL Express (skonfigurowanej z tymi samymi danymi uwierzytelniającymi MyDHL — zobacz Dodawanie przewoźników z punktami odbioru). Zamówienia bez punktu odbioru lub z punktem z sieci innego przewoźnika są odrzucane podczas eksportu.

Mapa punktów DHL Express pokazuje punkty, które MyDHL zwraca dla kodów capability 86,87 (przesyłka DHL Express skierowana do punktu DHL Express). Jeśli DHL poprosił o inny zestaw, wpisz go w ustawieniach punktów odbioru DHL Express w polu Kody możliwości punktów, na przykład 85, który w Danii pomija automaty DHL Pakkeboks. Zostaw pole puste, aby zachować wartość domyślną.

Cło i opłaty

Przesyłki przekraczające granicę celną — czyli inne niż krajowe lub z UE do UE — są eksportowane z pełną deklaracją elektroniczną zbudowaną z pozycji zamówienia: opis, ilość, cena jednostkowa, waga, kod HS i kraj produkcji. Kody HS pochodzą z kodu systemu zharmonizowanego produktu w Shopify, a w razie jego braku z Twojego Domyślnego kodu HS; kraj produkcji pochodzi z kraju pochodzenia produktu, a w razie jego braku z kraju nadawcy.

W sekcji Cło i opłaty w ustawieniach przewoźnika:

Ustawienie	Działanie
Kraje DDP	Kraje docelowe obsługiwane na warunkach DDP (cła i podatki obciążają Ciebie). Wszystkie pozostałe korzystają z DAP.
Wysyłaj wartości bez VAT dla krajów	Dla wybranych krajów docelowych deklarowana wartość jest wysyłana bez VAT.

Dla poszczególnych zamówień możesz nadpisać Kod HS i Opis zawartości w oknie etykiety przed eksportem.

Płatność za pobraniem (COD)

COD jest wysyłane do DHL jako usługa dodatkowa inkasa gotówkowego. Kwotą jest pozostała do zapłaty kwota zamówienia, w walucie zamówienia, pobierana gotówką. COD musi być włączone na Twoim koncie DHL Express i dostępne w danej relacji — DHL Express oferuje je tylko w ograniczonej liczbie krajów, więc potwierdź to z DHL, zanim udostępnisz je podczas realizacji zamówienia. Jeśli usługa nie jest dostępna, DHL odrzuca całą przesyłkę.

Status dostawy

Synchronizacja statusów dostawy nie jest dostępna dla DHL Express — statusy nie są zapisywane z powrotem w Shopify. Numer śledzenia i link do śledzenia są nadal dołączane do realizacji, więc paczkę można śledzić na dhl.com. Etykiety zwrotne również nie są obsługiwane.

Drukowanie etykiet

Etykiety są generowane jako PDF w rozdzielczości 300 DPI w następujących formatach:

Format	Pozycji na arkuszu
A6	1
A6 na A4	4

Podczas drukowania A6 na A4 możesz wybrać pozycję startową na arkuszu (pozycje 1–4), aby ponownie użyć częściowo zużytych arkuszy. Etykiety są zapisywane w momencie eksportu, więc ponowny wydruk nie wymaga kolejnego zapytania do DHL.

Rozwiązywanie problemów

Problem	Rozwiązanie
Błąd uwierzytelniania	Sprawdź, czy Nazwa użytkownika, Hasło i Numer konta odpowiadają wybranemu Środowisku — dane testowe nie działają w środowisku produkcyjnym.
Wymagany opis zawartości	Ustaw Domyślny opis zawartości przesyłki w ustawieniach przewoźnika lub uzupełnij Opis zawartości w zamówieniu.
Service Point: nie wybrano punktu odbioru	Zamówienie korzysta z usługi Service Point, ale nie ma punktu odbioru. Klient nie wybrał go podczas realizacji zamówienia.
Service Point: punkt odbioru musi mieć 6-znakowy identyfikator placówki	Wybrany punkt nie pochodzi z sieci DHL Express. Klient musi wybrać punkt DHL Express Service Point.
Nieznany typ produktu	Metoda wysyłki jest przypisana do usługi, która już nie istnieje. Przypisz metodę wysyłki ponownie w ustawieniach przewoźnika.
Przesyłka odrzucona przez DHL	Pełny komunikat błędu DHL jest pokazywany w wyniku eksportu — zwykle produkt niewłączony na Twoim koncie, nieprawidłowy kod pocztowy lub brak numeru telefonu.
Nie znaleziono danych etykiety podczas drukowania	Brakuje zapisanej etykiety dla tych zamówień. Wyeksportuj zamówienia ponownie, aby wygenerować nowe etykiety.

Add DHL pickup points to your Shopify store — pricing, demo & setup →