Битрикс24 и WooCommerce: сделки по заказам магазина
Кратко: В этой связке магазин создаёт заказ, а Битрикс24 ведёт по нему сделку и возвращает статус.
- Задача: видеть заказы в CRM, а не в двух несвязанных списках, и не терять оплату между системами.
- Что проверено: вебхуки и REST API WooCommerce, подпись вебхука, методы
crm.deal.addиcrm.deal.update, состав товарных позиций сделки, лимит запросов портала. - Уровень: documented; стенда с реальными порталами и магазинами не было.
- Что не проверено: соответствие ваших стадий воронки и кастомных статусов заказа.
Когда нужна интеграция
Заголовок раздела «Когда нужна интеграция»Интеграция уместна, когда менеджер работает со сделкой, а не с заказом: видит историю клиента, ставит задачи, отправляет счёт и фиксирует договор. Второй сценарий — когда маркетинг считает выручку по воронке CRM.
Когда она не нужна:
- Заказы обрабатываются только в админке магазина — CRM добавит дублирование, а не пользу.
- Нужен учёт товаров и документов — это задача учётной системы, см. WooCommerce и МойСклад и WooCommerce и 1С.
- Нужны только заявки и формы — это WordPress и Битрикс24, без заказов и позиций.
Сценарии
Заголовок раздела «Сценарии»Новый заказ → сделка с позициями
Заголовок раздела «Новый заказ → сделка с позициями»- Событие: покупатель оформляет заказ, WooCommerce отправляет вебхук
order.created. - Направление: WooCommerce → Битрикс24.
- Сущности: заказ, сделка, контакт, товарные позиции, сумма, способ доставки.
- Результат: сделка создаётся на первой стадии с позициями и суммой; номер заказа сохранён в поле сделки, поэтому повторная доставка вебхука не создаёт вторую сделку.
Оплата заказа → стадия «Оплачен»
Заголовок раздела «Оплата заказа → стадия «Оплачен»»- Событие: платёжная система подтверждает оплату, заказ переходит в
processing. - Направление: WooCommerce → Битрикс24.
- Сущности: заказ, платёж, стадия сделки, комментарий.
- Результат: сделка переходит в стадию, по которой менеджер начинает сборку и отгрузку; в комментарии остаются идентификатор платежа и способ оплаты.
Стадия сделки → статус заказа
Заголовок раздела «Стадия сделки → статус заказа»- Событие: менеджер переводит сделку в «Отгружено» или «Отказ».
- Направление: Битрикс24 → WooCommerce.
- Сущности: сделка, стадия, заказ, статус.
- Результат: заказ получает
completedилиcancelledи письмо покупателю. Правило сопоставления стадий задаётся явно: не каждая стадия воронки меняет статус заказа.
Триггеры и действия
Заголовок раздела «Триггеры и действия»| Событие в WooCommerce | Действие в Битрикс24 | Примечание |
|---|---|---|
order.created |
crm.deal.add + контакт + позиции |
Позиции добавляются после создания сделки |
order.updated |
crm.deal.update |
Только при значимых изменениях: сумма, состав, адрес |
Переход в processing |
crm.deal.update (стадия «Оплачен») |
Стадия должна существовать в воронке |
Переход в cancelled |
crm.deal.update (стадия «Отказ») |
Причина отмены — в комментарий |
customer.created |
crm.contact.add |
Дедупликация по телефону и email |
| Событие в Битрикс24 | Действие в WooCommerce | Примечание |
|---|---|---|
| Сделка перешла в «Отгружено» | PUT /wc/v3/orders/<id> со статусом completed |
Требует прав write у ключа API |
| Сделка перешла в «Отказ» | Статус cancelled + комментарий |
Письмо покупателю отправляет магазин |
| Добавлена задача менеджеру | Ничего | Не синхронизируется: задачи живут в CRM |
Вебхук WooCommerce подписан: заголовок X-WC-Webhook-Signature содержит base64 от HMAC-SHA256 тела
запроса с секретом вебхука. Подпись проверяется до разбора JSON — иначе endpoint принимает подделку и
создаёт сделки от чужого имени.
Варианты реализации
Заголовок раздела «Варианты реализации»- Плагин-коннектор — готовые решения закрывают заказы и статусы, но набор поддерживаемых полей и версий у них разный. Критерий: документированный маппинг стадий и активные обновления.
- iPaaS — сценарий «вебхук → фильтр → сделка» собирается без кода. Ограничение: правила и секреты вне репозитория, отладка в чужом интерфейсе, плата за операции.
- Custom-интеграция — MU-плагин на стороне магазина и небольшой сервис-приёмник: проверка подписи,
идемпотентность по
order_id, журнал и повторные попытки. Основной вариант, если стадий и правил больше двух. - Обмен через учётную систему — сделка создаётся не из магазина, а из учёта. Уместно, когда CRM вторична и работает от данных 1С или МойСклад.
Данные и соответствие полей
Заголовок раздела «Данные и соответствие полей»| Объект WooCommerce | Объект Битрикс24 | Ключ соответствия | Примечание |
|---|---|---|---|
Заказ (id, number) |
Сделка (ID) |
order_id в пользовательском поле |
Ключ идемпотентности |
Покупатель (billing) |
Контакт | Телефон, email | Дедупликация до создания |
| Позиции заказа | Товарные позиции сделки | sku или product_id |
Товары каталога CRM должны существовать |
| Сумма заказа | OPPORTUNITY |
— | Валюта сделки должна совпадать |
| Статус заказа | Стадия сделки | Таблица соответствия | Обратное направление только по явным правилам |
| Способ доставки | Пользовательское поле | — | Коды служб доставки различаются |
Владелец данных: WooCommerce владеет заказом, составом корзины и статусом оплаты; CRM владеет сделкой, ответственным и историей коммуникаций. Сумма и состав дублируются, поэтому нужна сверка: при расхождении источником правды считается заказ магазина.
Перед запуском
Заголовок раздела «Перед запуском»- Создать вебхуки
order.created,order.updated,customer.createdи сохранить секрет. - Завести ключ REST API с правами на чтение заказов и запись статусов.
- Согласовать таблицу «статус заказа ↔ стадия сделки» и зафиксировать её в коде.
- Создать пользовательские поля сделки под номер заказа и способ доставки.
- Проверить сопоставление товаров: SKU магазина и каталог CRM.
- Прогнать на staging: новый заказ, оплата, отмена, повторный вебхук, недоступный портал.
Ограничения и надёжность
Заголовок раздела «Ограничения и надёжность»- Статусы — расширяемые. Плагины добавляют собственные
wc-*статусы; интеграция должна игнорировать неизвестные, а не падать. - Вебхук не гарантирует доставку. Нужна ежедневная сверка: заказы за период без сделки — очередь на повтор.
- Товарные позиции отдельным вызовом. Сбой между созданием сделки и добавлением позиций оставляет сделку без состава; нужен повтор и проверка суммы.
- Лимит портала. Массовые всплески (распродажа) упираются в ограничение запросов; ставится очередь с ограничением параллелизма.
- Возвраты и частичные отмены. Возврат в WooCommerce — не то же самое, что отказ сделки; для корректного учёта возврат передаётся отдельным событием с суммой.
- Персональные данные. Адрес и телефон покупателя уходят в CRM на основании согласия; поля, ненужные для сделки, не передаются.
Вопросы и ответы
Заголовок раздела «Вопросы и ответы»Можно ли синхронизировать только новые заказы? Да, но нужен фильтр по дате и разовая сверка за период, иначе заказы, созданные до запуска, останутся без сделок.
Что делать с заказами, оформленными гостем? Создавать контакт по телефону или email с пометкой «гость»; дедупликация обязательна, иначе один покупатель превратится в десяток контактов.
Кто должен менять статус заказа? Магазин — по факту оплаты; CRM — по факту отгрузки. Если обе системы пишут статус без правил, начинаются «качели»: фиксируйте владельца каждого перехода.
Нужно ли передавать каждое изменение заказа? Нет: передаются значимые изменения — состав, сумма, адрес, оплата. Иначе лимит запросов расходуется на правки комментариев.