# eBay

Integracja eBay z Ritevo: podłączenie konta przez logowanie w eBay, pobieranie zamówień i wiadomości, co eBay przekazuje przez API, ponowne połączenie.

Integracja z eBay pobiera do Ritevo zamówienia i wiadomości od kupujących z Twojego konta sprzedawcy. Podłączasz ją przez zwykłe logowanie w eBay - bez kluczy i haseł wpisywanych w Ritevo.

> **Wymagana integracja:** Potrzebujesz aktywnego konta sprzedawcy w eBay.

Jedno konto eBay podłączasz raz; jeśli sprzedajesz z kilku kont, każde dodajesz jako osobną integrację.

To samo konto eBay 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 `EBAY`. 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`. Przy `authError` to jedyny sposób na przywrócenie połączenia.

## Podłączenie konta

Całość zajmuje minutę. 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 **Ebay**.
3. Kliknij **Dodaj integrację**. Ritevo przekieruje Cię na stronę logowania eBay.
4. Zaloguj się na konto sprzedawcy i zatwierdź dostęp dla Ritevo. eBay odeśle Cię z powrotem do Ritevo.
5. Wróć do Ritevo i chwilę poczekaj - nie zamykaj okna. Gdy dodawanie się zakończy, otworzą się ustawienia nowej integracji.

![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 Ebay w sekcji Marketplace](https://ritevo.com/docs/integrations/ebay/pl-catalogue.webp)

![Ekran dodawania integracji eBay z przyciskiem Dodaj integrację](https://ritevo.com/docs/integrations/ebay/pl-add.webp)

![Strona logowania eBay, na którą przekierowuje Ritevo](https://ritevo.com/docs/integrations/ebay/pl-login.webp)

> **Warto wiedzieć:** Ritevo nie widzi Twojego hasła do eBay. Logujesz się na stronie eBay, a Ritevo dostaje od eBay tylko zgodę na dostęp do konta. Zgodę możesz w każdej chwili cofnąć w ustawieniach konta eBay - integracja przestanie wtedy działać i pokaże **Wymaga ponownego połączenia**.

## 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** - login Twojego konta eBay. Ritevo pobiera go z eBay, nie da się go 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 eBay: nazwa konta oraz przełączniki Pobieranie zamówień i Pobieranie wiadomości](https://ritevo.com/docs/integrations/ebay/pl-details.webp)

## Co daje ta integracja

- **Zamówienia** - nowe i zaktualizowane zamówienia z eBay trafiają do tabeli zamówień, z danymi kupującego, dostawą, pozycjami i zdjęciami ofert.
- **Wiadomości** - rozmowy z kupującymi trafiają do wspólnej skrzynki. Odpowiadasz z Ritevo, także ze zdjęciami w załączniku.

## Zamówienia z eBay

Ritevo pobiera z eBay całe zamówienie: kupującego, płatność, dostawę, pozycje z cenami (po rabatach) i zdjęciami ofert. eBay udostępnia przez API tylko zamówienia opłacone i gotowe do realizacji, więc każde przychodzi do Ritevo jako **Potwierdzono**. Anulowania, zwroty i spory rozstrzygasz po stronie eBay - nie zmieniają one statusu w Ritevo.

- **Statusy i płatności** - statusy i metody płatności z eBay 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**.
- **Punkty odbioru** - eBay nie przekazuje ich przez API; zamówienie przychodzi z adresem dostawy.
- **Wysyłka międzynarodowa przez eBay** (eBay International Shipping) - jako adres dostawy widzisz magazyn eBay, do którego wysyłasz paczkę, a nie adres kupującego.
- **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 eBay 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 z eBay

- Do Ritevo trafiają wiadomości od kupujących z Twojej skrzynki eBay. Odpowiadasz z Ritevo; w załączniku możesz wysłać **tylko obrazy** (zdjęcia), bo tak działa eBay.

## Wymaga ponownego połączenia

Ten stan pojawia się, gdy zgoda udzielona Ritevo w eBay wygasła albo została cofnięta - na przykład po zmianie hasła w eBay lub po odłączeniu aplikacji w ustawieniach konta. Do czasu ponownego połączenia Ritevo nie pobiera ani nie wysyła żadnych danych na tym koncie.

1. Przejdź przez **Podłączenie konta** jeszcze raz, logując się na **to samo** konto eBay.
2. Ritevo rozpozna konto po jego identyfikatorze i odświeży połączenie w istniejącej integracji. Ustawienia pobierania i historia zostają bez zmian - nie powstaje druga integracja.

> **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 eBay.

## Integracja przez API

Endpointy tej integracji są pod `/integrations/marketplaces/ebay`, 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.

Usunięcie konta po stronie eBay: gdy eBay zgłosi usunięcie konta użytkownika (Marketplace Account Deletion), Ritevo od razu anonimizuje każdą integrację z tym kontem - ustawia `active=false`, zamienia nazwę konta na zastępczą i kasuje tokeny. Wcześniej pobrane zamówienia i wiadomości zostają.


---

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