Instrukcja obsługi modułu Integracja z Inpost z odbiorem w punkcie (Paczkomaty i Kurier) przez SHIPX API! Prestashop 1.5, 1.6, 1.7 i 8!

Tryb testowy

Tryb testowy pozwala na korzystanie z modułu bez żadnych kosztów na testowym koncie Inpost.

Klucz testowy api ShipX uzyskujemy pisząc na adres integracja@inpost.pl.

W przypadku przesyłek paczkomatowych wymagane jest również posiadanie konta w serwisie sandbox-manager.paczkomaty.pl.

Klucz API

Do poprawnego działania modułu integracji potrzebny jest klucz API ShipX, który otrzymujemy od Inpostu.

Klucz API powiązany jest z Twoim kontem manager.paczkomaty.pl i/lub kurier.inpost.pl i umożliwia tworzenie dowolnego typu przesyłek Inpost na Twoim koncie.

Bez poprawnego klucza moduł nie będzie miał możliwości tworzenia przesyłek i zarządzania nimi.

Klucz map Google

Jeśli chcesz umożliwić swoim klientom wybór paczkomatu w koszuku Twojego sklepu z mapy wystarczy, że wygenerujesz swój unikalny klucz map Google.

Wygenerowanie klucza jest darmowe, ale po przekroczeniu limitu 200$ Google będzie pobierać od nas opłaty za korzystanie z ich map.

Limit jest dość spory także w większości przypadków nie przekroczysz go, jednak zawsze masz możliwość kontroli wykorzystania klucza i limitów.

Aby zobaczyć jak wygenerować swój klucz kliknij tutaj.

Domyślny paczkomat klienta

W przypadku włączenia tej opcji moduł będzie automatycznie przypominał klientowi w jego nowych zamówieniach o wybranym wcześniej paczkomacie.

Klient będzie miał możliwość zmiany paczkomatu ale w większości przypadków uprości i skróci czas tworzenia zamówień dla Twoich klientów.

Pokazuj wybór paczkomatu poniżej listy przewoźników

Standardowo wybór paczkomatu w koszyku pokazuje się przy konkretnym przewoźniku. Jeśli jednak wolisz by wybór był poniżej wszystkich przewoźników w sklepie zaznacz tę opcję.

Format wydruku etykiet

Masz możliwośc wyboru formatu wydruku etykiet spośród:

1. PDF
2. EPL
3. ZPL
4. ZPL z rozszerzeniem DPL

Wszystkie formaty poza PDF przeznaczone są do specjalnych drukarek typu zebra

Typ wydruku etykiet

Dotyczy formatu wydruku PDF.

1. normal (poziomy) - etykieta to 1/3 kartki A4
2. A6 (pionowy) - jedna etykieta w formacie A6

Uzupełniaj nr domu przecinkiem jeśli nie podano w zamówieniu

Włączenie tej opcji spowoduje automatyczne uzupełniania adresu klienta w polu nr domu znakiem przecinka tak by system nie zwracał błędu przy walidacji. Przydatne gdy nr domu jest w nazwie ulicy.

Zapisuj nr przesyłki w standardowym polu PrestaShop

Gdy włączysz tę opcję po utworzeniu przesyłki nasz moduł automatycznie przypisze numer śledzenia przesyłki w standardowym polu dostępnym w podglądzie danego zamówienia.

Uwaga Podczas zmiany statusu zamówienia PrestaShop pobiera z tego pola numer śledzenia do uzupełenia linku śledzenia przesyłek w szablonie in_transit. Prosimy mieć to na uwadze jeśli chcesz by klient otrzymywał uzupełniony link śledzenia z opcji standardowych PrestaShop.

Wysyłaj nr przesyłki w standardowym mailu PrestaShop

Włączenie tej opcji spowoduje automatyczną wysyłkę maila z szablonu in_transit z linkiem do śledzenia przesyłki po jej dodaniu.

Jeśli nie korzystasz z opcji wysyłania maila ze śledzeniem przesyłki przy zmianie statusu zamówienia ta opcja może być dla Ciebie przydatna.

Temat maila z nr przesyłki

Przy włączonej powyższej opcji masz możliwość utworzenia dynamicznego tytułu maila, który otrzyma klient.

Masz do dyspozycji międzyinnymi:

