DHL Polska – Konfiguracja aplikacji

Możliwości aplikacji

Aplikacja DHL Polska pozwala:

• skonfigurować metody dostawy DHL dla wybranych krajów,
• automatycznie wyliczać koszt dostawy w checkoucie Shopify,
• tworzyć etykiety nadawcze DHL z poziomu ekranu szczegółów zamówienia,
• generować i pobierać etykiety nadawcze oraz numery śledzenia przesyłek,
• tworzyć etykiety zwrotne,
• zamawiać kuriera dla wielu przesyłek jednocześnie,
• pobierać potwierdzenie nadania,
• obsługiwać wysyłki do punktów DHL BOX i DHL POP.

Zanim zaczniesz

Przed rozpoczęciem konfiguracji aplikacji przygotuj:

1. Dane logowania do DHL WebAPI,
2. Numer SAP dla konta DHL,
3. Dane nadawcy,
4. Opcjonalnie klucz Google Maps Geocoding API,

a także upewnij się, że Strefy wysyłki zostały poprawnie skonfigurowane w Twoim sklepie w ustawieniach Shopify w zakładce Wysyłka i dostawa.

Podczas instalacji aplikacja DHL Polska automatycznie doda swoje stawki w ustawieniach wysyłki Shopify (Ustawienia → Wysyłka i dostawa → Strefy wysyłki) do każdej istniejącej strefy wysyłki:

Jeżeli z jakiegoś powodu tak by się nie stało i stawki DHL Polska nie zostałyby automatycznie dodane, użyj opcji Dodaj opcję wysyłki i w oknie, które się pojawi wybierz kolejno Typ stawki: Obliczane przez przewoźnika lub aplikację oraz Przewoźnik lub aplikacja: DHL Polska (Stawki z aplikacji), aby dodać je ręcznie:

Jeżeli z jakiegoś powodu tak by się nie stało i stawki DHL Polska nie zostałyby automatycznie dodane, użyj opcji + Dodaj opcję wysyłki i w oknie, które się pojawi wybierz kolejno Typ stawki: Obliczane przez przewoźnika lub aplikację oraz Przewoźnik lub aplikacja: DHL Polska (Stawki z aplikacji), aby dodać je ręcznie, a następnie zatwierdź całość przyciskiem Gotowe :

Po zakończeniu instalacji aplikacji powinien wyświetlić się następujący ekran:

Kliknij w przycisk Przejdź do ustawień widoczny w górnej części ekranu, aby przejść do Ustawień aplikacji i uzupełnić dane autoryzacyjne niezbędne do jej prawidłowego funkcjonowania.

Ustawienia

Tryb aplikacji

Wybierz tryb, w którym ma działać aplikacja. Domyślnie działa ona w trybie produkcyjnym.

Aby uruchomić ją w trybie testowym, pozwalającym bezpiecznie sprawdzić jej konfigurację i działanie bez wpływu na rzeczywiste dane i zamówienia, zaznacz checkbox Tryb testowy, a następnie w sekcji Dane logowania API poniżej wprowadź testowe dane autoryzacyjne.

Dane logowania API

Wprowadź dane autoryzacyjne (Login WebAPI, Hasło WebAPI i Numer SAP WebAPI) swojego konta użytkownika, aby nawiązać połączenie z API DHL.

Po wprowadzeniu kompletu danych autoryzacyjnych i zapisaniu zmian Status połączenia z API DHL powinien ulec zmianie na Połączono.

Statusy połączenia z API DHL

• Połączono – dane autoryzacyjne są poprawne i połączenie zostało nawiązane prawidłowo,
• Nie połączono – nie zostały jeszcze wprowadzone kompletne dane autoryzacyjne, niezbędne do nawiązania połączenia,
• Błąd połączenia – dane autoryzacyjne są nieprawidłowe lub nie powiodło się nawiązanie połączenia z API.

Google Maps API

