Контрагенты — общие настройки обмена контактами и компаниями

Страница Контрагенты → Общие настройки задаёт правила, общие для всех типов контрагентов: включать ли обмен клиентской базой, как искать клиента без дублей, что делать с группами и статусами. Поля конкретного типа — юрлица, ИП, физлица — настраиваются на отдельных страницах, см. Типы контрагентов.

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

Клиент заказа обменивается всегда

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

Общее

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

Варианты направления: Не обменивать, В обе стороны, Только в МойСклад, Только в Битрикс24.

Поиск

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

Вкладка состоит из двух одинаковых блоков: для компаний и для контактов.

Настройка	Что делает	По умолчанию	Когда менять
Компания участвует в обмене / Контакт участвует в обмене	Выключено — компании (контакты) Битрикс24 вообще не обмениваются с контрагентами, даже в составе сделки.	Включено	Выключайте, только если такая сущность у вас никогда не бывает клиентом заказа. Например, компании в CRM есть, но продаёте только физлицам. Тогда в настройках заказа поставьте Тип клиента по умолчанию = Контакт.
Тип по умолчанию — компания	Тип контрагента МойСклад, который получит контрагент, созданный из компании: Юридическое лицо, Физическое лицо или Индивидуальный предприниматель. От него же зависит список полей МойСклад в таблице поиска ниже.	Юридическое лицо	Если среди компаний в CRM в основном ИП — выберите Индивидуальный предприниматель.
Тип по умолчанию — контакт	То же для контактов.	Физическое лицо	Редко.
Поля поиска — компания / Поля поиска — контакт	Пары полей, по которым модуль ищет двойника. Подробно — ниже.	Пусто	Обязательно задайте при первой настройке.

Тип по умолчанию должен «смотреть» на ту же сущность

Каждый тип контрагента привязан ровно к одной сущности Битрикс24 настройкой Тип клиента в Битрикс24 на своей странице (Типы контрагентов). Тип по умолчанию — контакт работает, только если выбранный тип привязан к контактам.

Из коробки значения согласованы: Физическое лицо привязано к контактам и назначено им по умолчанию, Юридическое лицо — к компаниям. Меняя тип по умолчанию или привязку типа, следите, чтобы они указывали на одну сущность.

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

Поля поиска

Колонки таблицы: Поле компании Битрикс24 (или Поле контакта Битрикс24), Поле контрагента МойСклад и переключатель Сохранять соответствия — сохранять связку в поле контакта / компании. Строк до пяти. Порядок — приоритет поиска сверху вниз, меняется перетаскиванием.

Какие поля можно выбрать:

• в Битрикс24 — «Идентификатор элемента во внешнем источнике», «Телефон (первый)», «Email (первый)» и строковые пользовательские поля;
• в МойСклад — UUID, Код, Внешний код, Наименование, Телефон, Email, Номер дисконтной карты, а для юрлиц и ИП ещё ИНН и другие реквизиты. Список зависит от Типа по умолчанию.

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

Почему важен порядок и выбор полей. Представьте: в CRM компания «Ромашка» без телефона, а в МойСклад уже есть контрагент «ООО Ромашка», заведённый бухгалтерией. Ищете только по названию — опечатка или «ООО» в начале даст второго контрагента. Ищете по e-mail — найдётся, если почта заполнена в обеих системах. Надёжнее всего — связка по идентификатору, которую модуль ведёт сам.

Рекомендуемая схема:

Порядок	Поле Битрикс24	Поле МойСклад	Сохранять	Зачем
1	Идентификатор элемента во внешнем источнике	Внешний код	Да	Постоянная связь записей, которую ведёт модуль.
2	Email (первый)	Email	Да	Находит клиентов, заведённых в МойСклад до подключения модуля.
3	Телефон (первый)	Телефон	Да	Запасной вариант, если почты нет.

ИНН

Реквизиты компании в Битрикс24 («Реквизиты: ИНН») в поиск не попадают — искать можно только по строковым полям самой карточки. Если вы храните ИНН ещё и в строковом пользовательском поле компании, сопоставьте его с полем ИНН контрагента МойСклад. Для юрлиц это самая надёжная защита от дублей: название пишут по-разному, а ИНН у организации один.

