BaseLinker PrestaShop – instalacja modułu i konfiguracja integracji

Moduł BaseLinker dla PrestaShop – co dodaje do integracji

Moduł rozszerzający jest szczególnie ważny dla sklepów, które korzystają z popularnych modułów dostaw, faktur i płatności. Na liście obsługiwanych funkcji na stronie Base znajdziesz m.in.:

• dane punktów odbioru z wielu modułów dostaw – m.in. InPost, Furgonetka, Sendcloud, DPD, DHL, GLS, Orlen Paczka, Poczty Polskiej czy modułów firmy Sensbit,

• metodę wysyłki i punkt odbioru z modułu X13Allegro – przydatne, gdy sklep ma już własne połączenie z Allegro,

• wybór dokumentu sprzedaży z modułów typu „paragon czy faktura”, tak aby Base wiedział, co wystawić klientowi,

• opłaty dodatkowe za płatność, np. przez Przelewy24 czy wybrane moduły PayPal i Stripe,

• nazwy rabatów z reguł koszyka, które trafiają do zamówienia w Base,

• obsługę zwrotów zamówień w PrestaShop 9 i nowszych – statusy zwrotów i szczegóły zwracanych produktów.

W praktyce oznacza to, że zamówienie z paczkomatem trafia do Base razem z kodem punktu, więc etykietę można wygenerować od razu, bez ręcznego uzupełniania danych. Jak skonfigurować nadawanie przesyłek, opisujemy w artykule BaseLinker InPost – Paczkomaty i nadawanie przesyłek.

Moduł warto aktualizować razem ze sklepem. Po większej aktualizacji PrestaShop sprawdź na stronie Base, czy dla Twojej wersji nie pojawiła się nowsza paczka, a po instalacji upewnij się, że klucz API nadal ma uprawnienia do wszystkich zasobów bl_. Gdy nowa wersja sprawia problemy, wróć do poprzedniej paczki i zgłoś sprawę supportowi Base.

