InPost dla Magento Moduł kompatybilny z Magento Community wersje 1.7.x,1.8.x,1.9.x oraz Magento Enterprise wersje 1.1.x, 1.2.x Instrukcja obsługi
1 Spis treści 1. Konto InPost... 2 2. Instalacja... 2 2.1 Instalacja z serwera... 2 2.2 Instalacja z poziomu panelu administracyjnego... 3 3. Konfiguracja... 5 3.1 Ścieżka dostępu - gdzie widoczny jest moduł?... 5 3.2 Proces konfiguracji modułu... 5 4. Metody wysyłki... 9 5. W jaki sposób korzystać z modułu?... 16 5.1 Front-End (Widok użytkownika sklepu)... 16 5.2 Panel administracyjny... 16 6. Najczęściej zadawane pytania / rozwiązywanie problemów... 18
2 1. Konto InPost Jeśli są Państwo klientem firmy InPost prosimy o kontakt z Państwa Opiekunem Handlowym w celu pozyskania odpowiednich danych pozwalających na aktywację wtyczki. Jeśli są Państwo zainteresowani ofertą firmy InPost prosimy o kontakt na stronie https://inpost.pl/pl/kontakt/skontaktuj-sie-z-nami Skontaktujemy się z Państwem w celu przestawienia oferty. Jeśli posiadają Państwo login oraz token, ale aktywacja wtyczki jest niemożliwa, prosimy o kontakt pod adresem plugin@inpost.pl. Dziękujemy za wybranie naszej oferty, Zespół InPost 2. Instalacja Moduł ORBA InPost dostarczany jest w postaci skompresowanego pliku [tgz]. Zawiera wszystkie pliki niezbędne do instalacji. W celu zainstalowania modułu na Twojej stronie należy wybrać jedną z dwóch dostępnych opcji: 2.1 Instalacja z serwera W związku z tym, że moduł jest kompatybilny z katalogiem Magento, możesz rozpakować plik instalacyjny i wkleić go bezpośrednio do folderu głównego Magento. Następnie należy wykonać 3 kroki opisane poniżej: a. jeśli sklep ma włączoną funkcję kompilacji kodu, jego kompilacja musi zostać ponownie przeprowadzona. [System >> Narzędzia >> Kompilacja >> Rozpocznij proces kompilacji] b. następnie należy wyczyścić pamięć podręczną (cache) [System >> Zarządzanie cache >> Opróżnij składowane cache Magento a także Opróżnij składowanie cache]. Uwaga! Jeśli Twoja strona generuje duży ruch, zalecamy wykonanie tego kroku w nocy strona będzie potrzebować czasu, by zacząć wyświetlać się poprawnie. c. należy się wylogować a następnie zalogować ponownie do Magento moduł ORBA InPost powinien zostać zainstalowany.
3 2.2 Instalacja z poziomu panelu administracyjnego Jeśli masz ograniczony dostęp do serwera, administrator może zainstalować moduł z poziomu panelu administracyjnego. Aby to zrobić należy wejść na [System >> Magento Connect >> Zarządzanie Magento Connect]. Będziesz musiał potwierdzić dane Twoje konta. Uwaga! Interfejs Magento Connect posiada wersję angielskojęzyczną. W celu zainstalowania modułu wykonaj następujące kroki: 1. w zakładce Settings zmień Preffered State na Beta i zapisz zmiany.
4 2. w zakładce Extentions >> Direct package file upload wybierz nasz moduł ze swojego dysku i naciśnij Upload. W konsoli (na dole strony) powinien pojawić się komunikat o statusie operacji oraz komunikat końcowy. Kiedy komunikat wyświetli tekst potwierdzający Upload, postępuj zgodnie instrukcjami i odśwież konsolę. Możesz teraz bezpiecznie wylogować się z Magento Connect Manager (kliknij na Return to admin ). Następnie należy wykonać 3 kroki opisane poniżej: 1. jeśli sklep ma włączoną funkcję kompilacji kodu, jego kompilacja musi zostać ponownie przeprowadzona: [System >> Narzędzia >> Kompilacja >> Rozpocznij proces kompilacji] 2. następnie należy wyczyścić pamięć podręczną (cache) [System >> Zarządzanie cache >> Opróżnij składowane cache Magento a także Opróżnij składowanie cache]. Uwaga! Jeśli Twoja strona generuje duży ruch, zalecamy wykonanie tego kroku w nocy strona będzie potrzebować czasu, by zacząć wyświetlać się poprawnie. 3. należy wylogować a następnie zalogować się ponownie do Magento moduł ORBA InPost powinien zostać zainstalowany.
5 3. Konfiguracja Po zainstalowaniu moduł będzie widoczny w trzech, różnych miejscach. Proces konfiguracji musi odbyć się zgodnie z poniższym schematem obejmującym następujące po sobie kroki. Niezbędne jest zachowanie poniższej kolejności. 3.1 Ścieżka dostępu - gdzie widoczny jest moduł? a. System >> Konfiguracja >> Ogólne >> InPost b. System >> Konfiguracja >> Sprzedaże >> Formy dostawy >> InPost - Paczkomaty oraz InPost - Cross Border c. Sprzedaże >> InPost >> Lista wysyłek (ten ekran zawiera wszystkie wysyłki utworzone za pomocą modułu). 3.2 Proces konfiguracji modułu Po wejściu na System >> Konfiguracja>> Ogólne >> InPost możliwe będzie ustawienie modułu. 3.2.1 Zakładka główna Ogólne Kiedy moduł jest zainstalowany zobaczysz poniższy ekran:
6 Należy wybrać jedną z opcji w zależności od rynku, dedykowanego dla Twojej strony. Raz wybrana opcja zostanie zapisana na stałe upewnij się, że wybierasz poprawną opcję. Wybór zostanie na stale zapisany po naciśnięciu przycisku Zapisz konfigurację (w prawym górnym rogu strony). Na górze strony znajdziesz statusy systemu: a. Status InPost Główny Moduł powinien wyświetlać komunikat Włączony gdy dodano poprawną informację w polu Adres Nadawcy (po zapisaniu) b. InPost Paczkomaty Metoda wysyłki wyświetli się na zielono po dodaniu i przetestowaniu informacji Konfiguracja API Paczkomatów. c. InPost CrossBorder metoda wysyłki wyświetli się na zielono dodaniu informacji z pola Ustawienia API CrossBorder Jeśli korzystasz z trybu debugowania ustawionym na tak, dodatkowo pokaże się ostrzeżenie w zakładce Status modułu. Włączenie trybu debugowania pozwoli Ci na napisanie odpowiedzi z API. Uwaga! To nie jest moduł testowy i będzie widoczny na stronie produkcyjnej.
7 3.2.2 Adres nadawcy Aby przejść do kolejnego etapu należy wprowadzić dane adresowe. 3.2.3 Konfiguracja API Paczkomatów
8 Na tym etapie, należy wpisać ustawienia API dla Paczkomatów. W większości przypadków nie trzeba zmieniać adresu URL, dokonaj zmiany wyłącznie w sytuacji, kiedy jesteś tego pewien lub otrzymasz taką informację od przedstawiciela InPost. Klucz prywatny powinieneś otrzymać z InPost (razem z danymi konta użytkownika). Jeśli nie posiadasz klucza API (token) skontaktuj się z przedstawicielem InPost pod adresem plugin@inpost.pl. Po wypełnieniu formularza należy nacisnąć przycisk Testuj połączenia po wpisaniu prawidłowych danych, przycisk zmieni się na zielony. Powróć do bloku Głównej Konfiguracji (pozostając na tym samym ekranie) i włącz moduł (można tego dokonać później). Zapisz konfigurację w prawym, górnym rogu. 3.2.4 Ustawienia API CrossBorder Na tym etapie, należy wpisać ustawienia API dla metody wysyłki CrossBorder. W większości przypadków nie trzeba zmieniać adresu URL, dokonaj zmiany wyłącznie w sytuacji, kiedy jesteś tego pewien lub otrzymasz taką informację od przedstawiciela InPost. Dane dostępowe do usługi CrossBorder (nazwę użytkownika i hasło) powinieneś otrzymać z InPost (razem z danymi konta użytkownika). Jeśli nie posiadasz tych danych skontaktuj się z przedstawicielem InPost pod adresem plugin@inpost.pl. Po wypełnieniu wszystkich pól formularza należy nacisnąć przycisk Zaloguj się po wpisaniu prawidłowych danych, przycisk zmieni się na zielony.
9 Powróć do bloku Głównej Konfiguracji (pozostając na tym samym ekranie) i włącz moduł (można również tego dokonać później). Zapisz konfigurację w prawym, górnym rogu. 4. Metody wysyłki Po dodaniu wszystkich danych w formularzu możesz przejść dalej do konfiguracji metod wysyłki. W tym celu należy iść do System >> Konfiguracja >> Sprzedaże >> Formy dostawy >> InPost Paczkomaty. 4.1 Paczkomaty InPost 4.1.1 Główna konfiguracja Pole Tytuł wyświetla się na stronie podczas checkout u. Jeśli z jakiegokolwiek powodu wysyłka InPost nie jest możliwa wyświetlony zostanie komunikat błędu z pola Wyświetlony błąd. W polu Kolejność sortowania można ręcznie dodać wartość numeryczną, która będzie pokazywała kolejność wyświetlania tej metody wysyłki względem innych metod. 4.1.2 Przedpłata konfiguracja ceny
10 Metoda płatności Przedpłata ( Prepaid ) oznacza, że klient będzie musiał zapłacić odpowiednią kwotę wynikającą z zamówienia przed wysyłką. Istnieją 3 typy metod płatności Przedpłata : Stała cena stała cena dla każdej przesyłki. Cena dynamiczna na podstawie wagi cena uzależniona od wagi produktów w koszyku. Przy wyborze tej opcji należy dodać nowy wiersz poprzez naciśnięcie przycisku +Dodaj. Wyświetlone zostaną 3 pola. Należy dodać wagę minimalną, wagę maksymalną oraz cenę za przesyłkę dla wszystkich produktów z przedziału wagi minimalnej oraz maksymalnej. Cena dynamiczna na podstawie wartości cena uzależniona od wartości produktów w koszyku. Przy wyborze tej opcji należy dodać nowy wiersz poprzez naciśnięcie przycisku +Dodaj. Wyświetlone zostaną 3 pola. Należy dodać minimalną wartość koszyka, maksymalną wartość koszyka oraz cenę za przesyłkę dla wszystkich produktów z przedziału minimalnej i maksymalnej wartości koszyka.
11 4.1.3 Płatności za pobraniem - konfiguracja ceny Metoda Płatność za pobraniem oznacza, że klient będzie miał możliwość opłacenia zamówienia przy jego dostawie. Uwaga! Nie każdy Paczkomat posiada opcję płatności za pobraniem. Istnieją 3 typy metody Płatność za pobraniem : Stała cena stała cena dla każdej przesyłki Cena dynamiczna na podstawie wagi cena uzależniona od wagi produktów w koszyku. Przy wyborze tej opcji należy dodać nowy wiersz poprzez naciśnięcie przycisku +Dodaj. Wyświetlone zostaną 3 pola. Należy dodać wagę minimalną, wagę maksymalną oraz cenę za przesyłkę dla wszystkich produktów z przedziału wagi minimalnej oraz maksymalnej. Cena dynamiczna na podstawie wartości cena uzależniona od wartości produktów w koszyku. Przy wyborze tej opcji należy dodać nowy wiersz poprzez naciśnięcie przycisku +Dodaj. Wyświetlone zostaną 3 pola. Należy dodać minimalną wartość koszyka, maksymalną wartość koszyka oraz cenę dla wszystkich produktów z przedziału minimalnej i maksymalnej wartości koszyka.
12 4.1.4 Konfiguracja parametrów przesyłki Wartości te można zmieniać w zależności od standardowych wymiarów Twoich produktów. Możesz również zmieniać te wartości przed tworzeniem każdej paczki. 4.1.5 Konfiguracja płatności Jeśli wybrano Przedpłata / Płatność za pobraniem lub obie te opcje, należy wybrać metodę płatności, jaka będzie dostępna dla metody wysyłki. Wszystkie dostępne metody płatności powinny być dostępne w liście. Można wybrać więcej niż jedną metodę przy użyciu przycisku ctrl. Zapisz konfigurację. Konfiguracja została zakończona.
13 4.2 InPost CorssBorder 4.2.1 Główna konfiguracja Pole Tytuł wyświetla się na stronie podczas checkout u. Jeśli z jakiegokolwiek powodu wysyłka InPost CrossBorder nie jest możliwa wyświetlony zostanie komunikat błędu z pola Wyświetlony błąd. 4.2.2 InPost CrossBorder Paczkomaty - Konfiguracja ceny Metoda InPost CrossBorder Paczkomaty dostępna jest obecnie z dostawą do paczkomatu na terenie Czech oraz Słowacji. Istnieją 2 typy ceny dla InPost CrossBorder paczkomaty : Stała cena stała cena dla każdej przesyłki
14 Cena dynamiczna na podstawie wagi i kraju odbiorcy cena uzależniona od wagi produktów w koszyku oraz kraju docelowego (Czechy lub Słowacja). Uwaga! Należy wpisać wszystkie atrybuty wagi. Pozostawienie jakiegoś pola pustego spowoduje, że moduł otrzyma cenę z usługi Cross Border. 4.2.3 InPost CrossBorder Przesyłka kurierska Konfiguracja ceny Metoda InPost CrossBorder - Przesyłka kurierska dostępna jest obecnie z dostawą pod wskazany adres na terenie: Austrii, Belgii, Czech, Danii, Finlandii, Francji, Hiszpanii, Holandii, Irlandii, Niemiec, Portugalii, Słowacji, Szwecji, Wielkiej Brytanii, Włoch. Istnieją 2 typy ceny InPost CrossBorder przesyłka kurierska : Stała cena stała cena dla każdej przesyłki
15 Cena dynamiczna na podstawie wagi i kraju odbiorcy cena uzależniona od wagi produktów w koszyku oraz kraju docelowego (z listy podanej powyżej). Uwaga! Należy wpisać wszystkie atrybuty wagi. Pozostawienie jakiegoś pola pustego spowoduje, że moduł otrzyma cenę z usługi Cross Border. 4.2.4 InPost CrossBorder Konfiguracja parametrów paczki Aby skonfigurować parametry paczki dla InPost CrossBorder należy wybrać kod atrybutu wagi weight - z dostępnej listy a następnie dokonać wyboru atrybutu wagi Waga w kilogramach lub Waga w Gramach. 4.2.5 InPost CrossBorder Konfiguracja płatności Jeśli wybrano CrossBorder Paczkomaty Przedpłata / CrossBorder - Kurier - Przedpłata lub obie te opcje należy wybrać metodę płatności, jaka będzie dostępna dla tej metody wysyłki. Można wybrać więcej niż jedną metodę przy użyciu przycisku ctrl. Zapisz konfigurację. Konfiguracja została zakończona.
16 5. W jaki sposób korzystać z modułu? 5.1 Front-End (Widok użytkownika sklepu) Klient musi wybrać paczkomat (wybór z dostępnej listy lub z mapy) a także dodać swój numer telefonu. Po złożeniu zamówienia, dane te są dostępne dla Administratora w Panelu administracyjnym. 5.2 Panel administracyjny Aby zobaczyć zamówienie należy iść do Sprzedaże >> Zamówienia i kliknąć na wybrane zamówienie. W prawym, górnym rogu należy kliknąć na przycisk Dostawa. Zostaniesz przeniesiony na stronę tworzenia wysyłki w Magento. Powinna pojawić się nowa sekcja InPost Informacje o wysyłce ze szczegółami dotyczącymi wysyłki. Możesz edytować informacje dotyczące wysyłki InPost przed wysłaniem. W tym celu należy kliknąć na mały przycisk edytuj w prawym, górnym rogu na pasku Informacji o przesyłce InPost. Ten krok jest niezbędny wyłącznie w sytuacji, kiedy chcesz zmienić informacje dotyczące wysyłki.
17 Jeśli zdecydujesz się na zmianę jakiejś informacji, zapisz zmiany za pomocą przycisku Zapisz informację w prawym górnym rogu. Aby potwierdzić wysyłkę kliknij w przycisk Wyślij przesyłkę w prawym, dolnym rogu. Istnieje też możliwość odznaczenia opcji Wygeneruj etykietę. Jeśli wybierzesz tę opcję, będziesz mógł wygenerować etykietę w późniejszym terminie. Wysyłka została utworzona. Wraz z utworzeniem wysyłki, system generuje numer śledzenia paczki i przypisuje go do wysyłki. Numer ten jest również wysyłany mailem do zamawiającego.
18 Generowanie numer trackingowego w późniejszym terminie Idź do zakładki Sprzedaże >> InPost >> Lista wysyłek, kliknij na wybraną dostawę i naciśnij przycisk Wyślij informację o numerze przesyłki w prawym, górnym rogu. 6. Najczęściej zadawane pytania / rozwiązywanie problemów 6.1 Co mam zrobić jeśli chcę użyć modułu do innego rynku? Jeden moduł może być użyty wyłącznie dla jednego rynku ale możliwe jest zainstalowanie na kilku platformach Magento i skonfigurowanie go dla poszczególnych rynków. Obecnie moduł obejmuje rynek Włoch, Francji oraz Polski. 6.2 Nie widzę metody wysyłki InPost na mojej stronie internetowej. Kraj podany w adresie wysyłki musi być taki sam, jak typ rynku wybrany w module. Dodatkowo, należy upewnić się, że poprawnie skonfigurowano ceny dla modułu (w zakładce Metody wysyłki) oraz włączono metodę wysyłki InPost (w zakładce Metody wysyłki). 6.3 Zainstalowałem moduł ale nie widzę go w konfiguracji. Najprostszym rozwiązaniem jest wylogowanie się i ponowne zalogowanie do Magento. Prosimy też sprawdzić czy wykonano wszystkie kroki przy instalacji zgodnie z instrukcją podaną na wstępie niniejszego dokumentu.