Тип найденного контрагента модуль меняет, только если нашёл его по UUID или внешнему коду. Если контрагент найден по имени, телефону, e-mail или реквизитам, его тип в МойСклад не трогается, а в Логи пишется предупреждение.

Кнопки рядом с таблицей:

• Проверить поиск — прогоняет поиск на реальных контрагентах МойСклад выбранного типа. Показывает, найдёт ли модуль пары в Битрикс24 и по какому полю. Ничего не меняет. Перед проверкой сохраните настройки. Как читать результат — в описании заказа покупателя.
• Управление полем для поиска — создаёт в компаниях (контактах) строковое поле «Идентификатор МС» и добавляет строку «Идентификатор МС ↔ UUID» с сохранением соответствий. Пригодится, если «Идентификатор элемента во внешнем источнике» уже занят другой интеграцией.

Подробнее о логике поиска — в разделе Как модуль находит пару.

Обмен группой

Группы (теги) контрагента МойСклад — например, «опт», «VIP», «дилер» — можно переносить в Битрикс24 и обратно. В CRM они хранятся в множественном поле-списке компании или контакта.

Настройка	Что делает	По умолчанию	Когда менять
Пользовательское поле для хранения групп компании	Множественное поле-список компании, в котором хранятся группы. Значения списка синхронизируются с группами МойСклад.	Не выбрано	Выберите или создайте, если группы нужны в CRM.
Направление обмена группами — компания	Куда переносить группы. Варианты: Не обменивать, В обе стороны, Только в МойСклад, Только в Битрикс24.	В обе стороны	Только в Битрикс24, если группы назначает только МойСклад.
Пользовательское поле для хранения групп контакта	То же для контактов.	Не выбрано
Направление обмена группами — контакт	То же для контактов.	В обе стороны

Поле удобно создать кнопкой Управление полем групп. Шаг Поле в Битрикс24 создаёт множественное поле-список «Группы МойСклад» (кнопка Создать поле). Шаг Значения списка заполняет его группами, которые уже есть у контрагентов МойСклад.

Пример. Менеджер ставит компании в CRM группу «VIP» — контрагент в МойСклад получает группу «VIP», и склад видит, кого отгружать в первую очередь.

Если группы вам не нужны, поле не выбирайте: обмен группами — необязательная часть, проверка готовности его не требует.

Обмен статусами

У контрагента МойСклад есть статус («Новый», «Переговоры», «Сделка заключена» и т. п.). В Битрикс24 у компаний и контактов такого статуса нет, поэтому он хранится в пользовательском поле-списке. Модуль переносит статус по таблице соответствий. Кнопка Как передается статус контрагента? открывает короткий иллюстрированный гайд.

Настройка	Что делает	По умолчанию
Пользовательское поле для хранения статуса компании	Поле-список компании, в котором хранится статус. Кнопка Создать поле создаёт поле-список «Статус МойСклад».	Не выбрано
Соответствия статусов (компания)	Пары Статус компании Битрикс24 ↔ Статус контрагента МойСклад с Направлением обмена (по умолчанию В обе стороны).	Пусто
Пользовательское поле для хранения статуса контакта	То же для контактов.	Не выбрано
Соответствия статусов (контакт)	То же для контактов.	Пусто

Порядок настройки:

1. Выберите поле или нажмите Создать поле.
2. Нажмите Синхронизировать статусы у таблицы соответствий. Помощник проверит, что поле статуса выбрано, и заполнит его список статусами контрагентов из МойСклад. Синхронизировать снова досоздаёт статусы, которые появились в МойСклад позже.
3. Сопоставьте статусы в таблице и сохраните настройки.

Пример. Отдел продаж ведёт статус клиента в МойСклад, а менеджерам в CRM он нужен только для информации. Для контактов поставьте всем парам Только в Битрикс24. Статус в CRM будет повторять МойСклад, но не сможет изменить его в ответ.

Статусы одинаковы для всех типов контрагентов. Это свойство самой сущности «контрагент» в МойСклад, поэтому они настраиваются здесь, а не на страницах типов.

Что дальше

• Типы контрагентов — физлица, ИП и юрлица: привязка типа, реквизиты, поля.
• Рецепт Контакты и компании → контрагенты.