Zaawansowana integracja z Allegro

Moduł Magento - Allegro v3.129.3

Integracja z portalem aukcyjnym Allegro.pl

Changelog

[28-07-2016] Wersja v3.129.3 - Optymalizacja modułu.
- Zmiana miniaturki na aukcji po zmianie miniaturki allegro w produkcie.

[27-10-2016] Wersja v3.128.3 - Integracja z e-opisy.pl.
- Dodanie opcji edytowania ceny podczas trwania aukcji z listy podgląd aukcji.
- Dodanie opcji edytowania ilości na aukcji podczas trwania z listy podgląd aukcji.
- Dodanie opcji wykonywania działań matematycznych podczas tworzenia aukcji.
- Dodanie opcji aktualizuj cenę na aukcji.
- Ogólne poprawki.

[05-08-2016] Wersja v3.127.3 - Dodanie możliwości wpisania szerokości obrazków w bloku obrazków.
- Dodanie powiadomienia o błędnej wpisanej kwocie (kup teraz, minimalna, wywoławcza)
- Wybieranie "kup teraz" wtedy blokują się pola do wpisania ceny minimalnej oraz wywoławczej.

 
Moduł zgodny z PHP
PHP 5.2 - PHP 5.3 - PHP 5.4

Spis treści

 

Zgodny z Magento. 3

Moduł nie współpracuje. 3

Instalacja. 3

Problem z instalacją. 5

Konfiguracja cron LINUX: 6

Konfiguracja cron WINDOWS: 6

Konfiguracja. 7

Definicje aukcji. 18

Szablony aukcji. 21

Podgląd aukcji. 24

Lista zamówień. 25

Lista zamówień - Przypomnienia. 26

Wystawianie aukcji 27

Zwrot prowizji 34

PayU.. 36

Zamówienia. 37

Mapowanie kategorii allegro. 38

Mapowanie atrybutów allegro. 39

Zdarzenia (events). 41

Integracja z e-opisy. 41

FAQ.. 42

Changelog. 45

 


 

Zgodny z Magento

 

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

-1.5.1.0
-1.6.0.0
-1.6.1.0
-1.6.2.0
-1.7.0.0
-1.7.0.1
-1.7.0.2
-1.8.0.0
-1.9.0.0
-1.9.0.1
-1.9.X.X

W przypadku posiadania innej wersji prosimy o kontakt.
Współpracuje z PHP 5.2 - PHP 5.3 - PHP 5.4 - PHP 5.5 - PHP 5.6

Moduł nie współpracuje

- Moduł Store View Pricing, moduł uniemożliwia dostęp do funkcji wystawiania aukcji allegro.
                Celem naprawy należy odinstalować modułu Store View Pricing i ponownie zapisać konfiguracje allegro.
- Z systemami o architekturze 32 bitowej.

Instalacja

 

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

            Następnie, aby zainstalować moduł allegro, należy zalogować się do panelu administracyjnego sklepu i przejść do zakładki System następnie Magento Connect i wybrać Magento Connect Manager

            Po przejściu do zakładki Magento Connect Manager ukaże nam się formularz logowania, należy wpisać dane administratora i nacisnąć login.

            Po zalogowaniu do Magento Connect Manager możemy zarządzać zainstalowanymi dodatkami tj. dokonywać reinstalacji oraz instalacji nowych dodatków.

 

Instalacja modułu Allegro należy wykonać następującymi krokami:

1 –W zakładce „Direct package file upload” wybrać paczkę z modułem, klikamy obok [2] na [wybierz plik]

1-1

1-2

2 – Po wybraniu odpowiedniej paczki z modułem naciskamy upload

O powodzeniu instalacji powiadomi nas komunikat w konsoli

            Aby dodatek mógł automatycznie sprawdzać stan zamówień z allegro należy ustawić automatyczne uruchamianie skryptu cron.php z głównego katalogu Magento.

