# Erli

Integracja Erli z Ritevo: podłączenie konta kluczem API, pobieranie zamówień, punkty odbioru, wiadomości od kupujących przez e-mail, ponowne połączenie.

Integracja z Erli pobiera do Ritevo zamówienia z Twojego konta sprzedawcy. Podłączasz ją kluczem API z panelu sprzedawcy Erli. Wiadomości od kupujących Erli wysyła e-mailem - obsługujesz je w Ritevo przez integrację e-mail.

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

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

To samo konto Erli 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 `ERLI`. 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/erli/{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 Erli. Skopiuj go w całości - wkleisz go w Ritevo przy dodawaniu integracji.

1. Zaloguj się do panelu sprzedawcy Erli.
2. W prawym górnym rogu otwórz **Moje ERLI** i wybierz **Ustawienia sklepu**.
3. W menu po lewej wybierz **Metoda integracji**, a potem **Własna integracja po API**.
4. W polu **Opis klucza** wpisz dowolną nazwę, na przykład „Ritevo", i kliknij **Wygeneruj nowy 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 **Marketplace** wybierz kafelek **Erli**.
3. W polu **API Token** wklej klucz API z panelu sprzedawcy Erli.
4. Kliknij **Dodaj integrację**. Ritevo od razu sprawdza klucz w Erli: jeśli jest poprawny, integracja zostaje dodana i otworzą się jej ustawienia. Jeśli nie - zobaczysz błąd zwrócony przez Erli 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 Erli w sekcji Marketplace](https://ritevo.com/docs/integrations/erli/pl-catalogue.webp)

![Ekran dodawania integracji Erli z polem API Token i przyciskiem Dodaj integrację](https://ritevo.com/docs/integrations/erli/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 Erli. 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** - zamiast przełącznika jest tu informacja, że wiadomości z Erli obsługujemy przez integrację e-mail, i przycisk **Dodaj integrację**, który prowadzi do jej dodania.

![Szczegóły integracji Erli: nazwa konta, przełącznik Pobieranie zamówień, karta wiadomości odsyłająca do integracji e-mail oraz przycisk Zaktualizuj dane logowania](https://ritevo.com/docs/integrations/erli/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 Erli trafiają do tabeli zamówień, z danymi kupującego, danymi do faktury, dostawą (także punktem odbioru) i pozycjami ze zdjęciami.
- **Wiadomości** - przez integrację e-mail, patrz niżej.

## Zamówienia z Erli

Ritevo pobiera z Erli całe zamówienie: kupującego, płatność, dostawę razem z punktem odbioru, pozycje z cenami i zdjęciami produktów.

- **Statusy i płatności** - statusy i metody płatności z Erli 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**.
- **Zwroty** - zamówienie, do którego kupujący zgłosił zwrot, Erli nadal pokazuje jako zakupione; w Ritevo zostaje **Potwierdzono**.
- **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 Erli 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 od kupujących z Erli

Erli nie ma własnej skrzynki wiadomości - kupujący piszą do Ciebie **e-mailem** na adres podany w Twoim koncie Erli. Żeby te wiadomości widzieć i odpowiadać na nie w Ritevo, dodaj [integrację e-mail](https://ritevo.com/pl/docs/messages/fetching-messages) dla tej skrzynki. Wiadomości pojawią się wtedy w Ritevo jak zwykłe e-maile; nie są powiązane z integracją Erli ani z jej zamówieniami.

## Wymaga ponownego połączenia

Ten stan pojawia się, gdy klucz API przestał działać - został unieważniony w panelu Erli albo stracił uprawnienia. Do czasu podania nowego klucza Ritevo nie pobiera ani nie wysyła żadnych danych na tym koncie.

1. W panelu sprzedawcy Erli wygeneruj nowy klucz API.
2. Na stronie integracji w Ritevo kliknij **Zaktualizuj dane logowania**, wklej nowy klucz i zatwierdź. Ritevo sprawdza go w Erli 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 Erli.
- Nie pobiera wiadomości ani dyskusji - Erli nie udostępnia ich przez API.

## Integracja przez API

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