Jak polaczyc PrestaShop z easySales: kompletny przewodnik integracji

Polacz swoj sklep PrestaShop z easySales w trzech krokach — uruchom kreatora w easySales i pobierz modul, zainstaluj go w panelu administracyjnym PrestaShop, a nastepnie wklej token z powrotem do easySales, aby zakonczyc. Scentralizuj zamowienia, synchronizuj stany magazynowe i kombinacje, generuj listy przewozowe i faktury oraz wykorzystaj ten sam katalog jako oferty na kazdym marketplace, na ktorym sprzedajesz.

Dlaczego warto polaczyc PrestaShop z easySales

Sprzedajesz na PrestaShop i chcesz miec jedno miejsce do zarzadzania zamowieniami, generowania faktur, wysylania listow przewozowych do kurierow i wykorzystania tych samych produktow jako ofert na marketplace'ach? easySales obsluguje to wszystko z jednego pulpitu.

Po polaczeniu easySales pobiera produkty i kombinacje z PrestaShop oraz centralizuje przychodzace zamowienia. Stamtad generujesz faktury, tworzysz listy przewozowe z dowolnym obslugiwanym kurierem i zamieniasz te same produkty w oferty na Allegro, eMAG, Kaufland, Trendyol oraz ponad 80 innych kanalach. Stany magazynowe, kombinacje i statusy zamowien pozostaja zsynchronizowane w obu kierunkach.

Uruchomisz kreatora w easySales, pobierzesz modul easySales, zainstalujesz go w panelu administracyjnym PrestaShop, a nastepnie wkleisz token z easySales z powrotem do modulu — bez kodu, bez dostepu programisty, bez modyfikacji szablonu.

Interaktywny przewodnik

Nie chce ci sie czytac? Skorzystaj z interaktywnego przewodnika.

Interaktywny przewodnik — polacz PrestaShop z easySales

Jak dziala konektor PrestaShop

easySales laczy sie z PrestaShop przez maly natywny modul, ktory pobierasz ze swojego konta easySales i instalujesz w panelu administracyjnym PrestaShop. Modul udostepnia prywatny endpoint, ktory easySales wywoluje, aby odczytac twoj katalog i zamowienia, i podpina sie pod zdarzenia zamowien, stanow i produktow PrestaShop, dzieki czemu zmiany docieraja do easySales niemal w czasie rzeczywistym.

Modul nigdy nie inicjuje polaczen wychodzacych. To easySales rozmawia z nim, uwierzytelniony tokenem przypisanym do witryny, ktory easySales generuje dla ciebie. Dane logowania do bazy danych PrestaShop, konta pracownikow i klucze Web Service pozostaja wewnatrz twojej instalacji PrestaShop.

Dwie cechy PrestaShop ksztaltuja sposob konfiguracji polaczenia. Po pierwsze: PrestaShop zmienia nazwe folderu admina podczas instalacji na losowy sufiks (np. admin427xyz/) — easySales potrzebuje tej sciezki, aby dotrzec do kontrolerow modulu. Po drugie: produkty w PrestaShop niosa kombinacje (permutacje rozmiaru, koloru i innych atrybutow), kazda z wlasnym numerem referencyjnym i stanem — easySales importuje kazda kombinacje jako osobny wpis.

Wymagania wstepne — co przygotowac przed rozpoczeciem

Te wymagania utrzymuja niezawodna komunikacje modulu i zapobiegaja pomijaniu produktow przy imporcie.

Dostep do panelu administracyjnego PrestaShop

Potrzebujesz konta pracownika z uprawnieniami do instalowania modulow i odczytu strony konfiguracji modulu.

PrestaShop 1.7 lub nowszy

Konektor jest przeznaczony dla nowoczesnego Menedzera modulow. Starsze instalacje 1.6 nie sa obslugiwane przez obecny modul.

HTTPS i dostepnosc publiczna

Modul PrestaShop komunikuje sie z easySales tylko przez HTTPS, a witryna musi byc dostepna z publicznego internetu — nie za HTTP basic auth, listami dozwolonych IP ani trybem konserwacji.

Unikalny numer referencyjny dla produktu i kombinacji

Dwa produkty (lub dwie kombinacje) z tym samym numerem referencyjnym koliduja — importowany jest tylko jeden. Sprawdz i usun duplikaty przed polaczeniem.

Sciezka folderu admina

PrestaShop zmienia nazwe folderu admina przy instalacji na losowy sufiks (np. admin427xyz). easySales potrzebuje dokladnie tej sciezki, aby dotrzec do modulu.

