Dokumentacja - Integracja Allegro z PrestaShop

Instrukcja instalacji i obs艂ugi modu艂u integracji PrestaShop z Allegro od X13.pl
1.7.X  1.6.X  1.5.X 
6.0.7 / 2019-09-20
zobacz changelog

Podczas tworzenia integracji PrestaShop z Allegro, starali艣my si臋 zrobi膰 wtyczk臋 jak najbardziej intuicyjn膮. Jednocze艣nie oszcz臋dzaj膮c膮 jak najwi臋cej czasu przy wystawianiu aukcji z naszego sklepu na allegro.

Poni偶sza instrukcja u偶ytkowania modu艂u przydatna b臋dzie zar贸wno dla os贸b kt贸re zaczynaj膮 swoj膮 prac臋 z naszym dodatkiem, jak i chc膮 szybciej i sprawniej wystawia膰 aukcj臋 na portal Allegro.

Wymagania instalacyjne

Modu艂 wymaga kilku podstawowych us艂ug na serwerze, kt贸re w wi臋kszo艣ci przypadk贸w s膮 aktywne.

  1. PHP: 5.4 (minimalnie) - 7.3
  2. ionCube: tak
  3. SOAP: tak
  4. openSSL: tak
  5. mbstring: tak
  6. cURL: tak
  7. protok贸艂 TLS: 1.1 (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: X13Allegro
  2. Opis: Integracja z Allegro.pl
  3. Autor: x13.pl
  4. Kategoria: Rynek
  5. Filtruj po: Zainstalowane i nie zainstalowane / Aktywne i nie aktywne

Aktualizacja

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

Aby zacz膮膰 korzysta膰 z modu艂u musimy doda膰 nowe konto .
Wybieramy zak艂adk臋 Allegro Konta i klikamy (dodaj nowe)

Przed dodaniem samego konta rejestrujemy aplikacj臋 w Rest API.

Rejestrujemy aplikacj臋 na stronie https://apps.developer.allegro.pl/ loguj膮c si臋 swoim kontem z Allegro.
Lub w przypadku korzystania z konta w opcji Sanbox na stronie https://credentials-sandbox.allegroapi.io/.
W nazwie aplikacji wpisujemy np.: Integracja sklepu z Allegro
W adresie aplikacji podajemy adres naszego sklepu (znajduje si臋 on te偶 w zak艂adce Allegro Konta) czyli np. http://domena.pl/


Je艣li adres twojego sklepu to www.domena.pl to wpisujemy go z WWW np: http://www.domena.pl/ je艣li adres w opcjach SEO jest ustawiony na domena.pl to wpisujemy http://domena.pl/


Je艣li korzystamy z certyfikatu SSL to wpisujemy https://domena.pl/ lub https://www.domena.pl/ w przypadku ustawienia domeny z www


艁膮czymy si臋 z panelem PrestaShop z dok艂adnie takiego samego adresu jak mamy wpisane w opcjach SEO, jak i z https je艣li mamy certyfikat SSL.
Czyli np https://domena.pl/panel-sklepu/, oczywi艣cie w samej aplikacji ma by膰 wpisane tylko https://domena.pl/


Przy autoryzacji wielu kont allegro, musimy po ka偶dym koncie z autoryzowanym wylogowa膰 si臋 z allegro, strony aplikacji.
Idealnym rozwi膮zaniem jest autoryzowanie kont na wielu czystych przegl膮darkach.


Po utworzeniu konta, wracamy do zak艂adki Allegro Konta, i zaczynamy uzupe艂nia膰 profil.

Nazwa u偶ytkownika 鈥 nazwa naszego u偶ytkownika w allegro
Client IDClient ID / WebAPI key wygenerowane w aplikacji - Rest API
Client SecretClient Secret wygenerowane w aplikacji - Rest API
do tego mo偶emy ustawi膰 opcj臋 takie jak :
Sanbox 鈥 czyli je艣li jest to konto w trybie testowym na portalu sanboxallegro
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 - 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

Po klikni臋ciu Potwierd藕 konto, w przypadku poprawnie uzupe艂nionych danych zostaniemy przekierowaniu do panelu administracyjnego naszego sklepu. Zobaczymy tam informacj臋 o aktywno艣ci klucza (354dni) - jest to ilo艣膰 dni po kt贸rej musimy ponownie autoryzowa膰 konto (nie ma to zwi膮zku z ilo艣ci膮 dni do ko艅ca licencji).

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.

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.


Poni偶ej mo偶na zobaczy膰 r贸偶nic臋 w wygl膮dzie wystawiania tego samego produktu, wed艂ug nowego szablonu allegro.

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 opcko 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膮zanie kategorii

tekst w trakcie przygotowywania

P艂atno艣膰 i dostawa

W zak艂adce Allegro P艂atno艣膰 i dostawa mo偶emy zdefiniowa膰 wiele cennik贸w kt贸re b臋dziemy mogli wybra膰 automatycznie przy wystawianiu aukcji.
Nie musimy dodawa膰 wcze艣niej cennik贸w, jednak zaoszcz臋dzi nam to sporo czasu przy kolejnym wystawianiu aukcji.


Ceny dla wybranych us艂ug (Allegro MiniPaczka InPost, Allegro Paczkomaty InPost oraz Alegro Kurier InPost) nie mog膮 by膰 wy偶sze ni偶 wymagane przez allegro: http://faq.allegro.pl/artykul/37179/co-jest-dostawa-allegro-inpost

Mo偶emy dodawa膰 wiele wybor贸w opcji p艂atno艣ci i dostawy, 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.

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.

Ustawienia

tekst w trakcie przygotowywania

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偶emy zwi臋kszy膰 cz臋stotliwo艣膰 do "co 3 minuty".

/usr/bin/lynx --dump "http://domena.pl/modules/x13allegro/sync.php?token=XXXXXX" >/dev/null 2>&1 

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艂a by 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

Zakup licencji

Modu艂 integracji PrestaShop z Allegro wyst臋puje w 3 licencjach:

  • demo - 30 dni
  • 1 rocznej
  • do偶ywotniej (bez ogranicze艅)
W ka偶dej z tych opcji, modu艂 ma identyczn膮 funkcjonalno艣膰 r贸偶ni si臋 jedynie czasem przez jaki mo偶e by膰 wykorzystywany.
W przypadku zmiany licencji, np z wersji demo na do偶ywotni膮, musimy kupi膰 modu艂 w wybranej licencji.
Po op艂aceniu zam贸wienia, otrzymamy plik z modu艂em w formacie .zip, pobieramy go na komputer i instalujemy jak ka偶dy inny modu艂.
W takiej sytuacji wszystkie dane wprowadzone wcze艣niej w module, po艂膮czenie aukcji itd b臋d膮 przeniesione.
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

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 zalecamu 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艂臋d贸w

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 nie importowania zam贸wie艅 do sklepu - w zak艂adce Allegro -> Wystaw widzimy b艂膮d:
X13Allegro API: Nieprawid艂owy kod dost臋powy (ERR_INVALID_ACCESS_TOKEN).
Integracja Allegro z PrestaShop - Nieprawid艂owy kod dost臋powy 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 sprwadzi膰 czy certyfikat SSL zosta艂 poprawnie zainsatlowany, 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 serwra sprawdzenie i poprwan膮 konfiguracj臋 certefikatu.

Kolejna mo偶liwo艣膰 w kt贸rej pojawia si臋 powy偶szy problem to zablokowanie pobierania obrazk贸w przez niestatndardowego 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 5aukcji. 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).

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.

