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

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

• Подвійна дедуплікація: externalid wc-{id} дає upsert на боці OneBox, а збережений ID процесу в меті замовлення блокує повторне створення з боку плагіна.
• 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. Завантажте onebox-sync-for-woocommerce-1.0.0.zip через Плагіни → Додати новий → Завантажити плагін і активуйте.
3. Відкрийте WooCommerce → OneBox Sync та вкажіть домен вашого OneBox, API-логін і API-пароль.
4. Натисніть «Перевірити з’єднання» — плагін отримає токен і список бізнес-процесів.
5. За потреби вкажіть ID бізнес-процесу, етапу і джерела (порожні поля = перший бізнес-процес автоматично) та збережіть.
6. Зробіть тестове замовлення — у OneBox з’явиться процес-замовлення.

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

1.0.0 — липень 2026

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