Kilka przydatnych rzeczy o tym, jak zachowuje sie import:

  • easySales uzywa pola Reference PrestaShop jako SKU i sledzi po nim kazdy produkt. Kazdy produkt i kazda kombinacja potrzebuje unikalnego numeru referencyjnego — te bez niego sa pomijane przy imporcie.
  • Zmiana nazwy numeru referencyjnego w PrestaShop tworzy nowy produkt w easySales. Aby wczesnie wychwycic duplikaty, uzyj przycisku eksportu w Sklepy Online → Produkty.

Krok 1 — Uruchom kreatora w easySales i pobierz modul

W easySales przejdz do Integracje → Sklepy Online → Polacz witryne, a nastepnie wybierz PrestaShop. Kreator otwiera sie na kroku Pobierz modul.

Kreator Polacz witryne w easySales na kroku Pobierz modul z wybranym PrestaShop i widocznym przyciskiem pobierania modulu
Po wybraniu PrestaShop kreator otwiera sie na kroku Pobierz modul — kliknij, aby pobrac archiwum modulu easySales.

Kliknij przycisk pobierania, aby uzyskac archiwum modulu (easysales.zip). Pozostaw te karte otwarta — wrocisz do niej w Kroku 3, aby zakonczyc konfiguracje.

Krok 2 — Wgraj i zainstaluj modul w PrestaShop

W panelu administracyjnym PrestaShop przejdz do Moduly → Menedzer modulow → Wgraj modul. Upusc pobrane przed chwila archiwum easysales.zip.

Ekran Moduly → Menedzer modulow w panelu administracyjnym PrestaShop z podswietlonym przyciskiem Wgraj modul
W panelu administracyjnym PrestaShop otworz Moduly → Menedzer modulow i kliknij Wgraj modul, aby zainstalowac archiwum easySales.

PrestaShop instaluje modul i uruchamia swoje hooki konfiguracyjne. Po zakonczeniu modul pojawia sie w Menedzerze modulow w sekcji Zainstalowane moduly. Kliknij Konfiguruj w wierszu easySales — trafisz na strone ustawien modulu z polem Token na gorze. Pozostaw karte otwarta; tu wkleisz token z easySales w nastepnym kroku.

Krok 3 — Skonfiguruj witryne w easySales i wklej token w module

Wroc do karty easySales. Kreator jest teraz na kroku Konfiguracja i wyswietla wygenerowany token.

Kreator Polacz witryne w easySales na kroku Konfiguracja z wybranym PrestaShop i widocznym wygenerowanym tokenem witryny
Kreator przechodzi do Konfiguracji, gdy modul jest zainstalowany. easySales wyswietla token do skopiowania do modulu PrestaShop.

Skopiuj token wyswietlony w easySales, przejdz do karty PrestaShop, wklej go w polu Token w ustawieniach modulu easySales, a nastepnie kliknij Zapisz w PrestaShop.

Z powrotem w easySales dokoncz konfiguracje witryny. Ponizszy formularz zbiera wszystko, czego easySales potrzebuje do obslugi integracji.

Nazwa witryny, URL i sciezka admina

  • Nazwa witryny — etykieta wybrana przez ciebie. Widoczna tylko w easySales.
  • URL witryny — twoj sklep PrestaShop. Uzyj dokladnego adresu URL, pod ktorym dziala PrestaShop, wlacznie z https:// i prefiksem www, jesli twoja domena go uzywa.
  • Sciezka admina — przemianowany folder admina, ktory PrestaShop utworzyl przy instalacji (np. admin427xyz). easySales dolacza go do twojego URL, aby dotrzec do kontrolerow modulu. Bez niego polaczenie nie powiedzie sie przy zapisie.

VAT i VAT za wysylke

Jesli jestes platnikiem VAT, wprowadz stawke obowiazujaca dla twoich produktow oraz osobna stawke dla wysylki (np. 23 dla 23%). Pozostaw puste, jesli nie jestes. Wlasne reguly podatkowe PrestaShop obowiazuja dla strefy i grupy — easySales odczytuje kwoty pozycji, ktore PrestaShop wysyla, wiec to pole jest zapasowym, gdy zamowienie nie niesie podzialu podatku.

Jezyk i waluta

Wybierz jezyk sklepu (rumunski, bulgarski, wegierski, polski lub angielski) i walute (RON, BGN, HUF, PLN lub EUR). Pelnia role wartosci domyslnych dla importowanych produktow oraz zapasowych, gdy zamowienie nie niesie jawnej waluty. Nigdy nie nadpisuja poszczegolnych zamowien — kazde zamowienie zachowuje walute zgloszona przez PrestaShop.