1. {firstname} - Imię klienta
2. {lastname} - Nazwisko klienta
3. {id_order} - ID zamówienia
4. {order_name} - Indeks zamówienia
5. {shipping_number} - Nr przesyłki

Np. wpisanie w to pole tekstu {firstname} przesyłka {shipping_number} została wysłana. spowoduje, że klient otrzyma maila z tytułem np. "Tomasz przesyłka 123 została wysłana."

Zmień status zamówienia po dodaniu przesyłki

Włączenie tej opcji spowoduje automatyczną zmianę statusu zamówienia po dodaniu przesyłki na wybrany poniżej.

Status zamówienia po dodaniu przesyłki

Docelowy status zamówienia, na który ma zostać zmienione zamówienie po utworzeniu do niego przesyłki.

Ukryj ostrzeżenie o niewybranym paczkomacie w zamówieniach jeśli dane zamówienie nie ma przypisanego szablonu z usługą paczkomatową.

Moduł informuje ostrzeżeniem, że klient nie wybrał paczkomatu w zamówieniu nawet jeśli nie jest to zamówienie paczkomatowe. Tę informację dla zamówień niepaczkomatowych można ukryć włączając tę opcję.

Ponadto jeśli klient dokonał wyboru paczkomatu, ale np. zmienił następnie przewoźnika moduł poinformuję o takim przypadku odpowiednim komunikatem.

Podczep się pod szablon maila z potwierdzeniem zamówienia.

Jeśli włączysz tę opcję moduł będzie sprawdzał czy klient w zamówieniu wybrał dostawę do paczkomatu wraz z punktem i doda taką informację w tagu szablonu maila order_conf wybranym poniżej.

Tag w mailu potwierdzającym zamówienie dla klienta

Jeśli wprowadzisz istniejący tag np. {delivery_block_html} to moduł zamieni jego zawartość na informację o wybranym paczkomacie klienta.

Możesz wprowadzić swój nowy tag (wymagane dodanie tagu do szablonu order_conf) lub wybrać, któryś z polecanych poniżej.

1. {delivery_block_txt} Adres dostawy dla maila w formacie txt
2. {delivery_block_html} Adres dostawy dla maila w formacie html

Możesz wprowadzić też wiele tagów oddzielając je przecinkiem. Ważne by każdy tag był w nawiasie klamrowym {}.

Wyłącz informowanie o nowej wersji modułu

Standardowo moduł poinformuje automatycznie o nowej wersji do pobrania. Jeśli nie chcesz aktualizować modułu, a denerwują Cię komunikaty o nowej wersji możesz wyłączyć je tą opcją.

Zalecamy jednak korzystanie zawsze z najnowszej wersji modułu gdyż zawiera ona najmniej błędów jak i najwięcej praktycznych rozwiązań, które upraszczają jeszcze bardziej pracę z modułem.

Dodaj informację o wybranym paczkomacie w wiadomości klienta

Po złożeniu zamówienia przez klienta moduł automatycznie zmodyfikuje wiadomość klienta dopisując informacje o wybranym paczkomacie wg. poniższego schematu.

Treść wiadomości dodawanej do zamówienia

Możesz utworzyć dowolną treść wiadomości korzystając z tagów:

1. {name}
2. {address}

Przykładową wiadomością może być np. "Klient wybrał dostawę do paczkomatu: {name}, {address}."

Wyłącz wybór paczkomatu z mapy

Jeśli nie chcesz oferować swoim klientom wyboru paczkomatu z mapy, a jedynie z wyszukiwarki możesz włączyć tę opcję.

Ukryj niepowiązane szablony w zamówieniach

Zalecamy włączenie tej opcji. Moduł nie będzie wprowadzał w błąd i ukryje niepowiązane szablony przesyłek w podglądzie zamówienia. Więcej o szablonach przesyłek w rozdziale Szablony przesyłek.

Ukryj panel wysyłki z Inpost w zamówieniach bez przypisanych szablonów

Jeśli dane zamówienie nie ma być wysłane za pomocą Inpostu to przy właczonej tej opcji moduł będzie ukrywał cały panel wysyłki.

Zawsze jednak będzie można rozwinąć panel gdy zajdzie potrzeba utworzenia przesyłki Inpostowej np. do zamówienia gdzie klient wybrał dostawę Pocztą Polską

