Kreator integracji Allegro prowadzi przez połączenie konta Allegro z xSale oraz podstawową konfigurację obsługi ofert i zamówień. Dodawanie oraz edycja integracji Allegro, Allegro.cz i Allegro.sk odbywa się w panelu xSale V2.
W tym wpisie opisujemy dodanie rynku bazowego, czyli Allegro PL. Rynki dodatkowe, np. Allegro.cz lub Allegro.sk, dodaje się dopiero po poprawnym skonfigurowaniu rynku bazowego.
W tym artykule znajdziesz
- co przygotować przed rozpoczęciem konfiguracji,
- jak rozpocząć dodanie integracji Allegro,
- jak przejść przez kroki kreatora,
- co można zmienić po dodaniu integracji,
- o czym warto pamiętać.
Przed rozpoczęciem
Przed uruchomieniem kreatora upewnij się, że masz dostęp do konta Allegro, które chcesz połączyć z xSale. Autoryzacja odbywa się po stronie Allegro, dlatego podczas konfiguracji trzeba zalogować się na właściwe konto sprzedażowe i potwierdzić dostęp dla xSale.
Przygotuj też nazwę integracji. Nazwa jest wybierana podczas dodawania konta i powinna jednoznacznie wskazywać, którego konta lub rynku dotyczy integracja.
Dodanie integracji Allegro
Przejdź w panelu xSale do sekcji Integracje. Na liście dostępnych integracji wybierz Allegro i kliknij Dodaj.
Jeżeli konfigurujesz Allegro po raz pierwszy, wybierz Rynek bazowy. Rynek dodatkowy można dodać dopiero po poprawnym dodaniu rynku bazowego. Jeśli sprzedajesz także na rynkach zagranicznych Allegro, po dodaniu rynku bazowego warto dodać również właściwe rynki dodatkowe.

Kroki kreatora
Krok 1: autoryzacja konta Allegro
W pierwszym kroku wpisz nazwę integracji, wybierz marketplace oraz język, a następnie kliknij Autoryzuj. xSale przekieruje Cię do Allegro, gdzie trzeba zalogować się na właściwe konto i potwierdzić dostęp aplikacji xSale.
Po poprawnej autoryzacji integracja zostanie utworzona w xSale jako aktywna. W kodzie kreatora integracja Allegro jest tworzona z ustawieniem Aktywna, a dane autoryzacji, marketplace i język są zapisywane w konfiguracji integracji.

Krok 2: zakres integracji
W kroku zakresu integracji wybierz, które obszary mają być obsługiwane. Dla rynku bazowego kreator pozwala skonfigurować obsługę zamówień oraz ofert. Wybór zakresu decyduje, które kolejne kroki pojawią się w kreatorze.

Krok 3: synchronizacja ofert
Jeżeli włączysz obsługę ofert, ustaw parametry synchronizacji ofert. W tym kroku wskazujesz m.in. ustawienia cen, stanów, magazynów oraz sposób przeliczania danych wysyłanych z xSale do Allegro.
Dla Allegro dostępne jest też ustawienie związane z poprawianiem parametrów ofert. Pozwala ono korzystać z dodatkowej logiki przygotowanej dla tej integracji.

Krok 4: parametry sprzedaży
W kolejnym kroku ustaw parametry sprzedaży pobrane z Allegro, np. warunki dostawy, płatności, reklamacji, zwrotów i gwarancji. Są to dane wymagane przy wystawianiu ofert na Allegro.
Jeżeli lista parametrów nie jest jeszcze dostępna, kreator może oczekiwać na ich pobranie. W edycji integracji dostępna jest również akcja ponownej synchronizacji parametrów sprzedaży.