Zrodlo stanu magazynowego produktow

Najwazniejsza decyzja w formularzu. Okresla, gdzie znajduje sie miarodajna wartosc stanu:

  • Witryna — PrestaShop jest zrodlem prawdy. easySales odczytuje stan z PrestaShop i nigdy go nie nadpisuje.
  • easySales — easySales jest zrodlem prawdy. Zmiany stanu w easySales (sprzedaze, edycje reczne, odliczenia z marketplace) sa wysylane do PrestaShop.
  • Polaczona integracja — twoj stan znajduje sie w systemie firmy trzeciej juz polaczonym z easySales (oprogramowanie do fakturowania jak SmartBill, Oblio, Fakturownia czy FacturisOnline; ERP jak NexusERP czy Sedona; partner fulfilment jak Fulfillro czy Huboxx; i wiele innych). easySales odczytuje stan z tej integracji i wysyla go do PrestaShop. Najpierw polacz integracje i zadeklaruj jej magazyn — inaczej nie wybierzesz tej opcji.

Prowadzisz operacje wielomagazynowa? Przelacz na tryb Magazyn zaawansowany. Zamiast wiazac sklep z jednym zrodlem stanu, wybierasz jeden lub wiecej magazynow easySales i definiujesz, jak ich stan jest agregowany, priorytetyzowany lub dzielony na kanal.

Domyslny typ paczki

Uzywany przy generowaniu listu przewozowego, gdy zamowienie nie okresla paczki. Wybierz typ pasujacy do wiekszosci twoich zamowien.

Kliknij Zapisz. easySales testuje polaczenie, rejestruje hooki modulu na twojej witrynie PrestaShop i rozpoczyna import katalogu.

Co dzieje sie automatycznie po zapisaniu

easySales zajmuje sie polaczeniem i poczatkowym importem za ciebie.

  1. Hooki modulu dla zamowien, stanow i produktow sa aktywowane na twojej witrynie PrestaShop. Kazde zamowienie utworzone, zaktualizowane, anulowane lub oplacone w PrestaShop dociera do easySales niemal w czasie rzeczywistym, to samo dotyczy aktualizacji stanow i produktow.
  2. Twoj katalog produktow jest importowany — produkty i kazda ich kombinacja pojawiaja sie w Sklepy Online → Produkty, gdzie mozesz je przegladac, edytowac i zamieniac w oferty dla marketplace'ow.
  3. Przychodzace zamowienia PrestaShop pojawiaja sie na ekranie Zamowienia, gdzie generujesz faktury, listy przewozowe i uruchamiasz przeplywy automatyzacji.
  4. Stan synchronizuje sie zgodnie z wybranym zrodlem. Jesli wybrales easySales, wysylki stanu zaczynaja dzialac w sposob ciagly, a twoj sklep PrestaShop odzwierciedla scentralizowany magazyn.
Z PrestaShop → easySales Z easySales → PrestaShop
Zamowienia (utworzenie, aktualizacja, anulowanie, oplacenie) Aktualizacje stanu
Produkty i kombinacje Zmiany statusu zamowienia
Poziomy stanu dla kazdej kombinacji Status realizacji z generowania listu przewozowego
Ceny produktow
Kategorie i cechy
Kurier i metoda platnosci dla kazdego zamowienia
Dane i adresy klienta
ID paczkomatow (dowolny obslugiwany modul paczkomatow)
Synchronizacja dwukierunkowa obejmuje zamowienia na wejsciu oraz stan, status i realizacje na wyjsciu.

Jestes polaczony — co dalej

Gdy zamowienia zaczna naplywac, kolejnym krokiem jest automatyzacja. Skonfiguruj przeplywy do generowania faktur, tworzenia listow przewozowych i wysylania powiadomien o sledzeniu. Jesli sprzedajesz takze na marketplace'ach, zamien katalog PrestaShop w oferty i pozwol easySales je wypchnac.

Karta nie jest wymagana
14 dni darmowego okresu testowego
Anuluj w dowolnym momencie

Polacz swoj sklep PrestaShop w kilka minut

Wyprobuj easySales za darmo przez 14 dni. Bez karty kredytowej i bez zmian w kodzie.

Często zadawane pytania

Prawie zawsze to jedna z trzech rzeczy: token witryny zostal wygenerowany ponownie po jednej stronie, a nie po drugiej; folder admina zostal przemianowany w PrestaShop bez aktualizacji sciezki admina w easySales; lub modul zostal wylaczony albo odinstalowany podczas porzadkow w panelu administracyjnym. Otworz ustawienia witryny w easySales, potwierdz, ze sciezka admina odpowiada twojemu obecnemu folderowi admina PrestaShop, skopiuj token wyswietlony w easySales i wklej go z powrotem do ustawien modulu w PrestaShop. Jesli modul nie pojawia sie juz w Menedzer modulow → Zainstalowane moduly, wgraj ponownie najnowsze archiwum z kreatora easySales — twoj token i konfiguracja sa zachowane przy aktualizacjach.

