Zaawansowana integracja z Allegro Magento2

Moduł Magento2 - Allegro v1.3.0

Integracja z portalem aukcyjnym Allegro.pl

Changelog

[22-09-2016] Wersja v1.3.0 - Aktualizacja dla Magento 2.1.

[15-08-2016] Wersja v1.2.0 - Aktualizacja.

[15-07-2016] Wersja v1.0.0 - Wydanie modułu.

 
Moduł zgodny z PHP
PHP 5.6, PHP 7

Moduł Allegro – Magento 2 jest kompatybilny z następującymi wersjami oprogramowania:

-2.0
-2.X

W przypadku posiadania innej wersji prosimy o kontakt.

Instalacja

 

Należy wgrać plik licencji „lic-mag-allegro2.txt” do głównego katalogu Magento.

Następnie zawartość katalogu  app/  wgrywamy  do  katalogu  app/  w  Magento po czym w konsoli wywołujemy polecenie php bin/magento setup:upgrade. Wtyczka  wymaga  zainstalowanego  rozszerzenia  PHP  ion cubeloader  dla  poprawnego  działania  wtyczki. Jeżeli Państwa serwer nie posiada takiego rozszerzenia to administracja hostingu powinna  dokonać  bezpłatnej instalacji tego dodatku.

Konfiguracja cron LINUX:

W konsoli po zalogowaniu jako root, należy wpisać crontab –e. To polecenie otworzy nam edytora do cyklicznych zadań cron.

Wpis, jaki musimy wykonać, aby nasz sklep Magento miał uruchomiony cron co minutę:

*/5 * * * * php /lokalziacjasklepu/bin/magento cron:run

Zapisujemy zmiany crontab Ctrl + X [domyślny edytor nano]

*w przypadku posiadania tradycyjnego hostingu www o pomoc w konfiguracji cron zapytaj administratora serwera.

Konfiguracja

 

Z menu Narzędzia wybieramy Allegro a następnie Konfiguracja.

1.jpg
W pierwszym panelu mamy wybór czy synchronizować zamówienia oraz którego sklepu Magento zamówienia będą wpadały. Kolejne 3 opcje określają statusy:

  • status z jakim zamówienie zostanie dodane do sklepu,
  • status zamówienia dla płatności przy odbiorze,
  • status zamówienia po opłaceniu przez PayU.

W następnym polu ustawiamy obsługę transakcji anulowanych przez kupującego na allegro „Obsługa anulowania transakcji/zamówienia”

Kolejne pole to opcja wyboru wysłania email do klienta z potwierdzeniem utworzenia zamówienia „Wysyłaj email z potwierdzeniem utworzenia zamówienia”

W kolejnej opcji można ustalić czy tworzyć nowe konta każdemu klientowi kupującemu z Allegro (w przypadku jeżeli klient allegro znajduje się już w bazie używamy jego konta), czy też dodawać zamówienia bez tworzenia konta (jako konto gość) oraz do którego sklepu dodać użytkownika.

2.jpg

Następna opcja pozwala na usunięcie aukcji jeśli liczba przedmiotów na magazynie spadnie poniżej podanej wartości.

Kolejna opcja „Zmniejszaj liczbę przedmiotów na aukcji” powoduje zmniejszenie liczby przedmiotów na aukcji, jeśli jest ona większa od liczby przedmiotów w magazynie.

Następną opcją jest wybór sklepu z którego będziemy wystawiać przedmioty.

Opcja „Ilość przedmiotów jest wartością maksymalną” powoduje, że jeśli liczba przedmiotów w wystawianej aukcji będzie większa od liczby przedmiotów w magazynie to aukcja wystawi się z liczbą przedmiotów równą liczbie przedmiotów w magazynie. Ostatnimi opcjami w tej zakładce są opcje logów, możemy ustawić czy logować błędy i gdzie będą zapisywane.

Używaj zdjęć produktów konfigurowalnych – Pozwala na wstawienia zdjęć miniatur produktów konfigurowalnych oraz prostych.

 


 

