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

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

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

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 хв. Сплачені онлайн замовлення отримують у коментарі процесу позначку «✅ Оплачено онлайн» (COD і офлайн-методи не позначаються).

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

• Подвійна дедуплікація: 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 з’явиться процес-замовлення.