Klucz API Google Maps – wklej swój klucz Google Maps. Jego wprowadzenie jest opcjonalne, lecz zalecane, gdyż umożliwia lepszą lokalizację oraz znacznie dokładniejsze podpowiedzi najbliższych punktów DHL dla wprowadzonego przez klienta adresu.

Wprowadzenie Klucza API Google Maps poskutkuje pojawieniem się poniżej Statusu połączenia z API Google Maps, a po zapisaniu zmian powinien on ulec zmianie na Połączono.

Dane nadawcy

Uzupełnij pola Nazwa, Ulica, Numer domu, Kod pocztowy, Miasto, Telefon i E-mail danymi nadawcy, które będą wykorzystywane przy tworzeniu przesyłek oraz generowaniu etykiet nadawczych i zwrotnych.

Automatyzacja

Użyj opcji Początek i Koniec okna odbioru przez kuriera, aby określić domyślny przedział czasowy odbioru utworzonych przesyłek przez kuriera.

Etykiety

Wybierz format strony etykiety, w którym będą generowane etykiety nadawcze, wybierając jedną z dostępnych opcji:

• BLP – etykieta PDF 10×15 cm,
• LBLP – etykieta PDF A4,
• ZBLP – etykieta ZPL,
• ZBLP300 – etykieta ZPL 300 dpi

Przesyłki zwrotne

Typ zwrotu – zdecyduj, czy przy zwrotach krajowych klient ma mieć możliwość wyboru tylko wysyłki do punktu odbioru, czy do punktu odbioru lub kurierem.

Ważność etykiety zwrotnej (dni) – określ liczbę dni, przez które etykieta po wygenerowaniu pozostaje ważna.

Po wprowadzeniu wszystkich niezbędnych danych w Ustawieniach i zapisaniu zmian, z menu aplikacji widocznego w lewym pasku bocznym wybierz opcję Szablony przesyłek, aby przejść do kolejnego ekranu, na którym skonfigurujesz szablony przesyłek używane przez poszczególne metody dostawy.

Szablony przesyłek

Szablon przesyłki to zestaw domyślnych parametrów, które później wykorzystasz w metodach wysyłki i przy tworzeniu etykiet.

Szablony przyspieszają pracę, bo nie trzeba za każdym razem od nowa wpisywać:

• typu przesyłki,
• wagi,
• wymiarów,
• usług dodatkowych.

Kiedy warto używać szablonów

Utwórz osobne szablony, jeżeli sprzedajesz np.:

• małe koperty,
• standardowe paczki,
• większe paczki,
• palety,
• przesyłki z domyślnym pobraniem lub ubezpieczeniem.

Tworzenie szablonu przesyłki

Przejdź do Szablony przesyłek i kliknij Dodaj szablon.

W formularzu uzupełnij:

• Nazwa szablonu
• Typ przesyłki
• Domyślna waga (kg)
• Długość
• Szerokość
• Wysokość
• Usługi dodatkowe

Jak wypełniać pola

Nazwa szablonu

• służy do rozpoznawania szablonu w aplikacji,
• warto stosować nazwy opisowe, np. Paczka standard, Koperta dokumenty, Paleta 80x120.

Typ przesyłki

• wybierz typ zgodny z tym, jak nadajesz tę przesyłkę w DHL.

Domyślna waga i wymiary

• dla Paczki i Palety są wymagane,
• dla Koperty mogą pozostać puste, jeśli nie chcesz ich uzupełniać na poziomie szablonu.

Usługi dodatkowe

• to lista opcji, które mają być domyślnie zaznaczone przy tworzeniu przesyłki z tego szablonu.

6.3. Edycja i usuwanie szablonów

Na liście szablonów możesz:

• kliknąć Edytuj,
• usunąć szablon przyciskiem usuwania.

Usunięcia nie da się cofnąć.

Dostępne kraje sklepu

Lista krajów widoczna na tym ekranie nie jest dodawana ręcznie. Kraje są pobierane automatycznie na podstawie aktualnej konfiguracji stref wysyłki w sklepie Shopify.

Jeżeli w aplikacji nie widzisz danego kraju:

