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: вставьте ключ или запустите пробный период на вкладке «Лицензия».