Робот «Задать признак «Моя компания» у компании» робот помогает автоматически выставлять у компании признак «Моя компания» по ID и выбранному значению Y или N.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору CRM, который управляет признаком собственной организации для работы с документами и сторонами сделки.
Обычная компания клиента и собственная компания имеют разный смысл в CRM. Робот позволяет явно установить или снять IS_MY_COMPANY у конкретной записи без ручного открытия её карточки.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ID компании (companyId) |
Обязательное поле |
IS_MY_COMPANY (Y/N) (isMyCompany) |
Обязательное поле. Y (Y); N (N) |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Получите ID компании, которую действительно нужно обозначить своей. Не выбирайте клиентскую карточку только из-за совпадения названия.
- В поле IS_MY_COMPANY укажите Y для своей компании либо N для снятия признака. Другие значения не допускаются.
- Разместите действие только в процессе с согласованным правом менять этот признак. У пользователя интеграции должны быть права на изменение компании.
- После выполнения проверьте статус, companyId и применённое значение isMyCompany. При ошибке сверяйте карточку до повторной попытки.
Учебный пример и ожидаемый результат
В учебной CRM компания 51 представляет собственную организацию. Укажите companyId=51 и isMyCompany=Y. При подтверждённом изменении ожидаются тот же ID, применённое Y и положительный статус. Для снятия признака используйте отдельное согласованное действие со значением N.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «ID компании» (
companyId). - «Примененное значение» (
isMyCompany).
Возвращённое применённое значение удобно использовать в последующей проверке. Оно не содержит реквизиты и не делает компанию автоматически выбранным продавцом во всех сделках. Для выбора продавца и его реквизитов нужны отдельные действия.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Текст ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Обязательны положительный companyId и значение Y/N. Регистр и пробелы признака нормализуются. При успешном подтверждении возвращаются ID и применённое значение. При отказе изменения статус отрицательный и заполнено пояснение.
Робот не создаёт компанию, не исправляет её ИНН и не проверяет юридическую принадлежность организации. Изменение признака влияет на смысл записи для последующих процессов, поэтому ID должен быть получен из надёжного источника.