W zakładce „Lokalizacja” ustawiamy dane lokalizacyjne takie jak województwo, kod pocztowy, oraz miasto.

3.jpg

 


Zakładka „Ustawienia allegro” zawiera opcje dotyczące allegro, podajemy tutaj login i hasło do allegro, oraz klucz WebApi. Możemy także wybrać tryb testowy, aby przetestować aukcję w serwisie webapi.pl  (wersja testowa serwisu allegro nie obsługuje tworzenia zamówień).

4.jpg

Można także skorzystać z obsługi wielu kont po wybraniu opcji „Korzystaj z wielu kont”, domyślnym kontem jest wtedy to, które jest ustawione w zakładce „Ustawienia allegro”.

W przypadku wybrania opcji „Korzystaj z wielu kont” wyświetlona zostaje lista skonfigurowanych kont

(pomijając  konto domyślne):

5.jpg

W tym miejscu można wyszukiwać konta po ID, Loginie lub kluczu WebApi, a także dodać nowe konto poprzez przycisk „Dodaj konto” który przeniesie nas do odpowiedniego formularza:

 

6.jpg

Opcja indywidualnej lokalizacji dla dodatkowego konta

7.jpg

Ustawianie znaku wodnego dla zdjęć w wystawionych aukcjach Allegro.

8.jpg

 

W panelu „Komentarze” podajemy treść pozytywnego komentarza, wystawianego z sekcji komentarzy.

9.jpg

Ustawienia kwot dostaw, tutaj należy podać co najmniej jedną kwotę.

10.jpg

 

Zadania automatyczne cron.
Dzięki tej opcji można ustawić co jaki czas skrypt ma wykonywać włączone funkcje:

11.jpg

Definicje aukcji.

Z menu Narzędzia wybieramy Allegro, a następnie Definicje aukcji.

W tabeli mamy możliwość edycji  i podglądu definicji aukcji.  Link „Synchronizuj zmiany” aktualizuje zmiany wprowadzone w definicji w aukcjach powiązane z tą definicją, natomiast link „Wystaw powiązane aukcje” wystawia na Allegro aukcje które są niewystawione, a korzystają z danej definicji.

12.jpg

Po kliknięciu przycisku dodaj definicję pojawi się formularz dodawania nowej definicji aukcji.  Przy podawaniu cen można używać wyrażeń matematycznych np. {{product.price}} * 0.5. Dozwolone operacje to dodawanie, odejmowanie i mnożenie.
Aby wystawić aukcje:
- „kup teraz” wpisujemy wartość w pole „Cena produktu”,
-aukcja wywoławcza – licytacja / wieloprzedmiotowa wpisujemy wartość w pole „Cena wywoławcza”,
-aukcja z opcją kup teraz wpisujemy wartość we wszystkie pola.

13.jpg

Formularz ustawień modułu pojawia się po wybraniu ustawienia modułu z lewego menu. Po ustawieniu pola „Synchronizuj z definicją aukcji” na wartość „tak”, wszystkie aukcje utworzone na podstawie danej definicji aukcji  zminiają się wraz ze zmianą szablonu aukcji.

Ustawienie pola „Wystawiaj ponownie po zakończeniu aukcji”  na wartość „tak” powoduje automatyczne wznawianie aukcji utworzonej przy użyciu danej definicji, ale również sprawia, że takie, niewystawione aukcje  będą automatycznie wystawiane w ciągu 5min od momentu ich utworzenia.

14.jpg

Szablony aukcji.

Wybierając opcję Szablony aukcji z menu Narzędzia -> Allegro tworzymy wygląd naszej aukcji.

Po kliknięciu przycisku dodaj szablon pojawi nam się okno z możliwością uzupełnienia szablonu aukcji.

15.jpg

Podgląd aukcji.

Po wybraniu Narzędzia -> Allegro -> Podgląd aukcji widzimy wszystkie wystawione aukcje na  kontach podanych w konfiguracji.

16.jpg

