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.4 (z wykluczeniem 8.0)
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 aktualizacje, 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 przypadków 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 zmigrowane 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 UPGRADE
• 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łniamy 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 zautoryzowane, 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ć, jakie mają być aktywne, a które z nich ma być domyślne.

Przy autoryzacji wielu kont Allegro obowiązują takie same zasady jak przy tworzeniu konta (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

Kolejnym krokiem do korzystania z modułu, jest dodanie szablonu Allegro.

Wybieramy zakładkę Allegro Szablony i klikamy (dodaj nowe)

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ć jakie mają być aktywne, a który 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 oraz 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, producent 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 – otworzy się okno do mapowania.

Przy Wartość z Allegro – Waga rozwijamy listę z tabeli Atrybut/Cecha/Producent i wybieramy Wartość produktu, a następnie Waga opakowania i zapisujemy.

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 przykładu zmapujemy Rozmiar S, M i L – wybieramy odpowiadające atrybuty ze sklepu i zapisujemy zmiany.

4. Mapowanie wartości atrybutu/cechy z domyślną wartością

Zmapujemy materiał z realnymi materiałami (cechami) z naszego sklepu, a w przypadku jego braku ustawimy parametr Inny – przez Ustaw domyślną wartość parametru.

5. Automatyczne mapowanie kodu EAN / ISBN

Korzystając z naszego modułu możemy automatycznie uzupełniać kody EAN i ISBN przy wystawianiu aukcji. Przechodzimy do Allegro Konfiguracja i włączamy opcję Używaj kodu EAN13 w aukcjach.

Wszystkie opisane opcje mapowania działają również z atrybutami, oraz działają przy masowym wystawianiu produktów – zobacz 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 to Powiązanie kategorii – automatyczny wybór kategorii w Allegro na podstawie domyślnej kategorii produktów.
Wybierz odpowiednie kategorie – przyspieszy to wystawianie (kategoria i zmapowane parametry wczytają się automatycznie).

Płatność i dostawa

Dodanie profilu dostawy

Jeśli mamy już dodane konto, kolejnym krokiem będzie dodanie Profilu dostawy – zestawu informacji o lokalizacji firmy, fakturze oraz czasie dostawy.
Aby dodać nowy profil dostawy przechodzimy do Allegro Ustawienia dostawy, następnie na górze po prawej klikamy Dodaj nowy profil dostawy i ustawiamy go według preferencji.

W przypadku braku przynajmniej jednego profilu dostawy nie będziemy mieli możliwości wystawienia aukcji – pojawi się błąd: 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

W zakładce Allegro Ustawienia dostawy znajdziesz listę cenników przypisanych do konta Allegro.
Jeśli cenniki istnieją na Allegro, zostaną automatycznie wczytane. Możesz też utworzyć nowy cennik – Dodaj nowy cennik – i wybrać obsługiwane usługi.

Przy dodawaniu cen pamiętaj, że wybrane usługi (np. Allegro MiniPaczka InPost, Allegro Paczkomaty InPost, Allegro Kurier InPost) nie mogą być wyższe niż wymagane przez Allegro.

Edycja cennika dostawy

Edycja (nazwa, ceny, usługi) zmienia ustawienia na wszystkich aukcjach korzystających z tego cennika.

Usuwanie cennika dostawy

Usunięcie cennika po stronie Allegro nie jest możliwe z poziomu integracji (ograniczenie Allegro). Każdy profil/cennik przypisany jest do jednego konta. Możesz dodać wiele cenników i wybierać je przy wystawianiu.

Statusy zamówień

W opcji Allegro Statusy zamówień możemy ustawić jaki status 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 zamówienia w PrestaShop.

Automatyczne wysyłanie nr przewozowego

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

Wybieramy Allegro Powiązanie przewoźników – lista przewoźników z Allegro. Przy każdym wybieramy Przewoźnik w Twoim sklepie oraz Operator numeru śledzenia w Allegro.

Po prawidłowym uzupełnieniu numeru na zamówieniu integracja wyśle go do Allegro podczas pierwszej poprawnej synchronizacji CRON. Można też wysłać ręcznie w Allegro Numery śledzenia Allegro klikając Wyślij numery śledzenia.

Lista aukcji

W Allegro Lista aukcji otrzymujemy listę sprzedawanych / sprzedanych / niesprzedanych aukcji dla danego konta. Możemy edytować trwające aukcje oraz przypisywać aukcje z Allegro do produktów w PrestaShop.

Zmiana Ilości lub Ceny – klikamy Edytuj aukcje (także masowo).

Jeśli aukcje były wystawione poza integracją – nie będą się aktualizować. Można je powiązać z produktami: Przypisz i wybieramy produkt (oraz atrybut, jeśli dotyczy). Po przypisaniu aukcja będzie importowana do zamówień, a ilości aktualizowane (o ile opcje są włączone).

Wystawianie aukcji - zaawansowane

Indywidualne cechy

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

W związku z nowym mapowaniem atrybutów i cech zrezygnowaliśmy z kopiowania cech do produktów w poprzedniej formie. Teraz ustawiamy spójne cechy w globalnych, a różnice w „indywidualnych”.

Indywidualne dane produktu

Indywidualne parametry ustawiamy w Katalog Produkty → edycja produktu. W PS 1.6: zakładka X13Allegro. W PS 1.7: zakładka Moduły → Konfiguruj przy X13Allegro.

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

Indywidualne ceny na Allegro dla konkretnego produktu

Możesz ustawić globalny narzut lub indywidualne ceny (które nie dziedziczą narzutu). Dla wszystkich kont lub wybranego konta. Tryby: cena końcowa, wpływ kwotowy, wpływ procentowy. Dla produktu lub wybranych kombinacji.

Jak ustawić indywidualną cenę?

PS 1.7: Produkt → zakładka Moduły → Allegro → Konfiguruj.
PS 1.6: Produkt → zakładka X13allegro.

W dziale Ceny indywidualne wybieramy zakres (wszystkie konta / wybrane konto), ewentualnie kombinację i zapisujemy przyciskiem Zapisz ustawienia Allegro. Aktualizacja cen działa automatycznie (o ile włączona). Uwaga: podanie „ceny końcowej” 19.99 przy włączonym zaokrąglaniu zostawi 19.99.

Ustawienia

Ustawienia CRON - automatyczne pobieranie zamówień

Aby moduł zaczął pobierać zamówienia i aktualizować ilości, dodajemy zadanie CRON na serwerze.

Wywołujemy co 5 minut

Przy dużej skali – nawet co 3 minuty.

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

Zamiast XXXXXX wpisujemy poprawny indywidualny token – pełny link w Allegro Konfiguracja, na dole w boksie „Synchronizacja”.

Jak dodać zadanie CRON na serwerze?
Powyższy przykład jest dla DirectAdmin. Szczegóły i inne panele: tutaj.

Synchronizacja ilości

Moduł pomniejsza stany przed finalnym utworzeniem zamówienia (aby uniknąć podwójnej sprzedaży). Zamówienia z Allegro importują się bez zmiany ilości w produktach – zabezpieczenie przed wielokrotnym uzupełnianiem formularza pozakupowego.

Import zamówień

Warunki importu:

• produkt jest wystawiony lub zmapowany z aukcją Allegro
• w module opcja Importuj zamówienia z Allegro = TAK
• CRON poprawnie ustawiony (awaryjnie można wywołać link synchronizacji ręcznie)
• zamówienie ma uzupełniony poprawnie formularz pozakupowy

Aktualizacja ceny

Aktualizacja cen na wystawionych aukcjach

Włącz w Allegro Konfiguracja → Aktualizuj ceny na Allegro (nie aktualizuj / pełna / tylko w górę / tylko w dół). Indywidualne wyjątki ustawisz w edycji produktu.

Aktualizacja aukcji na Allegro

Integracja umożliwia masowe aktualizacje już wystawionych aukcji (wystawione z modułu lub powiązane).

Aby aktualizować: Allegro Lista aukcji → zaznacz aukcje → Działania masowe → Aktualizuj wybrane lub przycisk Aktualizuj przy aukcji.

Uwaga: ceny i ilości aktualizują się automatycznie z CRON – preferencje w Allegro Konfiguracja.

Proces (dla każdej opcji podobny)

1. Zaznacz aukcje (checkboxy).
2. Wybierz akcję z listy.
3. Potwierdź Aktualizuj aukcje.
4. Obserwuj pasek postępu i Dziennik zdarzeń.
5. Po zakończeniu: komunikat Aukcje zakończone.

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

Automatyczne łączenie wystawionych aukcji z produktami według EAN, kodu producenta, sygnatury aukcji → szuka w PrestaShop EAN / kod referencyjny (najpierw w atrybutach, potem w produktach).

Aktualizacja powiązania z Katalogiem Allegro (Produktyzacja)

Powiązanie z produktem z katalogu po EAN. Tryby parametrów: Zostaw własne / Dopełnij / Użyj z Katalogu. Opcjonalna aktualizacja tytułu, opisu i zdjęć z katalogu.

Uwaga: aktualizacja opisu/zdjęć z Katalogu nadpisze dotychczasowe.

Więcej: Produktyzacja na Allegro

Aktualizacja parametrów

Uzupełnianie/aktualizacja parametrów wg powiązań kategorii. Domyślnie włączone „Pomiń aktualizacje jeżeli uzupełnione”.

Aktualizacja tytułu aukcji

Ustaw nowy tytuł (ze znacznikami), dodaj frazę przed/po lub „znajdź i zamień”. Dostępne znaczniki: {product_name}, {product_name_attribute}, {product_reference}, {product_price}, {product_id}, {product_ean13}, {product_short_desc}, {product_weight}, {manufacturer_name}, {feature_X}, {feature_value_X}.

Uwaga: Allegro nie pozwala zmienić tytułu, jeśli w ofercie były już sprzedaże.

Aktualizacja opisu aukcji

Dodaj przed/po opisie lub „znajdź i zamień” (obsługa wyrażeń regularnych – ostrożnie). Działa na aktualnym opisie z aukcji (nie pobiera nowego szablonu).

Aktualizacja szablonów

Wybierz szablon oraz zakres zdjęć (wszystkie / pierwsze). Uwaga: jeśli edytowałeś opis pojedynczej oferty przy wystawianiu, zostanie on nadpisany bieżącym opisem produktu.

Aktualizacja EAN

Uzupełnia EAN wg powiązania kategorii, a gdy go brak – z pola EAN w produkcie. Domyślnie „Pomiń jeżeli uzupełnione”.

Aktualizacja sygnatury

Z danych produktu (ID, referencja, EAN-13, UPC) lub usuń sygnaturę.

Aktualizacja jednostki

Dostępne: szt, kpl, par.

Aktualizacja opcji faktury

Wybór: faktura VAT, VAT marża, bez VAT, nie wystawiam faktury.

Aktualizacja stawki podatku VAT

Z produktu lub wybór: 23%, 8%, 5%, 0% lub usuń. Zmiana działa, gdy „Opcja faktury” = „Faktura VAT”.

Aktualizacja cennika dostawy

Wybierz nowy cennik (lista z Allegro) i zaktualizuj.

Aktualizacja czasu wysyłki

Wybór czasu od „natychmiast” do „60 dni”.

Aktualizacja daty wysyłki (przedsprzedaż)

Opcje: Nie lub Tak z wyborem daty.

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

Wybór warunków (domyślne wg konta). Możesz ustawić „nie zmieniaj”. W gwarancji dostępne „usuń gwarancję”.

Aktualizacja cennika hurtowego

Przypisz cennik hurtowy (lista z Allegro) lub usuń.

Aktualizacja tabeli rozmiarów

Przypisz tabelę (lista z Allegro) lub usuń.

Aktualizacja usług dodatkowych

Przypisz grupę usług (lista z Allegro) lub usuń.

Zakup licencji

Moduł występuje w 3 licencjach:

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

Funkcjonalność identyczna – różni się czasem użycia. Przy zmianie licencji (np. demo → dożywotnia) kup nową licencję, pobierz .zip i zainstaluj jak zwykły moduł. Dane (połączenia, aukcje) zostaną zachowane.

UWAGA! Nie odinstalowuj poprzedniej wersji modułu przed wgraniem nowej paczki – stracisz dane.

Ponowna autoryzacja

Po 365 dniach od pierwszej autoryzacji wymagane jest jej odnowienie (lub przy problemach). Przebieg jak przy nowym koncie: Allegro Konta → Autoryzuj.

Po powodzeniu zobaczysz, że pozostało 364 dni do końca ważności klucza.

Jeśli problem dotyczy błędów po stronie Allegro – sprawdź adresy i uwagi z sekcji Konta.

Przy autoryzacji wielu kont – te same zasady co przy tworzeniu konta (wyczyść cache, wyloguj się). Gdy błąd – sprawdź uwagi z pkt Tworzenie konta.

Problemy i ich rozwiązania

Problem z dostępnością API Allegro

Sprawdź status API: https://api.allegrostatus.pl/

Odinstalowanie modułu

UWAGA! Odinstalowanie usuwa bezpowrotnie wszystkie ustawienia oraz powiązania produktów.

Usunięcie konta

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

Nie zalecamy usuwania konta ani dodawania kolejnego takiego samego – aukcje przypisywane są do ID konta (nie nazwy).

Biała strona lub „chińskie znaki” po dodaniu modułu

Brak ionCube loader lub nieobsługiwane PHP. Zobacz: rozwiązanie.

Błąd przy autoryzacji konta

X13Allegro API: Niepoprawna wartość klucza WebAPI lub klucz został zablokowany. Sprawdź poprawność klucza z Allegro (nie z aplikacji). Jeśli zablokowany – zaloguj się przez https://ssl.allegro.pl/enter_login.php?captcha=1.

Błąd „nie możemy wyświetlić strony” przy autoryzacji

Niepoprawna domena przekazywana do Allegro. Sprawdź uwagi z Konta (adres logowania, główny adres sklepu, adres w aplikacji – spójność http/https/www).

Błąd 403 (np. hekko)

Ustaw uprawnienia: pliki 644, katalogi 755 (w module x13allegro).

Problem z wystawianiem (MyDevil)

Błąd 403 – wyłącz Web Application Firewall w panelu.

Błąd 400 / 4002

X13Allegro API: invalid_grant (REST_API: 400) – odmowa dostępu. Ponownie autoryzuj konto: Allegro → Konto → Autoryzuj.

Nieprawidłowy kod dostępowy

X13Allegro API: ERR_INVALID_ACCESS_TOKEN – ponownie autoryzuj konto: Allegro → Konto → Autoryzuj.

Problem przy wystawianiu aukcji

Fatal error: Allowed memory size… – zwiększ pamięć RAM PHP min. do 256 MB (zalecane 512 MB).

Moduł nie wysyła zdjęć do Allegro

X13Allegro API: Nie można pobrać obrazka z podanego adresu. Błąd połączenia. (REST_API: 422)
Sprawdź poprawność instalacji SSL (np. SSL Checker). Ewentualnie zezwól na User-Agent: Allegro-ImageDownloader/1.0 w .htaccess:

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

Moduł wystawia tylko kilka aukcji

Wysyłka po 5 sztuk AJAX-em. Przy max_execution_time=30 s i dużych obrazach może być za mało – ustaw ~300 s.

Edycja zamówienia lub przewoźnika powoduje błędne kwoty w zamóweniu

W przypadku PrestaShop 1.7.X oraz wyżej jeśli edytujesz zamówienie i zmienisz przewoźnika koszt dostawy zostanie przeliczony ponownie - więc koszt zamówienia z Allegro zostanie nadpisany na ustawienie przewoźnika.
> Aby rozwiązać ten problem przejdź do Preferencje > Zamówienia i wyłącz opcje Ponownie przelicz koszty wysyłki po edytowaniu zamówienia.

Problem z aktualizacją modułu

Komunikat „Aktualizacja nie powiodła się…” – zaloguj się na konto w sklepie x13, pobierz najnowszą wersję i wgraj .zip na istniejący moduł (bez odinstalowywania).

Nie ładują się kategorie / token is not defined

Błąd ReferenceError: xAllegro_token is not defined. – brak hooka lub moduł jest wyłączony.
Upewnij się że moduł Allegro jest włączony - jeśli tak przejdź doponiższego kroku.
Dodaj moduł do hooka displayBackOfficeHeader (Wygląd → Pozycje → Przemieszczenie modułów → x13Allegro → przenieś do displayBackOfficeHeader).

Brak informacji o aktualizacji w PS

Na niektórych serwerach info o aktualizacji się nie pojawia. Pobierz moduł ręcznie i wgraj .zip na istniejący.

Błędy przy wystawianiu (wczesne PHP 7.0)

Problem znany – zaktualizuj PHP do min. 7.0.14.

Moduł nie importuje zamówień

Upewnij się, że CRON jest poprawnie ustawiony (to klucz do automatyki).

Podatek dla dostawców

Cena dostawy z Allegro importowana jest brutto. Aby mieć poprawny VAT w dokumentach, powiąż przewoźników Allegro z przewoźnikami w PrestaShop (sekcja Przewoźnicy).

Podwójny koszt płatności

Sprawdź, czy statusy nie zostały edytowane. Faktura może być ustawiona tylko dla: „Allegro - płatność przy odbiorze (COD)”, „Allegro - płatność zaakceptowana”, „Allegro - płatność zaakceptowana (nadpłata)”.

Brak wyświetlania opcji dostawy (nazwa.pl)

Poproś administratora o podniesienie max_allowed_packet do min. 64M (wpływa na pobieranie przewoźników).