SalesDrive Sync — CRM для WooCommerce

SalesDrive Sync для WooCommerce — плагин, который автоматически передаёт каждый заказ WooCommerce в CRM SalesDrive. Как только покупатель завершил checkout, в SalesDrive появляется заявка с покупателем, товарами, доставкой и комментарием — менеджер работает в CRM, а не копирует данные из админки сайта вручную. Поддерживаются и классический чекаут, и новые Checkout Blocks.

Плагин полностью бесплатный. Скачать: catcode-order-sync-with-salesdrive-for-woocommerce-0.2.0.zip. Лицензия GPLv2 — без ключей, без пробных периодов, без ограничений по количеству заказов.

Как это работает — шаг за шагом

1. Покупатель оформляет заказ в магазине — через классический чекаут или Checkout Blocks.
2. Плагин собирает payload: покупатель (телефон нормализуется до формата +380), товары с SKU, ценой и количеством, доставка, комментарий. Для оплаченных онлайн заказов в комментарий опционально добавляется пометка «Оплачено онлайн».
3. Данные летят в SalesDrive через обработчик заявок — POST /handler/ с заголовком X-Api-Key.
4. SalesDrive возвращает номер заявки — он сохраняется в мете заказа (_cc_salesdrive_order_id). Вместе с локом на уровне БД это гарантирует: один заказ — одна заявка.
5. Если CRM временно недоступна — плагин сам повторяет отправку: 3 попытки с паузами 5 мин / 30 мин / 2 ч по WP-Cron.
6. Менеджер видит результат в метабоксе заказа и во вкладке «Журнал» на странице настроек.

Что под капотом

• API-ключ зашифрован в БД — libsodium с HMAC-фолбеком для хостингов без расширения sodium. В открытом виде ключ в базе не лежит.
• Лок на уровне БД против дубля: чекаут, смена статуса и колбэк платёжки могут прилететь одновременно — в работу проходит ровно один запрос, а заказ перечитывается мимо кеша HPOS перед финальной проверкой.
• Проверка по externalId после таймаута: обработчик заявок SalesDrive НЕ дедуплицирует (два POST с тем же externalId дают две заявки), поэтому перед повторной попыткой плагин спрашивает CRM через GET /api/order/list/, есть ли заявка, и подхватывает её ID. Если у ключа нет права на чтение — заказ помечается в метабоксе, чтобы менеджер проверил CRM вручную.
• HPOS-совместимость — вся работа с заказами идёт только через WC_Order CRUD, без прямых запросов к постам.
• Нормализация телефона покупателя до E.164 (+380…) перед отправкой в CRM.
• Валюта: у обработчика заявок нет поля валюты, поэтому для заказов не в гривне код валюты дописывается в комментарий заявки.
• Точки расширения для разработчиков: фильтр cc_salesdrive_order_payload (изменить тело заявки) и хук cc_salesdrive_order_sent (реакция на успешную отправку).

Как установить

1. Скачайте catcode-order-sync-with-salesdrive-for-woocommerce-0.2.0.zip и установите через Плагины → Добавить новый → Загрузить плагин.
2. Активируйте в меню «Плагины».
3. Откройте WooCommerce → SalesDrive Sync, введите домен кабинета и API-ключ.
4. Нажмите «Проверить соединение» — убедитесь, что CRM отвечает.
5. Выберите, когда отправлять заказы (сразу после checkout или при переходе в выбранные статусы), сохраните настройки.