Настройка формы заказа в Битрикс24

Форма заказа в интернет-магазине на «1С-Битрикс: Управление сайтом» и CRM «Битрикс24» — это две разные системы, которые связывают через модуль интеграции. Магазин собирает заказ, а CRM получает по нему сделку, контакт и компанию. Чтобы данные не терялись, свойства заказа на сайте должны быть аккуратно сопоставлены с полями сущностей Битрикс24. Разберём, как это устроено и что настраивать.

Как связаны магазин и Битрикс24

Важно не путать два продукта. Форма заказа живёт в интернет-магазине на «1С-Битрикс: Управление сайтом» (BUS) — её выводит компонент bitrix:sale.order.ajax в публичной части сайта. Битрикс24 — отдельная CRM-система (облачная или коробочная), куда заказ попадает уже как сделка с привязанными контактом и, при необходимости, компанией.

Связку обеспечивает модуль интеграции с CRM. В BUS за это отвечает модуль sale совместно с настройками раздела Магазин → CRM Битрикс24 в административной панели. Обмен идёт по одному из двух сценариев:

• Онлайн-режим (REST/вебхук) — заказ уходит в облачный или коробочный Битрикс24 сразу после оформления;
• Односторонний экспорт — периодическая выгрузка накопленных заказов в CRM.

Настройка полей формы заказа на сайте

Прежде чем данные попадут в CRM, их нужно собрать на сайте. Поля формы заказа — это свойства заказа (order properties), которые настраиваются в разделе Магазин → Настройка заказов → Свойства заказа. Каждое свойство привязано к типу плательщика (Физическое / Юридическое лицо) и имеет свой тип данных.

Базовый набор полей для передачи в Битрикс24 обычно включает:

• Ф.И.О. — тип «Строка», системный код FIO;
• Телефон — тип «Строка» с маской, код PHONE;
• E-mail — код EMAIL;
• Адрес доставки — «Строка» или «Местоположение»;
• Реквизиты компании (ИНН, КПП, название) — для юрлиц.

Для корректной работы связки у ключевых свойств должен быть выставлен тип свойства в поле TYPE: EMAIL, PHONE, ADDRESS или NAME. Именно по этому признаку модуль CRM понимает, какое свойство куда мапить.

Подключение магазина к CRM Битрикс24

Связка настраивается мастером в разделе Магазин → CRM Битрикс24 → Настройки. Порядок действий:

1. В облачном Битрикс24 создайте входящий вебхук с правами на CRM (crm) — вы получите URL вида https://ваш-портал.bitrix24.ru/rest/1/токен/;
2. В админке магазина укажите этот адрес в мастере подключения к CRM;
3. Выберите режим синхронизации — только экспорт заказов или двусторонний обмен (заказы в CRM, статусы обратно на сайт);
4. Настройте ответственного за создаваемые сделки и воронку (направление сделок);
5. Сохраните и запустите пробную выгрузку.

Соответствие свойств заказа полям сделки

Ключевой этап — маппинг: сопоставление свойств заказа сайта с полями сущностей CRM. Мастер интеграции предлагает таблицу соответствия, где для каждого свойства заказа выбирается поле сделки, контакта или компании.

Состав заказа (товары) передаётся в товарные позиции сделки. Если на сайте есть нестандартные свойства (например, «Желаемое время доставки»), под них создают пользовательские поля сделки в Битрикс24 (раздел CRM → Настройки → Пользовательские поля) и указывают их в маппинге.

Проверка и типичные ошибки

После настройки оформите тестовый заказ и проверьте, что в CRM появилась сделка с корректными данными. Частые проблемы и их причины:

• Не создаётся контакт — у свойств телефона/почты не задан тип PHONE/EMAIL, CRM не распознаёт их;
• Дубли контактов — отключён поиск по совпадениям; включите правила дедупликации в Битрикс24;
• Пустые товарные позиции — товары не выгрузились из-за отсутствия привязки каталога или ошибок цены;
• Заказы не уходят вовсе — истёк или отозван токен вебхука, либо превышены лимиты REST.

Журнал обмена и ошибки удобно смотреть в разделе Магазин → CRM Битрикс24 → Журнал. Для отладки REST-запросов в коробке помогает лог модуля rest.

Когда нужны доработки и события

Штатного маппинга хватает для простых магазинов. Но при сложной логике подключают обработчики событий модуля sale. Например, событие OnSaleOrderSaved позволяет дописать данные в сделку через REST-метод crm.deal.add или crm.deal.update.

Типичные сценарии кастомной интеграции:

• Заполнение специфических пользовательских полей сделки по бизнес-правилам;
• Выбор воронки и стадии сделки в зависимости от типа заказа или суммы;
• Назначение ответственного менеджера по региону или категории товара;
• Обратная синхронизация статуса: смена стадии сделки в CRM меняет статус заказа на сайте.

Такую логику реализуют в файле /local/php_interface/init.php или в отдельном модуле, обращаясь к CRM через REST (входящий вебхук) либо напрямую через API в коробочной версии.

Итог

Форма заказа магазина на «1С-Битрикс: Управление сайтом» и CRM «Битрикс24» — связка из двух систем, где качество данных определяется настройкой свойств заказа и их маппингом на поля сделки, контакта и компании. Ключевые условия: правильные типы свойств (PHONE, EMAIL), рабочий вебхук с правами crm и аккуратно сопоставленные пользовательские поля. Для нетривиальной логики применяют события модуля sale и REST-методы CRM.

Мы настраиваем такие интеграции под ключ: связываем магазин с Битрикс24, проектируем структуру полей, пишем обработчики событий и следим, чтобы заказы доходили до CRM без потерь и дублей. Если нужен предсказуемый обмен заказами между сайтом и CRM — поможем спроектировать и внедрить.