Problem z instalacją

            W przypadku, gdy licencja modułu nie posiada wpisanych wszystkich adresów sklepu to może wystąpić problem i moduł się wyłączy tuż po instalacji lub nie zostanie zainstalowany. Jeżeli taka sytuacja nastąpi należy skontaktować się z dostawcą licencji.
            Jeśli w licencji są wpisane wszystkie adresy sklepu należy sprawdzić czy nasz serwer posiada ioncubeloader, jeżeli nie to należy poprosić administratora serwera o zainstalowanie ioncubeloader.
            Po otrzymaniu poprawnej licencji lub po zainstalowaniu ioncubeloader należy wejść w katalog: app/etc/modules odszukać plik .xml od instalowanego modułu w go zedytować zmieniając false na true.

           

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ę:

*/1 * * * * /usr/bin/wget  -q -O /dev/null http://adressklepuwww.pl/cron.php

            Zapisujemy zmiany crontab Ctrl + X [domyślny edytor nano]
*w przypadku posiadania tradycyjnego hostingu www o pomoc w konfiguracji cron zapytaj administratora serwera.

Konfiguracja cron WINDOWS:

            Dla systemu Windows należy utworzyć plik wsadowy, który będzie uruchamiany z harmonogramu zadań Windows.

            Zawartość pliku wsadowego:
start C:\php\php.exe C:\crons\mycron.php

            Plik zapisujemy jako cronmagento.bat

start C:\php\php.exe <- podajemy lokalizacje php
c:\crons\mycron.php <- podajemy lokalizację pliku cron z katalogu magento

            Zadanie cykliczne ustawiamy w harmonogramie zadań Windows wskazując na uruchamianie pliku bat co minutę.
*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.

konfiguracja.jpg
            W pierwszym panelu mamy wybór, czy synchronizować zamówienia oraz do którego sklepu Magento zamówienia będą pobierane. 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.

            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.

magento.jpg

            Działanie matematyczne na cenie produktu

            np. *1,23 lub -10 wtedy nasza cena będzie przerobiona przez działanie matematyczne i nowa cena będzie zapisana dla aukcji allegro. UWAGA: Jeżeli aukcja zakończy się ze starą ceną a zmienimy działanie matematyczne w trakcie jej trwania to aukcja wystawi się z nową ceną przy ponownym wystawieniu.
Zakładka „Aukcje wystawione poza Magento” udostępnia następujące opcje:

Jeżeli zostanie skonfigurowana opcja pobierania aukcji poza Magento, moduł będzie dodawał aukcje wystawione w allegro, ale tylko wtedy, gdy odpowiedni produkt wg SKU zostanie odnaleziony w Magento. Kolejna opcja decyduje o tym, czy w przypadku, gdy produkt nie zostanie odnaleziony w Magento, aukcja ma zostać zignorowana (nie dodana do podglądu aukcji modułu), czy też produkt ma zostać dodany do bazy produktów Magento, a następnie również aukcja. Jeżeli produkt ma być dodany, możemy ustawić dodatkowe atrybuty dla produktu w postaci <div id=”nazwa_atrybutu”>wartość_atrybutu</div>.

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


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

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):

 

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:

 

Opcja indywidualnej lokalizacji dla dodatkowego konta

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

znakwodny.jpg

 

Po wpisaniu numeru konta bankowego zostanie one dodane do wystawionej aukcji na Allegro.

 

 

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

W kolejnym panelu można podać dodatkowe atrybuty produktu, które będą widoczne na liście podglądu aukcji lub liście wystawiania aukcji. Atrybuty należy podawać po przecinku.

 

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

Można sparować sposoby dostawy Allegro z tymi w modułach Magento.

mapowaniewysylkiallegrodomagento.jpg

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

Dodatkowe kolumny na listach:

dodatkowekolumnynalistach.jpg

Zaznaczamy jakie dodatkowe kolumny mają pojawić się na danej liście.

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.

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.

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

 

            W celu utworzenia aukcji na podstawie jej definicji należy wybrać z menu Catalog, a następnie Manage Products.

         Po zaznaczeniu produktów wybieramy akcję: Ustaw aukcję allegro, szablon aukcji. Przycisk Submit tworzy gotową do wystawienia aukcję na podstawie wybranych produktów i przenosi do okna umożliwiającego ich wystawienie.

 

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.

 

W szablonie możemy używać znaczników takich jak:

{{var product.allegro_price}}– (przykładowy atrybut cena allegro) - można wyświetlić każdy inny atrybut dodany do danego produktu, który będzie wystawiony na allegro.

