МойСклад: Обмен контрагентами по API

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

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

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

• Пользователи 1С-Битрикс и контрагенты МойСклад — в обе стороны: создание и обновление.

• Все стандартные поля пользователя и контрагента с гибким сопоставлением «поле ↔ поле».

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

• Группы: группы пользователя Битрикс ↔ группы контрагента МойСклад.

• Тип контрагента (юрлицо, ИП, физлицо) ↔ группа пользователя на сайте.

• Персональная и накопительная скидка контрагента — в группу пользователя, которую дальше можно использовать в типах цен.

• Профиль покупателя интернет-магазина — создаётся и обновляется по данным контрагента (только из МойСклад в Битрикс).

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

Обмен идёт по событиям. Создали или изменили контрагента в МойСкладе — учётная система присылает веб-хук, модуль находит пользователя на сайте и создаёт или обновляет его. Зарегистрировался или изменился пользователь на сайте — модуль ищет контрагента в МойСкладе и создаёт или обновляет его.

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

Каждая операция пишется в журнал модуля: успешные импорты, экспорты и ошибки, с подробностями по клику на запись.

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

• Поиск с приоритетом. Пользователь и контрагент ищутся по выбранным полям — Email, телефон, внешний код, ИНН, пользовательские поля — в заданном порядке. Например, сначала по внешнему коду, потом по Email. Так обмен находит существующую запись, а не плодит дубли.

• Отдельные правила импорта и экспорта. Создавать ли новые записи, обновлять ли существующие, какие поля переносить в каждую сторону.

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

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

• Исключения из обмена по группам пользователей и по ID — например, чтобы не трогать старых пользователей.

• Обработка неполных данных. Генерация Email на вашем домене, если у контрагента его нет; разбор наименования контрагента на фамилию, имя и отчество; шаблон для поля «Обращение» и имени нового контрагента; объединение полей ОГРН/ОГРНИП и ОКПО у ИП и юрлиц.

• Генерация внешнего кода для новых пользователей, у которых он пустой.

Для доработок под свой проект есть события модуля: перед созданием и обновлением пользователя доступен объект импортируемого контрагента.

Безопасность данных пользователей

Модуль работает с персональными данными, поэтому в нём есть жёсткие ограничения:

• Администраторы защищены. Пользователей группы с ID = 1 модуль не создаёт и не изменяет ни при каких условиях; эта группа всегда исключена из обмена.

• Пароли не трогаются. Пароль генерируется только при создании нового пользователя, нигде не сохраняется и не показывается.

• Активность не меняется. Новый пользователь создаётся активным, дальше модуль на это поле не влияет.

• Защищённые группы. Группы, отмеченные как не участвующие в обмене, остаются у пользователя при любом обновлении.

Требования

• 1С-Битрикс: Управление сайтом, начиная с редакции «Старт». Импорт профиля покупателя — с редакции «Малый бизнес» (нужен модуль «Интернет-магазин»).

• Платный тариф МойСклад — для веб-хуков и дополнительных полей.

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

• Агенты 1С-Битрикс на cron — для массового импорта контрагентов.

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

• Не удаляет пользователей на сайте и контрагентов в МойСкладе.

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

• Не меняет пароли и активность пользователей.

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

• Не передаёт профиль покупателя из Битрикс в МойСклад: этот обмен только в одну сторону.

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