Перейти к содержимому

Битрикс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 — по факту отгрузки. Если обе системы пишут статус без правил, начинаются «качели»: фиксируйте владельца каждого перехода.

Нужно ли передавать каждое изменение заказа? Нет: передаются значимые изменения — состав, сумма, адрес, оплата. Иначе лимит запросов расходуется на правки комментариев.