Dokumentacja modułu Magento 2 – Paczkomaty

1. Założenia i integracja

Moduł Paczkomaty jest przeznaczony dla sklepów internetowych opartych o platformę Magento 2. Dodaje on możliwość oferowania klientom wysyłki zamówienia poprzez InPost Paczkomaty, płatności za pobraniem w paczkomacie oraz automatycznego generowania paczek w Managerze Paczek wraz z innymi funkcjonalnościami, które dostępne są w panelu administratora Magento 2.
Do poprawnego funkcjonowania modułu potrzebne jest podanie klucza API oraz ID organizacji (dostęp do API paczkomatów InPost) – otrzymuje się je od przedstawiciela InPostu.

2. Instalacja

Moduł można pobrać w formie spakowanego pliku zip ze swojego konta.
W celu samodzielnej instalacji modułu należy wykonać następujące czynności:

Pliki rozpakowujemy i wgrywamy do katalogu /app/code/Smartmage/Paczkomaty2
Następnie w konsoli uruchamiamy następujące komendy:

  • php bin/magento module:enable Smartmage_Paczkomaty2

  • php bin/magento setup:upgrade

  • php bin/magento setup:di:compile

  • php bin/magento setup:static-content:deploy pl_PL

  • php bin/magento cache:flush

3. Konfiguracja

Konfiguracja modułu znajduje się w Sklepy → Konfiguracja → Sprzedaż → Metody dostawy → SmartMage Paczkomaty2

 

W konfiguracji możemy:

  • włączyć moduł;

  • ustawić tytuł oraz nazwę metody dostawy jaka będzie wyświetlana w procesie zamówienia;

  • ustawić cenę za dostawę po przedpłacie;

  • ustawić kwotę od której jest darmowa dostawa;

  • ustawić czy opcja zapłaty za zamówienie przy odbiorze w paczkomacie ma być aktywna;

  • ustawić nazwę metody dostawy przy opcji za pobraniem;

  • ustawić cena za dostawę przy opłacie przy odbiorze;

  • ustawić kwotę od której jest darmowa dostawa za pobraniem;

  • dodać tekst ostrzeżenia jaki pojawi się przy wyborze płatności za pobraniem;

  • ustawić do których krajów jest możliwa wysyłka do paczkomatu (w chwili obecnej tylko Polska);

  • ustawić pozycję na której będą wyświetlane paczkomaty na stronie z wyborem dostawy;

  • podać klucz API oraz ID organizacji (dostęp do API paczkomatów InPost) – otrzymuje się je od przedstawiciela InPostu;

  • włączyć lub wyłączyć pokazywanie punktów POP (punkty POP to nie maszyny paczkomatowe tylko inne punkty np. sklepy);

  • ustawić wyłączenie metody płatności za pobraniem jeśli nie jest dostępna w wybranym paczkomacie (pozwala zablokować wybraną metodę płatności np. “płatność gotówką przy odbiorze” gdy wybrano metodę wysyłki do Paczkomatu – po wybraniu “Tak” w tym polu można wybrać metody płatności które zostaną wyłączone).

Dodatkowa konfiguracja znajduje się w Sklepy → Konfiguracja → Ustawienia dostawy → “SmartMage Paczkomaty2 – zaawansowane”.