Domyślny komentarz podczas zamawiania kuriera

Podczas zamawiania kuriera za pomocą modułu musimy podać komentarz. Można wpisać np. uwaga szkło bądź proszę o kontakt przed dostawą itd.

Uzupełnienie komentarza w konfiguracji spowoduje, że nie będzie trzeba go uzupełniać za każdym razem gdy zamawiamy kuriera.

Pobierz z api

Umożliwia pobranie danych nadawcy z systemu ShipX i automatycznie ich uzupełnienie.

Dane nadawcy widnieją na każdej etykiecie tworzonej w systemie.

Nie wszystkie dane mogą być pobrane z systemu, stąd też pobraniu danych z api zalecamy przejrzeć jeszcze raz wszystkie dane i uzupełnić brakujące elementy.

Ustawienia ogólne szablonu przesyłki

Opcje usługi - Przesyłka paczkomatowa standardowa

Opcje usługi - Przesyłka paczkomatowa Allegro Paczkomaty InPost

Opcje usługi - Minipaczka Allegro InPost

Opcje usługi - Przesyłka kurierska standardowa

Opcje usługi - Przesyłka kurierska Allegro

Informacje o wybranym punkcie

Jeśli zamówienie dotyczy przesyłek paczkomatowych otrzymamy w tym miejscu komunikat o wybranym przez klienta punkcie bądź też ostrzeżenie o niewybranym punkcie przez klienta (np. w przypadku ręcznie dodanych zamówień)

Szablony powiązane z tym zamówieniem

W tym miejscu wyświetlone zostaną wszystkie szablony, które utworzyliśmy i są powiązane z danym zamówieniem.

Powiązanie z danym zamówieniem odbywa się za pomocą wybranego przewoźnika, metodę płatności, wagę oraz wartość zamówienia w szablonie przesyłki.

Jeśli nie ma żadnych powiązanych szablonów z zamówieniem oznacza to, iż albo dane zamówienie nie powinno być wysłane Inpostem, albo nasze szablony są źle skonfigurowane.

Szablony niepowiązane z tym zamówieniem

Jest to jedyne miejsce, gdzie możemy utworzyć przesyłkę na podstawie dowolnie utworzonego przez nas szablonu.

Funkcja niezwykle przydatna gdyż czasami są takie sytuacje, iż chcemy utworzyć przesyłkę np. kurierską Inpost w zamówieniu gdzie klient wybrał dostawę kurierem DHL lub innym.

Tworzenie przesyłek na podstawie szablonów

Kliknięcie na dany szablon przesyłki spowoduje wyświetlenie się formularza dodawania przesyłki, w którym w zależności od powiązanej usługi zostaną wyświetlone odpowiednie dane, które można podać tworząc przesyłkę.

Wszystkie dane, które pojawiają się w formularzu są pobierane na podstawie danych zamówienia oraz domyślnych ustawień szablonów przesyłek.

Jeśli interesuje nas np. by za każdym razem w formularzu było zaznaczone pobranie bądź np. ustawiona stała waga lub wymiary przesyłki możemy to zdefiniować w opcjach usługi w szablonie przesyłki.

Szablon

Jest to nazwa powiązanego szablonu na podstawie, którego wygenerowano formularz.

Usługa

Wyświetlone zostanie nazwa bądź logo usługi powiązanej z danym szablonem

Dostępne usługi znajdziesz w dziale Konfiguracja > Status licencji niniejszej instrukcji.

Informacje o transakcji Allegro

Jeśli szablon dotyczy tak zwanych przesyłek Allegro Dostawa, to w tym miejscu będzie możliwość dodania parametrów, które są wymagane przez Inpost w celu utworzenia przesyłek Allegro.

Przesyłką Allegro nazywamy przesyłkę, która jest ściśle powiązana z danym zamówieniem klienta na Allegro oraz za którą Państwo płacą obniżoną stawkę zgodnie z cennikiem usług Inpost Allegro.

Rozmiar

W tej sekcji można zdefiniwać rozmiar wysyłanej przesyłki bądź też paczek w ramach przesyłki wielopaczkowej.

Nadanie

Podczas tworzenia przesyłki musimy poinformować Inpost w jaki sposób przekażemy im daną przesyłkę.

