Witaj w centrum pomocy Apilo

Konfiguracja po stronie 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 GET;
• zapisz dane.

Konfiguracja po stronie Apilo.

• Zaloguj się do Apilo jako administrator i przejdź do zakładki Administracja > Kanały sprzedaży.
• Z listy dostępnych sklepów wyszukaj “Prestashop” i kliknij przycisk: “Dodaj”:
  
• Uzupelnij formularz o wymagane pola:
  – Nazwa – Dowolna nazwa pozwalająca zidentyfikować kanał sprzedaży.
  – Alias – 2 literowy skrót od którego będą rozpoczynać się zamówienia z tego kanału, np. PR.
  – Login – Pełny adres strony sklepu np. https://www.sklep.pl.
  – Pobieranie zamówień – Czy włączyć pobieranie zamówień z kanału sprzedaży.
  – Klucz Api – Klucz API pozyskany z panelu Prestashop.
  – Strefa klienta – Czy generować dla klienta link z podglądem aktualnych informacji o zamówieniu? Link może być użyty w szablonach wiadomości do kupujących.
  – Cennik
  – Adres e-mail do powiadomień sprzedawcy – Wpisz adres e-mail, jeśli chcesz otrzymywać wiadomość o każdym zamówieniu, które pojawi się w Apilo. Bez jego podania opcja powiadomienia sprzedawcy nie zostanie aktywowana.
  – Domyślny komentarz przesyłki – W celu ułatwienia identyfikacji przesyłek ustaw komentarz etykiet generowanych dla zamówień z tego kanału sprzedaży. Wykorzystaj dostępne  zmienne.
  – Minimalny stan magazynowy – Czy Apilo ma wznawiać/kończyć aukcje/oferty gdy stan magazynowy mniejszy niż konkretna ilość dla kanału sprzedaży. Jeśli tak, wypełnij okno oczekiwaną najwyższą ilością.
  – Maksymalny stan magazynowy – Czy Apilo ma zaniżać ilości na aukcjach/ofertach. Jeśli tak, wypełnij okno oczekiwaną najwyższą ilością.
• Zapisz formularz.
  
  
  

Po zapisaniu formularza Apilo dokona weryfikacji wprowadzonych danych i poinformuje o statusie integracji z PrestaShop. W przypadku błędu należy sprawdzić poprawność danych.

Uwaga! Statusy można połączyć dopiero po utworzeniu kanału sprzedaży.

Konfiguracja dodatkowa.

Aby przejść do dalszej konfiguracji kanału sprzedaży należy przejść do zakładki: Administracja -> Kanały sprzedaży -> Prestashop – kliknij w nazwę podłączonego konta i uzupełnij dodatkowe pola.

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 język polski.

Uzupełnij pola płatności, jeśli oferujesz je w sklepie: 

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” .

Poza wcześniejszymi ustawieniami znajdziesz tutaj dodatkowo: 

• Zadania automatyczne – możesz skonfigurować ich dowolną ilość;
• Powiązania wysyłki– Konfiguracja automatycznego przypisania dostawy do zamówienia, wykorzystywane przy wysyłce zamówień  Więcej informacji na ten temat znajdziesz w poradniku;
• Powiązania statusów- Konfiguracja automatycznego przesyłania statusu zamówienia z Apilo do kanału sprzedaży 
• Import produktów oraz import ofert– pozwala na szybkie dodanie produktów do magazynu Apilo na podstawie platformy oraz ofert w celu ich zarządzania;
  Pamiętaj, że ofertą określone są wystawione na platformie sprzedaży produkty. Wykonując import ofert do Apilo pobierasz informacje o tym, jakie produkty obecnie są w sprzedaży.
  – Uzupełnij formularz:
  • import produktów: Tak
    – utworzy pozycje magazynowe w Towary i usługi > Produkty
  • import ofert: Tak
    – podłączy pod pozycje magazynową oferty, czyli informację o tym, że dane produkty są obecnie w sprzedaży.

Status sprawdzisz w Administracja > Zadania.
Więcej informacji na temat importu/ relacji produktów oraz synchronizacji stanów znajdziesz w poradnikach dotyczących:

• • Magazynu Apilo na podstawie platformy sprzedaży;
  • Relacji produktów.

• Przesyłki do kanału sprzedaży– włącz tą opcję, aby przesyłać numery przesyłek wygenerowanych w Apilo do zamówień w kanale sprzedaży.

Pobieranie danych punktów odbioru.

Poniżej udostępniamy 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

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.