Poza możliwością zobaczenia wystawionych aukcji można tutaj również zakończyć aukcji, lub zakończyć aukcji i jednoczesnego wycofać wszystkie oferty. Po wybraniu opcji zakończenia aukcji z wycofaniem ofert należy podać powód odwołania oferty.

17.jpg

Wystawianie aukcji

 

Gdy już uzupełnimy szablon, możemy przejść do wystawiania aukcji wybierając  opcję Wystawiania aukcji z menu Narzędzia -> Allegro.

Jeżeli będzie to nasza pierwsza aukcja należy zaktualizować kategorie allegro używając przycisku Aktualizuj kategorię, aktualizacja odbywa się za pomocą crona, dlatego należy odczekać parę minut po kliknięciu przycisku oraz sprawdzić czy na serwerze jest dostępna i dobrze skonfigurowana usługa crona. Następnie możemy przejść do dodawania aukcji.

18.jpg

Musimy uzupełnić opcje aukcji, takie jak tytuł, cena, ilość przedmiotów. Przy podawaniu cen można używać wyrażeń matematycznych np. {{product.price}} * 0.5. Dozwolone operacje to dodawanie, odejmowanie i mnożenie.

Następnie wybieramy wcześniej utworzony szablon, oraz dodatkowe opcje aukcji takie jak miniaturka, czy pogrubienie.

Zaznaczamy formy płatności oraz sposób dostawy i przechodzimy do zakładki Dodatkowe opcje odstawy.

 

19.jpg

Możemy zdecydować czy chcemy korzystać z globalnych opcji dostawy (dostępne w konfiguracji) czy ze zdefiniowanych specjalnie dla wybranej aukcji.

Jeżeli zdecydujemy się skorzystać z indywidualnych ustawień, należy wypełnić po 3 pola dla każdej przesyłki (cena pierwszej sztuki, kolejnej sztuki, oraz ilość w paczce).

W przypadku korzystania z wielu kont poniżej zakładki „Podstawowe informacje” pojawi się dodatkowa zakładka „Wybierz konta”:

20.jpg

Można wybrać jedno konto (wtedy aukcja zostanie dodana z zaznaczonego konta), wiele kont (wtedy aukcja zostanie dodana dla każdego z wybranych kont), lub nie wybrać żadnego konta (w tym wypadku zostanie użyte konto domyślne).

Następnie możemy przejść do wyboru kategorii.

21.jpg

 

Wybieramy kategorie z listy i przechodzimy do zakładki produkt.

22.jpg

W kolejny etapie wybieramy produkt, który zostanie wystawiony na aukcji.

23.jpg

Na koniec ustawiamy atrybuty produktu (jeżeli takie posiada) i klikamy Zapisz aukcję.

Jeżeli wszystko zostało uzupełnione prawidłowo pojawi nam się komunikat o poprawności zapisania aukcji.

24.jpg

Gdy już dodamy aukcje, możemy je wystawić w każdej chwili jednym kliknięciem, wybierając z listy Wystaw teraz.

Podgląd aukcji

 

Podgląd wystawionych aukcji jest dostępny po wybraniu opcji Podgląd aukcji z menu Narzędzia -> Allegro.

16.jpg

FAQ

 

Q: Jak zwiększyć cenę produktu o 10%?

A: Wystarczy w cenie produktu wpisać: {{var product.price}} * 1.1 lub w przypadku obliczania z ceny special price {{product.price}} * 1.10

 

Q: Otrzymuję komunikat błędu o braku opisu (ERR_DESCRIPTION_NOT_FOUND)

A: Jeżeli szablon jest wypełniony to najprawdopodobniej zawiera niedozwolone tagi lub skrypty.

Q: Nie mogę wystawić aukcji na 30 dni.

A: Aby wystawić na 30 dni należy w konfiguracji moduły zaznaczyć opcję Wystawiaj jako sklep. Dodatkowo na 30dni mogą być wystawione tylko aukcje "Kup Teraz", więc nie można podać kwoty minimalnej i startowej.

Q: Aukcja została wystawiona, ale opis / zdjęcia się nie przeniosły.

