МойСклад: Интеграция с Битрикс24

Модуль связывает CRM Битрикс24 и складской учёт МойСклад в один рабочий контур. Менеджер ведёт сделку в привычной CRM — в МойСкладе сам появляется заказ покупателя или заказ поставщику: с клиентом, составом товаров, ценами, скидками и ставками НДС. Кладовщик или бухгалтер меняет документ в учёте — изменение возвращается в карточку сделки. Никаких файлов обмена, кнопок «выгрузить» и переписывания строк руками.

Обмен двусторонний и разбирается на части: каждый контур, каждое направление и каждое поле включаются отдельно. Поэтому интеграцию не обязательно вводить целиком — можно начать с выгрузки сделок, потом добавить состав заказа, клиентскую базу, справочники и приём изменений обратно.

Что синхронизируется

• Сделки и заказы покупателя МойСклад — в обе стороны.

• Сделки и заказы поставщику МойСклад — отдельный контур со своими настройками.

• Контакты и компании Битрикс24 и контрагенты МойСклад — включая юрлиц, ИП и физлиц.

• Реквизиты клиента: ИНН, КПП, ОГРН, юридическое название, адреса, телефон, почта, сайт.

• Состав заказа: товарные строки сделки и позиции документа — товар, количество, цена, скидка, ставка НДС.

• Номенклатура: товары, услуги, комплекты и модификации (торговые предложения) с картинками и характеристиками.

• Стадии сделки и статусы документа, статусы контрагента.

• Ответственный менеджер и валюта документа.

• Теги (группы) контрагента и произвольные пользовательские поля обеих систем.

• Справочники: сотрудники, валюты, единицы измерения, ставки НДС.

Как это выглядит в работе

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

В обратную сторону работает так же: МойСклад присылает уведомление об изменении документа или контрагента, модуль кладёт его в очередь и обновляет карточку в Битрикс24. Опроса API по расписанию нет — значит, нет ни задержки в полчаса, ни лишней нагрузки на лимиты учётной системы.

При повторном обмене модуль сравнивает собранные данные с текущими и отправляет только изменившиеся поля. Если не изменилось ничего — запроса на запись не будет вовсе. Состав заказа сравнивается построчно: совпавшие позиции не трогаются, обновляются только те, что реально поменялись.

Настройка без программиста

Всё настраивается в интерфейсе модуля, списками и таблицами соответствий, а не правкой кода:

• Сопоставление полей. Любое поле сделки, контакта или компании связывается с любым полем документа или контрагента МойСклад — стандартным, пользовательским или дополнительным (атрибутом). У каждой пары своё направление: в МойСклад, в Битрикс24 или в обе стороны.

• Значения по умолчанию. Организация, счёт, склад, канал продаж — то, что постоянно и не хранится в CRM, задаётся правилом, а не отдельным полем в Битрикс24.

• Поля поиска связанной записи. Связь ведётся по тому полю, которое уже сложилось в ваших данных: внешнему коду, ИНН, номеру договора.

• Фильтры обмена. Условия на поля решают, какие сделки уезжают в учёт и какие документы принимаются обратно.

• Справочники соответствий. Сотрудники, валюты, единицы измерения и ставки НДС сопоставляются явной таблицей — видно, что с чем связано и почему значение не перенеслось.

• Создание полей CRM. Служебные поля, которые нужны интеграции (признак типа документа, тип контрагента, статус, теги), модуль заводит сам из своих настроек — ходить в конструктор полей Битрикс24 не нужно.

• Помощник настройки каталога. Инфоблоки, разделы, группы товаров МойСклад и поля связи выбираются из подставленных списков, а не вводятся идентификаторами.

Все настройки живут внутри профиля обмена, поэтому у разных профилей соответствия, фильтры и поля свои и не мешают друг другу.

Надёжность: очередь, проверки и разбор ошибок

Интеграция с внешним сервисом ломается предсказуемо: сервис недоступен, API ограничил частоту запросов, поле заполнено не так. Модуль рассчитан именно на это.

