KeyCRM Sync — CRM для WooCommerce

KeyCRM Sync для WooCommerce — плагин, который автоматически передаёт каждый заказ WooCommerce в KeyCRM: с покупателем, товарами, доставкой и оплатой. Отправка срабатывает сразу после оформления (классический checkout и Checkout Blocks) или при переходе заказа в выбранный вами статус. Менеджеры работают в CRM, а не переключаются между админкой магазина и табличками — и никакого ручного переноса заказов.

Плагин опубликован в официальном каталоге WordPress.org — устанавливается прямо из админки: wordpress.org/plugins/catcode-order-sync-with-keycrm-for-woocommerce.

Плагин полностью бесплатный. Код открыт на GitHub: github.com/catcodestudio/wp-keycrm-sync. Без ограничения по количеству заказов, без ежемесячных списаний и без привязки к сторонним сервисам — нужен только API-ключ из вашего кабинета KeyCRM.

Что получает админ

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

1. Покупатель оформляет заказ в вашем магазине — через классический checkout или Checkout Blocks.
2. Плагин собирает payload: покупатель, товары, доставка, оплата. Телефон нормализуется в формат +380, нулевые позиции пропускаются.
3. Отправка в KeyCRM через POST /order — сразу после оформления или когда заказ переходит в выбранный вами статус (например «В обработке»).
4. KeyCRM возвращает ID заказа — он сохраняется в мете _catcode_keycrm_order_id, поэтому дубликатов не будет даже при повторных срабатываниях.
5. Если CRM недоступна — плагин сам повторит попытку через 5 мин / 30 мин / 2 ч по WP-Cron, без настройки крона на хостинге.
6. Менеджер видит результат в метабоксе заказа и в журнале событий.

Сколько стоит

Бесплатно, код открытый. Скачать можно с GitHub или кнопкой на этой странице. Никаких платных тарифов, триалов или лимитов на количество заказов.

Технические требования

• WordPress 6.2+
• WooCommerce 6.0+
• PHP 7.4+
• API-ключ KeyCRM — кабинет KeyCRM → Настройки → API

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

• Дедупликация на двух уровнях: плагин передаёт source_uuid = wc-{id} и сохраняет KeyCRM ID в мете заказа — дубликаты не создаются ни на стороне плагина, ни на стороне CRM.
• API-ключ зашифрован в БД — libsodium с HMAC-фолбеком; в открытом виде ключ не хранится.
• Совместимость с HPOS (High-Performance Order Storage) — работа с заказами исключительно через WC_Order CRUD.
• Передача статуса оплаты: оплаченный заказ создаётся в CRM сразу с платёжной записью «оплачено» (опционально).
• Хуки для разработчиков: фильтр catcode_keycrm_order_payload (модификация данных перед отправкой) и экшен catcode_keycrm_order_sent (сторонние интеграции).

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

1. В админке: Плагины → Добавить новый → найдите «CatCode Order Sync with KeyCRM» и нажмите «Установить». Или загрузите catcode-order-sync-with-keycrm-for-woocommerce-0.1.6.zip вручную.
2. Активируйте плагин в списке плагинов.
3. Перейдите в WooCommerce → KeyCRM Sync и вставьте API-ключ из кабинета KeyCRM.
4. Нажмите «Проверить подключение» — убедитесь, что связь с CRM работает.
5. Выберите триггер отправки (сразу после оформления или конкретные статусы) и сохраните настройки.

История версий

0.1.6 — 13 августа 2026

Починена кнопка «Отправить повторно» в метабоксе заказа — она не работала ни дня: метабокс печатал собственную форму внутри формы заказа WooCommerce, а браузер вложенную форму выбрасывает, поэтому клик сабмитил форму заказа и в CRM ничего не уходило. Теперь это обычная ссылка с нонсом. Ручная отправка берёт ту же блокировку в БД, что и автоматическая, — два менеджера, нажавшие кнопку одновременно, больше не создадут в KeyCRM два заказа. Переводы убраны из сборки на WordPress.org (они идут с translate.wordpress.org), в zip на этой странице украинская локализация остаётся.

0.1.5 — 12 августа 2026

Обновление с версий до 0.1.1 больше не «теряет» магазин: при переименовании плагина настройки, API-ключ, журнал и метки «заказ уже в KeyCRM» оставались под старыми именами. Из-за этого каждый старый заказ выглядел неотправленным — следующая смена статуса толкала его в CRM ещё раз, KeyCRM отвечала ошибкой на повторный source_uuid, и заказ помечался как «Ошибка отправки», хотя на самом деле давно был в CRM. Теперь всё это переносится автоматически, а ложный статус ошибки снимается. Защита от двойной отправки стала атомарной (блокировка в БД вместо транзиента). Заказы без способа оплаты или совсем без контактов покупателя больше не отклоняются CRM с ошибкой 422. Удаление плагина убирает и старую таблицу журнала. Минимальная версия WooCommerce снижена до 6.0.

0.1.4 — 6 августа 2026

Описание и ключевые слова в каталоге WordPress.org — на украинском.

0.1.3 — 20 июля 2026

Исходные строки кода переведены на английский (требование каталога WordPress.org), добавлен полный встроенный украинский перевод — украиноязычный интерфейс остался без изменений.

0.1.2 — 20 июля 2026

Публикация в официальном каталоге WordPress.org. Плагин переименован в «CatCode Order Sync with KeyCRM for WooCommerce», унифицированы префиксы, инлайн-стили вынесены в enqueue, в readme добавлен раздел о внешних сервисах.

0.1.0 — июль 2026

Первый публичный релиз: экспорт заказов в KeyCRM (checkout и статусы-триггеры), дедупликация через source_uuid, ретраи 5 мин / 30 мин / 2 ч, метабокс в заказе с повторной отправкой, журнал событий, проверка подключения, шифрование API-ключа, совместимость с HPOS и Checkout Blocks.