Elbuz łączy się z kontem OLX, pobiera ogłoszenia do katalogu bazowego, a potem sam aktualizuje na OLX ceny, wyłącza i przywraca ogłoszenia według dostępności oraz publikuje nowe.
Kiedy to się przyda:
- Produkt skończył się w magazynie — ogłoszenie znika z OLX, a gdy produkt wróci, ogłoszenie też wraca.
- Zmieniasz cenę w katalogu — eksport wyśle ją do ogłoszenia.
- Ogłoszenia już są na OLX — stają się kartami katalogu razem ze zdjęciami i parametrami.
- Chcesz wystawić nowe produkty — program publikuje ogłoszenia i wiąże je z kartami.
Od czego zacząć: powiąż konto OLX w szablonie „OLX” okna „Import danych”.
Co potrafi integracja z OLX
- Import ogłoszeń — tytuł, opis, cena, kategoria, parametry i zdjęcia trafiają do karty, a status ogłoszenia staje się dostępnością.
- Ceny i dostępność z powrotem — zmieniona cena trafia do ogłoszenia, zerowy stan je wyłącza, niezerowy — włącza.
- Publikacja — produkty bez ogłoszenia są wystawiane na OLX z obowiązkowymi parametrami kategorii.
- Ochrona zmian — przełączniki „Nie aktualizuj” i „Stała cena” w karcie.
W partnerskim OLX nie ma zamówień — są tylko ogłoszenia i wiadomości od kupujących. Kupujący pisze lub dzwoni bezpośrednio do Ciebie, a platforma nie tworzy żadnego dokumentu. Włączone pole importu zamówień niczego nie zepsuje: Elbuz zapisze w dzienniku, że zamówienia nie są przekazywane przez API.
Czego potrzebujesz od OLX
Rejestrowanie aplikacji w OLX nie jest potrzebne: wystarczy zatwierdzić dostęp do konta i wpisać krótki kod powiązania. Dostęp OLX odnawia się codziennie, a Elbuz przedłuża go sam.
- „Region” w karcie „Połączenie” —
pl(Polska) alboua(Ukraina). Określa platformę logowania i walutę ogłoszeń: złoty lub hrywna. - Jedno powiązanie na konto: jeśli połączysz OLX w szablonie importu, szablon eksportu korzysta z tego samego dostępu, i odwrotnie. Przycisk „Połącz” i pole kodu są w obu.
- Miasto i telefon są potrzebne tylko do publikacji i ustawia się je w szablonie eksportu (publikacja).
Jak podłączyć krok po kroku
- Utwórz szablon typu „OLX” i zapisz go — powiązanie działa dla zapisanego szablonu.
- Wpisz w pole „Region” pl albo ua.
- Kliknij „Połącz”, zatwierdź dostęp w OLX i od razu wklej kod powiązania — jest ważny krótko.
- Kliknij „Sprawdź połączenie”: odpowiedź powinna zawierać platformę i nazwę konta.
- Uruchom import ręcznie i sprawdź, czy ogłoszenia trafiły do katalogu z cenami, opisami i zdjęciami.
- Ustaw harmonogram szablonu, a ceny i dostępność skonfiguruj osobnym szablonem eksportu.
Co trafia do karty
| Dane OLX | Pole produktu w Elbuz |
|---|---|
| tytuł ogłoszenia | Nazwa |
| opis | Opis |
| cena | Cena |
| status ogłoszenia | Status i dostępność |
| kategoria OLX | Kategoria |
| parametry ogłoszenia | Cechy |
| zdjęcia | Zdjęcia (jeśli zaznaczono pole) |
W OLX produkt nie ma ilości: ogłoszenie jest aktywne albo wyłączone. Aktywne daje stan 1, wyłączone — 0. W drugą stronę tak samo: stan większy od zera aktywuje ogłoszenie, zero — wyłącza.
Cechy z ogłoszenia przychodzą z technicznym kodem parametru OLX zamiast czytelnej nazwy. To nie błąd: po tych kodach program szuka obowiązkowych parametrów kategorii podczas publikacji.
Kategorie tworzone przez import
Import pyta OLX o nazwę kategorii ogłoszenia i szuka u Ciebie kategorii o takiej samej nazwie, a jeśli jej nie znajdzie — tworzy ją. To jedna nazwa, a nie pełna ścieżka drzewa OLX. Ogólne zasady — kategorie i marki techniczne.
Ogłoszenie bez kategorii trafia do technicznej „Produkty - olx” — wyłączonej i bez „Eksportuj do pliku (do sklepu)”. Dopóki produkt jest tylko w niej, eksport go nie bierze: cena i dostępność na OLX się nie aktualizują, a w dzienniku nie ma o nim ani słowa. Przenieś kartę do własnej kategorii albo włącz eksport kategorii technicznej.
- Karty można przenosić: kolejny import nie zmienia miejsca w drzewie, a powiązanie z ogłoszeniem jest zapisane osobno — w panelu bocznym produktu wiersz „ID olx #…”.
- Dopasowanie do kategorii OLX jest zapisane w Twojej kategorii. Jeśli przeniesiesz produkt do kategorii bez dopasowania, nowe ogłoszenia dla niego nie będą publikowane; już utworzone nadal się aktualizują.
- Cechy można usuwać, ale z nich zbierane są obowiązkowe parametry: produkt bez wymaganej cechy przestanie być publikowany.
Co kolejny import robi z Twoimi zmianami
Kolejny przebieg szuka karty po nazwie: OLX nie przekazuje SKU ogłoszenia, a numer ogłoszenia nie jest używany do wyszukiwania. Klucz liczony jest raz, przy tworzeniu karty.
- Zmieniasz nazwę produktu w Elbuz — karta zostanie znaleziona po pierwotnej nazwie, a przebieg po cichu przywróci jej tytuł ogłoszenia.
- Zmieniasz tytuł w panelu OLX — przebieg utworzy obok drugą kartę, a stara zostanie z ostatnimi danymi.
Edycja tytułów już zaimportowanych ogłoszeń w panelu OLX powoduje duplikaty. Powiązanie z ogłoszeniem mają obie karty, więc eksport przetworzy ogłoszenie dwa razy i zostanie ostatnia zapisana cena. Zbędną kartę usuń od razu.
| Pole karty | Co robi przebieg |
|---|---|
| Nazwa, opis, cena, ilość, „włączone/wyłączone”, pełna nazwa kategorii | nadpisuje danymi z ogłoszenia |
| Wewnętrzne SKU, kod kreskowy, tagi, stara cena | nie zmienia — ogłoszenie nie ma tych pól |
| Zdjęcia i cechy | dodaje tylko przy tworzeniu karty |
| Miejsce w drzewie kategorii | nie zmienia |
Całą kartę zablokujesz przełącznikiem „Nie aktualizuj” w sekcji „Ochrona podczas importu”; w tabeli „Produkty” to kolumna „Nie aktualizować (flaga)”. Tylko cenę — „Stała cena”: nazwę, opis i dostępność przebieg nadal bierze z ogłoszenia. „Nie aktualizuj” chroni kartę przed wszystkimi importami, nie tylko przed OLX. Ogólne zasady — jak zablokować własną wartość.
1
Nie aktualizuj2
Stała cena- Nie aktualizuj — przebieg importu całkowicie pomija tę kartę produktu.
- Stała cena — cena z importowanego ogłoszenia nie jest zapisywana w produkcie.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Czyja cena wygrywa
- Reguły narzutu pomijają kartę z OLX: liczą cenę od ceny zakupu, a ogłoszenie jej nie ma. Wygrywa cena z ogłoszenia.
- Cena zakupu przyszła z innego źródła (na przykład kartę znalazł cennik dostawcy) — kolejny narzut przeliczy cenę od niej. Cenę z ogłoszenia utrzyma „Stała cena”: narzut pomija produkty z nią i z „Nie aktualizuj”.
- Dwa źródła na jedną kartę — wyszukiwanie idzie po nazwie, więc w polu zostaje wartość przebiegu, który zakończył się jako ostatni. SKU, kodu kreskowego, tagów i starej ceny zapisanych przez inne źródło OLX nie nadpisuje. Cech istniejącej karty OLX w ogóle nie zmienia.
Jak aktualizować ceny i dostępność na OLX
Kierunek odwrotny to osobny szablon eksportu typu „OLX”. Dla każdego powiązanego ogłoszenia Elbuz robi dwie rzeczy:
- Cena — odczytuje ogłoszenie i, jeśli cena się zmieniła, wysyła całe ogłoszenie: OLX przyjmuje je tylko w całości, więc reszta przenosi się bez zmian.
- Dostępność — włącza albo wyłącza ogłoszenie według stanu.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Dziennik zapisuje „OLX: przetworzono ogłoszeń: …” co 50 ogłoszeń, a na końcu „OLX: ceny i dostępność zaktualizowane, ogłoszeń: … (błędów: …)”. Błędy to tutaj tylko odmowy przy zmianie ceny; liczba ogłoszeń pokazuje, ile ich przejrzano, a nie ile zmieniono.
Odmowy przy włączaniu lub wyłączaniu są zebrane w pomarańczowym wierszu „OLX: platforma odrzuciła polecenia aktywacji/dezaktywacji: …” z liczbą i pierwszą odmową (produkt, polecenie, przyczyna). Często oznacza to tylko, że ogłoszenie było już we właściwym stanie.
Cena nie jest wysyłana, gdy jest zerowa albo gdy ogłoszenia nie udało się odczytać — wtedy przebieg idzie dalej bez wpisu w dzienniku, a polecenie włączenia lub wyłączenia i tak zostaje wykonane.
Jak publikować nowe ogłoszenia
Publikację włącza pole „Publikuj nowe produkty” w szablonie eksportu. Bez niego produkty bez powiązania są po cichu pomijane. Wymagania OLX wobec ogłoszenia:
| Wymóg OLX | Co to oznacza dla katalogu |
|---|---|
| Tytuł od 16 do 150 znaków | Zbyt krótką nazwę Elbuz sam uzupełnia do minimum — dopisuje numer kategorii i kropki, więc taki tytuł lepiej poprawić w karcie. Dłuższy niż 150 znaków jest obcinany |
| Opis od 80 znaków | Produkt z krótkim opisem jest pomijany, z wpisem w dzienniku. Opis jest brany z karty bez znaczników i obcinany na 9000 znakach |
| Kategoria końcowa OLX | Musi być dopasowana do kategorii produktu, inaczej produkt jest pomijany |
| Obowiązkowe parametry kategorii | Są brane z cech produktu po nazwie; jeśli czegoś brakuje — pominięcie z listą w dzienniku |
| Miasto i telefon | Wpisuje się je w szablonie eksportu w polu „Wersja API (parametry platformy)” jednym wierszem: region, ID miasta, telefon rozdzielone pionową kreską — na przykład pl|1|48501234567 |
Bez miasta lub telefonu dziennik zapisze „OLX: nie podano ID miasta (city_id) lub telefonu — publikacja jest niemożliwa. Uzupełnij je w szablonie” i nowych ogłoszeń nie będzie. Ceny i dostępność powiązanych ogłoszeń aktualizują się przy tym normalnie.
Dla każdego produktu program pyta OLX o obowiązkowe parametry kategorii, składa ogłoszenie — tytuł, opis, cenę w walucie regionu, do ośmiu zdjęć — i wysyła je. Po otrzymaniu numeru od razu zapisuje powiązanie „produkt — ogłoszenie” i ustawia produktowi znacznik „Wyeksportowano”.
- Wiersz dla każdego ogłoszenia: „OLX: opublikowano ogłoszenie «nazwa» (ID …)”.
- Na końcu — ile opublikowano, ile pominięto i ile czeka na płatny pakiet.
- Nowe ogłoszenia przechodzą moderację OLX.
- Початок або кінець
- Розвилка: далі шлях залежить від відповіді
Gdy limit darmowych ogłoszeń jest wyczerpany, OLX przyjmuje ogłoszenie jako „ograniczone”: utworzone, ale niewyświetlane bez pakietu. Elbuz nie opłaca takich ogłoszeń — wiąże je z produktem i zapisuje wiersz „OLX: «nazwa» utworzono, ale wymaga płatnego pakietu…” z radą, by aktywować je na koncie OLX.
Kategorie OLX.pl i OLX.ua
OLX.pl i OLX.ua mają różne drzewa kategorii. Przycisk „Pobierz słownik platformy” w oknie dopasowania kategorii (zakładka OLX) pobiera kategorie regionu podanego w polu „Region” szablonu importu OLX i okno pokazuje właśnie je: dla pl — polskie kategorie, ceny ogłoszeń — w złotych.
Dopasowanie kategorii do kategorii OLX jest jedno na konto Elbuz. Jeśli zmienisz region szablonu z ua na pl lub odwrotnie, dopasuj kategorie od nowa: kategorie innego regionu nie będą pasować.
Obowiązkowe parametry: jak je uzupełnić
To najczęstszy powód, dla którego ogłoszenia nie są publikowane. Każda kategoria końcowa OLX ma własny zestaw obowiązkowych parametrów — stan, rozmiar, marka itp. Elbuz bierze je z cech produktu po nazwie lub kodzie parametru, a dla list dobiera wariant z listy. Jeśli brakuje cechy, ogłoszenie jest pomijane, a dziennik wymienia do ośmiu brakujących nazw.
Zacznij od jednej kategorii: opublikuj kilka produktów, sprawdź w dzienniku, jakich parametrów wymaga OLX, i utwórz cechy o takich samych nazwach. Potem kategoria będzie publikowana bez pominięć.
Harmonogram i wielkość przebiegu
Szablony importu i eksportu ustawia się w harmonogramie osobno — jak działa harmonogram źródeł API.
- Nie ma górnego limitu. Import pobiera ogłoszenia stronami po 100 i zapisuje do katalogu paczkami po 500. Eksport bierze wszystkie produkty, które przeszły filtr szablonu; na koncie demonstracyjnym — nie więcej niż 100 na przebieg.
- Zapytania do platformy: w eksporcie do trzech na ogłoszenie (odczyt, zapis ceny, jeśli się zmieniła, włączenie lub wyłączenie); na publikację produktu — dwa; w imporcie — jedno na stronę plus jedno na każdą nową kategorię.
- Oczekiwanie: do 120 sekund na zapytanie, 30 na połączenie. Przy „za dużo zapytań” — do trzech prób z przerwami dwie, cztery i sześć sekund; potem import zatrzymuje się z błędem.
- Zatrzymanie z dziennika: import doczytuje i zapisuje bieżącą stronę; eksport i publikacja tego nie sprawdzają i idą do końca listy.
Dziennik prowadzi Centrum operacji, okno można zamknąć.
Scenariusze
Ogłoszenia OLX mają być w katalogu razem z innymi produktami
Ustawienia: szablon importu „OLX”, konto powiązane, w wyborze danych zaznaczone „Produkty” i, jeśli potrzebne są zdjęcia, „Zdjęcia”.
Efekt: każde ogłoszenie staje się kartą, aktywne — ze stanem 1, wyłączone — z 0. Każdy przebieg przywraca nazwę, opis i cenę z ogłoszenia. Późniejsze zmiany zdjęć w ogłoszeniu nie trafią do już utworzonej karty.
Produkt skończył się w magazynie — ogłoszenie ma zniknąć z OLX
Ustawienia: szablon eksportu „OLX” z zaznaczonym polem „Produkty”, „Publikuj nowe produkty” wyłączone.
Efekt: stan większy od zera włącza ogłoszenie, zero je wyłącza. Cena jest wysyłana tylko wtedy, gdy jest większa od zera i różni się od ceny w ogłoszeniu. Produkty bez powiązania są pomijane; przebieg nie umie usuwać ogłoszeń — tylko je wyłączać.
Ceny i opisy prowadzisz w Elbuz, a import nie powinien ich nadpisywać
Ustawienia: „Nie aktualizuj” w sekcji „Ochrona podczas importu” karty; dla ceny na OLX — szablon eksportu z zaznaczonym polem „Produkty”.
Efekt: import z OLX nie nadpisuje karty, a eksport wyśle do ogłoszenia Twoją cenę. Aby zablokować tylko cenę — „Stała cena”.
Co zrobić, gdy OLX działa nie tak
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Powiązanie nie zadziałało | Kod powiązania jest ważny krótko | Pobierz kod od nowa i wklej go od razu (jak podłączyć) |
| „OLX: platforma odrzuciła polecenia aktywacji/dezaktywacji: …” | Najczęściej ogłoszenie jest już we właściwym stanie; w innym przypadku — moderacja lub limit | Sprawdź pierwszą odmowę w wierszu; moderację i limit wyjaśnij w panelu OLX |
| Cena na OLX się nie zaktualizowała | Cena jest taka sama jak w ogłoszeniu, zerowa albo ogłoszenia nie udało się odczytać | Sprawdź cenę w karcie (ceny i dostępność) |
| Produkt w ogóle nie trafia do eksportu | Jest tylko w technicznej „Produkty - olx” bez eksportu | Przenieś go do własnej kategorii (kategorie) |
| Ogłoszenie nie jest publikowane | Krótki opis, niedopasowana kategoria, brak parametrów albo miasta i telefonu | Sprawdź wiersz dziennika z nazwą produktu (wymagania OLX) |
| W katalogu są dwie karty jednego ogłoszenia | Tytuł zmieniono w panelu OLX po imporcie | Usuń zbędną kartę (kolejny import) |
| Przebieg przerwał się z błędem | OLX odpowiedział błędem albo „za dużo zapytań” trzy razy z rzędu | Uruchom ponownie (przerwanie przebiegu) |
Jeśli przebieg przerwał się w połowie
Ogólne zasady — w przeglądzie. Specyfika OLX:
- Import przy błędzie OLX dopisuje do katalogu wszystko, co odczytał, nawet niepełną paczkę. Stare zostają ogłoszenia, do których nie doszła kolej. Powtórka jest bezpieczna, dopóki nie zmieniano tytułów w panelu OLX.
- Publikacja zapisuje powiązanie przy każdej odpowiedzi OLX z numerem, więc powtórka dokończy resztę i nie opublikuje powiązanego ogłoszenia drugi raz.
- Przerwanie w chwili wysyłki — ogłoszenie na OLX może już istnieć bez powiązania w Elbuz, a kolejny przebieg opublikuje je jeszcze raz. Odpowiedź z błędem daje czerwony wiersz „OLX: błąd publikacji ogłoszenia” z przyczyną; produkt trafi do kolejnej próby.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Jeśli uruchomiono nie to, co trzeba
- Znajdź opublikowane. Dziennik przebiegu (wcześniejsze — przycisk „Historia uruchomień” w nagłówku szablonu) ma wiersz dla każdego ogłoszenia. W karcie produktu — wiersz „ID olx #…” i przycisk „Na stronie”, który prowadzi do ogłoszenia; link mają tylko ogłoszenia utworzone przez Elbuz.
- Wyłącz ogłoszenia zerowym stanem i powtórz eksport. Usuwać ogłoszeń Elbuz nie umie — robi się to w panelu OLX.
- Ceny na OLX popraw w katalogu i uruchom eksport ponownie — pójdzie tylko to, co się zmieniło, a tekst, zdjęcia i parametry nie ucierpią.
- Cen w katalogu po błędnym imporcie nie da się masowo przywrócić. Zmienione karty widać po „Dacie aktualizacji”, utworzone — po „Źródło: nazwa”, poprzednią cenę — w „Historii cen produktu”, jeśli jej prowadzenie jest włączone (ogólna procedura wycofania).
Usunięcie produktu w Elbuz to nie to samo co zdjęcie ogłoszenia. Razem z kartą znika powiązanie, a ogłoszenie na OLX zostaje i nie ma już czym nim sterować. Jeśli utworzysz produkt ponownie z „Publikuj nowe produkty”, pojawi się drugie ogłoszenie. Najpierw wyłącz ogłoszenie zerowym stanem, potem usuwaj karty.
Najczęstsze pytania
Dlaczego z OLX nie przychodzą zamówienia?
Nie ma ich w API OLX: kupujący kontaktuje się ze sprzedawcą bezpośrednio, a platforma nie tworzy dokumentu. Elbuz zarządza ogłoszeniami, cenami i dostępnością.
Jak przekazywana jest dostępność, skoro ogłoszenie nie ma ilości?
Przez widoczność: stan większy od zera — ogłoszenie aktywne, zero — wyłączone. W drugą stronę aktywne ogłoszenie przychodzi ze stanem 1, wyłączone — z zerem.
Co oznacza „ograniczone” ogłoszenie?
Wyczerpano limit darmowych publikacji: ogłoszenie jest utworzone, ale nie jest wyświetlane, dopóki nie kupisz pakietu na koncie OLX. Elbuz nie kupuje pakietów, tylko informuje o tym w dzienniku.
Co wybrać w polu „Region”?
pl dla Polski, ua dla Ukrainy — od tego zależą platforma, waluta i kategorie do dopasowania. Region musi odpowiadać krajowi podłączonego konta OLX (kategorie).
Jak wyłączyć ogłoszenia opublikowane przez pomyłkę?
Ustaw produktom zerowy stan i powtórz eksport. Usunąć ogłoszenia trzeba w panelu OLX (kolejność działań).
Czy można podłączyć dwa konta OLX?
Nie: powiązanie jest jedno na konto Elbuz i wszystkie szablony OLX działają z tym samym kontem.
Gdzie to jest i kto ma dostęp
- Menu
- Operacje → Import danych → szablon typu „OLX”
- Ceny, dostępność, publikacja
- Operacje → Eksport danych → szablon typu „OLX”
- Uprawnienia
- okna „Import danych” i „Eksport danych” w „Uprawnieniach grup”
- Przygotuj
- logowanie do konta OLX; do publikacji — miasta i telefon
1
Pole „Region”2
Przycisk „Połącz”3
Pole kodu powiązania i „Powiąż sklep”- Region — wpisz pl dla Polski albo ua dla Ukrainy.
- Połącz — otwiera logowanie do OLX i wydaje kod powiązania.
- Pole kodu powiązania i przycisk „Powiąż sklep” — wklej tu kod i powiąż sklep.
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu integracji przez API — import katalogu przez API.
- Jeśli import nadpisuje Twoje zmiany i chcesz zrozumieć dlaczego — przegląd importu danych.
- Jeśli obok OLX sprzedajesz na Prom — zamówienia z Prom.ua.
- Jeśli zastanawiasz się, czy warto wystawiać produkty na OLX z Elbuz — integracja z OLX.
- Jeśli planujesz sprzedaż na marketplace’ach — co to daje Twojemu sklepowi.
