Dokumentacja modułu Magento 2 – eNadawca

1. Założenia i integracja

Dzięki modułowi Magento 2 – eNadawca obsługa przesyłek pocztowych będzie prosta i szybka.
Moduł umożliwi Ci w łatwy sposób generowanie etykiet adresowych, książek nadawczych i cenników przesyłek.

Proces instalacji modułu nie wymaga ingerencji w skrypt platformy Magento 2, i jego pełna funkcjonalność jest dostępna natychmiast po poprawnej instalacji. Wszystkie ustawienia mają wartości domyślne co będzie pomocne podczas konfiguracji.

2. Instalacja

Do poprawnego działania wtyczki wymagany jest moduł Smartmage Base (zawiera go pakiet instalacyjny).
Pliki moduły wgrywamy do katalogu /app/code.
Następnie w konsoli uruchamiamy następujące komendy:

  • php bin/magento module:enable Smartmage_Base

  • php bin/magento module:enable Smartmage_Enadawca

  • 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 → SmartMage → Enadawca

W sekcji Ustawienia możemy:

  • włączyć moduł;

  • ustawić dane do logowania do systemu eNadawca;

  • ustawić adresy url do połączenia z API eNadawca (produkcyjnego i testowego);

  • włączyć tryb testowy;

  • wybrać urząd nadania przesyłek;

  • włączyć zmianę hasła raz w tygodniu do API eNadawcy;

  • włączyć dodawanie nr zamówienia, płatności i SKU do uwag w zamówieniu;

  • dwie ostatnie opcje zawierają informację o statusie połączenia do API eNadawcy oraz ilość placówek w bazie danych sklepu (możemy wymusić pobranie najnowszej listy placówek i zapisanie jej w lokalnej bazie sklepu);