Do wyboru mamy kilka opcji w zależności od usługi z jakiej korzystamy.

Dane kontaktowe odbiorcy

Do utworzenia przesyłek potrzebne są dwie formy kontaktu z klientem.

1. Adres e-mail - dla powiadomień e-mail
2. Nr telefonu - dla powiadomień sms

Dostawa do

W zależności od powiązanej usługi z szablonem przesyłki możemy tutaj wskazać albo punkt odbioru przesyłki przez klienta bądź też podać jego adres gdzie kurier ma dostarczyć przesyłkę.

Moduł posiada wbudowany system pobierania automatycznie punktu odbioru z wybranego punktu przez klienta w koszyku bądź też np. na aukcji Allegro (z modułu synchronizacji Allegro zainstalowanego w sklepie)

W przypadku dostawy na adres klienta, adres pobierany jest automatycznie z adresu do wysyłki podanego w zamówieniu.

Inpost wymaga by adres klienta zawierał również wyselekcjonowany nr domu, jednakże można obejść te zabezpieczenie podając w polu nr domu np. przecinek.

Można też włączyć opcję "Uzupełniaj nr domu przecinkiem jeśli nie podano w zamówieniu" w konfiguracji aby moduł robił to automatycznie za każdym razem oczędzając nam czasu na poprawki w formularzu.

Aby wyedytować jednorazowo adres w formularzu wystarczy kliknąć ikonę edycji przy adresie i w wyświetlonych polach wprowadzić nowy adres.

Pobranie

W sekcji pobrania mamy możliwość zaznaczenia czy za daną przesyłkę klient ma zapłacić przy odbiorze. Jeśli tak to zaznaczamy "ptaszkiem" oraz podajemy kwotę jaką kurier ma odebrać od klienta.

Kwota jak i opcja pobrania może być zaznaczana automatycznie dla zamówień za pobraniem o ile utworzymy dedykowany do tego szablon przesyłki, w którym wskażemy, że zamówienia z metodą płatności za pobraniem mają mieć zaznaczoną opcję pobrania.

Tym samym moduł również będzie wymagał w koszyku klienta, aby ten wybrał punkt obsługujący pobrania dla przewoźnika wybranego w szablonie.

Ubezpieczenie

Tutaj mamy możliwość ubezpieczenia przesyłki. W przypadku przesyłek pobraniownych ubezpieczenie również jest wymagane.

Opis przesyłki

Dane wprowadzone w tym polu będą również wyświetlane na etykiecie przesyłki.

Zalecamy skonfigurowanie szablonu przesyłki tak by w tym polu moduł automatycznie uzupełniał informacje jak np. indeks zamówienia czy też listę produktów w zamówieniu.

Szczegóły

Przycisk ze szczegółami przesyłki dostępny jest dla przesyłek kurierskich.

W przypadku przesyłek kurierskich kliknięcie na ten przycisk rozwinie nam opcje dodatkowe, które możemy również wybrać podczas tworzenia przesyłki

Z dostępnych opcji dodatkowych mamy miedzy innymi:

1. Serwis SMS
2. Serwis e-mail
3. Doręczenie w sobotę
4. Doręczenie od 17:00 do 20:00
5. Doręczenie do godziny 9:00, 10:00, 11:00, 12:00, 13:00, 14:00, 15:00, 16:00 i 17:00.
6. Zwrot dokumentów

Trwa przygotowanie przesyłki

Podczas tej operacji formularz wysyłany jest do Inpost w celu walidacji wszystkich wprowadzonych danych.

Jeśli walidacja przejdzie pomyślnie ujrzymy informację o generowaniu listu przewozowego, w przeciwnym razie pojawi się komunikat o błędzie, który należy poprawić.

Generowanie listu przewozowego

Ten komunikat oznacza iż przesyłka oczekuje na nadanie nr listu przewozowego. Jeśli takowy otrzyma formularz zniknie, naszym oczom pokaże się nr listu przewozowego i oznaczać to będzie iż przesyłka została stworzona poprawnie.

Jeśli chcesz możesz włączyć automatyczne pobieranie etykiet po utworzeniu przesyłki i bez dodatkowych kliknięć system sam zwróci Ci etykietę na nowo utworzoną przesyłkę.