{{var product.name}} – Wyświetla nazwę produktu.

{{var product.dropdownvalue('size')}} – Wyświetla rozmiar produktu.

{{varproduct.description}} lub {{var product.nl2br(‘description’)}} – wyświetla długi opis produktu, znacznik zawierający nl2br wyświetla opis używając konwersji znaków linii do html-owego<br>. Jeżeli chcemy wkleić opis z podziałem linii trzeba użyć wersji nl2br.

{{varproduct.short_description}} lub {{var product.nl2br(‘short_description’)}} – wyświetla krótki opis produktu.

<img src=”{{varproduct.image(numer_obrazka_zaczynając_od_zera)}}”> - wyświetlanie obrazków.

{{dependproduct.image(0)}}<div> Obrazek nr 1: <img src=”{{varproduct.image(0)}}”></div>{{/depend}} - wyświetlanie warunkowe obrazków (jeżeli nie ma obrazka wartość pomiędzy tagami depend zostanie pominięta).

Aby dodać kilka obrazków z wymuszonym rozmiarem wpisujemy w szablonie aukcji (przykład):

{{depend product.image(0)}}<div> Obrazek nr 1: <img height="400" src="{{var product.image(0)}} "></div>{{/depend}}
{{depend product.image(0)}}<div> Obrazek nr 2: <img height="400" src="{{var product.image(1)}} "></div>{{/depend}}
{{depend product.image(0)}}<div> Obrazek nr 3: <img height="400" src="{{var product.image(2)}} "></div>{{/depend}}
{{depend product.image(0)}}<div> Obrazek nr 4: <img height="400" src="{{var product.image(3)}} "></div>{{/depend}}

 

Dodatkowa funkcja imageByName i imageWithoutName

imageByName:

Sposób użycia:

{{depend product.imageByName('cala_rodzina')}}<div>Obrazek nr 1: <img src="{{var product.imageByName('cala_rodzina')}}"></div>{{/depend}}

Wyświetli pierwszy obrazek który ma w nazwie 'cala_rodzina'.

imageWithoutName:

            Działa jak zwykły image, ale dodatkowo pomija po nazwie,  żeby na przykład można było zrobić galerię obrazków bez obrazka cała rodzina:

Sposób użycia:

{{depend product.imageWithoutName(0,'cala_rodzina')}}<div>Obrazek nr 1: <img src="{{var product.imageWithoutName(0,'cala_rodzina')}}"></div>{{/depend}}

{{depend product.imageWithoutName(1,'cala_rodzina')}}<div>Obrazek nr 1: <img src="{{var product.imageWithoutName(1,'cala_rodzina')}}"></div>{{/depend}}

{{depend product.imageWithoutName(2,'cala_rodzina')}}<div>Obrazek nr 1: <img src="{{var product.imageWithoutName(2,'cala_rodzina')}}"></div>{{/depend}}

 

{{block type='allegro/media' template='websoft/allegro/media.phtml' product=$product }} – blok galerii.

Możemy powiększyć obrazki wyświetlane w bloku dopisując wymiar: {{block type='ws_allegro/media' template='websoft/allegro/media.phtml' product=$product imageWidth=400}} domyślnie jest 100

{{block type='allegro/attributes' template='websoft/allegro/attributes.phtml' product=$product }} – blok tabeli atrybutów.

baseImage:
            Możemy użyć zdjęcia jako miniaturki dla wszystkich produktów oraz wstawić zdjęcie do szablonu aukcji w dowolnym miejscu: <img src="{{var product.baseImage()}}">
Opcja działa również dla thumbnail, i smallImage.

Podgląd aukcji.

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

            Poza możliwością zobaczenia wystawionych aukcji można tutaj również zakończyć aukcje 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.

 

Edycja wystawionych ilości na aukcjach:


Edycja ceny na aukcji - po edycji ceny nie zmieni się ona, jeżeli w sklepie zmienimy cenę produktu.

Opcja jest powiązana z funkcją w konfiguracji modułu


