Witaj w centrum pomocy Apilo
Połączenie z Prestashop
Spis treści
Uzyskaj klucz API z panelu PrestaShop
1. Otwórz panel administracyjny PrestaShop.
2. Przejdź do zakładki.
Konfiguracja > Zaawansowane > Api.
3. Ustaw opcję „Włącz API PrestaShop” na „TAK”, następnie należy wybrać w prawym, górnym rogu „Dodaj nowy klucz API”.
4. Wypełnij formularz w celu uzyskania klucza API:
- kliknij przycisk “Generuj” obok pola klucz;
- opis klucza: opcjonalnie;
- status: Tak;
- wśród uprawnień zaznacz wszystkie pola PUT i GE;
- zapisz dane.
Konfiguracja PrestaShop w Apilo
1. Zaloguj się do Apilo jako administrator.
2. Przejdź do: Administracja > Kanały sprzedaży i wybierz PrestaShop.
3. Wypełnij formularz:
- nazwa: np. Prestashop sklep1;
- alias: 2 literowy skrót: np. PS, który będzie identyfikował zamówienia z tego kanału sprzedaży;
- login: adres sklepu PrestaShop np. mojsklep.pl;
- Pobieranie zamówień: włącz, jeśli chcesz pobierać zamówienia do Apilo;
- klucz API: wygenerowany klucz z panelu PrestaShop;
- Strefa klienta: włącz, aby generować dla klienta link z podglądem aktualnych informacji o zamówieniu;
- Cennik : możesz przypisać własny cennik dla ofert kanału;
- Adres e-mail do powiadomień sprzedawcy: uzupełnij, jeśli chcesz otrzymywać powiadomienia o nowych zamówieniach;
- Domyślny komentarz przesyłki;
- Minimalny i maksymalny stan magazynowy.
Po zapisaniu formularza Apilo dokona weryfikacji wprowadzonych danych i poinformuje o statusie integracji z PrestaShop. W przypadku błędu należy sprawdzić poprawność danych.
Po utworzeniu połączenia wejdź ponownie w edycję kanału sprzedaży Prestashop.
Uzupełnij dodatkowe pola:
- Język: jeśli posiadasz w sklepie wersje językowe, wybierz nadrzędny dla importów produktów / ofert. Jeśli nie dokonasz wyboru, jako domyślny zostanie uznany PL.
Uzupełnij pola płatności, jeśli oferujesz je w sklepie:
- Przelewy24 status zapłaty;
- PayU status zapłaty;
- PayPal status zapłaty;
- Imoje status zapłaty;
- Inpost Pay status zapłaty;
- Inpost Pay Pobranie status zapłaty.
Jeśli posiadasz dodane w sklepie inne metody płatności, dla każdej wtyczki dot. metody płatności, którą posiadasz w sklepie, utwórz i zmapuj odpowiedni status zamówienia, który zostanie ustawiony po jego opłaceniu. W ten sposób Apilo rozpozna status płatności zamówienia po jego pobraniu do systemu.
Ważne! Aby statusy zamówień były prawidłowo przesyłane z Apilo do PrestaShop należy po stronie PrestaShop w zakładce: Menu > Zaawansowane > Api > sekcja „Uprawnienia” włączyć „POST” dla zasobu „order_histories”.
Aktualnie obsługiwane wtyczki i dane wysyłkowe określające dostawę do punktu.
1) Komentarz InPost
Dane punktu odbioru zostaną pobrane z wiadomości do zamówienia. Ten sposób jest przeznaczony tylko dla dostawy do Paczkomatu InPost celem zachowania zgodności wstecznej.
Schemat dla wiadomości/komentarza:
Paczkomat [PACZKOMAT] (id: [ID])
Przykładowa treść wiadomości to np. Paczkomat BSL01M (id: BSL01M).
2) Komentarz Uniwersalny
Wzorowany na komentarzu InPost ale umożliwiający przekazanie także innego kuriera. Dane punktu odbioru zostaną pobrane z wiadomości do zamówienia.
Schemat dla wiadomości/komentarza:
Punkt odbioru (phrase: ?1) (type: ?2) (carrier: ?3).
Objaśnienie dla schematu:
- Dla “phrase” w miejscu „?1” podaj numer punktu lub adres punktu.
- Dla “type” w miejscu „?2” podaj “0” jeżeli w “phrase” przekazano numer punktu lub “1” jeżeli przekazano adres punktu.
- W “carrier” w miejscu „?3” podaj nazwę dostawcy wg tej listy (UPS / INPOST / FEDEX / POCZTA_POLSKA / DPD / DHL / ORLEN), np. dla Poczty Polskiej ma to być tak (carrier: POCZTA_POLSKA) → dużymi literami wraz z tym “_”.
Przykładowa treść wiadomości to np. Punkt odbioru (phrase: PL0001) (type: 0) (carrier: INPOST).
Zalecanym schematem byłby ten, który przekazuje numer punktu, przykład dla INPOST:
Punkt odbioru (phrase: PL0001) (type: 0) (carrier: INPOST).
Podając adres punktu, należy określić: ulicę bez numeru, miejscowość i kod pocztowy, przykład dla INPOST:
Punkt odbioru (phrase: Malinowa Toruń 43-300) (type: 1) (carrier: INPOST).
3) Wtyczka InPost
Dane punktu dostawy zostaną pobierane z parametru „inpost_point”, który jest automatycznie umieszczany przez wtyczkę InPost w danych zamówienia. Wystarczy, że zainstalujesz i skonfigurujesz wtyczkę po stronie sklepu.
4) Wtyczka DPD
https://www.dpd.com/pl/pl/oferta-dla-firm/rozwiazania-it/modul-dpd-dla-prestashop/
Dane punktu dostawy zostaną pobrane z danych dostawy, jeżeli adres dostawy zostanie oznaczony aliasem „Point Pick Up”. W ten sposób wtyczka DPD oznacza dostawę do punktu. Wystarczy, że zainstalujesz i skonfigurujesz wtyczkę po stronie sklepu.
