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

Контакты и компании Битрикс24 → контрагенты МойСклад: юрлица, ИП и физлица

Задача​

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

Что получится​

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

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

Что нужно заранее​

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

Шаги​

1. Общие настройки контрагентов​

Откройте Контрагенты → Общие настройки.

Вкладка «Общее». Включите Включить независимый обмен контрагентами, если карточки клиентов должны обмениваться и без сделок. Здесь же — Обмен ответственных — компания и Обмен ответственных — контакт (соответствия сотрудников задаются в Справочниках).

Общие настройки контрагентов: вкладка «Общее»

Вкладка «Поиск». Отдельно для компаний и для контактов:

  1. Компания участвует в обмене / Контакт участвует в обмене — выключите, если одна из сущностей вам не нужна.
  2. Тип по умолчанию — компания / Тип по умолчанию — контакт — каким типом контрагента МойСклад станет запись, если её тип в Битрикс24 не указан. Обычно для компании — Юридическое лицо, для контакта — Физическое лицо.
  3. Поля поиска — компания / Поля поиска — контакт — по ним модуль ищет уже существующего контрагента. Самое надёжное — нажать Управление полем для поиска: модуль создаст в карточке поле «Идентификатор МС» и сам добавит его в поиск. Вручную подойдут пары Идентификатор элемента во внешнем источнике ↔ Внешний код, Email (первый) ↔ Email, Телефон (первый) ↔ Телефон.
  4. Хотя бы у одной строки включите Сохранять соответствия — без этого обмен не запустится, а следующий обмен создавал бы дубль.

Поиск контрагента для компаний и контактов

Искать по ИНН из реквизитов Битрикс24 нельзя

В списке полей Битрикс24 для поиска реквизитов нет: доступны идентификаторы, «Телефон (первый)», «Email (первый)» и строковые пользовательские поля. ИНН МойСклад можно сделать полем поиска, только если ИНН у вас дополнительно хранится в строковом пользовательском поле компании.

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

2. Настройте каждый тип контрагента​

В меню Контрагенты у каждого типа своя страница: Юридическое лицо, ИП, Физическое лицо. На каждой — вкладки Соответствие типов и Поля.

Юридическое лицо: соответствие типов

На вкладке Соответствие типов:

  1. Тип клиента в Битрикс24 — какая сущность Битрикс24 соответствует этому типу: Компания или Контакт. Каждый тип привязан ровно к одной сущности; ею же модуль создаёт запись, когда контрагент приходит из МойСклад. После выбора сохраните страницу — набор настроек ниже зависит от выбора.

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

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

  3. Шаблон реквизитов Битрикс24 — какой реквизит модуль заполняет. Пусто — реквизиты для этого типа не обмениваются.

На вкладке Поля в Соответствия полей свяжите поля карточки и реквизитов с полями контрагента. Что обычно связывают — во вкладках:

  • Тип клиента в Битрикс24 — Компания.
  • Шаблон реквизитов Битрикс24 — «Организация».
  • Поля: Название ↔ Наименование, Реквизиты: ИНН ↔ ИНН, Реквизиты: КПП ↔ КПП, Реквизиты: ОГРН ↔ ОГРН, Реквизиты: полное наименование ↔ Полное наименование, Телефон (первый) ↔ Телефон, Email (первый) ↔ Email, адрес — например, Юридический адрес (Населенный пункт) ↔ [Юридический адрес] Город.

Сохраните каждую страницу кнопкой Сохранить.

Тип меняется только у «точно своего» контрагента

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

Как проверить​

  1. Создайте в Битрикс24 компанию, заполните реквизиты по шаблону «Организация» и выберите в поле типа «Юридическое лицо». Если включён независимый обмен — просто сохраните; если нет — создайте с этой компанией сделку.
  2. В Обзор работы модуля → Очередь обмена появится задача Экспорт с типом Компания (или Сделка) и завершится состоянием Выполнена.
  3. В МойСклад откройте Контрагенты: там новый контрагент-юрлицо с ИНН, КПП и наименованием из реквизитов.
  4. Сохраните компанию ещё раз — новый контрагент не появится, обновится существующий.
  5. Поменяйте телефон контрагента в МойСклад — изменение вернётся в карточку компании (задача Импорт).

Если не работает​

  • Задача выполнена, контрагента нет. Сработала проверка готовности: «Тип контрагента не сопоставлен с объектом CRM» (на странице типа выбрана другая сущность в Тип клиента в Битрикс24), «Не выбрано поле типа контрагента», «Не заданы поля поиска» или не включено сохранение полей поиска. Причина — в подробностях задачи и логах.
  • Контакты не уходят вовсе. Ни на одной странице типа Тип клиента в Битрикс24 не стоит Контакт — см. шаг 2.
  • Компания ушла не тем типом. В карточке не заполнено поле типа — сработал Тип по умолчанию. Заполните поле или сделайте его обязательным в CRM.
  • Появляются дубли. Ни одно поле поиска не связывает записи надёжно. Добавьте «Идентификатор МС» через Управление полем для поиска и поставьте его первым в списке (порядок меняется перетаскиванием).
  • Нет реквизитов. Не выбран Шаблон реквизитов Битрикс24 на странице типа или поля реквизитов не добавлены в Соответствия полей.

Подробнее​