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 появится процесс-заказ.