Integracja z Otomoto i Allegro — automatyzacja wystawiania ogłoszeń motoryzacyjnych

Integracja z Otomoto, która przez pięć lat wystawiła ponad 13 000 ogłoszeń, pewnego dnia po prostu przestała działać — a razem z nią stanęła sprzedaż online. W tym projekcie przywróciliśmy martwe połączenie z Otomoto, zdiagnozowaliśmy dlaczego integracja z Allegro milczała od lat i oddaliśmy klientowi panel, dzięki któremu sam zarządza integracją bez dzwonienia do agencji. Poniżej opisujemy, jak wygląda skuteczna automatyzacja wystawiania ogłoszeń motoryzacyjnych na marketplace’ach.

Kluczowe informacje o wdrożeniu

• Klient: firma motoryzacyjna z południa Polski sprzedająca pojazdy i części przez ogłoszenia na Otomoto i Allegro; katalog prowadzony w autorskim systemie klienta na CodeIgniter
• Problem: integracja z Otomoto nagle przestała wystawiać ogłoszenia — 238 pozycji utknęło w kolejce; integracja z Allegro była martwa od kilku lat, a klient nie wiedział dlaczego
• Rozwiązanie: diagnoza na żywym API zamiast zgadywania, udrożnienie autoryzacji OAuth, automatyzacja publikacji z auto-odświeżaniem tokenu i panel self-service dla klienta
• Efekt: integracja przywrócona, zaległa kolejka wznowiona, klient samodzielnie zarządza połączeniem, wytyczona ścieżka na cztery marketplace’y przez jedno API
• Realizacja: Auranet — integracje systemowe i automatyzacja procesów B2B

Wyzwanie: integracja, która działała pięć lat — i nagle zamilkła

Przez pięć lat (2021–2026) autorski system klienta wystawiał ogłoszenia na Otomoto w pełni automatycznie — ponad 13 000 publikacji, równomiernie miesiąc w miesiąc. W kwietniu 2026 publikacja nagle się urwała. W kolejce oczekujących utknęło 238 pozycji, a sprzedaż online praktycznie stanęła. Druga integracja — z Allegro — była martwa jeszcze dłużej, bo od 2021 roku.

Najbardziej dotkliwy był jednak brak kontroli: klient nie wiedział, dlaczego integracja przestała działać, a przy każdej zmianie — hasła, kategorii, ustawień konta — musiał dzwonić do wykonawcy. To częsty wzorzec w integracjach marketplace: dopóki działają, nikt o nie nie dba; gdy padną, okazuje się, że nikt nie wie, jak są zbudowane.

Diagnoza: testy na żywym Otomoto API zamiast zgadywania

Zaczęliśmy od rekonesansu wyłącznie do odczytu na produkcji, a następnie od testów na żywym API — bo tylko realne odpowiedzi serwerów mówią prawdę o stanie integracji. Ustalenia były precyzyjne:

• Otomoto: identyfikator aplikacji (client_id) był wciąż rozpoznawany przez serwery, ale hasło konta było nieaktualne — klient zmienił je samodzielnie mniej więcej w kwietniu, przy resecie przez logowanie OLX. Dodatkowo stary panel deweloperski developer.otomoto.pl został zlikwidowany: Otomoto przeniosło integracje do ekosystemu OLX Group Partner, a dotychczasowy sposób autoryzacji hasłem jest wycofywany.
• Allegro: aplikacja deweloperska została unieważniona po migracji panelu Allegro w 2024 roku — serwer odpowiadał invalid_client. Na to nałożył się błąd w kodzie odświeżania tokenu (przy nieudanym odświeżeniu nadpisywał zapisany token pustą wartością) oraz trzy nowe wymogi polityk Allegro, m.in. zakaz fraz kierujących kupującego do kontaktu poza platformą i obowiązkowy parametr „Producent części”.

Diagnoza faktami zamiast wymiany komponentów „na oślep” zajęła ułamek czasu, który pochłonęłoby przepisywanie integracji od zera — i wskazała dokładnie, co naprawić.

Rozwiązanie: integracja z Otomoto odzyskana i oddana w ręce klienta

Auranet zaprojektował i wdrożył rozwiązanie w czterech warstwach. Koncepcję opracował Jan Schenk na podstawie wyników diagnozy i realnego procesu sprzedaży u klienta.

Krok 1: udrożnienie autoryzacji i panel self-service

Przywróciliśmy poprawną autoryzację OAuth z Otomoto i — co ważniejsze — zbudowaliśmy panel, w którym klient sam zmienia hasło konta, testuje połączenie (przycisk „Sprawdź połączenie” wykonuje realny test autoryzacji na żywym API) i wymusza przetworzenie kolejki. To uniezależnienie klienta od agencji jest celowe: następna zmiana hasła nie zatrzyma już sprzedaży na dwa miesiące.

Krok 2: automatyzacja wystawiania ogłoszeń

Cron cyklicznie pobiera pozycje z kolejki i publikuje ogłoszenia z automatycznym odświeżaniem tokenu — integracja nie „umiera” po wygaśnięciu autoryzacji. Każde ogłoszenie może mieć wiele zdjęć, które system automatycznie zmniejsza do rozdzielczości wymaganej przez Otomoto. Kategorie ogłoszeń wybierane są z listy pobieranej na żywo z API, więc zmiany w drzewie kategorii Otomoto nie psują publikacji.