Lista zamówień

            Lista zamówień Allegro dostępna jest po wybraniu z menu Narzędzia -> Allegro -> Lista zamówień. Można tutaj ręcznie tworzyć nowe zamówienia jeśli z jakiś powodów nie zostały one utworzone automatycznie.

         Link - „Utwórz zamówienie (debug)” otwiera okno umożliwia śledzenie procesu tworzenia zamówienia i wyświetla ewentualne błędy:

 

Lista zamówień - Przypomnienia

         Czasami zdarzy się tak, że klient po złożonym zamówieniu nie dokończy transakcji. W tym celu zostały dodane przypomnienia wysyłane do klientów.

         W polach ustawiamy ilość dni, po jakich ma zostać wysłany stosowny komunikat do naszego klienta, a w konsekwencji złożony wniosek o zwrot prowizji.

 

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.

            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.

 

 

            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”:

 

         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.


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

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

            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.

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

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


            Wystawianie komentarzy

            Korzystając z opcji komentarze możemy wystawić kontrahentom komentarz na allegro.

         Pojawi nam się lista transakcji, do których możemy wystawić komentarz. W przypadku gdy korzystamy z wielu kont, w prawym górnym rogu możemy wybrać, dla którego konta chcemy wystawić komentarz.

            Możemy wystawić komentarz pozytywny bez podawania treści, lub kliknąć na Wystaw, aby otrzymać formularz do wypełnienia. Możemy także przejść do zamówienia którego dotyczy transakcja.

            Komentarz możemy również wystawić z zakładki Allegro znajdującej się w widoku zamówienia (widoczna tylko, jeżeli zamówienie zostało utworzone przez moduł).

 

Zwrot prowizji

         Korzystając z opcji Zwrot prowizji, możemy zarządzać zwrotami prowizji, oraz wysyłać przypomnienia. Gdy korzystamy z wielu kont po prawej górnej stronie pojawi się możliwość wybrania konta z którego korzystamy.

Z wyświetlonej listy transakcji możemy przejść do zamówienia którego dotyczy.


Możemy wysłać przypomnienie o zawarciu transakcji.

 

A także prośbę o zwrot prowizji.

            Akcje te można również wykonać w widoku zamówienia, w dodatkowej zakładce Allegro. (widoczna tylko, jeżeli zamówienie zostało utworzone przez moduł).

PayU

            Korzystając z opcji PayU możemy sprawdzić stan naszego konta (w przypadku korzystania z wielu kont pojawi się opcja wyboru konta).

            Widoczne są informację na temat stanu konta, oraz informacje właściciela.

            Korzystając z opcji Zleć wypłatę środków na konto, możemy  wypłacić środki zgromadzone na koncie PayU na rachunek bankowy zdefiniowany w ustawieniach Allegro.

            W zamówieniach stworzonych przez moduł pojawia się również dodatkowa opcja przy fakturze Prośba o dopłatę.

            Po jej wybraniu pojawi nam się formularz do wypełnienia.

            Podajemy w nim treść wiadomości, oraz kwotę jaka ma zostać dopłacona.

Zamówienia

         W szczegółach zamówienia (Sales ->Orders -> wiersz z zamówieniem) dokonanego za pośrednictwem Allegro możemy znaleźć dodatkowe informacje pochodzące z portalu. Panel „Payment Information” dodatkowo zawiera wybraną metodę płatności i informację o tym czy ma być wystawiona faktura.

            Z kolei w panelu „Shipping& Handling Information”  znajduje się wybrany sposób dostawy:

 

            Informacja o loginie allegro sprzedającego widoczne w zamówieniu:

Mapowanie kategorii allegro

            Funkcja dostępna z menu modułu allegro.

            Jak dodać mapowanie kategorii?

            Po wejściu w Allegro > Mapowanie kategorii należy nacisnąć:

następnie zobaczymy dwie kolumny „Wybór kategorii Allegro” i „Wybór kategorii Magento”

            Po odpowiednim ustawieniu mapowania możemy zapisać mapowanie lub zapisać i edytować.

 

            Dzięki tej funkcji możemy ustawić kategorię allegro dla kategorii sklepu z których wystawiamy aukcje.


Jeżeli produkt jest w kilku zmapowanych kategoriach to podczas tworzenia aukcji moduł zada nam pytanie gdzie wystawić dany przedmiot.

 