1. sprawdź profile i strefy dostawy w Shopify,
2. upewnij się, że ten kraj jest aktywny w konfiguracji wysyłki sklepu,
3. wróć do aplikacji i sprawdź listę ponownie.

Dla każdego kraju możesz:

• zobaczyć istniejące metody dostawy,
• rozpoznać metody nieaktywne po oznaczeniu Nieaktywna,
• dodać nową metodę wysyłki przyciskiem +,
• wejść do ustawień istniejącej metody,
• usunąć metodę.

Jak czytać ten ekran

• Jeżeli kraj jest widoczny, oznacza to, że jest skonfigurowany po stronie Shopify.
• Jeżeli przy kraju nie ma metod, możesz od razu dodać pierwszą.
• Jeżeli metoda jest nieaktywna, nie będzie używana do liczenia stawek.

7. Metody wysyłki

Metoda wysyłki określa, jak aplikacja ma pokazywać i wyceniać dostawę DHL dla konkretnego kraju.

Ważny warunek

Przed utworzeniem metody wysyłki musisz mieć przynajmniej jeden szablon przesyłki. Jeśli nie masz żadnego szablonu, aplikacja pokaże ostrzeżenie.

Dodawanie nowej metody

Na stronie głównej kliknij + przy wybranym kraju.

Formularz składa się z kilku sekcji.

Status

Pole:

• Włącz metodę wysyłki dla kraju ...

Jeżeli metoda jest włączona:

• będzie brana pod uwagę przy liczeniu stawek.

Jeżeli jest wyłączona:

• pozostaje w konfiguracji,
• ale nie będzie używana w checkout.

Konfiguracja DHL i szablonu

Tutaj wybierasz:

• Usługa DHL
• Szablon przesyłki

Usługa DHL

• decyduje, z jakiego rodzaju usługi DHL korzysta metoda.

Szablon przesyłki

• ustawia domyślne parametry, które będą podpowiadane przy tworzeniu przesyłki dla zamówienia.

Nazwa i opis

Pola:

• Nazwa konfiguracyjna
• Nazwa metody wysyłki
• Opis metody wysyłki

Nazwa konfiguracyjna

• widoczna tylko w aplikacji,
• pomaga rozpoznać metodę na liście.

Nazwa metody wysyłki

• to nazwa używana dla tej metody dostawy.

Opis metody wysyłki

• możesz go dodać dla zwykłych metod wysyłki,
• dla metod punktowych to pole nie jest pokazywane.

Koszt wysyłki

W tej sekcji wybierasz sposób wyliczania ceny:

• Na podstawie wagi produktów
• Na podstawie wartości zamówienia

Niżej definiujesz reguły kosztowe.

Jak działają reguły

Każda reguła zawiera:

• od,
• do,
• koszt.

Możesz zbudować np. przedziały:

• od 0 do 5 kg,
• od 5 do 10 kg,
• od 10 kg wzwyż.

albo:

• od 0 do 100 PLN,
• od 100 do 200 PLN,
• od 200 PLN wzwyż.

Płaska stawka

Jeżeli chcesz ustawić jedną stałą cenę:

• dodaj tylko jedną regułę,
• wpisz koszt,
• pola od i do możesz zostawić puste.

Wskazówki

• koszt jest zawsze wymagany,
• przy wielu regułach uzupełniaj pełne zakresy,
• wartość do nie może być mniejsza niż od.

Punkty odbioru

Ta sekcja pojawia się tylko dla usług punktowych.

Pola:

• Liczba punktów odbioru
• Typ punktu odbioru

Liczba punktów odbioru

• określa, ile punktów aplikacja pokaże klientowi.

Typ punktu odbioru

• pozwala wybrać, czy pokazywać:
• DHL BOX,
• DHL POP,
• albo oba typy jednocześnie.

Jak dobrać ustawienia

Jeżeli chcesz dać klientowi większy wybór:

• ustaw większą liczbę punktów,
• zaznacz oba typy punktów.

Jeżeli zależy Ci na prostszym wyborze:

