Jak połączyć OLX z easySales: kompletny przewodnik po integracji

Co daje Ci OLX połączony z easySales

easySales publikuje Twoje produkty na OLX jako ogłoszenia, a potem utrzymuje je w aktualnym stanie: ceny i stany magazynowe podążają za Twoim katalogiem, ogłoszenia znikają, gdy produkt się wyprzeda, i wracają po uzupełnieniu zapasu. Na OLX PL easySales może też importować Twoje zamówienia z OLX, a na OLX PL i OLX RO PulseAI może uzupełniać nowe oferty, które sprawdzasz, zanim zostaną wysłane.

Prowadzisz jeden katalog dla wszystkich kanałów sprzedaży, zamiast edytować każde ogłoszenie ręcznie. Najbardziej liczy się to przy większej skali. Wystawienie pięćdziesięciu produktów na OLX ręcznie to jedno popołudnie; utrzymywanie pięćdziesięciu ogłoszeń w zgodzie ze zmieniającym się stanem magazynu to zajęcie bez końca — i właśnie tę część przejmuje easySales.

Obsługiwane są cztery rynki OLX, każdy łączony osobno i każdy z własną walutą:

To niezależne połączenia. Jeśli sprzedajesz i na OLX.pl, i na OLX.ro, potrzebujesz dwóch połączeń, każde z własnymi danymi kontaktowymi, lokalizacją i mapowaniem kategorii.

Jak działa konektor OLX

easySales łączy się z OLX przez autoryzację OAuth po stronie OLX — zatwierdzasz aplikację easySales z poziomu swojego konta OLX, zamiast przenosić klucz API z miejsca na miejsce, więc nie masz żadnego klucza do przechowywania ani rotowania.

easySales odnawia tę autoryzację automatycznie, dopóki połączenie działa. Nie musisz niczego odnawiać ręcznie. Odnawianie zatrzymuje się, gdy coś zmieni się po stronie OLX — na przykład dostęp dla easySales zostanie cofnięty albo zmienisz hasło do OLX. Jeśli przez 28 dni autoryzacja nie zostanie odnowiona, easySales codziennie Cię ostrzega, e-mailem i w aplikacji. To sygnał, żeby użyć Uwiarygodnij ponownie z OLX.

Twój katalog zawsze trafia na OLX jako ogłoszenia. Zamówienia wracają tylko z OLX PL: włącz Importuj zamówienia, a każde zamówienie pojawi się jako zwykłe zamówienie w easySales, gotowe do fakturowania, listów przewozowych i automatycznych przepływów. Na OLX w Rumunii, Bułgarii i Portugalii integracja obejmuje wyłącznie ogłoszenia, a kupujących z tych rynków nadal obsługujesz na swoim koncie OLX.

Zanim zaczniesz

Krok 1 — Otwórz formularz połączenia i uwiarygodnij easySales

W easySales przejdź do Integracje → Marketplace'y, znajdź rynek OLX dla swojego kraju i kliknij Połącz.

Formularz otwiera się z przyciskiem Uwiarygodnij z OLX. Po kliknięciu trafiasz na ekran logowania i uprawnień po stronie OLX. Zatwierdzasz tam easySales i wracasz do formularza połączenia, już powiązanego z tym kontem OLX.

Jeśli chcesz przełączyć połączenie na inne konto OLX albo easySales ostrzega Cię, że autoryzacja przestała się odnawiać, ten sam przycisk pojawi się jako Uwiarygodnij ponownie z OLX. Skorzystaj z niego, zamiast usuwać i budować połączenie od nowa — ponowna autoryzacja zachowuje mapowanie kategorii i powiązane ogłoszenia.

Na OLX PL i OLX RO połączenie ma dwie zakładki: Główne ustawienia i Generowanie ofert przez AI. Druga zawiera ustawienia PulseAI opisane niżej i pojawia się, jeśli Twoje konto ma dostęp do generowania ofert przez AI.

Krok 2 — Uzupełnij ustawienia połączenia

Autoryzacja to dopiero połowa. Formularz zawiera ustawienia dziedziczone przez każde ogłoszenie. Pięć pól jest wymaganych: Alias, Dodatek do ceny, Miasto, Imię i nazwisko kontaktu oraz Telefon kontaktu.

Tożsamość i lokalizacja