Kroki związane z zamówieniami
Jeżeli włączysz obsługę zamówień, kreator prowadzi przez ustawienia importu zamówień, mapowanie form dostawy i płatności oraz mapowanie statusów. Dla Allegro dostępne są również ustawienia statusów dla zamówień anulowanych przez klienta oraz anulowanych automatycznie.
Ustawienia zamówień decydują m.in. od kiedy xSale ma pobierać zamówienia, do jakiego magazynu mają trafić oraz jakie statusy mają być ustawiane po imporcie.
Krok: aktywacja integracji
Na końcu kreatora sprawdź, czy integracja ma pozostać aktywna. Aktywna integracja może wykonywać skonfigurowane synchronizacje zgodnie z wybranym zakresem.

Krok: import ofert
Po zakończeniu konfiguracji możesz uruchomić import ofert z Allegro do xSale. Import pobiera oferty z konta Allegro i pokazuje postęp działania w kreatorze. Ten krok można pominąć, jeżeli nie chcesz od razu pobierać ofert.

Edycja integracji
Po dodaniu integracji możesz wrócić do jej konfiguracji z poziomu listy integracji. Górny pasek pozwala wyszukać integrację oraz przefiltrować widok, np. tylko do aktywnych integracji. Po najechaniu kursorem na kafelek integracji pojawi się opcja Edytuj.
W edycji integracji dostępne są zakładki odpowiadające obszarom konfiguracji. Zakres widocznych zakładek zależy od tego, czy edytujesz rynek bazowy, czy rynek dodatkowy, oraz od wybranego zakresu integracji.
Zakładka: Połączenia
W zakładce Połączenia można sprawdzić podstawowe dane integracji i wykonać operacje dotyczące połączenia z Allegro.
W tej zakładce można m.in.:
- włączyć lub wyłączyć aktywność integracji,
- uruchomić resynchronizację ofert,
- zsynchronizować warunki sprzedaży z Allegro,
- ponownie autoryzować konto Allegro.
Zakładka: Synchronizacja ofert
Zakładka Synchronizacja ofert zawiera ustawienia wykorzystywane przy tworzeniu i aktualizacji ofert z xSale do Allegro.
W tej zakładce można zmienić m.in.:
- domyślny typ ceny,
- marżę procentową lub kwotową, zaokrąglenie oraz przesunięcie ceny,
- domyślną zakładkę z opisem,
- magazyn, z którego mają być wysyłane stany do Allegro,
- limit stanu wysyłanego do kanału sprzedaży,
- ustawienie nadpisywania parametrów ofert danymi z produktu podpiętego z katalogu Allegro.
Ważne: zmiana ustawień w edycji integracji nie zawsze zmienia dane na ofertach, które zostały utworzone wcześniej. Przykładowo, jeśli oferta została wystawiona z domyślnym typem ceny ustawionym wcześniej w integracji, zmiana domyślnego typu ceny w edycji integracji będzie stosowana przede wszystkim przy nowych ofertach lub przy kolejnych aktualizacjach zgodnie z logiką danej synchronizacji.
Jeżeli włączysz nadpisywanie parametrów ofert danymi z katalogu Allegro, działanie zacznie mieć znaczenie przy aktualizacji danej oferty. Samo zapisanie ustawienia w edycji integracji nie zmienia od razu wszystkich wcześniejszych ofert.
Zakładka: Import ofert
Jeżeli podczas dodawania integracji nie uruchomiono importu ofert albo chcesz ponowić pobieranie ofert z Allegro, przejdź do zakładki Import ofert i wybierz Importuj oferty.
Import ofert pobiera oferty z konta Allegro do xSale. Przy większej liczbie ofert proces może potrwać dłużej, dlatego po uruchomieniu warto obserwować komunikaty i postęp importu.
O czym warto pamiętać?
- Najpierw dodaj rynek bazowy Allegro PL, a dopiero później rynki dodatkowe.
- Autoryzację wykonuj na właściwym koncie Allegro, ponieważ to ono zostanie połączone z xSale.
- Zakres integracji wybrany w kreatorze wpływa na kolejne kroki konfiguracji.
- Jeżeli chcesz wystawiać lub aktualizować oferty, uzupełnij parametry sprzedaży wymagane przez Allegro.
- Po zakończeniu konfiguracji sprawdź, czy integracja jest aktywna.
EN