PrestaShop i BaseLinker - integracja zamówień, stanów i produktów krok po kroku

Łukasz Palej

Łukasz Palej

Technical Implementation Expert

PrestaShop połączysz z BaseLinkerem, który dziś działa pod nazwą Base, przez API sklepu: w panelu PrestaShop włączasz webservice i generujesz klucz, wklejasz go w integracji PrestaShop w Base, a w sklepie instalujesz rozszerzenie Base odpowiednie dla Twojej wersji PrestaShop. Potem ustalasz, który system jest źródłem produktów i stanów, włączasz automatyczne pobieranie zamówień i uzgadniasz statusy. Samo połączenie zajmuje kilkanaście minut, a najwięcej pracy wymaga powiązanie produktów i ustalenie reguł.

W tym wpisie przechodzimy przez integrację PrestaShop i BaseLinkera krok po kroku według bazy wiedzy Base i dokumentacji PrestaShop 9. Pokazujemy, jak przygotować klucz API, jakie ustawienia zaawansowane ma integracja, jak podejść do stanów, cen i kombinacji oraz co sprawdzić, zanim pierwsze zamówienie z Allegro trafi do obsługi. Nazwy menu PrestaShop podajemy opisowo, a w nawiasie po angielsku.

[#wazne] W skrócie: integracja PrestaShop z Base działa przez webservice, czyli wbudowane API sklepu, oraz rozszerzenie Base instalowane w sklepie. Klucz generujesz w parametrach zaawansowanych (Advanced Parameters > Webservice), a w Base dodajesz integrację PrestaShop z adresem sklepu i kluczem. Przed włączeniem synchronizacji ustal jedno źródło stanów i cen oraz unikalne SKU i EAN dla każdej kombinacji. W Vinson wdrażamy sklepy na PrestaShop i jesteśmy certyfikowanym partnerem Base.

Czym jest integracja PrestaShop z BaseLinkerem i kiedy ma sens?

Base, wcześniej BaseLinker, to system do zarządzania sprzedażą w wielu kanałach: zamówieniami ze sklepu i marketplace'ów, magazynem produktów, wysyłkami i dokumentami sprzedaży. Integracja PrestaShop z Base to połączenie, w którym Base pobiera ze sklepu zamówienia i dane produktów, a do sklepu wysyła stany, ceny i zmiany statusów. Według strony integracji Base obsługuje import i eksport produktów oraz kategorii, warianty i zdjęcia, synchronizację stanów i cen z kanałami oraz automatyczne pobieranie zamówień.

Taka integracja ma największy sens, gdy sklep jest jednym z kilku kanałów sprzedaży. Typowe sytuacje to:

  • sprzedajesz w PrestaShop i na Allegro, Erli, Empik Place lub Kauflandzie, a stany muszą się zgadzać wszędzie,

  • chcesz drukować etykiety kurierskie dla wszystkich kanałów w jednym miejscu,

  • faktury i paragony mają powstawać automatycznie z jednego systemu, niezależnie od kanału,

  • masz kilka sklepów PrestaShop w trybie multistore albo kilka osobnych sklepów z jednym magazynem.

Przy jednym sklepie bez marketplace'ów Base często nie jest potrzebny. Porównanie modułów w sklepie, integratora i integracji dedykowanej opisujemy we wpisie Integracja PrestaShop z marketplace - moduły gotowe czy dedykowane. Jeśli wahasz się między dwoma popularnymi integratorami, przeczytaj tekst Apilo czy BaseLinker - który integrator wybrać do sprzedaży wielokanałowej.

Co przygotować w sklepie przed połączeniem?

Integracja przenosi dane takie, jakie są w sklepie, więc braki w PrestaShop staną się brakami w Base i na marketplace'ach. Zanim dodasz integrację, zrób kopię zapasową bazy i plików, sprawdź, czy sklep działa na aktualnej wersji z obsługiwanym PHP, i przejrzyj katalog pod kątem pustych indeksów, kodów EAN, wag i zdjęć. Spisz też aktualne statusy zamówień i moduły, które je zmieniają, np. moduły płatności i kurierów. Ta lista przyda się przy ustalaniu mapy statusów. Jeśli w sklepie działają moduły marketplace'ów, zanotuj, które oferty są przez nie wystawione, bo później trzeba je powiązać z produktami w Base.

Jak połączyć PrestaShop z BaseLinkerem krok po kroku?

Baza wiedzy Base opisuje połączenie przez klucz API sklepu i rozszerzenie instalowane w PrestaShop. Cały proces pokazuje diagram:

[#chart:prs17a]

  1. Włącz webservice w PrestaShop. W parametrach zaawansowanych, w sekcji webservice (Advanced Parameters > Webservice), włącz opcję webservice sklepu (Enable PrestaShop's webservice). Dokumentacja PrestaShop przypomina, że sklep powinien działać na bezpiecznym połączeniu SSL.

  2. Dodaj klucz. Przyciskiem dodania klucza (Add new webservice key) wygeneruj klucz, wpisz opis, np. „Base - integracja”, ustaw status na włączony i nadaj uprawnienia. Baza wiedzy Base każe nadać wszystkie uprawnienia, w tym do zasobu bl_orders i pozostałych zasobów z przedrostkiem bl_.

  3. Dodaj integrację w Base. W Base przejdź do integracji, dodaj nową, w sekcji sklepów wybierz PrestaShop. Wpisz nazwę wyświetlaną (do 15 znaków) i adres sklepu - samą domenę, bez http i https.

  4. Wklej klucz i zapisz. Skopiuj klucz z PrestaShop do pola klucza API w Base i zapisz integrację.

  5. Zainstaluj rozszerzenie. Pobierz rozszerzenie sklepowe Base ze strony rozszerzeń w dokumentacji dla deweloperów Base i zainstaluj je w menedżerze modułów (Modules > Module Manager). To ono dodaje zasoby bl_, z których korzysta integracja.

Rozszerzenie Base a wersja PrestaShop

Base publikuje rozszerzenie dla PrestaShop w kilku wersjach, przygotowanych dla różnych gałęzi sklepu, a przy każdej podaje datę wydania. Baza wiedzy zaznacza, że wersje dla starszych i nowszych gałęzi znacząco się różnią i że w razie problemów można wrócić do poprzedniej wersji. Przed instalacją sprawdź na stronie rozszerzeń, która paczka obsługuje Twoją wersję PrestaShop, w tym gałąź 9, i zapisz numer zainstalowanej wersji w dokumentacji sklepu (stan na sierpień 2026 - sprawdź aktualną listę rozszerzeń).

Klucz z pełnymi uprawnieniami - jak go chronić?

Ogólna zasada dla kluczy API mówi, że każda integracja powinna mieć tylko potrzebne uprawnienia. Base wymaga jednak pełnego zakresu, bo pobiera i zapisuje wiele typów danych. Dlatego ten klucz traktuj jak hasło administratora: używaj go wyłącznie dla Base, nie przekazuj innym narzędziom, opisz w polu opisu, do czego służy, i wyłącz go statusem, gdy przestaniesz korzystać z integracji. Gdy integrację obsługuje kilka osób lub agencja, zapisz klucz w menedżerze haseł, a nie w arkuszu.

PrestaShop połączysz z BaseLinkerem, który dziś działa pod nazwą Base, przez API sklepu: w panelu PrestaShop włączasz webservice i generujesz klucz, wklejasz go w integracji PrestaShop w Base, a w sklepie instalujesz rozszerzenie Base odpowiednie dla Twojej wersji PrestaShop. Potem ustalasz, który system jest źródłem produktów i stanów, włączasz automatyczne pobieranie zamówień i uzgadniasz statusy. Samo połączenie zajmuje kilkanaście minut, a najwięcej pracy wymaga powiązanie produktów i ustalenie reguł.

W tym wpisie przechodzimy przez integrację PrestaShop i BaseLinkera krok po kroku według bazy wiedzy Base i dokumentacji PrestaShop 9. Pokazujemy, jak przygotować klucz API, jakie ustawienia zaawansowane ma integracja, jak podejść do stanów, cen i kombinacji oraz co sprawdzić, zanim pierwsze zamówienie z Allegro trafi do obsługi. Nazwy menu PrestaShop podajemy opisowo, a w nawiasie po angielsku.

[#wazne] W skrócie: integracja PrestaShop z Base działa przez webservice, czyli wbudowane API sklepu, oraz rozszerzenie Base instalowane w sklepie. Klucz generujesz w parametrach zaawansowanych (Advanced Parameters > Webservice), a w Base dodajesz integrację PrestaShop z adresem sklepu i kluczem. Przed włączeniem synchronizacji ustal jedno źródło stanów i cen oraz unikalne SKU i EAN dla każdej kombinacji. W Vinson wdrażamy sklepy na PrestaShop i jesteśmy certyfikowanym partnerem Base.

Czym jest integracja PrestaShop z BaseLinkerem i kiedy ma sens?

Base, wcześniej BaseLinker, to system do zarządzania sprzedażą w wielu kanałach: zamówieniami ze sklepu i marketplace'ów, magazynem produktów, wysyłkami i dokumentami sprzedaży. Integracja PrestaShop z Base to połączenie, w którym Base pobiera ze sklepu zamówienia i dane produktów, a do sklepu wysyła stany, ceny i zmiany statusów. Według strony integracji Base obsługuje import i eksport produktów oraz kategorii, warianty i zdjęcia, synchronizację stanów i cen z kanałami oraz automatyczne pobieranie zamówień.

Taka integracja ma największy sens, gdy sklep jest jednym z kilku kanałów sprzedaży. Typowe sytuacje to:

  • sprzedajesz w PrestaShop i na Allegro, Erli, Empik Place lub Kauflandzie, a stany muszą się zgadzać wszędzie,

  • chcesz drukować etykiety kurierskie dla wszystkich kanałów w jednym miejscu,

  • faktury i paragony mają powstawać automatycznie z jednego systemu, niezależnie od kanału,

  • masz kilka sklepów PrestaShop w trybie multistore albo kilka osobnych sklepów z jednym magazynem.

Przy jednym sklepie bez marketplace'ów Base często nie jest potrzebny. Porównanie modułów w sklepie, integratora i integracji dedykowanej opisujemy we wpisie Integracja PrestaShop z marketplace - moduły gotowe czy dedykowane. Jeśli wahasz się między dwoma popularnymi integratorami, przeczytaj tekst Apilo czy BaseLinker - który integrator wybrać do sprzedaży wielokanałowej.

Co przygotować w sklepie przed połączeniem?

Integracja przenosi dane takie, jakie są w sklepie, więc braki w PrestaShop staną się brakami w Base i na marketplace'ach. Zanim dodasz integrację, zrób kopię zapasową bazy i plików, sprawdź, czy sklep działa na aktualnej wersji z obsługiwanym PHP, i przejrzyj katalog pod kątem pustych indeksów, kodów EAN, wag i zdjęć. Spisz też aktualne statusy zamówień i moduły, które je zmieniają, np. moduły płatności i kurierów. Ta lista przyda się przy ustalaniu mapy statusów. Jeśli w sklepie działają moduły marketplace'ów, zanotuj, które oferty są przez nie wystawione, bo później trzeba je powiązać z produktami w Base.

Jak połączyć PrestaShop z BaseLinkerem krok po kroku?

Baza wiedzy Base opisuje połączenie przez klucz API sklepu i rozszerzenie instalowane w PrestaShop. Cały proces pokazuje diagram:

[#chart:prs17a]

  1. Włącz webservice w PrestaShop. W parametrach zaawansowanych, w sekcji webservice (Advanced Parameters > Webservice), włącz opcję webservice sklepu (Enable PrestaShop's webservice). Dokumentacja PrestaShop przypomina, że sklep powinien działać na bezpiecznym połączeniu SSL.

  2. Dodaj klucz. Przyciskiem dodania klucza (Add new webservice key) wygeneruj klucz, wpisz opis, np. „Base - integracja”, ustaw status na włączony i nadaj uprawnienia. Baza wiedzy Base każe nadać wszystkie uprawnienia, w tym do zasobu bl_orders i pozostałych zasobów z przedrostkiem bl_.

  3. Dodaj integrację w Base. W Base przejdź do integracji, dodaj nową, w sekcji sklepów wybierz PrestaShop. Wpisz nazwę wyświetlaną (do 15 znaków) i adres sklepu - samą domenę, bez http i https.

  4. Wklej klucz i zapisz. Skopiuj klucz z PrestaShop do pola klucza API w Base i zapisz integrację.

  5. Zainstaluj rozszerzenie. Pobierz rozszerzenie sklepowe Base ze strony rozszerzeń w dokumentacji dla deweloperów Base i zainstaluj je w menedżerze modułów (Modules > Module Manager). To ono dodaje zasoby bl_, z których korzysta integracja.

Rozszerzenie Base a wersja PrestaShop

Base publikuje rozszerzenie dla PrestaShop w kilku wersjach, przygotowanych dla różnych gałęzi sklepu, a przy każdej podaje datę wydania. Baza wiedzy zaznacza, że wersje dla starszych i nowszych gałęzi znacząco się różnią i że w razie problemów można wrócić do poprzedniej wersji. Przed instalacją sprawdź na stronie rozszerzeń, która paczka obsługuje Twoją wersję PrestaShop, w tym gałąź 9, i zapisz numer zainstalowanej wersji w dokumentacji sklepu (stan na sierpień 2026 - sprawdź aktualną listę rozszerzeń).

Klucz z pełnymi uprawnieniami - jak go chronić?

Ogólna zasada dla kluczy API mówi, że każda integracja powinna mieć tylko potrzebne uprawnienia. Base wymaga jednak pełnego zakresu, bo pobiera i zapisuje wiele typów danych. Dlatego ten klucz traktuj jak hasło administratora: używaj go wyłącznie dla Base, nie przekazuj innym narzędziom, opisz w polu opisu, do czego służy, i wyłącz go statusem, gdy przestaniesz korzystać z integracji. Gdy integrację obsługuje kilka osób lub agencja, zapisz klucz w menedżerze haseł, a nie w arkuszu.

Bezpłatna konsultacja PrestaShop
Chcesz uruchomić lub rozwinąć sklep na PrestaShop?
  • Przegląd sklepu, konfiguracji i integracji
  • Płatności, wysyłki i połączenie z marketplace’ami
  • Plan rozwoju sprzedaży krok po kroku
Łukasz PalejKonsultację poprowadzi Łukasz Palej, Technical Implementation Expert

Produkty i stany - który system jest źródłem danych?

Najważniejsza decyzja przy integracji PrestaShop z Base to wybór źródła prawdy. Jeśli stany i ceny mogą zmieniać się w dwóch miejscach, prędzej czy później jedna synchronizacja nadpisze drugą. Base pozwala zarówno zaimportować produkty z zewnętrznego magazynu, np. sklepu, jak i eksportować produkty do sklepu - baza wiedzy wymienia oba scenariusze jako osobne instrukcje. Wybór zależy od tego, gdzie Twój zespół pracuje na co dzień:

[#chart:prs17b]

Gdy źródło jest wybrane, stany przepływają w jedną stronę: z systemu wiodącego do pozostałych. Sprzedaż w dowolnym kanale zmniejsza stan w systemie wiodącym, a ten aktualizuje sklep i marketplace'y. O tym, jak zbudować taki przepływ i jak uniknąć sprzedaży towaru, którego już nie ma, piszemy w tekście Synchronizacja stanów magazynowych między sklepem a marketplace - jak ją zbudować.

Kombinacje, SKU i EAN

Base łączy produkty i warianty z różnych kanałów po identyfikatorach. W PrestaShop każda kombinacja ma własny indeks (reference) i kody, które ustawiasz w edycji kombinacji. Zanim zaimportujesz katalog do Base, sprawdź, czy indeksy są unikalne i wypełnione dla każdego wariantu. Pusty lub powtórzony indeks to najczęstsza przyczyna sytuacji, w której stan jednego rozmiaru trafia do innego albo oferta na marketplace nie łączy się z produktem w magazynie. Uzupełnij też kody EAN, bo marketplace'y często wymagają ich do połączenia oferty z kartą produktu.

Ustawienia zaawansowane integracji PrestaShop w Base

Po zapisaniu integracji przejdź do jej ustawień i zakładki ustawień zaawansowanych. Baza wiedzy Base opisuje tam kilka parametrów, które rozwiązują typowe problemy:

ParametrDo czego służy według bazy wiedzy BaseKiedy go użyć
presta_shop_idID sklepu w trybie multistoregdy integracja ma obsługiwać jeden z kilku sklepów
og_ignore_shop_idpobieranie zamówień ze wszystkich ID sklepów jednym połączeniemmultistore z jednym magazynem
og_delayopóźnienie pobierania zamówień, np. o kilka minutgdy pojawiają się duplikaty lub niepełne zamówienia
special_pricesuwzględnianie cen specjalnych i reguł cenowychgdy w sklepie działają ceny szczególne lub promocje katalogowe
language, currencyjęzyk i waluta sklepu, domyślnie PL i PLNsklep z innym językiem lub walutą domyślną
max_req_idsliczba identyfikatorów w jednym zapytaniuzmniejsz o połowę przy problemach z pobieraniem produktów

Ceny i promocje w synchronizacji

Ceny wymagają takiej samej decyzji jak stany. Jeśli cena bazowa produktu ma się zmieniać w Base, nie poprawiaj jej ręcznie w formularzu produktu PrestaShop, bo kolejna synchronizacja ją nadpisze. Osobnej uwagi wymagają ceny szczególne (specific prices) i reguły cenowe katalogu. Klient w sklepie widzi cenę po rabacie, a integracja bez parametru special_prices może przekazywać cenę bazową. Ustal, czy promocje prowadzisz w sklepie, czy w Base, i sprawdź na kilku produktach, jaką cenę widzisz w Base i na marketplace'ach po włączeniu synchronizacji.

Pamiętaj też o podatkach. Cena w PrestaShop wynika z ceny netto i reguły podatkowej przypisanej do produktu, a Base i marketplace'y operują zwykle cenami brutto. Przy produktach w stawkach obniżonych porównaj cenę brutto w sklepie z ceną w Base, zanim uruchomisz masową aktualizację cen.

Ile trwa i kosztuje wdrożenie?

Samo połączenie PrestaShop z Base to kilkanaście minut pracy. Czas wdrożenia zależy głównie od stanu danych: liczby produktów i kombinacji, jakości indeksów, liczby kanałów i tego, ile istniejących ofert trzeba powiązać z produktami. Do budżetu dolicz abonament Base, którego wysokość zależy od wybranego planu i skali sprzedaży - aktualne warunki sprawdź w cenniku Base. Najwięcej czasu oszczędza uporządkowanie katalogu przed połączeniem, a nie poprawianie go po pierwszym imporcie.

Zamówienia i statusy w integracji PrestaShop z Base

Base pobiera zamówienia ze sklepu automatycznie. Według strony integracji w ramach automatyzacji może też zmieniać status zamówienia w sklepie i wysyłać klientowi powiadomienie z numerem przesyłki. Baza wiedzy nie opisuje szczegółów mapowania statusów, dlatego ustalenia warto spisać samemu, zanim włączysz automatyczne akcje. Dobra praktyka to prosty plan:

  • Obsługa w jednym miejscu - zamówienia ze wszystkich kanałów realizujesz w Base, a w PrestaShop pracownicy ich nie przesuwają ręcznie.

  • Mapa statusów - dla każdego etapu w Base, np. opłacone, do spakowania, wysłane, wskaż odpowiadający status w PrestaShop.

  • E-maile bez dubli - w PrestaShop status może wysyłać klientowi e-mail przy zmianie (Send an e-mail to customer when his/her order status has changed). Jeśli powiadomienia wysyła też Base, wyłącz jedną z dróg.

  • Płatności - statusy płatności zmienia moduł operatora w sklepie, więc sprawdź, czy Base pobiera zamówienie dopiero po opłaceniu, czy od razu.

Według strony integracji zwroty z PrestaShop trafiają do modułu zwrotów w Base. Pamiętaj, że zwroty w PrestaShop są domyślnie wyłączone, a przyjęcie zwrotu na stan rób tylko w jednym systemie - inaczej towar zostanie policzony podwójnie po najbliższej synchronizacji.

[#przyklad] Sklep odzieżowy sprzedaje w PrestaShop i na Allegro. Katalog i stany prowadzi w Base, który eksportuje produkty do sklepu i na bieżąco aktualizuje w nim stany. Zamówienia z obu kanałów trafiają do Base, gdzie magazyn drukuje etykiety, a akcja automatyczna po nadaniu paczki zmienia status zamówienia w PrestaShop na wysłane. E-mail o wysyłce wysyła tylko PrestaShop.

Najczęstsze problemy z integracją PrestaShop i BaseLinkera

Większość zgłoszeń dotyczących integracji ma kilka powtarzalnych przyczyn. Zebraliśmy objawy i poprawki, od których warto zacząć:

[#chart:prs17c]

Po każdej aktualizacji PrestaShop sprawdź też rozszerzenie Base. Nowa wersja sklepu może wymagać nowszej paczki rozszerzenia, a problem zwykle wychodzi dopiero wtedy, gdy zamówienia przestają spływać. Aktualizację sklepu zrób najpierw na kopii z podłączoną testową integracją, a po wdrożeniu złóż zamówienie testowe i sprawdź, czy dotarło do Base.

[#checklista] Integracja PrestaShop z Base przed startem: SSL działa, webservice włączony, klucz tylko dla Base z opisem, rozszerzenie zgodne z wersją sklepu, źródło stanów i cen ustalone, indeksy i EAN kombinacji unikalne, ceny szczególne uwzględnione, mapa statusów spisana, e-maile do klientów bez dubli, zamówienie testowe z każdego kanału obsłużone do końca.

Jak Vinson pomaga z integracją PrestaShop i Base

W Vinson wdrażamy, rozwijamy i utrzymujemy sklepy na PrestaShop, a jako certyfikowany partner Base łączymy je z marketplace'ami i resztą procesów:

  • podłączamy PrestaShop do Base i dobieramy wersję rozszerzenia do sklepu,

  • porządkujemy indeksy i kody EAN kombinacji przed importem katalogu,

  • ustalamy źródło stanów i cen oraz mapę statusów zamówień,

  • konfigurujemy akcje automatyczne, etykiety i dokumenty sprzedaży,

  • testujemy integrację po aktualizacjach sklepu i rozszerzenia.

Szczegóły współpracy znajdziesz na stronie sklep na PrestaShop z Vinson.

Najczęściej zadawane pytania

Jak połączyć PrestaShop z BaseLinkerem?

W PrestaShop włącz webservice i wygeneruj klucz z uprawnieniami w parametrach zaawansowanych. W Base dodaj integrację PrestaShop, wpisz domenę sklepu bez http i wklej klucz. Na koniec zainstaluj w sklepie rozszerzenie Base w wersji odpowiedniej dla Twojej wersji PrestaShop.

Czy BaseLinker działa z PrestaShop 9?

Base udostępnia rozszerzenie dla PrestaShop w kilku wersjach, przygotowanych dla różnych gałęzi sklepu. Przed instalacją sprawdź na stronie rozszerzeń Base, która wersja obsługuje Twoją wersję PrestaShop, i przetestuj integrację na kopii sklepu.

Jakie uprawnienia musi mieć klucz webservice dla Base?

Według bazy wiedzy Base klucz powinien mieć wszystkie uprawnienia, w tym do zasobu bl_orders i pozostałych zasobów z przedrostkiem bl_, które dodaje rozszerzenie. Używaj tego klucza wyłącznie dla Base i przechowuj go jak hasło administratora.

Dlaczego zamówienia z PrestaShop dublują się w Base?

Zwykle Base pobiera zamówienie, zanim sklep zapisze je w całości, albo integracja w trybie multistore pobiera te same zamówienia kilka razy. Baza wiedzy Base zaleca wtedy parametr opóźnienia pobierania zamówień, np. o kilka minut, i sprawdzenie ustawień ID sklepu.

Czy po podłączeniu Base potrzebuję modułu Allegro w PrestaShop?

Zwykle nie. Base łączy się z Allegro i innymi marketplace'ami po swojej stronie, a ze sklepem jednym połączeniem. Moduły marketplace'ów w sklepie można wtedy wyłączyć, ale wcześniej powiąż istniejące oferty z produktami w Base, żeby nie wystawić ich drugi raz.

Dobrze zaplanowana integracja PrestaShop z BaseLinkerem to zgodne stany we wszystkich kanałach i zamówienia obsługiwane w jednym miejscu. Jeśli chcesz połączyć sklep z Base albo uporządkować istniejącą integrację, sprawdź wdrożenie sklepu na PrestaShop z Vinson - zaczniemy od przeglądu Twoich kanałów sprzedaży i danych produktów.

Produkty i stany - który system jest źródłem danych?

Najważniejsza decyzja przy integracji PrestaShop z Base to wybór źródła prawdy. Jeśli stany i ceny mogą zmieniać się w dwóch miejscach, prędzej czy później jedna synchronizacja nadpisze drugą. Base pozwala zarówno zaimportować produkty z zewnętrznego magazynu, np. sklepu, jak i eksportować produkty do sklepu - baza wiedzy wymienia oba scenariusze jako osobne instrukcje. Wybór zależy od tego, gdzie Twój zespół pracuje na co dzień:

[#chart:prs17b]

Gdy źródło jest wybrane, stany przepływają w jedną stronę: z systemu wiodącego do pozostałych. Sprzedaż w dowolnym kanale zmniejsza stan w systemie wiodącym, a ten aktualizuje sklep i marketplace'y. O tym, jak zbudować taki przepływ i jak uniknąć sprzedaży towaru, którego już nie ma, piszemy w tekście Synchronizacja stanów magazynowych między sklepem a marketplace - jak ją zbudować.

Kombinacje, SKU i EAN

Base łączy produkty i warianty z różnych kanałów po identyfikatorach. W PrestaShop każda kombinacja ma własny indeks (reference) i kody, które ustawiasz w edycji kombinacji. Zanim zaimportujesz katalog do Base, sprawdź, czy indeksy są unikalne i wypełnione dla każdego wariantu. Pusty lub powtórzony indeks to najczęstsza przyczyna sytuacji, w której stan jednego rozmiaru trafia do innego albo oferta na marketplace nie łączy się z produktem w magazynie. Uzupełnij też kody EAN, bo marketplace'y często wymagają ich do połączenia oferty z kartą produktu.

Ustawienia zaawansowane integracji PrestaShop w Base

Po zapisaniu integracji przejdź do jej ustawień i zakładki ustawień zaawansowanych. Baza wiedzy Base opisuje tam kilka parametrów, które rozwiązują typowe problemy:

ParametrDo czego służy według bazy wiedzy BaseKiedy go użyć
presta_shop_idID sklepu w trybie multistoregdy integracja ma obsługiwać jeden z kilku sklepów
og_ignore_shop_idpobieranie zamówień ze wszystkich ID sklepów jednym połączeniemmultistore z jednym magazynem
og_delayopóźnienie pobierania zamówień, np. o kilka minutgdy pojawiają się duplikaty lub niepełne zamówienia
special_pricesuwzględnianie cen specjalnych i reguł cenowychgdy w sklepie działają ceny szczególne lub promocje katalogowe
language, currencyjęzyk i waluta sklepu, domyślnie PL i PLNsklep z innym językiem lub walutą domyślną
max_req_idsliczba identyfikatorów w jednym zapytaniuzmniejsz o połowę przy problemach z pobieraniem produktów

Ceny i promocje w synchronizacji

Ceny wymagają takiej samej decyzji jak stany. Jeśli cena bazowa produktu ma się zmieniać w Base, nie poprawiaj jej ręcznie w formularzu produktu PrestaShop, bo kolejna synchronizacja ją nadpisze. Osobnej uwagi wymagają ceny szczególne (specific prices) i reguły cenowe katalogu. Klient w sklepie widzi cenę po rabacie, a integracja bez parametru special_prices może przekazywać cenę bazową. Ustal, czy promocje prowadzisz w sklepie, czy w Base, i sprawdź na kilku produktach, jaką cenę widzisz w Base i na marketplace'ach po włączeniu synchronizacji.

Pamiętaj też o podatkach. Cena w PrestaShop wynika z ceny netto i reguły podatkowej przypisanej do produktu, a Base i marketplace'y operują zwykle cenami brutto. Przy produktach w stawkach obniżonych porównaj cenę brutto w sklepie z ceną w Base, zanim uruchomisz masową aktualizację cen.

Ile trwa i kosztuje wdrożenie?

Samo połączenie PrestaShop z Base to kilkanaście minut pracy. Czas wdrożenia zależy głównie od stanu danych: liczby produktów i kombinacji, jakości indeksów, liczby kanałów i tego, ile istniejących ofert trzeba powiązać z produktami. Do budżetu dolicz abonament Base, którego wysokość zależy od wybranego planu i skali sprzedaży - aktualne warunki sprawdź w cenniku Base. Najwięcej czasu oszczędza uporządkowanie katalogu przed połączeniem, a nie poprawianie go po pierwszym imporcie.

Zamówienia i statusy w integracji PrestaShop z Base

Base pobiera zamówienia ze sklepu automatycznie. Według strony integracji w ramach automatyzacji może też zmieniać status zamówienia w sklepie i wysyłać klientowi powiadomienie z numerem przesyłki. Baza wiedzy nie opisuje szczegółów mapowania statusów, dlatego ustalenia warto spisać samemu, zanim włączysz automatyczne akcje. Dobra praktyka to prosty plan:

  • Obsługa w jednym miejscu - zamówienia ze wszystkich kanałów realizujesz w Base, a w PrestaShop pracownicy ich nie przesuwają ręcznie.

  • Mapa statusów - dla każdego etapu w Base, np. opłacone, do spakowania, wysłane, wskaż odpowiadający status w PrestaShop.

  • E-maile bez dubli - w PrestaShop status może wysyłać klientowi e-mail przy zmianie (Send an e-mail to customer when his/her order status has changed). Jeśli powiadomienia wysyła też Base, wyłącz jedną z dróg.

  • Płatności - statusy płatności zmienia moduł operatora w sklepie, więc sprawdź, czy Base pobiera zamówienie dopiero po opłaceniu, czy od razu.

Według strony integracji zwroty z PrestaShop trafiają do modułu zwrotów w Base. Pamiętaj, że zwroty w PrestaShop są domyślnie wyłączone, a przyjęcie zwrotu na stan rób tylko w jednym systemie - inaczej towar zostanie policzony podwójnie po najbliższej synchronizacji.

[#przyklad] Sklep odzieżowy sprzedaje w PrestaShop i na Allegro. Katalog i stany prowadzi w Base, który eksportuje produkty do sklepu i na bieżąco aktualizuje w nim stany. Zamówienia z obu kanałów trafiają do Base, gdzie magazyn drukuje etykiety, a akcja automatyczna po nadaniu paczki zmienia status zamówienia w PrestaShop na wysłane. E-mail o wysyłce wysyła tylko PrestaShop.

Najczęstsze problemy z integracją PrestaShop i BaseLinkera

Większość zgłoszeń dotyczących integracji ma kilka powtarzalnych przyczyn. Zebraliśmy objawy i poprawki, od których warto zacząć:

[#chart:prs17c]

Po każdej aktualizacji PrestaShop sprawdź też rozszerzenie Base. Nowa wersja sklepu może wymagać nowszej paczki rozszerzenia, a problem zwykle wychodzi dopiero wtedy, gdy zamówienia przestają spływać. Aktualizację sklepu zrób najpierw na kopii z podłączoną testową integracją, a po wdrożeniu złóż zamówienie testowe i sprawdź, czy dotarło do Base.

[#checklista] Integracja PrestaShop z Base przed startem: SSL działa, webservice włączony, klucz tylko dla Base z opisem, rozszerzenie zgodne z wersją sklepu, źródło stanów i cen ustalone, indeksy i EAN kombinacji unikalne, ceny szczególne uwzględnione, mapa statusów spisana, e-maile do klientów bez dubli, zamówienie testowe z każdego kanału obsłużone do końca.

Jak Vinson pomaga z integracją PrestaShop i Base

W Vinson wdrażamy, rozwijamy i utrzymujemy sklepy na PrestaShop, a jako certyfikowany partner Base łączymy je z marketplace'ami i resztą procesów:

  • podłączamy PrestaShop do Base i dobieramy wersję rozszerzenia do sklepu,

  • porządkujemy indeksy i kody EAN kombinacji przed importem katalogu,

  • ustalamy źródło stanów i cen oraz mapę statusów zamówień,

  • konfigurujemy akcje automatyczne, etykiety i dokumenty sprzedaży,

  • testujemy integrację po aktualizacjach sklepu i rozszerzenia.

Szczegóły współpracy znajdziesz na stronie sklep na PrestaShop z Vinson.

Najczęściej zadawane pytania

Jak połączyć PrestaShop z BaseLinkerem?

W PrestaShop włącz webservice i wygeneruj klucz z uprawnieniami w parametrach zaawansowanych. W Base dodaj integrację PrestaShop, wpisz domenę sklepu bez http i wklej klucz. Na koniec zainstaluj w sklepie rozszerzenie Base w wersji odpowiedniej dla Twojej wersji PrestaShop.

Czy BaseLinker działa z PrestaShop 9?

Base udostępnia rozszerzenie dla PrestaShop w kilku wersjach, przygotowanych dla różnych gałęzi sklepu. Przed instalacją sprawdź na stronie rozszerzeń Base, która wersja obsługuje Twoją wersję PrestaShop, i przetestuj integrację na kopii sklepu.

Jakie uprawnienia musi mieć klucz webservice dla Base?

Według bazy wiedzy Base klucz powinien mieć wszystkie uprawnienia, w tym do zasobu bl_orders i pozostałych zasobów z przedrostkiem bl_, które dodaje rozszerzenie. Używaj tego klucza wyłącznie dla Base i przechowuj go jak hasło administratora.

Dlaczego zamówienia z PrestaShop dublują się w Base?

Zwykle Base pobiera zamówienie, zanim sklep zapisze je w całości, albo integracja w trybie multistore pobiera te same zamówienia kilka razy. Baza wiedzy Base zaleca wtedy parametr opóźnienia pobierania zamówień, np. o kilka minut, i sprawdzenie ustawień ID sklepu.

Czy po podłączeniu Base potrzebuję modułu Allegro w PrestaShop?

Zwykle nie. Base łączy się z Allegro i innymi marketplace'ami po swojej stronie, a ze sklepem jednym połączeniem. Moduły marketplace'ów w sklepie można wtedy wyłączyć, ale wcześniej powiąż istniejące oferty z produktami w Base, żeby nie wystawić ich drugi raz.

Dobrze zaplanowana integracja PrestaShop z BaseLinkerem to zgodne stany we wszystkich kanałach i zamówienia obsługiwane w jednym miejscu. Jeśli chcesz połączyć sklep z Base albo uporządkować istniejącą integrację, sprawdź wdrożenie sklepu na PrestaShop z Vinson - zaczniemy od przeglądu Twoich kanałów sprzedaży i danych produktów.

Czy ten artykuł był pomocny? Oceń go
Bądź pierwszą osobą, która oceni

Łukasz Palej

Technical Implementation Expert

Wdraża integracje i rozwiązania IT dla e-commerce: sklepy, feedy produktowe, przepływ danych między systemami.

Wdraża integracje i rozwiązania IT dla e-commerce: sklepy, feedy produktowe, przepływ danych między systemami.

★★★★★
Współpracowałeś z Vinson?
Twoja opinia pomoże innym sprzedawcom wybrać sprawdzoną agencję. Zajmie Ci to minutę.
Oceń nas na Trustpilot →
Potrzebujesz pomocy z tym tematem?

Sklep na PrestaShop z Vinson

Łukasz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie - bez zobowiązań.

  • Analiza Twojego konta i obecnych działań
  • Konkretny plan poprawek do wdrożenia
  • Bezpłatna konsultacja – bez zobowiązań
4,9/5 ze 171 opiniiWdrażamy i obsługujemy PrestaShop
Łukasz Palej - Technical Implementation Expert
Łukasz PalejTechnical Implementation Expert

Przeczytaj także

Więcej porad z naszej bazy wiedzy - przesuń, aby zobaczyć kolejne artykuły.

1 / 1

Masz pytania? Chętnie porozmawiamy!

Masz pytania? Chętnie porozmawiamy!

Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.

Masz pytania? Chętnie porozmawiamy!

Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.

Bartłomiej Stokłosa, CEO Vinson Agency

Bartłomiej Stokłosa

CEO & Founder

"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."

Bartłomiej Stokłosa, CEO Vinson Agency

Bartłomiej Stokłosa

CEO & Founder

"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."

Zadzwoń

574 944 685

Adres

Kazimierza Wielkiego 7/7

32-700 Bochnia

Wybierz dogodny termin w kalendarzu - bez wymiany maili w tę i z powrotem.

Napisz do nas

Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.

Łukasz PalejNa zapytanie odpowie Łukasz Palej, Technical Implementation Expert

Napisz do nas

Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.

Łukasz PalejNa zapytanie odpowie Łukasz Palej, Technical Implementation Expert
4,9172 opinii klientów · Trustindex →