Mapowanie atrybutów allegro

                Funkcja dostępna w menu modułu allegro.

                Narzędzia -> Allegro -> Mapowanie atrybutów

                Po wejściu w tą funkcję zobaczymy listę naszych mapowań.

                Aby dodać nowe mapowanie należy kliknąć przycisk "Dodaj mapowanie". Podczas tej procedury pokaże nam się formularz z wyborem kategorii allegro - do kategorii allegro są przypisane odpowiednie atrybuty.

               

         Jak widać na przykładzie po wybraniu "Dom i Ogród", "Wyposażenie", "Ręczniki", "Pozostałe" pokaże nam się dodatkowa belka (Atrybuty kategorii) i w tym miejscu mapujemy kategorię allegro do kategorii sklepu.

               

         Mamy zmapowany kolor biały do koloru białego w sklepie. Możemy zmapować pozostałe atrybuty dzięki plusikowi w sekcji (Atrybuty kategorii). Gdy mamy już dodane mapowania nie musimy tych opcji wybierać podczas tworzenia aukcji do wystawienia, gdyż same się nam zaznaczą.

Zdarzenia (events)

            Moduł wywołuje następujące zdarzenia (w nawiasie obiekty przekazane do zdarzenia):

·         ws_allegro_set_billing_address (allegro_customer_data, soap_response, billing_address) - wywołany przed dodaniem adresu do zamówienia,

·         ws_allegro_set_shipping_address (allegro_customer_data,soap_response, shipping_address) - wywołany przed dodaniem adresu do zamówienia,

·         ws_allegro_submit_order_before (allegro_customer_data,quote service) - wywołany przed utworzeniem zamówienia,

·         ws_allegro_submit_order_after (allegro_customer_data, order) - wywołany po udanym utworzeniu zamówienia,

·         ws_allegro_submit_order_error (allegro_customer_data,exception, soap_response,  quote,  service) - wywołany w przypadku wystąpienia błędu przy tworzeniu zamówienia .

Gdzie:

·         allegro_customer_data - dodatkowy obiekt w evencie, zawiera pełne dane kupującego

·         soap_response  - dane transakcji allegro

·         shipping_address – adres dostawy magento

·         blilling_address – adres bilingowy magento

Aby utworzyć zamówienie z evant'a, po błędzie należy wykonać $service->submitOrder(); Przy pomocy zdarzeń możemy zmodyfikować adresy przy dodawaniu zamówienia i w razie potrzeby zmodyfikować zamówienie.

 

Integracja z e-opisy

                Połączenie z api e-opisy pozwala na automatyczne pobranie szablonu html dla tworzonej aukcji na allegro.

                Dane do konfiguracji e-opisy należy wprowadzić w ustawieniach modułu allegro w dolnej sekcji.

                Integracja może być włączona lub wyłączona a dodatkowo możemy wybrać atrybut z którego pobieramy ID dla e-opisy dzięki czemu aplikacja wie, który szablon pobrać w danym momencie.

                Pobieranie szablonu działa tylko podczas tworzenia aukcji na podstawie definicji aukcji z listy produktów magento.

FAQ

 

Q: Jak wyciąć atrybut z bloku atrybutów?

A: Dodajemy do wpisu z blokiem exclude="cecha1,cecha2" przykład: {{block type='ws_allegro/attributes' template='websoft/allegro/attributes.phtml' product=$product exclude="cecha1,cecha2"}}

Q: Jak usuwać linki z szablonu aukcji?

A: {{var product.stripTags('description')}} - wyświetla opis z wyciętymi linkami

{{var product.stripTags('description')|nl2br}} - wyświetla opis z wyciętymi linkami i zamienia nowe linie na br'y

{{var product.stripTags('description','a,strong')|nl2br}} - wyświetla opis z wyciętymi linkami i tagami strong

Jakie tagi ma wycinać podajemy w drugim parametrze, jak nie podamy to wycina tylko linki.

Jeżeli w innych atrybutach ma być coś wycięte to na tej samej zasadzie trzeba zrobić:

{{var product.stripTags('jakis_dodatkowy_atrybut')}}

 

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, pobiera "suchą" wartość z atrybutu.

 

