Instrukcja użytkownika Aplikacja dla Magento
Instrukcja użytkownika Aplikacja dla Magento Wersja 1.0 Warszawa, Lipiec 2016 Strona 2 z 15 Instrukcja użytkownika Aplikacja dla Magento
Spis treści 1. Wstęp...4 Wymagania systemowe...4 Aktualizacje...4 2. Tryb pracy...5 Uruchomienie jako aplikację desktopową...5 3. Konfiguracja modułu...6 Połączenie z Magento...6 Etykiety i protokoły...7 Dane konta webserwisu DPD...7 Adres nadawcy...8 Miejsce zapisu nr listu...8 Dane dodatkowe z Magento...9 Szablon przesyłki...9 Inne...10 4. Działanie modułu...11 Zakładka Zamówienia...11 Generowanie listu...12 Zakładka Wysyłki...13 5. Ustawienia Magento...14 Konfiguracja w sklepie...14 Strona 3 z 15 Instrukcja użytkownika Aplikacja dla Magento
1. Wstęp Wsparcie Aplikację można pobrać ze strony internetowej: http://www.imag.pl/dpd/ Na stronie znajdują się również inne przydatne informacje oraz niniejsza instrukcja. Pytania dotyczące funkcjonalności aplikacji prosimy przesyłać na adres mailowy: itcustomersupport@dpd.com.pl. Wymagania systemowe W celu zapewnienia optymalnej pracy aplikacji zaleca się zapewnienie podanego minimum wymagań: Komputer z procesorem 1 GHz kompatybilny z x86; 512 MB RAM (1024 MB RAM dla Windows Vista, Windows 7, Windows 8); Windows XP SP3/Vista/Windows 7/ Windows 8; Łącze internetowe o prędkości 2 Mb. Aktualizacje W przypadku nowszych wersji programu lub poprawek zostanie udostępniony nowy plik DPD.exe. Należy go skopiować do katalogu, który został wskazany podczas instalacji i zaakceptować zastąpienie obecnego pliku (aplikacja w tym momencie nie może być uruchomiona). Strona 4 z 15 Instrukcja użytkownika Aplikacja dla Magento
2. Tryb pracy Uruchomienie jako aplikację desktopową Jeśli moduł nie został wcześniej skonfigurowany otworzy się okno Ustawień, w przeciwnym wypadku zostaniemy przeniesieni do zakładki Zamówienia, w której możemy podejrzeć listę dokumentów utworzonych w sklepie Magento. Dopiero wybranie zamówienia z listy poprzez dwukrotne kliknięcie przycisku myszy powoduję uzupełnienie pól w zakładce Generowanie przesyłek i przejście do niej. Strona 5 z 15 Instrukcja użytkownika Aplikacja dla Magento
3. Konfiguracja modułu Połączenie z Magento Ustawienie połączenia z Magento jest najważniejszą czynnością jaką trzeba wykonać przed rozpoczęciem pracy. Moduł DPD łączy się z API Magento za pomocą wcześniej utworzonego konta do API SOAP w panelu administracyjnym sklepu. Ważne: Poprawność danych należy sprawdzić za pomocą przycisku #Testuj połączenie, który w przypadku prawidłowych danych zwróci tekst OK!, lub w przypadku nieprawidłowych tekst Niepoprawne dane. Jeśli podaliśmy prawidłowe dane możemy przejść do pozostałych ustawień. Strona 6 z 15 Instrukcja użytkownika Aplikacja dla Magento
3. Konfiguracja modułu Etykiety i protokoły W sekcji Miejsce zapisu należy wskazać folder, do którego będą zapisywane etykiety oraz protokoły. Ważne, żeby konto użytkownika miało uprawnienia do zapisywania plików w wybranym katalogu. W sekcji Drukarki można wybrać osobne drukarki dla wydruku etykiet i protokołów. Jeśli wybrana przez nas drukarka do etykiet jest etykieciarką możemy dodatkowo wybrać format w jakim zapiszę się plik etykiety. Dane konta webserwisu DPD W tej zakładce podajemy dane dostępowe do webserwisu DPD, przy czym należy zwrócić uwagę, że nie są to te same dane, którymi można się zalogować Aplikacji Webklient. Oprócz wpisania loginu i hasła należy również podać adres pliku WSDL oraz numer klienta. Ważne: Po uzupełnieniu danych możemy dodatkowo sprawdzić ich poprawność wybierając przycisk #Sprawdź poprawność. Strona 7 z 15 Instrukcja użytkownika Aplikacja dla Magento
3. Konfiguracja modułu Adres nadawcy Tymi danymi będzie uzupełniony adres nadawcy w zakładce Generowanie przesyłek bez względu na dane pobrane z Magento. Jeżeli pole Domyślny adres nadawcy nie jest zaznaczone, adres jest pobierany z adresów firmy, na którą został wystawiony wybrany przez nas dokument. Miejsce zapisu nr listu Opcja umożliwia przesyłani numeru listu w systemie DPD do Magento. Po jej zaznaczeniu Aplikacja przesyła numer przesyłki DPD do Magento (tworzy wysyłkę do zamówienia i numer paczki zapisuje jako tracking number). Strona 8 z 15 Instrukcja użytkownika Aplikacja dla Magento
3. Konfiguracja modułu Dane dodatkowe z Magento W tej zakładce możemy wybrać, czy z Magento mają pobierać się dodatkowe dane i wybrać pola, do których automatycznie zostaną zapisane. Szablon przesyłki Sekcja ta służy do zadeklarowania stałych usług, które mają być dopisane do każdej paczki wygenerowanej przez aplikację. W celu aktywacji szablonu należy zaznaczyć opcję Włącz. Pole Pobierz kwotę z Magento przy polach Przesyłka wartościowa i Pobranie C.O.D będzie skutkowało przeniesieniem wartości do zapłaty z Magento na list przewozowy (w przypadku C.O.D. dodatkowym warunkiem jest zaznaczenie danego sposobu płatności w zakładce inne). Strona 9 z 15 Instrukcja użytkownika Aplikacja dla Magento
3. Konfiguracja modułu Inne W tej zakładce mamy możliwość utworzenia reguł dla przesyłki za pobraniem. Po wciśnięciu przycisku Pobierz dane z Magento Moduł DPD pobierze dane o dostępnych w sklepie metodach płatności. Dla zaznaczonych metod aplikacja będzie pobierała kwotę pobrania i jeśli w szablonie przesyłki zostanie ustawione pobieranie tej wartości z Magento to na liście przewozowym pojawi się ta kwota. Można też ustawić, czy waga domyślna dla pierwszej paczki ma być pobierana z Magento, czy uzupełniana stałą wartością wpisaną przez użytkownika. Strona 10 z 15 Instrukcja użytkownika Aplikacja dla Magento
4. Działanie modułu Zakładka Zamówienia Zamówienia można filtrować po jego numerze, nazwie kontrahenta, sposobie dostawy, rodzaju płatności, nazwie produktów Gdy znajdziemy interesujący nas dokument klikamy w dany wiersz dwukrotnie ta operacja spowoduje przejście do zakładki Generowanie przesyłek, w której dane adresowe dla dokumentu zostaną automatycznie uzupełnione. Ważne: Istnieje możliwość generowania numerów listów dla wielu dokumentów jednocześnie w tym celu należy zaznaczyć dokumenty, dla których ma się odbyć operacja, a następnie kliknąć na przycisk #Przygotuj wysyłkę. Adres nadawcy Dane pobierane do tej sekcji to dane nadawcy z konfiguracji Modułu DPD. Adres odbiorcy Moduł wyświetla pobiera adres dostawy dla danego zamówienia. Dostępne usługi: - Doręczenia gwarantowane; - Doręczenie do rąk własnych; - Doręczenie na adres prywatny; - Pobranie C.O.D.; - Odbiór własny; - Dokumenty zwrotne; - DOX; - Przesyłka zwrotna;- Opony - Paleta; - Przesyłka wartościowa; Strona 11 z 15 Instrukcja użytkownika Aplikacja dla Magento
4. Działanie modułu Paczki W tabeli naley podać liczbę paczek uzupełniając je o dodatkowe informacje takie jak waga, zawartość, uwagi, wymiary. Ważne: Tylko pole waga jest pozycją obowiązkową do uzupełnienia. Pozostałe Wybór płatnika z trzech dostępnych opcji: Nadawca, odbiorca, trzecia strona. W przypadku wyboru odbiorcy lub trzeciej strony pojawia się okno, w którym należy wybrać wcześniej zdefiniowany w ustawieniach numer FID (nr klienta). Przesyłkę można uzupełnić o dodatkowe informację uzupełniając pola Ref1 i Ref2. Zapisz etykietę domyślnie wybranie opcji Generuj numer listu i poprawne przetworzenie danych przez webserwis DPD powoduje wypełnienie pola Nr listu oraz zapis do bazy danych. Jeśli opcja Zapisz etykietę jest zaznaczona to program generuje etykietę i zapisuje w zdefiniowanym katalogu. Dodatkowo jeśli zaznaczona jest opcja Drukuj etykietę zostanie ona od razu wydrukowana. Pozycja etykiety istnieje możliwość wskazania, od którego miejsca na stronie ma rozpocząć się drukowanie etykiet. Opcja widoczna tylko w przypadku, gdy w ustawieniach nie została zaznaczona opcja Czy wybrana drukarka jest etykieciarką?. Generowanie listu W momencie, gdy zostały uzupełnione wszystkie pola należy kliknąć na #Generuj numer listu. Poprawne wykonanie operacji zostanie zasygnalizowane pojawieniem się komunikatu: Strona 12 z 15 Instrukcja użytkownika Aplikacja dla Magento
4. Działanie modułu Zakładka Wysyłki Tabela zawiera wszystkie wygenerowane listy. Listę można filtrować po nazwie kontrahenta, numerze listu lub protokołu oraz z konkretnego przedziału czasowego. Generowanie etykiet Kliknięcie na przycisk generuje etykiety dla wszystkich zaznaczonych przesyłek. Generowanie protokołów Kliknięcie na przycisk generuje protokół składający się z wszystkich zaznaczonych przesyłek. Usuwanie Przesyłki które zawierają błędy, niepoprawne dane lub niezgodne usługi można usunąć z listy przez co nie znajdą się one na protokole przekazania towaru i zostaną usunięte z systemu. Ważne: Usunięcie paczki, która posiada już wygenerowany nr protokołu spowoduje, że dla wszystkich pozostałych paczek nr protokołu zostanie usunięty (tylko numer) i konieczne będzie ponowne wygenerowanie protokołu. Inne Dwukrotne kliknięcie lewym przyciskiem myszy na wybranym wierszu spowoduje przejście do zakładki Generowanie przesyłek i odtworzenie danych przesyłki. Strona 13 z 15 Instrukcja użytkownika Aplikacja dla Magento
5. Ustawienia Magento Konfiguracja w sklepie 1. W celu wgrania sposobów wysyłki DPD należy rozpakować plik app.zip i nadpisać katalog app na FTP - moduły po wyczyszczeniu cache powinny się pokazać w panelu. 2. Następnie w panelu administracyjnym Magento należy stworzyć użytkownika API SOAP z przypisaną rolą, która ma dostęp do wszystkich metod z kategorii wysyłki/produkty/płatności/zamówienia. Danymi dostępowym dla tego konta będziemy się łączyli za pomocą modułu DPD do Magento. 3. Po wgraniu pliku app.zip metody wysyłki DPD pojawią się w konfiguracji Magento (System -> Configuration -> Sales -> Shipping methods): 4. W panelu administracyjnym sklepu należy ustawić cache owanie pliku WSDL (opcja ta jest dostępna w System -> Configuration -> Services -> Magento Core API -> General Settings): Strona 14 z 15 Instrukcja użytkownika Aplikacja dla Magento
5. Ustawienia Magento 5. Po skonfigurowaniu i pozytywnym teście połączenia ze sklepem w zakładce inne możemy skonfigurować domyślną wagę dla przesyłek oraz wybrać rodzaje płatności dla których ma być pobierana kwota COD (do pełnej konfiguracji pobrań należy jeszcze włączyć szablon przesyłki i wybrać pobieranie kwoty z Magento). Strona 15 z 15 Instrukcja użytkownika Aplikacja dla Magento