OneBox Sync — CRM для OpenCart 3.x & 4.x

OneBox Sync для OpenCart 4 — модуль, який зв’язує магазин на OpenCart 4.x із OneBox OS: кожне нове замовлення автоматично стає процесом-замовленням у CRM разом із клієнтом, телефоном, адресою доставки та товарами. Замість ручного перенесення даних менеджер одразу бачить заявку в OneBox і працює з нею за вашим бізнес-процесом.

Модуль повністю безкоштовний, код відкритий. Репозиторій на GitHub: github.com/catcodestudio/opencart-onebox-sync. Без ключів, підписок і лімітів на замовлення.

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

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

1. Покупець оформлює замовлення — модуль реагує на подію додавання історії замовлення, не втручаючись у checkout.
2. Модуль авторизується у вашому OneBox: отримує токен через POST /api/v2/token/get/ і надсилає замовлення через POST /api/v2/order/set/.
3. Товари прив’язуються до каталогу OneBox: назва, артикул (SKU/модель), кількість і ціна — каталожні продукти знаходяться або створюються автоматично, без дублів у каталозі. Доставка передається окремим рядком, тому сума процесу сходиться із сумою замовлення.
4. OneBox повертає ID процесу — він фіксується в журналі синхронізації; додатково передається externalid, тож повторне спрацювання не створить другий процес.
5. Невдалі відправки повторює cron-ретрай — замовлення, які не пішли з першої спроби, доїжджають у CRM автоматично.

Скільки коштує

Безкоштовно. Код модуля відкритий — завантажуйте з GitHub і користуйтеся без обмежень. Платної версії не існує.

Технічні вимоги

• OpenCart 4.0.2 – 4.1.x
• PHP 8.0+
• OneBox OS з компонентом «API v2» (1b.app → Додатки → API-сервіси) та логіном/паролем співробітника для REST API

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

• Події OpenCart 4 — модуль підписується на додавання історії замовлення; файли ядра і теми не модифікуються.
• Ідемпотентність: upsert за externalid на боці OneBox плюс унікальний журнал синхронізації в БД магазину — ні дубльованих процесів, ні дубльованих товарів у каталозі.
• Мапінг товарів, оплати й доставки у поля процесу OneBox; необов’язкова маршрутизація workflowid/statusid/sourceid (порожньо = перший бізнес-процес автоматично).
• Cron-черга повторів для замовлень, які не вдалося відправити з першого разу.
• API-пароль зберігається в БД у зашифрованому вигляді, а журнал синхронізації містить запит і відповідь API для діагностики.

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

1. У OneBox встановіть компонент «API v2» (1b.app → Додатки → API-сервіси) і задайте співробітнику логін та пароль (Користувачі і співробітники → Логін, пароль, права доступу).
2. Завантажте cc_onebox.ocmod.zip через Розширення → Інсталятор в адмінці OpenCart.
3. У Розширення → Модулі знайдіть OneBox Sync, натисніть «Встановити» й відкрийте налаштування.
4. Вкажіть домен вашого OneBox, API-логін і API-пароль, натисніть «Перевірити з’єднання».
5. За потреби заповніть ID бізнес-процесу, етапу і джерела (можна лишити порожніми — модуль візьме перший бізнес-процес) та збережіть.
6. Оформіть тестове замовлення і перевірте процес у OneBox та рядок у журналі.

Історія версій

1.0.0 — липень 2026

Перший публічний реліз: відправка замовлень OpenCart 4.x у OneBox OS через API v2 (POST /order/set/ з токен-авторизацією), upsert за externalid + унікальний журнал синхронізації, мапінг товарів/оплати/доставки, маршрутизація workflowid/statusid/sourceid, cron-черга повторів, шифрування API-пароля, перевірка з’єднання.