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 konfiguracją przygotuj:
– dane logowania do DHL WebAPI,
– numer SAP dla konta DHL,
– dane nadawcy,
– opcjonalnie klucz Google Maps Geocoding API,
– poprawnie skonfigurowane strefy dostawy w Shopify.
Pierwsza konfiguracja aplikacji
Po instalacji najlepiej przejść przez konfigurację w tej kolejności:
1. Uzupełnij `Ustawienia`.
2. Utwórz co najmniej jeden `Szablon przesyłki`.
3. Dodaj `Metodę wysyłki` dla wybranego kraju.
4. Wykonaj test na przykładowym zamówieniu.
#### Kraje w aplikacji
Lista krajów w aplikacji nie jest dodawana ręcznie. Kraje są pobierane z konfiguracji dostawy w 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.
## 4. Ustawienia
Ekran `Ustawienia` służy do skonfigurowania połączenia z DHL i domyślnych parametrów pracy aplikacji.
### 4.1. Tryb aplikacji
Sekcja `Tryb aplikacji` zawiera pole:
– `Tryb testowy`
Gdy tryb testowy jest włączony:
– aplikacja używa testowych danych logowania DHL,
– sprawdzenie połączenia odbywa się na danych testowych.
Gdy tryb testowy jest wyłączony:
– aplikacja używa danych produkcyjnych.
Wybierz tryb zgodnie z tym, na jakim środowisku DHL aktualnie pracujesz.
### 4.2. Dane logowania API
W tej sekcji wpisujesz dane autoryzacyjne do DHL WebAPI.
W zależności od wybranego trybu zobaczysz:
– `Login WebAPI`
– `Hasło WebAPI`
– `Numer SAP WebAPI`
lub:
– `Login WebAPI (test)`
– `Hasło WebAPI (test)`
– `Numer SAP WebAPI (test)`
Pod formularzem widoczny jest `Status połączenia`.
Interpretacja statusu:
– `Połączono` – dane są poprawne,
– `Nie połączono` – formularz nie zawiera jeszcze kompletu danych,
– `Błąd połączenia` – dane są niepoprawne albo połączenie z API nie powiodło się.
Jeżeli status pokazuje błąd:
– sprawdź login,
– sprawdź hasło,
– sprawdź numer SAP,
– upewnij się, że wybrałeś właściwy tryb: testowy albo produkcyjny.
### 4.3. Google Maps API
Pole `Klucz API Google Maps` jest opcjonalne.
Ten klucz poprawia dobór punktów odbioru dla metod typu punktowego. Po jego dodaniu aplikacja może dokładniej wskazywać najbliższe punkty na podstawie adresu klienta.
Jeżeli nie podasz klucza:
– aplikacja nadal działa,
– ale przy metodach punktowych będzie korzystać z prostszego dopasowania, głównie po kodzie pocztowym.
Po wpisaniu klucza pojawi się `Status połączenia z API Google Maps`.
### 4.4. Dane nadawcy
Dane z tej sekcji są używane jako domyślne dane nadawcy przy tworzeniu przesyłek.
Uzupełnij:
– `Nazwa`
– `Ulica`
– `Numer domu`
– `Kod pocztowy`
– `Miasto`
– `Telefon`
– `Email`
Pola wymagane:
– nazwa,
– ulica,
– numer domu,
– kod pocztowy,
– miasto.
Bez poprawnych danych nadawcy nie utworzysz etykiety.
### 4.5. Automatyzacja
Sekcja `Automatyzacja` określa domyślne godziny odbioru przez kuriera.
Pola:
– `Początek okna odbioru przez kuriera`
– `Koniec okna odbioru przez kuriera`
Te wartości są wykorzystywane przy:
– tworzeniu przesyłek,
– zamawianiu kuriera.
Podawaj godziny w formacie `HH:MM`, np. `10:00` i `16:00`.
### 4.6. Etykiety
Tutaj wybierasz format etykiety DHL.
Pole:
– `Format etykiety`
Dostępne opcje zależą od ustawień aplikacji, ale obejmują m.in. PDF i ZPL.
Wybierz format zgodny z tym, jak drukujesz etykiety w firmie.
### 4.7. Przesyłki zwrotne
Ta sekcja dotyczy zwrotów krajowych.
Pola:
– `Typ zwrotu`
– `Ważność etykiety zwrotnej (dni)`
`Typ zwrotu` określa, czy przy zwrotach krajowych klient ma korzystać:
– tylko z punktu odbioru,
– z punktu odbioru lub kuriera.
`Ważność etykiety zwrotnej` określa liczbę dni, przez które etykieta zwrotna pozostaje ważna.
## 5. Ekran główny: Dostępne kraje sklepu
Na stronie głównej widzisz listę krajów pobranych automatycznie ze stref dostawy Shopify.
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.
## 6. 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.
### 6.1. 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.
### 6.2. Tworzenie szablonu
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 80×120`.
`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ąć.
## 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.
### 7.1. Dodawanie nowej metody
Na stronie głównej kliknij `+` przy wybranym kraju.
Formularz składa się z kilku sekcji.
### 7.2. 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.
### 7.3. 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.
### 7.4. 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.
### 7.5. 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`.
### 7.6. 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.
### 7.7. 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.
## 8. Tworzenie przesyłki z poziomu zamówienia
Po skonfigurowaniu aplikacji możesz tworzyć przesyłki bezpośrednio w szczegółach zamówienia Shopify.
### 8.1. 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ę`
### 8.2. 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.
### 8.3. 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.
### 8.4. 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.
## 9. 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.
## 10. 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.
## 11. 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.
### 11.1. Otwieranie zamówienia
Kliknięcie nazwy zamówienia na liście otwiera szczegóły tego zamówienia w Shopify Admin.
### 11.2. 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.
### 11.3. 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`
### 11.4. 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.
## 12. 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.
## 13. 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.
## 14. Sugerowana kolejność wdrożenia
Jeżeli konfigurujesz aplikację po raz pierwszy, skorzystaj z tej kolejności:
1. Uzupełnij dane DHL i dane nadawcy w `Ustawienia`.
2. Wybierz format etykiety.
3. Ustaw zasady zwrotów.
4. Dodaj klucz Google Maps API, jeśli chcesz używać punktów odbioru wygodniej.
5. Utwórz 2-3 podstawowe `Szablony przesyłek`.
6. Dodaj `Metody wysyłki` dla krajów, które już masz aktywne w Shopify.
7. Utwórz testową przesyłkę z poziomu zamówienia.
8. Sprawdź, czy działa pobieranie etykiety i tracking.
9. Przetestuj `Potwierdzenie nadania` i `Zamów kuriera`.
## 15. Podsumowanie
Najważniejsze elementy pracy z aplikacją są trzy:
1. `Ustawienia` – tutaj konfigurujesz połączenie z DHL i działanie aplikacji.
2. `Szablony przesyłek` – tutaj budujesz gotowe wzorce paczek.
3. `Metody wysyłki` – tutaj decydujesz, jak DHL ma działać dla poszczególnych krajów.
Po poprawnym ustawieniu tych trzech obszarów dalsza obsługa jest prosta:
– tworzysz przesyłki z poziomu zamówień,
– pobierasz etykiety,
– tworzysz zwroty,
– zarządzasz kurierem i potwierdzeniami nadania z poziomu listy przesyłek.