Empik
Integracja z Empik Marketplace pobiera do Ritevo zamówienia oraz wiadomości i dyskusje z Twojego konta sprzedawcy. Podłączasz ją kluczem API z panelu sprzedawcy Empik.
Jedno konto Empik podłączasz raz; jeśli sprzedajesz z kilku kont, każde dodajesz jako osobną integrację.
To samo konto Empik podłączysz tylko raz. Gdy podłączysz je 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 API tworzysz w panelu sprzedawcy Empik. Skopiuj go w całości - wkleisz go w Ritevo przy dodawaniu integracji.
- Zaloguj się do panelu sprzedawcy Empik Marketplace.
- Kliknij swoją nazwę użytkownika w prawym górnym rogu i przejdź do ustawień konta.
- Wybierz Klucz API.
- Kliknij Wygeneruj nowy klucz. Jeśli klucz już istnieje, po prostu go skopiuj.
Podłączenie konta
Zacznij w Ritevo:
- Wejdź w Integracje w lewym panelu i kliknij Dodaj integrację w prawym górnym rogu.
- W sekcji Marketplace wybierz kafelek Empik.
- W polu API Token wklej klucz API z panelu sprzedawcy Empik.
- Kliknij Dodaj integrację. Ritevo od razu sprawdza klucz w Empik: jeśli jest poprawny, integracja zostaje dodana i otworzą się jej ustawienia. Jeśli nie - zobaczysz błąd zwrócony przez Empik i nic nie zostanie zapisane.



Ustawienia integracji
Po podłączeniu integracja jest Aktywna, ale pobieranie zamówień i wiadomości jest wyłączone - włączasz je sam, osobno:
- Nazwa konta - nazwa Twojego konta sprzedawcy, którą Ritevo pobiera z Empik. Nie da się jej zmienić.
- 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 wiadomości mniej więcej co 10 minut, przy pierwszym pobraniu sięgając 7 dni wstecz. Zasady wspólne: Pobieranie wiadomości.

Co daje ta integracja
- Zamówienia - nowe i zaktualizowane zamówienia z Empik trafiają do tabeli zamówień, z danymi kupującego, danymi do faktury, dostawą (także punktem odbioru) i pozycjami.
- Wiadomości i dyskusje - rozmowy z kupującymi oraz zgłoszenia (incydenty) trafiają do wspólnej skrzynki.
Zamówienia z Empik
Ritevo pobiera z Empik całe zamówienie: kupującego, płatność, dostawę razem z punktem odbioru, pozycje i wiadomość od kupującego. Zamówienia czekające na przyjęcie Ritevo przyjmuje automatycznie - nie musisz ich akceptować w panelu Empik.
- Statusy i płatności - statusy i metody płatności z Empik są tłumaczone na statusy Ritevo w jeden, stały sposób; marketplace'y nie mają własnych mapowań, jak sklepy internetowe. Zamówienie za pobraniem przychodzi jako Ocz. na płatność z metodą Płatność przy odbiorze.
- Usługi dodatkowe - nieobsługiwane. Ta integracja nie przekazuje usług takich jak pakowanie na prezent czy wniesienie. Jeśli chcesz je sprzedawać, wystaw je jako osobny produkt albo ofertę - w zamówieniu pojawią się wtedy jako zwykła pozycja. Więcej o usługach dodatkowych.
- Faktura - jeśli Empik 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 i dyskusje z Empik
- Wiadomości - rozmowy z kupującymi z panelu Empik. Odpowiadasz z Ritevo, także z załącznikami.
- Dyskusje - to zgłoszenia (incydenty) do pozycji zamówienia. Empik nie pozwala odpowiadać wewnątrz zgłoszenia, dlatego przy dyskusji Ritevo pokazuje istniejące konwersacje z tym kupującym dla tego zamówienia - odpowiadasz w nich jak w zwykłej wiadomości - oraz przycisk Napisz do kupującego w nowej konwersacji, gdy takiej rozmowy jeszcze nie ma. Samo zgłoszenie zamykasz z tego miejsca przyciskiem Rozwiąż incydent, podając powód.
- Jeśli wiadomość dotyczy zamówienia, którego nie ma jeszcze w Ritevo, samo je dociągamy - także przy wyłączonym pobieraniu zamówień.
Wymaga ponownego połączenia
Ten stan pojawia się, gdy klucz API przestał działać - został unieważniony w panelu Empik albo stracił uprawnienia. Do czasu podania nowego klucza Ritevo nie pobiera ani nie wysyła żadnych danych na tym koncie.
- W panelu sprzedawcy Empik wygeneruj nowy klucz API.
- Na stronie integracji w Ritevo kliknij Zaktualizuj dane logowania, wklej nowy klucz i zatwierdź. Ritevo sprawdza go w Empik tak samo jak przy dodawaniu - zły klucz zwróci błąd, poprawny odświeży połączenie. 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 Empik.