Проверить связь контакта и компании в обе стороны

Робот «Проверить связь контакта и компании в обе стороны» проверяет конкретную пару карточек и показывает расхождение между двумя доступными списками связей.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую задачу решает

Администратору CRM, который проверяет связь конкретного контакта с компанией перед переносом или дальнейшим выбором ответственного лица.

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

Параметры и подготовка

Поле	Как заполнить
ID компании (COMPANY_ID)	Обязательное поле
ID контакта (CONTACT_ID)	Обязательное поле

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

Как использовать

1. Укажите COMPANY_ID и CONTACT_ID как два положительных ID нужных карточек. Получите их из полей связи CRM или предыдущего шага поиска.
2. Проверьте доступ пользователя интеграции к обеим карточкам. Недоступность нельзя считать отсутствием связи.
3. После выполнения посмотрите state. related означает наличие в обоих списках, absent согласованное отсутствие, inconsistent одностороннее наличие.
4. Стройте дальнейшее действие по related и consistent. При расхождении предусмотрите повторную проверку фактических связей, потому что чтения выполняются не одновременно.

Учебный пример и ожидаемый результат

Для учебных компании 51 и контакта 72 оба списка содержат эту пару: related включён, consistent включён. Если контакт указан только у компании, companySide включён, contactSide выключен, state=inconsistent. Если пара отсутствует с обеих сторон, state=absent и consistent включён при отрицательном related.

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

• «Связь подтверждена с двух сторон» (related).
• «Списки согласованы для пары» (consistent).
• «Контакт в списке компании» (companySide).
• «Компания в списке контакта» (contactSide).
• «Основной контакт компании» (primaryContact).
• «Основная компания контакта» (primaryCompany).
• «Состояние проверки» (state).

companySide и contactSide показывают результат каждой стороны. primaryContact и primaryCompany независимы: различие этих признаков само по себе не доказывает повреждение связи. Проверяйте общие related/consistent отдельно от основного статуса.

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Принимает COMPANY_ID и CONTACT_ID. Сначала проверяет доступ к обеим карточкам, затем читает оба списка связей. Возвращает related, consistent, state, companySide, contactSide, primaryContact и primaryCompany. related=Y только при наличии пары в обоих списках; отсутствие в обоих: consistent=Y/state=absent. Одностороннее наличие: consistent=N/state=inconsistent. Основной контакт компании и основная компания контакта: независимые признаки, их равенство не требуется. До 1000 связей на сторону. Не меняет связи; чтения не атомарны, расхождение может требовать повторной проверки.

Робот ничего не исправляет и не удаляет. Для изменения связи требуется отдельное согласованное действие. До 1000 связей на каждую сторону; при параллельной правке CRM расхождение может быть временным. Не объявляйте его окончательным результатом без сверки.