W tej sekcji możemy:

  • włączyć lub wyłączyć tryb testowy (tryb testowy wymaga podania ID organizacji oraz klucza API przeznaczonych dla trybu testowego – produkcyjne dane nie będą działały w trybie testowym ani odwrotnie);

  • zezwolić na składanie zamówień gdy są problemy z API Inpostu – jeśli API Inpostu nie odpowiada a ustawione jest automatyczne generowanie przesyłek to może pojawić się błąd. Jeśli ustawimy w tym polu na “Tak” to błąd zostanie zignorowany a przesyłka może nie być utworzona. Nie przeszkodzie to jednak w utworzeniu zamówienia;

  • zdecydować czy przesyłki mają być tworzone automatycznie po złożeniu zamówienia (w polu poniżej wówczas wybiera się domyślny gabaryt) czy ręcznie w podglądzie zamówienia w panelu admina;

  • wybrać sposób nadawania przesyłek – jeśli wybrano “Nadanie w paczkomacie” to należy podać numer paczkomatu w polu poniżej;

  • zdecydować czy utworzone przesyłki mają być automatycznie opłacone – przesyłki opłacone posiadają od razu numer śledzenia ale nie da się ich już anulować. Przesyłki nieopłacone należy w podglądzie zamówienia opłacić klikając przycisk “Zapłać”. Płatność jest realizowana w zależności od sposobu rozliczeń z Inpostem;

  • ustawić limit ilości produktów w koszyku dla których wyświetlana będzie opcja wysyłki paczkomatem;

  • zezwolić na ręcznie tworzenie przesyłek – jeśli ustawione na tak to w każdym zamówieniu z wybraną metodą dostawy Paczkomaty będzie widoczny formularz do generowania przesyłek;

  • zdecydować czy status przesyłki widoczny w podglądzie zamówienia w panelu admina ma być odświeżany przy każdym otwarciu strony tego zamówienia – włączenie tej opcji może spowolnić wyświetlenie takiego zamówienia, ale zapewni zawsze aktualny status przesyłki;

  • wybrać format oraz rozmiar etykiety na przesyłkę którą można pobrać w podglądzie zamówienia w panelu admina;

  • użyć innego adresu nadawcy – jeśli ta opcja jest ustawiona na tak pojawią się nowe pola w których należy wypełnić wszystkie dane nadawcy które mają się pojawić na etykiecie przesyłki.

4. Obsługa zamówień od strony panelu administratora

W panelu administratora, wybieramy Sprzedaż → Zamówienia. Po wyborze zamówienia z opcją dostawy do paczkomatów, widzimy w szczegółach wybrany paczkomat.

Możemy zmienić sposób nadania:

  • Nadanie w Paczkomacie;

  • Nadanie w Oddziale;

  • Odbiór przez Kuriera;

  • Nadanie w POP.

oraz rozmiar paczki:

  • Gabaryt A [8 x 38 x 64 cm]

  • Gabaryt B [19 x 38 x 64 cm]

  • Gabaryt C [41 x 38 x 64 cm]

Przygotowanie wysyłki:

Aby przygotować wysyłkę należy sprawdzić poprawność danych (paczkomat, sposób nadania, gabaryt) i kliknąć w przycisk “Utwórz przesyłkę”

Po poprawnym utworzenie otrzymamy okno:

Po utworzeniu wysyłki w systemie InPost możemy zaktualizować jej status, zapłacić oraz anulować przesyłkę.

5. Frontend

Od strony procesu zamówienia paczkomaty dodają dwie metody:

  • Dostawa do paczkomatu;

  • Dostawa do paczkomatu, płatność przy odbiorze;

Po wyborze właściwej metody możemy wybrać paczkomat. Po kliknięciu na “Wybierz paczkomat“ pokaż się mapa:

Na niej możemy wybrać właściwy paczkomat, mapa podpowiada miejsce zamieszkania bazując na podanym w formularzu adresie zamieszkania.

6. Licencja

Postanowienia ogólne:

  • Licencja jasno określa prawa autorskie do modułów, które nie mogą zostać w żaden sposób ograniczone. Licencja stosuje się do każdej wersji oprogramowania;
  • Licencja dotyczy wszystkich plików wchodzących w skład modułu;
  • Jedynym właścicielem skryptu jest jego autor i do niego należą wszystkie prawa autorskie. W przypadku złamania jakiegokolwiek punktu niniejszej licencji osoba łamiąca owe postanowienia traci prawo do użytkowania modułu i ponosi odpowiedzialność karną określoną w przepisach prawa.

