
OneBox Sync — CRM для OpenCart 2.3, 3.x і 4.x
Замовлення OpenCart в OneBox; у Pro — статуси в обидва боки, UTM-мітки, власні поля й старі замовлення. Ліцензія назавжди.
- Сумісність
- OpenCart 2.3.0.0 – 2.3.0.2 · 3.0.2 – 3.0.5 · 4.0.2 – 4.1.x
- PHP
- 7.4 і новіший
- Версія
-
v1.2.1 (OpenCart 4)
v1.2.0 (OpenCart 3.x)
v1.2.0 (OpenCart 2.3) - Ліцензія
- сайт + тестова копія, назавжди
- Тріал
- 7 днів, без картки, один на сайт
- Оновлено
- листопад 2026
Що є в Free,
а що дає Pro
Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.
Як це виглядає

Тріал стартує, коли ви попросите
Свіжий інстал — безкоштовна версія, нічого не вмикається само. Кнопка «Спробувати Pro 7 днів» → e-mail → ключ одразу у вікні і листом.

Один ключ — сайт і тестова копія
Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.
Технічні вимоги
OpenCart 2.3.0.0 – 2.3.0.2, 3.0.2 – 3.0.5 і 4.0.2 – 4.1.x — три окремі збірки
PHP 7.4+ для збірок OpenCart 3.x і 4.x; збірка для OpenCart 2.3 працює й на PHP 5.6 – 7.x
OneBox OS з компонентом «API v2» (1b.app → Додатки → API-сервіси) та логіном/паролем співробітника для REST API
Історія версій
Pro: коли замовлення надсилається в CRM за статусом-тригером, наступні зміни його статусу теж передаються в CRM — раніше вони губилися.
Pro і в збірках для OpenCart 3.x і 2.3.
Pro для OpenCart 4.x: статуси в обидва боки (перевірка статусів за розкладом), UTM-мітки, власні поля, відправка старих замовлень, «Повторити всі невдалі», листи про збої; ліцензія назавжди…
Усі версії (9)Згорнути
Перед оновленням на цю версію запишіть налаштування або замініть файли через FTP без деінсталяції: наступні оновлення вже зберігатимуть їх.
Суми в CRM більше не їдуть у базовій валюті магазину.
Окрема збірка під OpenCart 2.3.0.0–2.3.0.2 і PHP 5.6–7.x: класи без неймспейсів, шаблони Bootstrap 3, подія addOrderHistory через extension/event.
Подія замовлення реєструється як order*addHistory — на OpenCart 4.0.2.x роздільник методу інший, і з крапкою модуль не спрацьовував зовсім.
Виправлено «тихий» тригер на OpenCart 4.0.2.x: подія додавання історії замовлення не спрацьовувала через роздільник методу.
Перший публічний реліз: відправка замовлень OpenCart 4.x у OneBox OS через API v2 (POST /order/set/ з токен-авторизацією), upsert за externalid + унікальний журнал синхронізації, мапінг…
Разом з OneBox Sync купують


Nova Poshta Premium — модуль Нова Пошта для OpenCart 2.3, 3.x і 4.x

Telegram-сповіщення і Viber/SMS покупцям для OpenCart

