[PL] WooCommerce International
Poniżej znajduje się wtyczka oraz dokumentacja dot. naszej autorskiej wtyczki InPost dla systemu Magento 2.
Dokumentacja opisuję instalację modułu, konfigurację oraz omawia poszczególne funkcjonalności modułu takie jak: tworzenie przesyłek i generowanie etykiet.
Dostępna dla: BE - Belgium / ES - Spain / FR - France / IT - Italy / LU - Luxembourg / NL - Netherlands / PT - Portugal
Wtyczka: 11.03.2025r
Autoryzacja
Środowisko produkcyjne / testowe
Skorzystanie z środowiska PRODUKCYJNEGO jest możliwe tylko po podpisaniu umowy na usługi INTERNATIONAL
- 1 Autoryzacja
- 2 Instalacja
- 3 Konfiguracja
- 3.1 Opis zakładek
- 3.1.1 Autoryzacja
- 3.1.2 Ustawienia Geowidget
- 3.1.3 Ustawienia sprzedawcy
- 3.1.4 Punkty odbioru
- 3.1.5 Opcje wysyłki
- 3.1.6 Szablony paczek
- 3.1.7 Ustawienia produktów
- 3.1.8 Tabela przesyłek
- 3.1 Opis zakładek
- 4 Tworzenie metod dostawy
- 4.1 Ustawienia
- 4.1.1 Logo
- 4.1.2 Nazwa metod
- 4.1.3 Kwota ubezpieczenia
- 4.1.4 Darmowa wysyłka
- 4.1.5 Dodaj etykietę "(darmowa wysyłka)" na końcu tytułu metody wysyłki
- 4.1.6 Rabat dla kuponów
- 4.1.7 Płaska stawka
- 4.1.8 Koszt za zamówienie
- 4.1.9 Status podatku
- 4.1.10 Koszty klasy wysyłkowej
- 4.1 Ustawienia
- 5 Konfiguracja metod dostawy w produktach
- 5.1 Masowa edycja z poziomu wtyczki
- 5.2 Bezpośrednio w produkcie
- 5.2.1 Szablony
- 5.2.2 Dostępność usług
- 6 Obsługa zamówień/wysyłki
- 6.1 Tworzenie przesyłki i pobieranie etykiety
- 6.2 Zamówienie
- 6.2.1 Wybrany paczkomat
- 6.2.2 Status
- 6.2.3 Szablony
- 6.2.4 Wymiary i waga
- 6.2.5 Kwota ubezpieczenia
- 6.2.6 Sposób nadania
- 6.2.7 Numer referencyjny
- 6.3 Masowe tworzenie przesyłek
- 6.4 Masowe pobieranie etykiet
- 7 Utworzenie podjazdu kuriera
- 8 Kontakt
Przed przystąpieniem do instalacji należy posiadać dane dostępowe do połączenia z API:
ClientID oraz ClientSecret
Login oraz hasło
Do połączenia z usługami InPost wymagane jest uzyskanie loginu i hasła.
W celu otrzymania danych autoryzacyjnych należy skontaktować się z InPost poprzez formularz:
Udzielenie dostępu do API → API International → Środowisko: Produkcja lub Sandbox (wyłącznie do testów usługi)
Połączenie z usługami InPost odbywa się poprzez przekierowanie na stronę www. Prosimy o upewnienie się, że mają Państwo w przeglądarce włączone zezwalanie na wyskakujące okienka.
Instalacja
Zaloguj się do panelu administracyjnego Twojego sklepu na platformie WooCommerce
Przejdź do zakładki Wtyczki → Zainstalowane wtyczki
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 panelu bocznym → InPost International
Opis zakładek
Autoryzacja | Opis |
ClientID | ID potrzebne do autoryzacji - w powyższej zakładce AUTORYZACJA jest opisane jak te dane można otrzymać |
ClientSecret | Klucz potrzebny do autoryzacji - w powyższej zakładce AUTORYZACJA jest opisane jak te dane można otrzymać |
Typ API | Tryb Produkcyjny - pozwala generować realne przesyłki, Tryb Sandbox - pozwala generowanie przesyłek, zleceń podjazdów i pobieranie etykiet bez opłat |
Włącz metody wysyłki Inpost International tylko dla administratorów | Włącza widoczność metody dostawy w checkout tylko dla administratora - klienci nie widzą usług |
Połącz się z API | Po uzupełnieniu ClientID i ClientSecret należy wybrać POŁĄCZ SIĘ Z INPOST gdzie należy uzupełnić login i hasło do Manager Paczek, na którym jest włączona usługa International |
Ustawienia Geowidget | Opis |
---|---|
Token produkcyjny Geowidget | Wymagane jest uzupełnienie tokenu do Geowidget w celu włączenia widoczności usług w checkout (tylko środowisko Produkcyjne). Token należy wygenerować w InPost - Manager paczek zakładka Moje konto - API - Geowidget |
Token sandbox Geowidget | Wymagane jest uzupełnienie tokenu do Geowidget w celu włączenia widoczności usług w checkout (tylko środowisko Sandbox) Token należy wygenerować w https://sandbox-manager.paczkomaty.pl/auth/login zakładka Moje konto - API - Geowidget |
Wybierz kolor | Zmiana koloru przycisku do wyboru punktu odbioru w checkout |
Brak widoczności usług w koszyku | Ustawienia pozwalają miejsce widoczności przycisku do wyboru punktu odbioru Włączyć tryb JS i Skrypt Geowidget, które włączają przycisk wyboru punktu odbioru jeśli checkout jest niestandardowy |
Ustawienia sprzedawcy |
|
---|---|
Nazwa i dane adresowe nadawcy | Należy uzupełnić dane nadawcy przesyłek, mogą być widoczne na etykietach |
Punkty odbioru |
|
---|---|
Dodaj lub usuń punkty | Pozwala stworzyć punkt odbioru, który po zleceniu odbioru przesyłki będzie widoczny dla kuriera. Można wygenerować kilka punktów. |
Opcje wysyłki |
|
---|---|
Nie udostępniaj usług InPost Paczkomaty gdy waga produktu wynosi więcej niż 25kg | W przypadku ustawienia wagi w produkcie - gdy ta wynosi ponad 25kg usług InPost nie wyświetla się w checkoucie jako forma dostawy |
Zmienić status zamówienia na ZREALIZOWANO po wygenerowaniu przesyłki? | Automatyczna zmiana statusu na ZREALIZOWANY po wygenerowaniu przesyłki w panelu InPost |
Wysłać mail do kupującego o rozpoczęciu procesu dostawy zaraz po utworzeniu przesyłki? | Automatyczna wysyłka maila o rozpoczęciu procesu dostawy produktów po utworzeniu przesyłki (szablon maila WooCommerce) |
Automatycznie skopiować komentarz kupującego do pola 'Numer referencyjny' | Uzupełnienie pola Numer referencyjny komentarz dodany przez kupującego podczas składania zamówienia - w przypadku jego pozostawiania i stworzenia przesyłki pojawi się na etykiecie. |
Domyślny sposób wysyłki | Ustawienia określa przy tworzeniu przesyłki domyślny sposób jej nadania → u KURIERA lub w PACZKOMAT |
Szablony paczek |
|
ON / OFF tej opcji, aby wypełnić wymiary z ustawień produktu lub utworzyć własne szablony poniżej i ustawić dowolny jako domyślny | Pozwala włączyć lub wyłączyć opcję pobierania wymiarów z ustawień produktów |
Szablony | Tworzenia lub usuwanie szablonów przesyłek, które można wybrać podczas tworzenia przesyłki lub automatycznie przypisać go do produktów |
Ustawienia produktów |
|
---|---|
Zarządzanie ustawieniami produktów | Umożliwia:
|
Tabela przesyłek |
|
---|---|
Zarządzanie przesyłkami | Pozwala zarządzać utworzonymi zamówieniami przez metodę dostawy InPost International. Zlecać podjazdy, pobierać etykiety i sprawdzać status przesyłki |
Tworzenie zlecenia podjazdu | Wybierając sposób nadania - KURIER i klikając FILTR pojawi się możliwość wygenerowania podjazdu kuriera po przesyłki |
Tworzenie metod dostawy
Do poprawnego działania usługi InPost International należy dodać metodę dostawy do ustawień WooCommerce
W tym celu można przejść od razu do miejsca gdzie należy to zrobić klikając w konfiguracji wtyczki przycisk → Ustawienia wysyłki WooCommerce
Należy wybrać strefę dla konkretnego kraju lub utworzyć jedną z kilkoma krajami i dodać metodę wysyłki
Dostępna dla: BE - Belgium / ES - Spain / FR - France / IT - Italy / LU - Luxembourg / NL - Netherlands / PT - Portugal
Po dodaniu metody należy ją skonfigurować klikając EDYTUJ
Ustawienia |
|
---|---|
Logo | Wybór logo domyślnie wgranych lub możliwość wgrania własnego |
Nazwa metod | Domyślnie określona zgodnie z standardem |
Kwota ubezpieczenia | Istnieje możliwość ustawienia kwoty ubezpieczenia wartością domyślną (która przypisze się automatycznie podczas tworzenia przesyłki) lub zaznaczając checkbox - automatycznie wartość zamówienia przypisze się do ubezpieczenia. Ubezpieczenie może równać się z dodatkową opłatą - należy ustalić tą kwestią z Opiekunem Handlowym |
Darmowa wysyłka | Kwota, od której przesyłka będzie darmowa dla danego zamówienia |
Dodaj etykietę "(darmowa wysyłka)" na końcu tytułu metody wysyłki | Zastępuje stawką 0 zł za dostawę na napis “darmowa wysyłka” |
Rabat dla kuponów | Bezpłatna wysyłka będzie dostępna na podstawie kwoty zamówienia przed rabatem |
Płaska stawka | Ustawiając płaska stawka - kwota za dostawę jest zawsze ta sama. Odznaczając tą opcję pojawi się możliwość ustawienia ceny względem:
|
Koszt za zamówienie | Cena za dostawę (przy płaskiej stawce) |
Status podatku | Kwota dostawy opodatkowana lub nie |
Koszty klasy wysyłkowej | Ustawienie cen względem klasy wysyłkowej |
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
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
Zakładka InPost -> Ustawienia produktów
Dostępność usług
Bezpośrednio w produkcie należy ustawić widoczność poszczególnych usług w koszyku (nowo utworzonych również)
Obsługa zamówień/wysyłki
Tworzenie przesyłki i pobieranie etykiety
Umożliwia generowanie przesyłek i pobieranie etykiet
Przechodząc do konkretnego zamówienia po wybraniu przez klienta usługi InPost International pojawia się okno dot. wysyłki InPost
Zamówienie | Opis |
---|---|
Wybrany paczkomat | Nazwa urządzenia, które wybrał klient składając zamówienie |
Status |
|
Szablony | Pozwala wybrać utworzony wcześniej szablon lub oznaczyć Z ustawień produktu → wymiary będą pobrane z produktu |
Wymiary i waga | Pobierane z szablonów lub z produktu → można edytować |
Kwota ubezpieczenia | Kwota domyślna ustawiona w konfiguracji metody dostawy lub z wartości zamówienia (jeśli taka opcja została wybrana w metodzie dostawy) |
Sposób nadania | Wartość domyślna z ustawień wtyczki Opcje wysyłki → możliwa edycja |
Numer referencyjny | Domyślnie jest to numer zamówienia WooCommerce → możliwa zmiana w Opcje wysyłki na komentarz kupującego |
Po utworzeniu przesyłki pojawia się numer śledzenia i przycisk Pobierz etykietę → klikając w nią pobiera się PDF
Masowe tworzenie przesyłek
Jest możliwe tworzenie masowo przesyłek (tych, które nie mają jeszcze numeru śledzenia) poprzez wejście w zakładkę WooCommerce → Zamówienia
Zaznaczamy konkretne zamówienia checkboxem
Wybieramy z Działania masowe → InPost INT tworzenie przesyłek
Paczki po utworzeniu uzyskają numer 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:
Utworzenie podjazdu kuriera
Zlecanie podjazdu kuriera jest możliwe w konfiguracji wtyczki w zakładce TABELA PRZESYŁEK
We wtyczce International w podjeździe kuriera określamy dzień odbioru, godzinę, ilość przesyłek i ich wagę
→ najpóźniejszy czas odbioru jest określany przez kod pocztowy i godzinę graniczną nadania przesyłki
Kontakt
W przypadku pytań zapraszamy do skorzystania z naszego formularza kontaktowego dostępnego pod linkiem Support | InPost . Po wejściu w formularz wystarczy wybrać z listy opcję Wsparcie Klienta, w kategorii wybrać: Moduł InPost International, a w polu Proszę podać nazwę modułu podajemy: WooCommerce