A: Najprawdopodobniej szablon zawiera błędy. Przed wystawieniem aukcji należy sprawdzić poprawność konfiguracji klikając na "Podgląd".

 

Q: Zamówienie zostało kilkakrotnie anulowane i utworzone, co się stało?

A: Jeżeli w konfiguracji włączona jest opcja anulowania zamówień, może się zdarzyć, że przy błędzie płatności zamówienie zostanie anulowane, po czy utworzone zostanie nowe. Allegro w taki sposób zarządza płatnościami. Można wyłączyć tą opcję w konfiguracji, wtedy zamówienie nie będzie anulowane, nawet jeżeli nie zostanie nigdy opłacone.

 

Q: Moduł nie pobiera ceny specjalnej do aukcji

A: Jeżeli użyjemy tagu: {{product.price}} zostanie pobrana cena produktu, tak jak pobiera ją magento, czyli w przypadku ustawienia ceny specjalnej pobierze się cena specjalna, natomiast tag {{var product.price}} rzeczywiście nie uwzględnia tej ceny, pobiara "suchą" wartość z atrybutu.

 

Q: Nie przychodzą zamówienia / nie aktualizują się kategorie.

A: Należy się upewnić czy cronmagento jest uruchomiony, oraz czy jest on uruchamiany z IonCube. Często hostingi uruchamiają skrypty php w konsoli z użyciem innego pliku konfiguracyjnego, czasami bez włączonego IonCube.

 

Q: Zamówienia przychodzą z opóźnieniem.

A: Zamówienie w Magento pojawia się dopiero po wypełnieniu formularza pozakupowego przez kupującego.  Jeżeli przedmiot został zakupiony, ale nie został wypełniony formularz, zamówienie nie zostanie utworzone.

 

Q: Cron działa prawidłowo, ale nadal nie dochodzą zamówienia.

A: Należy sprawdzić plik ./var/log/system.log czy nie wystąpił błąd podczas tworzenia zamówienia. Błąd może być spowodowany np. brakiem przedmiotu na magazynie.

 

Q: Zamówienia nie są tworzone z powodu błędu w adresie.

A: Moduł uzupełnia dane adresowe, takie jakie są niezbędne w czystym Magento. Jeżeli Państwa system ma inne wymagania co do adresu (np. dodatkowe wymagane pola), można nadpisać klasę mapującą adresy allegor - magento, czyli: Websoft_Allegro_Model_Plugins_Address.

Q: Pojawia się błąd: ERR_INVALID_VALUE_IN_ATTRIB_FIELD: Incorrectlyspecifiedstructureparameters (e.g. a non-existent sale form field hasbeenpassed) - fid: 340

A: Testowe APIAllegro nie obsługuje pola "Wysyłka w ciągu", należy wybrać pozycję "wybierz" jeżeli korzystamy z testowego API

W przypadku innych problemów prosimy o kontakt, oraz, w miarę możliwości podanie dostępu do logów, oraz do katalogu modułu na FTP.

Q:  Przypomnienie użytkownikowi o transakcji, jak to działa?

A: "Metoda pozwala na wysłanie przypomnień o zawarciu transakcji (wypełniać je można nie wcześniej niż 3 dni i nie później niż 30 dni od dnia zakończenia sprzedaży), do kupujących którzy dokonali zakupu w ofertach zalogowanego użytkownika."

Czyli można wysłać formularz dopiero w niedziele / poniedziałek. Choć błąd tutaj jest mylący (zwrócony przez allegro).

Changelog

 

Wersja 1.0.0
- Pierwsza wersja modułu

  • Web-Soft, ul. Gosławicka 2/216,
    45-446 Opole
  • +48 667 700 732
  • +48 775 466 174
  • This email address is being protected from spambots. You need JavaScript enabled to view it.

WYŚLIJ WIADOMOŚĆ

  Nie wysłano.   Wiadomość wysłana
Top
Ta strona używa ciasteczek. Dowiedz się więcej o celu ich używania i możliwości zmiany ustawień w przeglądarce. Czytaj więcej. Akceptuję cookies z tej strony. Akceptuję