• pokaż mniej punktów,
• ogranicz listę do jednego typu.

Edycja i usuwanie metody

Na stronie głównej kliknij nazwę metody i wybierz:

• Edytuj ustawienia metody dostawy
• Usuń metodę dostawy

Po usunięciu metoda znika z konfiguracji kraju.

Tworzenie przesyłki z poziomu zamówienia

Po skonfigurowaniu aplikacji możesz tworzyć przesyłki bezpośrednio w szczegółach zamówienia Shopify.

Gdzie znaleźć formularz

Otwórz zamówienie w Shopify Admin.

W szczegółach zamówienia pojawi się blok DHL. Jeżeli dla zamówienia nie ma jeszcze przesyłki, zobaczysz przycisk:

• Utwórz przesyłkę

Co aplikacja uzupełnia automatycznie

Formularz może automatycznie podpowiedzieć:

• usługę DHL,
• datę nadania,
• typ paczki,
• wagę i wymiary,
• usługi dodatkowe,
• dla przesyłek punktowych także punkt odbioru.

Te podpowiedzi wynikają z:

• wybranej metody wysyłki,
• przypisanego do niej szablonu,
• danych z zamówienia.

Jak wypełnić formularz przesyłki

Sprawdź i uzupełnij:

• usługę DHL,
• datę nadania,
• listę paczek,
• usługi dodatkowe,
• kwotę pobrania,
• kwotę ubezpieczenia,
• referencję,
• uwagi,
• punkt odbioru dla przesyłek punktowych.

Paczki

Aplikacja obsługuje:

• pojedynczą paczkę,
• wiele paczek w jednej przesyłce.

Dla Koperty pola wymiarów i wagi mogą pozostać puste, jeśli nie są wymagane w Twoim procesie.

Dla Paczki i Palety uzupełnij:

• wagę,
• długość,
• szerokość,
• wysokość.

COD i ubezpieczenie

Jeżeli zaznaczysz odpowiednią usługę dodatkową:

• COD wymaga wpisania kwoty pobrania,
• Ubezpieczenie wymaga wpisania kwoty ubezpieczenia.

Co dzieje się po zapisaniu

Po zapisaniu aplikacja:

• tworzy przesyłkę w DHL,
• zapisuje numer nadania,
• udostępnia etykietę do pobrania,
• zwykle dodaje tracking do fulfillmentu zamówienia w Shopify.

Blok przesyłki na zamówieniu

Po utworzeniu przesyłki blok DHL pokazuje najważniejsze informacje:

• numer nadania,
• usługę,
• datę nadania,
• usługi dodatkowe,
• pobranie,
• ubezpieczenie,
• referencję,
• uwagi,
• numer etykiety zwrotnej,
• listę paczek przy przesyłkach wielopaczkowych.

Dostępne akcje

W zależności od stanu przesyłki możesz:

• Pobierz etykietę
• Utwórz etykietę zwrotną
• Pobierz etykietę zwrotną
• Usuń etykietę zwrotną
• Usuń

Usunięcie przesyłki

Przycisk Usuń usuwa przesyłkę DHL i usuwa ją z aplikacji.

Używaj tej akcji ostrożnie, jeśli przesyłka została już wykorzystana operacyjnie.

Etykiety zwrotne

Etykietę zwrotną możesz utworzyć dopiero dla istniejącej przesyłki.

Jak utworzyć etykietę zwrotną

1. Otwórz zamówienie.
2. W bloku DHL kliknij Utwórz etykietę zwrotną.

Po poprawnym utworzeniu aplikacja zapisze numer etykiety zwrotnej i pokaże nowe akcje.

Co możesz zrobić dalej

Po utworzeniu etykiety zwrotnej możesz:

• pobrać etykietę,
• usunąć etykietę zwrotną.

Od czego zależy sposób zwrotu

Sposób obsługi zwrotu zależy od ustawień w sekcji Przesyłki zwrotne.

Pamiętaj:

• ustawienia zwrotu dotyczą zwrotów krajowych,
• zwroty zagraniczne są obsługiwane inaczej i nie korzystają z zamówienia kuriera zwrotnego w taki sam sposób.

