Добавление реквизита

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

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

Как работает активити (робот):
- Реквизит привязывается к сущности CRM: контакт (ENTITY_TYPE_ID=3) или компания (ENTITY_TYPE_ID=4);
- Тип набора полей задаётся пресетом (шаблоном реквизитов). Список пресетов формируется при установке активити (робота) на портале;
- Передаются только заполненные пользователем поля; обязательными являются тип пресета, тип сущности, ID сущности и название реквизита;
- Перед добавлением выполняется проверка существования указанной сущности (контакт или компания);
- При успешном создании возвращается идентификатор нового реквизита (id_requisite).

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

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

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

Описание примера	Решение
Добавить основные реквизиты компании после создания компании	Тип пресета — «Юридическое лицо», Тип сущности — Компания (4), ENTITY_ID — {=Variable:NEW_COMPANY_ID}, Название — «Основные реквизиты». При необходимости заполните ИНН, КПП, полное наименование и другие поля. В возвращаемом параметре id_requisite получите ID созданного реквизита.
Создать реквизит контакту из поля документа	Тип пресета — «Физическое лицо», Тип сущности — Контакт (3), ENTITY_ID — {=Document:ID}, Название — «Реквизиты для договора». Активити (робот) создаст реквизит для контакта с ID из документа.
Добавить реквизиты с ИНН и наименованием для подготовки счёта	Тип пресета — «ИП» или «Юридическое лицо», Тип сущности — 4, ENTITY_ID — {=Document:COMPANY_ID}, Название — «Реквизиты», заполните поля ИНН, КПП, полное наименование организации. После сохранения реквизиты подставятся в документы CRM.
Массовое добавление реквизитов для списка компаний	В цикле по итератору: ENTITY_ID — {=Iterator:Value}, где Iterator передаёт ID компаний. Тип пресета и Тип сущности (4) задайте один раз; Название можно сформировать выражением, например «Реквизиты {=Iterator:Key}».
Создать реквизит с кодом для интеграции с 1С	Заполните Тип пресета, Тип сущности, ENTITY_ID, Название и поле «Код» (или «Внешний код») значением из внешней системы, например {=Variable:EXTERNAL_CODE}. Идентификатор внешней информационной базы при необходимости укажите в соответствующем поле.
Добавить реквизит компании, найденной по ИНН	После активити (робота) «Поиск Компании по ИНН КПП» или «Умный поиск компаний по реквизитам» возьмите ID компании из результата. Тип пресета — нужный шаблон, Тип сущности — 4, ENTITY_ID — {=A1988_22222_92566_99999:ID} (подставьте код вашего активити), Название — «Основные реквизиты».
Реквизит с данными руководителя и контактами	Выберите пресет для юрлица или ИП, укажите ENTITY_ID компании, заполните поля ФИО первого руководителя, Должность первого руководителя, E-Mail, Телефон. Название — «Контактные реквизиты».
Добавить реквизит после конвертации лида в сделку/компанию	В бизнес-процессе после создания компании из лида: ENTITY_ID — ID созданной компании из возвращаемого параметра соответствующего активити (робота), Тип сущности — 4, Тип пресета и Название — по задаче. Данные можно брать из полей лида через переменные.
Реквизит с указанием активности и сортировки	Параметры Тип пресета, Тип сущности, ENTITY_ID, Название — как обычно; поле «Активен» — Y или N; «Сортировка» — число для порядка отображения (например 100). Подходит для нескольких реквизитов у одной сущности.
Создать реквизит компании из карточки сделки	ENTITY_ID — {=Document:COMPANY_ID} (если документ — сделка и в нём есть привязка к компании). Тип пресета — «Юридическое лицо», Тип сущности — 4, Название — «Реквизиты для счёта». Используйте id_requisite в следующих шагах (например, для добавления банковских реквизитов).

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

- id_requisite (Идентификатор нового реквизита) — число, ID созданного реквизита. Используется для последующего изменения реквизита, добавления банковских реквизитов или получения данных по реквизиту.

Примеры использования возвращаемых параметров:
- Передать id_requisite в активити (робот) «Добавление банковского реквизита» для привязки расчётного счёта;
- Использовать id_requisite в активити (робот) «Получение данных по сущности: реквизит» для проверки или копирования данных;
- Сохранить id_requisite в переменную для использования в условиях или следующих шагах.

Важно о возвращаемых параметрах: При ошибке (нет обязательных параметров или сущность не найдена) реквизит не создаётся; в журнал бизнес-процесса записывается сообщение об ошибке. Проверяйте наличие сущности и заполненность обязательных полей до шага добавления реквизита.

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

Обязательные параметры:
Для успешного добавления реквизита обязательно указать: Тип пресета, Тип сущности, ENTITY_ID (ID сущности) и Название (NAME). При отсутствии хотя бы одного из них активити (робот) завершится с ошибкой «Нет обязательных параметров» с перечислением недостающих полей.

Существование сущности:
Перед вызовом активити (робота) контакт или компания с указанным ENTITY_ID должны существовать в CRM. Если сущность не найдена, выполнение завершится с ошибкой «Указанной сущности не существует».

Пресеты и поля шаблонов:
Добавление новых шаблонов и полей реквизитов в настройках CRM должно выполняться до установки активити (робота) на портал. Если шаблоны или поля добавлены после установки, они не отобразятся в настройках активити (робота) до его переустановки.

УНП (Беларусь):
В текущей реализации УНП (Беларусь) хранится в поле ИНН (Россия). Учитывайте это при получении и отображении данных реквизита.

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

Типы сущностей:
Поддерживаются только контакт (ENTITY_TYPE_ID=3) и компания (ENTITY_TYPE_ID=4). Реквизиты не привязываются к сделкам и лидам напрямую — только к контакту или компании.

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

Добавление реквизита