• Alias — nazwa, pod jaką połączenie występuje w easySales. Nigdy nie widzą jej kupujący, więc nazwij je dla siebie: OLX Polska, OLX RO magazyn 2.
• Imię i nazwisko kontaktu oraz Telefon kontaktu — to, co OLX pokazuje w ogłoszeniu. Na ten numer zadzwonią kupujący.
• Miasto i opcjonalnie Dystrykt — miejsce publikacji ogłoszenia. Najpierw wybierasz miasto; lista dystryktów filtruje się według niego. Dystrykt możesz zostawić pusty.

Ceny

• Dodatek do ceny — procent doliczany do ceny Twojego produktu, wyłącznie na tym kanale. Przy 10% produkt za 10 zł wychodzi za 11 zł. Dotyczy ceny wysyłanej przez easySales; Twój katalog pozostaje nietknięty.
• Źródło ceny sprzedaży — domyślnie Cena z katalogu. Jeśli zamiast tego wybierzesz grupę cenową, Twoje oferty OLX pobiorą cenę z tej grupy; gdy ceny w grupie się zmienią, easySales automatycznie wyśle je ponownie. Dodatek do ceny nie jest stosowany do cen pobieranych z grupy cenowej.
• Płatnik VAT — ustaw na Tak tylko wtedy, gdy konto zarejestrowane na OLX należy do czynnego podatnika VAT. Zmienia sposób naliczania cen, więc błędne ustawienie przesuwa każde ogłoszenie.

Domyślne ustawienia ogłoszeń

• Domyślny stan produktu — stosowany do ogłoszeń, które nie określają tego same. OLX w Rumunii oferuje stany Nowy, Używany, Nowe z tagiem, Nowe bez tagu, Noszone raz i W dobrym stanie; OLX BG, PL i PT oferują Nowy i Używany.
• Automatyczne odświeżenie — automatycznie publikuje ogłoszenia ponownie po ich wygaśnięciu. Ogłoszenia OLX nie trwają wiecznie, a bez tej opcji przechodzą w stan outdated i po cichu przestają być widoczne.
• Dostawa kurierem — Tak, jeśli wysyłasz kurierem, Nie, jeśli kupujący odbierają osobiście. To pole nie jest wyświetlane na OLX PL.
• Informacja o wysyłce — dopisywana na końcu każdego opisu ogłoszenia i wliczana do limitu długości opisu na OLX.

Domyślne ustawienia zamówień (OLX PL)

• Domyślny podatek od wysyłki — stawka VAT stosowana do wysyłki w importowanych zamówieniach z OLX PL.
• Domyślny typ paczki — domyślny typ paczki na liście przewozowym dla importowanych zamówień.
• Domyślny status indywidualny — opcjonalny; własny status nadawany importowanym zamówieniom z OLX PL.

Zachowanie przy stanach magazynowych — dwa przełączniki decydujące o tym, co dzieje się wraz ze zmianą stanu:

• Dezaktywuj oferty, gdy produkty wyprzedadzą się — zdejmuje ogłoszenie, gdy produkt osiąga zero, zamiast zostawiać je aktywne dla kupujących, których nie obsłużysz.
• Automatycznie aktywuj oferty, kiedy produkty mają zapas — przywraca je po uzupełnieniu zapasu. Ogłoszenie, które dezaktywowałeś samodzielnie, nie zostanie ponownie aktywowane.

Włączenie obu sprawia, że integracja utrzymuje się sama. Jeśli zostawisz je wyłączone, wracasz do ręcznego pilnowania dostępności.

Krok 3 — Zmapuj kategorie

Ogłoszenia nie zostaną opublikowane, dopóki nie zmapujesz kategorii. easySales musi wiedzieć, do której kategorii OLX należy każda Twoja kategoria, ponieważ to kategoria decyduje po stronie OLX o tym, co może zawierać ogłoszenie.

Mapuj do kategorii końcowej — najniższego poziomu drzewa kategorii OLX, pod którym nie ma już nic. Kategoria nadrzędna nie wystarczy: Telefony, na przykład, potrzebują jeszcze marki poniżej. Jeśli ogłoszenia są odrzucane od razu po pierwszej publikacji, zwykle przyczyną jest mapowanie, które kończy się o jeden poziom za wysoko.

Wybieraj starannie: po opublikowaniu ogłoszenia OLX nie pozwala zmienić jego kategorii.

Na OLX PL i OLX RO z włączonym PulseAI oferta bez zmapowanej kategorii i tak ją otrzyma: PulseAI wybiera dla tej oferty kategorię końcową, a Ty sprawdzasz ją, zanim oferta zostanie wysłana.

Krok 4 — Opublikuj pierwsze ogłoszenia

