# Allegro

Integracja Allegro z Ritevo: podłączenie konta przez logowanie, pobieranie zamówień i wiadomości, faktury, dyskusje i reklamacje, ponowne połączenie.

Integracja z Allegro pobiera do Ritevo zamówienia oraz wiadomości, dyskusje i reklamacje z Twojego konta sprzedawcy. Podłączasz ją przez zwykłe logowanie w Allegro - bez kluczy i haseł wpisywanych w Ritevo.

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

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

To samo konto Allegro 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 `ALLEGRO`. 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 **Allegro**.
3. Kliknij **Dodaj integrację**. Ritevo przekieruje Cię na stronę logowania Allegro.
4. Zaloguj się na konto sprzedawcy i zatwierdź dostęp dla Ritevo. Allegro 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 Allegro w sekcji Marketplace](https://ritevo.com/docs/integrations/allegro/pl-catalogue.webp)

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

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

> **Warto wiedzieć:** Ritevo nie widzi Twojego hasła do Allegro. Logujesz się na stronie Allegro, a Ritevo dostaje od Allegro tylko zgodę na dostęp do konta. Zgodę możesz w każdej chwili cofnąć w ustawieniach konta Allegro - 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 Allegro. Ritevo pobiera go z Allegro, 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 Allegro: nazwa konta oraz przełączniki Pobieranie zamówień i Pobieranie wiadomości](https://ritevo.com/docs/integrations/allegro/pl-details.webp)

## Co daje ta integracja

- **Zamówienia** - nowe i zaktualizowane zamówienia z Allegro trafiają do tabeli zamówień, z danymi kupującego, danymi do faktury, dostawą (także punktem odbioru) i pozycjami ze zdjęciami ofert.
- **Wiadomości** - rozmowy z Centrum wiadomości oraz **dyskusje** i **reklamacje** trafiają do wspólnej skrzynki. Na wszystkie trzy odpowiadasz z Ritevo, także z załącznikami.
- **Nadawanie przesyłek** przez Wysyłam z Allegro to osobna integracja, którą dodajesz po podłączeniu konta - korzysta z tego samego konta Allegro.

## Zamówienia z Allegro

Ritevo pobiera z Allegro całe zamówienie: kupującego, płatność, dostawę razem z punktem odbioru, pozycje z cenami i zdjęciami ofert oraz wiadomość od kupującego. Allegro przekazuje przez API komplet tych danych, więc niczego nie trzeba uzupełniać ręcznie.

- **Statusy i płatności** - statusy i metody płatności z Allegro 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** - obsługiwane. Gdy kupujący dokupi do produktu na przykład pakowanie na prezent albo wniesienie, zobaczysz je w zamówieniu jako osobną pozycję pod tym produktem - także gdy są darmowe. Więcej o [usługach dodatkowych](https://ritevo.com/pl/docs/orders/fetching-orders#additional-services).
- **Faktura** - Allegro jawnie przekazuje, czy kupujący poprosił o fakturę. Takie zamówienie dostaje oznaczenie **Klient prosi o fakturę**, a dane firmy i numer podatkowy 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, dyskusje i reklamacje z Allegro

- **Wiadomości** z Centrum wiadomości - do Ritevo trafiają tylko wiadomości, które Allegro już dostarczyło. Twoją odpowiedź Allegro najpierw sprawdza, więc potwierdzenie wysyłki może potrwać do pół minuty.
- **Dyskusje** i **reklamacje** - z tematem, opisem, terminem na decyzję, żądaniem kupującego (naprawa, wymiana, zwrot pieniędzy, częściowy zwrot) i powiązanym zamówieniem. Odpowiadasz na nie z Ritevo, możesz też zakończyć dyskusję oraz rozpatrzyć reklamację - zaakceptować lub odrzucić z podaniem powodu.
- 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 zgoda udzielona Ritevo w Allegro wygasła albo została cofnięta - na przykład po zmianie hasła w Allegro 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 Allegro.
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 Allegro.

## Integracja przez API

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