Integracja PrestaShop z OLX

Prestino OLX — ogłoszenia i wiadomości OLX w panelu PrestaShop

Obsługuj ofertę OLX bezpośrednio w zapleczu swojego sklepu. Prestino OLX łączy produkty i warianty PrestaShop z ogłoszeniami na autoryzowanym koncie OLX, pozwala przygotowywać oferty, aktualizować ceny i odpowiadać klientom z jednego panelu.

Moduł korzysta z OLX Partner API. Jest przeznaczony dla sprzedawców, którzy chcą wykorzystać katalog sklepu jako podstawę ogłoszeń i ograniczyć ręczne przepisywanie danych.

Produkty i warianty pod kontrolą

• Lista produktów i wariantów z miniaturami, ceną brutto, dostępnością oraz statusem powiązanej oferty OLX.
• Wyszukiwanie po nazwie, indeksie produktu i EAN, filtry statusów oraz stronicowanie wyników.
• Wyszukiwanie przy użyciu kilku fraz i możliwość usunięcia wybranej frazy bez wpisywania zapytania od nowa.
• Wystawianie nowego ogłoszenia lub powiązanie produktu z istniejącą ofertą na swoim koncie OLX.
• Odłączenie powiązania w module bez usuwania ogłoszenia w OLX.

Wygodny edytor ogłoszenia

Przygotuj ofertę na podstawie produktu ze sklepu i dostosuj ją do sprzedaży w OLX. Edytor obejmuje tytuł, opis, kategorię, wymagane i opcjonalne parametry kategorii, cenę, walutę, lokalizację oraz dane kontaktowe. Dostępne dla danej kategorii opcje obejmują także negocjację ceny, zamianę i cenę jako budżet.

• Zdjęcia produktu lub wariantu, wybór zdjęć do ogłoszenia i kontrola limitu kategorii.
• Mapowanie kategorii sklepu na kategorie OLX jako domyślny wybór dla nowych ofert.
• Wyszukiwarka miast oraz wybór dzielnicy, jeśli wymaga tego lokalizacja.
• Dane bezpieczeństwa produktu GPSR, gdy mają zastosowanie.
• Zapis lokalnego szkicu przed publikacją, również gdy oferta nie jest jeszcze kompletna.
• Walidacja danych przed wysłaniem i zachowanie wpisanych informacji po błędzie formularza.

Szkic pozostaje oddzielony od danych pobieranych z OLX. Możesz wrócić do pracy nad ofertą bez publikowania niedokończonych zmian.

Obsługa istniejących ofert OLX

Przeglądaj ogłoszenia z połączonego konta — również te, które nie mają jeszcze powiązania z produktem sklepu. Lista pokazuje miniaturę, tytuł, identyfikator, status, cenę i dostępne akcje. Pozwala wyszukać dokładny identyfikator zewnętrzny oraz przejść do oferty w OLX lub do edycji powiązanego produktu.

Moduł obsługuje aktualizację ogłoszeń, aktywację, dezaktywację i przedłużenie w zakresie dostępnym dla danej oferty w API. W edytorze można odczytać statystyki, takie jak wyświetlenia, odsłony numeru telefonu i obserwujący, a także informacje o moderacji i aktywnych wyróżnieniach.

Wiadomości i zdjęcia w jednym miejscu

Odpowiadaj kupującym bez opuszczania panelu sklepu. Komunikator pokazuje listę rozmów z miniaturami produktów, tytułami ofert i informacją o nieprzeczytanych wiadomościach. Historia rozmowy ma czytelne chmurki, a własne wiadomości są wyróżnione ciemnym tłem i białym tekstem.

• Odpowiedzi tekstowe i przeglądanie historii konwersacji.
• Automatyczne oznaczanie rozmowy jako przeczytanej po wyświetleniu jej treści, dla użytkownika z uprawnieniem do edycji.
• Zapisywanie ulubionych rozmów i filtr „Zapisane”.
• Wyszukiwanie w pobranej liście rozmów oraz odświeżanie wiadomości.
• Dodawanie zdjęć z dysku przez ikonę spinacza lub przeciągnięcie na pole wiadomości.
• Walidacja plików przed przesłaniem: JPG, JPEG i PNG, maksymalnie 8 MB na plik i 8 załączników w wiadomości.
• Lista dodanych plików z możliwością ich usunięcia przed wysyłką oraz miniatury zdjęć w historii rozmowy.

Zdjęcia są przesyłane na serwer sklepu i udostępniane OLX pod publicznym adresem HTTPS. Moduł zarządza ich czasowym przechowywaniem i sprzątaniem; plików nie usuwa natychmiast, jeśli mogłoby to uniemożliwić ich pobranie przez OLX.