Gdy połączenie jest uwiarygodnione, a kategorie zmapowane, przejdź do Produkty, zaznacz to, co chcesz wystawić, i użyj Dodaj ofertę przy produkcie albo przycisku dodawania ofert nad listą, aby opublikować kilka naraz.

Zacznij od kilku sztuk, nie od całego katalogu. Pierwsza partia pokaże Ci, czy mapowanie kategorii i ustawienia domyślne są poprawne, a poprawienie dziesięciu ogłoszeń jest znacznie prostsze niż tysiąca.

Przed dużą publikacją sprawdź treści pod kątem limitów OLX:

• Tytuły: OLX wymaga 16–150 znaków.
• Opisy: najwyżej 9000 znaków, liczonych tak, jak liczy je OLX: z formatowaniem i z Informacją o wysyłce dopisywaną przez easySales.

Na OLX PL i OLX RO easySales sprawdza przed wysłaniem kategorię, wymagane cechy i długość opisu i zatrzymuje ofertę, którą OLX by odrzucił — zobacz niżej Kontrole, przez które przechodzi każda oferta OLX PL i OLX RO przed wysłaniem.

Statusy ogłoszeń, które zobaczysz

Po publikacji każde ogłoszenie ma w easySales status odzwierciedlający to, co raportuje OLX:

limited i moderated to dwa warte obserwowania. limited oznacza, że wyczerpałeś pulę darmowych ogłoszeń i kolejne nie staną się aktywne, dopóki nie dokupisz pakietu w OLX. moderated jest normalne przy pierwszej publikacji w nowej kategorii i zwykle rozwiązuje się samo.

Zamówienia z OLX PL i OLX Delivery

OLX PL to rynek OLX, z którego zamówienia trafiają do easySales. Import zamówień jest domyślnie wyłączony i ustawiany osobno dla każdego połączenia: otwórz połączenie OLX PL i w sekcji Zamówienia OLX włącz Importuj zamówienia.

Zaimportowane zamówienie z OLX PL to zwykłe zamówienie w easySales. Zawiera klienta, adres rozliczeniowy i adres dostawy, produkty — dopasowane do Twojej oferty przez ogłoszenie OLX — oraz pozycję wysyłki opodatkowaną według ustawienia Domyślny podatek od wysyłki. Otrzymuje Domyślny status indywidualny, jeśli go ustawisz, a Twoje automatyczne przepływy działają na nim jak na każdym innym zamówieniu.

Strona zamówienia pokazuje jego status w OLX i termin na potwierdzenie. easySales przekłada statusy OLX na własne:

• Oczekuje na potwierdzenie → Nowe
• Potwierdzone lub oczekuje na wysyłkę → Procesowane
• W drodze, wypłata lub zakończone → Zakończone
• Odrzucone, anulowane lub wysyłka wygasła → Anulowane
• Nieudana wysyłka lub zwrot → Zwrot

Automatyczna akceptacja zamówień

Automatyczna akceptacja zamówień potwierdza za Ciebie nowe zamówienia z OLX PL: „Zaakceptowanie zamówienia potwierdza w Twoim imieniu warunki zamówienia OLX, z użyciem poniższych danych nadawcy.”

Dane nadawcy obejmują pola: Imię, Nazwisko, Firma (opcjonalnie), Telefon, E-mail, Ulica, Numer domu, Numer lokalu (opcjonalnie), Kod pocztowy i Miejscowość.

Wysyłka z OLX Delivery

OLX zamawia przewoźnika w chwili akceptacji zamówienia. Gdy etykieta OLX jest gotowa, easySales ją pobiera i zapisuje w zamówieniu przewoźnika oraz numer przesyłki, a w wyborze kuriera do listu przewozowego pojawia się kurier OLX Delivery. Wybierz go tam, aby użyć etykiety OLX jako listu przewozowego zamówienia.

Wysyłaj stan magazynowy do OLX

Wysyłaj stan magazynowy do OLX dotyczy ogłoszeń sprzedawanych z pakietami dostawy OLX, wybranymi na Twoim koncie OLX. Gdy opcja jest włączona, easySales przy każdej aktualizacji ogłoszenia wysyła dostępny stan, maksymalnie 1000 sztuk. Jak zaznacza samo ustawienie: „OLX przestaje oferować przesyłkę, gdy spadnie do zera.”

Faktury i anulowanie

Zamówienia z OLX PL fakturujesz w swoim programie do fakturowania, jak każde inne zamówienie w easySales. Aby anulować zamówienie, anuluj je w easySales: zostanie ono odrzucone lub anulowane także w OLX, a powód wybierasz z listy OLX.

