OfferSync - integracja Prestashop z Allegro
Kod produktu: offersync-pres
Moduł, który integruje Twój sklep na Prestashop z marketplace Allegro poprzez API. Synchronizuje stany. System dba o ciągłą, dwukierunkową synchronizację stanów magazynowych oraz cen.
Zarządzaj ofertami z jednego miejsca
Moduł integracji PrestaShop z Allegro pozwala przygotować dane produktu w sklepie, połączyć je z kategoriami i parametrami Allegro, a następnie utworzyć lub zaktualizować ofertę bez ręcznego przepisywania wszystkich informacji.
Integracja korzysta z oficjalnego Allegro REST API i autoryzacji OAuth. Dane produktu, cena, opis, zdjęcia, kategoria, parametry oraz warunki sprzedaży są składane w kompletną ofertę wysyłaną do Allegro.
Moduł został przygotowany przede wszystkim z myślą o sprzedaży produktów cyfrowych i licencjonowanego oprogramowania, ale jego mechanizm tworzenia ofert może obsługiwać również inne produkty posiadające prawidłowo skonfigurowane dane.
Najważniejsze możliwości
tworzenie nowych ofert Allegro i aktualizowanie istniejących ofert,
mapowanie kategorii PrestaShop -- Allegro,
mapowanie atrybutów PrestaShop -- Allegro,
mapowanie parametrów produktu i oferty,
obsługa parametrów wymaganych,
obsługa wartości słownikowych,
przekazywanie numeru EAN,
publikowanie ceny produktu,
uwzględnianie aktywnej ceny promocyjnej,
opcjonalny narzut ceny dla konta sprzedawcy Allegro,
wysyłanie galerii zdjęć,
wybór zdjęcia głównego aukcji,
własny szablon opisu Allegro,
oddzielny opis SEO dla marketplace,
wybór cennika dostaw,
wybór warunków zwrotów i reklamacji,
ustawienie czasu dostawy,
ustawienie stanu dostępnego na aukcji,
zapisywanie numeru i adresu utworzonej oferty,
czytelna diagnostyka brakujących ustawień,
pobieranie opłaconych zamówień
Tworzenie i aktualizowanie ofert
Przy pierwszej publikacji moduł tworzy nową ofertę typu „Kup teraz”. Identyfikator utworzonej oferty jest zapisywany przy produkcie. Przy kolejnej publikacji moduł rozpoznaje, że produkt posiada już ofertę, i wykonuje jej aktualizację.
Dzięki temu zmiana opisu, ceny czy zdjęć nie tworzy przypadkowo kolejnej aukcji tego samego produktu.
Przed wysłaniem danych moduł sprawdza, czy produkt posiada:
aktywne połączenie z kontem Allegro,
kategorię powiązaną z Allegro,
aktywną cenę,
komplet wymaganych parametrów,
cennik dostaw,
warunki zwrotów,
warunki reklamacji.
Jeżeli któregoś elementu brakuje, administrator otrzymuje konkretny komunikat zamiast ogólnego błędu publikacji.
Kategorie PrestaShop i Allegro
Kategorie obu systemów nie mają identycznej struktury. Dlatego przed pierwszą publikacją należy powiązać kategorię sklepu z właściwą kategorią końcową Allegro.
Moduł pobiera aktualne drzewo kategorii z API. Administrator przechodzi przez jego poziomy i wybiera kategorię odpowiadającą sprzedawanemu produktowi.
Powiązanie zapisuje się raz i może być później używane przez wszystkie produkty należące do danej kategorii sklepu. Jeżeli produkt posiada kilka kategorii, pierwszeństwo ma kategoria oznaczona jako główna.
Parametry wymagane przez Allegro
Po wybraniu kategorii moduł pobiera przypisane do niej parametry. Mogą to być między innymi:
producent,
rodzaj produktu,
platforma,
wersja,
EAN,
typ licencji,
sposób dostarczenia,
stan produktu,
inne cechy wymagane przez wybraną kategorię.
Każdy parametr można skonfigurować jako:
wartość pobieraną z danych produktu,
wartość stałą,
wartość wybraną ze słownika Allegro.
Moduł rozróżnia parametry opisujące sam produkt od parametrów dotyczących konkretnej oferty. Jest to istotne, ponieważ Allegro oczekuje ich w różnych częściach żądania i może odrzucić ofertę, jeśli parametr zostanie przekazany w niewłaściwym miejscu.
Cena, promocja i stan oferty
Cena jest pobierana z aktywnego wariantu cenowego produktu. Jeżeli produkt ma aktywną promocję, do Allegro może trafić aktualna cena promocyjna.
Administrator może ustawić osobny procentowy narzut dla Allegro. Pozwala to uwzględnić prowizję marketplace bez ręcznego przeliczania każdego produktu.
W konfiguracji można również określić:
liczbę dostępnych sztuk,
jednostkę stanu,
czas trwania aukcji,
deklarowany czas realizacji,
lokalizację sprzedawcy.
Aktualna wersja nie nasłuchuje każdej zmiany stanu i ceny w czasie rzeczywistym. Po zmianie danych produktu należy wykonać aktualizację oferty albo uruchomić przewidziany dla integracji proces synchronizacji.
Zdjęcia produktu
Moduł pobiera zdjęcia z galerii produktu i przekazuje je do Allegro. Obsługiwanych jest do ośmiu zdjęć.
Administrator może wskazać, które zdjęcie ma zostać miniaturą aukcji. Pozwala to zastosować na Allegro inną fotografię główną niż w sklepie.
Zdjęcia używane wewnątrz opisu są przesyłane na serwery Allegro, ponieważ platforma wymaga własnych adresów obrazów. Raz przesłane zdjęcie jest zapamiętywane, dzięki czemu kolejna aktualizacja nie wysyła niezmienionego pliku ponownie.
Własny opis aukcji
Integracja posiada wspólny szablon opisu wykorzystywany przez wszystkie produkty.
Szablon może automatycznie podstawiać:
nazwę,
typ produktu,
platformę,
kod katalogowy,
EAN,
wersję,
wymagania techniczne,
producenta,
okres pomocy,
dedykowany opis Allegro.
Opis można podzielić na czytelne bloki z nagłówkami, akapitami, listami i zdjęciami.
Produkt może mieć oddzielny opis przeznaczony wyłącznie dla Allegro. Pozwala to uniknąć publikowania identycznej treści w sklepie i na marketplace oraz lepiej dopasować komunikację do kupujących na Allegro.
Warunki sprzedaży
Przed pierwszą publikacją należy przygotować na koncie Allegro:
cennik dostaw,
warunki zwrotów,
warunki reklamacji,
opcjonalnie warunki gwarancji.
Moduł pobiera te elementy i pozwala wybrać je w panelu. Wybrane ustawienia mogą być wykorzystywane przy kolejnych produktach.
Dla produktu cyfrowego Allegro nadal może wymagać lokalizacji sprzedawcy. W takim przypadku należy podać adres firmy: kraj, województwo, miasto i kod pocztowy.
Obsługa zamówień
Moduł może cyklicznie pobierać zamówienia z Allegro. Licencja jest wydawana dopiero po potwierdzeniu zakończonej płatności.
Każde zamówienie jest zapisywane pod unikalnym identyfikatorem Allegro. Ponowne uruchomienie synchronizacji nie wystawia drugi raz tej samej licencji.
Jeżeli kupujący zamówi więcej niż jedną sztukę, system może utworzyć odpowiednią liczbę niezależnych licencji.
Oferowany wariant obejmuje indywidualną licencję na jedną stronę internetową lub jeden sklep.
1. Konfiguracja przed pierwszą publikacją
Instalacja modułu
Przed instalacją wykonaj kopię zapasową plików i bazy danych PrestaShop.W panelu PrestaShop przejdź do:
Menedżer modułów → Zainstaluj modułWskaż paczkę ZIP, zaczekaj na zakończenie instalacji i otwórz konfigurację integracji.
Serwer powinien posiadać:
aktywny certyfikat HTTPS,
możliwość wykonywania wychodzących połączeń HTTPS,
poprawnie skonfigurowaną pocztę,
zadanie cron uruchamiające harmonogram,
wersję PHP i PrestaShop zgodną z wymaganiami konkretnego wydania modułu.
2. Przygotowanie konta Allegro
Sprzedawca powinien posiadać aktywne konto umożliwiające wystawianie ofert.
Na koncie Allegro należy wcześniej skonfigurować:
dane firmy,
warunki zwrotów,
warunki reklamacji,
cennik dostaw,
opcjonalną gwarancję.
3. Autoryzacja
W ustawieniach po wpisaniu kluczy API Allegro, należy przycisnąć przycisk Połącz konto Allegro
Po jego kliknięciu klient powinien zostać przekierowany na oficjalną stronę Allegro, zalogować się i wyrazić zgodę na dostęp.
Klient nie powinien podawać modułowi hasła do Allegro.
W obecnej wersji technicznej administrator wpisuje Client ID i Client Secret własnej aplikacji.
Adres powrotu wyświetlany przez moduł musi zostać dokładnie skonfigurowany po stronie aplikacji Allegro. Różnica w protokole, domenie, ścieżce lub końcowym ukośniku może spowodować odrzucenie autoryzacji.
4. Warunki oferty
W module należy wybrać:
cennik dostaw,
warunki zwrotów,
warunki reklamacji,
opcjonalną gwarancję,
czas realizacji,
długość publikacji,
domyślny stan,
narzut ceny,
lokalizację firmy,
pozycję zdjęcia głównego.
Brak cennika, zwrotów lub reklamacji zablokuje publikację.
5. Przygotowanie produktu
Produkt przeznaczony do publikacji powinien posiadać:
nazwę nieprzekraczającą limitu Allegro,
aktywną cenę,
kategorię sklepu,
kod katalogowy,
EAN, jeżeli wymaga go kategoria,
wersję produktu,
platformę,
wymagania techniczne,
galerię zdjęć,
opis przeznaczony dla Allegro,
aktywny wariant licencyjny.
Dla aukcji opisanej w tej karcie wariant powinien mieć limit jednej aktywacji na jedną stronę lub sklep.
6. Mapowanie kategorii
W panelu integracji należy:
wybrać kategorię PrestaShop,
otworzyć drzewo kategorii Allegro,
przechodzić przez kolejne poziomy,
wybrać końcową kategorię Allegro,
zapisać powiązanie.
Nie należy wybierać kategorii wyłącznie na podstawie podobnej nazwy. Trzeba sprawdzić jej wymagane parametry i przeznaczenie.
7. Mapowanie parametrów
Po zapisaniu kategorii należy otworzyć jej parametry i uzupełnić wszystkie pola wymagane.
Dla każdego parametru wybiera się:
wartość ze słownika Allegro,
wartość stałą,
pole produktu.
Szczególną uwagę należy zwrócić na:
stan,
producenta,
EAN,
rodzaj produktu,
platformę,
typ i zakres licencji.
8. Szablon opisu
Przed pierwszą publikacją warto otworzyć podgląd szablonu na konkretnym produkcie.
Należy sprawdzić:
czy nie brakuje danych,
czy zdjęcia są na odpowiednich pozycjach,
czy widoczna jest informacja o licencji na jedną stronę,
czy prawidłowo opisano cyfrową dostawę,
czy wymagania techniczne są kompletne,
czy tekst nie zawiera obietnic niezgodnych z rzeczywistą funkcjonalnością.
9. Publikacja oferty
Po pomyślnym połączeniu oferty z katalogiem Allegro wraz z konfiguracją oferty (mapowanie wymaganych atrybutów, jak i spełnieniem szeregu innych pól obowiązkowych wymaganych przez Allegro, przy ofercie którą chcemy wystawić, pojawi się zielony alert "Wymagania OK". Oznacza to, że wszelkie wymagania są spełnione do wystawiania danej oferty i można ją zaznaczyć i wystawić.
Masowe wystawianie ofert / cron
Istnieje również możliwość masowo wystawiać oferty z naszego sklepu na Allegro. W tym celu należy zaznaczyć kilka ofert a pojawi się przycisk
Specyfikacja techniczna
Sprawdź wymagania i kompatybilność przed instalacją.
Historia zmian
Duża aktualizacja funkcjonalna obejmująca zarządzanie ofertami, synchronizację, zgodność z aktualnym API, obsługę sprzedaży oraz przebudowę modułu pod nazwą OfferSync.
Zarządzanie ofertami
- NowośćDodano zbiorczą listę aktywnych, zakończonych i roboczych ofert.
- NowośćDodano wyszukiwanie po nazwie, SKU, EAN i identyfikatorze oferty.
- NowośćDodano bezpośrednią edycję ceny i stanu.
- NowośćDodano edycję warunków sprzedaży, podatku, gwarancji i czasu wysyłki.
- NowośćDodano masowe aktywowanie i kończenie ofert.
- NowośćDodano ponowne wystawianie zakończonych ofert.
- NowośćDodano masowe aktualizowanie pól przez kolejkę.
- NowośćDodano grupową aktualizację ceny i stanu przez zasoby API.
- NowośćJedna komenda może aktualizować maksymalnie 25 ofert.
- NowośćOgraniczono liczbę indywidualnych żądań i ryzyko limitu 429.
Synchronizacja cen i stanów
- NowośćDodano automatyczną synchronizację ceny.
- NowośćDodano automatyczną synchronizację stanu magazynowego.
- NowośćDodano bufor dostępnego stanu.
- NowośćDodano minimalny próg dostępności.
- NowośćDodano ograniczenie maksymalnej ilości dla pojedynczego produktu.
- NowośćDodano wybór kierunku synchronizacji ceny.
- NowośćDodano obsługę cen indywidualnych i narzutów.
- NowośćDodano wybór grupy klientów wykorzystywanej do obliczania ceny.
- NowośćDodano możliwość wykluczenia produktu z synchronizacji.
- NowośćDodano ochronę ceny oferty uczestniczącej w kampanii.
Katalog produktów, EAN i SKU
- NowośćDodano wyszukiwanie produktu katalogowego po EAN/GTIN.
- NowośćDodano ręczny wybór produktu z katalogu.
- NowośćDodano wiązanie oferty z produktem katalogowym.
- NowośćDodano wiązanie oferty marketplace z produktem PrestaShop.
- NowośćDodano automatyczne dopasowanie produktów po SKU i EAN.
- NowośćDodano informację, czy oferta jest już powiązana z katalogiem.
- NowośćDodano wykrywanie błędnego lub niejednoznacznego GTIN.
- NowośćDodano ochronę danych produktu pobieranych z katalogu.
- PoprawkaPoprawiono układ kolumn SKU i EAN.
- PoprawkaKolumna EAN nie nachodzi już na sąsiednie pola.
- PoprawkaUsunięto mylące informacje o przyszłym powiązaniu, jeżeli oferta jest już powiązana.
Kategorie i atrybuty
- NowośćDodano kategorię domyślną.
- NowośćDodano indywidualne nadpisanie kategorii na karcie produktu.
- NowośćDodano dziedziczenie mapowania kategorii.
- NowośćDodano kopiowanie mapowania na podkategorie.
- NowośćDodano import i eksport mapowań.
- NowośćDodano licznik produktów w kategoriach.
- NowośćDodano import i eksport mapowań parametrów.
- NowośćDodano grupowanie parametrów według kategorii.
- NowośćDodano bezpośrednie przejście z kategorii do jej atrybutów.
- UlepszeniePrzebudowano drzewo kategorii.
- UlepszenieDodano czytelne gałęzie między kategorią nadrzędną a jej dziećmi.
- UlepszeniePoprawiono wcięcia podkategorii.
- UlepszenieWyraźnie rozróżniono mapowania własne i dziedziczone.
- UlepszeniePoprawiono wybieranie kategorii końcowej.
Kompletność i publikacja
- PoprawkaPrzebudowano obliczanie kompletności oferty.
- PoprawkaBrak kategorii nie może już powodować wyniku 100%.
- PoprawkaKompletność uwzględnia rzeczywiste blokady publikacji.
- PoprawkaDodano rozróżnienie błędów, ostrzeżeń i informacji.
- PoprawkaPoprawiono komunikaty o katalogu, GTIN, GPSR i wymaganych parametrach.
- PoprawkaDodano wskazanie konkretnego działania wymaganego od użytkownika.
- PoprawkaOferta powiązana z katalogiem jest odpowiednio oznaczana.
Masowe wystawianie
- NowośćDodano masowy wybór produktów.
- NowośćDodano podgląd ofert przed publikacją.
- NowośćDodano ocenę kompletności każdej pozycji.
- NowośćDodano kolejkę publikacji.
- NowośćDodano pasek postępu.
- NowośćDodano możliwość zatrzymania operacji.
- NowośćDodano wystawianie jako szkic lub aktywną ofertę.
- NowośćDodano podsumowanie udanych, pominiętych i błędnych pozycji.
- NowośćDodano zabezpieczenie przed podwójnym wystawieniem tego samego produktu.
GPSR i bezpieczeństwo produktów
- NowośćDodano producenta odpowiedzialnego.
- NowośćDodano osobę odpowiedzialną w Unii Europejskiej.
- NowośćDodano informacje o bezpieczeństwie produktu.
- NowośćDodano mapowanie producentów.
- NowośćDodano dane GPSR na karcie produktu.
- NowośćDodano ustawienie produktu wprowadzonego na rynek UE przed 13 grudnia 2024 roku.
- NowośćDodano sprawdzanie brakujących i niespójnych danych GPSR.
- NowośćDodano ostrzeżenia przed publikacją niekompletnej oferty.
AI Act i obrazy AI
- NowośćDodano obsługę oznaczenia obrazów utworzonych lub zmodyfikowanych przy pomocy AI.
- NowośćDodano obsługę pola images[].aiCoCreatedContent.
- NowośćDodano obsługę oznaczeń AI w danych posprzedażowych.
- NowośćZachowano ponowne wykorzystywanie wcześniej przesłanych zdjęć.
- NowośćNiezmienione pliki nie są przesyłane ponownie.
Warunki sprzedaży i podatki
- NowośćDodano ustawienia faktury i podatku.
- NowośćDodano domyślny przedmiot opodatkowania GOODS.
- NowośćDodano gwarancję domniemaną.
- NowośćDodano tabele rozmiarów.
- NowośćDodano usługi dodatkowe.
- NowośćDodano cenniki hurtowe.
- NowośćDodano ustawienia warunków sprzedaży dla wielu kont.
Zgodność API -
- NowośćCenniki dostaw przesyłają wymagane pole type.
- NowośćDla cenników fizycznych przesyłane jest dispatchCountry.
- NowośćDodano kontrolę kraju nadania.
- PoprawkaPoprawiono walidację payloadów cenników dostaw.
Zamówienia
- NowośćDodano rozbudowany widok zamówień.
- NowośćDodano filtrowanie według statusu i płatności.
- NowośćDodano synchronizację statusów w obu kierunkach.
- NowośćDodano anulowanie nieopłaconych zamówień.
- NowośćDodano obsługę punktów odbioru.
- NowośćDodano uwagi kupującego.
- NowośćDodano podgląd pozycji zamówienia.
- NowośćDodano powiązanie z zamówieniem PrestaShop.
- NowośćDodano obsługę faktur przy zamówieniu.
- NowośćDodano rozpoznawanie zamówień One Fulfillment.
Wysyłka
- NowośćDodano wysyłanie numeru przesyłki.
- NowośćDodano częściową realizację zamówienia.
- NowośćDodano obsługę wielu pozycji przesyłki.
- NowośćDodano tworzenie przesyłek Wysyłam z Allegro.
- NowośćDodano pobieranie etykiet PDF.
- NowośćDodano zapisywanie numeru przesyłki w PrestaShop.
- NowośćDodano wykorzystywanie suggestedInput z propozycji dostawy.
- NowośćDodano obsługę punktów odbioru.
Zgodność API -
- NowośćDodano walidację numerów telefonicznych w formacie E.164.
- NowośćWalidowany jest numer nadawcy i odbiorcy.
- UsuniętoUsunięto zastępczy numer 000000000.
- NowośćPrefiks +48 jest dodawany wyłącznie dla polskiego adresu.
- NowośćDla innych państw moduł nie zgaduje prefiksu.
- NowośćNieprawidłowy numer blokuje utworzenie przesyłki i pokazuje czytelny komunikat.
Wiadomości i problemy zakupowe
- NowośćDodano skrzynkę wiadomości.
- NowośćDodano listę wątków.
- NowośćDodano odczytywanie i wysyłanie wiadomości.
- NowośćDodano załączniki.
- NowośćDodano szablony odpowiedzi.
- NowośćDodano oznaczanie wiadomości jako przeczytane.
- NowośćDodano obsługę POST_PURCHASE_ISSUE.
- NowośćDodano pola orders, subType, status i read.
- NowośćDodano stronicowanie przez page.id i nextPage.
- NowośćDodano kontrolowany tryb zgodności beta/public.
- NowośćZachowano obsługę wcześniejszych Dyskusji i reklamacji.
Reklamacje i zwroty klientów
- NowośćDodano pobieranie reklamacji i zwrotów.
- NowośćDodano podgląd szczegółów zgłoszenia.
- NowośćDodano rozmowę z kupującym.
- NowośćDodano zmianę statusu reklamacji.
- NowośćDodano tworzenie RMA w PrestaShop.
- NowośćDodano opcjonalne przywracanie stanu.
- NowośćDodano odmowę zwrotu wraz z powodem.
- NowośćDodano status REJECTED_CLAIM_WITHDRAWN_BY_BUYER.
- NowośćDodano informację o reklamacji wycofanej przez kupującego.
Zwroty płatności
- NowośćDodano pełne i częściowe zwroty.
- NowośćDodano podawanie powodu zwrotu.
- NowośćDodano rejestr wykonanych operacji.
- NowośćDodano zapisywanie operacji oczekujących.
Zgodność API -
- NowośćKażdy zwrot otrzymuje UUID commandId.
- NowośćcommandId jest zapisywany przed wysłaniem żądania.
- NowośćPonowienie operacji używa tego samego identyfikatora.
- NowośćDodano zabezpieczenie przed podwójnym zwrotem.
- PoprawkaPoprawiono zgodność starszej ścieżki zwrotów.
Kampanie, promocje i odznaki
- NowośćDodano kalendarz promocji.
- NowośćDodano planowanie początku i zakończenia kampanii.
- NowośćDodano wykrywanie nakładających się kampanii.
- NowośćDodano automatyczne włączanie i wyłączanie wyróżnień.
- NowośćDodano obsługę kampanii odznak.
- NowośćDodano wymagane ceny promocyjne.
- NowośćDodano deklarowany stan dla kampanii.
- NowośćDostosowano zasoby kampanii i odznak do zmian API.
Allegro Ceny
- NowośćDodano osobną sekcję programu Allegro Ceny.
- NowośćDodano prezentację statusu uczestnictwa konta.
- NowośćDodano ręczne wyrażanie i wycofywanie zgody.
- NowośćModuł nie zapisuje konta do programu automatycznie.
- NowośćDodano zgłaszanie ofert.
- NowośćDodano wykluczanie ofert.
- NowośćDodano deklarowanie maksymalnego udziału sprzedawcy w rabacie.
- NowośćDodano sprawdzanie kwalifikacji ofert.
- NowośćDodano prezentację rekomendowanego rabatu.
- NowośćDodano status uczestnictwa oferty.
- NowośćDodano filtrowanie ofert uczestniczących, dofinansowanych i wykluczonych.
Statystyki
- NowośćDodano statystyki ofert i produktów.
- NowośćDodano pobieranie prowizji z API.
- NowośćDodano prezentację pozostałych opłat.
- NowośćDodano cenę sklepu i cenę marketplace.
- NowośćDodano prezentację narzutu.
- NowośćDodano koszt zakupu.
- NowośćDodano zysk brutto i netto.
- NowośćDodano marżę procentową.
- NowośćDodano sugerowaną cenę pokrywającą opłaty marketplace.
- NowośćDodano filtrowanie produktów bez kosztu i bez mapowania.
- PoprawkaKoszt zakupu z produktu PrestaShop jest nadrzędnym źródłem danych.
- PoprawkaIstniejący koszt jest w statystykach tylko do odczytu.
- PoprawkaDodano informację, że koszt pochodzi z Katalog → Produkt.
- PoprawkaZmiana ceny lub narzutu nie nadpisuje kosztu produktu.
- PoprawkaJeśli kosztu brakuje, można zapisać go ze statystyk.
- PoprawkaNowy koszt jest zapisywany bezpośrednio w standardowym polu produktu.
- PoprawkaUsunięto ryzyko przechowywania dwóch różnych kosztów tego samego produktu.
Raport sprzedaży i rozliczenia
- NowośćDodano raport sprzedaży.
- NowośćDodano filtrowanie według zakresu dat.
- NowośćDodano eksport CSV.
- NowośćDodano przychód, koszt towaru i wynik operacyjny.
- NowośćDodano wpisy rozliczeniowe przypisane do zamówień i ofert.
- NowośćDodano obciążenia, uznania i saldo.
- NowośćDodano tax.annotation.
- NowośćDodano szczegółowe podtypy operacji.
- NowośćDodano powiązanie wpisów z pozycjami zamówienia.
- NowośćDodano dopłaty i zmiany wartości pozycji.
- NowośćDodano rozpoznawanie korekt i zwrotów.
- NowośćDodano powiązanie korekty z pierwotnym wpisem, jeśli API udostępnia identyfikator.
- NowośćDodano prezentację kosztów One Fulfillment.
- NowośćDodano dostępne informacje o kwotach brutto i podatkach.
- NowośćDodano informację, że raport nie jest dokumentem księgowym.
Centrum zgodności
- NowośćDodano zbiorczą sekcję pokazującą: blokady API, brakujące dane, problemy GPSR, nieaktualne mapowania, brakujące kategorie, błędne lub niejednoznaczne GTIN, problemy z katalogiem produktów, brakujące parametry, wymagane działania użytkownika, stan kolejki i harmonogramu.
Monitoring i diagnostyka
- NowośćDodano monitoring działania harmonogramu.
- NowośćDodano kontrolę kolejki.
- NowośćDodano rejestr błędów synchronizacji.
- NowośćDodano obsługę błędów autoryzacji.
- NowośćDodano kontrolę limitów API.
- NowośćDodano ponawianie operacji z uwzględnieniem Retry-After.
- NowośćDodano diagnostykę zakładek administracyjnych.
- NowośćDodano naprawę drzewa menu.
- NowośćDodano alerty o problemach wymagających reakcji.
Interfejs administracyjny
- UlepszeniePrzebudowano boczne menu modułu.
- UlepszenieMenu użytkownika, profil i wylogowanie mają pierwszeństwo przed paskiem OfferSync.
- UlepszeniePoprawiono pozycjonowanie i kolejność warstw.
- UlepszenieDodano zwijanie sekcji i zapamiętywanie ich stanu.
- UlepszenieDodano panele boczne produktu, oferty i zamówienia.
- UlepszeniePoprawiono układ responsywny.
- UlepszeniePoprawiono statusy, komunikaty i ostrzeżenia.
- UlepszenieZmieniono wygląd etykiet .al-chip.
- UlepszenieZmieniono wygląd oznaczeń .al-attr-sig.
- UlepszenieZwiększono odstępy wewnętrzne oznaczeń do 6px 12px.
- UlepszenieZmieniono promień narożników oznaczeń na 10px.
Zamówienia
- NowośćDodano pobieranie zamówień Allegro.
- NowośćDodano rozpoznawanie zakończonej płatności.
- NowośćDodano powiązanie oferty Allegro z produktem PrestaShop.
- NowośćDodano automatyczne tworzenie klienta na podstawie danych zamówienia.
- NowośćWielokrotne uruchomienie synchronizacji nie tworzy duplikatów.
- NowośćDodano automatyczną synchronizację wykonywaną przez harmonogram.
Szablony i opisy Allegro
- NowośćDodano jeden wspólny szablon dla wszystkich ofert.
- NowośćDodano automatyczne podstawianie danych produktu.
- NowośćDodano zmienne dla nazwy produktu, platformy, rodzaju produktu, kodu katalogowego, EAN, wersji, wymagań technicznych, producenta, okresu wsparcia i opisu.
- NowośćDodano proste nagłówki, listy i akapity.
- NowośćDodano podział opisu na bloki tekstowe i zdjęciowe.
- NowośćDodano automatyczne usuwanie pustych wierszy i sekcji.
- NowośćProdukt bez EAN nie wyświetla pustej etykiety EAN.
- NowośćDodano filtrowanie niedozwolonego HTML.
- NowośćDodano kontrolę maksymalnej długości opisu.
- NowośćDodano podgląd szablonu na wybranym produkcie.
- NowośćDodano przywracanie wersji domyślnej.
Warunki sprzedaży
- NowośćDodano pobieranie cenników dostaw z konta Allegro.
- NowośćDodano wybór warunków zwrotów.
- NowośćDodano wybór warunków reklamacji.
- NowośćDodano opcjonalne warunki gwarancji.
- NowośćDodano ustawienie czasu realizacji.
- NowośćDodano lokalizację sprzedawcy wymaganą również dla produktów cyfrowych.
- NowośćDodano kraj, województwo, miasto i kod pocztowy.
- NowośćDodano możliwość ręcznego wpisania identyfikatorów, jeśli API chwilowo nie zwróci list.
- UlepszenieModuł sprawdza komplet wymaganych warunków przed publikacją.
Zdjęcia
- NowośćDodano pobieranie galerii produktu.
- NowośćDodano obsługę maksymalnie ośmiu zdjęć.
- NowośćDodano wybór zdjęcia używanego jako miniatura.
- NowośćDodano przesyłanie zdjęć na serwery Allegro.
- NowośćDodano ponowne wykorzystywanie wcześniej przesłanych zdjęć.
- NowośćDodano zapamiętywanie adresów zdjęć przy produkcie.
- NowośćDodano możliwość umieszczania zdjęć obok bloków tekstowych opisu.
- WażneAktualizacja oferty nie przesyła ponownie niezmienionych plików.
Oddzielne treści SEO
- NowośćDodano osobny opis produktu przeznaczony wyłącznie dla Allegro.
- NowośćOpis oferty może różnić się od opisu produktu w sklepie.
- NowośćDodano opcjonalne generowanie oddzielnego opisu za pomocą skonfigurowanego narzędzia AI.
- NowośćDodano ostrzeżenie, gdy wygenerowany opis jest zbyt podobny do treści sklepu.
Fundament integracji z Allegro
Pierwsza kompletna wersja integracji panelu administracyjnego PrestaShop z Allegro REST API.
Autoryzacja i komunikacja
- NowośćDodano komunikację z oficjalnym Allegro REST API.
- NowośćDodano środowisko produkcyjne.
- NowośćDodano środowisko testowe Allegro Sandbox.
- NowośćWdrożono OAuth 2.0 Authorization Code.
- NowośćDodano ekran potwierdzenia właściwego konta.
- NowośćDodano ochronę parametrem state.
- NowośćDodano automatyczne odświeżanie wygasającego tokenu dostępowego.
- NowośćToken dostępowy, token odświeżający i sekret aplikacji są przechowywane w postaci zaszyfrowanej.
- NowośćDodano możliwość rozłączenia konta bez usuwania istniejących ofert.
Kategorie
- NowośćDodano pobieranie drzewa kategorii bezpośrednio z Allegro.
- NowośćDodano poruszanie się po wielopoziomowym drzewie.
- NowośćDodano powiązanie kategorii sklepu z końcową kategorią Allegro.
- NowośćKategoria główna produktu otrzymuje pierwszeństwo podczas wybierania mapowania.
- NowośćDodano możliwość usunięcia i ponownego utworzenia powiązania.
- NowośćModuł blokuje publikację bez prawidłowego mapowania kategorii.
Parametry Allegro
- NowośćDodano pobieranie parametrów właściwych dla wybranej kategorii.
- NowośćDodano obsługę parametrów wymaganych i opcjonalnych.
- NowośćDodano obsługę wartości słownikowych.
- NowośćDodano obsługę wartości tekstowych.
- NowośćDodano przypisywanie wartości stałej.
- NowośćDodano pobieranie wartości z danych produktu.
- NowośćDodano rozdzielenie parametrów oferty i parametrów produktu.
- NowośćDodano obsługę pól wymaganych przez Katalog Produktów Allegro.
- NowośćDodano sprawdzanie brakujących parametrów przed publikacją.
- NowośćDodano obsługę EAN/GTIN.
Publikowanie ofert
- NowośćDodano tworzenie nowych ofert.
- NowośćDodano aktualizowanie wystawionych ofert bez tworzenia duplikatów.
- NowośćDodano format sprzedaży „Kup teraz”.
- NowośćDodano pobieranie nazwy produktu.
- NowośćDodano pobieranie ceny z aktywnego produktu.
- NowośćDodano uwzględnianie aktywnej ceny promocyjnej.
- NowośćDodano opcjonalny procentowy narzut ceny.
- NowośćDodano ustawianie dostępnej liczby sztuk.
- NowośćDodano ustawianie czasu trwania oferty.
- NowośćDodano zapisywanie identyfikatora i adresu wystawionej oferty.
- NowośćDodano datę pierwszej publikacji i ostatniej synchronizacji.
- NowośćDodano zapisywanie komunikatu zwróconego po odrzuceniu oferty.
Kontrola publikacji
- NowośćDodano listę blokad pokazującą, czego brakuje przed opublikowaniem produktu.
Wybierz swoją licencję
Każdy plan obejmuje dostęp do pliku, klucza licencyjnego i aktualizacji zgodnie z podanym okresem.
Start
W planie otrzymujesz
- Licencja na 1 domenę
- Aktualizacje przez 365 dni
- Pomoc techniczna przez 6 miesięcy od zakupu
- Ostatnia wersja pozostaje po wygaśnięciu aktualizacji
Rozliczenie roczne
Biznes
W planie otrzymujesz
- Licencja na 3 domeny
- Aktualizacje przez 365 dni
- Pomoc techniczna przez 6 miesięcy od zakupu
- Ostatnia wersja pozostaje po wygaśnięciu aktualizacji
Rozliczenie roczne
Agencja
W planie otrzymujesz
- Licencja na 10 domen
- Aktualizacje przez 365 dni
- Pomoc techniczna przez 6 miesięcy od zakupu
- Ostatnia wersja pozostaje po wygaśnięciu aktualizacji
Rozliczenie roczne
Pytania i odpowiedzi
Odpowiedzi na pytania, które klienci zadają przed zakupem tego produktu.
Do czego służy OfferSync?
OfferSync integruje sklep PrestaShop z kontem sprzedawcy w serwisie Allegro. Moduł umożliwia między innymi wystawianie i aktualizowanie ofert, synchronizację cen oraz stanów magazynowych, import zamówień, obsługę wysyłki, zwrotów, reklamacji, wiadomości, katalogu produktów, kampanii i rozliczeń.
Moduł korzysta z oficjalnego Allegro REST API. Nie jest produktem Allegro ani częścią Grupy Allegro.
Jakie funkcje obejmuje moduł?
Najważniejsze funkcje to:
wystawianie i edytowanie ofert;
masowa publikacja produktów;
synchronizacja cen i stanów;
mapowanie kategorii oraz parametrów;
obsługa EAN/GTIN i Katalogu Produktów Allegro;
import zamówień do PrestaShop;
obsługa wysyłek i etykiet;
wiadomości i problemy zakupowe;
zwroty, reklamacje i zwroty płatności;
GPSR oraz oznaczanie obrazów AI;
promocje, odznaki i Allegro Ceny;
statystyki, rozliczenia i Centrum zgodności;
obsługa wielu kont i marketplace’ów.
Czy OfferSync jest oficjalnym modułem Allegro?
Nie. OfferSync jest niezależnym oprogramowaniem integracyjnym korzystającym z oficjalnego Allegro REST API.
Allegro oraz powiązane oznaczenia są znakami towarowymi należącymi do ich właścicieli. Użycie nazwy Allegro w opisach funkcji wskazuje wyłącznie platformę, z którą moduł się komunikuje.
Jakie PrestaShop jest wymagane?
Aktualna wersja OfferSync jest przeznaczona dla PrestaShop 9.0 lub nowszego.
Przed instalacją należy również sprawdzić wymagania dotyczące PHP i rozszerzeń serwera wynikające z używanej wersji PrestaShop.
Czy moduł działa ze starszym PrestaShop 1.7 lub 8?
Aktualne wydanie nie deklaruje zgodności z PrestaShop 1.7 ani 8. Instalacja na niewspieranej wersji może powodować błędy kontrolerów, hooków, formularzy i interfejsu administracyjnego.
Czy potrzebuję własnej aplikacji Allegro API?
Tak. Do połączenia konta potrzebne są dane aplikacji utworzonej w panelu Allegro Developer:
Client ID;
Client Secret;
prawidłowy Redirect URI;
wymagane uprawnienia OAuth.
Redirect URI należy przepisać dokładnie z ustawień OfferSync.
Czy obsługiwany jest Allegro Sandbox?
Tak. Moduł obsługuje zarówno środowisko produkcyjne, jak i Allegro Sandbox.
Dane dostępowe dla Sandbox są oddzielne od danych produkcyjnych. Oferty, zamówienia i konta testowe nie są współdzielone ze środowiskiem produkcyjnym.
Czy moduł obsługuje wiele kont Allegro?
Tak. Można zapisać kilka kont i przełączać aktywne konto w ustawieniach modułu.
Mapowania, kolejki i powiązania uwzględniają konto, dla którego wykonywana jest operacja. Przed publikacją lub synchronizacją należy upewnić się, że wybrane jest właściwe konto.
Czy moduł obsługuje inne rynki niż Allegro.pl?
Tak. OfferSync zawiera obsługę dostępnych marketplace’ów Allegro, w tym właściwych walut, krajów oraz adresów ofert. Dostępność konkretnej funkcji może zależeć od rynku, konfiguracji konta i zakresu udostępnionego przez API.
Jak zainstalować moduł?
Pobraną paczkę ZIP należy wgrać przez menedżer modułów PrestaShop. Archiwum powinno zawierać jeden katalog główny:
offersync/Nie należy zmieniać nazwy katalogu ani pliku głównego modułu.
Czy mogę rozpakować moduł i wgrać go przez FTP?
Tak, ale cały katalog offersync musi trafić bezpośrednio do:
/modules/offersync/Po wgraniu plików moduł należy zainstalować lub uaktualnić w panelu PrestaShop. Trzeba zachować strukturę katalogów, nazwy plików i uprawnienia serwera.
Czy mogę jednocześnie włączyć starszy moduł i OfferSync?
Nie jest to zalecane. Dwa aktywne moduły wykonujące te same operacje mogą reagować na te same zmiany produktów i zamówień, co grozi podwójną synchronizacją, duplikacją operacji lub nadmiernym użyciem API.
Migrację należy przeprowadzić kontrolowanie, a poprzednią integrację wyłączyć przed uruchomieniem automatyzacji OfferSync.
Co skonfigurować przed pierwszym wystawieniem oferty?
Należy przynajmniej:
połączyć właściwe konto;
wybrać środowisko i marketplace;
ustawić lokalizację sprzedawcy;
wybrać cennik dostawy;
skonfigurować warunki zwrotów i reklamacji;
zmapować kategorie;
zmapować wymagane parametry;
uzupełnić dane GPSR;
sprawdzić EAN/GTIN;
uruchomić test kompletności oferty.
Czy moduł automatycznie opublikuje produkty po instalacji?
Nie. Sama instalacja nie powinna automatycznie publikować całego katalogu.
Publikacja wymaga wybrania produktów i uruchomienia odpowiedniej operacji. Automatyczne wystawianie działa dopiero po świadomym włączeniu właściwego ustawienia.
Jak aktywować licencję?
W ustawieniach OfferSync należy podać:
klucz licencyjny;
adres e-mail użyty przy zakupie.
Następnie należy wybrać opcję aktywacji. Sklep musi w tym momencie mieć dostęp do internetu i poprawnie skonfigurowane połączenie HTTPS.
Ile sklepów mogę podłączyć?
Liczba sklepów zależy od limitu aktywacji przypisanego do zakupionego wariantu licencji.
Każda odrębna domena lub instalacja może zostać potraktowana jako osobna aktywacja. Aktualny limit i liczbę wykorzystanych aktywacji pokazuje odpowiedź systemu aktywacyjnego.
Czy subdomena jest traktowana jako osobny sklep?
Może zostać potraktowana jako osobna domena. Przykładowo:
sklep.example.pl
test.example.plto dwa różne hosty. Przed aktywacją środowiska testowego należy sprawdzić limit przypisany do licencji.
Co zrobić po zmianie domeny?
Licencja jest powiązana z domeną sklepu. Przed zmianą najlepiej dezaktywować ją na starej domenie, a następnie aktywować na nowej.
Jeżeli stara instalacja nie jest już dostępna, konieczne może być zwolnienie poprzedniej aktywacji przez obsługę techniczną.
Czy zmiana protokołu HTTP na HTTPS wymaga ponownej aktywacji?
Zwykle nie, ponieważ identyfikacja opiera się na domenie. Jeżeli jednak zmieni się host, subdomena albo sposób raportowania domeny przez serwer, system może potraktować instalację jako inną.
Czy po aktualizacji trzeba ponownie wpisywać klucz?
Nie. Standardowa aktualizacja zachowuje konfigurację modułu, w tym zapisane dane aktywacyjne.
Ponowne podanie klucza może być potrzebne po:
ręcznym usunięciu konfiguracji;
pełnym czyszczeniu danych modułu;
przeniesieniu na inną domenę;
przywróceniu niepełnej kopii bazy danych;
utworzeniu nowej instalacji PrestaShop.
Co się stanie, gdy sklep utraci połączenie z internetem?
Moduł nie będzie mógł komunikować się z API ani wykonywać operacji wymagających połączenia sieciowego.
Ostatni prawidłowy wynik kontroli uprawnień jest zapamiętywany. Krótkotrwała awaria nie powinna natychmiast blokować modułu. Jeżeli brak połączenia będzie trwał dłużej niż przewidziany okres bezpieczeństwa, funkcje wymagające potwierdzenia mogą zostać czasowo ograniczone.
Co się stanie, gdy zewnętrzny serwer weryfikacyjny jest chwilowo niedostępny?
OfferSync używa pamięci podręcznej ostatniej poprawnej weryfikacji oraz okresu ochronnego. W aktualnym wydaniu okres ten wynosi do 14 dni od ostatniego prawidłowego potwierdzenia.
Po przywróceniu połączenia moduł ponowi kontrolę. Lokalny panel PrestaShop oraz dane sklepu nie są z tego powodu usuwane.
Czy klucz można udostępnić innej firmie?
Nie. Klucz jest przeznaczony dla uprawnionego nabywcy i liczby instalacji określonej w zakupionym wariancie. Publiczne udostępnienie klucza może spowodować wykorzystanie limitu aktywacji lub jego unieważnienie.
Jak sprawdzić dostępność aktualizacji?
W ustawieniach OfferSync należy użyć funkcji sprawdzania aktualizacji. Moduł przesyła numer aktualnie zainstalowanej wersji i pobiera informację, czy jest dostępne nowsze wydanie.
Czy aktualizacje są instalowane automatycznie?
Nie bez decyzji administratora. Moduł może sprawdzić dostępność wydania, ale instalacja wymaga uruchomienia odpowiedniej operacji w panelu.
Czy aktualizacja może usunąć moje ustawienia?
Prawidłowa aktualizacja zachowuje konfigurację oraz dane modułu. Przed większą aktualizacją zawsze warto wykonać kopię:
plików sklepu;
bazy danych;
katalogu modułu.
Czy podczas aktualizacji tworzona jest kopia poprzedniej wersji?
Bezpieczny mechanizm aktualizacji tworzy kopię dotychczasowego katalogu przed przełączeniem na nową wersję. Jeżeli instalacja nowej paczki się nie powiedzie, moduł podejmuje próbę przywrócenia poprzedniego katalogu.
Dlaczego aktualizacja może zostać odrzucona?
Najczęstsze przyczyny to:
nieprawidłowa suma SHA-256;
brak wymaganego manifestu;
niezgodność plików z manifestem;
nieprawidłowa struktura ZIP;
brak uprawnień do zapisu w katalogu modułów;
przerwane pobieranie;
nieobsługiwana wersja PHP lub PrestaShop;
brak miejsca na dysku;
blokada połączenia HTTPS.
Czy mogę zmieniać pliki modułu ręcznie?
Technicznie jest to możliwe, ale nie jest zalecane. Ręczna modyfikacja może:
zmienić integralność wydania;
utrudnić diagnostykę;
zostać nadpisana podczas aktualizacji;
spowodować odrzucenie paczki;
doprowadzić do niezgodności kodu z bazą danych.
Własne zmiany należy utrzymywać jako osobne, kontrolowane rozszerzenie lub wdrażać w nowym, wersjonowanym wydaniu.
Czy dane znikną po odinstalowaniu modułu?
Domyślnie ustawienia i dane integracji mogą pozostać w bazie, aby umożliwić ponowną instalację bez utraty konfiguracji.
Jeżeli administrator wcześniej włączy opcję pełnego usuwania danych, odinstalowanie może usunąć tabele i konfigurację modułu.
Czy odinstalowanie usuwa oferty z Allegro?
Nie. Usunięcie modułu ze sklepu nie oznacza automatycznego zakończenia ani usunięcia ofert działających na zewnętrznym koncie.
Oferty należy zakończyć osobno, jeśli taki jest zamiar sprzedawcy.
Czy odinstalowanie usuwa zamówienia PrestaShop?
Nie. Zamówienia już utworzone w PrestaShop pozostają częścią danych sklepu.
Czy mogę ponownie zainstalować moduł?
Tak. Jeżeli dane nie zostały wcześniej wyczyszczone, moduł może ponownie wykorzystać zachowaną konfigurację. Po instalacji należy jednak sprawdzić połączenie, harmonogram, mapowania i aktywne konto.
Czy moduł przechowuje dane klientów?
Moduł przetwarza dane potrzebne do utworzenia i obsługi zamówienia, wysyłki, faktury, wiadomości lub zwrotu. Dane trafiają również do standardowych struktur PrestaShop zgodnie z wykonywaną operacją.
Administrator sklepu odpowiada za zgodną z prawem konfigurację, zabezpieczenie dostępu i okres przechowywania danych.
Czy do automatycznej synchronizacji potrzebny jest cron?
Tak. Automatyczny import zamówień, obsługa kolejek, synchronizacja ofert i inne zadania okresowe wymagają regularnego wywoływania adresu cron podanego w ustawieniach.
Jak często uruchamiać cron?
Zalecana częstotliwość zależy od wielkości katalogu i liczby zamówień. Najczęściej zadanie uruchamia się co kilka minut.
Nie należy uruchamiać wielu identycznych zadań jednocześnie. Moduł używa blokad procesów, ale błędna konfiguracja harmonogramu może niepotrzebnie obciążać sklep i API.
Czy synchronizacja może tworzyć duplikaty zamówień?
Moduł zapisuje powiązanie identyfikatora zamówienia z zamówieniem PrestaShop i sprawdza je przed kolejnym importem. Wielokrotne uruchomienie synchronizacji nie powinno tworzyć drugiego zamówienia dla tego samego formularza zakupowego.
Co się stanie po osiągnięciu limitu API?
Moduł rozpoznaje odpowiedzi ograniczające liczbę żądań i uwzględnia Retry-After. Operacje kolejkowe mogą zostać odłożone i ponowione później.
Masowe wykonywanie wielu operacji ręcznie może wydłużyć synchronizację pozostałych danych.
Która cena jest wysyłana do oferty?
Cena może wynikać z:
bieżącej ceny produktu;
aktywnej promocji;
narzutu procentowego;
narzutu kwotowego;
indywidualnej ceny ustawionej dla produktu;
ustawień konta i kierunku synchronizacji.
Indywidualna cena produktu ma pierwszeństwo przed ogólnym narzutem.
Skąd pobierany jest koszt zakupu?
Podstawowym źródłem jest pole „Cena zakupu (netto)” na karcie produktu PrestaShop.
Jeżeli koszt istnieje, w statystykach jest tylko do odczytu. Zmiana ceny lub narzutu oferty nie zmienia kosztu zakupu.
Jeśli produkt nie ma kosztu, można uzupełnić go ze statystyk OfferSync. Wartość zostanie zapisana bezpośrednio w produkcie PrestaShop.
Czy moduł zmienia opis produktu w sklepie?
Nie. Opis przeznaczony dla oferty może być przechowywany oddzielnie. Aktualizacja oferty nie musi zmieniać standardowego opisu produktu widocznego w sklepie.
Dlaczego oferta ma mniej niż 100% kompletności?
Wynik może być obniżony przez:
brak kategorii końcowej;
brak wymaganych parametrów;
nieprawidłowy EAN/GTIN;
problem z katalogiem produktów;
brak warunków sprzedaży;
brak wymaganych danych GPSR;
nieprawidłowy tytuł;
brak wymaganych zdjęć;
brak danych podatkowych lub lokalizacji.
Szczegóły są wyświetlane przy ofercie.
Czy 100% kompletności gwarantuje przyjęcie oferty?
Nie. Wynik oznacza, że moduł nie wykrył znanych braków na podstawie dostępnych danych. Ostateczna walidacja odbywa się po stronie API, które może zastosować dodatkowe reguły zależne od kategorii, konta lub aktualnych zasad platformy.
Czy można wystawić produkt bez EAN?
Zależy to od kategorii i zasad katalogu. W części kategorii GTIN jest obowiązkowy. Jeżeli API wymaga identyfikatora, moduł zablokuje publikację albo pokaże błąd zwrócony przez platformę.
Czy moduł automatycznie wybiera produkt z katalogu?
Może wyszukać propozycje po EAN/GTIN, ale nie powinien automatycznie wybierać niejednoznacznego produktu. Jeżeli znaleziono kilka pasujących pozycji, użytkownik powinien wskazać właściwą.
Co oznacza, że oferta jest już powiązana z katalogiem?
Oznacza to, że oferta wskazuje konkretny produkt katalogowy. Część danych produktu może wtedy pochodzić z katalogu, a możliwość ich zmiany może zależeć od zasad API.
Dlaczego moduł odrzuca numer telefonu przy tworzeniu przesyłki?
Wysyłam z Allegro wymaga numeru z międzynarodowym prefiksem w formacie E.164, przykładowo:
+48123123123Dla polskiego adresu moduł może uzupełnić +48. Dla innego kraju nie zgaduje prefiksu, ponieważ mogłoby to skierować powiadomienia do niewłaściwej osoby.
Czy moduł może tworzyć etykiety wysyłkowe?
Tak, dla obsługiwanych metod Wysyłam z Allegro. Moduł może utworzyć przesyłkę, pobrać etykietę PDF i zapisać numer przesyłki przy zamówieniu.
Czy można wykonać częściowy zwrot płatności?
Tak. Kwota musi spełniać ograniczenia płatności i nie może przekraczać dostępnej wartości zwrotu.
Każda operacja otrzymuje unikalny identyfikator, który chroni przed przypadkowym podwójnym wykonaniem zwrotu.
Czy moduł obsługuje reklamacje wycofane przez kupującego?
Tak. Obsługiwany jest status:
REJECTED_CLAIM_WITHDRAWN_BY_BUYERCzy przy utworzeniu zwrotu stan automatycznie wraca do magazynu?
Zależy to od ustawienia modułu. Bezpieczniejszy wariant przywraca stan dopiero po rzeczywistym otrzymaniu lub zakończeniu zwrotu.
Natychmiastowe przywrócenie stanu może spowodować sprzedaż produktu, który fizycznie jeszcze nie wrócił.
Czy raport sprzedaży jest dokumentem księgowym?
Nie. Raport służy do analizy operacyjnej. Może łączyć sprzedaż, koszt towaru i wpisy rozliczeniowe, ale nie zastępuje ksiąg, faktur ani dokumentów dostarczanych przez operatora marketplace.
Czy statystyki zawierają wszystkie koszty prowadzenia działalności?
Nie. Raport obejmuje wyłącznie dane dostępne w sklepie i zwrócone przez API. Może nie uwzględniać między innymi kosztów podatkowych, pracy, opakowań, zewnętrznych usług, reklam spoza raportowanych danych czy różnic kursowych.
Skąd pobierana jest prowizja?
Prowizja i dostępne opłaty są pobierane z oficjalnego kalkulatora API dla kategorii, ceny i waluty oferty.
Rzeczywista opłata po sprzedaży może różnić się z powodu kampanii, rabatów, korekt lub indywidualnych warunków konta.
Czy dane dostępowe są przechowywane otwartym tekstem?
Wrażliwe dane konfiguracyjne są przechowywane w postaci zaszyfrowanej. Administrator powinien dodatkowo chronić bazę danych, pliki konfiguracyjne PrestaShop i dostęp do panelu administracyjnego.
Czy moduł gwarantuje zgodność każdej oferty z prawem?
Nie. OfferSync pomaga wykrywać brakujące dane i obsługuje mechanizmy takie jak GPSR czy oznaczenia AI, ale odpowiedzialność za treść oferty, produkt, dokumentację, podatki i zgodność sprzedaży spoczywa na sprzedawcy.
Czy moduł może sam wyrazić zgodę na udział w Allegro Ceny?
Nie. Decyzja dotycząca uczestnictwa konta lub oferty wymaga świadomej akcji użytkownika. Moduł nie powinien automatycznie zapisywać sprzedawcy do programu.
Czy przed aktualizacją lub migracją potrzebna jest kopia zapasowa?
Tak. Przed instalacją, aktualizacją, zmianą domeny albo migracją integracji należy wykonać pełną kopię bazy danych i plików sklepu.
Gdzie uzyskam pomoc techniczną?
Zgłoszenie powinno zawierać:
wersję OfferSync;
wersję PrestaShop i PHP;
informację, czy używane jest środowisko produkcyjne czy Sandbox;
identyfikator oferty lub zamówienia, jeżeli jest potrzebny;
dokładny komunikat błędu;
godzinę wystąpienia problemu;
kroki prowadzące do błędu.
Nie należy przesyłać w zgłoszeniu haseł, sekretu aplikacji, tokenów dostępowych ani pełnych danych klientów.