Synchronizacja cen i dostępności

Automatyczna synchronizacja może aktualizować ceny aktywnych, powiązanych ofert oraz wyłączać ogłoszenia, gdy produkt ma zerowy stan lub został wyłączony w sklepie. Ustawienia synchronizacji znajdują się w osobnym panelu na stronie „Połączenie”.

• Osobne ustawienia synchronizacji cen i wyłączania ofert przy braku dostępności.
• Adres CRON do skopiowania i skonfigurowania na serwerze sklepu.
• Przetwarzanie ofert partiami i kontynuacja od zapamiętanego miejsca.
• Raport ostatniej synchronizacji i historia operacji ułatwiające kontrolę działania.

Automat wymaga regularnego wywoływania adresu CRON przez serwer. Zalecany interwał to 5 minut. Powrót produktu na stan nie wznawia automatycznie ogłoszenia — wznowienie pozostaje świadomą decyzją sprzedawcy. OLX nie udostępnia pola ilości magazynowej w modelu ogłoszenia; moduł reaguje na dostępność przez status oferty.

Przesyłki, saldo i pakiety

Konfiguruj Przesyłki OLX w ogłoszeniu w zakresie dostępnym dla wybranej kategorii i konta. Moduł pokazuje przewoźników, gabaryty, limity wagi oraz dostępne warunki dostawy. Pomaga wybrać przewoźników ze wspólnym rozmiarem paczki.

Podsumowanie pozwala odczytać informacje o saldzie konta i dostępnych pakietach ogłoszeń według kategorii oraz metody płatności. Moduł nie dokonuje automatycznych zakupów pakietów ani płatnych wyróżnień.

Połączenie i codzienna administracja

• Autoryzacja konta OLX przez OAuth, odświeżanie dostępu i test połączenia z czytelnym wynikiem.
• Adres callback HTTPS z przyciskiem kopiowania oraz maskowanie sekretu aplikacji.
• Powrót do ustawień modułu po autoryzacji i komunikaty o połączeniu lub odłączeniu konta.
• Pobieranie słowników kategorii i miast z informacją o postępie.
• Obsługa uprawnień pracowników panelu PrestaShop.
• Panel licencji i wbudowany mechanizm sprawdzania oraz instalowania dostępnych aktualizacji, z kopią modułu przed instalacją.

Wymagania

• PrestaShop 8.x lub 9.x.
• PHP 8.1–8.4 oraz ionCube Loader odpowiedni dla wersji PHP: 13+ dla PHP 8.1–8.2, 14+ dla PHP 8.3 i 15+ dla PHP 8.4.
• Rozszerzenia PHP cURL, OpenSSL, mbstring i fileinfo; możliwość zapisu plików na serwerze.
• Sklep dostępny przez HTTPS oraz publicznie dostępne adresy zdjęć i załączników.
• Konto OLX i zatwierdzona aplikacja z dostępem do OLX Partner API, Client ID oraz Client Secret.
• Ważna licencja modułu. Okres licencji, wsparcia i aktualizacji wynika z wybranego wariantu licencyjnego.
• Dostęp do konfiguracji zadań CRON, jeśli chcesz korzystać z automatycznej synchronizacji.

Jak rozpocząć?

1. Zainstaluj paczkę modułu w PrestaShop i otwórz zakładkę „Połączenie”.
2. W konfiguracji aplikacji OLX wpisz adres callback pokazany przez moduł.
3. Zapisz Client ID i Client Secret, autoryzuj konto i sprawdź połączenie.
4. Uzupełnij lokalizację i dane kontaktowe, pobierz miasta i kategorie oraz ustaw mapowanie kategorii sklepu.
5. Przygotuj pierwsze ogłoszenie lub powiąż istniejącą ofertę z produktem.
6. W razie potrzeby włącz synchronizację i skonfiguruj zadanie CRON na serwerze.

Zakres integracji z OLX

Funkcje zależą od uprawnień aplikacji, kategorii, konta oraz dostępności usług w OLX. Ogłoszenie po wysłaniu może trafić do moderacji lub wymagać opłaty; zapis przez API nie oznacza automatycznie aktywnej publikacji.

Moduł nie importuje zamówień OLX ani danych transakcyjnych kupujących, nie generuje etykiet i nie śledzi przesyłek. Konfiguracja Przesyłek OLX dotyczy ustawień dostawy w ogłoszeniu. Komunikator nie udostępnia usuwania rozmów ani kosza przez API.