OneBox Sync — синхронізація замовлень для WooCommerce

OneBox Sync для WooCommerce — плагін, який після кожного checkout автоматично створює у OneBox OS процес-замовлення з клієнтом, телефоном, адресою доставки та списком товарів. Менеджер відкриває готову заявку в CRM замість того, щоб переносити дані із замовлення WooCommerce руками — і жоден ордер не губиться між сайтом і OneBox.

Плагін повністю безкоштовний, код відкритий. Завантажити можна з GitHub: github.com/catcodestudio/wp-onebox-sync. Без платних версій, ключів і обмежень.

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

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

1. Покупець оформлює замовлення — плагін підтримує і класичний чекаут, і Checkout Blocks.
2. Плагін авторизується в OneBox: отримує токен через POST /api/v2/token/get/ (токен кешується й оновлюється автоматично) і надсилає замовлення через POST /api/v2/order/set/ на домен вашого OneBox.
3. Клієнт і товари мапляться на CRM: clientname/clientemail/clientphone/clientaddress плюс масив products із прив’язкою до каталогу OneBox — каталожні товари знаходяться за артикулом (SKU) або створюються автоматично. Доставка — окремим рядком, тож сума процесу сходиться з сумою замовлення.
4. OneBox повертає ID процесу — він зберігається у меті _cc_onebox_order_id; додатково передається externalid wc-{id}, тому дублі виключені подвійно.
5. Якщо OneBox недоступний — WP-Cron повторює відправку: 3 спроби з паузами 5 хв / 30 хв / 2 год. Сплачені онлайн замовлення отримують у коментарі процесу позначку «✅ Оплачено онлайн» (COD і офлайн-методи не позначаються).

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

Безкоштовно. Плагін розповсюджується під GPLv2 з відкритим кодом на GitHub — усі функції доступні без оплати одразу після встановлення.

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

• WordPress 6.2+ (тестовано до 7.0)
• WooCommerce 6.0 або новіше
• PHP 7.4+
• OneBox OS з компонентом «API v2» (1b.app → Додатки → API-сервіси) та REST API логіном/паролем співробітника (Користувачі і співробітники → картка співробітника)

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

• Подвійна дедуплікація: externalid wc-{id} дає upsert на боці OneBox, а збережений ID процесу в меті замовлення блокує повторне створення з боку плагіна.
• Лок на рівні БД — якщо хук чекауту, зміна статусу і колбек платіжки прилітають на одне замовлення одночасно, у OneBox піде рівно один запит на створення (перевірено 24 паралельними запитами на 3 замовлення).
• Спроба без відповіді не дублює угоду — якщо OneBox не відповів (таймаут), замовлення позначається, а перед повтором плагін питає CRM за externalid (POST /order/get/) і підхоплює вже створений процес.
• API-пароль зашифрований у БД — libsodium з HMAC-фолбеком; токен доступу кешується і поновлюється автоматично.
• Нормалізація телефону до E.164 (+380…) — номери в CRM приходять в єдиному форматі.
• HPOS-сумісність (custom order tables) — робота із замовленнями виключно через WC_Order CRUD.
• Розширюваність: фільтр cc_onebox_order_payload дозволяє змінити дані перед відправкою, хук cc_onebox_order_sent — виконати свій код після успішної синхронізації.

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

1. Встановіть у OneBox компонент «API v2» (1b.app → Додатки → API-сервіси) і задайте співробітнику логін та пароль у картці (Користувачі і співробітники → Логін, пароль, права доступу).
2. Завантажте catcode-order-sync-with-onebox-for-woocommerce-0.2.0.zip через Плагіни → Додати новий → Завантажити плагін і активуйте.
3. Відкрийте WooCommerce → OneBox Sync та вкажіть домен вашого OneBox, API-логін і API-пароль.
4. Натисніть «Перевірити з’єднання» — плагін отримає токен і список бізнес-процесів.
5. За потреби вкажіть ID бізнес-процесу, етапу і джерела (порожні поля = перший бізнес-процес автоматично) та збережіть.
6. Зробіть тестове замовлення — у OneBox з’явиться процес-замовлення.

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

0.2.0 — 13 серпня 2026

Полагоджена кнопка «Відправити повторно» в метабоксі: форма метабокса була вкладена у форму замовлення, і браузер її викидав — тепер це нонсифіковане посилання, а результат показується адмін-нотисом. Паралельні запити на одне замовлення більше не можуть відправити його двічі — лок на рівні БД плюс перечитування замовлення повз кеш HPOS. Спроба, яка не отримала відповіді, перед повтором шукає процес у OneBox за externalid. Видалення плагіна тепер прибирає таблицю журналу, налаштування й залишкові локи. Інтерфейс переведено на англійську з українським перекладом, стилі підключаються як окремий хендл. Плагін перейменовано на catcode-order-sync-with-onebox-for-woocommerce (налаштування, мета замовлень і таблиця не змінилися — міграція не потрібна).

0.1.0 — липень 2026

Перший публічний реліз: відправка замовлень у OneBox OS через API v2 (token/get + order/set), подвійна дедуплікація (externalid + мета), прив’язка товарів до каталогу, маршрутизація за бізнес-процесом/етапом/джерелом, ретраї через WP-Cron, метабокс, журнал, перевірка з’єднання, шифрування API-пароля.