Multi PRRO Connector — фіскалізація чеків для OpenCart 2.3, 3.x & 4.x
Повний опис модуля
OneBox Sync для OpenCart — модуль, який зв’язує магазин на OpenCart 2.3, 3.x або 4.x із OneBox OS: кожне нове замовлення автоматично стає процесом-замовленням у CRM разом із клієнтом, телефоном, адресою доставки та товарами. Замість ручного перенесення даних менеджер одразу бачить заявку в OneBox і працює з нею за вашим бізнес-процесом.
Як це працює — крок за кроком
- Покупець оформлює замовлення — модуль реагує на подію додавання історії замовлення, не втручаючись у checkout.
- Модуль авторизується у вашому OneBox: отримує токен через POST
/api/v2/token/get/і надсилає замовлення через POST/api/v2/order/set/. - Товари прив’язуються до каталогу OneBox: назва, артикул (SKU/модель), кількість і ціна — каталожні продукти знаходяться або створюються автоматично, без дублів у каталозі. Доставка передається окремим рядком, тому сума процесу сходиться із сумою замовлення.
- OneBox повертає ID процесу — він фіксується в журналі синхронізації; додатково передається externalid, тож повторне спрацювання не створить другий процес.
- Невдалі відправки повторює cron-ретрай — замовлення, які не пішли з першої спроби, доїжджають у CRM автоматично.
Що додає Pro
- Статуси в обидва боки. Змінили статус замовлення в магазині — процес в OneBox переходить у статус, вибраний у таблиці відповідностей. Менеджер змінив статус процесу в OneBox — модуль бачить це під час регулярної перевірки процесів і змінює статус замовлення. Змінюються лише замовлення, які надіслав модуль, і статус не повертається назад по колу.
- UTM-мітки. Модуль запамʼятовує utm_source, utm_medium, utm_campaign, utm_content, utm_term і сторінку входу відвідувача (30 днів) — вони потрапляють у блок UTM процесу OneBox, і в CRM видно, яка реклама приносить продажі.
- Власні поля. Колонка замовлення, додаткове поле акаунта чи адреси (custom_field) або стале значення — у додаткове поле процесу OneBox за його ключем.
- Старі замовлення. Оберіть період і статуси — модуль надішле в OneBox усі замовлення, яких там ще немає, по 10 за крок, із лічильником на сторінці. Кнопка «Повторити всі невдалі» дошле все, що не дійшло.
- Листи про збої. Якщо замовлення не дійшло до OneBox після всіх автоматичних спроб, на вашу адресу приходить лист із причиною (не більше 20 на добу).
Pro вмикається ключем у блоці «Ліцензія Pro» вгорі налаштувань модуля. Там же запускається 7-денний пробний період: безкоштовно, без картки. Pro працює в усіх трьох збірках: OpenCart 4.x, 3.x і 2.3.
Що під капотом
- Події OpenCart — модуль підписується на додавання історії замовлення (
addHistoryв OpenCart 4,addOrderHistoryв 3.x і 2.3); файли ядра і теми не модифікуються. - Ідемпотентність: upsert за externalid на боці OneBox плюс унікальний журнал синхронізації в БД магазину — ні дубльованих процесів, ні дубльованих товарів у каталозі.
- Мапінг товарів, оплати й доставки у поля процесу OneBox; необов’язкова маршрутизація workflowid/statusid/sourceid (порожньо = перший бізнес-процес автоматично).
- Cron-черга повторів для замовлень, які не вдалося відправити з першого разу: підбираються і невдалі відправки, і ті, що зависли в стані «в процесі» понад годину (наприклад, якщо PHP обірвався посеред запиту).
- Cron-токен — публічний URL повторів можна закрити спільним секретом:
...&token=<значення>. Штатний планувальник OpenCart 4 працює й без токена, порожнє поле лишає ендпоінт відкритим. - API-пароль зберігається в БД у зашифрованому вигляді, а журнал синхронізації містить запит і відповідь API для діагностики.
Як встановити
- У OneBox встановіть компонент «API v2» (1b.app → Додатки → API-сервіси) і задайте співробітнику логін та пароль (Користувачі і співробітники → Логін, пароль, права доступу).
- Завантажте
cc_onebox.ocmod.zipчерез Розширення → Інсталятор в адмінці OpenCart. Для OpenCart 3.0.2–3.0.5 беріть окрему збірку — cc_onebox-oc3.ocmod.zip (після встановлення оновіть модифікації: Розширення → Модифікації → кнопка «Оновити»). - Для OpenCart 2.3.0.0–2.3.0.2 беріть збірку cc_onebox-oc2.ocmod.zip. ⚠️ Штатний інсталятор 2.3 копіює файли лише по FTP: якщо FTP не налаштовано, розпакуйте архів і залийте вміст теки
upload/у корінь магазину, далі Розширення → Модулі → OneBox Sync → «Встановити». - У Розширення → Модулі знайдіть OneBox Sync, натисніть «Встановити» й відкрийте налаштування.
- Вкажіть домен вашого OneBox, API-логін і API-пароль, натисніть «Перевірити з’єднання».
- За потреби заповніть ID бізнес-процесу, етапу і джерела (можна лишити порожніми — модуль візьме перший бізнес-процес) та збережіть.
- Оформіть тестове замовлення і перевірте процес у OneBox та рядок у журналі.
- В OpenCart 3.x і 2.3 планувальника немає — рядок повторів додається в crontab хостингу вручну (типово раз на 15 хвилин):
curl -s "https:/(у 3.x роут —/ SHOP/ index.php?route=extension/ module/ cc_ onebox_ cron/ retry&token=ТОКЕН" extension/; готовий URL показано в налаштуваннях модуля)module/ cc_ onebox/ cronRetry
Pro. У блоці «Ліцензія Pro» вгорі налаштувань модуля введіть ключ із листа після покупки або запустіть пробний період. Під час оновлення модуля налаштування й ліцензія зберігаються.
Питання
про модуль
Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.
Звідки взяти API-доступи OneBox?
З картки співробітника в застосунку «Користувачі та співробітники» вашого OneBox: логін співробітника і REST API пароль. Модуль сам обмінює їх на токен через /api/v2/token/get/.
Чи змінює модуль checkout або тему?
Ні. Модуль працює через події OpenCart на сервері — сторінка оформлення і шаблони залишаються як були, і після видалення модуля нічого відновлювати не треба.
Чи можуть задублюватися процеси або товари в OneBox?
Ні. Модуль передає externalid (OneBox оновлює знайдений процес замість створення нового) і веде унікальний журнал синхронізації; товари каталогу знаходяться за артикулом, а не створюються щоразу.
Що буде, якщо OneBox недоступний у момент замовлення?
Відправка потрапить у чергу повторів — cron-ретрай автоматично доправить замовлення, коли OneBox знову відповідатиме. Кількість спроб і помилки видно в журналі.
Куди в OneBox потрапляють замовлення?
У бізнес-процес, який ви вкажете в налаштуваннях (workflowid + statusid + sourceid). Якщо поля порожні — модуль автоматично використовує перший бізнес-процес вашого OneBox.
Що буде після видалення модуля?
Процеси в OneBox і замовлення в магазині залишаться недоторканими — модуль лише читає замовлення і веде власний журнал синхронізації.
Чим Pro відрізняється від безкоштовної версії?
Безкоштовна версія передає замовлення в OneBox. Pro для OpenCart 4.x, 3.x і 2.3 додає статуси в обидва боки, UTM-мітки, власні поля, відправку старих замовлень, «Повторити всі невдалі» й листи про збої.
Як спробувати Pro?
У блоці «Ліцензія Pro» вгорі налаштувань модуля введіть e-mail і натисніть «Почати пробний період». Pro вмикається одразу на 7 днів, без картки.
Ліцензія Pro діє рік?
Ні, ліцензія для OpenCart назавжди: одна оплата, без щорічних платежів.
Поки що жодного відгуку. Будьте першим.
Поки питань немає. Запитай — ми відповімо протягом 24 годин.
Не той варіант, що шукаєте?
Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—

















