Dokumentacja - Integracja Allegro z PrestaShop

Wymagania instalacyjne

Moduł wymaga kilku podstawowych usług na serwerze, które w większości przypadków są aktywne.

1. PHP: 5.6 (minimalnie) - 8.1
2. ionCube: tak
3. SOAP: tak
4. openSSL: tak
5. mbstring: tak
6. cURL: tak
7. bcmath: tak
8. protokół TLS: 1.2 (minimalnie) - 1.3

Gdyby któraś z wymienionych opcji nie była dostępna - należy ją włączyć w panelu serwera lub napisać do administratora

Instalacja

Moduł możesz znaleźć na liście jako:

1. Nazwa: Integracja PrestaShop z Allegro
2. Opis: Zaawansowany moduł integrujący sklep PrestaShop z Allegro.pl. Szybkie wystawianie aukcji, pełna kontrola ilości oraz cen aukcji. Opcja importu zamówień z Allegro.
3. Autor: x13.pl
4. Kategoria: Rynek
5. Filtruj po: Zainstalowane i niezainstalowane / Aktywne i nieaktywne

Aktualizacja modułu

Moduł integracji PrestaShop z Allegro został wyposażony w funkcję auto aktualizacji.
Z faktu na liczne zmiany ze strony API Allegro, wydajemy systematycznie aktualizacja, które można pobrać bezpośrednio ze swojego sklepu.
Jeśli zobaczymy taką informację:

Mamy do pobrania nową wersją modułu, w większości przypadku aktualizacja polega jedynie na wciśnięciu przycisku TUTAJ, moduł powinien pobrać automatycznie najnowszą wersję dodatku.
Zainstalować ją i przejść na zakładkę Moduły Moduły i usługi , po czym wyświetlić informację o zastosowanych aktualizacjach.

po każdej aktualizacji polecamy przynajmniej odświeżyć przeglądarkę (a najlepiej wyczyścić jej cache), jak i wyczyścić cache z Presty

Aktualizacja do wersji 6.2.X

Całkowita migracja pobierania zamówień na restAPI.

Pobieranie zamówień zostało całkowicie z migrowane na rest api, sama obsługa jest zmieniona w stosunku do poprzedniej wersji najważniejsze jest by w sytuacji gdy mamy status „Allegro – przetwarzanie zamówienia” nie procesować tego zamówienia.

Najważniejsze zmiany

• podsumowanie zamówienia (nowy czytelny panel informacji do zakupu Allegro, oraz możliwość konfiguracji elementów, które mają być dodane do wiadomości)
• importowanie niepowiązanych aukcji (od teraz możliwe jest pobieranie wszystkich zamówień z Allegro - również dla niepowiązanych produktów)
• stopniowa aktualizacja cen (zobacz więcej)
• maksymalna ilość sztuk na Allegro
• obsługa całej transakcji w jednym zamówieniu (nie duplikujemy już zamówień w przypadku zmiany płatności)
• uzupełnianie nr płatności wg Allegro
• obsługa dopłat
• nowe nazwy płatności (np Allegro: PAYU zamiast x13Allegro)

W przypadku zaktualizowania modułu, otrzymamy stosowny komunikat, w którym klikamy przejdź do ustawień

Opcje do konfiguracji