Krok 3: sync „sprzedane → zdjęte z oferty” — bug zamiast mitu

Klient od lat ręcznie kasował ogłoszenia sprzedanych pozycji, bo „automat tego nie umiał”. Testy na żywym API pokazały co innego: funkcja dezaktywacji w kodzie wołała endpoint aktywacji zamiast dezaktywacji. Właściwy endpoint działał od zawsze poprawnie (HTTP 204). Poprawka była trywialna, bez żadnej migracji danych — ale znaleźć ją można było tylko testując realne wywołania, a nie czytając dokumentację po raz kolejny.

Krok 4: ścieżka future-proof — OLX Group Car Parts API

Stary model integracji Otomoto odchodzi do historii, dlatego wytyczyliśmy ścieżkę migracji na OLX Group Car Parts API — jedną integrację, która obsługuje jednocześnie cztery marketplace’y: Otomoto, Autovit, OLX.pl i OLX.ro. Ten sam katalog, bez dodatkowej pracy operatora, może docierać do czterokrotnie szerszej publiczności.

Co istotne, wzorzec jest transferowalny: OAuth, kolejka, cron, mapowanie kategorii i galeria zdjęć działają tak samo niezależnie od tego, czy katalogiem jest autorski system na CodeIgniter, sklep WooCommerce, czy własny typ treści w WordPressie. Tę samą architekturę stosujemy m.in. w systemie do zarządzania częściami z demontażu dla firmy z branży autorecyklingu.

Wyniki wdrożenia

Dlaczego Auranet

• Diagnoza faktami. Zanim cokolwiek wymienimy, testujemy żywe API i czytamy realne odpowiedzi serwerów. To dlatego naprawa „niedziałającego od lat” syncu sprzedanych pozycji zajęła jedną poprawkę, a nie przepisanie modułu.
• Niezależnie od stacku. Naprawiamy i budujemy integracje z marketplace’ami dla autorskich systemów (utrzymujemy tego typu rozwiązania na CodeIgniter), sklepów WooCommerce i instalacji WordPress z własnymi typami treści — patrz nasze pozostałe integracje systemów, API, ERP i CRM.
• Klient zostaje samodzielny. Panel self-service i dokumentacja zamiast uzależnienia od wykonawcy. Podobnie projektujemy automatyzacje procesów w n8n — narzędzie ma pracować dla firmy, nie firma dla narzędzia.

Dla kogo jest ta integracja

Automatyzacja wystawiania ogłoszeń na Otomoto, Allegro i OLX sprawdza się wszędzie tam, gdzie katalog jest większy niż cierpliwość operatora:

• komisy i firmy handlujące pojazdami, które wystawiają dziesiątki ogłoszeń miesięcznie;
• sklepy i hurtownie części samochodowych — nowych i używanych;
• platformy z ogłoszeniami motoryzacyjnymi z własnym, autorskim zapleczem;
• sklepy WooCommerce, które chcą publikować ofertę na marketplace’ach bez podwójnego wpisywania danych.

Najczęstsze pytania (FAQ)

Czy integracja z Otomoto działa ze sklepem WooCommerce?

Tak. Wzorzec integracji — autoryzacja OAuth, kolejka ogłoszeń, cron publikujący, mapowanie kategorii i galeria zdjęć — jest niezależny od źródła katalogu. Podłączamy pod Otomoto i Allegro zarówno autorskie systemy, jak i WooCommerce czy własne typy treści w WordPressie.

Czym różni się stare Otomoto API od OLX Group Car Parts API?

Stary panel deweloperski developer.otomoto.pl został zlikwidowany, a integracje przeniesiono do ekosystemu OLX Group Partner; autoryzacja hasłem jest wycofywana. OLX Group Car Parts API to nowsza ścieżka: jedna integracja publikuje ogłoszenia jednocześnie na Otomoto, Autovit, OLX.pl i OLX.ro.

Co zrobić, gdy integracja z Allegro nagle przestała wystawiać ogłoszenia?

Najpierw sprawdzić autoryzację na żywym API — po migracji panelu Allegro część starych aplikacji deweloperskich została unieważniona (błąd invalid_client). Warto też zweryfikować obsługę odświeżania tokenu w kodzie oraz zgodność ogłoszeń z aktualnymi politykami Allegro, m.in. zakazem fraz kierujących do kontaktu poza platformą i obowiązkowym parametrem „Producent części”.

Czy klient może sam zarządzać integracją z Otomoto?

Tak — i tak to projektujemy. Panel self-service pozwala samodzielnie zmienić hasło konta, przetestować połączenie na żywym API jednym przyciskiem i wymusić przetworzenie kolejki ogłoszeń. Zmiana hasła czy kategorii nie wymaga kontaktu z agencją.

Następny krok

Twoja integracja z Otomoto lub Allegro przestała działać — albo nigdy nie ruszyła? Zdiagnozujemy ją na żywym API i powiemy dokładnie, co jest do naprawy, zanim zaproponujemy jakiekolwiek prace. Niezależnie od tego, czy katalog prowadzisz w autorskim systemie, WooCommerce, czy arkuszu, z którego wszyscy chcą uciec.

Zapytaj o wycenę: wypełnij formularz wyceny lub napisz na office@auranet.com.pl — odezwiemy się w ciągu 24 godzin.

Auranet — integracje systemowe i automatyzacja procesów B2B. Marketing oparty na danych.