# Empik

Integracja Empik Marketplace z Ritevo: podłączenie kluczem API, pobieranie zamówień i wiadomości, automatyczne przyjmowanie zamówień, dyskusje i incydenty.

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.

> **Wymagana integracja:** Potrzebujesz aktywnego konta sprzedawcy w Empik i klucza API wygenerowanego w jego panelu.

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.

Unikalność: integracja jest unikalna w ramach firmy po `externalId` i typie `EMPIK`. Ponowne utworzenie odświeża istniejącą integrację zamiast tworzyć nową: od razu ustawia `authError=false`, a jeśli integracja była nieaktywna - także `active=true`. Nowe dane podasz też przez `PATCH /integrations/marketplaces/empik/{id}/token` - w każdym stanie integracji, także gdy `authError=false` i `active=true`; ustawia `authError=false` i `active=true`.

## Jak wygenerować klucz API

Klucz API tworzysz w panelu sprzedawcy Empik. Skopiuj go w całości - wkleisz go w Ritevo przy dodawaniu integracji.

1. Zaloguj się do panelu sprzedawcy Empik Marketplace.
2. Kliknij swoją nazwę użytkownika w prawym górnym rogu i przejdź do ustawień konta.
3. Wybierz **Klucz API**.
4. Kliknij **Wygeneruj nowy klucz**. Jeśli klucz już istnieje, po prostu go skopiuj.

## 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 **Marketplace** wybierz kafelek **Empik**.
3. W polu **API Token** wklej klucz API z panelu sprzedawcy Empik.
4. 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.

![Lista integracji w Ritevo z zaznaczonym przyciskiem Dodaj integrację w prawym górnym rogu](https://ritevo.com/docs/integrations/pl-integrations-list.webp)

![Ekran Dodaj integrację z zaznaczonym kafelkiem Empik w sekcji Marketplace](https://ritevo.com/docs/integrations/empik/pl-catalogue.webp)

![Ekran dodawania integracji Empik z polem API Token i przyciskiem Dodaj integrację](https://ritevo.com/docs/integrations/empik/pl-add.webp)

## 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ń](https://ritevo.com/pl/docs/orders/fetching-orders).
- **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](https://ritevo.com/pl/docs/messages/fetching-messages).

![Szczegóły integracji Empik: nazwa konta, przełączniki Pobieranie zamówień i Pobieranie wiadomości oraz przycisk Zaktualizuj dane logowania](https://ritevo.com/docs/integrations/empik/pl-details.webp)

> **Warto wiedzieć:** Klucz możesz podmienić w każdej chwili tym samym przyciskiem **Zaktualizuj dane logowania**, nie tylko po błędzie.

## 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](https://ritevo.com/pl/docs/orders/fetching-orders#additional-services).
- **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.

> **Warto wiedzieć:** Zamówienie ze statusem **Potwierdzono** przejmuje Ritevo - późniejsze zmiany po stronie kanału sprzedaży są pomijane. Więcej w [Pobieranie zamówień](https://ritevo.com/pl/docs/orders/fetching-orders#who-manages).

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

1. W panelu sprzedawcy Empik wygeneruj nowy klucz API.
2. 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.

> **Warto wiedzieć:** Ponowne połączenie od razu zdejmuje stan **Wymaga ponownego połączenia** i włącza integrację - także wtedy, gdy wcześniej została usunięta. Nie musisz jej osobno przywracać.

W API ponowne połączenie ustawia na integracji `authError=false` i `active=true`, także gdy integracja była usunięta (`active=false`). Jaki endpoint to robi w danej integracji, opisuje notatka o unikalności na początku strony.

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

## Integracja przez API

Endpointy tej integracji są pod `/integrations/marketplaces/empik`, a wspólne dla całego typu (lista, pobranie jednej, przełączniki pobierania, usunięcie, przywrócenie) pod `/integrations/marketplaces`. Aktualne ścieżki, pola, typy i kody odpowiedzi są zawsze w Swaggerze: https://api.ritevo.com/api/v1/api-docs.


---

Cała pomoc w jednym pliku: https://ritevo.com/llms-full.txt. Mapa pomocy z linkami do wszystkich stron: https://ritevo.com/llms.txt.