• Pobieraj zamówienia z ofert wystawionych przez sklep
• Pobieraj pełną kwotę zamówienia do podsumowania
• Wiadomość do zamówienia (wybór, jakie dane mają być przekazane do wiadomości
• Aktualizuj ceny na Allegro (pełna, w górę, w dół, wcale)
• Maksymalny stan magazynowy na Allegro

W następnym kroku wybieramy jakie konta mają zostać zmigrowane.
Zalecamy przed migracją autoryzować wszystkie konta (jeśli będą nieaktywne).
Pod każdym z kont mamy do wyboru daty migracji zamówień (7, 14 i 60 dni), im większa ilość dni do zmigrowania, tym dłużej będzie trwał ten proces.

W przypadku ustawienia maksymalnej wartości moduł będzie w stanie obsłużyć zmiany w archiwalnych zamówieniach - jednak może zająć to nawet kilkanaście minut dla konta.

Po prawidłowo wykonanej migracji możemy przejść do korzystania z modułu.

Aktualizacja z wersji 3.X

• 1. klikamy na TUTAJ w polu informacji o aktualizacji modułu Allegro
• 2. wchodzimy w zakładkę Moduły Moduły i usługi, w przypadku PrestaShop 1.7 przy module x13allegro klikamy UPRGRADE
• 3. Otrzymujemy informację o tym, że zastosowano X aktualizacji do modułu
• 4. przechodzimy do konfiguracji konta wg opisu poniżej

Konta

Jeśli posiadamy już dodane konto, nigdy nie usuwamy go i nie dodajemy ponownie (w przypadku ponownej autoryzacji lub aktualizacji modułu). Zawsze autoryzacja powinna być przeprowadzona na obecnym koncie.

Aby zacząć korzystać z modułu musimy dodać nowe konto .
Wybieramy zakładkę Allegro Konta i klikamy (dodaj nowe), i uzupełnij poniższe dane.

Nazwa użytkownika – nazwa naszego użytkownika w Allegro
Domyślne konto – zaznaczamy w przypadku gdy ma być to nasze główne konto w integracji
Aktywne konto – możemy włączyć lub wyłączyć konto

Po zapisaniu konta klikamy przy nim na przycisk Autoryzuj

Przejdziemy na Allegro - gdzie musimy powiązać swoje konto z aplikacją - integracją.

W tym momencie moduł przekieruje nas na podstronę Allegro, na której przechodzimy do dodania dostępu dla integracji.

Po wyświetleniu podsumowania Udało się, przechodzimy na podstronę panelu administracyjnego naszego sklepu.

Jeśli konto zostanie z autoryzowanie, możemy wybrać przy nim opcję Edytuj, a następnie wybrać domyślne wartości dla poniższych opcji:

• Informacje o gwarancjach
• Warunki reklamacji
• Warunki zwrotów

Informacje te są pobierane bezpośrednio z Allegro.pl, jeśli jeszcze ich nie masz uzupełnionych zalecamy dodanie ich przed konfiguracją konta.

Możemy dodawać wiele kont, które będą widoczne przy wystawianiu aukcji.
Możemy ustawiać, jaki mają być aktywne, a jaki z nich ma być domyślny.

Przy autoryzacji wielu kont Allegro, obowiązują takie same zasady jak przy tworzeniu konto (polecamy wyczyścić cache przeglądarki oraz wylogowywać się z konta). Jeśli pojawi się błąd z autoryzacją prosimy sprawdzić uwagi z pkt Tworzenie konta.

Szablony

Jeśli wybierzemy nowy szablon nie dodajemy styli (pogrubień, nagłówków, itd) do znaczników:
{auction_description}, {product_description}, {product_description_short}, {product_description_custom}, {product_features}

Ponieważ ich dodanie może powodować przesyłanie niepoprawnie sformatowanego szablonu.

Opcja dodania szablonu wg nowego formatu

Poniżej można zobaczyć różnicę w wyglądzie wystawiania tego samego produktu, według nowego szablonu Allegro.

Podgląd szablonu Allegro - w nowej wersji

Przy stosowaniu starego formatu szablonów zalecamy dodawanie szablonów zbudowanych "na divach", szablony, które są zbudowane na tabelach mogą nie wyświetlać się poprawnie.

Możemy dodawać wiele szablonów, które będą widoczne przy wystawianiu aukcji.
Możemy je również duplikować , ustawiać jaki mają być aktywne, a jaki z nich ma być domyślny.

Zaawansowana konfiguracja szablonu

W nowej wersji modułu umożliwiliśmy opcję korzystania z zaawansowanych opisów składnia jest ważna, w przeciwnym wypadku nie zostanie zamieniona i zostanie w opisie (przykład na produkcie ID:1){if znacznik_szablonu}content{/if}
{if !znacznik_szablonu}other content{/if}
{if znacznik_szablonu < "123.45"}content{/if}
{if znacznik_szablonu == "wartość"}content{/if}

Uwagi:

• proste sprawdzanie działa jako: isset() && !empty()
• lub negacja: !isset() || empty()
• przy porównywaniu wartość musi się znaleźć w jednym z dwóch cudzysłowów (") lub ('), jak na przykładzie poniżej
• w przypadku operatorów (==) i (!=) możliwe jest porównywanie tekstu, w każdym innym przypadku porównanie jest liczbowe
• negacja działa tylko w prostym sprawdzaniu, przy porównywaniu trzeba wybrać pasujący operator

Przykłady
{if feature_value_7}feature_7: {feature_value_7}{/if}
{if attribute_value_3}attribute_3: {attribute_value_3}{/if}
{if product_ean13}ean: {product_ean13}{/if}
{if !product_ean13}negacja ean{/if}
{if auction_price > "30"}wiekszy od 30{/if}
{if auction_price <= "30"}mniejszy lub równy 30{/if}
{if auction_price == '13.99'}równy 13.99{/if}
{if auction_price != '13.99'}różny od 13.99{/if}
{if attribute_value_3 == 'Orange'}Pomarańczowy{/if}

Wystawianie aukcji - podstawowe

Aby wystawić aukcje, klikamy Allegro Wystaw , zobaczymy tam listę wszystkich produktów.

Przy interesującym nas produkcie klikamy Wystaw / Wystawiony, i zostaniemy przeniesieni na dodatkową podstronę.

Możemy zaznaczyć, jakie zdjęcia będą wysłane do tego w jakim szablonie wystawimy aukcje na Allegro.
Musimy wybrać kategorię z Allegro, i wpisać do niej cechy.
Na samym końcu uzupełniamy dane do wysyłki i płatności na identycznej zasadzie jak na Allegro.

U góry zakładki klikamy Wystaw aukcje, a wybrane produkty zostaną wystawione na Allegro.

Zaprezentowany sposób jest najprostszy do wystawnie aukcji - jednak nie wykorzystuje on całej możliwości modułu.
Możemy wystawiać aukcje dużo szybciej i w większym stopniu automatycznie - opisane jest to w kontynuacji dokumentacji, w zakładce Wystawianie aukcji - zaawansowane .

Powiązania kategorii

Moduł posiada funkcjonalność, dzięki której możemy zaoszczędzić bardzo dużą ilość czasu – powiązanie kategorii.

Dzięki poświęceniu kilku minut na powiązanie kategorii z PrestaShop z kategoriami z Allegro, a następnie cech/producentów/atrybutów z PrestaShop z parametrami kategorii z Allegro możemy oszczędzić wiele godzin podczas wystawiania aukcji.

Czyli np. produkty ze sklepu z kategorii sukienki będą miały automatycznie wybraną kategorię sukienki na Allegro, również zostaną uzupełnione parametry takie jak np. kolor, rozmiar, wzór, producenta czy też kod referencyjny lub EAN.

Aby rozpocząć dodawanie powiązań przechodzimy do Allegro Powiązanie kategorii, następnie po prawej u góry klikamy Dodaj powiązanie kategorii.

Zaczynamy od wyboru kategorii z Allegro, w naszym przykładzie będzie to Moda > Odzież, Obuwie, Dodatki > Odzież męska > T-Shirty, jeśli znamy numer kategorii możemy też go wpisać, zamiast wybierać kategorię domyślną. Numer wybranej kategorii to 87913.

Jeśli chcemy możemy dodać nazwę pomocniczą powiązania – widoczną tylko na liście wszystkich powiązań, w naszym przypadku będzie to Koszulki męskie, w tym momencie polecamy zapisać ustawienia klikając Zapisz i zostań.

Mapowanie parametrów kategorii

Poniżej zobaczymy tabelę z tytułem Parametry kategorii, w której widoczne będą wszystkie parametry kategorii z Allegro.

W naszym przypadku dokonamy kilku różnych czynności mapowania, pokażemy, w jaki sposób można mapować parametry cech kategorii w Allegro z parametrami produktów.

1. Ustawienie stałego parametru dla wszystkich produktów w tej kategorii

Ustawimy na stałe Stan na Nowy.
By to zrobić po prostu wybieramy z listy Stan opcję Nowy

2. Mapowanie wybranej wartości produktu (kod referencyjny, EAN, waga itd)

Zmapujemy Wagę z realną wagą produktu z PrestaShop.
Przy polu Waga (z opakowaniem) po prawej klikamy w przycisk mapuj pole, w tym momencie otworzy nam się nowy popup z możliwością mapowania wartości z Allegro z tymi, które mamy w naszym sklepie.

Przy Wartość z Allegro – Waga rozwijamy listę z tabeli Atrybut/Cecha/Producent i wybieramy Wartość produktu⁣, a następnie Waga opakowania i zapisujemy nasze powiązanie potwierdzając przyciskiem Zapisz

3. Mapowanie wartości atrybutu/cechy

Zmapujemy rozmiar z realnymi rozmiarami (atrybutami) z naszego sklepu.
Koło interesującego nas pola (Rozmiary) klikamy przycisk Mapuj pole

W popupie dla naszego przykładu zmapujemy Rozmiar S, M i L, z rozwijanej listy przy wybranym rozmiarze szukamy konkretnego rozmiaru ze sklepu, możemy wpisać nazwę grupy atrybutów czy też wartość takiego atrybutu np. Rozmi (nie musimy wpisać precyzyjnie nazwy) i wybieramy np. Rozmiar L i zapisujemy zmian.

4. Mapowanie wartości atrybutu/cechy, wraz z ustawieniem domyślnej wartości w przypadku braku wartości atrybutu

Zmapujemy materiał z realnymi materiałami (cechami) z naszego sklepu, a w przypadku jego braku ustawimy parametr Inny.
Zasada mapowania atrybutów jest identyczna jak w punkcie powyżej, jeśli chcemy również dodać domyślną wartość w przypadku braku którejkolwiek z poniżej zmapowanych opcji, musimy wybrać w opcji Ustaw domyślną wartość parametru wybrać Inny.

5. Automatyczne mapowanie kodu EAN / ISBN

Korzystając z naszego modułu możemy automatycznie uzupełniać kody EAN i ISBN przy wystawianiu aukcji, aby to zrobić przechodzimy do Allegro Konfiguracja i włączamy opcję Używaj kodu EAN13 w aukcjach, po jego włączeniu kody będą automatycznie dopisywane na takiej samej zasadzie jak byśmy mapowali każdą z kategorii osobno.

Wszystkie z opisanych opcji mapowania działają również z atrybutami, oraz działają przy masowym wystawianiu produktów (zaznaczając wiele produktów z 1 grupy mapowania) – zapraszamy do zapoznania się z opisem wystawiania takich produktów w Wystawianie aukcji - zaawansowane.

Tagi produktów

Gdy chcemy do wystawianych produktów z danej kategorii Allegro automatycznie przypisywać wybrane Tagi możemy zrobić to w tym miejscu, wybierz z już zdefiniowanych tagów lub dodaj nowe.

Powiązanie z kategorią

Ostatnia opcja, którą znajdziemy podczas tworzenia powiązania kategorii to Powiązanie kategorii, dzięki tej opcji możemy automatycznie wybierać kategorię w Allegro na podstawie domyślnej kategorii wystawianych produktów.
Z listy możemy wybrać dowolną ilość kategorii, dla których automatycznie zostanie wczytany dany zestaw mapowania – co to oznacza w praktyce ?
Błyskawiczne wystawianie, produkty będą miały wybraną kategorię w Allegro, oraz wszystkie wyżej zmapowane kategorie – będzie to bardzo duża oszczędność czasu podczas wystawiania aukcji!

Płatność i dostawa

Dodanie profilu dostawy

Jeśli mamy już dodane konto, kolejnym krokiem będzie dodanie Profilu dostawy, jest to zbiór informacji, w których uzupełniamy informację na temat lokalizacji naszej firmy, informacji o fakturze oraz czasie dostawy.
Aby dodać nowy profil dostawy przechodzimy do Allegro Ustawienia dostawy następnie na górze po prawej klikamy w ikonkę Dodaj nowy profil dostawy i ustawiamy go według własnych preferencji.

W przypadku braku dodania przynajmniej jednego profilu dostawy nie będziemy mieli możliwości wystawienia aukcji oraz otrzymamy błąd pt:
Brak utworzonych profili dostawy

Gdy dodasz kilka cenników dostawy dla jednego konta Allegro, możesz zadecydować, który ma być domyślnie wybrany podczas wystawiania aukcji.

Dodanie / edycja cenników dostawy

Znajdując się w zakładce Allegro Ustawienia dostawy mamy również listę cenników przypisanych do konta Allegro.

W przypadku gdy mamy już dodane cenniki na stronie Allegro.pl zostaną one automatyczne wczytane do modułu w to miejsce, jak i będą dostępne podczas wystawiania aukcji.

Jeśli chcemy utworzyć nowy cennik wybieramy przycisk znajdujący się w prawym górnym rogu Dodaj nowy cennik, następnie wybieramy opcję dostawy, które chcemy mieć aktywne podczas korzystania z tego cennika.

Przy dodawaniu cen należy pamiętać o tym że wybrane usługi np.: (Allegro MiniPaczka InPost, Allegro Paczkomaty InPost oraz Alegro Kurier InPost) nie mogą być wyższe niż wymagane przez Allegro

Edycja cennika dostawy

W przypadku edycji wybranego cennika, możemy zmienić jego nazwę, ceny dostawy czy też dodać kolejne opcje dostawy.
Taka edycja spowoduje również zmianę na wszystkich aukcjach, które były wystawione z wybranym cennikiem dostawy!

Usuwanie cennika dostawy

Jeśli mamy dodany już dodany cennik dostawy i chcemy go usunąć, niestety nie mamy takiej możliwości (jest to ograniczenie po stronie Allegro.pl, nie samej integracji).

Każdy z profili dostawy i cenników przypisany jest do jednego konta Allegro.
Możemy dodawać wiele wyborów opcji płatności i dostawy, które będą widoczne przy wystawianiu aukcji.

Statusy zamówień

W opcji Allegro Statusy zamówień możemy ustawić jaki status z płatności Allegro będzie ustawiany na konkretny Status zamówienia w PrestaShop.

Przewoźnicy

W zakładce Allegro Powiązanie przewoźników możemy ustawić jak wybrany przewoźnik z Allegro będzie importowany do naszego zamówienia w PrestaShop.

Automatyczne wysyłanie nr przewozowego

Od wersji 5.1.0 modułu, umożliwiamy automatyczne wysyłanie nr przewozowego z PrestaShop do Allegro.

Wybieramy zakładkę Allegro Powiązanie przewoźników., na której mamy listę wszystkich przewoźników dostępnym w Allegro.

Przy każdym z przewoźników mamy Jego nazwę, pole do wyboru Przewoźnik w Twoim sklepie - w którym wybieramy najbardziej pasujący sposób dostawy w naszym sklepie, oraz pole Operator numeru śledzenia w Allegro - który wybierany jest automatycznie podczas wysyłania nr przewozowych.

Po prawidłowym uzupełnieniu nr przewozowego na karcie zamówienia, ręcznie lub przez zewnętrzną integrację moduł Allegro wyśle numer przesyłki bezpośrednio do Allegro, przy 1wszej prawidłowo wykonanej synchronizacji - przez plik sync (ustawiony w zadaniach cron na serwerze).

Możemy również ręcznie wysłać nr przewozowe, wchodząc w zakładkę Allegro Numery śledzenia Allegro i klikając po prawej u góry w ikonkę Wyślij numery śledzenia.

Lista aukcji

Wybierając Allegro Lista aukcji otrzymujemy listę sprzedawanych / sprzedanych / nie sprzedanych wszystkich aukcji z Allegro dla danego konta.
W tym miejscu możemy edytować trwające już aukcje jak i przypisywać aukcje z Allegro do wybranych produktów w PrestaShopie.

Jeśli chcemy zmienić Ilość lub Cenę danej aukcji na Allegro klikamy przycisk Edytuj aukcje, i możemy wpisać wartości ręcznie, lub zaktualizować je z wybranych opcji. Aukcje również możemy edytować masowo.

Gdy mamy już wystawione aukcje na Allegro, a nie były one dodane przez integrację - takie aukcje nie będą się aktualizowały z produktami w sklepie.
Możemy jednak powiązać aukcje z naszymi produktami klikając Przypisz, wpisujemy pierwsze litery od towaru, z którym chcemy połączyć aukcje. Jeśli produkt ma atrybuty to również musimy wybrać jako to jest atrybut.
Po przypisaniu taka aukcja będzie importowana do zamówień w naszym sklepie, jak i ilości będą się aktualizować (oczywiście jeśli mamy te opcje aktywne w module).

Wystawianie aukcji - zaawansowane

Indywidualne cechy

Uwaga od wersji 5.0.0 modułu zmieniło się wystawianie indywidualnych cech

Z faktu nowej możliwości mapowania atrybutów i cech zrezygnowaliśmy z kopiowania cech do produktów w poprzedniej formie.
Teraz wystarczy w globalnych cechach ustawić wszystkie spójne cechy, a w indywidualnych tylko różnicę dla danego produktu.
Czyli np ustawiamy dla bluzki, producenta, krój, materiał itd. w globalnych cechach, a sam rozmiar ustawiamy w cechach indywidualnych.

Indywidualne dane produktu

W module umożliwiamy ustawienie indywidualnych danych dla wybranych produktów.
Wszystkie parametry indywidualnego produktu ustawiamy z Katalog Produkty, następnie edytujemy wybrany produkt.
W Przypadku PrestaShop 1.6 w zakładkach produktu wybieramy X13Allegro.
Jeśli korzystamy z PrestaShop 1.7 przechodzimy do zakładki Moduły (w edycji produktu), następnie przy X13Allegro klikamy konfiguruj.

• tytuł aukcji
• opcja aktualizacji ceny wybranego produktu
• opcja aktualizacji ilości wybranego produktu
• indywidualne tagi
• dodatkowe zdjęcia - tylko dla Allegro
• dodatkowe opisy - tylko dla Allegro

Indywidualne ceny na Allegro dla konkretnego produktu

• cenę końcową (cena brutto)
• wpływ na cenę (wartość)
• wpływ na cenę (procent)

Każda z tych opcji może być wybrana dla całego produktu, albo dla konkretnej kombinacji.

Jak ustawić indywidualną cenę dla konkretnego produktu?

Przechodzimy do zakładki Katalog Produkty, następnie edytujemy wybrany przez nas produkt.

W przypadku PrestaShop 1.7.X na stronie produktu, przechodzimy na ostaniom zakładkę Moduły, i w okienku z modułem Allegro klikamy Konfiguruj.
Jeśli korzystamy z wersji PrestaShop 1.6.X na stronie produktu, klikamy w zakładkę X13allegro.

Na otwartej zakładce mamy dział "Ceny indywidualne", odpowiadający za ceny pod Allegro.
Z rozwijanej listy możemy wybrać czy cena ma być dodana dla wszystkich kont, czy tylko dla wybranego konta.
Gdy uzupełnimy ceny dla indywidualnego konta mają one wyższy priorytet niż cena dla wszystkich kont.

Jeśli twój Produkt posiada kombinacje (atrybuty), możesz ustawić indywidualne ceny dla całego produktu lub wybranych kombinacji.
Pamiętaj, by po wprowadzeniu ceny dla wybranego konta zapisać je klikając przycisk Zapisz ustawienia Allegro.
Indywidualne ceny widoczne są automatycznie przy wystawianiu, jak i aukcje są aktualizowane według tych wartości na Allegro (w przypadku włączenia aktualizacji cen).
W przypadku podania konkretnej ceny w opcji cena końcowa np. jako 19.99 i włączeniu opcji zaokrąglania cen w module, cena na aukcji pozostanie niezaokrąglona.

Ustawienia

Ustawienia CRON - automatyczne pobieranie zamówień

Aby moduł zaczął pobierać nam zamówienia z Allegro, jak i ustawiać ilości po sprzedaży na Allegro, potrzebujemy dodać zadanie CRON na serwerze.

Wywołujemy co 5 minut

W przypadku bardzo dużej ilości wystawionych produktów, jak i zamówień z Allegro - możesz zwiększyć częstotliwość do "co 3 minuty".

/usr/bin/wget -q -F -O - "http://domena.pl/modules/x13allegro/sync.php?token=XXXXXX" 

Zamiast XXXXXX wpisujemy poprawny indywidualny token, cały poprawny link znajdziemy w Allegro Konfiguracja, na samym dole w boxie Synchronizacja.

Jak dodać zadanie CRON na serwerze ?
Powyższe przykłady dodania zadań CRON są dla serwerów z systemem DirectAdmin, szczegółową instrukcję, jak i przykłady dla innych serwerów znajdą Państwo tutaj

Synchronizacja ilości

Moduł pomniejsza stany magazynowe, przed finalnym utworzeniem zamówienia w sklepie.
Jest to działanie celowe - ponieważ klient może kupić produkt, a formularz po zakupowy uzupełnić np. po 5 dniach. Przy standardowym podejściu do tworzenia zamówień, istniałaby możliwość sprzedania produktu na sklepie, który już ktoś zamówił w sklepie.
Zamówienia z Allegro importują się bez zmiany ilości w produktach - jest to również zabezpieczenie przez uzupełnienie kilkukrotnie formularza do 1dnych zakupów - np zmiana banku przy płatności.

Import zamówień

Moduł importuje zamówienia jeśli spełnione są warunki:

• produkt jest wystawiony lub zmapowany z aukcją Allegro
• w module mamy ustawioną opcję Importuj zamówienia z Allegro na TAK
• zadanie CRON na plik synchronizacyjny jest poprawnie ustawione na serwerze - awaryjnie możemy uruchomić ręcznie link od synchronizacji w przeglądarce
• moduł importuje tylko zamówienia, które mają uzupełniony poprawnie formularz po zakupowy, na jego podstawie zamówienie pobieranie jest do sklepu

Aktualizacja ceny

Aktualizacja cen na wystawionych aukcjach

W module możemy włączyć aktualizację cen w już wystawionych aukcjach, aktualizacja cen również bierze pod uwagę wpisany dodatkowy narzut w konfiguracji modułu.
Aby włączyć aktualizację cen, przechodzimy do Allegro Konfiguracja następnie w opcji Aktualizuj ceny na Allegro, wybieramy interesujący nas sposób aktualizacji cen:

• nie aktualizuj (ceny nie zostaną zaktualizowane)
• pełna aktualizacja (ceny zostaną zaktualizowane, jeśli cena będzie wyższa lub niższa na sklepie w stosunku do ceny na aukcji)
• aktualizuj tylko w górę (cena zostanie zaktualizowna w przypadku gdy produkt będzie droższy na sklepie niż na aukcji)
• aktualizuj tylko w dół (cena zostanie zaktualizowana tylko w przypadku gdy jego cena na sklepie będzie niższa niż na Allegro)

Jeśli chcemy wykluczyć lub zmienić sposób aktualizacji dla wybranego produktu zrobimy to w konfiguracji danego produktu (edytując produkt, następnie przechodząc do zakładki Allegro).

Aktualizacja aukcji na Allegro.

Nasza integracja PrestaShop z Allegro umożliwia wykonywania masowych zmian/aktualizacji na już wystawionych aukcjach. Integracja obsługuje aukcje, które są wystawione z modułu lub zostały powiązane z produktami w Preście.

Moduł umożliwia aktualizację kilkunastu opcji związanych z aukcjami, każda z nich zostanie opisana poniżej. Aby aktualizować już wystawione aukcje przechodzimy do zakładki Allegro Lista aukcji.
Następnie możemy przy każdej powiązanej aukcji wybrać po prawej przycisk Aktualizuj lub skorzystać z opcji masowych.
Zaznaczamy checboxem po lewej wybrane przez nas aukcje, na dole pod listą wybieramy Działania masowe, a następnie z listy wybieramy Aktualizuj wybrane

Uwaga! W przypadku edycji ilości oraz ceny produktów, informacje o tych zmianach aktualizują się automatyczne podczas wykonywania zadania CRON, preferencje aktualizacji cen i ilości ustawiamy w Allegro Konfiguracja.

Proces aktualizacji przebiega w taki sam sposób dla każdej dostępnej opcji aktualizacji aukcji.

1. Zaznaczamy jedną lub wiele aukcji, które chcemy edytować (checboxami po lewej stronie na liście aukcji), zgodnie z powyższym opisem.

2. Wybieramy odpowiednią opcję z dostępnej listy akcji

3. Potwierdzamy zmianę, klikając przycisk Aktualizuj aukcje

4. Zobaczymy informację na temat aktualizacji aukcji, Trwa aktualizacja …., która zaprezentuje również graficznie informację ile aukcji zostało już zaktualizowanych.

Poniżej paska postępu, mamy pole Dziennik zdarzeń, są w nim na bieżąco odświeżane informację o aktualizacji aukcji, również w tym miejscu zobaczymy informację o błędach.

5. Po zakończeniu aktualizacji otrzymamy informację Aukcje zakończone, a pasek postępu zmieni kolor na zielony.

Aktualizacja w tym momencie została zakończona, możemy przejść do aktualizacji innej opcji na tych samych aukcjach lub zakończyć aktualizacje.

Opcje aktualizacji aukcji

• Aktualizacja powiązania z PrestaShop
• Aktualizacja powiązania z Katalogiem Allegro (Produktyzacja)
• Aktualizacja parametrów
• Aktualizacja tytułu aukcji
• Aktualizacja opisu aukcji
• Aktualizacja szablonów
• Aktualizacja EAN
• Aktualizacja sygnatury
• Aktualizacja jednostki
• Aktualizacja opcji faktury
• Aktualizacja stawki podatku VAT
• Aktualizacja cennika dostawy
• Aktualizacja czasu wysyłki
• Aktualizacja daty wysyłki (przedsprzedaż)
• Aktualizacja warunków oferty (zwrot/reklamacja/gwarancja)
• Aktualizacja cennika hurtowego
• Aktualizacja tabeli rozmiarów
• Aktualizacja usług dodatkowych

Aktualizacja powiązania z PrestaShop

Opcja Aktualizacja powiązania z PrestaShop służy do szybkiego automatycznego połączenia wystawionych już aukcji na Allegro, z produktami które dodane są do sklepu.

Funkcjonalność ta idealnie sprawdza się w przypadku gdy sprzedajemy już na Allegro oraz sklepie internetowym, a dopiero zaczynamy korzystanie z integracji PrestaShop z Allegro od x13.pl.

Integracja jest w stanie automatycznie połączyć aukcję z produktami, które są dodane na sklepie na podstawie kilku parametrów. Podane parametry są ułożone według priorytetu łączenia - najważniejsze na samej górze.

Z Allegro pobieramy takiego parametry jak:

• EAN
• Kod producenta
• Sygnatura aukcji

Następnie szukamy produktów z takimi parametrami w PrestaShopie:

• EAN
• Kod referencyjny / Indeks

Moduł szuka powiązań na początku w atrybutach produktów, następnie w produktach płaskich (bez atrybutów), jeśli zostanie znaleziony pasujący parametr produkt zostaje automatycznie połączony.

Po zakończeniu procesu łączenia aukcji otrzymamy komunikat “Aktualizacja zakończona, odśwież stronę aby kontynuować.”.
Podczas procesu mogą pojawić się błędy (brak możliwości znalezienia aukcji) lub ostrzeżenia (aukcje już były powiązane), po zakończeniu procesu można wyświetlić wszystkie błędy lub ostrzeżenia - wybierając odpowiedni przycisk.

Następnie postępujemy zgodnie z powyższą informacją, czyli zamykamy okienko aktualizacji i odświeżamy stronę (aby zobaczyć realnie połączone aukcje).

Aktualizacja powiązania z Katalogiem Allegro (Produktyzacja)

Opcja Aktualizacja powiązania z Katalogiem Allegro (Produktyzacja), służy do powiązania już wystawionych aukcji z Katalogiem Allegro.
Przy skorzystaniu z tej opcji oprócz wyświetlenia informacji o produkcie na aukcji wraz z jego oceną możesz uzupełnić informację o parametrach produktu, jak i zmienić opis czy zdjęcia w aukcji. Wszystkie te opcje dostępne są w naszej integracji.

Będąc w zakładce Allegro Lista aukcji, możemy wybrać przycisk po prawej stronie Produktyzacja, następnie kliknąć przycisk Pokaż oferty, które mogą wymagać powiązania z Katalogiem Allegro, otrzymamy listę aukcji, którą można połączyć z produktami z katalogu Allegro.

Moduł pobiera kod EAN z produktu dodanego w PrestaShop, w przypadku gdy nie ma kodu EAN w produkcie integracja próbuje pobrać go z aktualnej aukcji Allegro. Następnie na jego postawie szuka produktów w Katalogu Allegro, jeśli taki produkt zostanie znaleziony, aukcja zostanie powiązana z pierwszym znalezionym produktem w katalogu.

Aukcje aktualizujemy w taki sam sposób jak w przypadku aktualizacji pozostałych informacji o aukcji, klikając po prawej Aktualizuj lub wybierając akcje masowe, wybieramy z rozwijanej listy opcji aktualizację Aktualizacja powiązania z Katalogiem Allegro (Produktyzacja).

• Zostaw własne - parametry aukcji nie zostaną zmienione
• Dopełnij własne parametry, parametrami z Katalogu - do już uzupełnionych parametrów na aukcji, zostaną dodane parametry z produktyzacji
• Użyj parametrów z Katalogu Allegro - wszystkie obecne parametry zostaną usunięte, następnie ustawione te z produktyzacji

Oprócz opcji uzupełniania parametrów mamy możliwość zaktualizowania tytułu i opisu aukcji.

W opcji Zdjęcia, mamy do wyboru:

• Nie aktualizuj zdjęć wg Katalogu Allegro - zdjęcia pozostaną nie zmienione, będą taki same jak przed połączeniem
• Użyj zdjęć z Katalogu Allegro (jeśli istnieją) - zdjęcia na aukcji zostaną zastąpione zdjęciami z katalogu, o ile te istnieją w bazie Allegro

W opcji Opis, mamy do wyboru:

• Nie aktualizuj opisu wg Katalogu Allegro - opis pozostanie nie zmieniony, będzie taki sam jak przed połączeniem
• Użyj opisu z Katalogu Allegro (jeśli istnieją) - opis na aukcji zostanie zastąpiony opisem z katalogu, o ile ten istnieje w bazie Allegro

W wybranych sytuacjach np. aktualizując tylko opis, Allegro może również dodać zdjęcie do aukcji, jeśli obrazek będzie znajdował się w opisie aukcji.

Uwaga: jeżeli zaktualizujemy opis albo zdjęcie dostarczonego przez Katalog Allegro, wypełnione wcześniej zdjęcia i opis zostaną bezpowrotnie usunięte z aukcji.

Więcej informacji o produktyzacji znajdziesz na tej stronie: https://allegro.pl/dla-sprzedajacych/kategoria/produktyzacja

Aktualizacja Parametrów

Opcja Aktualizacja Parametrów, służy do uzupełnienia/aktualizacji parametrów kategorii na wystawionych aukcjach.
Parametry kategorii pobierane są według powiązania kategorii w PrestaShop, w przypadku jeśli parametr uzupełniony jest na Allegro a nie jest uzupełniony w powiązaniu kategorii w module nigdy nie zostanie nadpisany oraz usunięty w aukcji.

Domyślnie mamy zaznaczoną opcję Pomiń aktualizacje jeżeli uzupełnione, powodująca pominięcie aktualizacji parametrów w aukcji które są już uzupełnione oraz możemy pobrać ich dane z powiązania kategorii z modułu.
Sugerujemy włączenie tej opcji jeśli przy wystawianiu akcji uzupełnianie są ręcznie wybrane parametry lub nie wszystkie parametry są prawidłowo zmapowane (muszą być edytowane podczas wystawiania aukcji).

Aktualizacja tytułu aukcji

Wybierając opcje Aktualizacja tytułu aukcji, możemy zmienić tytuł na zaznaczonych aukcjach.
Mamy do wyboru 3 opcje:

• ustawienie nowego tytułu - z możliwością skorzystania z dodatkowych znaczników
• dodanie frazy do tytułu - możesz dodać frazę przed lub po obecnym tytule aukcji
• zmiana fragment tytułu - wpisując frazę, którą chcesz zamienić w tytule aukcji na nową

• {product_name} - Nazwa produktu
• {product_name_attribute} - Nazwa atrybutu
• {product_reference} - Kod referencyjny produktu
• {product_price} - Cena produktu
• {product_id} - ID produktu
• {product_ean13} - Kod EAN13
• {product_short_desc} - Krótki opis
• {product_weight} - Waga produktu
• {manufacturer_name} - Nazwa producent
• {feature_X} - Nazwa i wartość cechy X (cecha musi być przypisana do produktu)
• {feature_value_X} - Wartość cechy X (cecha musi być przypisana do produktu)

UWAGA! Tytuł aukcji nie zostanie zmieniony na aukcjach, na których zostały już sprzedane przedmioty, jest to niemożliwe po stronie Allegro.

Aktualizacja opisu aukcji

Korzystając z opcji Aktualizacja opisu aukcji, możemy dodać/zmienić opis na wybranych aukcjach.
Wybierając opcję dodaj do opisu wskazujemy czy chcemy dodać opis przed czy po obecnym opisie aukcji.
W oknie edytora tekstowego dodajemy treść która zostanie dodana we wcześniej wybranym miejscu na aukcji, możemy do niej dodać pogrubienia, nagłówki wypunktowania itd. wg ograniczeń Allegro.

Kolejna opcja znajdzie i zamień jest bardzo przydatna jeśli chcemy masowo usunąć lub zamienić dany fragment opisu aukcji - bez całkowitej edycji opisu (aktualizacji szablonu).
Jeśli w swoich ofertach masz np. tekst który sugeruje kontakt poza serwisem w celu realizacji transakcji wykorzystując tę opcję błyskawicznie zamienisz go na nową treść lub go usuniesz.

W tej funkcjonalności dodaliśmy również obsługę wyrażeń regularnym, dzięki temu możesz np. usunąć każde zdanie, które zaczyna się od danego słowa - bądź ostrożny przy korzystaniu z tej funkcji, błędne wyrażenie może całkowicie popsuć opis Twojej oferty.

Funkcja aktualizacji opisu aukcji nie pobiera nowego opisu produktów/szablonów - zawsze działa na aktualnych danych pobranych bezpośrednio z aukcji.

Aktualizacja szablonów

Po wyborze Aktualizacja szablonów, mamy możliwość zaktualizowania wybranych ofert według aktualnych danych ze sklepu z wybranym szablonem.
Podczas aktualizacji szablonów mamy 2 pola do wyboru

• szablon aukcji wybierzesz tutaj jeden z wszystkich aktywnych szablonów aukcji utworzonych w module
• zdjęcia do szablonu określisz jakie zdjęcia chcesz dodać do szablonu:
  • wszystkie zdjęcia - według kolejności zdjęcia produktu + zdjęcia dodatkowe z zakładki modułu Allegro
  • pierwsze zdjęcie - zostanie przesłane tylko jedno zdjęcie, te które ustawione jest jako okładka produktu

UWAGA! Jeśli podczas wystawiania takiej oferty edytowałeś opis w opcji Edytuj opis produktu na podstronie wystawiania, przy aktualizacji szablonów taka zmiana zostanie nadpisana bieżącym opisem produktu.

Aktualizacja EAN

Opcja Aktualizacja EAN, służy do uzupełnienia/aktualizacji kodu EAN na aukcjach.
Parametr EAN pobierany jest według powiązania kategorii w PrestaShop, jeśli produkt nie jest powiązany z kategorią moduł pobierze automatycznie kod EAN, z pola EAN z PrestaShop.

W tej aktualizacji mamy domyślnie zaznaczoną opcję Pomiń aktualizacje jeżeli uzupełnione, powodująca pominięcie aktualizacji aukcji, w których jest już wpisany kod EAN.
Zalecamy pozostawienie włączonej tej opcji w przypadku uzupełniania ręcznie kodów EAN przy wystawianiu aukcji i nieuzupełnieniu ich w produktach w PrestaShop.

Aktualizacja sygnatury

Korzystając z opcji Aktualizacja sygnatury, dodasz, zmodyfikujesz lub usuniesz sygnaturę ze swoich ofert.
W module możesz wybrać kilka sposobów aktualizacji tego parametru:

• zaktualizuj według danych produktu (z obsługą pobierania danych dla konkretnego atrybutu produktu):
  • ID produktu
  • kod referencyjny (indeks)
  • kod kreskowy EAN-13
  • kod kreskowy UPC
• usuń sygnaturę

Aktualizacja jednostki

Wybieramy Aktualizacja jednostki, następnie zobaczymy wybór opcji jednostek dostępnych w Allegro.

• szt - sztuk
• kpl - kompletów
• par - par

Aktualizacja opcji faktury

Z listy wybieramy Aktualizacja opcji faktury, otrzymamy listę wszystkich opcji faktury (z automatycznym zaznaczeniem domyślnej opcji, według naszego profilu dostawy).

• faktura VAT
• faktura VAT marża
• faktura bez VAT
• nie wystawiam faktury

Aktualizacja stawki podatku VAT

Wybieramy opcję Aktualizacja stawki podatku VAT, następnie mamy dostępne takie opcje jak

• zaktualizuj według ustawień produktu (wartość podatku pobrana zostanie z przypisanego produktu w PrestaShop)
• wybierz stawkę Vat
  • 23%
  • 8%
  • 5%
  • 0%
• usuń stawkę VAT

Podatek zostanie zmieniony, jedynie na aukcjach z parametrem Opcja faktury: Faktura VAT., jeśli nie masz włączonej tej opcji, polecamy skorzystać z trybu aktualizacji opcje faktury.

Aktualizacja cennika dostawy

Po kliknięciu Aktualizacja cennika dostawy, otrzymujemy pole z wyborem wszystkich dodanych cenników na Allegro.pl.
Wybieramy z listy nowy cennik, a następnie przechodzimy do aktualizacji aukcji.

Aktualizacja czasu wysyłki

Po kliknięciu Aktualizacja czasu wysyłki, zobaczymy wszystkie dostępne na Allegro opcje czasu wysyłki (zaznaczona zostanie automatycznie domyślna opcja z konfiguracji modułu).
Z rozwijanej listy wybieramy odpowiednią opcję aktualizacji czasu od natychmiast do 60 dni, następnie zatwierdzamy aktualizacje.

Aktualizacja daty wysyłki (przedsprzedaż)

Po wyborze Aktualizacja daty wysyłki (przedsprzedaż), otrzymamy 2 opcje przedsprzedaży do wyboru:

• Nie - dla produktów, które nie są oferowane w przedsprzedaży
• Tak - z dodatkowym polem, w którym z kalendarza wybierzesz konkretny termin wysyłki produktu

Aktualizacja warunków oferty (zwrot/reklamacja/gwarancja)

Z listy wybieramy Aktualizacja warunków oferty (zwrot/reklamacja/gwarancja), następnie otrzymujemy 3 listy

• Warunki zwrotów
• Reklamacje
• Gwarancje

Aktualizacja cennika hurtowego

Po kliknięciu Aktualizacja cennika hurtowego, możesz:

• przypisać cennik hurtowy - w nowym polu cennik hurtowy zostaną wyświetlone wszystkie cenniki hurtowe dla danego konta, zdefiniowane na Allegro.pl
• usunąć cennik hurtowy z zaznaczonych aukcji

Aktualizacja tabeli rozmiarów

Korzystając z opcji Aktualizacja tabeli rozmiarów:

• przypiszesz tabelę rozmiarów - wybierajać w poniższym polu jedną z wcześniej zdefiniowanych tabel rozmiarów na Allegro.pl
• usuniesz tabelę rozmiarów z aukcji

Aktualizacja usług dodatkowych

Opcja Aktualizacja usług dodatkowych odpowiedzialna jest za:

• przypisanie grupy dodatkowych usług - w następnym polu wybierzesz jedną z grup usług wcześniej ustawionych na Allegro.pl
• usunięcie grupy dodatkowe z ofert

Zakup licencji

Moduł integracji PrestaShop z Allegro występuje w 3 licencjach:

• demo - 30 dni
• 1 rocznej
• dożywotniej (bez ograniczeń)

UWAGA !!! przy instalowaniu nowej paczki z modułem, nie usuwamy/odinstalowujemy poprzedniej wersji modułu - w takiej sytuacji dane zostaną usunięte.

Ponowna autoryzacja

W przypadku przekroczenia 365dni od pierwszej autoryzacji, wymagana będzie ponowna - która odświeży klucz .
Autoryzacja również może być wymagana przy problemach z Allegro/serwerem.

Ponowna autoryzacja przebiega bardzo podobnie do autoryzacji nowego konta.

Wybieramy zakładkę Allegro Konta po prawej stronie od konkretnego konta, klikamy w przycisk Autoryzuj

Przejdziemy na Allegro - tam wpisujemy swoje dane i potwierdzamy.
Jeśli wszystko przebiegnie pomyślnie, zostaniemy przekierowani na stronę modułu, i zobaczymy że pozostało nam 364 dni do końca aktywnego klucza

Jeśli mamy problem z błędem typowo na stronie Allegro, prosimy o sprawdzenie wszystkich uwag od adresu sklepu w aplikacji i w formie zalogowania się na panel sklepu - więcej informacji znajduje się w pkt konto

Przy autoryzacji wielu kont Allegro, obowiązują takie same zasady jak przy tworzeniu konto (polecamy wyczyścić cache przeglądarki oraz wylogowywać się z konta). Jeśli pojawi się błąd z autoryzacją prosimy sprawdzić uwagi z pkt Tworzenie konta.

Problemy i ich rozwiązania

Problem z dostępnością API Allegro

Zacznij od sprawdzenia informacji o dostępności API po stronie Allegro pod adrese https://api.allegrostatus.pl/

Odinstalowanie modułu

UWAGA !!! odinstalowanie modułu powoduje bezpowrotne usunięcie wszystkich ustawień, oraz powiązań produktów - jest to bezpowrotne usunięcie wszystkich danych.

Usunięcie konta

UWAGA !!! usunięcie konta, powoduje bezpowrotne usunięcie powiązań produktów.

Nigdy nie zalecamy usuwania konta w przypadku jakichkolwiek problemów z modułem.
Również odradzamy dodawanie kolejnego takiego samego konta, aukcje przypisywane są do ID konta w sklepie, a nie jego nazwy. Dodanie kolejnego takiego samego konta, nie przenosi na nie powiązań aukcji.

Biała strona po dodaniu modułu lub "Chińskie znaki" po dodaniu modułu

Brak zainstalowanego ionCube loader na serwerze - zobacz rozwiązanie, lub na serwerze nie jest ustawione PHP 5.4 - 7.2.

Błąd przy autoryzacji konta

X13Allegro API: Niepoprawna wartość klucza WebAPI lub kluz został zablokowany.
Rozwiązaniem jest sprawdzenie, czy mamy wpisany poprawny klucz WebAPI (typowo z Allegro.pl -> moje konto) nie z aplikacji.
Jeśli klucz jest poprawny a został zablokowany, musimy się zalogować na swoje konto z https://ssl.Allegro.pl/enter_login.php?captcha=1

Błąd przy autoryzacji konta - nie możemy wyświetlić strony

W przypadku wyświetlenie błędu "nie możemy wyświetlić strony" po kliknięciu autoryzuj, przekazywana jest niepoprawna domena do Allegro.

Należy sprawdzić wszystkie czerwone i pomarańczowe uwagi z pkt Konto (zobacz).
W szczególności, adres z jakiego się logujemy, główny adres sklepu, jak i adres wpisany w aplikacji (wszędzie muszą być takie same), jeśli chodzi o SSL/www (http://....m, www....)

Błąd przy autoryzacji konta - na serwerze hekko itd

Po kliknięciu autoryzuj otrzymuję błąd 403 w adresie.

Musimy dla plików w module x13allegro ustawić chmody na 644, oraz dla wszystkich folderów prawa na 755

Problem z wystawianiem MyDevil

Jeśli podczas wystawiania na serwerze MyDevil otrzymujemy błąd 403, musimy zmienić zabezpieczenia Web Application Firewall - poprzez wyłączenie go, problem zostaje rozwiązany.

Błąd 400 / 4002

W przypadku pojawienia się poniższego błędu:
Pojawiły się 2 błędy:
2 błędy

X13Allegro API: invalid_grant (REST_API: 400)
Odmowa dostępu

Musimy ponownie autoryzować konto, aby to zrobić przechodzimy do zakładki Allegro -> Konto i przy naszym koncie klikamy jeszcze raz Autoryzuj.

Nieprawidłowy kod dostępowy

Jeśli przy próbie wystawiania produktów, lub w przypadku nieimportowania zamówień do sklepu - w zakładce Allegro -> Wystaw widzimy błąd:
X13Allegro API: Nieprawidłowy kod dostępowy (ERR_INVALID_ACCESS_TOKEN).
Moduł nie pobrał poprawnie nowego TOKENU, zazwyczaj dzieje się tak w przypadku przywracania backupu, złego logowania na panel administracyjny.
Aby rozwiązać problem, przechodzimy do zakładki Allegro -> Konto i przy naszym koncie klikamy jeszcze raz Autoryzuj.

Problem przy wystawianiu aukcji

Jeśli podczas kliknięcia "wystaw aukcje", lub przy wejściu do mapowania kategorii otrzymamy:
Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 32 bytes) in /home/user/domains/domena.pl/public_html/modules/x13allegro/classes/XAllegroClass.php on line 0
Musimy zwiększyć pamięć RAM dla PHP - minimalnie do 256MB, zalecane jest 512MB.

Moduł nie wysyła zdjęć do Allegro.

Jeśli podczas wystawiania produktów na Allegro, otrzymujemy poniższy błąd:

X13Allegro API: Nie można pobrać obrazka z podanego adresu. Błąd połączenia. (REST_API: 422)

W przypadku gdy korzystamy z SSLa, musimy sprawdzić, czy certyfikat SSL został poprawnie zainstalowany, np. na stronie - https://www.sslshopper.com/ssl-checker.html. Gdy w którymś miejscu zobaczymy problem (czerwoną strzałkę), zalecamy zgłosić do administratora serwera sprawdzenie i poprawną konfigurację certyfikatu.

Kolejna możliwość, w której pojawia się powyższy problem to zablokowanie pobierania obrazków przez niestandardowego User-Agenta. W takim przypadku należy zezwolić na pobieranie obrazków przez User-Agenta o nazwie `Allegro-ImageDownloader/1.0`, robimy to w pliku htacess jako.

SetEnvIfNoCase User-Agent .*Allegro-ImageDownloader/1.0.* search_robot # SOAP/REST API

Moduł wystawia tylko kilka aukcji (2-3)

Moduł wystawia aukcje AJAXowo, jednak wysyła je po 5 sztuk.
W przypadku gdy na serwerze mamy ustawione execution_time na 30 sekund, a zdjęcia są duże może być to za krótki czas na wystawienie 5 aukcji. W tym wypadku polecamy zmienić czas na przynajmniej 300 sekund.

Problem z aktualizacją modułu

Moduł przy próbie aktualizacji po kliknięciu "KLIKNIJ TUTAJ", wyświetla komunikat "Aktualizacja nie powiodła się! Wystąpił problem podczas pobierania i wypakowywania plików nowej wersji. Skontaktuj się z dostawcą modułu. ".
Rozwiązaniem jest zalogowanie się na "moje konto" u nas na sklepie, pobranie najnowszej wersji modułu i wgranie nowej paczki z modułem (ZIP), i wgraniem jej na obecny moduł (bez odinstalowywania/wyłączania poprzedniej wersji modułu).

Moduł nie wyświetla kolejnych kategorii przy wystawianiu – xAllegro_token in not defined.

Jeśli przy wystawianiu nie działa wybór kategorii (nie ładują się kolejne poziomy kategorii), nie działa podgląd aukcji jak i nie można dodać poprawnie nowego szablonu – najprawdopodobniej został zainstalowany nowy szablon / zaktualizowany poprzedni i usunął podpięcie hooka od modułu Allegro.

Aby upewnić się czy jest to problem z odpięciem modułu z hooka, możemy uruchomić konsolę przeglądarki i w powinniśmy zobaczyć błąd ReferenceError: xAllegro_token is not defined.

Rozwiązaniem problemy jest ponowne ręcznie dodanie modułu do odpowiedniego zaczepu. Przechodzimy do Wygląd → Pozycje i klikamy po prawej na Przemieszczenie modułów

Po wykonaniu tych czynności problem nie powinien już występować

Brak informacji o aktualizacji w panelu PrestaShop

Na wybranych konfiguracjach serwerów może się nie wyświetlać informacja o aktualizacji modułu, pomimo jej dostępności.
W takim przypadku pobieramy moduł i wgrywamy manualnie.
Rozwiązaniem jest zalogowanie się na "moje konto" u nas na sklepie, pobranie najnowszej wersji modułu i wgranie nowej paczki z modułem (ZIP), i wgraniem jej na obecny moduł (bez odinstalowywania/wyłączania poprzedniej wersji modułu).

Wystąpiły następujące błędy - przy wystawianiu:

X13Allegro API: Element '{https://webapi.Allegro.pl/service.php}item': Missing child element(s). Expected is one of ( {https://webapi.Allegro.pl/service.php}fid, {https://webapi.Allegro.pl/service.php}fvalueString, {https://webapi.Allegro.pl/service.php}fvalueInt, {https://webapi.Allegro.pl/service.php}fvalueFloat, {https://webapi.Allegro.pl/service.php}fvalueImage, {https://webapi.Allegro.pl/service.php}fvalueDatetime, {https://webapi.Allegro.pl/service.php}fvalueDate, {https://webapi.Allegro.pl/service.php}fvalueRangeInt, {https://webapi.Allegro.pl/service.php}fvalueRangeFloat, {https://webapi.Allegro.pl/service.php}fvalueRangeDate ).(Sender)
Problem pojawia się przy stosowaniu wczesnych wersji PHP 7.0, polecamy zaktualizować PHP do min 7.0.14

Moduł nie importuje zamówień do sklepu

W sytuacji gdy mamy wgrany moduł, ustawione opcje importu jak i zaimportowane kategorie czeka Nas ostatni krok.
Jest to utworzenie zadania CRON, dzięki któremu import będzie działał całkowicie automatycznie - w myśl zasady "uruchom i zapomnij"

Prawidłowe ustawienie jest bardzo istotne do automatycznego importu jak i aktualizacji produktów.

4. Nieprawidłowo ustawiona aktywność aukcji

W skrajnych sytuacjach moduł może nieprawidłowo oznaczyć aukcje w bazie danych, aukcja zostanie ustawiona jako zakończona, przez co moduł nie będzie aktualizował ilości czy też cen w takiej aukcji.

Rozwiązaniem tego problemu jest przejście do zakładki Allegro -> Konfiguracja, następnie na samym dole strony klikamy w przycisk Wymuś stan aukcji wg Allegro, czekamy aż wszystkie aukcje zostaną przetworzone. Proces może zając nawet kilkanaście minut w przypadku bardzo dużej ilości aukcji.

Moduł nie importuje poprawnie podatku dla dostawców

Moduł importuje cenę dostawy przekazaną z Allegro zawsze jako cenę brutto.
Bez przypisania Dostawcy z PrestaShop z opcją wysyłki z Allegro będzie to cena bez ustawionego podatki - widoczne np na pro-formie lub przy imporcie do zewnętrznych programów fakturujących.
Rozwiązaniem jest przypisanie danego dostawcy z Allegro do opcji wysyłki z PrestaShop (wtedy podatek będzie wybierany wg ustawień danego przewoźnika). Powiązać dostawców możemy w zakładce Allegro -> Przewoźnicy i przy każdym z nich wybierając odpowiedni sposób dostawy z naszego sklepu (lub najbardziej zbliżony).

Podwójny koszt płatności

W przypadku gdy w zamówieniach widzimy podwójną płatność za zamówienie, zaczynamy od sprawdzenia czy statusy które tworzy moduł nie zostały edytowane.

Faktura może być ustawiona tylko i wyłącznie dla:
Allegro - płatność przy odbiorze (COD)
Allegro - płatność zaakceptowana
Allegro - płatność zaakceptowana (nadpłata)

Brak wyświetlania opcji dostawy

Jeśli korzystają Państwo z hostingu nazwa.pl, i nie wyświetlają się wcale opcje dostawy.
Należy poprosić administratora o zmianę parametru 'max_allowed_packet' na min 64M - przy kolejnej aktualizacji pkt kontrolnych, poprawnie pobiorą się przewoźnicy.