Erli: klucz API ze sklepu i synchronizacja zamówień, stanów i cen

Do czego to służy

Konektor Erli korzysta z oficjalnego API sprzedawcy (OpenAPI Erli). Pobiera opłacone zamówienia, listę ofert, wysyła stany i ceny oraz przekazuje numery przesyłek.

Czego konektor nie robi: nie tworzy produktów w Erli i nie edytuje opisów, zdjęć ani kategorii. Produkty muszą już tam być, a Zaksio synchronizuje wyłącznie stan i cenę.

Gdzie to znaleźć w aplikacji

Sprzedaż i logistyka, „Kanały sprzedaży”, „Dodaj kanał sprzedaży”, rodzaj „Erli”, a w kanale zakładka „Połączenie”. Pola konektora: „Klucz API Erli” oraz opcjonalnie „Adres API (opcjonalnie, środowisko testowe)”, który dla produkcji zostawiasz pusty.

Aplikacja oznacza ten rodzaj kanału jako „W przygotowaniu”: zakładka „Połączenie” pokazuje na razie uproszczony szkic formularza (z mniejszą liczbą pól i innymi nazwami), a przycisków „Sprawdź połączenie” i „Start” jeszcze w niej nie ma. Klucze zapisane w tym szkicu mogą nie trafić do pól konektora, więc po udostępnieniu pełnego ekranu wpisz je ponownie.

Skąd wziąć klucze

1. Załóż i aktywuj sklep na Erli (erli.pl) oraz uzupełnij w nim metody dostawy i warunki zwrotu, reklamacji i gwarancji.
2. W panelu sprzedawcy wejdź w Moje Erli, Ustawienia sklepu, Metoda integracji i wybierz kafelek „Własna integracja po API”.
3. Wpisz dowolny opis klucza (np. Zaksio), kliknij „Wygeneruj nowy klucz” i skopiuj go.
4. Wklej klucz w pole „Klucz API Erli”. „Sprawdź połączenie” pobiera dane sklepu i pokazuje jego nazwę, a jeśli sklep jest nieaktywny, ostrzega o tym.
5. Produkty muszą już być w Erli. Po połączeniu pobierz listę ofert i zmapuj ją na towary w Zaksio.
6. Nie włączaj równolegle drugiej integracji pobierającej zamówienia z tego samego sklepu Erli, bo grozi to duplikatami.

Środowisko testowe przydziela Erli (BOK): dostajesz wtedy inny adres i dane logowania, a adres wpisujesz w polu „Adres API”. Dokumentacja API: erli.pl/svc/shop-api/doc/reference.

Co synchronizuje

• Zamówienia: z opłaconą płatnością albo pobraniem. Nieopłacone (czekają na płatność PayU) są pomijane do czasu opłacenia. Brak webhooków, zamówienia pobieramy odpytywaniem.
• Oferty: łączone po identyfikatorze produktu nadanym przez sprzedawcę (externalId w Erli).
• Stany i ceny: wsadami z wynikiem dla każdej oferty. Ceny tylko w PLN.
• Numer przesyłki: przewoźnicy spoza listy Erli są zapisywani jako nadanie własne. Dla przesyłek nadawanych przez Erli numer wpisuje się automatycznie, a Twoje wywołanie może zostać odrzucone.

Czego jeszcze nie ma

• Ekranu połączenia dla tej platformy w aplikacji: backend konektora istnieje i jest przetestowany na atrapach serwera, ale interfejs jest w przygotowaniu (patrz wyżej).
• Gwarancji, że zmiana dojdzie: pola zmienione ręcznie w panelu Erli są „zamrożone”, API ich nie nadpisuje i odpowiada sukcesem, więc zmiana stanu lub ceny może zostać po cichu pominięta. Zmiana ceny produktu z aktywną promocją czasową jest ignorowana.
• Przywracania stanu po anulowaniu: Erli samo zmniejsza stan po zakupie i go nie przywraca, a kolejna wysyłka stanu z Zaksio naprawia rozbieżność.
• Rynku niemieckiego (EUR) oraz zwrotów zgłoszonych w Erli.
• Weryfikacji na żywym koncie: niepewne są m.in. czy cena jednostkowa jest brutto, czy suma obejmuje dostawę, maksymalny rozmiar wsadu i limity zapytań.