W sekcji Ustawienia Metod Dostawy możemy:

  • ustawić widoczny licznik paczek (mamy możliwość podzielenia zamówienia na kilka paczek a ten włącznik umożliwia pokazania klientowi na ile paczek będzie podzielone np “Twoje zamówienie będzie podzielone na 5 paczek”

  • ustawić domyślny rozmiar i wagę produktu;

  • ustawić limit paczek; (jest to liczba na którą można podzielić paczki w zamówieniu)

  • ustawić kategorię przesyłki;

  • ustawić termin; (termin jest wykorzystywany do usługi paczkowej: paczka24, paczka48, paczka extra 24)

W sekcji Ustawienia Pobrania możemy:

  • wyłączyć metodę płatności za pobraniem gdy nie dostępna. Opcja ta zadziała gdy najpierw w procesie zamówienia wybieramy metodę dostawy a później metodę płatności;

  • ustawić sposób pobrania. Dostępna jest tylko opcja przelewu na konto bankowe (opłaty za przesyłki pobraniowe);

  • ustawić nr konta bankowego;

W sekcji Ustawienia powiadomień możemy ustawić adres email na który będą przesyłane powiadomienia o błędach systemowych.
W sekcji Ustawienia Logów możemy włączyć logowanie z modułu do pliku w katalogu /var/log. Mamy także podgląd na wielkość logu.
W sekcji Ustawienia Google Maps podajemy klucz do mapy Googla.
W sekcji Ustawienia wyglądu możemy zmienić kolor tła okna mapy oraz labela na liście.
W ostatniej sekcji Pocztex48 możemy wybrać wartość ubezpieczenia paczki. Dostępne opcje to: 1000 zł, 5000 zł, 10000 zł, 20000 zł, 50000 zł.

Konfiguracja metod dostawy znajduje się w Sklepy → Konfiguracja → Metody dostawy


W tej sekcji są dostępne wszystkie metody dostawy zaimplementowane w naszym module.
Każda metoda posiada indywidualne opcje konfiguracji takie jak: włącz/wyłącz, tytuł oraz nazwa, cennik, włączenie darmowej dostawy, konfigurację krajów wysyłki.

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

W panelu administratora, wybieramy Sprzedaż → Zamówienia. Po wyborze zamówienia z opcją dostawy przez Pocztę Polską widzimy w szczegółach wybraną metodę:

 

Przy tworzeniu dostawy możemy zmienić przewoźnika, tytuł oraz dodać numer przesyłki do śledzenia:

Z widoku siatki zamówień możemy przesyłkę dodać do poczekalni w której czekają na wysyłkę całej listy do Poczty Polskiej. W poczekalni paczki muszą być wysłane do PP w tym samym dniu, w którym zostały dodane.

Widok poczekalni:

5. Frontend

W procesie zamówienia są wyświetlane wszystkie dostępne metody dostawy z modułu eNadawca.

Przy wyborze metody Kurier48 do placówek możemy wybrać punkt odbioru na mapie, z listy oraz wyszukiwarki:

6. Pozostałe opcje

Wybierając Smartmage → Placówki mamy podgląd punktów odbioru w naszym sklepie (lista jest zapisana w bazie danych sklepu i musi być okresowo aktualizowana).

7. 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.

8. Pytania i odpowiedzi

Opłata jest roczna czy lifetime?
Czy można generować etykiety nadawcze dla wielu przesyłek na raz?
Czy jest dostępne demo backendu?
Czy można wygenerować i pobrać etykiety np. dla 1000 listów poleconych priorytetowych na raz?
Czy można włączyć/wyłączyć wybrane metody wysyłki PP?
Jak można pobrać zakupiony moduł?
Aby moje opłacone zamówienie trafiło do panelu e-nadawcy muszę utworzyć przesyłke w Magento?
Czy zwrotnie otrzymamy numer przesyłki?
Czy jest możliwość otrzymania np. w pdf lub pod linkiem etykiety do wydruku?
Mam pewien problem złożyłem wczoraj na sklepie zamowienie jednak od wczoraj do panelu e-nadawcy nie wpadło. Próbując pobrać etykietę otrzymuję błąd: Brak wygenerowanego pliku To zamówienie widzę również w panelu w zakładce Smartmage Poczekalnia.
Próbując wysłać listę dostaję błąd: Zamówienia nie istnieją lub nie posiadają stworzonej wysyłki. Co mam zrobić?
Czy jeśli klient złoży zamówienie a nie opłaci go czy taka transakcja wpada do panelu e-nadawcy?
Czy po utworzeniu w e-nadawcy przesyłki jest numer nadania przesyłany do Magento?
Jak mogę wymusi pobranie zamówień z Magento do e-nadawcy?
Czy jest możliwość jakiegoś okresu testowego?
Gdzie mogę pobrać moduł Smartmage Base?
Opłata jest roczna czy lifetime?

Oplata za moduł jest jednorazowa w ramach wersji.

Czy można generować etykiety nadawcze dla wielu przesyłek na raz?

Tak, poprzez masową akcję na gridzie zamówień.

Czy jest dostępne demo backendu?

Tak, demo modułu eNadawca jest dostępne pod adresem https://demo-m2.smartmage.pl/

Czy można wygenerować i pobrać etykiety np. dla 1000 listów poleconych priorytetowych na raz?

Poczta Polska posiada wewnętrzny limit paczek, który wynosi 500 elementów. Zaleca się dodawanie do poczekalni mniejsze paczki by serwer nie ubił naszego procesu poprzez przekroczenie limitu czasu.

Czy można włączyć/wyłączyć wybrane metody wysyłki PP?

Tak, metody dostawy są od siebie niezależne.

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“

Aby moje opłacone zamówienie trafiło do panelu e-nadawcy muszę utworzyć przesyłke w Magento?

Należy dodać zamówienie do poczekalni a następnie wysłać całą listę paczek. Wtedy paczki pojawią się w panelu Poczty Polskiej.

Czy jest możliwość otrzymania np. w pdf lub pod linkiem etykiety do wydruku?

Etykietę paczki pobiera się od razu po dodaniu do poczekalni lub w podglądzie zamówienia.

Próbując wysłać listę dostaję błąd: Zamówienia nie istnieją lub nie posiadają stworzonej wysyłki. Co mam zrobić?

Ten błąd pojawia się, gdy moduł nie potrafi pobrać dostawy lub załadować zamówienia.

Czy jeśli klient złoży zamówienie a nie opłaci go czy taka transakcja wpada do panelu e-nadawcy?

Proces ten nie jest automatyczny, do poczekalni Poczty Polskiej paczki dodajemy ręcznie.

Czy po utworzeniu w e-nadawcy przesyłki jest numer nadania przesyłany do Magento?

Nie mamy takiego powiązania, wszystkie operacje powinny być tworzone poprzez Magento.

Jak mogę wymusi pobranie zamówień z Magento do e-nadawcy?

Paczki można wysłać poprzez przycisk “Wysyłka całej listy”

Czy jest możliwość jakiegoś okresu testowego?

Tak, jest taka możliwość. Prosimy napisać do nas na adres biuro@smartmage.pl podając domenę, przygotujemy 14 dniową wersję testową.

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

Menu