Q: Moduł zniknął z menu, nie widać go w Magento.

A: Prawdopodobnie wystąpił problem z IonCube i moduł został wyłączony, aby nie blokować Magento. Można włączyć moduł ponownie zmieniając flagę active na true w pliku ./app/etc/modules/Websoft_Allegro.xml, w sekcji error tego pliku można sprawdzić co spowodowało problem.

 

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

A: Należy się upewnić czy cron magento 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: Który obrazek jest ustawiany jako miniaturka.

A: Jest to główny obrazek produktu, oznaczony w magento jako "Base image"

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

Q: Czy wstawią się tagi wpisane w produkt ?

A: Tak wystarczy wstawić taki takie jak w szablonie allegro.

 

Changelog


Wersja v3.129.3
- Optymalizacja modułu.
- Zmiana miniaturki na aukcji po zmianie miniaturki allegro w produkcie.

Wersja v3.128.3
- Integracja z e-opisy.pl.
- Dodanie opcji edytowania ceny podczas trwania aukcji z listy podgląd aukcji.
- Dodanie opcji edytowania ilości na aukcji podczas trwania z listy podgląd aukcji.
- Dodanie opcji wykonywania działań matematycznych podczas tworzenia aukcji - dotyczy każdej tworzonej aukcji.
- Dodanie opcji aktualizuj cenę na aukcji.
- Ogólne poprawki.

Wersja v3.127.3
- Dodanie możliwości wpisania szerokości obrazków w bloku obrazków.
- Dodanie powiadomienia o błędnej wpisanej kwocie (kup teraz, minimalna, wywoławcza)
- Wybieranie "kup teraz" wtedy blokują się pola do wpisania ceny minimalnej oraz wywoławczej.

Wersja v3.126.3
- Aktualizacja modułu

Wersja v3.125.3
- Aktualizacja modułu
- Możliwość edycji ilości na aukcji z listy podgląd aukcji

Wersja v3.124.3
- Aktualizacja modułu

Wersja v3.123.3
- Aktualizacja modułu

Wersja v3.122.3
- Aktualizacja modułu

Wersja v3.121.3
- Zakańczanie aukcji, jeżeli sprzedano X przedmiotów.

Wersja v3.120.3
- Aktualizacja

Wersja v3.119.3
- Aktualizacja modułu

Wersja v3.118.3
- Aktualizacja modułu

Wersja v3.117.3
- Aktualizacja modułu

Wersja v3.116.3
- Aktualizacja modułu

Wersja v3.115.3
- Dodatkowa opcja lokalizacji w dodatkowych kontach allegro.

Wersja v3.114.3
- Aktualizacja modułu allegro

Wersja v3.113.3
- Opcja dla sklepów - do wyczerpania zapasów
- Zmiany na grid liście "Wystaw aukcje"

Wersja v3.112.3
- Aktualizacja modułu

Wersja v3.111.3
- Aktualizacja modułu

Wersja v3.110.3
- InPost Paczkomaty dla Allegro

Wersja v3.109.3
- Mapowanie kategorii sklep <> allegro

Wersja v3.108.3
- Dodano opcje wycinania cech z bloku atrybutów.
- Dodanie loginu allegro sprzedającego do tworzonych zamówień.
- Poprawa wyświetlania ceny bez podatku w edycji aukcji na liście produktów.

Wersja v3.107.3
- Poprawka na liście produktów do wystawienia.

Wersja v3.106.3
- Zmiana ilości zer po kropce z 4 na 2 na siatce zarządzania aukcjami.

Wersja v3.105.3
- Aktualizacja aukcji / wznawianie z kont dodatkowych.

Wersja v3.104.3
- Wyłączenie notyfikacji o wygasającej licencji jeżeli AdminNotification jest wyłączone.

Wersja v3.103.3
- Dodano opcje baseImage
- Dodano możliwość notifykacji nt. transakcji, z których od 24h nie powstało zamówienie
- Dodano możliwość włączenia notyfikacji nt. błędów CRON
- Zrobienie pola "Kategoria sklepu" jako wymagane
- Zakończenie aukcji po zmianie statusu produktu na DISABLED

