Изменение реквизита

Активити (робот) "Изменение реквизита" предназначено для использования в роботах и может быть полезно в следующих сценариях:

Обновление данных существующего реквизита (ИНН, КПП, наименование, адрес и др.) после изменения в карточке контакта или компании;
Синхронизация реквизитов с внешними системами (1С): подстановка актуальных полей по коду или ID реквизита;
Исправление ошибочно введённых реквизитов по результатам проверки или после получения данных по ИНН;
Изменение названия, активности или сортировки реквизита для отображения в карточке CRM;
Массовое обновление реквизитов в цикле по списку ID реквизитов из поиска;
Заполнение пустых полей реквизита данными из другого шага бизнес-процесса;
Обновление контактных данных (телефон, e-mail, ФИО руководителя) в реквизите;
Приведение реквизитов к единому формату после импорта или переноса данных;
Обновление реквизита после смены юридического адреса или реорганизации компании;
Установка или снятие активности реквизита в зависимости от условий процесса.

Как работает активити (робот):
- Активити (робот) обновляет существующий реквизит через метод REST API Битрикс24 crm.requisite.update;
- Обязателен только параметр ID реквизита; остальные поля передаются по необходимости — в запрос попадают только заполненные пользователем поля;
- Тип сущности, тип пресета и ID сущности (контакт/компания) при изменении реквизита не задаются — реквизит остаётся привязанным к той же сущности;
- Список доступных полей формируется при установке активити (робота) из метода crm.requisite.fields и зависит от настроек портала;
- При успешном выполнении изменения применяются в CRM; активити (робот) не возвращает отдельные возвращаемые параметры.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID реквизита	Обязательный параметр. Идентификатор реквизита, который нужно изменить. Примеры: - {=Variable:REQUISITE_ID} — ID из переменной (например, из результата активити «Добавление реквизита»); - {=A1988_22222_92566_99999:id_requisite} — ID реквизита из возвращаемого параметра активити (робота) «Добавление реквизита»; - {=Iterator:Value} — для массового обновления реквизитов в цикле по списку ID; - {=Document:ID} — если ID реквизита совпадает с полем документа.
Остальные поля реквизита	Набор полей для обновления (название, ИНН, КПП, полное и сокращённое наименование, ФИО руководителя, должность, адрес, телефон, e-mail, код, внешний код, активность, сортировка и др.) формируется при установке активити (робота) из crm.requisite.fields. Заполняйте только те поля, которые нужно изменить; пустые поля не передаются и не перезаписывают существующие значения. Поля «Тип пресета», «Тип сущности» и «ID сущности» в активити (роботе) не отображаются — привязка реквизита к контакту или компании не меняется.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется выбирать сотрудника с правами администратора. При недостаточных правах активити (робот) может завершиться с ошибкой.
Устанавливать текст статуса	Позволяет включать установку статуса бизнес-процесса для отображения в истории, на каком шаге остановился процесс. Удобно при отладке.
Текст статуса	Текстовый статус, отображаемый в истории бизнес-процесса при включённом параметре «Устанавливать текст статуса».
Ожидать ответа	Параметр не управляется пользователем; определяет, нужно ли ожидать ответа от активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Ограничение времени ожидания ответа (в секундах, минутах, часах, днях). Рекомендуется не менее 5 минут и не более 1 часа. При истечении времени бизнес-процесс продолжит выполнение по заданной логике.

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

Описание примера	Решение
Обновить ИНН и наименование реквизита после проверки по ИНН	ID реквизита — {=Variable:REQUISITE_ID}. Заполните поля ИНН и полное наименование организации значениями из переменных (например, из результата запроса по ИНН). Остальные поля оставьте пустыми.
Изменить реквизит, только что созданный активити «Добавление реквизита»	ID реквизита — {=A1988_22222_92566_99999:id_requisite} (подставьте код вашего активити «Добавление реквизита»). В следующих полях укажите недостающие данные: телефон, e-mail, КПП и т.д.
Обновить контактные данные в реквизите компании	ID реквизита — {=Variable:REQUISITE_ID}. Заполните поля E-Mail, Телефон, Контактное лицо (и при необходимости ФИО первого руководителя, Должность первого руководителя).
Переименовать реквизит и изменить порядок отображения	ID реквизита — {=Variable:REQUISITE_ID}. В поле NAME (Название) укажите новое название, в поле «Сортировка» — число для порядка (например 200). Остальные поля не заполняйте.
Синхронизация с 1С: обновить код и внешний код реквизита	ID реквизита — из переменной, полученной при поиске реквизитов или из предыдущего шага. Заполните поле «Код» и «Внешний код» (или XML_ID) значениями из интеграции. При необходимости обновите ИНН, наименование.
Массовое обновление реквизитов по списку ID	В цикле по итератору: ID реквизита — {=Iterator:Value}. В остальных полях укажите общие данные для обновления (например, новое значение одного поля) или используйте переменные, зависящие от итератора.
Деактивировать реквизит по условию	ID реквизита — {=Variable:REQUISITE_ID}. В поле «Активен» выберите N (или 0). Используйте после условия «если реквизит устарел» или «если компания сменила реквизиты».
Заполнить пустые поля реквизита данными из карточки сделки	ID реквизита — из переменной (например, из поиска реквизитов компании сделки). Заполните поля из полей документа: например, телефон — {=Document:PHONE}, e-mail — {=Document:EMAIL}.
Обновить юридический адрес и ИФНС в реквизите	ID реквизита — {=Variable:REQUISITE_ID}. Заполните поля, соответствующие адресу и ИФНС (названия полей зависят от пресета и настроек портала). Остальные поля не указывайте.
Привести наименование и КПП к формату после импорта	ID реквизита — {=Iterator:Value} в цикле по списку ID реквизитов. В полях «Полное наименование организации», «Сокращённое наименование», КПП укажите значения из переменных, сформированных выражениями (например, с помощью функций trim, substr).

Возвращаемые параметры данного активити (робота):

Активити (робот) выполняет обновление реквизита в CRM и не возвращает отдельные возвращаемые параметры. При успешном выполнении изменения применяются к реквизиту с указанным ID. Для получения обновлённых данных используйте активити (робот) «Получение данных по сущности: реквизит» с тем же ID реквизита.

Важно! Ограничения и рекомендации:

Обязательный параметр:
Для выполнения активити (робота) обязательно указать ID реквизита. Реквизит с указанным ID должен существовать в CRM. Если реквизит не найден или ID не указан, вызов метода crm.requisite.update может завершиться ошибкой.

Какие поля можно менять:
Через активити (робот) нельзя изменить тип пресета, тип сущности и ID сущности — реквизит остаётся привязанным к тому же контакту или компании. Доступные для изменения поля (название, ИНН, КПП, наименования, контакты и др.) формируются при установке активити (робота) из crm.requisite.fields.

Частичное обновление:
В запрос передаются только заполненные в настройках активити (робота) поля. Пустые поля не отправляются и не затирают существующие значения в реквизите. Чтобы изменить только часть полей, заполните в активити (роботе) только эти поля.

Права доступа:
Сотрудник, указанный в поле «Запускать от имени», должен иметь права на изменение реквизитов в CRM. Рекомендуется использовать сотрудника с правами администратора.

Источник ID реквизита:
ID реквизита можно получить из активити (робота) «Добавление реквизита» (возвращаемый параметр id_requisite), из активити (робота) «Поиск реквизитов» или «Получение данных по сущности: реквизит», а также из переменных, заполненных на предыдущих шагах бизнес-процесса.

Ваша корзина пуста

Изменение реквизита