Użytkowanie oprogramowania:

  • Moduł można zainstalować na jednej instalacji Magento. Nie ma ograniczenia co do ilości domen;
  • Dopuszczalna jest modyfikacja kodu do swoich potrzeb, z wyjątkiem kodu odpowiedzialnego za kontrolę licencji;
  • Moduł nie może być rozpowszechniany płatnie jak i bezpłatnie w oryginalnej oraz modyfikowanej wersji;
  • Autor modułu nie ponosi odpowiedzialności za straty wynikłe z działania skryptu;
  • Licencja na moduł jest bezterminowa a opłata jednorazowa.

7. Pytania i odpowiedzi

Co to jest ID Organizacji i jak je zdobyć?
Proszę o informację czy Państwa moduł można dostosować do paczkomatów w Epaka
Jak można pobrać zakupiony moduł?
Kiedy będzie dostępna opcja dostawy w weekend?
Jedną z deklarowanych funkcjonalności modułu jest możliwość definiowania kosztów wysyłki w zależności od gabarytów jednak w panelu M2 na demo cennik dla gabarytów można definiować jedynie w sekcjach Poczty Polskiej, natomiast w sekcji: ``SmartMage Paczkomaty2`` brak takiej możliwości. Proszę o wskazanie właściwego miejsca w konfiguracji kosztów w zaleności od gabarytów dla metody Paczkomaty.
Dla której wersji modułu jest przygotowane demo?
Czy moduł Enadawca wchodzi w skład modułu dla Paczkomatów?
Po zainstalowaniu modułu brakuje opcji ``Pokaż mapkę Google``
Czy wymagane jest przekompilowanie/ dodanie tabel dla sklepu, czy moduł powinien działać ``od ręki``?
Czy planujecie dodanie OSM zamiast/obok GMaps w module paczkomatów?
Czy wtyczka obsługuje tez Magento 2.3?
Czy moduł potrafi wyliczać gabaryt paczki z produktów w koszyku tak jak w M1?. Czy można zamówić taką funkcjonalność? Czy moduł pozwala określać różne ceny wysyłki względem gabarytów?
Do czego służy opcja “Przy tworzeniu przesyłki automatycznie ją opłacaj“?
Co to jest ID Organizacji i jak je zdobyć?

ID organizacji oraz Access Token (Klucz API w konfiguracji modułu) to informacje które są potrzebne aby korzystać z API Paczkomatów. Są potrzebne dla modułu w wersji Pro gdzie wykorzystywana jest integracja z systemem Paczkomatów. Aby je uzyskać należy skontaktować się z opiekunem klienta w Inpost.

Proszę o informację czy Państwa moduł można dostosować do paczkomatów w Epaka

Dostosowanie do zewnętrznych rozwiązań zawsze wymaga dodatkowych prac programistycznych i może być zrealizowane jako osobne zlecenie. Nie realizowaliśmy dotychczas integracji z serwisem epaka.pl

Jak można pobrać zakupiony moduł?

Po opłaceniu zamówienia moduł można pobrać z konta klienta pod adresem https://sklep.smartmage.pl/customer/account/ w zakładce “Moje produkty do pobrania“

Kiedy będzie dostępna opcja dostawy w weekend?

Możliwość generowania przesyłek z opcją dostawy w weekend jest w trakcie przygotowania. Będzie dostępna w najbliższych tygodniach.

Jedną z deklarowanych funkcjonalności modułu jest możliwość definiowania kosztów wysyłki w zależności od gabarytów jednak w panelu M2 na demo cennik dla gabarytów można definiować jedynie w sekcjach Poczty Polskiej, natomiast w sekcji: ``SmartMage Paczkomaty2`` brak takiej możliwości. Proszę o wskazanie właściwego miejsca w konfiguracji kosztów w zaleności od gabarytów dla metody Paczkomaty.

