OLX Connector для OpenCart — оголошення OLX з товарів, ціни й залишки

OLX Connector для OpenCart 4.x, 3.x і 2.3 публікує товари магазину оголошеннями на OLX через офіційний Partner API: OLX.ua, а також OLX у Польщі, Румунії, Болгарії, Португалії й Казахстані. Ви зіставляєте категорії магазину з категоріями OLX, і оголошення створюється з назви, опису, фото, ціни й залишку товару.

Що потрібно від OLX. Кожен магазин реєструє власний застосунок на порталі розробників OLX (для України це developer.olx.ua) і чекає, поки OLX його схвалить: лише після цього OLX видає Client ID і Client Secret. Один застосунок працює для однієї країни; для другої країни потрібен окремий застосунок з акаунтом OLX цієї країни.

Що бачить покупець

Покупець на OLX бачить звичайне оголошення вашого акаунта: заголовок і опис товару, фото з магазину, ціну за вашими правилами (податок, курс, націнка, округлення), місто й контакти, які ви вказали в модулі. Коли в Pro товар закінчився, оголошення стає неактивним, тож покупець не замовляє те, чого немає.

Що отримує адмін

Розширення → Модулі → OLX Connector: вкладки «Підключення», «Оголошення», «Категорії», «Ціни і залишки», «Товари», «Замовлення», «Ліцензія» і «Журнал». На вкладці «Підключення» обираєте країну OLX, вписуєте Client ID і Client Secret, копіюєте показаний Callback URL у свій застосунок OLX і натискаєте «Підключити акаунт OLX»: OLX просить увійти й дозволити доступ. Секрет зберігається зашифрованим і у форму не повертається.

На вкладці «Оголошення» задаєте те, що йде в кожне оголошення: приватна особа чи бізнес, імʼя й телефон, місто (вводите координати магазину, а «Знайти місто» підставляє місто й район OLX), мову текстів і кількість фото. На вкладці «Категорії» кнопка «Підібрати» шукає категорію OLX за назвою товару, «Переглянути дерево» показує всі категорії; для категорій з обовʼязковими атрибутами задаєте, звідки брати значення: стале або з атрибута товару.

У формі товару зʼявляється вкладка OLX: «Продавати цей товар на OLX», власний заголовок і категорія для цього товару. «Перевірити» показує, яким піде оголошення: заголовок, категорія, ціна, залишок, кількість фото, і що саме заважає, якщо воно не готове. «Опублікувати на OLX» створює оголошення; далі там само є «Оновити оголошення», «Деактивувати», «Активувати», «Подовжити» і «Видалити оголошення», номер оголошення з посиланням, його стан і термін дії. Один товар — одне оголошення: опції товару окремими оголошеннями не публікуються, залишок береться з кількості товару.

Ціна оголошення рахується з ціни магазину (акційної, якщо акція діє): плюс податок, курс до валюти оголошення, націнка у відсотках і сумою, округлення. Резерв залишку лишає задану кількість для магазину. У Pro модуль стежить за товарами з оголошеннями: змінилася ціна, текст чи залишок — завдання за розкладом надсилає зміну на OLX; залишок дійшов до резерву — оголошення деактивується, зʼявився знову — активується. Там само Pro читає з OLX модерацію й завершення терміну, публікує всю категорію магазину однією кнопкою і застосовує шаблони заголовка й опису.

Замовлення OLX через API OLX відкриває лише в Польщі. Для польського акаунта Pro створює із замовлення OLX замовлення OpenCart, зменшує залишок, веде статус слідом за OLX, а на сторінці замовлення дає панель із кнопками «Прийняти», «Етикетка (PDF)» і скасуванням. OLX не передає продавцю адресу доставки й e-mail покупця: у замовленні магазину є дані для рахунка, якщо покупець їх дав, а адреса доставки — на етикетці OLX. Для України та інших країн вкладка «Замовлення» поки нічого не робить.

Як це працює, крок за кроком

1. Встановлюєте архів для своєї версії OpenCart і вмикаєте модуль.
2. На порталі розробників OLX своєї країни додаєте застосунок і вказуєте Callback URL з вкладки «Підключення». Чекаєте схвалення OLX.
3. Вписуєте Client ID і Client Secret, натискаєте «Підключити акаунт OLX» і дозволяєте доступ.
4. На вкладці «Оголошення» вказуєте контакти й місто, на вкладці «Категорії» зіставляєте категорії й атрибути, на вкладці «Ціни і залишки» задаєте правила ціни.
5. У товарі на вкладці OLX натискаєте «Перевірити», потім «Опублікувати на OLX».
6. У Pro додаєте завдання за розкладом: ціна й залишок далі оновлюються самі, товар без залишку знімається з OLX.

Що під капотом

• OLX Partner API 2.0, вхід через OAuth; Client Secret і токени зберігаються зашифрованими.
• Один товар — одне оголошення; опції окремо не публікуються.
• OLX приймає заголовок 16–150 символів і опис 80–9000 символів без e-mail і адрес сайтів: модуль прибирає HTML, e-mail і посилання, а закороткий заголовок доповнює брендом і моделлю. Закороткі описи потрібно дописати в товарі.
• Коли ліміт безкоштовних оголошень у категорії вичерпано, OLX ставить оголошенню стан «ліміт»: пакет купується в акаунті OLX, модуль платних пакетів не купує.
• OLX дозволяє 4500 запитів за 5 хвилин з однієї IP-адреси й блокує на 30 хвилин за перевищення: модуль надсилає зміни чергою, до 100 товарів за запуск, з паузами.
• OLX тримає підключення місяць після останнього використання; у Pro модуль оновлює його у фоні.
• Після втраченої відповіді OLX оголошення не дублюється: модуль знаходить уже створене.
• Події OpenCart без правок ядра; під час оновлення модуля підключення, відповідності категорій і звʼязки з оголошеннями лишаються.
• Інтерфейс українською, російською, польською й англійською.

Як встановити

1. Розширення → Встановлення: завантажте архів для своєї версії без перейменування файлу (OpenCart 4 — cc_olx.ocmod.zip, 3.x — cc_olx-oc3.ocmod.zip, 2.3 — cc_olx-oc23.ocmod.zip).
2. Для 3.x і 2.3: Розширення → Модифікатори → Оновити.
3. Розширення → Модулі → OLX Connector: встановіть і відкрийте.
4. Оберіть країну, впишіть Client ID і Client Secret, підключіть акаунт OLX.
5. Для Pro: вставте ключ або запустіть пробний період на вкладці «Ліцензія».