Najpierw sprawdz zrodlo stanu na witrynie easySales. Jesli jest ustawione na **Witryna**, easySales traktuje PrestaShop jako miarodajny i nigdy nie zapisuje stanu z powrotem — zmniejszenia nastepuja tylko, jesli sam PrestaShop zmniejsza przy zamowieniu (kontrolowane w PrestaShop w *Preferencje → Produkty → Ilosci*). Jesli zrodlem jest **easySales** lub **Polaczona integracja**, potwierdz, ze *Aktualizacja stanu produktow w PrestaShop* jest wlaczona w preferencjach Synchronizacji witryny. Sprawdz takze strone produktu w easySales dla tego numeru referencyjnego — jesli katalog pokazuje prawidlowy stan, ale PrestaShop go nie odzwierciedla, dziennik bledow zadania wysylki stanu na stronie produktu powie ci dokladnie, ktora kombinacja sie nie powiodla i dlaczego.

PrestaShop wysyla kuriera, na ktorym skonczylo kazde zamowienie, a easySales zachowuje te nazwe kuriera w danych dostawy zamowienia. Dla PrestaShop nie ma tabeli mapowania kurierow — easySales nie zamienia sam kuriera PrestaShop na jednego z twoich kurierow. Rzeczywisty kurier easySales jest okreslany przy generowaniu listu przewozowego: albo wybierasz go recznie, albo przypisuje go przeplyw automatyzacji. Wiec „bledny” kurier prawie zawsze oznacza, ze przeplyw generowania listu przewozowego wybral zly (lub wrocil do domyslnego) dla tej nazwy kuriera. Otworz przeplyw generowania listu przewozowego i dostosuj warunek, ktory odczytuje kuriera PrestaShop, albo wygeneruj list przewozowy recznie z wybranym kurierem.

Tak — jesli twoj sklep uzywa dowolnego obslugiwanego modulu paczkomatow, easySales automatycznie odczytuje ID paczkomatu z danych zamowienia PrestaShop. Pokrycie jest niezalezne od kraju: InPost Paczkomaty, Sameday EasyBox, Fannbox i inne sieci paczkomatow na rynkach, ktore obslugujemy, sa wspierane od razu. Dodatkowa konfiguracja nie jest potrzebna — paczkomat staje sie punktem dostawy przy generowaniu listu przewozowego. Jesli twoj modul paczkomatow przechowuje ID pod nietypowym kluczem, skontaktuj sie z pomoca, abysmy dodali go do listy automatycznego wykrywania.

easySales pobiera metode platnosci i status platnosci bezposrednio z PrestaShop i zapisuje je na zamowieniu w niezmienionej postaci — dla PrestaShop nie ma mapowania metod platnosci na poziomie witryny. Gdy PrestaShop wysyla modul platnosci, ktorego easySales nie rozpoznaje, zamowienie zachowuje oryginalna nazwe metody platnosci, ale nie otrzymuje znanego typu platnosci, i to wlasnie pokazuje sie jako puste lub „Nieznane”. Oryginalna nazwa metody pozostaje na zamowieniu, wiec mozesz na niej dzialac przeplywem automatyzacji — na przyklad ustawic typ platnosci lub wyzwolic akcje, gdy metoda platnosci pasuje do okreslonej nazwy. Jesli popularny modul platnosci w ogole nie jest rozpoznawany, skontaktuj sie z pomoca, abysmy dodali go do ustawien domyslnych.

easySales importuje produkt nadrzedny i kazda kombinacje jako osobne wpisy. Nadrzedny niesie tytul, opis, zdjecia i cechy; kazda kombinacja niesie wlasny numer referencyjny, cene, stan i wartosci atrybutow (rozmiar, kolor itd.). Kazda kombinacja potrzebuje unikalnego numeru referencyjnego w PrestaShop — kombinacje bez niego sa pomijane przy imporcie. Gdy zamieniasz produkt w oferte dla marketplace, kombinacje przychodza jako osobne oferty powiazane z tym nadrzednym, wiec mozesz wystawiac kazdy rozmiar i kolor osobno na Allegro, eMAG lub Kaufland bez ponownego wprowadzania czegokolwiek.

Czy ten przewodnik był pomocny?