Lista przesyłek

Ekran Przesyłki pokazuje wszystkie utworzone przesyłki w aplikacji.

Na liście widzisz:

• zamówienie,
• usługę,
• datę nadania,
• numer nadania,
• numer etykiety zwrotnej,
• numer zamówienia kuriera.

Otwieranie zamówienia

Kliknięcie nazwy zamówienia na liście otwiera szczegóły tego zamówienia w Shopify Admin.

Zamawianie kuriera

Na liście zaznacz jedną lub więcej przesyłek, a następnie wybierz:

• Zamów kuriera

Ta operacja:

• zamawia podjazd kuriera DHL dla wybranych przesyłek,
• zapisuje numer zamówienia kuriera przy przesyłkach.

Anulowanie zamówienia kuriera

Jeżeli przesyłki mają już zamówiony podjazd kuriera, możesz zaznaczyć je na liście i użyć akcji:

• Anuluj zamówienie kuriera

Potwierdzenie nadania

W prawym górnym rogu listy dostępna jest akcja:

• Potwierdzenie nadania

Po kliknięciu:

1. wybierasz Datę nadania,
2. wybierasz Typ przesyłki,
3. pobierasz plik.

To przydatne, gdy chcesz pobrać zbiorczy dokument dla przesyłek nadanych danego dnia.

Dobre praktyki pracy z aplikacją

Zacznij od ustawień

Najczęstsza przyczyna problemów to brak kompletnych danych:

• logowania do DHL,
• numeru SAP,
• danych nadawcy.

Używaj szablonów

Jeżeli wysyłasz podobne paczki:

• utwórz kilka szablonów,
• przypisz je do metod wysyłki,
• dzięki temu formularz przesyłki będzie prawie gotowy od razu.

Nadawaj czytelne nazwy

Dobrze sprawdzają się nazwy typu:

• PL kurier standard
• PL DHL BOX
• DE parcelshop
• Paczka 2 kg
• Paleta premium

Dodaj Google Maps API przy punktach odbioru

Jeżeli korzystasz z metod punktowych, klucz Google Maps API poprawia trafność podpowiadanych punktów.

Regularnie sprawdzaj listę przesyłek

Na liście przesyłek szybko zobaczysz:

• które przesyłki mają numer nadania,
• które mają etykietę zwrotną,
• dla których zamówiono kuriera.

Najczęstsze problemy

Nie widzę kraju na stronie głównej

Przyczyna:

• kraj nie jest aktywny w profilach dostawy Shopify.

Co zrobić:

• skonfiguruj kraj po stronie Shopify,
• wróć do aplikacji i sprawdź listę krajów ponownie.

Nie mogę dodać metody wysyłki

Przyczyna:

• nie istnieje jeszcze żaden szablon przesyłki.

Co zrobić:

• przejdź do Szablony przesyłek,
• utwórz pierwszy szablon,
• wróć do formularza metody wysyłki.

Status połączenia z DHL pokazuje błąd

Sprawdź:

• czy wybrany jest właściwy tryb,
• czy login jest poprawny,
• czy hasło jest poprawne,
• czy numer SAP jest poprawny.

Nie mogę utworzyć etykiety

Najczęstsze przyczyny:

• brak danych nadawcy w ustawieniach,
• niepoprawne dane DHL,
• brak adresu dostawy w zamówieniu,
• brak wymaganych parametrów paczki.

Nie widzę punktów odbioru albo wyniki są słabe

Sprawdź:

• czy metoda wysyłki jest punktowa,
• czy ustawiono liczbę punktów i typy punktów,
• czy dodano klucz Google Maps API.

Nie mogę korzystać z aplikacji na planie Basic

Przyczyna:

• sklep nie ma aktywnego Carrier-Calculated Shipping.

Co zrobić:

• skontaktuj się ze wsparciem Shopify,
• aktywuj CCS zgodnie z warunkami planu,
• wróć do aplikacji po aktywacji.