PrestaShop

Integracja z PrestaShop pobiera do Ritevo zamówienia i wiadomości z obsługi klienta Twojego sklepu. Podłączasz ją kluczem webservice wygenerowanym w panelu PrestaShop. Statusy i moduły płatności sklepu tłumaczysz na statusy Ritevo w mapowaniu na stronie integracji.

Ten sam sklep PrestaShop podłączysz tylko raz. Gdy dodasz go ponownie, Ritevo odświeży istniejącą integrację i włączy ją z powrotem, nawet jeśli była usunięta.

Jak wygenerować klucz API

Klucz tworzysz w panelu administracyjnym PrestaShop. Skopiuj go w całości - wkleisz go w Ritevo przy dodawaniu integracji.

1. Zaloguj się do panelu PrestaShop i w menu po lewej wybierz Zaawansowane, potem Webservice.
2. W sekcji Konfiguracja ustaw Włącz webservice PrestaShop na Tak i zapisz.
3. Kliknij Dodaj nowy klucz webservice. Kliknij Generuj, a w polu Opis klucza wpisz dowolną nazwę, na przykład „Ritevo".
4. W tabeli Uprawnienia zaznacz wszystko: każdy zasób i każde działanie (Widok, Dodaj, Modyfikuj, Usuń). Ustaw Status na Tak i zapisz. Klucz skopiuj z pola Klucz.

Podłączenie konta

Zacznij w Ritevo:

1. Wejdź w Integracje w lewym panelu i kliknij Dodaj integrację w prawym górnym rogu.
2. W sekcji Sklepy internetowe wybierz kafelek PrestaShop.
3. W polu Nazwa konta wpisz własną nazwę integracji, na przykład nazwę sklepu.
4. W polu Adres sklepu wpisz pełny adres sklepu razem z https://, bez końcowego ukośnika i bez /api - na przykład https://mojsklep.pl.
5. W polu Klucz webservice wklej klucz z panelu PrestaShop.
6. Kliknij Dodaj integrację. Ritevo od razu łączy się ze sklepem i sprawdza dane: jeśli są poprawne, integracja zostaje dodana i otworzą się jej ustawienia. Jeśli nie - zobaczysz błąd zwrócony przez sklep i nic nie zostanie zapisane.

Ustawienia integracji

Po podłączeniu integracja jest Aktywna, ale pobieranie zamówień jest wyłączone - włączasz je sam. Na stronie integracji znajdziesz:

• Nazwa konta - Twoja własna nazwa tej integracji, na przykład nazwa sklepu. Możesz ją zmienić w każdej chwili.
• Adres sklepu - adres podany przy dodawaniu. Tutaj nie da się go zmienić; nowy adres lub nowe klucze podajesz przez Zaktualizuj dane logowania.
• Pobieranie zamówień - po włączeniu Ritevo sprawdza nowe i zmienione zamówienia mniej więcej co 10 minut. Zasady wspólne dla wszystkich kanałów: Pobieranie zamówień.
• Pobieranie wiadomości - po włączeniu Ritevo pobiera wątki z obsługi klienta mniej więcej co 10 minut, przy pierwszym pobraniu sięgając 7 dni wstecz. Zasady wspólne: Pobieranie wiadomości.
• Mapowanie statusów zamówień i Mapowanie metod płatności - opisane niżej.

Mapowanie statusów i płatności

Każdy sklep nazywa statusy zamówień i metody płatności po swojemu, dlatego przy sklepach internetowych sam decydujesz, jak mają być tłumaczone na statusy i metody Ritevo. Mapowanie ustawiasz raz, na stronie integracji, i dotyczy ono każdego zamówienia pobieranego od tej chwili.

Mapowanie statusów zamówień

Listę statusów Ritevo pobiera z Twojego sklepu, więc widzisz je pod takimi nazwami jak w panelu PrestaShop. Na start przypisane są statusy, z którymi PrestaShop jest instalowany. Sam przypisujesz statusy dodane przez moduły płatności lub ręcznie. Przypisanie startowe:

• Potwierdzono - Płatność zaakceptowana, Przygotowanie w toku, Dostarczane, Dostarczone, Zwróconych pieniędzy, Zamówienie oczekujące (opłacone), Płatność przyjęta. Zamówienie ze zwróconymi pieniędzmi było prawdziwą sprzedażą, dlatego zostaje potwierdzone.
• Anulowano - Anulowane.
• Ocz. na płatność - Oczekiwanie na płatność czekiem, Błąd płatności, Oczekiwanie na płatność przelewem, Zamówienie oczekujące (nieopłacone), Oczekiwanie na płatność przy odbiorze.
• Ocz. na potwierdzenie - z góry nic; tu trafiają też zamówienia ze statusem bez przypisania.

Jeden status Ritevo może mieć przypisanych kilka statusów sklepu, ale jeden status sklepu tylko jeden status Ritevo. Zamówienie ze statusem, którego nigdzie nie przypisałeś, trafia jako Ocz. na potwierdzenie - zobaczysz je i zdecydujesz, co dalej.

Mapowanie metod płatności