Wersja v3.102.3
- Poprawiono sprawdzanie statusu podczas wystawiania aukcji.
- Dodano kolumnę status produktu na liście produktów podczas wystawiania aukcji.

Wersja v3.101.3
- Możliwość wyłączenia skalowania miniatury po stronie Magento.

Wersja v3.100.3
- Optymalizacja i poprawki.

Wersja v3.99.3
- Możliwość dodawania obrazków po nazwie.
- Poprawa walidacji długości tytułu aukcji.
- Poprawa obsługi tagów w tytule aukcji.
- Aktualizacja parametrów aukcji jeżeli zostały zmienione a nikt jeszcze nic nie kupił.
- Filtrowanie po parametrach allegro, na liście aukcji (wyróżnienie, miniaturka, etc).

Wersja v3.98.3
- Poprawa obsługi UTF-8

Wersja v3.97.3
- Dodanie funkcji stripTags (usuwanie linków) dostępnej na produkcie w szablonie Allegro

Wersja v3.96.3
- Poprawka błędu "Headers already sent", pojawiającego się przy niektórych konfiguracjach serwera.

Wersja v3.95.3
- Zmiana szablon na definicja przy tworzeniu aukcji z listy produktów.
- Usunięcie problematycznego zgłaszania błędów.

Wersja v3.94.3
- Poprawka wyboru sposobu płatności.

Wersja v3.93.3
- Poprawka błędu integracji z modułem paczkomatów.

Wersja v3.92.3
- Dodano możliwość pobierania galerii z produktu konfigurowalnego, tak jak to ma miejsce z miniaturką.

Wersja v3.91.3
- Aktualizacja API testowego do webapisandbox.pl

Wersja v3.90.3
- Dodano możliwość wystawienia produktu prostego z obrazkiem produktu konfigurowalnego.

Wersja v3.89.3
- Dostosowanie modułu pod Magento 1.5.1.0

Wersja v3.88.3
- Zmiana sposobu logowania, rozwiązanie problemów z przekroczeniem limitu sesji.
- Poprawiono filtrowanie w niestandardowych kolumnach.

Wersja v3.87.3
- Poprawa integracji z impost.
- Poprawienie wystawiania aukcji (zbyt długie pole nazwa)
- Poprawienie obsługi definicji.
- Aktualizacja metod wysyłki.

Wersja v3.86.3
- Zapisywanie adresu do wysyłki i do faktury.
- Masowa akcja wystawiania o danej dacie.

Wersja v3.85.3
- Używaj "-" zamiast "brak" jako wypełnienie pustych pól
- Kopiuj "dodatkowe informacje" dostawy do pól adresowych
- Domyślna grupa nowo tworzonych klientów

Wersja v3.84.3
- Dodanie obsługi wyjątków dla nowych płatności PayU
- Poprawka błędu który powodował wyświetlanie się zamówień allegro na liście porzuconych koszyków.
- Naprawa translacji w akcjach cron
- Wybór sklepu dla nowych klientów

Wersja v3.83.3
- Dodanie logowania zdarzeń allegro.

Wersja v3.82.3
- Naprawa wycofania aukcji.

Wersja v3.81.3
- Dodano zakładkę Allegro do podglądu zamówienia.

Wersja v3.80.3
- Poprawa integracji z InPost
- Poprawa wyszukiwanie po id
- Poprawa walidacji wartości zmiennoprzecinkowych
- Poprawa wczytywania informacji dodatkowych
- Poprawa wczytywania atrybutów

Wersja v3.79.3
- Poprawka automatycznego zakańczania aukcji
- Poprawka automatycznego zmniejszania ilości produktów na aukcji

Wersja v3.78.3
- Rozszerzona możliwość parowania metod dostawy Allegro – Magento
- Dodanie importu komentarzy klientów do zamówienia
- Dodanie wyboru statusu dla odbioru osobistego

Wersja v3.77.3
- Dodania możliwości mapowania wysyłek Allegro do modułów Magento.

Wersja v3.76.3
- Dodana opcja wystawiaj ponownie jeżeli stan magazynowy wynosił 0
- Dodano możliwość tworzenia ręcznie zamówienia, które posiada formularz dostawy, ale nie zostało utworzone automatycznie z powodu błędów.