Modu艂 nie aktualizuje ilo艣ci produkt贸w na allegro / w sklepie

1. Brak dodanego zadania CRON na serwerze

W sytuacji gdy mamy wgrany modu艂, ustawione opcje, dodane konto oraz wystawione lub powi膮zane aukcje - musimy upewni膰 si臋 偶e mamy dodane zadanie CRON na serwerze.
Wi臋cej informacji o poprawnym ustawieniu zadania CRON dla modu艂u allegro znajd膮 Pa艅stwo - tutaj.

2. Problem z ustawieniem aukcji jako zamkni臋ta w bazie danych

W skrajnych przypadkach korzystaj膮c z modu艂u przed pa藕dziernikiem 2019 roku istnieje mo偶liwo艣膰, w kt贸rej modu艂 niepoprawnie oznaczy艂 aukcj臋 jako zamkni臋t膮 w bazie danych.
Je艣li aukcja jest zamkni臋ta w bazie danych, modu艂 nie aktualizuje w niej 偶adnych danych, ilo艣ci cen itd.
Na wybranych konfiguracjach serwra m贸g艂 pojawi膰 si臋 taki b艂膮d, dlatego dodali艣my przycisk kt贸ry naprawia realne zamkni臋cie bazy danych w sklepie.

3. Problem z nie aktualizowaniem si臋 ilo艣ci / cen na wybranych aukcjach.

Rozwi膮zanie sugerowane jest w przypadku problemu z aktualizacj膮 ilo艣ci lub cen tylko i wy艂膮cznie na wybranych aukcjach - nie rozwi膮zuje on problemu ca艂kowitego braku aktualizacji tych parametr贸w.
Od wersji modu艂u 6.X zmienili艣my spos贸b aktualizowania cen i ilo艣ci za pomoc膮 REST API, metoda z kt贸rej korzystamy wymusza aby aukcja mia艂a poprawnie wpisane wszystkie wymagane parametry - cechy kategorii.
Je艣li kt贸ry艣 z wymaganych parametr贸w nie b臋dzie uzupe艂niony, nie mamy technicznie mozliwo艣ci edycji ich ilo艣ci i cen.

Rozwi膮zaniem problemu z takimi aktualizacjami jest uzupe艂nienie brakuj膮cych parametr贸w, list臋 aukcji kt贸ra wymaga zmian znajdziemy na koncie allegro.
Logujemy si臋 na swoje konto na www.allegro.pl, przechodzimy do zak艂adki Moja Sprzeda偶, nast臋pnie Uzupe艂nij parametry nowo艣膰

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

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.

Video