PulseAI na OLX PL i OLX RO: automatyczne generowanie ofert

PulseAI może uzupełniać za Ciebie nowe oferty na OLX PL i OLX RO — kategorię, cechy, stan produktu oraz, jeśli zechcesz, tytuł i opis — a następnie wstrzymać je do Twojej weryfikacji. Funkcja jest dostępna na OLX PL i OLX RO, w każdym połączeniu, i jest domyślnie wyłączona.

Ustawienia znajdziesz w zakładce Generowanie ofert przez AI połączenia, która podsumowuje to tak: „Nowe oferty są uzupełniane automatycznie przez AI, a następnie czekają na Twoją weryfikację. Nic nie trafia na marketplace bez Twojej akceptacji.”

Ustawienia generowania ofert przez AI

• Uzupełniaj nowe oferty przez AI — włącza automatyczne uzupełnianie. Dotyczy tylko nowo utworzonych ofert; istniejące oferty nie są zmieniane.
• Cechy do uzupełnienia — jak daleko idzie PulseAI: Tylko te, które blokują publikację, Wszystkie cechy, puste w razie niepewności (domyślnie) lub Wszystkie cechy, zawsze z najlepszym przybliżeniem. Szerszy wybór zużywa więcej dziennego limitu na każdą ofertę.
• Popraw pola, które marketplace by odrzucił — domyślnie włączone. Na OLX tytuł dłuższy niż 150 znaków jest skracany na granicy słowa.
• Popraw tytuł oferty — przepisuje tytuł każdej nowej oferty zgodnie z zasadami OLX: 16–150 znaków, nie głównie wielkimi literami, bez danych kontaktowych. Nowy tytuł czeka na weryfikację razem z resztą oferty.
• Popraw krótkie lub brakujące opisy — przepisuje tylko opisy puste lub bardzo krótkie. OLX wyświetla formatowanie tylko w kategorii Praca, więc opis powstaje jako zwykłe linie tekstu i mieści się w limicie długości OLX razem z Twoją Informacją o wysyłce.
• Gdy dzienny limit się skończy — Utwórz ofertę bez AI, jak zwykle albo Poczekaj na jutrzejszy limit. Oczekujące oferty nie są wysyłane, dopóki nie zostaną uzupełnione i zweryfikowane, a możesz je zwolnić w dowolnym momencie z listy ofert.

Jeszcze jedno ustawienie znajduje się w zakładce Główne ustawienia: PulseAI może zmieniać stan produktu, domyślnie ustawione na Nie.

• Nie — PulseAI proponuje stan produktu tylko wtedy, gdy kategoria nie akceptuje obecnego.
• Tak — PulseAI proponuje stan (nowy, używany, uszkodzony…) na podstawie danych produktu, nawet gdy obecny stan jest poprawny dla kategorii, więc używana część zapisana jako nowa zostanie poprawiona.

Ustawienie działa zarówno przy automatycznym uzupełnianiu, jak i przy przycisku Uzupełnij wartości automatycznie z PulseAI. Gdy nic nie przesądza o stanie, używany jest Domyślny stan produktu z połączenia, o ile kategoria go akceptuje.

Co PulseAI uzupełnia w nowej ofercie

• Kategoria — kategoria z Twojego mapowania kategorii zostaje zachowana. Bez niej PulseAI wybiera dla oferty kategorię końcową. Nigdy nie zmienia kategorii ogłoszenia już opublikowanego na OLX, bo OLX na to nie pozwala.
• Cechy — na wybranym przez Ciebie poziomie. PulseAI nigdy nie zgaduje numerów części, numerów VIN, kodów producenta, list kompatybilności ani gwarancji.
• Stan produktu — zgodnie z ustawieniem PulseAI może zmieniać stan produktu.
• Tytuł i opis — tylko gdy odpowiednie ustawienia są włączone.

Weryfikacja ofert uzupełnionych przez AI

Oferta uzupełniona przez PulseAI ma na swojej stronie baner Uzupełniona przez AI — czeka na Twoją weryfikację z dopiskiem: „Sprawdź poniższe wartości, a następnie zatwierdź, aby ją wysłać. Zapis ani ponowne wysłanie nie opublikują jej wcześniej.” Jeśli PulseAI zmienił stan produktu lub kategorię, baner o tym informuje i podaje starą oraz nową wartość.