Wersja v3.75.3
- Poprawa integracji z wFirma
- Możliwość ponowienia tworzenia zamówienia dla aukcji spoza Magento.
- Imię i nazwisko klienta a liście ostatnich zamówień.
- Walidacja poprawności kwoty zamówienia.

Wersja v3.74.3
- Poprawa integracji z wFirma.

Wersja v3.73.3
- Poprawka błędnego pobierania produktu pod magento 1.6

Wersja v3.72.3
- Poprawka importowania numeru nip do zamówienia.
- Poprawka błędu ilości sztuk gdy produkt został kupiony kilka razy na jednej aukcji, ale nie w tym samym momencie.

Wersja v3.71.3
- Poprawka pobierania aukcji wystawionych poza Magento.
- Poprawka widoczności produktów w aukcji gdy nie ma ich na magazynie.
- Poprawka dodawania znaku wodnego.
- Logowanie błędów wyniesione do nowego pliku allegro.log.
- Poprawa działania skryptów cron.

Wersja v3.70.3
- Poprawa integracji z wFirma

Wersja v3.69.3
- Poprawione filtrowanie po definicji aukcji.
- Poprawione importowanie aukcji wystawionych poza Magento.
- Poprawione pobieranie danych billingowych, gdy dostawa do paczkomatu.

Wersja v3.68.3
- Wymuszenie waluty podczas tworzenia zamówienia.
- Zmiana zapisu informacji o chęci otrzymania faktury.

Wersja v3.67.3
- Dodanie nowych tłumaczeń Aukro.ua

Wersja v3.66.3
- Poprawka przy zapisywaniu konfiguracji
- Poprawki błędów tłumaczenia Aukro.ua

Wersja v3.65.3
- Poprawki wersji Aukro

Wersja v3.64.3
- Dodanie obsługi ukraińskiej wersji Allegro - Aukro.ua

Wersja v3.63.3
- Optymalizacja zapytań SQL

Wersja v3.62.3
- Poprawki dotyczące cron

Wersja v3.61.3
- Poprawa ponownego wystawiania aukcji. Teraz jeżeli aukcja nie zostanie wystawiona z powodu braku przedmiotu na magazynie, zostanie wystawiona ponownie, gdy produkt zostanie dodany na magazyn.
- Dodano możliwość użycia tagów szablonu w atrybutach produktu.

Wersja v3.60.3
- Przyspieszenie uruchamiania zadań automatycznych (Cron)

Wersja v3.59.3
- Poprawka błędu, który uniemożliwiał użycie niektórych tagów w szablonie aukcji.

Wersja v3.58.3
- Dodanie możliwości wyłączenia parsowania pól na liście aukcji do wystawienia.
- Optymalizacja listy aukcji.

Wersja v3.57.3
- Możliwość sortowania aukcji po tym czy są wystawione czy też nie.
- Zmiana sposobu ładowania zdjęć do miniaturki.

Wersja v3.56.3
- Adres paczkomatu jest zapisywany jako adres dostawy.
- Imię i nazwisko nowego klienta pobierane są z danych jego konta Allegro, a nie jak do tej pory z adresu.
- Poprawa błędu związanego z importem zamówień.

Wersja v3.55.3
- Poprawa zmiany statusu dla zamówień płatnych przy odbiorze
- Dodanie możliwości skalowania miniaturki do proporcji 4:3
- Dodanie możliwości zmiany ustawień znaku wodnego dla każdego konta osobno.

Wersja v3.54.3
- Poprawka dodawania znaku wodnego do miniaturki, niekiedy zdjęcia źle się skalowały.
- Możliwość ignorowania stanów magazynowych Magento przy wystawianiu i obsłudze aukcji.

Wersja v3.53.3
- Możliwość dodania znaku wodnego do miniaturki, znak wodny może być różny dla każdego konta.
- Usprawnienie działania cron dla aktualizacji aukcji. Teraz aktualizacja działa dużo szybciej, została także zredukowana liczba zapytań do API.
- Poprawiony błąd dodawania nazwiska klienta do zamówienia. W niektórych przypadkach pojawiała się informacja 'brak' zamiast nazwiska.

  • 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ę