Pobierz dokumentację - Web

Transkrypt

FUTURE-SOFT SP. Z O.O.
ul. Gosławicka2/215 45-446, Opole
tel. +48667700732 [email protected]
NIP: 599-316-99-06
ALLEGRO
(Moduł Magento)
v.3.128.3
Strona 1 z 49
NIP: 599-316-99-06
Spis treści
Zgodny z Magento ........................................................................................................................................................ 3
Moduł nie współpracuje ............................................................................................................................................... 3
Instalacja ....................................................................................................................................................................... 3
Konfiguracja cron LINUX ........................................................................................................................................... 5
Konfiguracja cron WINDOWS ................................................................................................................................... 6
Konfiguracja .................................................................................................................................................................. 7
Definicje aukcji............................................................................................................................................................18
Szablony aukcji. ..........................................................................................................................................................21
Podgląd aukcji. ............................................................................................................................................................24
Lista zamówień ...........................................................................................................................................................25
Wystawianie aukcji .....................................................................................................................................................26
Zwrot prowizji .............................................................................................................................................................33
PayU ............................................................................................................................................................................35
Zamówienia ................................................................................................................................................................36
Mapowanie kategorii allegro ......................................................................................................................................37
Zdarzenia (events) ......................................................................................................................................................38
Integracja z e-opisy .....................................................................................................................................................39
FAQ .............................................................................................................................................................................39
Changelog ...................................................................................................................................................................42
Strona 2 z 49
NIP: 599-316-99-06
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
Strona 3 z 49
NIP: 599-316-99-06
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]
Strona 4 z 49
NIP: 599-316-99-06
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.
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
Strona 5 z 49
NIP: 599-316-99-06
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.
Strona 6 z 49
NIP: 599-316-99-06
Konfiguracja
Z menu Narzędzia wybieramy Allegro a następnie Konfiguracja.
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.
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.
Strona 7 z 49
NIP: 599-316-99-06
Używaj zdjęć produktów konfigurowalnych – Pozwala na wstawienia zdjęć miniatur produktów
konfigurowalnych oraz prostych.
Strona 8 z 49
NIP: 599-316-99-06
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.
Strona 9 z 49
NIP: 599-316-99-06
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
Strona 10 z 49
NIP: 599-316-99-06
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.
Strona 11 z 49
NIP: 599-316-99-06
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:
Strona 12 z 49
NIP: 599-316-99-06
Opcja indywidualnej lokalizacji dla dodatkowego konta
Ustawianie znaku wodnego dla zdjęć w wystawionych aukcjach Allegro.
Po wpisaniu numeru konta bankowego zostanie one dodane do wystawionej aukcji na Allegro.
W panelu „Komentarze” podajemy treść pozytywnego komentarza, wystawianego z sekcji komentarzy.
Strona 13 z 49
NIP: 599-316-99-06
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.
Strona 14 z 49
NIP: 599-316-99-06
Ustawienia kwot dostaw, tutaj należy podać co najmniej jedną kwotę.
Można sparować sposoby dostawy Allegro z tymi w modułach Magento.
Strona 15 z 49
NIP: 599-316-99-06
Zadania automatyczne cron.
Dzięki tej opcji można ustawić co jaki czas skrypt ma wykonywać włączone funkcje:
Strona 16 z 49
NIP: 599-316-99-06
Dodatkowe kolumny na listach:
Zaznaczamy jakie dodatkowe kolumny mają pojawić się na danej liście.
Strona 17 z 49
NIP: 599-316-99-06
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.
Strona 18 z 49
NIP: 599-316-99-06
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.
W celu utworzenia aukcji na podstawie jej definicji należy wybrać z menu Catalog, a następnie Manage
Products.
Strona 19 z 49
NIP: 599-316-99-06
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.
Strona 20 z 49
NIP: 599-316-99-06
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.
Strona 21 z 49
NIP: 599-316-99-06
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 posziału linii do htmlowego<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}}
Strona 22 z 49
NIP: 599-316-99-06
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}}
{{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.
Strona 23 z 49
NIP: 599-316-99-06
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ć 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.
Strona 24 z 49
NIP: 599-316-99-06
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:
Strona 25 z 49
NIP: 599-316-99-06
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.
Strona 26 z 49
NIP: 599-316-99-06
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.
Strona 27 z 49
NIP: 599-316-99-06
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).
Strona 28 z 49
FUTURE-SOFT
SOFT SP. Z O.O.
ul. Gosławicka2/215
Gosławicka2
45-446, Opole
NIP: 599-316
316-99-06
Następnie możemy przejść do wyboru kategorii.
Strona 29 z 49
NIP: 599-316-99-06
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ę.
Strona 30 z 49
NIP: 599-316-99-06
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.
Strona 31 z 49
NIP: 599-316-99-06
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ł).
Strona 32 z 49
NIP: 599-316-99-06
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.
Strona 33 z 49
NIP: 599-316-99-06
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ł).
Strona 34 z 49
NIP: 599-316-99-06
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ę.
Strona 35 z 49
NIP: 599-316-99-06
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 wpanelu „Shipping& Handling Information” znajduje się wybrany sposob dostawy:
Strona 36 z 49
NIP: 599-316-99-06
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ć.
Strona 37 z 49
NIP: 599-316-99-06
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.
Zdarzenia (events)
Moduł wywołuje następujące zdarzenia (w nawiasie obiekty przekazane do zdarzenia):
•
•
•
•
•
Gdzie:
•
•
•
•
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 .
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.
Strona 38 z 49
NIP: 599-316-99-06
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?
Strona 39 z 49
NIP: 599-316-99-06
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
Strona 40 z 49
NIP: 599-316-99-06
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: 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 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.
Strona 41 z 49
NIP: 599-316-99-06
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.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.
Strona 42 z 49
NIP: 599-316-99-06
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
- Możliwość edycji ilości na aukcji z listy podgląd aukcji
Wersja v3.124.3
Wersja v3.123.3
Wersja v3.122.3
Wersja v3.121.3
- Zakańczanie aukcji, jeżeli sprzedano X przedmiotów.
Wersja v3.120.3
- Aktualizacja
Wersja v3.119.3
Wersja v3.118.3
Wersja v3.117.3
Wersja v3.116.3
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"
Strona 43 z 49
NIP: 599-316-99-06
Wersja v3.112.3
Wersja v3.111.3
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.
Strona 44 z 49
NIP: 599-316-99-06
- 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.
Strona 45 z 49
NIP: 599-316-99-06
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.
Strona 46 z 49
NIP: 599-316-99-06
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
Strona 47 z 49
NIP: 599-316-99-06
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.
Strona 48 z 49
NIP: 599-316-99-06
- 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.
Strona 49 z 49

Pobierz dokumentację - Web

Transkrypt

Podobne dokumenty

EUROINWEST Aleksandra Kieras al. 3 Maja 9 30

DJCOM-formularz

Imię i Nazwisko: Adres zamieszkania: Nick/login allegro

TAURON Wytwarzanie Spółka Akcyjna ul. Promienna 51, 43

Ozdoba do włosów

FORMULARZ ZWROTU TOWARU Nr zamówienia/aukcji

Welon 3 m długości

Nie chcesz kupować? Nie licytuj!

OFERTA PRACY – Asystent ds. sprzedaży internetowej