• Очередь обмена. Задачи копятся в отдельной линии на каждый профиль и обрабатываются пакетами. Повторные правки одной сделки склеиваются в одну задачу: десять изменений подряд не превращаются в десять обращений к МойСкладу. Сбой не теряется — задача повторяется с нарастающей паузой.

• Проверка готовности настроек. Перед каждым обменом модуль смотрит, достаточно ли настроек, чтобы запись нашлась и связалась. Недонастроенный контур обмен не запускает — вместо того чтобы плодить дубли. Состояние по обоим видам документов, трём типам контрагента и четырём справочникам видно на дашборде.

• Защита от дублей. Перед созданием записи модуль ищет её пару на другой стороне и обновляет найденную. Если поиск не выполнился из-за сбоя, обмен прерывается и повторяется позже: создавать запись вслепую после ошибки нельзя, это гарантированный дубль.

• Защита от зацикливания. Записи, которые модуль делает сам, не запускают встречный обмен: ни события CRM, ни уведомления МойСклад на них не срабатывают.

• Страница очереди. Видно каждую задачу: направление, документ, статус, число попыток, полный текст ошибки. Задачу можно выполнить принудительно или удалить, не дожидаясь расписания. Рядом — карточка агента: активен ли, когда следующий запуск, кнопки переустановить и прогнать проход вручную.

Товары и каталог

Товарная часть — самое трудоёмкое место любой интеграции, и здесь она разобрана подробно.

Товар ищется по выбранному вами полю связи: внешнему коду (XML_ID) или конкретному свойству инфоблока, а на стороне МойСклад — по внешнему коду или внутреннему идентификатору. Если XML_ID уже занят выгрузкой из 1С или интернет-магазина, связь настраивается на своё свойство, не ломая существующие интеграции. После создания товара код связи дозаписывается обратно, чтобы следующий обмен нашёл товар, а не создал второй.

Если товара во второй системе ещё нет, модуль создаёт его сам: переносит название, описание, единицу измерения, картинки и характеристики. Связанные сущности разворачиваются каскадом — у модификации сначала создаётся родительский товар, у комплекта сначала компоненты. Свойства торговых предложений (цвет, размер, объём) сопоставляются с характеристиками модификаций МойСклад — списки, привязки к элементам инфоблока и справочники highload-блоков.

Благодаря этому обмен заказами можно запустить, не выгружая заранее весь каталог: номенклатура наполняется по мере появления реальных заказов и остаётся связанной с обеих сторон.

Требования

• Битрикс24 в коробочной версии с модулем CRM.

• Модули «Торговый каталог» и «Информационные блоки» — для обмена составом заказа и номенклатурой.

• Учётная запись МойСклад: подключение по токену доступа или по логину и паролю. Права в учётной системе определяются той записью, под которой выпущен токен.

• Планировщик агентов Битрикс24 (cron) — для очереди обмена.

• Публично доступный адрес на сайте портала — для уведомлений МойСклад.

Что модуль не делает

Честный список, чтобы не было сюрпризов при внедрении:

• Не синхронизирует остатки и прайс-листы.

• Не переносит удаление записей ни в одну сторону.

• Не обменивает лиды.

• Не синхронизирует изменение картинок товара после его создания.

• Не разрешает конфликты правок: если одно и то же поле поменяли с обеих сторон, победит та сторона, чей обмен выполнился последним.

• Не догадывается о соответствиях сотрудников, валют, единиц и ставок НДС — они сопоставляются вручную, зато предсказуемо.

С чего начать

1. Подключить МойСклад: токен или логин с паролем.

2. Создать служебные поля CRM прямо из настроек модуля.

3. Включить нужный контур — заказы покупателя или заказы поставщику — и задать поля поиска связанной записи.

4. Сопоставить поля обмена и, если нужно, стадии со статусами.

5. Проверить состояние настроек на дашборде: там видно, что готово, а что осталось донастроить.

6. Включить состав товаров, клиентскую базу и приём уведомлений из МойСклад, когда основной контур заработал.