Oferta, która wciąż czeka w kolejce, pokazuje Czeka na uzupełnienie przez AI: „Ta oferta nie jest jeszcze na marketplace. Usuń ją z kolejki AI, aby wystawić ją w obecnej formie.”

Na listach ofert OLX PL i OLX RO filtr Generowanie AI pokazuje Czeka na moją weryfikację, Czeka na uzupełnienie lub Wyłączone automatycznie: brak weryfikacji AI, a oferty mają znacznik AI — do sprawdzenia lub AI — w kolejce. Menu akcji AI zawiera Zatwierdź i wyślij, Usuń z kolejki AI i Zobacz aktywność AI.

Zweryfikuj w ciągu 60 dni. Oferta niezweryfikowana w ciągu 60 dni zostaje wyłączona, nigdy niewysłana, i jest oznaczona jako Wyłączona automatycznie: brak weryfikacji AI. Jej włączenie zatwierdza ją i wysyła na OLX.

Uzupełnij wartości automatycznie z PulseAI — na żądanie

W każdej ofercie OLX przycisk Uzupełnij wartości automatycznie z PulseAI wypełnia cechy w formularzu i proponuje stan. Nic nie zostaje zapisane, dopóki sam nie zapiszesz. Uzupełnione wartości są oznaczone „Uzupełnione przez AI - sprawdź przed zapisaniem.”, a wartość, której PulseAI nie był w stanie ustalić — „PulseAI nie był pewien tej wartości. Uzupełnij ją.” Na koniec krótkie pytanie: „Czy autouzupełnienie było trafne?”

Dzienny limit

Automatyczne uzupełnianie korzysta z dziennego limitu AI Twojego konta; przycisk Uzupełnij wartości automatycznie z PulseAI — nie. O tym, co dzieje się po wyczerpaniu limitu, decydujesz w ustawieniu Gdy dzienny limit się skończy.

Kontrole, przez które przechodzi każda oferta OLX PL i OLX RO przed wysłaniem

Dotyczą każdej oferty na OLX PL i OLX RO, niezależnie od tego, czy uzupełnił ją PulseAI. easySales zatrzymuje ofertę, zanim trafi na OLX, i pokazuje Ci powód, gdy:

• oferta nie ma kategorii albo ma kategorię, której nie ma na liście OLX;
• opis, z formatowaniem i Twoją Informacją o wysyłce, jest dłuższy niż 9000 znaków;
• tylko w przypadku nowego ogłoszenia: jej kategoria nie jest kategorią końcową, wymagana cecha jest pusta albo wartość wybrana z listy lub stan produktu nie należy do akceptowanych przez OLX w tej kategorii.

Ogłoszenie już opublikowane na OLX nie jest wstrzymywane z powodu swoich cech: OLX sprawdza je przy tworzeniu ogłoszenia.

Limity darmowych ogłoszeń i promowanie

OLX daje każdemu kontu pulę darmowych ogłoszeń i pobiera opłaty powyżej niej. Po przekroczeniu progu easySales pokazuje komunikat, a nowe ogłoszenia otrzymują status limited — nic nie ginie, ale nic się też nie opublikuje, dopóki nie dokupisz pakietu na koncie OLX.

Promowanie odbywa się w OLX, nie w easySales. Wyróżnienie ogłoszenia na pierwszej stronie, podbicia i płatne promowanie znajdziesz na swoim koncie OLX. easySales publikuje i utrzymuje ogłoszenie; jego widoczność pozostaje decyzją OLX.

Jeśli synchronizacja się zatrzyma

Niemal każde zepsute połączenie z OLX sprowadza się do autoryzacji: cofnięta zgoda albo zmiana hasła po stronie OLX zatrzymuje automatyczne odnawianie. Otwórz połączenie i użyj Uwiarygodnij ponownie z OLX. Mapowanie i powiązane ogłoszenia pozostają nienaruszone, więc ponowna autoryzacja jest zawsze lepsza niż usuwanie połączenia i zaczynanie od zera.

Jeśli ogłoszenia się publikują, ale są odrzucane, przyczyna leży zwykle w samym ogłoszeniu, a nie w połączeniu: kategoria, która nie jest końcowa, opis przekraczający limit OLX albo pusta wymagana cecha. Na OLX PL i OLX RO easySales wychwytuje to przed wysłaniem i pokazuje Ci powód.

Jeśli oferta na OLX PL lub OLX RO nie została wysłana, sprawdź, czy nie wstrzymuje jej PulseAI: filtr Generowanie AI na liście ofert pokazuje każdą ofertę czekającą na Twoją weryfikację albo na AI.