PrestaShop nie udostępnia listy modułów płatności, dlatego tu wpisujesz nazwy modułów ręcznie - takie, jakie widzisz w panelu PrestaShop w szczegółach zamówienia albo w Moduły → Płatności (na przykład ps_wirepayment, payu). Na start wpisane są najczęstsze moduły. Sam dopisujesz inne moduły, a niepotrzebne usuwasz. Przypisanie startowe:

• Przelew - ps_wirepayment, ps_checkpayment.
• Płatność przy odbiorze - ps_cashondelivery.
• Karta płatnicza - stripe_official.
• PayU - payu.
• PayPal - ps_checkout, paypal.
• P24 - przelewy24.

Płatność metodą, której nigdzie nie przypisałeś, trafia jako Inne.

Co daje ta integracja

• Zamówienia - nowe i zmienione zamówienia z PrestaShop trafiają do tabeli zamówień, z danymi kupującego, danymi do faktury, dostawą i pozycjami ze zdjęciami produktów.
• Wiadomości - wątki z obsługi klienta PrestaShop trafiają do skrzynki wiadomości; odpowiadasz na nie z Ritevo.

Zamówienia z PrestaShop

Ritevo pobiera z PrestaShop całe zamówienie: konto klienta z adresem do faktury, adres i przewoźnika dostawy, wpłaty, pozycje z cenami brutto i zdjęciami produktów. Zamówienie zmienione w sklepie (na przykład nowy status) jest pobierane ponownie.

• Statusy i płatności - tłumaczone według Twojego mapowania, opisanego wyżej. Kwota zapłacona to suma wpłat zarejestrowanych w PrestaShop.
• Uwagi kupującego - komentarz wpisany w koszyku trafia do zamówienia jako wiadomość od kupującego.
• Usługi dodatkowe - obsługiwane. Gdy kupujący wybierze pakowanie na prezent albo opakowanie z recyklingu, zobaczysz je w zamówieniu jako osobne pozycje dla całego zamówienia, także gdy są darmowe. Obsługiwana jest też wiadomość na prezent, czyli tekst, który kupujący chce dołączyć do paczki - zobaczysz ją razem z wiadomością od kupującego, w ramce Wiadomość na prezent. Więcej o usługach dodatkowych.
• Rabaty - reguły koszyka (kody rabatowe) pojawiają się jako osobne pozycje z ujemną kwotą, żeby suma pozycji zgadzała się z kwotą zamówienia.
• Zakup bez konta - zamówienie gościa pobiera się normalnie.
• Faktura - jeśli PrestaShop przekaże numer podatkowy kupującego (na przykład NIP) albo jego odpowiednik, zamówienie dostaje oznaczenie Klient prosi o fakturę, a dane firmy i numer są wpisane.

Wiadomości z PrestaShop

Ritevo pobiera wątki z Obsługi klienta PrestaShop - zarówno te z formularza kontaktowego, jak i te przypięte do zamówienia. Każdy wątek jest w Ritevo rozmową:

• Odpowiedź - odpowiadasz z Ritevo; w PrestaShop odpowiedź jest zapisana jako wiadomość pracownika sklepu. Nie ma dyskusji ani reklamacji - PrestaShop ich nie ma.
• Powiązanie z zamówieniem - wątek dotyczący zamówienia jest w Ritevo podpięty pod to zamówienie.
• Wiadomości prywatne - notatki pracowników oznaczone w PrestaShop jako prywatne nie są pobierane.
• Załączniki - PrestaShop podaje tylko nazwę załączonego pliku, nie sam plik. W Ritevo widzisz nazwę; plik otworzysz w panelu PrestaShop. Załączników też nie wyślesz.

Wymaga ponownego połączenia

Ten stan pojawia się, gdy sklep przestał akceptować dane logowania - klucz został usunięty w panelu sklepu, stracił uprawnienia albo zmienił się adres sklepu. Do czasu podania nowych danych Ritevo nie pobiera ani nie wysyła żadnych danych z tego sklepu.

1. W panelu sklepu wygeneruj nowe klucze - tak samo jak przy pierwszym podłączeniu.
2. Na stronie integracji w Ritevo kliknij Zaktualizuj dane logowania, podaj adres sklepu i nowe klucze i zatwierdź. Ritevo sprawdza je w sklepie tak samo jak przy dodawaniu - błędne dane zwrócą błąd, poprawne odświeżą połączenie. Mapowania, ustawienia pobierania i historia zostają bez zmian.

Usunięcie integracji

Usuń integrację wyłącza integrację w Ritevo: przestaje pobierać i wysyłać dane, ale to, co pobrała wcześniej, zostaje. Przywróć integrację włącza ją z powrotem.

Czego integracja nie robi

• Nie zarządza ofertami: nie wystawia, nie zmienia cen ani stanów magazynowych w PrestaShop.
• Nie obsługuje punktów odbioru (na przykład paczkomatów). PrestaShop nie ma na nie standardowego pola - każdy moduł przewoźnika zapisuje wybrany punkt u siebie, poza zasięgiem webservice. Zamówienie z taką dostawą pobierze się normalnie, ale bez informacji o punkcie; ostrzeżenie o tym widzisz u góry strony integracji.
• Nie przesyła nic z powrotem do PrestaShop: gdy w Ritevo zmienisz status zamówienia, nadasz przesyłkę albo wystawisz fakturę, zamówienie w PrestaShop zostaje bez zmian.