W Magento 2 nie wprowadziliśmy możliwości określania gabarytu zamówienia na podstawie wymiarów i wag produktów w koszyku ponieważ ogromna większość klientów nie była w stanie skorzystać z tej możliwości ze względu na konieczność zwymiarowania wszystkich (często tysięcy) swoich produktów. Takie rozwiązanie funkcjonuje w naszym module dla Magento 1, ale z naszych doświadczeń niewielu klientów z tego korzystało. Z tego względu przesyłki jeśli są generowane automatycznie (można to włączyć lub wyłączyć w konfiguracji) to są zawsze w jednym, ustawionym w konfiguracji, gabarycie a cena przesyłki jest zawsze stała. W sytuacji gdy przesyłki nie są generowane automatycznie to w poglądzie zamówienia można wybrać gabaryt i utworzyć przesyłkę.

Dla której wersji modułu jest przygotowane demo?

Demo dostępne pod adresem https://demo-m2.smartmage.pl/ posiada zainstalowaną najnowszą wersję Pro.

Czy moduł Enadawca wchodzi w skład modułu dla Paczkomatów?

Nie, moduły Paczkomatów oraz Enadawcy są osobnymi modułami sprzedawanymi w naszym sklepie.

Po zainstalowaniu modułu brakuje opcji ``Pokaż mapkę Google``

Obecnie moduł w wersji Pro działa na OpenStreetMap które nie wymaga żadnych płatności za korzystanie z mapy. Moduł w wersji Frontend korzysta z Google Maps który wymaga podania klucza API Google Maps. Korzystanie z Google Maps do pewnego limitu zapytań jest darmowe, ale wymaga ustawienia metody płatności (np. karty kredytowej) z której Google pobierze płatność gdy będzie to konieczne.

Czy wymagane jest przekompilowanie/ dodanie tabel dla sklepu, czy moduł powinien działać ``od ręki``?

Moduł należy zainstalować zgodnie z wymaganiami Magento czyli wykonując wszystkie potrzebne komendy w konsoli.

Czy planujecie dodanie OSM zamiast/obok GMaps w module paczkomatów?

Tak, docelowo oba moduły Paczkomatów będą działać na OpenStreetMaps. W chwili obecnej tylko wersja Pro działa z wykorzystaniem tych map, wersja Frontend korzysta z Google Maps.

Czy wtyczka obsługuje tez Magento 2.3?

Tak, moduły Paczkomatów są dostosowane do Magento 2.3

Czy moduł potrafi wyliczać gabaryt paczki z produktów w koszyku tak jak w M1?. Czy można zamówić taką funkcjonalność? Czy moduł pozwala określać różne ceny wysyłki względem gabarytów?

W chwili obecnej w module dla Magento 2 nie ma funkcjonalności automatycznego obliczania gabarytów. Taka funkcjonalność działała w module dla Magento 1 ale była bardzo rzadko używana. Oczywiście na życzenie możemy dopisać taką funkcjonalność jako dodatkowe zlecenie, podobnie jak każdy inny pomysł na rozszerzenie modułu lub dostosowanie do indywidualnych potrzeb Państwa sklepów. Wystarczy wysłać odpowiednie zgłoszenie przez nasz helpdesk: https://sklep.smartmage.pl/helpdesk/

Do czego służy opcja “Przy tworzeniu przesyłki automatycznie ją opłacaj“?

W konfiguracji modułu (Sklepy → Konfiguracja → Ustawienia dostawy → Smartmage Paczkomaty2 – zaawansowane) znajduje się pole pod nazwą “Przy tworzeniu przesyłki automatycznie ją opłacaj”. Jeśli jest ustawione na Tak, wówczas generowane przesyłki będą od razu opłacone (w zależności od sposobu rozliczeń z Inpost albo przez pobranie z konta albo poprzez dopisanie do rozliczenia na koniec okresu rozliczeniowego) i dzięki temu będą posiadały już numer śledzenia. W przeciwnym wypadku konieczne będzie w poglądzie zamówienia kliknięcie przycisku “Zapłać” (w tym momencie nie następuje żadna płatność w panelu admina tylko rozliczenie następuje jak napisano w zdaniu poprzednim). Przesyłki można anulować do momentu gdy są opłacone.

Spodobał Ci się ten moduł? Możesz go kupić w naszym sklepie.

Menu