Сайт на OpenCart або ocStore

OpenCart і ocStore (українсько-російська збірка OpenCart) не мають власного REST API, тому Рекс.Селлер працює з ними через безкоштовне розширення «Рекс.Селлер Connector». Ви встановлюєте його один раз — і замовлення з сайту приходять у «Продажі», а статуси й номери ТТН повертаються в історію замовлення на сайті.

Яку версію завантажити

Ваш сайт	Файл у вікні підключення
OpenCart 3.0.x	«Рекс.Селлер Connector для OpenCart 3.x»
OpenCart 4.0.x, 4.1.x	«Рекс.Селлер Connector для OpenCart 4.x»
ocStore 3.0.x	«Рекс.Селлер Connector для ocStore 3.x»
ocStore 4.1	«Рекс.Селлер Connector для ocStore 4.x (бета)»

ocStore 2.3 і OpenCart 2.x не підтримуються. Файли завантажуються у вікні Налаштування → «Інтеграції» → OpenCart (або ocStore) → «Підключити» — під підказкою з інструкцією.

Крок 1. Встановити розширення

OpenCart:

1. Адмінка → Розширення → Встановлення розширень (Extensions → Installer) → завантажте zip-файл.
2. Розширення → Розширення → тип «Модулі» → Рекс.Селлер Connector → «Встановити», потім «Редагувати».
3. Увімкніть статус модуля й збережіть.

ocStore: те саме через Доповнення → Установка доповнень, потім Доповнення → Доповнення → Модулі → Рекс.Селлер Connector → Встановити.

Крок 2. Скопіювати URL і ключ

У налаштуваннях модуля є:

• «URL конектора» — адреса, за якою Рекс.Селлер звертається до сайту;
• «API-ключ» — секретний ключ (кнопка «Згенерувати новий ключ» створює інший — після цього підключення треба оновити);
• «URL вебхука» і «Секрет вебхуків» — для миттєвих замовлень (крок 4).

Крок 3. Підключити в Рекс.Селлер

1. Налаштування → «Інтеграції» → «Інтернет-магазини» → OpenCart або ocStore → «Підключити».
2. «Назва» і «Магазин» для замовлень.
3. Вставте «URL конектора» і «API-ключ конектора» з модуля.
4. Перевірте налаштування й натисніть «Перевірити» → «Підключити». Успішна перевірка покаже версію магазину й конектора.

Важливо

Якщо на сайті увімкнено SEO Pro (часто в ocStore), копіюйте URL конектора саме з модуля — у вигляді https://ваш-сайт/index.php?route=…. Короткі «гарні» адреси SEO Pro перенаправляє, і запити Рекс.Селлер губляться. Адресу виду https://shop.ua/?route=… Рекс.Селлер виправить сам.

Крок 4. Вебхук — миттєві замовлення

1. У Рекс.Селлер відкрийте підключену інтеграцію → «Підключення» → «Вебхук» і скопіюйте «URL вебхука».
2. Вставте його в поле «URL вебхука» у модулі на сайті. Якщо задаєте власний «Секрет вебхуків», впишіть те саме значення в Рекс.Селлер → інтеграція → «Секрет вебхуків». Порожньо — вебхуки підписуються API-ключем.
3. Збережіть модуль і натисніть «Перевірити» в ньому — має з’явитися «Рекс.Селлер прийняв тестовий вебхук».

Без вебхука Рекс.Селлер однаково забирає замовлення за розкладом («Інтервал опитування, хв», за замовчуванням 5).

Налаштування й статуси

Перемикачі ті самі, що й для інших каналів: «Імпортувати замовлення», «Передавати статуси й ТТН» (за замовчуванням вимкнено), «Автоматично приймати нові замовлення», «Створювати відсутні товари автоматично» — див. Маркетплейси.

«Наші статуси → майданчик» для OpenCart — це order_status_id вашого магазину: за замовчуванням 3 — Shipped, 5 — Complete, 7 — Canceled (в ocStore: 3 — «Доставлено», 5 — «Завершено», 7 — «Скасовано»). Якщо у вас власні статуси, вкажіть їхні id. Номер ТТН додається в історію замовлення на сайті.

Зверніть увагу

«Автоматично приймати нові замовлення» для OpenCart спрацює, лише якщо в «Наші статуси → майданчик» вказано статус для «Не оброблене» (напр. id статусу «В обробці» вашого магазину).

Що приходить із замовленням

• Покупець, телефон і e-mail (в OpenCart 4 телефон може бути необов’язковим — тоді клієнта знайдуть за e-mail).
• Спосіб доставки, адреса й вартість доставки.
• Товари з опціями. OpenCart записує опції в назву рядка, напр. «Кава зернова (Вага: 500 г)». Рекс.Селлер розбирає опції й зіставляє рядок з потрібним варіантом чи фасуванням товару в каталозі.

Якщо рядок не зіставлено, він позначений «Не з каталогу»: «Знайти в каталозі» → оберіть товар, варіант чи фасування → «Замінити». Рекс.Селлер запам’ятає вибір саме для цієї опції, і наступні такі замовлення прийдуть зіставленими.

Товари сайту → каталог

«Огляд» → «Завантажити товари з сайту», далі «Імпортувати в каталог» (з назвою, артикулом, ціною, фото й посиланням) або «Зв’язати вручну» з наявними товарами. Детальніше — у Маркетплейси.

Порада

Фото товарів імпортуються з конектора версії 1.2 і новіших. Якщо встановили розширення давно, завантажте свіжий zip і встановіть поверх старого.

Часті питання

Перевірка пише, що конектор недоступний. Переконайтеся, що модуль увімкнено, URL скопійовано з модуля повністю (з index.php?route=), а сайт відкривається з інтернету по HTTPS. Подивіться «Журнал» інтеграції.

Дати замовлень зсунуті на кілька годин. Перевірте часовий пояс у налаштуваннях OpenCart (Система → Налаштування) і на сервері.

Залишки на сайті не оновлюються. Передача залишків і цін на сайти зараз призупинена — синхронізуються замовлення, статуси й ТТН, хоча опис модуля згадує й залишки.