[PL] WooCommerce
- Michał Machowski
- Paweł Milewski
Poniżej znajduje się dokumentacja do autorskiej wtyczki InPost WooCommerce. Zawiera informację o instalacji oraz konfiguracji wtyczki.
Wtyczkę należy zainstalować i skonfigurować dodając dane autoryzacyjne i tworząc metody dostawy.
Wtyczka: (najnowsza wersja nowego wydania 1.6.1 dostępna na stronie wordpress)
Changelog - rozwiń
Na tej stronie:
- 1 Changelog - rozwiń
- 2 Autoryzacja
- 3 Instalacja
- 4 Konfiguracja
- 4.1 Dane logowania (Autoryzacja)
- 4.2 Ubezpieczenie
- 4.3 Opcje wysyłki
- 4.4 Dodatkowe opcje
- 4.5 Punkt odbioru
- 4.6 Nadawca
- 4.7 Tryb Debugowania
- 5 Dostępne metody dostawy
- 6 Tworzenie metod dostawy (koszyk)
- 7 Obsługa zamówień/wysyłki
- 8 Konfiguracja metod dostawy w produktach
- 8.1 Masowa edycja z poziomu wtyczki
- 8.2 Bezpośrednio w produkcie
- 8.2.1 Szablony
- 8.2.2 Dostępność usług
- 9 Obsługa kuponów na dostawę
- 10 Integracja z Flexible Shipping
- 11 Rozwiązania problemów
- 11.1 Wystąpił błąd podczas łączenia z API
- 11.2 Tworzenie przesyłki - Oferta wybrana
- 11.3 Geowidget - brak dostępu
- 11.4 Brak dostaw w koszyku InPost
- 11.4.1 Brak usług w produkcie
- 11.4.2 Metoda dostawy ‘Darmowa Dostawa’
- 11.5 Brak przycisku “Wybierz Paczkomat”
- 11.6 Przycisk “Wybierz Paczkomat” pojawia się po odświeżeniu strony
- 12 Kontakt
Autoryzacja
Posiadamy dwa środowiska (Manager Paczek x API) - testowe i produkcyjne. Dane należy wygenerować dla tego środowiska, którego obecnie używamy.
Środowisko produkcyjne
Przed przystąpieniem do instalacji należy posiadać dane dostępowe do połączenia z API ShipX:
Token (klucz)
ID organizacji
oraz
Token do Geowidget
Pobierz poradnik wyjaśniający jak szybko we własnym zakresie utworzyć dostęp do API ShipX oraz Geowidget:
https://inpost.pl/sites/default/files/2022-03/instrukcja-konfiguracji-api-shipx.pdf
https://manager.paczkomaty.pl/ > zakładka Moje konto > API
Środowisko testowe (Sandbox)
Generowanie dostępu
https://sandbox-manager.paczkomaty.pl/ > zakładka Moje konto > API
Aby wygenerować Token i ID organizacji należy uzupełnić wszystkie dane, łącznie z danymi do faktury w zakładce Moje konto > Dane. Do utworzenia przesyłki Paczkomat® niezbędne są środki na koncie, konto doładujesz wirtualnie w zakładce Płatności.
Geowidget:
Token do Geowidget > zakładka Moje konto > API > Geowidget
Testy:
Na środowisku sandbox nie ma możliwości przetestowania wysyłki przesyłek i zamawiania podjazdu kuriera - te opcje dostępne są tylko na produkcji. Wynika to z możliwości API Sandbox.
Instalacja
Zaloguj się do panelu administracyjnego Twojego sklepu na platformie WooCommerce
Przejdź do zakładki Wtyczki → Zainstalowane wtyczki
2. W tej zakładce wybieramy przycisk Dodaj nową a następnie Wyślij wtyczkę na serwer
(Kliknij przycisk i wrzuć paczkę instalacyjną w postaci Archiwum)
Konfiguracja
Wyszukiwanie modułu w celu dalszej konfiguracji następuje w zakładce InPost → Ustawienia
Dane logowania (Autoryzacja)
W tym miejscu możesz uzupełnić dane dostępowe do API (Token, ID organizacji), która można wygenerować samemu w Managerze Paczek w zakładce „API”
(Dostęp do środowisk znajduje się na początku tej dokumentacji)
Id organizacji | należy uzupełnić z Manager Paczek (zakładka Moje konto - API, format – 5 cyfr) |
Token | należy uzupełnić z Manager Paczek (zakładka Moje konto - API) |
Token Geowidget produkcyjny | należy uzupełnić z Manager Paczek (zakładka Moje konto - API - Geowidget). Bez tych danych mapa nie będzie wyświetlać się prawidłowo |
Token Geowidget sandbox | należy uzupełnić z Manager Paczek Sandbox (zakładka Moje konto - API - Geowidget). Bez tych danych mapa nie będzie wyświetlać się prawidłowo |
Ważne! Gdy w koszyku w Geowidget pokazuje się błąd “Brak dostępu, sprawdź czy token został wygenerowany dla odpowiedniej witryny” należy ponownie wygenerować token do Geowidget w Manager Paczek ale podając poprawny adres witryny sklepu. Błąd dotyczy podania błędnego adresu url sklepu.
Typ API | Produkcyjne/Sandbox - tutaj należy wybrać w zależności od użytych danych z Manager Paczek (produkcja lub sandbox) |
Szybkie Zwroty | w tym miejscu możesz uzupełnić skróconą nazwę swojego konta założonego w serwisie Szybkie Zwroty |
Ubezpieczenie
Domyślna wartość ubezpieczenia/ Automatyczne pobieranie | umożliwia określenie domyślnej wartości ubezpieczenia, która będzie uzupełniana przy przesyłkach
|
Opcje wysyłki
Domyślne wymiary paczki | dotyczy usługi Paczkomat® - gab. A/B/C |
Domyślna metoda wysyłki | Kurier/Paczkomat® |
Domyślne wymiary dla przesyłek kurierskich | domyślne wymiary dla przesyłek kurierskich (gdy zaznaczone nadpisuje wymiary ustawione w danym produkcie) |
Format etykiety Paczkomat® | który będzie dostępny do pobrania do wyboru A4 lub A6 |
Domyślny Paczkomat® nadawczy | domyślny Paczkomat®, który zostanie podstawiony po wybraniu sposobu wysyłki - Nadaj w Paczkomat® |
Dodatkowe opcje
Włącz metody InPost dla wszystkich produktów w swoim sklepie | Checkbox włączający metody dostawy InPost we wszystkich produktach na raz |
Włącz metodę SmartCourier dla wszystkich produktów w swoim sklepie | Włącza metodę dostawy SmartCourier dla wszystkich produktów |
Nie udostępniaj usług InPost Paczkomaty gdy waga produktu wynosi więcej niż 25kg | Działa tylko wtedy gdy w produkcie jest ustawiona waga |
Wysłać mail do kupującego o rozpoczęciu procesu dostawy zaraz po utworzeniu przesyłki? | Wysyła maila do klienta o utworzeniu przesyłki |
Zmienić status zamówienia na ZREALIZOWANO po wygenerowaniu przesyłki? | Zmienia status zamówienia po utworzeniu przesyłki w zamówieniu |
Automatycznie skopiować komentarz kupującego do pola 'Numer referencyjny' | Automatycznie kopiuje komentarz/uwagi kupującego do pola “Numer referencyjny” podczas tworzenia przesyłki w zamówieniu |
Punkt odbioru
Punkt odbioru | umożliwia dodanie/usuwanie/edycję Punktów Odbioru, w którym kurier odbierze przesyłki |
Nadawca
Nadawca | należy uzupełnić danymi firmy (ważne! numer telefonu nadawcy musi być uzupełniony w formacie 9 cyfr - bez +48 i spacji) |
Tryb Debugowania
Ten tryb pozwala włączyć dodatkowe opcje dostępne dla administratora jak i zmienić miejsce wyświetlania przycisku “Wybierz Paczkomat”
Włącz tryb JS przycisku mapy → Ustawienie dla sklepów Multisite (w przypadku braku przycisku “Wybierz Paczkomat”)
Wyłącz sprawdzanie, aby skrypt dla geowidgetu był podłączony tylko na stronie Checkout → Włączyć gdy nie działa przycisk “Wybierz Paczkomat”
Dostępne metody dostawy
Metody dostawy | Opis |
|---|---|
InPost Paczkomat® 24/7 InPost Paczkomat® 24/7 COD | Dostawa przesyłki do punktów odbioru Paczkomat®/PaczkoPunkt
|
InPost Kurier Standard InPost Kurier Standard COD | Dostawa przesyłki na adres podany przez klienta Usługa dostępna tylko dla klienta biznesowego (umowa)
|
InPost Kurier C2C InPost Kurier C2C COD | Dostawa przesyłki na adres podany przez klienta Usługa dostępna dla klienta detalicznego - (prepaid) (stawki zgodnie z cennikiem na stronie InPost.pl
|
InPost Paczka w Weekend | Dostawa przesyłki do punkt odbioru Paczkomat® w weekend dostępnego 24/7 |
InPost SmartCourier | Dostawa przesyłki na adres podany przez klienta. Usługa dedykowana dostawom towarów wymagających doręczenia osobistego z potwierdzeniem danych odbiorcy. Proces doręczenia wymaga weryfikacji adresata za pomocą takich danych jak imię, nazwisko, pełnoletniość, a w przypadku, gdy doręczenie danej kategorii towarów wymaga trzeźwości odbiorcy przesyłki, zostanie to również zweryfikowane |
Usługi z pobraniem zawierają w nazwie COD (tylko wtedy jest zapisywana wartość pobrania podczas tworzenia paczki)
Tworzenie metod dostawy (koszyk)
Konfiguracja
Aby skonfigurować usługi dostępne w koszyku należy każdą z osobna dodać w konfiguracji
1. W tym celu należy przejść do zakładki WooCommerce → Ustawienia → Wysyłka
2. Wybrać kraj (przycisk edytuj)
3. Kliknąć Dodaj metodę wysyłki
4. Wybrać konkretną usługę, która nas interesuje
5. Usługa zostaje dodana. Należy ją skonfigurować
Wybierając usługę mamy możliwość jej konfiguracji:
Zmiana nazwy usługi | Nazwę usługi i logo należy dodać zgodnie z wytycznymi zawartymi w „Poradniku skutecznej implementacji dostaw InPost w koszyku e-commerce” Poradnik implementacji dostaw znajdziesz pod adresem: |
Zmiana logo | Pierwotnie aktualne logo jest już dodane do metody dostawy |
Ustawienia kwoty, od której obowiązuje darmowa dostawa |
|
Możliwość dodania tekstu “darmowa wysyłka” w checkoucie |
|
Włączenia rabatu dla kuponów |
|
Ustawienia ceny za przesyłkę |
|
Czy przesyłka ma być opodatkowana (zgodnie z zasadami WooCommerce) |
|
Jednolita stawka | Dodatkowo odznaczając Jednolita stawka można ustawić cenę wysyłki pod względem wagi w koszyku, gabarytu jak i ceny samego produktów waga/gabaryt/cena są pobierane z ustawień danego produktu |
Konfiguracja klasy wysyłkowej | Skonfigurowanie klasy wysyłkowej pozwala na grupowanie produktów jeśli chodzi o ceny |
Podgląd:
Przykład wyróżnienia konkretnej dostawy dla danego gabarytu:
Jeśli chcemy bo przesyłki małe do 3 kg były wysyłane za pomocą usługi Paczkomat® należy:
w usłudze Paczkomat® ustawić wagę od 0-3kg → cena
w usłudze Kurierskiej ustawić wagę 3-25kg → cena
W ten sposób w zależności od wybranego produktu (i jego wagi) będzie podstawiać się konkretna usługa
Pozycjonowanie usług dostawy w koszyku jest możliwe w panelu: WooCommerce → Ustawienia → Wysyłka → Kraj (można dowolnie przesuwać usługi klikając na trzy kreski obok nazwy usługi)
Klasa wysyłkowa
Skonfigurowanie klasy wysyłkowej pozwala na grupowanie produktów jeśli chodzi o ceny. Tworzymy klasę wysyłkową, którą w ustawieniach produktu możemy przypisać do konkretnego przedmiotu/przedmiotów
Możemy dodawać dowolną ilość klas wysyłkowych
Tworzenie klasy
Należy utworzyć klasy wysyłkowe w zakładce WooCommerce → Ustawienia → Wysyłka → Klasy wysyłkowe → Dodaj nową klasę wysyłkową
Konfigurowanie w metodzie dostawy
WooCommerce → Ustawienia → Wysyłka → Strefa
W danej formie dostawy np. InPost Paczkomat® 24/7 należy określić jakie koszty wysyłki będą w konkretnej klasie
Priorytet obliczania ceny dostawy
jeśli zostanie osiągnięty próg darmowej dostawy to - darmowa dostawa
jeśli próg darmowej dostawy nie zostanie osiągnięty - bierzemy cenę za klasę dostawy
jeżeli klasa dostawy nie jest określona - to ustawienia naszego pluginu (płaska stawka lub cena z tabeli względem gabarytu/wagi)
Konfiguracja w produkcie
Przechodząc do konkretnego produktu należy w zakładce Wysyłka ustawić do jakiej klasy wysyłkowej ma należeć
InPost Paczkomat® Paczka Ekonomiczna
Produkty zamówione w ramach udostępnianej usługi InPost Paczkomat® Paczka Ekonomiczna zyskują atrakcyjną cenę dostawy. Odbieranie przesyłek ekonomicznych z Paczkomat® InPost to najbezpieczniejszy sposób na realizację zamówień internetowych, zwłaszcza przy pomocy zdalnego otwierania skrytki poprzez aplikację InPost Mobile
Do działania usługi należy dodać nową metodę wysyłki
Zakładka WooCommerce → Ustawienia → Wysyłka → Dodaj metodę wysyłki
2. Następnie należy skonfigurować usługę Podając identyfikator produktu handlowego podanego w umowie i uzupełnić cenę za usługę
3. Po wybraniu przez klienta usługi InPost Paczkomat Paczka Ekonomiczna w zamówieniu pojawi się informacja o usłudze i o wariancie.
InPost Paczka w Weekend
W celu udostępniania usługi Paczka w Weekend należy dodać nową metodę dostawy.
1. W tym celu należy przejść do zakładki WooCommerce → Ustawienia → Wysyłka
2. Wybrać kraj (przycisk edytuj)
3. Kliknąć Dodaj metodę wysyłki
Z listy wybieramy: InPost Paczka w Weekend
Przechodzimy do konfiguracji dostawy:
Ustawiając konkretny dzień i godziny wskazujemy w jakich godzinach podana usługa ma się pokazywać w koszyku na stronie www
Tworzenie przesyłek z usługą PwW jest dostępne od czwartku 20:00 do piątku 18:00 (pomijając przerwy serwisowe)
Szybkie Zwroty
Usługa pozwala klientom na zwrot przesyłki zamówionej w sklepie poprzez Paczkomat®
W konfiguracji wtyczki należy podać link do formularza Szybkich Zwrotów (np. https://szybkiezwroty.pl/pl/Nazwa_sklepu). Link tworzy się po założeniu konta w tej usłudze poprzez Przedstawiciela Handlowego
Klient, który jest zalogowania w sklepie w zakładce zamówienia widzi nowy przycisk Szybkie Zwroty to pozwala na przeniesienie się do Państwa formularza gdzie może dokonać zwrotu
Przycisk Szybkie Zwroty pojawia się w panelu klienta gdy zostanie dodany link w konfiguracji wtyczki “Szybkie zwroty - link”
Zwroty dokonywane poprzez formularz posiadają 2 opcje akceptacji:
Automatyczny - klient w momencie uzupełnienia formularza otrzymuje kod zwrotu, który musi podać będąc przy maszynie
Ręczna akceptacja - klient składa formularz ale to Państwo akceptują bądź nie dany zwrot. Dopiero po akceptacji klient otrzymuje kod zwrotu
Obsługa zamówień/wysyłki
Tworzenie przesyłki i pobieranie etykiet
Umożliwia generowanie etykiet, tworzenie przesyłek, drukowanie zleceń odbioru
Przechodząc do konkretnego zamówienia po wybraniu przez klienta konkretnej usługi pojawia się okno dot. wysyłki InPost
Po uzupełnieniu i weryfikacji danych należy nacisnąć przycisk Wyślij przesyłkę by wygenerować paczkę i nadać numer trackingowy
Po chwili pojawia się przycisk Pobierz etykietę i numer trackingowy
Masowe tworzenie przesyłek
Wtyczka pozwala na masowe tworzenie przesyłek
Należy wejść w zakładkę Zamówienia i zaznaczyć konkretne zamówienia, w których ma zostać utworzona przesyłka
Następnie rozwijamy listę - Działania zbiorcze na górze tabeli i wybieramy InPost PL tworzenie przesyłek
Jest możliwość tworzenia przesyłek masowo z wybranym konkretnie gabarytem A/B/C:
Tworzenie wielu przesyłek i pobieranie etykiet
W zamówieniu jest możliwość tworzenia kilku paczek
Po utworzeniu pierwszej przesyłki pod przyciskiem Pobierz należy kliknąć Utwórz kolejną przesyłkę
Należy wybrać metodę dostawy dla kolejnej przesyłki i kliknąć Dodaj kolejną paczkę
Pokazuje się nowe okno z informacjami o wysyłce. Wybieramy przycisk Utwórz przesyłkę
Okno się odświeża i pojawia się możliwość pobrania etykiety
Ważne! Możliwość nadania kolejnej paczki pojawi się po odświeżeniu strony
Tworzenie przesyłek wielopaczkowych i pobieranie etykiet
W usłudze Kurier Standard jest możliwość generowania przesyłek wielopaczkowych (1/3,2/3 …)
Wchodząc w zamówienie zaznaczamy checkobox: Przesyłka wielopaczkowa
Pojawia się okno z widokiem na dodatkowe przesyłki 5/5 - usuwamy zbędną ilość przesyłek
Podajemy wymiary i klikamy Utwórz przesyłkę
Po utworzeniu przesyłki można pobrać etykiety (ilość etykiet w zależności od ilości przesyłek)
Masowe pobieranie etykiet
Wtyczka pozwala na masowe pobieranie etykiet
Są dwa miejsca, w których można to zrobić
Zakładka Zamówienia - przycisk Działania zbiorcze na górze tabeli:
2. Zakładka InPost - Przesyłki - przycisk Pobierz etykiety (po zaznaczeniu przesyłek)
Utworzenie zlecenia podjazdu kuriera
Zakładki:
InPost → Przesyłki
W tym miejscu możliwa jest obsługa i podgląd zleceń podjazdu, aktualnie procesowanych oraz nadanych przesyłek, generowanie etykiet, tworzenie i drukowanie zleceń odbioru
Panel pozwala na podgląd przesyłek, które otrzymały już numer trackingowy
Zamówienie kuriera → w tym celu należy wybrać w filtrze Sposób nadania: Kurier
Pojawią się przesyłki, których sposób nadania to Kurier
Należy zaznaczyć przesyłkę bądź kilka przesyłek wybrać punkt odbioru przesyłki i kliknąć w Zamów Kuriera
Konfiguracja metod dostawy w produktach
Masowa edycja z poziomu wtyczki
Stworzyliśmy ogólny widok na dodane produkty w sklepie tak by móc łatwiej określać dostępne metody dostawy i gabaryty produktów (Paczkomat)
Jest możliwość filtrowania po kategoriach, typ produktu czy wyszukiwania produktów po nazwie
Bezpośrednio w produkcie
Szablony
W każdym z produktów jest możliwość określenia konkretnych wymiarów dla przesyłek kurierskich i gabarytów dla przesyłek Paczkomat®. Są automatycznie pobierane do zamówienia
Dostępność usług
Bezpośrednio w produkcie należy ustawić widoczność poszczególnych usług w koszyku (nowo utworzonych również):
Obsługa kuponów na dostawę
Obsługę kuponów w koszyku można włączyć w miejscu WooCommerce → Ustawienia → Ogólne → Włącz kupony
Konfiguracja znajduję się w zakładce Marketing → Kupony
Klikamy dodaj kupon
Wybieramy z Typ rabatu → Inpost
Ustalamy wartość kuponu, jego nazwę, datę wygaśnięcia i dla jakich form dostawy ma się pojawić
Klikamy Opublikuj
W koszyku po dodaniu kuponu przez klienta informacja o obniżce pokazuje się nad wysyłką a kwota wysyłki obniża się o wartość kuponu
Integracja z Flexible Shipping
Nasz moduł pozwala na integrację z wtyczką Flexible Shipping
Aby skonfigurować usługi dostępne w koszyku należy każdą z osobna dodać w konfiguracji wtyczki
1. W tym celu należy przejść do zakładki WooCommerce → Ustawienia → Wysyłka
2. Wybrać kraj (przycisk edytuj)
3. Kliknąć Dodaj metodę wysyłki
4. Wybrać Flexible Shipping
Po utworzeniu formy dostawy należy ją skonfigurować
Przechodzimy do konkretnej nowo utworzonej usługi, która wstępnie nazywa się Flexible Shipping i klikamy Edytuj
Uzupełniamy nazwę usługi
2. Wybieramy konkretną usługę przypisaną do InPost API
3. Ustawiamy cenę i konfigurujemy dalsze ustawienia wtyczki Flexible Shipping
Rozwiązania problemów
Wystąpił błąd podczas łączenia z API
Jednym z powodów powyższego błędu jest moment gdy dane podane w miejscu ID organizacji i Token są nieprawidłowe - lub podane dane nie dotyczą Typu API: Sandbox (Sandbox i Produkcja to są dwa osobne środowiska i posiadają różne ID organizacji)
Po każdej modyfikacji tokenu lub ID organizacji należy zapisać ustawienia (tylko wtedy następuje weryfikacja danych autoryzacyjnych)
Ten błąd może się również pojawić gdy połączenie sklepu z API jest zablokowane - po stronie serwera sklepu (należy zweryfikować ten stan w swoim hostingu) lub po naszej stronie. W tym celu prosimy o kontakt poprzez nasz formularz https://inpost.pl/formularz-wsparcie
Tworzenie przesyłki - Oferta wybrana
W zamówieniu podczas tworzenia przesyłki w statusie zamiast nr tracking pojawia się Status: oferta wybrana
To oznacza ,że przesyłka nie została utworzona
Możliwe powody:
Brak środków na koncie w Manager Paczek (w przypadku klientów Prepaid)
Brak nr konta bankowego w Manager Paczek
W przypadku usługi kurierskiej brak podpiętej umowy kurierskiej w Manager Paczek
Błąd dotyczący danych odbiorcy - kod pocztowy
Geowidget - brak dostępu
Gdy w koszyku w Geowidget pokazuje się błąd “Brak dostępu, sprawdź czy token został wygenerowany dla odpowiedniej witryny” należy ponownie wygenerować token do Geowidget w Manager Paczek ale podając poprawny adres witryny sklepu. Błąd dotyczy podania niepoprawnego adresu URL sklepu
Brak dostaw w koszyku InPost
Brak usług w produkcie
W konkretnym produkcie należy dodać usługi InPost:
Można również za jednym razem dodać do wszystkich produktów usługi InPost:
Metoda dostawy ‘Darmowa Dostawa’
Ta metoda w WooCommerce powoduje ,że gdy spełni warunek i może zostać wyświetlona w koszyku przy produkcie usuwa wszystkie inne dostępne metody dostawy
Należy ją usunąć
Darmową dostawę od konkretnej kwoty można ustawić w naszych metodach InPost
Brak przycisku “Wybierz Paczkomat”
Sprawdź:
Zainstalować najnowszą wersję wtyczki
Token do Geowidget - wygenerować go bez podawania URL strony
Sprawdzić czy dodana metoda dostawy została wykonana zgodnie z dokumentacją
[PL] WooCommerce | Tworzenie metod wysyłki (koszyk)
Przetestować checkbox włączyć/wyłączyć w konfiguracji wtyczki opcję: Tryb JS (na samym dole w debugowaniu) lub Wyłącz sprawdzanie, aby skrypt dla geowidgetu
Jeśli jest zainstalowana wtyczka Jetpack lub Webcraftic Clearfy wyłączyć każdą po kolei i sprawdzić czy przycisk się pojawia
W przypadku braku poprawy prosimy o kontakt z nami za pomocą formularza https://inpost.pl/formularz-wsparcie
Przycisk “Wybierz Paczkomat” pojawia się po odświeżeniu strony
Należy włączyć lub wyłączyć (w zależności od stanu po wejściu w panel) opcję ze zrzuty ekranu poniższego:
Kontakt
W przypadku pytań zapraszamy do skorzystania z formularza kontaktowego Działu integracji, który dostępny jest tu: https://inpost.pl/formularz-wsparcie
Po wejściu w formularz wystarczy z listy wybrać opcję "Wsparcie Klienta”, w kategorii wybrać: Moduł InPost, a w polu "Proszę podać nazwę modułu” podajemy: WooCommerce