[#uwaga] Jeśli sklep pobiera zamówienia z Allegro przez własny moduł (np. X13Allegro), a jednocześnie podłączasz to samo konto Allegro do Base, zamówienia będą się dublować. Pomoc Base zaleca wyłączenie zewnętrznych rozwiązań pobierających zamówienia z Allegro do sklepu. Zamówienie, które przeszło przez taki moduł, Base traktuje jak zamówienie ze sklepu – bez możliwości nadania przesyłki w programie Allegro.

Parametry zaawansowane integracji BaseLinker PrestaShop

W ustawieniach integracji, w zakładce Zaawansowane, Base udostępnia dodatkowe parametry sklepu. Pomoc Base wyróżnia kilka, które warto znać od pierwszego dnia:

Wykres – najważniejsze parametry zaawansowane integracji PrestaShop i sytuacje, w których warto je zmienić. [#chart:b20b]

[#przyklad] Sklep pobiera zamówienia z PrestaShop co minutę i co jakiś czas widzi w Base podwójne albo niepełne zamówienia – bez metody płatności czy z brakującą pozycją. Pomoc Base wskazuje, że problem może leżeć po stronie sklepu, i proponuje ustawić og_delay na 5 minut. Proces pobierania nadal startuje co minutę, ale ignoruje zamówienia złożone w ciągu ostatnich 5 minut, więc PrestaShop zdąży zapisać je w całości.

Parametrów jest więcej niż w tabeli. Jeśli nie masz pewności, co robi dany parametr, skonsultuj zmianę z supportem Base – źle ustawiony język czy waluta potrafią po cichu zepsuć ceny w ofertach.

Zamówienia, statusy i płatności z PrestaShop w Base

Pobieranie zamówień włączasz w Integracje → PrestaShop → Ustawienia → Zamówienia. Domyślnie Base pobiera zamówienia ze sklepu co 10 minut, opcjonalnie co minutę, a ręcznie – w każdej chwili. Po pierwszym włączeniu w ciągu godziny pojawiają się zamówienia z ostatnich 24 godzin.

• Statusy – w zakładce Statusy powiązujesz statusy Base ze statusami PrestaShop. Synchronizacja działa tylko w kierunku Base → sklep, status zamówienia jest przesyłany co godzinę.

• Płatności – Base może przekazywać informację o opłaceniu (co 4 godziny), a w części integracji także mapować metody płatności.

• Wysyłki – sposoby dostawy w Base można powiązać z przewoźnikami w sklepie i przekazywać numer nadania od razu po nadaniu paczki.

• Przekazywanie zamówień do sklepu – jeśli obsługę chcesz zostawić w PrestaShop, Base może dodawać do sklepu zamówienia z marketplace’ów; nie pobierze ich potem ponownie.

Zamówienia ze sklepu znajdziesz w Manager zamówień → Zamówienia, a w wyszukiwaniu zaawansowanym możesz je odfiltrować po źródle zamówienia. Na karcie widać zarówno numer nadany w Base, jak i oryginalny numer z PrestaShop, co ułatwia kontakt z klientem, który podaje numer z e-maila potwierdzającego.

Dla zamówień ze sklepu warto od razu przygotować osobny status startowy i akcje automatyczne, które przenoszą zamówienie dalej po opłaceniu. Jak to zaprojektować, pokazujemy w tekście statusy zamówień w BaseLinkerze, a o automatycznym wystawianiu dokumentów – w artykule faktury w BaseLinkerze.

Stany, ceny i produkty – synchronizacja i eksport do PrestaShop

Kierunek i częstotliwość synchronizacji ustawiasz w zakładce Ceny/Stany integracji. Możesz traktować PrestaShop jako nadrzędny katalog (Base pobiera stany i ceny ze sklepu) albo prowadzić katalog w Base i wysyłać dane do sklepu. W obu przypadkach produkty muszą być powiązane między katalogiem Base a sklepem – inaczej synchronizacja nie zadziała. Jeśli w sklepie działają promocje, włącz parametr special_prices, żeby integracja widziała ceny specjalne.

Gdy katalog prowadzisz w Base, nowe produkty dodasz do PrestaShop przez Operacje → Utwórz produkty w sklepie internetowym – eksport odbywa się przez API. Przy produktach z wariantami zaznacz tylko produkt główny, inaczej każdy wariant powstanie w sklepie jako osobny produkt. Ponowny eksport istniejącego produktu aktualizuje go w sklepie zamiast tworzyć nowy.

Szczegóły mechanizmu i typowe pułapki opisaliśmy w artykule synchronizacja stanów w BaseLinkerze. Gdy produkty ze sklepu chcesz wystawić na Allegro, przyda się poradnik wystawianie ofert z BaseLinkera na Allegro, a porównanie sposobów łączenia sklepu z Allegro znajdziesz w tekście integracja sklepu z Allegro – na jakie rozwiązanie postawić.

PrestaShop multistore i wersje językowe w Base

Do jednego konta Base możesz podłączyć dowolną liczbę sklepów. Przy PrestaShop multistore masz dwie drogi. Możesz podłączyć każdy sklep jako osobną integrację przez API, podając w polu adresu domenę i ID sklepu (np. domena.pl/2) i ustawiając parametr presta_shop_id. Możesz też pobierać zamówienia ze wszystkich sklepów w jednym połączeniu dzięki parametrowi og_ignore_shop_id.

Wersje językowe i waluty obsłużysz parametrami language i currency. Pamiętaj, że Base nie synchronizuje magazynów sklepów bezpośrednio między sobą – jeśli kilka sklepów ma dzielić stany, potrzebny jest wspólny katalog w Base. Starsze sklepy, w których nie da się użyć API, można też podłączyć plikiem integracyjnym umieszczanym na serwerze, ale przy aktualnych wersjach PrestaShop zalecaną drogą jest API z modułem.

Najczęstsze problemy z integracją PrestaShop i jak je naprawić

Większość problemów z integracją PrestaShop powtarza się u wielu sklepów i ma proste rozwiązanie w ustawieniach. Zanim zgłosisz sprawę do supportu, sprawdź poniższą tabelę.

Jeśli połączenie działa, ale nowe zamówienia przestały spływać, przejdź przez naszą listę kontrolną, gdy BaseLinker nie pobiera zamówień. Przy sklepach na PrestaShop 9 warto od razu sprawdzić też obsługę zwrotów – dane z modułu można połączyć z procesem opisanym w artykule zwroty w BaseLinkerze.

[#checklista] Moduł zgodny z wersją PrestaShop; kopia sklepu przed instalacją; klucz Webservice z pełnymi uprawnieniami i aktywną usługą API; uprawnienia bl_orders i pozostałe bl_; domena bez protokołu; ustawione language i currency; presta_shop_id przy multistore; special_prices przy promocjach; jedno źródło zamówień Allegro; testowe zamówienie z paczkomatem przeprowadzone do etykiety.

Najczęściej zadawane pytania

Czy do integracji BaseLinker z PrestaShop potrzebny jest moduł?

Podstawowe połączenie działa na kluczu API, ale pomoc Base zaleca instalację najnowszej wersji modułu rozszerzającego. Bez niego zamówienia mogą nie zawierać m.in. danych punktów odbioru, wyboru faktury czy opłat za płatność.

Którą wersję modułu wybrać do mojego PrestaShop?

Dla PrestaShop od 1.7.0 do 9.1 Base udostępnia nowy moduł „base”, dostępny także w PrestaShop Marketplace. Starsze paczki dla gałęzi 8, 1.7 i 1.6 są oznaczone jako wycofywane – aktualną listę z datami wydań sprawdź na stronie modułów dla deweloperów.

Jakie uprawnienia nadać kluczowi API w PrestaShop?

Przy tworzeniu klucza nadaj wszystkie uprawnienia. Po instalacji modułu dodaj jeszcze uprawnienia do zasobów bl_orders i pozostałych zaczynających się od „bl_”, bo to przez nie Base korzysta z rozszerzeń.

Skąd biorą się zdublowane zamówienia z PrestaShop?

Zwykle z pobierania co minutę, gdy sklep nie zdążył jeszcze zapisać zamówienia w całości, albo z równoległego modułu Allegro w sklepie. W pierwszym przypadku pomaga parametr og_delay ustawiony na 5 minut, w drugim – jedno źródło zamówień Allegro.

Czy mogę podłączyć PrestaShop multistore do Base?

Tak. Każdy sklep możesz podłączyć osobno, podając domenę z ID sklepu i ustawiając parametr presta_shop_id, albo pobierać zamówienia ze wszystkich sklepów w jednym połączeniu dzięki parametrowi og_ignore_shop_id.

Czy integracja PrestaShop z Base jest płatna?

Integracja jest wliczona w abonament Base, także w darmowy plan Freemium. Płacisz za sam abonament zależny od liczby zamówień – aktualne stawki netto sprawdź w cenniku Base.

Podsumowanie

Integracja BaseLinker PrestaShop to połączenie API i modułu: klucz Webservice z pełnymi uprawnieniami, moduł dopasowany do wersji sklepu i uprawnienia do zasobów bl_. Dopiero potem przychodzi czas na parametry zaawansowane, statusy, synchronizację i testowe zamówienie. Ta kolejność oszczędza wiele godzin szukania, dlaczego w zamówieniu brakuje paczkomatu albo skąd biorą się duplikaty.

Jeśli chcesz, żeby integracja działała od pierwszego dnia, wdrożymy ją jako certyfikowany partner wdrożeń Base – od modułu i parametrów po automatyzacje, wysyłki i dokumenty. Sprawdź szczegóły wdrożenia Base w Vinson Agency.