Popraw następujące błędy / Błędy walidacji danych

Jeśli na czerwonym tle ujrzymy taki komunikat to musimy poprawić błędy, które nam się pojawiły.

Najczęstrze błędy podczas walidacji to:

Data zamówienia

Możesz wybrać z jakiego przedziału czasowego chcesz zobaczyć zamówienia. Filtr ten działa na datę utworzenia zamówienia.

Zalecamy by zawężać listę zamówień za pomocą filtra daty tak by była ona jak najmniejsza. Szczególnie gdy mamy setki zamówień dziennie.

Przewoźnicy

Filtr przewoźników umożliwia precyzyjne wyłapanie tylko tych zamówień, które dotyczą przesyłek Inpostowych.

Płatności

W tym filtrze mamy możliwość wyboru zamówień według powiązanej metody płatności. Możemy więc wybrać tylko te zamówienia, które np. są opłacone przelewm bankowym bądź za pobraniem.

Aktywne statusy zamówień

Jak sama nazwa filtru wskazuje możemy wybrać konkretne statusy zamówień by zobaczyć powiązane z nimi zamówienia.

Wraz ze statusem widoczny jest również jego kolor, który pozwoli na szybkie rozróżnienie statusów.

Przesyłki

Filtr przesyłek stosujemy gdy chcemy zobaczyć zamówienia do których nie utworzyliśmy jeszcze przesyłek bądź też utworzyliśmy.

Jeśli wybierzemy filtr bez przesyłek, lista zamówień zawsze będzie zawierać tylko te zamówienia, które nie mają jeszcze przypisanych przesyłek.

Status opłaconych zamówień

Tutaj możesz wybrać czy na liście mają się pojawić tylko opłacone zamówienia czy też te nie opłacone.

Poprzez opłacone zamówienie rozumiemy takie zamówienie, którego aktualny status ma w ustawieniach włączoną opcję oznaczania zamówienia jako opłacone.

Wyświetlane dane

Chyba jeden z ciekwszych filtrów, który pozwala na konkretny wybór informacji, które mają się pojawić na liście zamówień.

Standardowo wyświetlają się wszystkie informacje, jednak jest ich tak dużo, że widok rozjeżdza się powodując niewygodne zarządzanie listą.

Sugerujemy wybór tylko najbardziej interesujących Cię pól tak by lista mieściła się na ekranie twojego monitora.

W module dostępne są następujące dane, które możemy dowolnie włączać bądź wyłączać:

Edytuj przesyłki do wszystkich zamówień

Ta opcja spowoduje wyświetlenie formularzy dodawania przesyłek do każdego zamówienia wyświetlonego na liście.

Formularze zostają otwarte ale nie wysłane stąd też mamy możliwość przejrzenia każdego i poprawienie ich przed wysłaniem.

Dodaj szybko przesyłki do wszystkich zamówień

Najlepsza opcja pod słońcem :-) Jednym kliknięciem otwierają się wszystkie formularze dodawania przesyłek do zamówień, a po ich otwarciu od razu są zamykane i wysyłane do Inpostu.

Wraz z włączoną opcją automatycznego pobierania etykiet po utworzeniu przesyłki tworzy kombajn, który niezwykle upraszcza i przyspiesza pracę sklepu internetowego!

Nazwa

Twoja nazwa tego punktu odbioru. Będzie wyświetlana na liście adresów podczas zamawiania kuriera

Firma

Nazwa firmy dostępnej pod danym punktem. Pole opcjonalne.

Imię i nazwisko

Dane osoby, która przekaże paczki kurierowi.

Ulica

Ulica na której znajduje się nasz punkt odbioru.

Nr budynku / lokalu

Nr budynku lub lokalu z którego kurier odbierze przesyłki.

Kod pocztowy

Kod pocztowy miejsca z którego kurier odbierze przesyłki.

Miasto

Nazwa miasta z którego kurier odbierze przesyłki.

Kod kraju

Kod kraju w formacie ISO. Powinnien być to kod PL dla Polski.

Nr kontaktowy

Nr telefonu pod który kurier może się kontaktować w celu odebrania przesyłek.

Domyślny

Zaznaczenie tej opcji spowoduje oznaczenie punktu odbioru jako domyślnego i będzie zawsze wybrany podczas zamawiania kuriera.