Автозапуск Бизнес-процессов

Штатный автозапуск: запуск БП только при изменении или добавления сущности.
Наше решение: позволяет запускать БП как в определенное время, так и с указанной периодичностью.
Можно также выбрать кратность запуска (однократно или многократно). 

Кнопка "Добавить БП" - после нажатия появляется меню настройки сценария автозапуска БП.
Доступные для настройки параметры: 

• Тип сущности (обязательно);
• ID сущности (обязательно);
• Шаблон БП (обязательно);
• Запускать периодически (опционально);
• Месяц запуска (опционально);
• Час запуска (опционально);
• Минута запуска (опционально);
• Тип запуска (опционально);
• Активировать шаблон автозапуска БП.

Тип сущности: выпадающий список, в котором нужно выбрать в каком типе сущности будет происходить автозапуск.
Этот параметр обязателен к заполнению.

Для каждого сценария можно выбрать только 1 тип сущности, с которым он будет работать.
Если вы хотите чтобы сценарий работал с другим типом сущности, то нужно настраивать сценарий для другого типа сущности отдельно.
Типы сущности, доступные к выбору: Лид, Сделка, Контакт, Компания, БП в живой Ленте, Универсальные списки, Смарт-процессы, Диск.

ID сущности: указывается идентификатор сущности, с которой будет работать БП.
Этот параметр обязателен к заполнению.

Шаблон БП: позволяет выбрать из списка БП, который есть на портале.
Этот параметр обязателен к заполнению.

Этот БП будет автоматически запускаться согласно настроенного вами сценария.

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

Месяц запуска, Час запуска, Минута запуска - позволяют указать месяц, час и минуту запуска БП.
Поля заполняются в числовом виде.
Т.е если вы хотите, чтобы БП запускался 9 марта в 14:38, то нужно заполнить поля как на скриншоте ниже.

Тип запуска: позволяет выбрать из выпадающего списка сколько раз будет запущен БП, один раз или несколько.
Варианты:

• Многократно;
• Однократно;

Активировать шаблон автозапуска БП: данный параметр служит для активации или деактивации сценария автозапуска.
Если параметр не активировать, то сценарий автозапуска работать не будет.

Статус: отображает статус активности сценария автозапуска.

• Зеленый - сценарий активен;
• Красный - сценарий не активен (отключен).

Данные БП: отображает краткий набор данных о сущности с которой работает БП.
Отображаемые данные:

• Тип сущности с которой работает БП;
• ID сущности;
• Название БП, который задействован в сценарии автозапуска.

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

Интервал запуска: отображает данные об интервале запуска БП, который задан в сценарии автозапуска.

Тип запуска: отображает сколько раз будет запущен БП согласно настроек сценария, один раз или несколько.

Следующий запуск: отображает дату и время следующего автозапуска БП.

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

Статус запуска: отображает статус запуска БП, срабатывал ли автозапуск или нет.

Значек карандаша: позволяет отредактировать сценарий автозапуска.

Значок "урны": позволяет удалить сценарий автозапуска после подтверждения процедуры удаления.

Массовый запуск Бизнес-процессов

При работе с бизнес-процессами и сущностями, в Битрикс24 бывают сценарии при которых необходимо запустить БП (бизнес-процесс) для нескольких сущностей.
Можно запускать БП из меню в каждой сущности, но если их много, 50,100 и более, то это будет довольно затратно по времени, и не эффективно.
Именно для таких случаев мы разработали данный функционал.

Цветовая расшифровка статусов в таблице:

• Белый - шаблон сохранен, но не выполняется и не был запущен;
• Синий - шаблон выполняется;
• Зеленый - шаблон успешно завершил работу;
• Красный - шаблон завершил работу с ошибкой;
• Оранжевый - работа шаблона остановлена сотрудником.

Для того чтобы запустить множество сущностей, нужно эти сущности определить, для этого нужен раздел "Фильтр".

Для настройки шаблона массового запуска, нужно нажать кнопку "Добавить шаблон".
После этого откроется меню настройки шаблона, с активной вкладкой "Фильтр":

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

Выберите тип сущности: позволяет выбрать из выпадающего списка тип сущности, с которой будет работать шаблон массового запуска БП. Так же, выбор в этом поле определяет для поля "Список шаблонов БП", для какой сущности подгружать бизнес-процессы из конструктора БП.

Поддерживаются следующие типы сущностей:

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• БП в живой ленте;
• Универсальные списки;
• Смарт-процессы.

Список шаблонов БП: позволяет выбрать из выпадающего списка, БП, которые будут запущены этим шаблоном массвого запуска после настройки.

Ограничить количество элементов до: позволяет указать максимальное количество элементов, с которыми шаблон будет работать за 1 проход.
Т.е если вам нужно обработать к примеру 150 элементов и в поле вы укажите 30, то шаблон за раз будет работать максимум с 30 элементами.
Это нужно для того, чтобы не "заливать" наше приложение либо сервер Б24 эвентами и не попасть в очередь или блокировку по лимиту.
Параметры фильтров Обновить : эта кнопка позволяет произвести обновление подгрузившихся параметров фильтра, в случае если это потребуется.

Кнопка Поиск по фильтру : активирует поиск сущностей по заранее заданным в фильтре параметрам.
После поиска будут отображены (если найдены) сущности с которыми будет работать шаблон массового запуска.

Набор фильтров состоит из кастомных и пользовательских полей, которые существуют в рамках выбранного типа сущности.
Если бы добавили новое кастомное поле в какую-то из сущностей и хотите чтобы она отобразилась в фильте, нужно воспользоваться кнопкой "Обновить".

Найденные фильтром элементы будут отображены во вкладке "Найдено".
После того, как фильтр нашел необходимые элементы и вы удалили (или нет) лишние, Вы можете сразу запустить шаблон массового запуска в работу, нажатием кнопки Выполнить запуск.
Вкладка "История операций" - отображает операции, время их выполнения и ФИО сотрудника, от имени которого эти операции были выполнены.

 

Статус: отображает статус выполнения шаблона.
Значение цветовой палитры статусов описано выше.

Шаблон БП: Отображает название БП, который работает в шаблоне массвого запуска.

Тип сущности: отображает тип сущности с которой работает шаблон массвого запуска.

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

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

Когда создан: отображает дату и время создания шаблона. 

Кем создан: отображает имя и ID пользователя, который создал шаблон.

Поиск по Бизнес-процессам

Модуль "Поиск по бизнес-процессам" предназначен для фильтрации и поиска шаблонов бизнес-процессов Битрикс24 по различным параметрам.
Результатом работы модуля является возможность быстрого поиска нужных шаблонов бизнес-процессов по ID, названию, типу сущности, наличию автозапуска, типу активити, заголовку активити, значению параметра в активити и другим критериям.
Модуль поддерживает сохранение параметров фильтрации для быстрого применения в будущем и автоматическое кэширование данных для повышения производительности.

Название функции	Описание и примеры использования
Фильтрация по ID бизнес-процесса	Позволяет найти шаблон бизнес-процесса по его уникальному идентификатору. Поиск выполняется по точному совпадению или частичному совпадению ID. Это полезно для быстрого поиска конкретного шаблона, если известен его идентификатор. Как использовать: - Введите ID бизнес-процесса в поле "ID бизнес-процесса"; - Система автоматически отфильтрует таблицу и покажет только шаблоны с указанным ID; - Поиск работает в реальном времени при вводе текста. ID бизнес-процесса является уникальным идентификатором и позволяет точно найти нужный шаблон.
Фильтрация по названию бизнес-процесса	Позволяет найти шаблоны бизнес-процессов по их названию. Поиск выполняется по частичному совпадению текста в названии шаблона. Это полезно для поиска шаблонов, когда известно примерное название или его часть. Как использовать: - Введите название или часть названия бизнес-процесса в поле "Название бизнес-процесса"; - Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие указанный текст в названии; - Поиск не чувствителен к регистру и работает в реальном времени. Поиск выполняется по частичному совпадению, поэтому можно ввести только часть названия для поиска.
Фильтрация по типу сущности бизнес-процесса	Позволяет отфильтровать шаблоны бизнес-процессов по типу сущности, с которой они работают. Доступны все типы сущностей, присутствующие в шаблонах на портале: Сделка, Лид, Контакт, Компания, Смарт-процесс, Универсальные списки, Универсальные списки в группе, Живая лента, Задачи. Как использовать: - Выберите нужный тип сущности из выпадающего списка "Тип сущности бизнес-процесса"; - Система автоматически отфильтрует таблицу и покажет только шаблоны выбранного типа сущности; - Для отображения всех типов выберите опцию "Все типы". Информация о типах: Список типов сущностей формируется автоматически на основе всех шаблонов, присутствующих на портале.
Фильтрация по автозапуску	Позволяет отфильтровать шаблоны бизнес-процессов по наличию или отсутствию активной опции автозапуска в его настройках, а так же типу автозапуска. Это полезно для поиска шаблонов с определенным режимом автозапуска. Как использовать: - Выберите нужный вариант автозапуска из выпадающего списка "Автозапуск"; - Система автоматически отфильтрует таблицу и покажет только шаблоны с выбранным типом автозапуска; - Для отображения всех шаблонов выберите опцию "Любой". Варианты автозапуска: Без автозапуска; Создание; Изменение; Создание и изменение.
Фильтрация по пользователю, изменившему бизнес-процесс	Позволяет найти шаблоны бизнес-процессов, которые последний раз изменял конкретный пользователь. Список пользователей формируется автоматически на основе всех пользователей, которые когда-либо изменяли шаблоны на портале. Это полезно для отслеживания работы конкретного сотрудника или команды. Как использовать: - Выберите пользователя из выпадающего списка "Кто изменил бизнес-процесс"; - Система автоматически отфильтрует таблицу и покажет только шаблоны, которые последний раз изменял выбранный пользователь; - Для отображения всех шаблонов выберите опцию "Все пользователи"; - Так же доступен ручной ввод ФИО пользователей. Информация о пользователях: Список пользователей формируется автоматически на основе данных о последних изменениях шаблонов.
Фильтрация по типу штатных активити Битрикс24	Позволяет найти шаблоны бизнес-процессов, содержащие стандартные активити Б24. Поиск выполняется по типу активити (например, "Создать задачу", "Отправить письмо", "Условие" и другие), путем выбора необходимого активити из выпадающего списка с разделами. Как использовать: - Выберите тип активити из выпадающего списка "Тип штатных активити Битрикс24"; - Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие выбранный тип активити; Информация об активити: Список типов активити формируется автоматически на основе всех активити, присутствующих в шаблонах на портале.
Фильтрация по заголовку активити	Позволяет найти шаблоны бизнес-процессов, содержащие активити с определенным заголовком (названием). Поиск выполняется по точному или частичному совпадению заголовка активити. Это полезно для поиска шаблонов, использующих активити с конкретными названиями. Как использовать: - Введите заголовок активити или его часть в поле "Заголовок активити"; - Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие активити с указанным заголовком; - Поиск работает в реальном времени при вводе текста. Поиск выполняется по частичному совпадению, поэтому можно ввести только часть заголовка для поиска.
Фильтрация по значению параметра в активити	Позволяет найти шаблоны бизнес-процессов, содержащие активити с определенным значением параметра. Поиск выполняется по значению любого параметра в любом поле активити шаблона. Это полезно для поиска шаблонов, использующих конкретные значения параметров (например, определенные адреса электронной почты, названия полей, значения переменных и другие). Как использовать: - Введите значение параметра в поле "Значение параметра в активити"; - Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие активити с указанным значением параметра; - Поиск работает в реальном времени при вводе текста. Поиск выполняется по всем параметрам всех активити в шаблоне, поэтому можно найти шаблоны по любому значению параметра.
Сохранение параметров фильтрации	Позволяет сохранить текущие параметры фильтрации для быстрого применения в будущем. Система поддерживает сохранение до 10 наборов параметров фильтрации. Каждый сохраненный набор можно назвать для удобства идентификации. Это полезно для часто используемых комбинаций фильтров. Как использовать: - Заполните нужные поля фильтрации; - Нажмите кнопку "Сохранить параметры фильтра"; - Введите название для сохраненного набора параметров; - Сохраненный набор появится в списке справа от фильтров; - Для применения сохраненных параметров кликните на нужный набор в списке. ВАЖНО! Система ограничивает количество сохраненных наборов параметров до 10. При достижении лимита необходимо удалить один из существующих наборов перед сохранением нового.
Редактирование сохраненных параметров фильтрации	Позволяет изменить название сохраненного набора параметров фильтрации. Это полезно для переименования наборов при изменении их назначения или для исправления опечаток в названиях. Как использовать: - Найдите нужный набор параметров в списке справа от фильтров; - Нажмите на иконку карандаша рядом с названием набора; - Введите новое название и нажмите на иконку сохранения или нажмите Enter; - Название будет обновлено. Редактирование изменяет только название набора параметров, сами параметры остаются неизменными.
Удаление сохраненных параметров фильтрации	Позволяет удалить сохраненный набор параметров фильтрации из списка. Это полезно для освобождения места при достижении лимита в 10 сохраненных наборов или для удаления устаревших наборов. Как использовать: - Найдите нужный набор параметров в списке справа от фильтров; - Нажмите на иконку корзины рядом с названием набора; - Подтвердите удаление в появившемся модальном окне; - Набор будет удален из списка. ВАЖНО! Удаление набора параметров выполняется безвозвратно. После удаления набор нельзя восстановить.
Очистка параметров фильтрации	Позволяет быстро очистить все поля фильтрации и сбросить все примененные фильтры. Это полезно для начала нового поиска с нуля или для просмотра всех шаблонов без фильтрации. Как использовать: - Нажмите кнопку "Очистить параметры фильтра"; - Все поля фильтрации будут очищены; - Таблица автоматически обновится и покажет все шаблоны без фильтрации. Очистка параметров фильтрации не удаляет сохраненные наборы параметров из списка.
Обновление списка шаблонов бизнес-процессов	Позволяет обновить список шаблонов бизнес-процессов, загрузив актуальные данные с портала Битрикс24. Система кэширует список шаблонов для повышения производительности, но при необходимости можно принудительно обновить данные, удалив кэш и загрузив свежую информацию. При обновлении список шаблонов обновляется в реальном времени, включая новые созданные шаблоны и изменения в существующих. Как использовать: - Нажмите кнопку "Обновить список шаблонов БП"; - Система автоматически удалит кэш и загрузит актуальный список шаблонов; - Обновленный список отобразится в таблице на странице. Кэширование: Система автоматически кэширует список шаблонов для повышения скорости работы. Кэш обновляется при каждом обновлении списка или автоматически при изменениях в шаблонах.
Сортировка таблицы результатов	Позволяет сортировать таблицу результатов фильтрации по различным столбцам. Доступна сортировка по ID, названию, типу сущности, дате изменения, количеству активити и другим параметрам. Это полезно для упорядочивания результатов поиска. Как использовать: - Нажмите на заголовок столбца для сортировки по возрастанию; - Повторное нажатие изменит направление сортировки на убывание; - Третье нажатие отменит сортировку и вернет исходный порядок. Сортировка применяется к текущим результатам фильтрации, а не ко всем шаблонам.

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

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

Описание примера	Решение
Поиск шаблона бизнес-процесса по известному ID	Если известен ID нужного шаблона бизнес-процесса, введите его в поле "ID бизнес-процесса". Например, для поиска шаблона с ID 123 введите "123" в поле фильтрации. Система автоматически отфильтрует таблицу и покажет только шаблон с указанным ID.
Поиск всех шаблонов для работы со сделками	Для поиска всех шаблонов бизнес-процессов, работающих со сделками, выберите "CRM Сделка" в поле "Тип сущности бизнес-процесса". Система автоматически отфильтрует таблицу и покажет только шаблоны, работающие со сделками.
Поиск шаблонов с автозапуском при создании	Для поиска всех шаблонов, которые автоматически запускаются при создании сущности, выберите "Создание" в поле "Автозапуск". Система автоматически отфильтрует таблицу и покажет только шаблоны с автозапуском при создании.
Поиск шаблонов, измененных конкретным пользователем	Для поиска всех шаблонов, которые последний раз изменял конкретный пользователь, выберите нужного пользователя в поле "Кто изменил бизнес-процесс". Например, выберите "Иванов Иван Иванович" для поиска всех шаблонов, которые он последний раз изменял.
Поиск шаблонов, содержащих активити "Отправить письмо"	Для поиска всех шаблонов, содержащих активити типа "Отправить письмо", выберите "Отправить письмо" в поле "Тип штатных активити Битрикс24". Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие это активити.
Поиск шаблонов с определенным значением параметра	Для поиска шаблонов, содержащих активити с определенным значением параметра, введите это значение в поле "Значение параметра в активити". Например, для поиска шаблонов, использующих адрес электронной почты "manager@example.com", введите "manager@example.com" в поле фильтрации.
Комбинированный поиск шаблонов для сделок с автозапуском	Для поиска шаблонов, работающих со сделками и имеющих автозапуск при создании, выберите "CRM Сделка" в поле "Тип сущности бизнес-процесса" и "Создание" в поле "Автозапуск". Система автоматически отфильтрует таблицу и покажет только шаблоны, соответствующие обоим критериям.
Сохранение часто используемых параметров фильтрации	Для сохранения часто используемых параметров фильтрации заполните нужные поля фильтрации, например, выберите "CRM Сделка" в типе сущности и "Создание" в автозапуске. Нажмите кнопку "Сохранить параметры фильтра" и введите название, например "Сделки с автозапуском". В будущем можно быстро применить эти параметры, кликнув на сохраненный набор в списке справа.
Поиск шаблонов по части названия	Для поиска шаблонов по части названия введите часть названия в поле "Название бизнес-процесса". Например, для поиска всех шаблонов, содержащих слово "обработка" в названии, введите "обработка" в поле фильтрации. Система автоматически найдет все шаблоны с этим словом в названии.
Поиск шаблонов с несколькими типами активити	Для поиска шаблонов, содержащих один из нескольких типов активити, выберите несколько типов активити в поле "Тип штатных активити Битрикс24". Например, выберите "Отправить письмо" и "Создать задачу". Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие хотя бы один из выбранных типов активити.
Быстрый сброс всех фильтров	Для быстрого сброса всех примененных фильтров и просмотра всех шаблонов нажмите кнопку "Очистить параметры фильтра". Все поля фильтрации будут очищены, и таблица автоматически обновится, показывая все шаблоны без фильтрации.
Обновление списка после создания новых шаблонов	После создания новых шаблонов бизнес-процессов нажмите кнопку "Обновить список шаблонов БП" для загрузки актуального списка. Система автоматически удалит кэш и загрузит свежие данные с портала, включая новые созданные шаблоны.
Сортировка результатов по дате изменения	Для упорядочивания результатов фильтрации по дате последнего изменения нажмите на заголовок столбца "Дата изменения". Первое нажатие отсортирует по возрастанию (старые сверху), второе нажатие - по убыванию (новые сверху). Это полезно для поиска недавно измененных шаблонов.

Модуль "Поиск по бизнес-процессам" предназначен для использования в веб-интерфейсе и может быть полезен в следующих сценариях:

• Быстрый поиск конкретного шаблона бизнес-процесса по ID или названию;
• Фильтрация шаблонов по типу сущности для работы только с определенными типами бизнес-процессов;
• Поиск шаблонов с определенным режимом автозапуска для анализа автоматизации процессов;
• Отслеживание работы конкретных пользователей через фильтрацию по изменившему пользователю;
• Поиск шаблонов, использующих определенные типы активити для анализа функциональности;
• Поиск шаблонов по значению параметра для нахождения шаблонов с конкретными настройками;
• Комбинированный поиск по нескольким критериям для точного нахождения нужных шаблонов;
• Сохранение часто используемых параметров фильтрации для быстрого применения в будущем;
• Анализ структуры бизнес-процессов на портале через фильтрацию и сортировку;
• Обновление списка шаблонов после изменений для работы с актуальными данными.

Сохранение БП

Модуль "Сохранение БП" предназначен для управления резервными копиями шаблонов бизнес-процессов Битрикс24.
Результатом работы модуля является возможность сохранения, просмотра, восстановления и управления резервными копиями шаблонов БП для последующего использования или восстановления после случайного удаления или изменения.

Название функции	Описание и примеры использования
Сохранение резервной копии шаблона БП	Позволяет сохранить полную резервную копию шаблона бизнес-процесса в базу данных. Сохраняются все параметры шаблона: структура активити, переменные, константы, параметры, настройки автозапуска и другие данные. При сохранении автоматически проверяется лимит резервных копий согласно тарифу пользователя. Если лимит достигнут, система выводит предупреждение с предложением удалить часть существующих копий или приобрести другой тариф. При каждом сохранении в журнал операций записывается информация о пользователе, который выполнил операцию, и дате сохранения. Как использовать: - Откройте список шаблонов БП на странице модуля; - Найдите нужный шаблон в таблице; - Нажмите на иконку дискеты в столбце "Резервная копия"; - В появившемся всплывающем окне нажмите кнопку "Сохранить резервную копию"; - Система автоматически сохранит копию с указанием текущей даты и пользователя. Важно: Система ограничивает количество резервных копий согласно тарифному плану. При достижении лимита необходимо удалить часть существующих копий или приобрести другой тариф. Механизм не работает с роботами, только бизнес-процессы из конструктора БП. Созданные в конструкторе БП шаблоны вручную, приложение может только "клонировать" и ничего более, даже удалить. А вот с клонами, пользователь может уже полноценно работать. Такие БП, созданные вручную, будут отображены в виде "серой" дискетки.
Просмотр списка сохраненных копий	Позволяет просмотреть все сохраненные резервные копии для конкретного шаблона БП. Для каждого шаблона можно сохранить несколько версий копий, и все они будут отображаться в списке с указанием даты сохранения и пользователя, который выполнил операцию. В таблице списка копий отображается информация: ID копии, название шаблона, дата сохранения, пользователь, который сохранил копию, и доступные действия. Как использовать: - Найдите шаблон БП в основной таблице; - Нажмите на иконку дискеты, чтобы открыть список резервных копий; - В модальном окне будет отображена таблица со всеми сохраненными копиями шаблона. Информация о копиях: Каждая копия содержит полную информацию о состоянии шаблона на момент сохранения, включая все активити, переменные, константы и настройки.
Восстановление шаблона из резервной копии	Позволяет восстановить шаблон БП из ранее сохраненной резервной копии. При восстановлении все текущие настройки шаблона заменяются настройками из выбранной копии. Операция восстановления создает запись в журнале операций для отслеживания изменений. Восстановление выполняется через REST API метод bizproc.workflow.template.update, что гарантирует корректность данных. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите нужную копию в списке (сортировка по дате сохранения - самые новые сверху); - Нажмите кнопку "Восстановить" рядом с нужной копией; - Подтвердите операцию восстановления; - Система автоматически восстановит шаблон из выбранной копии. Важно: Операция восстановления заменяет все текущие настройки шаблона. Рекомендуется сохранить текущую версию перед восстановлением, если есть риск потерять важные изменения. "Заменить" (восстановить) можно ТОЛЬКО БП, которые были созданы приложением. Созланные в конструкторе БП бизнес-процессы восстановить НЕЛЬЗЯ. Чтобы БП, которые были созданы в конструкторе можно было восстанавливать, их нужно "Клонировать", и клон оригинального БП уже можно восстановить при необходимости.
Скачивание резервной копии в формате .bpt	Позволяет скачать резервную копию шаблона БП в стандартном формате .bpt для последующего использования на другом портале или в качестве архива. Файл .bpt содержит полную информацию о шаблоне в сжатом формате и может быть импортирован в любой портал Битрикс24. Имя файла формируется автоматически и включает домен портала, ID шаблона и метку времени. Операция скачивания также фиксируется в журнале операций. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите нужную копию в списке; - Нажмите кнопку "Скачать" рядом с нужной копией; - Файл автоматически загрузится в папку загрузок браузера; - Имя файла будет в формате: домен_портала_ID_шаблона_время.bpt. Формат файла: Файл .bpt представляет собой сжатый архив с сериализованными данными шаблона в формате JSON, который может быть импортирован в Битрикс24 через интерфейс бизнес-процессов.
Клонирование БП	Позволяет создать новый шаблон БП на основе сохраненной резервной копии существующего шаблона. Это полезно для копирования настроек одного шаблона в другой или для создания вариаций одного шаблона для разных сценариев. При создании нового шаблона автоматически добавляется префикс с названием приложения и датой создания к оригинальному названию шаблона. Новый шаблон создается с теми же параметрами, что и исходный: типом сущности, настройками автозапуска, структурой активити и всеми переменными. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите нужную копию в списке; - Нажмите кнопку "Клонировать" рядом с нужной копией; - Система автоматически создаст новый шаблон на основе выбранной копии; - Новый шаблон появится в списке шаблонов БП с названием в формате: "Оригинальное название [Лаборатория роботов - дата и время]". Важно: Новый шаблон создается как полностью независимый и не связан с исходным шаблоном. Все последующие изменения в новом шаблоне не влияют на оригинальный шаблон или резервную копию.
Удаление резервных копий	Позволяет удалить отдельную резервную копию шаблона БП из базы данных. Операция удаления создает запись в журнале операций для аудита. При удалении копии она полностью удаляется из базы данных и не может быть восстановлена. Также доступна функция массового удаления всех резервных копий для конкретного шаблона БП. Это полезно для освобождения места при достижении лимита резервных копий. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите копию, которую нужно удалить; - Нажмите кнопку "Удалить" рядом с нужной копией; - Подтвердите операцию удаления; - Копия будет удалена из базы данных. Массовое удаление: Для удаления всех копий конкретного шаблона используйте функцию "Удалить шаблон со всеми копиями" в основном списке шаблонов.
Фильтрация шаблонов БП	Позволяет фильтровать список шаблонов БП по различным критериям для быстрого поиска нужных шаблонов. Доступны фильтры: по ID бизнес-процесса, по названию, по типу сущности, по пользователю, который последним изменял шаблон, по наличию резервных копий, по шаблонам, созданным приложением, и по удаленным шаблонам. Фильтры могут использоваться как отдельно, так и в комбинации друг с другом. Система поддерживает сохранение параметров фильтрации для быстрого применения в будущем. Как использовать: - Заполните нужные поля фильтрации в верхней части страницы; - Используйте выпадающие списки для выбора типа сущности или пользователя; - Установите флажки для показа только шаблонов с копиями, удаленных шаблонов или шаблонов, созданных приложением; - Результаты фильтрации автоматически применяются к таблице шаблонов; - Используйте кнопку "Очистить параметры фильтра" для сброса всех фильтров. - Используйте кнопку "Обновить список шаблонов БП" для обновления списка доступных в системе БП. Сохранение фильтров: Система позволяет сохранить до 10 последних наборов параметров фильтрации для быстрого применения в будущем.
Просмотр истории операций	Позволяет просмотреть полную историю всех операций с резервными копиями шаблонов БП. В истории отображаются все действия: создание копии, восстановление шаблона, скачивание файла, создание нового шаблона, замена шаблона и удаление копий. Для каждой операции записывается тип операции, пользователь, который выполнил действие, ID шаблона БП, описание операции, дата и время выполнения. История доступна как в общем виде для всех шаблонов, так и по конкретному шаблону БП. Система поддерживает пагинацию для удобной навигации по большому количеству записей. Как использовать: - Нажмите кнопку "История операций" в верхней части страницы для просмотра общей истории; - Для просмотра истории конкретного шаблона откройте список его резервных копий; - В модальном окне будет отображена таблица с историей операций; - Используйте пагинацию для просмотра предыдущих или следующих страниц; - История отсортирована по дате - самые новые операции сверху. Информация в истории: Каждая запись содержит полную информацию об операции, включая тип операции (Создание, Обновление, Восстановление, Скачивание, Замена, Удаление), пользователя, ID шаблона и описание действия.
Обновление списка шаблонов БП	Позволяет обновить список шаблонов БП, загрузив актуальные данные с портала Битрикс24. Система кэширует список шаблонов для повышения производительности, но при необходимости можно принудительно обновить данные, удалив кэш и загрузив свежую информацию. При обновлении список шаблонов обновляется в реальном времени, включая новые созданные шаблоны и изменения в существующих. Как использовать: - Нажмите кнопку "Обновить список шаблонов БП" в верхней части страницы; - Система автоматически удалит кэш и загрузит актуальный список шаблонов; - Обновленный список отобразится в таблице на странице. Кэширование: Система автоматически кэширует список шаблонов для повышения скорости работы. Кэш обновляется при каждом обновлении списка или автоматически при изменениях в шаблонах.
Работа с удаленными шаблонами	Позволяет просматривать и работать с шаблонами БП, которые были удалены из портала Битрикс24, но имеют сохраненные резервные копии. Удаленные шаблоны отображаются в основной таблице с пометкой "Удален" и могут быть восстановлены или использованы для создания новых шаблонов. Это полезно для восстановления случайно удаленных шаблонов или для анализа удаленных шаблонов. Как использовать: - Установите флажок "Удаленные шаблоны" в блоке фильтров; - В таблице будут отображены только шаблоны, удаленные из портала, но имеющие резервные копии; - Для удаленных шаблонов доступны функции просмотра копий, скачивания и создания нового шаблона; - Функция восстановления недоступна для удаленных шаблонов, так как они не существуют на портале. Важно: Удаленные шаблоны можно использовать только для создания новых шаблонов или скачивания резервных копий. Прямое восстановление удаленного шаблона невозможно, так как шаблон отсутствует на портале.
Удаление шаблона БП	Позволяет удалить шаблон БП непосредственно из портала Битрикс24 через REST API. Операция удаления выполняется окончательно и необратимо. Система позволяет удалять только шаблоны, которые были созданы этим приложением. Для шаблонов, созданных другими способами, функция удаления недоступна для предотвращения случайного удаления важных шаблонов. Как использовать: - Найдите нужный шаблон в списке; - Убедитесь, что шаблон был создан этим приложением (иконка удаления будет активной); - Нажмите на иконку корзины в столбце "Удалить"; - Подтвердите операцию удаления; - Шаблон будет удален из портала Битрикс24. Важно: Удаление шаблона БП выполняется безвозвратно. Рекомендуется сохранить резервную копию перед удалением, если есть вероятность, что шаблон понадобится в будущем.

Описание примера	Решение
Создание резервной копии перед важными изменениями шаблона БП	Перед внесением изменений в шаблон БП сохраните его резервную копию. Откройте список шаблонов, найдите нужный шаблон, нажмите на иконку дискеты и выберите "Сохранить резервную копию". После сохранения можно безопасно вносить изменения в шаблон, зная, что при необходимости можно восстановить предыдущую версию.
Восстановление шаблона после неудачных изменений	Если после изменений шаблон работает некорректно, восстановите его из резервной копии. Откройте список копий нужного шаблона, найдите нужную версию (обычно самая последняя перед изменениями), нажмите "Восстановить" и подтвердите операцию. Шаблон будет восстановлен в состояние на момент сохранения копии.
Создание копии шаблона для другого отдела	Для создания шаблона для другого отдела на основе существующего используйте функцию "Создать новый шаблон". Откройте список резервных копий исходного шаблона, выберите нужную копию и нажмите "Создать новый шаблон". Новый шаблон будет создан с теми же настройками, и его можно будет адаптировать под нужды отдела без изменения оригинального шаблона.
Экспорт шаблона БП для использования на другом портале	Для переноса шаблона БП на другой портал скачайте его резервную копию в формате .bpt. Откройте список копий нужного шаблона, выберите нужную копию и нажмите "Скачать". Файл будет загружен в папку загрузок. Затем этот файл можно импортировать на другой портал Битрикс24 через интерфейс бизнес-процессов.
Восстановление случайно удаленного шаблона БП	Если шаблон был случайно удален, используйте фильтр "Удаленные шаблоны" для поиска. Установите флажок "Удаленные шаблоны" в фильтрах, найдите нужный шаблон в списке. Откройте его резервные копии и используйте функцию "Создать новый шаблон" для восстановления. Новый шаблон будет создан на основе последней сохраненной копии.
Архивирование старых резервных копий	Для освобождения места при достижении лимита резервных копий скачайте старые копии в формате .bpt для архивации. Откройте список копий шаблона, отсортируйте по дате (старые внизу), скачайте нужные копии и сохраните их локально. Затем удалите скачанные копии из системы для освобождения места.
Отслеживание изменений в шаблонах БП через историю операций	Для аудита и отслеживания изменений используйте функцию просмотра истории операций. Нажмите кнопку "История операций" в верхней части страницы для просмотра всех операций или откройте историю конкретного шаблона через список его копий. История покажет всех пользователей, которые работали с шаблоном, и все выполненные операции.
Быстрый поиск шаблонов определенного типа сущности	Для поиска всех шаблонов определенного типа сущности используйте фильтр "Тип сущности бизнес-процесса". Выберите нужный тип из выпадающего списка (например, "CRM Сделка" или "CRM Контакт"), и в таблице будут отображены только шаблоны этого типа. Это упрощает работу с большим количеством шаблонов.
Поиск шаблонов, измененных конкретным пользователем	Для поиска шаблонов, которые изменял конкретный пользователь, используйте фильтр "Кто изменил бизнес-процесс". Выберите пользователя из выпадающего списка, и в таблице будут отображены только шаблоны, которые последний раз изменял этот пользователь. Это полезно для отслеживания работы команды или конкретного сотрудника.
Работа только с шаблонами, имеющими резервные копии	Для фильтрации только шаблонов с сохраненными резервными копиями установите флажок "Шаблоны с копиями" в блоке фильтров. В таблице будут отображены только шаблоны, для которых были созданы резервные копии. Это помогает быстро найти шаблоны, у которых есть возможность восстановления.

Модуль "Сохранение БП" предназначен для использования в веб-интерфейсе и может быть полезен в следующих сценариях:

• Создание резервных копий перед важными изменениями шаблонов БП для возможности отката изменений;
• Восстановление шаблонов после неудачных изменений или случайного удаления;
• Копирование шаблонов БП между отделами или порталами Битрикс24;
• Архивирование старых версий шаблонов для хранения истории изменений;
• Экспорт и импорт шаблонов БП для использования на других порталах;
• Аудит и отслеживание изменений в шаблонах БП через журнал операций;
• Быстрый поиск и фильтрация шаблонов по различным критериям;
• Управление версиями шаблонов БП для поддержания различных вариантов одного процесса;
• Восстановление работы бизнес-процессов после ошибок или сбоев;
• Создание тестовых копий шаблонов для экспериментов без риска потери рабочей версии.

Бизнес-процессы

Запуск бизнес-процесса для Лида

Данное активити позволяет запускать бизнес-процесс для сущности "Лид" после выбора необходимых БП из списка.


Бизнес-процесс: в данном поле из выпадающего списка можно выбрать какие активити будут запущены в результате работы БП "Запуск бизнес-процесса для лида".
Все доступные варианты являются ранее созданными шаблонами БП для сущности данного типа.

ID сущности: в данном пункте указывается ID сущности "Лид" для которой будут запущены активити, выбранные в п. меню "Бизнес-процесс".

Параметры для бизнес-процесса: в данном пункте указываются параметры, которые нужно передать в БП.
Заполняется по такому принципу: название параметра: содержимое параметра
Пример ввода параметра: Title:123 
Параметр,указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для лида". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID лида, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID лида).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.
Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Запуск бизнес-процесса для Компании

Данное активити позволяет запускать бизнес-процесс для сущности "Компания" после выбора необходимых БП из списка.

 
Пример ввода параметра: Title:123 
Параметр, указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для компании". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID компании, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID компании).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.
Схема: Название переменной:содержимое. Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Запуск бизнес-процесса для Контакта

Данное активити позволяет запускать бизнес-процесс для сущности "Контакт" после выбора необходимых БП из списка.


Бизнесс-процес: в данном поле из выпадающего списка можно выбрать какие активити будут запущены в результате работы БП "Запуск бизнесс-процесса для Контакта".
Все доступные варианты являются ранее созданными шаблонами БП для сущности данного типа.

ID сущности: в данном пункте указывается ID сущности "Контакт" для которой будут запущены активити, выбранные в п. меню "Бизнесс-процесс".

Параметры для бизнес-процесса: в данном пункте указываются параметры, которые нужно передать в БП.
Заполняется по такому принципу: название параметра: содержимое параметра
Пример ввода параметра: Title:123 
Параметр, указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для компании". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID компании, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID компании).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Запуск бизнес-процесса для Сделки

Данное активити позволяет запускать бизнес-процесс для сущности "Сделка" после выбора необходимых БП из списка.


Бизнес-процесс: в данном поле из выпадающего списка можно выбрать какие активити будут запущены в результате работы БП "Запуск бизнесс-процесса для сделки".
Все доступные варианты являются ранее созданными шаблонами БП для сущности данного типа.

Параметры для бизнес-процесса: в данном пункте указываются параметры, которые нужно передать в БП.
Заполняется по такому принципу: название параметра: содержимое параметра
Пример ввода параметра: Title:123 
Параметр, указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для компании". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID компании, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID компании).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Задание в карточке сущности

Данное активити позволяет добавить поле "Задача" в тело выбранной сущности, тем самым позволяя ставить задания из карточки сущности определенным пользователям.

Сценарий работы активити бизнес-процесса

Тип сущности: в данном пункте указывается тип сущности, в которой появится поле для указания задачи.
ID сущности: в данном поле указывается ID сущности, в которой будет добавлено поле задания.
Файлы: в данном поле указывается публичная ссылка на ресурс, где размещен файл для скачивания. Доступно увеличение количества полей с помощью кнопки "Добавить".

Название	Описание
Разрешить ответственному перепоручить выполнение другому пользователю (Да\Нет):	Позволяет ответственному за сущность перепоручить задание другим пользователям.
Требуется комментарий пользователя? (Да\Нет):	Выберите данный пункт, чтобы в карточке появилось поле для ввода комментария.

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

Название	Описание
Цвет рамки (например #FFFFFF):	Позволяет выбрать цвет рамки вокруг карточки задания, в виде шестнадцатеричного кода палитры.
Включить мигание рамки задания (Да\Нет):	Позволяет активировать мигание рамки задания в карточке сущности.
Заголовок задания:	Позволяет указать заголовок задания.
Содержание задания:	Позволяет указать содержание задания.
Название Кнопки 1:	Позволяет указать название первой кнопки, которая расположена в левом нижнем углу задания.
Цвет текста Кнопки 1 (например #FFFFFF):	Позволяет указать цвет текста в кнопке 1, в виде шестнадцатеричного кода палитры.
Цвет кнопки 1 (например #d2f95f):	Позволяет указать цвет кнопки 1, в виде шестнадцатеричного кода палитры.
Название Кнопки 2:	Позволяет указать название второй кнопки, которая расположена в левом нижнем углу задания, после первой кнопки.
Цвет текста Кнопки 2 (например #FFFFFF):	Позволяет указать цвет текста в кнопке 2, в виде шестнадцатеричного кода палитры.
Цвет кнопки 2 (например #cc1a00):	Позволяет указать цвет кнопки 2, в виде шестнадцатеричного кода палитры.
Название Кнопки 3:	Позволяет указать название третьей кнопки, которая расположена в левом нижнем углу задания.
Цвет текста Кнопки 3 (например #FFFFFF):	Позволяет указать цвет текста в кнопке 3, в виде шестнадцатеричного кода палитры.
Цвет кнопки 3 (например #ff0000):	Позволяет указать цвет кнопки 3, в виде шестнадцатеричного кода палитры.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

ВАЖНО! 
Данное активити не совместимо с одноименным активити из "Лаборатории БП" и самим приложением "Лаборатория БП".
Это значит, что если установлено приложение "Лаборатория БП" и активити "Задание в карточке сущности" из лаборатории БП, то такое же активити из приложения "Лаборатория роботов" работать не будет, до тех пор, пока не будет удалено приложение "Лаборатория БП".

Группы

Добавление группы (проекта)

Данное активити позволяет создавать группу или проект с настройками, указанными в активити.

Название	Описание
Название группы:	в данном поле указывается название группы (проекта)
Владелец группы:	Владельцем группы (проекта) будет тот пользователь, от имени которого произошел запуск активити. Если данный вариант вам не подходит, то в следующем активити можно запустить смену владельца группы (проекта).
Описание группы:	в данном указывается описание группы (проекта)
Видна ли группа в списке:	Выбор из выпадающего списка: да/нет. Позволяет выбрать видна ли группа в списке групп.
Открыта ли группа для свободного вступления:	позволяет открыть и закрыть свободное вступление в группу
Ключевые слова (через запятую):	В данном пункте указываются ключевые слова.
Кто может приглашать пользователей?:	Выбор из выпадающего списка тех, кто может приглашать кого-либо в группу. Это могут быть пользователи, модераторы, владелец группы.
Кто может писать в группу?:	Выбор из выпадающего списка тех, кто может писать в группу. Это могут быть пользователи, модераторы, владелец группы.
Тип группы:	Выбор из выпадающего списка типа группы:обычная группа, либо проект.
Дата старта проекта:	В данном пункте указывается дата начала проекта.
Дата окончания проекта:	В данном пункте указывается дата окончания проекта.
Пригласить пользователей в группу (укажите через точку с запятой):	В данном поле указываются пользователи, которые будут приглашены в группу. Выбор пользователей происходит из выпадающего меню.
Текст приглашения:	В данном пункте указывается текст приглашения, который пользователи получат при приглашении в группу.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
   

Удаление участника(ов) из группы

Данное активити позволяет удалить участника из группы (проекта).


ID рабочей группы: в данном полу указывается ID группы (проекта)

ID пользователя (или массив ID). : в этом поле нужно указать ID пользователя, которого активити удалит из группы (проекта).

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Добавление участника(ов) в группу

Данное активити позволяет добавить участника в группу (проект).


ID рабочей группы: в данном полу указывается ID группы (проекта)

ID пользователя (или массив ID). : в этом поле нужно указать ID пользователя, которого активити добавит в группу.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Поиск группы (проекта)

Данное активити позволяет искать группу или проект с настройками, указанными в активити.

 

Название	Описание
ID рабочей группы:	В этом поле нужно указать ID рабочей группы, если таковая есть.
Код сайта:	В этом поле нужно указать код сайта, если такой используется.
Название группы:	В этом поле нужно ввести название искомой группы.
Описание группы:	В этом поле заполняется текст - описание искомой группы.
Дата создания:	В этом поле нужно выбрать в календаре дату и время создания искомой группы.
Дата последнего изменения параметров группы:	В этом поле нужно выбрать в календаре дату и время последнего изменения параметров искомой группы.
Активность:	Нужно указать активна группа или нет, варианты на выбор: да/нет.
Видима ли группа в списках:	Нужно указать, видима ли искомая группа в списках. Варианты для выбора: да/нет.
Открыта ли группа для свободного вступления:	Нужно указать, открыта искомая группа для свободного вступления или нет. Варианты для выбора: да/нет.
Является ли группа архивной:	Нужно указать, является ли искомая группа архивной (удаленной). Варианты для выбора: да/нет.
Код темы группы:	В этом поле нужно указать код темы группы.
Код пользователя - владельца группы:	В этом поле нужно указать код пользователя, владеющего группой, т.е его ID.
Ключевые слова:	Указываются ключевые слова.
Количество членов группы:	Нужно указать количество членов группы (цифрами).
Кто имеет право на прием в группу новых членов:	Из выпадающего списка нужно выбрать кто имеет права на прием в группу новых членов. Доступно несколько вариантов на выбор:  Владелец группы. Владелец группы и модераторы. Все члены группы.
Кто имеет право на написание сообщений членам группы:	Из выпадающего списка нужно выбрать кто имеет права на написание сообщений членам группы. Доступно несколько вариантов на выбор:  Владелец группы. Владелец группы и модераторы. Все члены группы.
Дата последней активности в группе:	В этом поле нужно выбрать в календаре дату и время последней активности в группе.
Название темы группы:	В этом поле указывают название темы искомой группы (текстом).
Имя владельца группы:	В этом поле указывают имя владельца искомой группы. (текстом).
Фамилия владельца группы:	В этом поле указывают фамилия владельца искомой группы (текстом).
Логин владельца группы:	В этом поле указывают логин владельца искомой группы (текстом).

Делать отладочные сообщения в журнал БП:  в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Возвращаемые параметры данного активити:
- Результат поиска (массив для итератора).
- Результат поиска (строка).
- Количество найденных элементов.
- Соответствует условиям.
- Сообщение об ошибке.

Смена владельца группы (проекта)

Данное активити позволяет сменить владельца группы (проекта).


ID группы: в данном пункте указывается ID группы (проекта, владельца в которой надо сменить).

Владелец группы: в данном пункте указывается новый владелец группы(проекта).

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Изменение группы (проекта)

Данное активити позволяет изменять группу или проект с настройками, указанными в активити.

Название	Описание
ID группы:	В данном пункте указывается ID группы (проекта) в котором будут произведены изменения.
Название группы:	В данном поле указывается название группы (проекта)
Описание группы:	В данном указывается описание группы (проекта)
Видна ли группа в списке:	Выбор из выпадающего списка: да/нет. Позволяет выбрать видна ли группа в списке групп.
Открыта ли группа для свободного вступления:	Позволяет открыть и закрыть свободное вступление в группу
Ключевые слова (через запятую):	В данном пункте указываются ключевые слова.
Кто может приглашать пользователей?:	Выбор из выпадающего списка тех, кто может приглашать кого-либо в группу. Это могут быть пользователи, модераторы, владелец группы.
Кто может писать в группу?:	Выбор из выпадающего списка тех, кто может писать в группу. Это могут быть пользователи, модераторы, владелец группы.
Тип группы:	Выбор из выпадающего списка типа группы:обычная группа, либо проект.
Дата старта проекта:	В данном пункте указывается дата начала проекта.
Дата окончания проекта:	В данном пункте указывается дата окончания проекта.
Пригласить пользователей в группу (укажите через точку с запятой):	В данном поле указываются пользователи, которые будут приглашены в группу. Выбор пользователей происходит из выпадающего меню.
Текст приглашения:	В данном пункте указывается текст приглашения, который пользователи получат при приглашении в группу.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Дата, время и календарь

Удаление события календаря

Данное активити позволяет удалить событие в календаре, ID которого вы укажите в настройках.

Сценарий работы активити бизнес-процесса

Тип календаря: в данном поле можно выбрать из выпадающего списка тип календаря:пользовательский/для групп.

Идентификатор владельца календаря: в данном поле указывается ID владельца календаря.

Идентификатор события: в данном поле указывается ID события, которое планируется изменить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Изменение события календаря

Данное активити позволяет изменять события календаря, ID которого вы укажите в настройках.

Название	Описание
ID события:	В данном поле указывается ID события, которое планируется изменить.
Тип календаря:	В данном поле можно выбрать из выпадающего списка тип календаря:пользовательский/для групп.
Идентификатор владельца календаря:	В данном поле указывается ID владельца календаря.
Дата начала события:	В данном поле указывается дата начала изменяемого события
Дата завершения события:	В данном поле указывается дата завершения изменяемого события
Идентификатор календаря:	В данном поле указывается ID календаря, который планируется изменить.

Название	Описание
Наименование события:	В данном поле указывается наименование изменяемого события.
Описание события:	В данном поле указывается описание изменяемого события.
Цвет фона события:	В данном поле указывается цвет фона изменяемого события в формате HTML.
Цвет текста события:	В данном поле указывается цвет текста изменяемого события в формате HTML.
Доступность на время события:	В данном поле указывается доступность на время события участника этого события.
Важность события:	В данном поле указывается важность изменяемого события.
Место проведения:	В данном поле указывается место проведения изменяемого события.
НАПОМИНАНИЕ (за сколько):	В данном поле указывается напоминание (за сколько) для изменяемого события.
НАПОМИНАНИЕ (единица измерения):	В данном поле указывается напоминание (единица измерения) для изменяемого события .

Список участников события: в поле указываются участники создаваемого события.
Поле является множественным.
Значение указывается через контекстное меню, либо в ручную в формате: Администратор KOSAS [1234].

Название	Описание
Организатор события:	В данном поле указывается организатор события, указывается его ID или данный пользователь выбирается из списка пользователей портала.
Создать встречу:	Варианты: да/нет. Позволяет параллельно измененному событию создать встречу.
ВСТРЕЧА: Текст приглашения:	В данном поле указывается текст приглашения для встречи.
ВСТРЕЧА: признак открытой встречи:	В данном поле указывается, будет - ли открыта встреча или нет.
ВСТРЕЧА: флаг оповещения о подтверждении\отказе участников:	В данном поле указывается наличие флага оповещения об отказе или согласии участников, приглашенных на встречу.
ВСТРЕЧА: флаг запроса повторного подтверждения участия (при редактировании события):	В данном поле указывается флаг для повторного подтверждения об повторном подтверждении участия в событии.
Делать отладочные сообщения в журнал БП:	В данном поле указывается, будет ли сделано отладочное сообщение в журнале БП или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Добавить событие календаря

Данное активити позволяет добавлять события в календарь, ID которого вы укажите в настройках.

Тип календаря: в данном поле нужно выбрать тип календаря. Это может быть календарь сотрудника (user), календарь группы (group) либо календарь Компании (company).

Идентификатор владельца календаря: в данном поле следует указывать id сотрудника, либо id группы (ID группы указывается именно цифрой и никак иначе).
Значение указывается простой цифрой (без квадратных скобок). 

Дата начала события: в данном поле требуется указать, когда начнётся планируемое событие.

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

Идентификатор календаря: в данном поле требуется указать id календаря пользователя, группы, компании или переговорной комнаты.

Чтобы понять, какое значение сюда требуется прописать, необходимо:

1. Для календаря пользователя (или Компании).
Перейдите в список календарей и нажмите "Настройки"

Далее необходимо нажать F12 в браузере и навести курсор на список календарей выбора по умолчанию для приглашений.

2. Для календаря группы.
Перейдите в календарь группы и нажмите F12.
Нажмите на инструмент выбора блока и наведите на календарь.

В классе bxec-sect: содержится id календаря.

Значение даты передается без времени: эта опция позволит устанавливать даты события без указания времени.

Наименование события: в данном поле вы указываете тему создаваемого события.

Описание события: в данном поле вы указываете текстовое описание создаваемого события.

Цвет фона события: в данном поле вы указываете цвет создаваемого события в календаре. Применяется код цвета HTML.

Доступность на время события: в данном поле вы определяете отметку занятости, которая будет отображаться в планировщике событий.

Важность события: в данном поле вы можете выбрать категорию важности создаваемого события в календаре.

Частное событие: при указании значения "да" в данном поле, Вы ограничиваете видимость содержания создаваемого события. В календаре будет отображаться что событие есть, но прочесть другим сотрудникам его не получится.

Место проведения: в данном поле вы можете указать место проведения создаваемого события.
Данные заполняются текстом.

НАПОМИНАНИЕ (за сколько): в данном поле вы можете указать, что система должна Вас уведомить за какое-то время. Значение указывается в целых числах.

НАПОМИНАНИЕ (единица измерения): в данном поле вы можете указать, в каких единицах измерения вести отсчет времени до напоминания (дни, часы, минуты)

Список участников события: в данном поле указываются участники создаваемого события. Поле является множественным. Значение указывается через контекстное меню, либо в ручную в формате: Администратор KOSAS [1234].

Организатор события: в данном поле указывается организатор создаваемого события.  Значение указывается простой цифрой (без квадратных скобок). Это поле важно заполнять, когда это событие календаря типа встреча и в него будут приглашаться другие участники.
Создать встречу: данное поле позволяет создавать событие тип встреча, на которую приглашаются участники.

ВСТРЕЧА: Текст приглашения - в данном поле указывается описание для события типа встреча.

ВСТРЕЧА: признак открытой встречи - в данном поле указывается тип события. Встреча может быть общедоступная или закрытая.

ВСТРЕЧА: флаг оповещения о подтверждении\отказе участников - данная опция позволит (с помощью системного механизма Битрикс24) отправить оповещение о событии.

ВСТРЕЧА: флаг запроса повторного подтверждения участия (при редактировании события) - в данной опции (с помощью системного механизма Битрикс24) указывается необходимость повторно уведомлять участников события если в него будут вноситься изменения.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Получить список календарей

Данное активити позволяет получить идентификаторы календарей Пользователя, Групп, Компании и Переговорных комнат.


Тип календаря: позволяет выбрать из списка тип календаря, ID которого необходимо получить.
Доступны следующие варианты календарей:

• Календарь пользователя;
• Календарь группы;
• Календарь компании;
• Календарь переговорной комнаты.

Идентификатор владельца календаря: в этом поле нужно указать ID владельца календаря.
Ограничить количество результатов до: позволяет указать количество выводимых результатов до указанного значения.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Ближайший день недели

Данное активити позволяет задавать повторение какого-либо процесса заранее заданный промежуток дня/времени с помощью возврата параметра день недели/время либо другого указанного параметра. 
Т.е если сегодня четверг 21.02, то выставив в параметре "День недели (условие)": 6 , мы получим 6й день недели относительно текущей недели, т.е субботу 23.02. Однако если выставить в четверг 21.02 , значение параметра "День недели (условие)" 2, то мы получим вторник 26.02,т.е дату, расположенную на следующей неделе.

День недели (условие):   1: понедельник, 2: вторник, 3: среда, 4: четверг, 5: пятница, 6: суббота, 7: воскресенье.

Дата для расчета: в этом поле указывается дата для расчета ближайшего дня недели. Дата указывается в формате ДД.ММ.ГГГГ.
Если в сущности, в поле тип "дата и время" указано время, то в активити поле "Время" можно не заполнять.
Если в  сущности, в поле тип "дата и время" время не указано, т.е по умолчанию 00:00:00, то нужно заполнить поле "Время" в настройках активити, иначе вы получите результат (к примеру) 23,04,2021 00:00:00.

Время: Указывается время к которому будет возвращено ближайшее значение ближайшего дня недели, в формате ЧЧ:ММ.
Например: 11:00.
Если не корректно заполнить данное поле, то активити вернет в результатах не корректные данные.

Часовой пояс: указывается часовой пояс, используемый в пункте "Время", в формате "+3".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Ближайший день месяца

Данное активити позволяет задавать повторение какого-либо процесса в определенный промежуток дня/времени с помощью возврата параметра день месяца/время либо другого указанного параметра. 

День месяца (условие): Позволяет выбрать из выпадающего списка нужный день месяца. Выбрав 1: первое число месяца, 15: пятнадцатое число месяца.

Время: Указывается время к которому будет возвращено ближайшее значение ближайшего дня месяца, в формате ЧЧ:ММ.
Например: 11:00.
Если не корректно заполнить данное поле, то активити вернет в результатах не корректные данные.

Часовой пояс: указывается часовой пояс, используемый в пункте "Время", в формате "+3"

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Дела

Системные дела

Добавление привязки к CRM сущности

Позволяет добавить привязку к сущностям CRM

Сценарий работы активити бизнес-процесса

Идентификатор дела: в данном поле нужно указать ID дела, которое будет привязано к сущности CRM.

Идентификатор типа CRM сущности: в этом поле нужно выбрать из выпадающего списка тип сущности, к которой будет осуществлена привязка. Этот список содержит список сущностей, к которым дело всегда имеет привязку. Для привязки дела к некоторым дополнительным типам сущностей, необходимо иметь привязку к основным. 

Идентификатор CRM сущности: в данном поле указывается ID CRM сущности к которой будет привязано дело.

Идентификатор типа CRM сущности 2: это поле, в отличии от поля "Идентификатор типа CRM сущности" имеет меньше вариантов в выпадающем списке в виду того, что в данном поле выбирается дополнительная сущность для привязки, т.е оно не обязательно к заполнению.

Идентификатор CRM сущности 2: в этом поле указывается ID второй CRM сущности, к которой дело будет привязано.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Создание своего дела в CRM

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

• Автоматическое создание дел при изменении статуса сделки или лида;
• Создание напоминаний и задач для ответственных сотрудников;
• Автоматизация планирования дел на основе данных из других сущностей CRM;
• Создание дел при поступлении заявок или обращений клиентов;
• Планирование дел с привязкой к сделкам, контактам, компаниям или смарт-процессам;
• Автоматическое создание дел для контроля выполнения обязательств;
• Создание дел для напоминаний о важных событиях и дедлайнах;
• Автоматизация создания дел при интеграции с внешними системами;
• Создание дел для отслеживания этапов работы с клиентами;
• Планирование регулярных дел и напоминаний.

Название поля	Описание и примеры использования
Тип сущности	В данном поле указывается тип сущности, к которой будет привязано создаваемое дело. Это обязательный параметр. Варианты выбора: - 1 - Лид (CRM_LEAD); - 2 - Сделка (CRM_DEAL); - 3 - Контакт (CRM_CONTACT); - 4 - Компания (CRM_COMPANY); - Смарт-процессы - для привязки к смарт-процессам (требует указания конкретного смарт-процесса в поле "Смарт-процессы"). Примеры использования: - Для создания дела, привязанного к сделке, выберите значение "2"; - Для создания дела, привязанного к лиду, выберите значение "1"; - При выборе "Смарт-процессы" необходимо дополнительно указать конкретный смарт-процесс в поле "Смарт-процессы".
Смарт-процессы	В данном поле указывается конкретный смарт-процесс, к которому будет привязано дело. Это необязательный параметр, который используется только при выборе типа сущности "Смарт-процессы". Важно: Это поле активно только при выборе типа сущности "Смарт-процессы". Для обычных CRM-сущностей (лид, сделка, контакт, компания) это поле не используется. Примеры: - Выберите нужный смарт-процесс из выпадающего списка (список формируется автоматически на основе настроек вашего портала); - Список доступных смарт-процессов загружается автоматически при установке активити (робота).
ID Сущности	В данном поле указывается числовой идентификатор (ID) сущности, к которой будет привязано создаваемое дело. Это обязательный параметр. Примеры: - {=Document:ID} - привязать дело к текущей сущности из документа (сделка, лид, контакт, компания); - 123 - привязать дело к сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой.
Заголовок дела	В данном поле указывается текстовый заголовок создаваемого дела. Это обязательный параметр. Примеры: - Позвонить клиенту; - Подготовить коммерческое предложение для сделки #{=Document:ID}; - Встреча с {=Document:COMPANY_TITLE} - {=Variable:MEETING_DATE}; - Напоминание: оплата по сделке {=Document:TITLE}; - ={{={=Variable:SUBJECT} & " - Дополнительная информация"}} - добавить информацию к заголовку из переменной. Рекомендации: - Используйте информативные заголовки, которые помогут быстро понять суть дела; - Можно включать переменные и поля из текущей сущности для персонализации; - Максимальная длина заголовка ограничена настройками CRM вашего портала.
Содержание дела	В данном поле указывается содержание и описание создаваемого дела. Это обязательный параметр. Поддерживается форматирование BB-код. Примеры: - Необходимо связаться с клиентом для уточнения деталей сделки; - [b]Важно:[/b] Проверить документы по сделке #{=Document:ID}. Сумма: {=Document:OPPORTUNITY} руб.; - Подготовить договор для компании {=Document:COMPANY_TITLE}. Контактное лицо: {=Document:CONTACT_NAME}; - ={{={=Variable:DESCRIPTION} & "[br]Дополнительная информация: " & {=Variable:ADDITIONAL_INFO}}}} - объединить несколько переменных с форматированием; - [url={=System:HostUrl}/crm/deal/details/{=Document:ID}/]Ссылка на сделку[/url] - добавить ссылку на сущность. Форматирование BB-код: - [b]жирный текст[/b] - жирное начертание; - [i]курсив[/i] - курсивное начертание; - [u]подчёркнутый[/u] - подчёркнутый текст; - [br] - перенос строки; - [url=ссылка]текст[/url] - ссылка. Важно: Если поле "Содержание дела" пустое, активити (робот) завершится с ошибкой. Обязательно укажите описание дела.
Дата начала	В данном поле указывается дата и время начала выполнения дела. Это необязательный параметр. Если не указано, дата начала будет установлена автоматически. Примеры: - {=System:NowLocal} - установить текущую дату и время; - ={{=dateadd({=System:Now}, "1d")}} - установить дату начала через 1 день от текущего момента; - ={{=workdateadd({=System:Now}, "2d", {=Document:ASSIGNED_BY_ID})}} - установить дату начала через 2 рабочих дня с учётом рабочего времени ответственного; - ={{=dateadd({=Document:BEGINDATE}, "1h")}} - установить дату начала через 1 час от даты начала сделки; - 15.01.2025 10:00:00 - указать конкретную дату и время. Рекомендации: - Используйте функции работы с датами для автоматического расчёта времени начала; - Учитывайте рабочие дни и часы при планировании дел; - Если дата начала не указана, система установит текущую дату и время.
Дата завершения	В данном поле указывается дата и время завершения выполнения дела. Это необязательный параметр. Если не указано, дата завершения не будет установлена. Примеры: - ={{=dateadd({=System:Now}, "3d")}} - установить дату завершения через 3 дня от текущего момента; - ={{=workdateadd({=System:Now}, "5d", {=Document:ASSIGNED_BY_ID})}} - установить дату завершения через 5 рабочих дней с учётом рабочего времени ответственного; - ={{=dateadd({=Variable:DATE_START}, "2h")}} - установить дату завершения через 2 часа от даты начала (из переменной); - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}} - установить дату завершения на 1 день раньше даты закрытия сделки; - 20.01.2025 18:00:00 - указать конкретную дату и время завершения. Рекомендации: - Дата завершения должна быть позже даты начала; - Используйте функции работы с датами для автоматического расчёта дедлайнов; - Учитывайте рабочие дни при планировании сроков выполнения дел.
Ответственный за дело	В данном поле указывается сотрудник, который должен выполнить дело и отчитаться о проделанной работе. Это обязательный параметр. Выбирается из выпадающего списка или указывается вручную. Форматы указания пользователя: - Числовой ID: 1, 25, 100; - Формат с префиксом: [U1], [U25]; - Формат user_ID: user_1, user_25; - Можно использовать переменные из предыдущих активити (роботов) или полей сущности. Примеры: - {=Document:ASSIGNED_BY_ID} - назначить ответственного из текущей сущности (сделки, лида и т.д.); - [U1] - назначить пользователя с ID 1; - user_25 - назначить пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота); - {=User:ID} - назначить текущего пользователя, запустившего бизнес-процесс. Как получить ID пользователя: - Из полей CRM-сущностей (ответственный, контакт и т.д.); - Из результатов активити (робота) поиска пользователей; - Использовать текущего пользователя через системные переменные ({=User:ID}); - Из справочника сотрудников портала.
Важное дело	В данном поле указывается статус, уведомляющий о том, что выполнение данного дела в приоритете. Это необязательный параметр (варианты: да/нет). Варианты выбора: - Да (Y) - дело помечается как важное (высокий приоритет); - Нет (N) - дело имеет обычный приоритет. Примеры использования: - Установите "Да" для дел, требующих срочного выполнения; - Используйте условие: если {=Document:OPPORTUNITY} > 1000000, то установить "Да"; - Важные дела отображаются с особым выделением в интерфейсе CRM и имеют приоритет в уведомлениях. Рекомендации: - Не помечайте все дела как важные, иначе теряется смысл приоритизации; - Используйте важные дела для критических задач и дедлайнов.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Создание дела для ответственного при изменении стадии сделки	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Заголовок дела - "Проверить документы по сделке #{=Document:ID}", Содержание дела - "Сделка переведена на стадию 'Выставлен счёт'. Необходимо проверить все документы. Сумма: {=Document:OPPORTUNITY} руб.", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "1d")}}, Важное дело - Да.
Создание напоминания о звонке клиенту через 2 рабочих дня	Параметры: Тип сущности - 3 (Контакт), ID Сущности - {=Document:ID}, Заголовок дела - "Позвонить клиенту {=Document:NAME}", Содержание дела - "Необходимо связаться с клиентом для уточнения деталей. Телефон: {=Document:PHONE}", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - ={{=workdateadd({=System:Now}, "2d", {=Document:ASSIGNED_BY_ID})}}, Дата завершения - ={{=workdateadd({=System:Now}, "2d 2h", {=Document:ASSIGNED_BY_ID})}}, Важное дело - Нет.
Создание важного дела для подготовки коммерческого предложения	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Заголовок дела - "Подготовить КП для сделки {=Document:TITLE}", Содержание дела - "[b]Важно:[/b] Необходимо подготовить коммерческое предложение для компании {=Document:COMPANY_TITLE}. Сумма сделки: {=Document:OPPORTUNITY} руб. Срок: до {=Document:CLOSEDATE}", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=Document:CLOSEDATE}, "-3d")}}, Важное дело - Да.
Создание дела для встречи с клиентом на основе данных из лида	Параметры: Тип сущности - 1 (Лид), ID Сущности - {=Document:ID}, Заголовок дела - "Встреча с клиентом {=Document:TITLE}", Содержание дела - "Запланирована встреча с клиентом. Компания: {=Document:COMPANY_TITLE}, Контакт: {=Document:NAME}, Телефон: {=Document:PHONE}. Адрес встречи: {=Variable:MEETING_ADDRESS}", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - {=Variable:MEETING_DATE}, Дата завершения - ={{=dateadd({=Variable:MEETING_DATE}, "2h")}}, Важное дело - Да.
Автоматическое создание дела при поступлении заявки с сайта	Параметры: Тип сущности - 1 (Лид), ID Сущности - {=Document:ID}, Заголовок дела - "Обработка заявки #{=Document:ID}", Содержание дела - "Поступила новая заявка с сайта. Источник: {=Document:SOURCE_ID}. [url={=System:HostUrl}/crm/lead/details/{=Document:ID}/]Открыть лид[/url]", Ответственный за дело - {=Variable:MANAGER_ID}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "4h")}}, Важное дело - Да.
Создание дела для контроля оплаты по сделке	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Заголовок дела - "Контроль оплаты по сделке {=Document:TITLE}", Содержание дела - "Необходимо проверить оплату по сделке. Сумма: {=Document:OPPORTUNITY} руб. Компания: {=Document:COMPANY_TITLE}. Дата закрытия: {=Document:CLOSEDATE}", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - ={{=dateadd({=Document:CLOSEDATE}, "1d")}}, Дата завершения - ={{=dateadd({=Document:CLOSEDATE}, "2d")}}, Важное дело - Да.
Создание дела для подготовки отчёта по компании	Параметры: Тип сущности - 4 (Компания), ID Сущности - {=Document:ID}, Заголовок дела - "Подготовить отчёт по компании {=Document:TITLE}", Содержание дела - "Требуется подготовить отчёт по работе с компанией. Количество сделок: {=Variable:DEALS_COUNT}, Общая сумма: {=Variable:TOTAL_AMOUNT} руб.", Ответственный за дело - {=Variable:REPORT_MANAGER_ID}, Дата начала - ={{=dateadd({=System:Now}, "1d")}}, Дата завершения - ={{=dateadd({=System:Now}, "3d")}}, Важное дело - Нет.
Создание дела для напоминания о дедлайне задачи	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Variable:DEAL_ID}, Заголовок дела - "Напоминание: дедлайн задачи", Содержание дела - "До дедлайна задачи '{=Variable:TASK_TITLE}' осталось менее 24 часов. Ответственный: {=Variable:TASK_RESPONSIBLE}", Ответственный за дело - {=Variable:TASK_RESPONSIBLE}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=Variable:TASK_DEADLINE}, "-1d")}}, Важное дело - Да.
Создание дела для смарт-процесса при изменении статуса	Параметры: Тип сущности - Смарт-процессы, Смарт-процессы - {=Variable:SMART_TYPE}, ID Сущности - {=Document:ID}, Заголовок дела - "Обработка элемента смарт-процесса", Содержание дела - "Элемент смарт-процесса переведён в новый статус. Требуется обработка. [url={=System:HostUrl}/crm/configs/bp/CRM_DYNAMIC_{=Variable:SMART_TYPE}/{=Document:ID}/]Открыть элемент[/url]", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "1d")}}, Важное дело - Нет.
Массовое создание дел для всех найденных сделок через итератор	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Iterator:Value}, Заголовок дела - "Контроль сделки #{=Iterator:Value}", Содержание дела - "Создано дело для контроля сделки. Необходимо проверить статус и связаться с клиентом.", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "7d")}}, Важное дело - Нет.

Удаление дела

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

• Удаление дел по их ID;
• Удаление дел по типу сущности и ID сущности;
• Удаление дел по типу провайдера (звонок, письмо, встреча и т.д.);
• Удаление дел по ответственному за дело;
• Массовое удаление дел, соответствующих определённым критериям;
• Очистка старых или неактуальных дел;
• Удаление дел после выполнения определённых условий в бизнес-процессе;
• Автоматическое удаление дел при изменении статуса сделки или лида;
• Удаление дел при интеграции с внешними системами;
• Очистка дел для оптимизации работы с CRM.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела или несколько идентификаторов дел, которые нужно удалить. Это необязательный параметр, поддерживается множественный выбор. Если указан, то все остальные параметры игнорируются (приоритет у ID дела). Примеры: - {=Variable:ACTIVITY_ID} - удалить дело с ID из переменной предыдущего активити (робота); - 123 - удалить дело с ID 123; - {=A1988_22222_92566_99999:search_results_array} - использовать массив ID дел из результата активити (робота) "Поиск дел"; - {=Iterator:Value} - удалить дело для каждого ID из итератора; - 123, 456, 789 - удалить несколько дел с указанными ID (множественный выбор). Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если указан параметр "ID дела", то все остальные параметры (Тип сущности, ID сущности, Тип дела, Ответственный за дело) игнорируются. Активити (робот) будет удалять только указанные дела.
Ответственный за дело	В данном поле указывается сотрудник, дела которого нужно удалить. Это необязательный параметр, используется как дополнительный фильтр при удалении дел по типу сущности и ID сущности. Если указан, то будут удалены только дела указанного ответственного. Примеры: - {=Document:ASSIGNED_BY_ID} - удалить дела ответственного из текущей сущности; - {=User:ID} - удалить дела текущего пользователя; - [U1] - удалить дела пользователя с ID 1; - user_25 - удалить дела пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации дел по ответственному при удалении по типу сущности; - Для удаления всех дел конкретного сотрудника, связанных с определённой сущностью; - Для очистки дел при смене ответственного. Важно: Этот параметр работает только если не указан параметр "ID дела". Если указан "ID дела", этот параметр игнорируется. Для задач (OWNER_TYPE_ID = 3) фильтр по ответственному не применяется.
Тип сущности	В данном поле указывается тип сущности CRM, дела которой нужно удалить. Это необязательный параметр, используется только если не указан "ID дела". Выбирается из выпадающего списка. Варианты выбора: - Лид (L) - для удаления дел, привязанных к лидам; - Сделка (D) - для удаления дел, привязанных к сделкам; - Контакт (C) - для удаления дел, привязанных к контактам; - Компания (CO) - для удаления дел, привязанных к компаниям; - Предложение (Q) - для удаления дел, привязанных к предложениям; - Заказ (O) - для удаления дел, привязанных к заказам; - Счёт (SI) - для удаления дел, привязанных к счетам; - СМАРТ: [название смарт-процесса] - для удаления дел, привязанных к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - Сделка (D) - удалить все дела, привязанные к сделкам; - Контакт (C) - удалить все дела, привязанные к контактам; - СМАРТ: Заявки - удалить все дела, привязанные к смарт-процессу "Заявки". Когда использовать: - Для массового удаления дел по типу сущности; - Для очистки дел при удалении сущности; - Для фильтрации дел перед удалением по другим критериям.
ID сущности	В данном поле указывается идентификатор сущности CRM, дела которой нужно удалить. Это необязательный параметр, используется только если указан "Тип сущности" и не указан "ID дела". Примеры: - {=Document:ID} - удалить дела текущей сущности из документа (сделка, лид, контакт, компания); - 123 - удалить дела сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Когда использовать: - Для удаления всех дел конкретной сущности; - Для очистки дел при удалении или изменении сущности; - Для удаления дел при завершении работы с сущностью.
Тип дела (провайдера)	В данном поле указывается тип дела (провайдера), который нужно удалить. Это необязательный параметр, используется как дополнительный фильтр при удалении дел по типу сущности и ID сущности. Выбирается из выпадающего списка. Варианты выбора: - Универсальное (CRM_TODO) - универсальные дела; - Встреча (CRM_MEETING) - дела типа "Встреча"; - Звонок (VOXIMPLANT_CALL) - дела типа "Звонок"; - Письмо (CRM_EMAIL) - дела типа "Письмо"; - Задачи (TASKS) - задачи (старые дела для обратной совместимости); - Задача (новая) (CRM_TASKS_TASK) - задачи в новой реализации; - Чат (IMOPENLINES_SESSION) - дела типа "Чат"; - Обзвон (CALL_LIST) - дела типа "Обзвон"; - SMS (CRM_SMS) - дела типа "SMS"; - CRM форма (CRM_WEBFORM) - дела типа "CRM форма"; - Визит (VISIT_TRACKER) - дела типа "Визит"; - Слоты (CRM_CALENDAR_SHARING) - дела типа "Слоты"; - Доставка (CRM_DELIVERY) - дела типа "Доставка"; - Документ подписания (CRM_SIGN_DOCUMENT) - дела типа "Документ подписания"; - Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION) - дела типа "Сообщение в WhatsApp"; - Оплата (CRM_PAYMENT) - дела типа "Оплата"; - Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW) - дела типа "Дело бизнес-процесса"; - И другие типы дел. Примеры использования: - Звонок - удалить только дела типа "Звонок"; - Письмо - удалить только дела типа "Письмо"; - Встреча - удалить только дела типа "Встреча". Когда использовать: - Для фильтрации дел по типу при удалении по сущности; - Для удаления только определённого типа дел; - Для очистки дел конкретного типа.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Удаление одного дела по ID	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности - не указывается, ID сущности - не указывается, Тип дела - не указывается, Ответственный за дело - не указывается. Активити (робот) удалит дело с указанным ID.
Массовое удаление дел из результата поиска	Параметры: ID дела - {=A1988_22222_92566_99999:search_results_array}, Тип сущности - не указывается, ID сущности - не указывается, Тип дела - не указывается, Ответственный за дело - не указывается. Активити (робот) удалит все дела из массива результатов поиска. Используйте итератор для обработки большого количества дел.
Удаление всех дел сделки	Параметры: ID дела - не указывается, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Тип дела - не указывается, Ответственный за дело - не указывается. Активити (робот) найдёт и удалит все дела, привязанные к указанной сделке.
Удаление только звонков контакта	Параметры: ID дела - не указывается, Тип сущности - Контакт (C), ID сущности - {=Document:ID}, Тип дела - Звонок (VOXIMPLANT_CALL), Ответственный за дело - не указывается. Активити (робот) найдёт и удалит только дела типа "Звонок", привязанные к указанному контакту.
Удаление дел ответственного по сделке	Параметры: ID дела - не указывается, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Тип дела - не указывается, Ответственный за дело - {=Document:ASSIGNED_BY_ID}. Активити (робот) найдёт и удалит все дела указанного ответственного, привязанные к сделке.
Удаление дел через итератор	Параметры: ID дела - {=Iterator:Value}, Тип сущности - не указывается, ID сущности - не указывается, Тип дела - не указывается, Ответственный за дело - не указывается. Для каждого ID дела из итератора активити (робот) удалит соответствующее дело. Полезно для массовой обработки.
Удаление нескольких конкретных дел	Параметры: ID дела - 123, 456, 789 (множественный выбор), Тип сущности - не указывается, ID сущности - не указывается, Тип дела - не указывается, Ответственный за дело - не указывается. Активити (робот) удалит все указанные дела за один запуск.
Удаление всех писем лида	Параметры: ID дела - не указывается, Тип сущности - Лид (L), ID сущности - {=Document:ID}, Тип дела - Письмо (CRM_EMAIL), Ответственный за дело - не указывается. Активити (робот) найдёт и удалит все дела типа "Письмо", привязанные к указанному лиду.
Удаление дел смарт-процесса	Параметры: ID дела - не указывается, Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}, Тип дела - не указывается, Ответственный за дело - не указывается. Активити (робот) найдёт и удалит все дела, привязанные к указанному элементу смарт-процесса.
Очистка дел при удалении сущности	Параметры: ID дела - не указывается, Тип сущности - {=Variable:ENTITY_TYPE}, ID сущности - {=Variable:ENTITY_ID}, Тип дела - не указывается, Ответственный за дело - не указывается. Используйте перед удалением сущности для очистки всех связанных дел.

Завершение дел

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

• Автоматическое закрытие выполненных дел после завершения бизнес-процесса;
• Массовое закрытие дел по определённым критериям;
• Закрытие всех дел, назначенных конкретному ответственному;
• Автоматизация очистки завершённых задач и дел;
• Закрытие дел после выполнения определённых условий в бизнес-процессе;
• Очистка старых неактуальных дел;
• Автоматическое закрытие дел при изменении статуса сделки или лида;
• Закрытие дел после получения подтверждения выполнения;
• Автоматизация закрытия дел при интеграции с внешними системами;
• Массовое закрытие дел для оптимизации работы с CRM.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела или несколько идентификаторов дел, которые нужно закрыть. Это необязательный параметр, поддерживается множественный выбор. Если указан, то будут закрыты только указанные дела. Если не указан, но указан параметр "Ответственный", то будут закрыты все дела указанного ответственного. Примеры: - {=Variable:ACTIVITY_ID} - закрыть дело с ID из переменной предыдущего активити (робота); - 123 - закрыть дело с ID 123; - {=A1988_22222_92566_99999:search_results_array} - использовать массив ID дел из результата активити (робота) "Поиск дел"; - {=Iterator:Value} - закрыть дело для каждого ID из итератора; - 123, 456, 789 - закрыть несколько дел с указанными ID (множественный выбор). Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если указан параметр "ID дела", то параметр "Ответственный" игнорируется. Для закрытия дел по ответственному необходимо оставить поле "ID дела" пустым.
Ответственный	В данном поле указывается сотрудник, все дела которого нужно закрыть. Это необязательный параметр, используется только если не указан параметр "ID дела". Если указан, то будут закрыты все дела указанного ответственного. Примеры: - {=Document:ASSIGNED_BY_ID} - закрыть все дела ответственного из текущей сущности; - {=User:ID} - закрыть все дела текущего пользователя; - [U1] - закрыть все дела пользователя с ID 1; - user_25 - закрыть все дела пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для массового закрытия всех дел конкретного сотрудника; - Для автоматической очистки дел при смене ответственного; - Для закрытия всех дел при завершении работы сотрудника над проектом. Важно: Этот параметр работает только если не указан параметр "ID дела". Если указаны оба параметра, приоритет имеет параметр "ID дела".
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Закрытие одного дела по ID	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ответственный - не указывается. Активити (робот) закроет дело с указанным ID, установив флаг COMPLETED = 'Y'.
Массовое закрытие дел из результата поиска	Параметры: ID дела - {=A1988_22222_92566_99999:search_results_array}, Ответственный - не указывается. Активити (робот) закроет все дела из массива результатов поиска. Используйте итератор для обработки большого количества дел.
Закрытие всех дел ответственного сотрудника	Параметры: ID дела - не указывается, Ответственный - {=Document:ASSIGNED_BY_ID}. Активити (робот) найдёт и закроет все дела указанного ответственного сотрудника.
Закрытие дел после выполнения условия	Параметры: ID дела - {=Variable:COMPLETED_ACTIVITY_ID}, Ответственный - не указывается. Используйте в условии: если дело выполнено, то закрыть его через данное активити (робот).
Автоматическое закрытие дел при изменении статуса сделки	Параметры: ID дела - {=Variable:DEAL_ACTIVITY_ID}, Ответственный - не указывается. Используйте в бизнес-процессе сделки: при переводе сделки в статус "Закрыта" автоматически закрыть связанные дела.
Закрытие дел через итератор	Параметры: ID дела - {=Iterator:Value}, Ответственный - не указывается. Для каждого ID дела из итератора активити (робот) закроет соответствующее дело. Полезно для массовой обработки.
Закрытие нескольких конкретных дел	Параметры: ID дела - 123, 456, 789 (множественный выбор), Ответственный - не указывается. Активити (робот) закроет все указанные дела за один запуск.
Очистка дел текущего пользователя	Параметры: ID дела - не указывается, Ответственный - {=User:ID}. Активити (робот) закроет все дела текущего пользователя, запустившего бизнес-процесс.
Закрытие дел после получения подтверждения	Параметры: ID дела - {=Variable:CONFIRMED_ACTIVITY_ID}, Ответственный - не указывается. Используйте после активити (робота) получения подтверждения: если подтверждение получено, закрыть дело.
Массовое закрытие дел при завершении проекта	Параметры: ID дела - не указывается, Ответственный - {=Variable:PROJECT_MANAGER_ID}. При завершении проекта закрыть все дела менеджера проекта.

Получение параметров дела

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

• Получение всех данных дела по его ID для дальнейшей обработки;
• Извлечение конкретных полей дела (тема, описание, ответственный и т.д.);
• Получение информации о файлах, прикреплённых к делу;
• Получение ссылок на файлы для скачивания или просмотра;
• Проверка статуса и параметров дела перед выполнением операций;
• Извлечение данных дела для использования в других активити (роботах);
• Получение информации о записях звонков (ссылки на файлы записей);
• Автоматизация обработки данных дел в бизнес-процессах;
• Получение данных дела для аналитики и отчётности;
• Извлечение данных дела для интеграции с внешними системами.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, данные которого нужно получить. Это обязательный параметр. Если указан массив ID, будет обработан только первый элемент массива. Примеры: - {=Variable:ACTIVITY_ID} - получить данные дела с ID из переменной предыдущего активити (робота); - 123 - получить данные дела с ID 123; - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска дел; - {=Document:ID} - получить данные дела, если ID дела совпадает с ID документа; - {=Iterator:Value} - получить данные дела для каждого ID из итератора. Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если дело с указанным ID не существует, активити (робот) завершится с ошибкой "Дело с указанным ID не найдено". Всегда проверяйте существование дела перед получением данных.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Получение всех данных дела по ID	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Активити (робот) вернёт все доступные поля дела: ID, тема, описание, ответственный, даты создания и завершения, статус, тип дела и другие поля. Все данные будут доступны в возвращаемых параметрах активити (робота).
Получение данных дела из результата поиска	Параметры: ID дела - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) получит данные первого дела из результата поиска. Используйте для обработки найденных дел.
Получение информации о файлах дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Активити (робот) вернёт информацию о всех файлах, прикреплённых к делу: ID файлов (ids_files_url), ссылки для просмотра (array_files_url), ссылки для скачивания (array_files_load). Используйте массивы для итерации по файлам.
Получение ссылки на запись звонка	Параметры: ID дела - {=Variable:CALL_ACTIVITY_ID}. Активити (робот) вернёт ссылку на запись звонка в параметре file_url и ID файла записи в параметре file_id. Используйте для прослушивания записей звонков.
Проверка статуса дела перед выполнением операции	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Используйте возвращаемый параметр COMPLETED для проверки статуса дела (Y - выполнено, N - не выполнено) перед выполнением операций с делом.
Извлечение данных дела для использования в других активити	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Получите данные дела и используйте их в следующих активити (роботах). Например, используйте SUBJECT для создания нового дела или DESCRIPTION для отправки письма.
Получение данных дела через итератор	Параметры: ID дела - {=Iterator:Value}. Для каждого ID дела из итератора активити (робот) получит данные соответствующего дела. Полезно для массовой обработки дел.
Получение информации о ответственном за дело	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Активити (робот) вернёт ID ответственного за дело в параметре RESPONSIBLE_ID. Используйте для дальнейшей работы с ответственным.
Извлечение дат дела для планирования	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Активити (робот) вернёт дату начала (START_TIME) и дату завершения (END_TIME) дела. Используйте для планирования связанных дел или задач.
Получение данных дела для аналитики	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Получите все данные дела и используйте их для создания отчётов, анализа эффективности работы или для передачи в системы аналитики.

Поиск дел

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

• Поиск дел по типу (звонок, письмо, встреча, задача и т.д.);
• Поиск дел, привязанных к конкретной сущности CRM (сделка, лид, контакт, компания);
• Фильтрация дел по различным параметрам (ответственный, дата создания, статус и т.д.);
• Поиск дел за определённый период времени;
• Поиск дел по ответственному за дело;
• Поиск дел в смарт-процессах;
• Автоматическое определение типа сущности по ID;
• Поиск дел с поддержкой множественных сущностей;
• Аналитика и отчётность по делам;
• Автоматизация процессов на основе найденных дел.

Название поля	Описание и примеры использования
Тип дела	В данном поле указывается тип дела (провайдера), который нужно найти. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Универсальное (CRM_TODO) - универсальные дела; - Встреча (CRM_MEETING) - дела типа "Встреча"; - Звонок (VOXIMPLANT_CALL) - дела типа "Звонок" (поддерживается поиск с альтернативными провайдерами); - Письмо (CRM_EMAIL) - дела типа "Письмо"; - Задачи (TASKS) - задачи (старые дела для обратной совместимости); - Задача (новая) (CRM_TASKS_TASK) - задачи в новой реализации; - Чат (IMOPENLINES_SESSION) - дела типа "Чат"; - Обзвон (CALL_LIST) - дела типа "Обзвон"; - SMS (CRM_SMS) - дела типа "SMS"; - CRM форма (CRM_WEBFORM) - дела типа "CRM форма"; - Визит (VISIT_TRACKER) - дела типа "Визит"; - Слоты (CRM_CALENDAR_SHARING) - дела типа "Слоты"; - Доставка (CRM_DELIVERY) - дела типа "Доставка"; - Документ подписания (CRM_SIGN_DOCUMENT) - дела типа "Документ подписания"; - Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION) - дела типа "Сообщение в WhatsApp"; - Оплата (CRM_PAYMENT) - дела типа "Оплата"; - Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW) - дела типа "Дело бизнес-процесса"; - И другие типы дел. Примеры: - Звонок - найти все дела типа "Звонок"; - Письмо - найти все дела типа "Письмо"; - Встреча - найти все дела типа "Встреча". Важно: Параметр "Тип дела" является обязательным. Без указания типа дела поиск не будет выполнен. Для звонков активити (робот) автоматически ищет дела с альтернативными провайдерами (CALL_LIST, CRM_CALL, TELEPHONY, PHONE) для более полного результата.
Тип сущности	В данном поле указывается тип сущности CRM, в которой нужно искать дела. Это необязательный параметр, поддерживается множественный выбор. Выбирается из выпадающего списка. Варианты выбора: - Лид (L) - для поиска дел, привязанных к лидам; - Сделка (D) - для поиска дел, привязанных к сделкам; - Контакт (C) - для поиска дел, привязанных к контактам; - Компания (CO) - для поиска дел, привязанных к компаниям; - Предложение (Q) - для поиска дел, привязанных к предложениям; - Заказ (O) - для поиска дел, привязанных к заказам; - Счёт (SI) - для поиска дел, привязанных к счетам; - СМАРТ: [название смарт-процесса] - для поиска дел, привязанных к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - Сделка (D) - найти все дела, привязанные к сделкам; - Контакт (C) - найти все дела, привязанные к контактам; - Сделка (D), Контакт (C) - найти дела, привязанные к сделкам или контактам (множественный выбор); - СМАРТ: Заявки - найти дела, привязанные к смарт-процессу "Заявки". Особенности работы: - Если тип сущности не указан, но указан ID сущности, активити (робот) автоматически определит тип сущности по ID; - Поддерживается множественный выбор для поиска дел в нескольких типах сущностей одновременно; - Для смарт-процессов список формируется автоматически на основе настроек вашего портала.
ID сущности	В данном поле указывается идентификатор сущности CRM, в которой нужно искать дела. Это необязательный параметр. Если указан без указания типа сущности, активити (робот) автоматически определит тип сущности по ID. Примеры: - {=Document:ID} - искать дела в текущей сущности из документа (сделка, лид, контакт, компания); - 123 - искать дела в сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Особенности работы: - Если тип сущности не указан, активити (робот) автоматически определит тип сущности по ID (проверяет лид, сделку, контакт, компанию, смарт-процессы); - Если указан тип сущности, используется указанный тип; - Можно использовать вместе с типом сущности для более точного поиска.
Ответственный	В данном поле указывается сотрудник, дела которого нужно найти. Это необязательный параметр, используется как дополнительный фильтр при поиске дел. Примеры: - {=Document:ASSIGNED_BY_ID} - искать дела ответственного из текущей сущности; - {=User:ID} - искать дела текущего пользователя; - [U1] - искать дела пользователя с ID 1; - user_25 - искать дела пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации дел по ответственному; - Для поиска дел конкретного сотрудника; - Для анализа работы конкретного пользователя.
Дата создания	В данном поле можно указать дату создания дела для фильтрации результатов. Это необязательный параметр. Поддерживаются различные операторы сравнения (=, !, >=, <=, >, <, %, !%). Примеры: - ={{=dateadd({=System:Now}, "-7d")}} - найти дела, созданные 7 дней назад; - >={{=dateadd({=System:Now}, "-30d")}} - найти дела, созданные за последние 30 дней; - <={{=dateadd({=System:Now}, "-1d")}} - найти дела, созданные до вчерашнего дня; - {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота). Операторы сравнения: - = - точное совпадение; - ! - не равно; - >= - больше или равно; - <= - меньше или равно; - > - больше; - < - меньше; - % - содержит (для строк); - !% - не содержит (для строк).
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Поиск всех звонков сделки	Параметры: Тип дела - Звонок (VOXIMPLANT_CALL), Тип сущности - Сделка (D), ID сущности - {=Document:ID}. Активити (робот) найдёт все звонки, привязанные к указанной сделке. Результат будет возвращён в параметре search_results_array.
Поиск писем контакта за последний месяц	Параметры: Тип дела - Письмо (CRM_EMAIL), Тип сущности - Контакт (C), ID сущности - {=Document:ID}, Дата создания - >={{=dateadd({=System:Now}, "-1m")}}. Активити (робот) найдёт все письма контакта, созданные за последний месяц.
Поиск дел с автоматическим определением типа сущности	Параметры: Тип дела - Универсальное (CRM_TODO), ID сущности - {=Variable:ENTITY_ID}, Тип сущности - не указывается. Активити (робот) автоматически определит тип сущности по ID и найдёт все универсальные дела, привязанные к этой сущности.
Поиск дел в нескольких типах сущностей	Параметры: Тип дела - Встреча (CRM_MEETING), Тип сущности - Сделка (D), Контакт (C) (множественный выбор), ID сущности - не указывается. Активити (робот) найдёт все встречи, привязанные к сделкам или контактам.
Поиск дел ответственного сотрудника	Параметры: Тип дела - Задача (новая) (CRM_TASKS_TASK), Ответственный - {=User:ID}, Тип сущности - не указывается, ID сущности - не указывается. Активити (робот) найдёт все задачи текущего пользователя.
Поиск дел смарт-процесса	Параметры: Тип дела - Универсальное (CRM_TODO), Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}. Активити (робот) найдёт все универсальные дела, привязанные к указанному элементу смарт-процесса "Заявки".
Поиск дел за определённый период	Параметры: Тип дела - Письмо (CRM_EMAIL), Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Дата создания - >={{=dateadd({=System:Now}, "-7d")}} и <={{=System:Now}}. Активити (робот) найдёт все письма сделки, созданные за последние 7 дней.
Поиск дел через итератор	Параметры: Тип дела - Звонок (VOXIMPLANT_CALL), Тип сущности - Контакт (C), ID сущности - {=Iterator:Value}. Для каждого ID контакта из итератора активити (робот) найдёт все звонки этого контакта.
Поиск дел с фильтрацией по теме	Параметры: Тип дела - Универсальное (CRM_TODO), Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Тема - %Важное%. Активити (робот) найдёт все универсальные дела сделки, тема которых содержит слово "Важное".
Поиск дел с использованием всех доступных полей	Параметры: Тип дела - Встреча (CRM_MEETING), Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Ответственный - {=Document:ASSIGNED_BY_ID}, Дата начала - >={{=System:Now}}, Статус - N. Активити (робот) найдёт все предстоящие встречи сделки, назначенные ответственному за сделку.

Изменение дела

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

• Изменение данных дела по его ID;
• Обновление статуса дела (выполнено/не выполнено);
• Изменение ответственного за дело;
• Обновление темы и описания дела;
• Изменение дат начала и завершения дела;
• Изменение приоритета дела;
• Изменение типа сущности, к которой привязано дело;
• Автоматическое обновление дел при изменении статуса сделки или лида;
• Массовое обновление дел по определённым критериям;
• Автоматизация обновления дел при интеграции с внешними системами.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, данные которого нужно изменить. Это обязательный параметр. Примеры: - {=Variable:ACTIVITY_ID} - изменить дело с ID из переменной предыдущего активити (робота); - 123 - изменить дело с ID 123; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска дел; - {=Document:ID} - изменить дело, если ID дела совпадает с ID документа; - {=Iterator:Value} - изменить дело для каждого ID из итератора. Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если ID дела не указан или указан неверно, активити (робот) завершится с ошибкой "Не указано ID дела".
Все доступные поля дела	Активити (робот) автоматически получает список всех доступных полей дела из CRM вашего портала и создаёт для каждого поля параметр, который можно заполнить для изменения значения. Это необязательные параметры. Доступные поля зависят от настроек вашего портала. Основные поля, которые обычно доступны: - Тема (SUBJECT) - тема дела; - Описание (DESCRIPTION) - описание дела; - Ответственный (RESPONSIBLE_ID) - ответственный за дело; - Дата начала (START_TIME) - дата и время начала дела; - Дата завершения (END_TIME) - дата и время завершения дела; - Выполнено (COMPLETED) - статус выполнения дела (Y/N); - Приоритет (PRIORITY) - приоритет дела; - Тип сущности (OWNER_TYPE_ID) - тип сущности, к которой привязано дело; - ID сущности (OWNER_ID) - ID сущности, к которой привязано дело; - И другие поля в зависимости от настроек портала. Примеры использования: - SUBJECT - "Новая тема дела" - изменить тему дела; - DESCRIPTION - "Обновлённое описание" - изменить описание дела; - COMPLETED - Y - отметить дело как выполненное; - RESPONSIBLE_ID - {=User:ID} - изменить ответственного на текущего пользователя; - START_TIME - ={{=dateadd({=System:Now}, "1d")}} - изменить дату начала на завтра; - OWNER_TYPE_ID - 2 - изменить тип сущности на "Сделка"; - OWNER_ID - {=Variable:DEAL_ID} - изменить ID сущности на значение из переменной. Типы полей: - Строка (string) - для текстовых полей; - Число (integer, double) - для числовых полей; - Дата/Время (datetime) - для полей с датой и временем; - Булево значение (boolean) - для полей с значениями Y/N; - Пользователь (user) - для полей с пользователями; - Тип сущности (crm_enum_ownertype) - для выбора типа сущности из списка. Важно: Не все поля дела доступны для изменения. Некоторые поля являются системными и не могут быть изменены (например, ID, PROVIDER_ID, PROVIDER_TYPE_ID). Список доступных полей формируется автоматически при установке активити (робота) на основе настроек вашего портала.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Отметить дело как выполненное	Параметры: ID дела - {=Variable:ACTIVITY_ID}, COMPLETED - Y. Активити (робот) отметит дело с указанным ID как выполненное.
Изменить ответственного за дело	Параметры: ID дела - {=Variable:ACTIVITY_ID}, RESPONSIBLE_ID - {=Document:ASSIGNED_BY_ID}. Активити (робот) изменит ответственного за дело на ответственного из текущей сущности.
Обновить тему и описание дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, SUBJECT - "Обновлённая тема", DESCRIPTION - "Обновлённое описание дела". Активити (робот) обновит тему и описание дела.
Изменить даты начала и завершения дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, START_TIME - ={{=dateadd({=System:Now}, "1d")}}, END_TIME - ={{=dateadd({=System:Now}, "2d")}}. Активити (робот) изменит дату начала на завтра, а дату завершения - на послезавтра.
Изменить приоритет дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, PRIORITY - 3. Активити (робот) изменит приоритет дела на высокий (3).
Изменить тип сущности и ID сущности	Параметры: ID дела - {=Variable:ACTIVITY_ID}, OWNER_TYPE_ID - 2, OWNER_ID - {=Variable:DEAL_ID}. Активити (робот) изменит привязку дела на сделку с указанным ID.
Массовое обновление дел через итератор	Параметры: ID дела - {=Iterator:Value}, COMPLETED - Y. Для каждого ID дела из итератора активити (робот) отметит дело как выполненное. Полезно для массовой обработки.
Обновление дела после выполнения условия	Параметры: ID дела - {=Variable:ACTIVITY_ID}, COMPLETED - Y, SUBJECT - "Выполнено: " & {=Variable:ACTIVITY_SUBJECT}. Используйте в условии: если условие выполнено, то обновить дело через данное активити (робот).
Автоматическое обновление дела при изменении статуса сделки	Параметры: ID дела - {=Variable:DEAL_ACTIVITY_ID}, SUBJECT - "Сделка переведена в статус '{=Document:STAGE_ID}'", DESCRIPTION - "Статус сделки изменён. Новый статус: {=Document:STAGE_ID}". Используйте в бизнес-процессе сделки: при переводе сделки в новый статус автоматически обновить связанное дело.
Изменение нескольких полей одновременно	Параметры: ID дела - {=Variable:ACTIVITY_ID}, SUBJECT - "Новая тема", DESCRIPTION - "Новое описание", RESPONSIBLE_ID - {=User:ID}, COMPLETED - N, PRIORITY - 1, START_TIME - {=System:NowLocal}, END_TIME - ={{=dateadd({=System:Now}, "1d")}}. Активити (робот) обновит все указанные поля дела за один запрос.

Удаление привязки к CRM сущности

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

• Удаление привязок дел к сущностям CRM при изменении структуры данных;
• Очистка привязок дел перед переносом на другие сущности;
• Удаление привязок дел к удалённым или неактуальным сущностям;
• Массовое удаление привязок дел к определённым типам сущностей;
• Очистка привязок дел при миграции данных между порталами;
• Удаление привязок дел к смарт-процессам при изменении структуры процессов;
• Фильтрация и удаление привязок дел по типу дела (провайдеру);
• Автоматическая очистка привязок при обработке ошибок и исключений;
• Удаление привязок дел при интеграции с внешними системами;
• Очистка привязок дел для оптимизации структуры данных в CRM.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, привязки которого к сущностям CRM будут удалены. Это необязательный параметр, но если он указан, то другие параметры (тип сущности и ID сущности) не учитываются. Поддерживается множественное значение (можно указать несколько ID дел). Важно: Если указан ID дела, то параметры "Тип сущности (для поиска дел)", "ID сущности (для поиска дел)" и "Тип дела (дополнительный фильтр)" игнорируются. Используйте этот параметр для удаления привязок конкретного дела. Примеры: - {=Variable:ACTIVITY_ID} - удалить привязки дела с ID из переменной предыдущего активити (робота); - 123 - удалить привязки дела с ID 123; - 123, 456, 789 - удалить привязки нескольких дел одновременно (множественное значение); - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=Iterator:Value} - удалить привязки дела для каждого ID из итератора. Важно: Если у дела только одна привязка, она не будет удалена (дело будет пропущено), так как дело всегда должно иметь хотя бы одну привязку к сущности CRM. ID таких дел будет возвращён в параметре skipped_activity_ids.
Тип сущности (для поиска дел)	В данном поле выбирается тип сущности CRM, по которой будут найдены дела для удаления привязок. Это необязательный параметр, используется только если не указан "ID дела". Выбирается из выпадающего списка. Варианты выбора: - L - Лид (CRM_LEAD); - D - Сделка (CRM_DEAL); - C - Контакт (CRM_CONTACT); - CO - Компания (CRM_COMPANY); - Q - Предложение (CRM_QUOTE); - O - Заказ (CRM_ORDER); - SI - Счёт (новый, CRM_SMART_INVOICE); - СМАРТ: [название смарт-процесса] - для поиска дел, привязанных к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - D - найти все дела, привязанные к сделкам, и удалить у них привязки; - C - найти все дела, привязанные к контактам, и удалить у них привязки; - CO - найти все дела, привязанные к компаниям, и удалить у них привязки; - СМАРТ: Заявки - найти все дела, привязанные к смарт-процессу "Заявки", и удалить у них привязки. Важно: Этот параметр используется только если не указан "ID дела". Если указан "ID дела", то этот параметр игнорируется. Для работы этого параметра также необходимо указать "ID сущности (для поиска дел)".
ID сущности (для поиска дел)	В данном поле указывается идентификатор сущности CRM, по которой будут найдены дела для удаления привязок. Это необязательный параметр, используется только если не указан "ID дела". Примеры: - {=Document:ID} - найти все дела, привязанные к текущей сущности из документа (сделка, лид, контакт, компания), и удалить у них привязки; - 123 - найти все дела, привязанные к сущности с ID 123, и удалить у них привязки; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Как работает в паре с "Тип сущности (для поиска дел)": - Если указаны оба параметра ("Тип сущности (для поиска дел)" и "ID сущности (для поиска дел)"), активити (робот) найдёт все дела, привязанные к указанной сущности, и удалит у них все привязки (кроме одной, если она единственная); - Если указан только "ID сущности (для поиска дел)" без "Типа сущности (для поиска дел)", активити (робот) завершится с ошибкой. Важно: Этот параметр используется только если не указан "ID дела". Если указан "ID дела", то этот параметр игнорируется. Для работы этого параметра также необходимо указать "Тип сущности (для поиска дел)".
Тип дела (дополнительный фильтр)	В данном поле можно указать тип дела (провайдер) для дополнительной фильтрации при поиске дел. Это необязательный параметр, используется только если не указан "ID дела". Позволяет фильтровать дела по их типу перед удалением привязок. Варианты выбора: - Универсальное дело (CRM_TODO); - Встреча (CRM_MEETING); - Звонок (VOXIMPLANT_CALL); - Задача (старый формат) (TASKS); - Задача (новый формат) (CRM_TASKS_TASK); - Письмо (CRM_EMAIL); - Обзвон (CALL_LIST); - SMS (CRM_SMS); - Сообщение в живую ленту (CRM_LF_MESSAGE); - Комментарий в живую ленту (CRM_LF_COMMENT); - Визит (VISIT_TRACKER); - Дело через REST (конфигурируемое) (CONFIGURABLE_REST_APP); - Слоты календаря (CRM_CALENDAR_SHARING); - Доставка (CRM_DELIVERY); - Документ подписания (CRM_SIGN_DOCUMENT); - Дело через REST (устаревшее) (CRM_EXTERNAL_CHANNEL); - Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION); - Оплата (CRM_PAYMENT); - Задание из бизнес-процесса (CRM_REQUEST); - Комментарий к задаче (CRM_TASKS_TASK_COMMENT); - Заполнение CRM-формы (CRM_WEBFORM); - Чат открытой линии (IMOPENLINES_SESSION); - Дело через REST приложение (REST_APP); - Документ складского учета (STORE_DOCUMENT); - Zoom-конференция (ZOOM); - Подписание документа с сотрудниками (CRM_SIGN_B2E_DOCUMENT); - Бронирование (CRM_BOOKING); - Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW). Примеры: - Звонок - удалить привязки только у дел типа "Звонок"; - Письмо - удалить привязки только у дел типа "Письмо"; - Встреча - удалить привязки только у дел типа "Встреча". Когда использовать: - Когда нужно удалить привязки только у определённого типа дел; - Для фильтрации дел перед массовым удалением привязок; - Для более точного контроля над процессом удаления привязок.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Удаление всех привязок у конкретного дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности (для поиска дел) - не указывается, ID сущности (для поиска дел) - не указывается, Тип дела (дополнительный фильтр) - не указывается. Активити (робот) удалит все привязки у указанного дела (кроме одной, если она единственная).
Удаление привязок у всех дел, привязанных к сделке	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - D (Сделка), ID сущности (для поиска дел) - {=Document:ID}, Тип дела (дополнительный фильтр) - не указывается. Активити (робот) найдёт все дела, привязанные к указанной сделке, и удалит у них все привязки (кроме одной, если она единственная).
Удаление привязок только у звонков, привязанных к контакту	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - C (Контакт), ID сущности (для поиска дел) - {=Document:ID}, Тип дела (дополнительный фильтр) - Звонок. Активити (робот) найдёт все дела типа "Звонок", привязанные к указанному контакту, и удалит у них все привязки.
Удаление привязок у нескольких дел одновременно	Параметры: ID дела - 123, 456, 789 (множественное значение), Тип сущности (для поиска дел) - не указывается, ID сущности (для поиска дел) - не указывается, Тип дела (дополнительный фильтр) - не указывается. Активити (робот) удалит все привязки у всех трёх указанных дел.
Удаление привязок у всех писем, привязанных к компании	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - CO (Компания), ID сущности (для поиска дел) - {=Variable:COMPANY_ID}, Тип дела (дополнительный фильтр) - Письмо. Активити (робот) найдёт все дела типа "Письмо", привязанные к указанной компании, и удалит у них все привязки.
Массовое удаление привязок через итератор	Параметры: ID дела - {=Iterator:Value}, Тип сущности (для поиска дел) - не указывается, ID сущности (для поиска дел) - не указывается, Тип дела (дополнительный фильтр) - не указывается. Для каждого ID дела из итератора будет выполнено удаление всех привязок.
Удаление привязок у дел, привязанных к смарт-процессу	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - СМАРТ: Заявки, ID сущности (для поиска дел) - {=Document:ID}, Тип дела (дополнительный фильтр) - не указывается. Активити (робот) найдёт все дела, привязанные к указанному элементу смарт-процесса "Заявки", и удалит у них все привязки.
Удаление привязок только у встреч, привязанных к сделке	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - D (Сделка), ID сущности (для поиска дел) - {=Document:ID}, Тип дела (дополнительный фильтр) - Встреча. Активити (робот) найдёт все дела типа "Встреча", привязанные к указанной сделке, и удалит у них все привязки.
Удаление привязок у дел после переноса на другую сущность	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности (для поиска дел) - не указывается, ID сущности (для поиска дел) - не указывается, Тип дела (дополнительный фильтр) - не указывается. Используется после привязки дела к новой сущности через активити (робот) "Привязка дела" для удаления старых привязок.
Очистка привязок у всех дел типа "Задание из бизнес-процесса"	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - D (Сделка), ID сущности (для поиска дел) - {=Document:ID}, Тип дела (дополнительный фильтр) - Задание из бизнес-процесса. Активити (робот) найдёт все дела типа "Задание из бизнес-процесса", привязанные к указанной сделке, и удалит у них все привязки.

Получить список CRM сущностей, привязанных к делу

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

• Получение списка всех сущностей, к которым привязано дело;
• Проверка наличия привязок дела к определённым типам сущностей;
• Анализ структуры связей дел с сущностями CRM;
• Получение ID сущностей для дальнейшей обработки в бизнес-процессе;
• Проверка привязок перед удалением или изменением связей;
• Получение списка привязок для массовой обработки дел;
• Аналитика и отчётность по связям дел с сущностями;
• Валидация данных перед выполнением операций с привязками;
• Получение информации о привязках для интеграции с внешними системами;
• Автоматизация процессов на основе информации о привязках дел.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, для которого нужно получить список привязок к сущностям CRM. Это обязательный параметр. Примеры: - {=Variable:ACTIVITY_ID} - получить список привязок дела с ID из переменной предыдущего активити (робота); - 123 - получить список привязок дела с ID 123; - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=Document:ID} - получить список привязок дела, связанного с текущим документом (если ID дела совпадает с ID документа); - {=Iterator:Value} - получить список привязок для каждого ID дела из итератора. Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если дело с указанным ID не существует или не имеет привязок, активити (робот) завершится с ошибкой "Не найдены привязки для данного дела".
Ограничить количество результатов до	В данном поле можно указать максимальное количество результатов, которое будет возвращено. Это необязательный параметр. Если не указан, будут возвращены все найденные привязки. Примеры: - 5 - вернуть только первые 5 привязок; - 10 - вернуть только первые 10 привязок; - {=Variable:LIMIT} - использовать значение из переменной предыдущего активити (робота); - Если не указано - вернуть все найденные привязки. Когда использовать: - Когда нужно получить только первую привязку (указать 1); - Для ограничения количества результатов при большом количестве привязок; - Для оптимизации производительности при работе с большими массивами данных. Рекомендации: - Используйте этот параметр, если дело может иметь много привязок и вам нужны только первые N результатов; - Для получения только первой привязки используйте также параметр search_result_first_string из возвращаемых значений.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Получение списка всех привязок дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Активити (робот) вернёт все привязки дела в формате массива и строки (например, D_123,C_456,CO_789).
Получение только первой привязки дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - 1. Активити (робот) вернёт только первую привязку. Также можно использовать параметр search_result_first_string из возвращаемых значений.
Проверка привязок дела перед удалением	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте результат для проверки количества привязок (параметр count_search) перед удалением привязок через активити (робот) "Удаление привязки дела".
Получение ID сделки из привязок дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_results_array для поиска элементов с префиксом D_ (сделка) и извлечения ID сделки.
Получение списка привязок для массовой обработки	Параметры: ID дела - {=Iterator:Value}, Ограничить количество результатов до - не указывается. Для каждого ID дела из итератора будет получен список привязок для дальнейшей обработки.
Проверка наличия привязки к определённой сущности	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_results_string для проверки наличия определённого префикса и ID (например, проверка наличия D_{=Document:ID}).
Получение всех контактов, привязанных к делу	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_results_array для фильтрации элементов с префиксом C_ (контакт) и извлечения ID контактов.
Ограничение результатов для оптимизации	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - 10. Активити (робот) вернёт только первые 10 привязок, что полезно при большом количестве привязок.
Получение последней привязки дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_result_last_string из возвращаемых значений для получения последней привязки.
Анализ структуры привязок для отчётности	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр count_search для подсчёта количества привязок и search_results_array для анализа типов привязанных сущностей.

Привязка дела

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

• Привязка дела к дополнительным сущностям CRM (сделка, лид, контакт, компания);
• Связывание дела с несколькими сущностями одновременно;
• Автоматическая привязка дел к смарт-процессам;
• Создание связей между делами и различными типами сущностей в процессе работы;
• Привязка дел к сущностям на основе данных из предыдущих активити (роботов);
• Массовая привязка дел к сущностям через итератор;
• Автоматизация создания связей при обработке заявок и обращений;
• Привязка дел к сущностям при интеграции с внешними системами;
• Создание дополнительных связей для аналитики и отчётности;
• Привязка дел к сущностям при изменении статусов и этапов работы.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, которое будет привязано к сущности CRM. Это необязательный параметр, но если он указан, то другие параметры (тип сущности и ID сущности) не учитываются. Поддерживается множественное значение (можно указать несколько ID дел). Важно: Если указан ID дела, то параметры "Тип сущности" и "ID сущности" игнорируются. Используйте этот параметр для прямой привязки конкретного дела к сущности. Примеры: - {=Variable:ACTIVITY_ID} - привязать дело с ID из переменной предыдущего активити (робота); - 123 - привязать дело с ID 123; - 123, 456, 789 - привязать несколько дел одновременно (множественное значение); - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=Iterator:Value} - привязать дело для каждого ID из итератора. Когда использовать: - Когда нужно привязать конкретное дело, ID которого известно; - Когда ID дела получен из предыдущего активити (робота); - Для массовой привязки нескольких конкретных дел к одной сущности.
Тип сущности	В данном поле выбирается тип сущности CRM, к которой будет привязано дело. Это необязательный параметр, используется только если не указан "ID дела". Выбирается из выпадающего списка. Варианты выбора: - L - Лид (CRM_LEAD); - D - Сделка (CRM_DEAL); - C - Контакт (CRM_CONTACT); - CO - Компания (CRM_COMPANY); - Q - Предложение (CRM_QUOTE); - O - Заказ (CRM_ORDER); - SI - Счёт (новый, CRM_SMART_INVOICE); - СМАРТ: [название смарт-процесса] - для привязки к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - D - привязать дело к сделке; - C - привязать дело к контакту; - CO - привязать дело к компании; - СМАРТ: Заявки - привязать дело к смарт-процессу "Заявки". Важно: Этот параметр используется только если не указан "ID дела". Если указан "ID дела", то этот параметр игнорируется. Для работы этого параметра также необходимо указать "ID сущности".
ID сущности	В данном поле указывается идентификатор сущности CRM, к которой будет привязано дело. Это необязательный параметр, используется только если не указан "ID дела". Примеры: - {=Document:ID} - привязать дело к текущей сущности из документа (сделка, лид, контакт, компания); - 123 - привязать дело к сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Как работает в паре с "Тип сущности": - Если указаны оба параметра ("Тип сущности" и "ID сущности"), активити (робот) найдёт все дела, привязанные к указанной сущности, и привяжет их к новой сущности, указанной в этих параметрах; - Если указан только "ID сущности" без "Типа сущности", активити (робот) завершится с ошибкой. Важно: Этот параметр используется только если не указан "ID дела". Если указан "ID дела", то этот параметр игнорируется. Для работы этого параметра также необходимо указать "Тип сущности".
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Привязка конкретного дела к сделке по ID	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности - не указывается (игнорируется), ID сущности - не указывается (игнорируется). Примечание: при указании ID дела другие параметры не учитываются. Для привязки к сделке используйте активити (робот) с указанием ID дела и ID сделки в других параметрах активити (робота) или используйте другой способ привязки.
Привязка всех дел от лида к сделке при конвертации	Параметры: ID дела - не указывается, Тип сущности - D (Сделка), ID сущности - {=Document:ID}. Активити (робот) найдёт все дела, привязанные к лиду (из которого запущен бизнес-процесс), и привяжет их к указанной сделке.
Привязка дела к контакту после создания дела	Параметры: ID дела - {=A1988_22222_92566_99999:new_id_activity}, Тип сущности - не указывается, ID сущности - не указывается. Используется ID дела из активити (робота) "Создание своего дела в CRM". Дело будет привязано к контакту, указанному в параметрах активити (робота) привязки.
Привязка нескольких дел к компании одновременно	Параметры: ID дела - 123, 456, 789 (множественное значение), Тип сущности - не указывается, ID сущности - не указывается. Все три дела будут привязаны к компании, указанной в других параметрах активити (робота).
Привязка дел к смарт-процессу при изменении статуса	Параметры: ID дела - не указывается, Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}. Активити (робот) найдёт все дела, привязанные к текущему элементу смарт-процесса, и привяжет их к новому элементу смарт-процесса.
Массовая привязка дел через итератор	Параметры: ID дела - {=Iterator:Value}, Тип сущности - не указывается, ID сущности - не указывается. Для каждого ID дела из итератора будет выполнена привязка к сущности, указанной в других параметрах активити (робота).
Привязка дела к контакту при создании сделки	Параметры: ID дела - не указывается, Тип сущности - C (Контакт), ID сущности - {=Document:CONTACT_ID}. Активити (робот) найдёт все дела, привязанные к сделке (из которой запущен бизнес-процесс), и привяжет их к контакту, указанному в сделке.
Привязка дела к компании при работе с лидом	Параметры: ID дела - не указывается, Тип сущности - CO (Компания), ID сущности - {=Variable:COMPANY_ID}. Активити (робот) найдёт все дела, привязанные к лиду (из которого запущен бизнес-процесс), и привяжет их к компании, ID которой указан в переменной.
Привязка дела к предложению при создании коммерческого предложения	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности - не указывается, ID сущности - не указывается. Дело будет привязано к предложению, указанному в других параметрах активити (робота).
Привязка дел к счёту при выставлении счёта	Параметры: ID дела - не указывается, Тип сущности - SI (Счёт), ID сущности - {=Variable:INVOICE_ID}. Активити (робот) найдёт все дела, привязанные к сделке (из которой запущен бизнес-процесс), и привяжет их к созданному счёту.

Прочие операции с делами

Создание e-mail

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

• Автоматическое создание входящих писем при получении сообщений из внешних систем;
• Создание исходящих писем для отправки клиентам;
• Автоматизация создания писем при изменении статуса сделки или лида;
• Создание писем с прикреплёнными файлами;
• Автоматическое создание писем при интеграции с почтовыми системами;
• Создание писем для напоминаний и уведомлений;
• Автоматизация создания писем при поступлении заявок с сайта;
• Создание писем для массовых рассылок через бизнес-процессы;
• Автоматическое создание писем при выполнении определённых условий;
• Создание писем для документооборота и согласования.

Название поля	Описание и примеры использования
Тип сущности	В данном поле указывается тип сущности, к которой будет привязано создаваемое письмо. Это обязательный параметр. Варианты выбора: - Лид (1) - для привязки письма к лиду; - Сделка (2) - для привязки письма к сделке; - Контакт (3) - для привязки письма к контакту; - Компания (4) - для привязки письма к компании; - Смарт-процессы (5) - для привязки письма к смарт-процессу (требует указания конкретного смарт-процесса в поле "Смарт-процессы"). Примеры использования: - Для создания письма, привязанного к сделке, выберите значение "2"; - Для создания письма, привязанного к лиду, выберите значение "1"; - При выборе "Смарт-процессы" необходимо дополнительно указать конкретный смарт-процесс в поле "Смарт-процессы".
ID Сущности	В данном поле указывается числовой идентификатор (ID) сущности, к которой будет привязано создаваемое письмо. Это обязательный параметр. Примеры: - {=Document:ID} - привязать письмо к текущей сущности из документа (сделка, лид, контакт, компания); - 123 - привязать письмо к сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой.
Смарт-процессы	В данном поле указывается конкретный смарт-процесс, к которому будет привязано письмо. Это необязательный параметр, который используется только при выборе типа сущности "Смарт-процессы". Важно: Это поле активно только при выборе типа сущности "Смарт-процессы". Для обычных CRM-сущностей (лид, сделка, контакт, компания) это поле не используется. Примеры: - Выберите нужный смарт-процесс из выпадающего списка (список формируется автоматически на основе настроек вашего портала); - Список доступных смарт-процессов загружается автоматически при установке активити (робота).
Тип сущность, которой принадлежит почта	В данном поле указывается тип сущности, которой принадлежит почтовый адрес. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Контакт (3) - почта принадлежит контакту; - Компания (4) - почта принадлежит компании. Примеры использования: - Контакт (3) - если почтовый адрес принадлежит контакту; - Компания (4) - если почтовый адрес принадлежит компании.
ID сущности, которой принадлежит почта	В данном поле указывается идентификатор сущности (контакта или компании), которой принадлежит почтовый адрес. Это обязательный параметр. Примеры: - {=Document:CONTACT_ID} - использовать ID контакта из текущей сущности; - {=Document:COMPANY_ID} - использовать ID компании из текущей сущности; - 123 - указать ID сущности напрямую; - {=Variable:ENTITY_ID} - использовать ID из переменной предыдущего активити (робота). Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности (контакт или компания).
Направление письма	В данном поле указывается направление письма: входящее или исходящее. Это обязательный параметр. Варианты выбора: - Входящее (1) - письмо получено от клиента или партнёра; - Исходящее (2) - письмо отправляется клиенту или партнёру. Примеры использования: - Входящее (1) - для создания писем, полученных от клиентов; - Исходящее (2) - для создания писем, которые будут отправлены клиентам. Особенности работы: - Для входящих писем используется статус из параметра "Статус письма"; - Для исходящих писем можно указать, нужно ли отправлять письмо сразу (параметр "Отправлять письмо").
Статус письма	В данном поле указывается статус письма: выполнено или не выполнено. Это обязательный параметр. Варианты выбора: - Не выполнено (N) - письмо не обработано или не отправлено; - Выполнено (Y) - письмо обработано или отправлено. Примеры использования: - Не выполнено (N) - для писем, которые требуют обработки; - Выполнено (Y) - для писем, которые уже обработаны или отправлены. Особенности работы: - Для входящих писем статус указывает, обработано ли письмо; - Для исходящих писем статус указывает, отправлено ли письмо (если параметр "Отправлять письмо" установлен в "Да").
Отправлять письмо	В данном поле указывается, нужно ли отправлять исходящее письмо сразу после создания. Это необязательный параметр (варианты: да/нет), используется только для исходящих писем. Варианты выбора: - Да (Y) - письмо будет отправлено сразу после создания; - Нет (N) - письмо будет создано, но не отправлено (можно отправить вручную позже). Примеры использования: - Да (Y) - для автоматической отправки писем клиентам; - Нет (N) - для создания писем, которые требуют проверки перед отправкой. Важно: Этот параметр работает только для исходящих писем (Направление письма = Исходящее). Для входящих писем этот параметр не применяется.
От кого (e-mail)	В данном поле указывается почтовый адрес отправителя письма. Это обязательный параметр. Примеры: - info@example.com - указать почтовый адрес напрямую; - {=Variable:SENDER_EMAIL} - использовать адрес из переменной предыдущего активити (робота); - {=Document:EMAIL} - использовать адрес из текущей сущности (если есть поле EMAIL). Важно: Почтовый адрес должен быть указан в корректном формате (например, user@example.com).
Кому (e-mail)	В данном поле указывается почтовый адрес получателя письма. Это обязательный параметр. Поддерживается указание адреса в формате массива с типом VALUE_TYPE = 'WORK' для автоматического определения рабочего адреса. Примеры: - client@example.com - указать почтовый адрес напрямую; - {=Document:EMAIL} - использовать адрес из текущей сущности; - {=Variable:RECIPIENT_EMAIL} - использовать адрес из переменной предыдущего активити (робота); - Массив с VALUE_TYPE = 'WORK' - для автоматического определения рабочего адреса из контакта или компании. Особенности работы: - Если указан массив с типом VALUE_TYPE = 'WORK', активити (робот) автоматически выберет рабочий адрес; - Если указана строка, используется указанный адрес напрямую.
Тема письма	В данном поле указывается тема (заголовок) письма. Это необязательный параметр. Примеры: - Ответ на ваше обращение; - Коммерческое предложение для сделки #{=Document:ID}; - Напоминание: оплата по сделке {=Document:TITLE}; - ={{={=Variable:SUBJECT} & " - Дополнительная информация"}} - добавить информацию к теме из переменной. Рекомендации: - Используйте информативные темы, которые помогут быстро понять суть письма; - Можно включать переменные и поля из текущей сущности для персонализации.
Тип описания	В данном поле указывается формат описания письма. Это необязательный параметр. Варианты выбора: - Текст (1) - обычный текст без форматирования; - BBCODE (2) - форматирование BB-код; - HTML (3) - форматирование HTML. Примеры использования: - Текст (1) - для простых текстовых писем; - BBCODE (2) - для писем с форматированием (жирный текст, ссылки и т.д.); - HTML (3) - для писем с HTML-форматированием. Рекомендации: - Используйте BBCODE для стандартного форматирования; - Используйте HTML для сложного форматирования и дизайна.
Описание письма	В данном поле указывается содержание и описание письма. Это обязательный параметр. Поддерживается форматирование в зависимости от выбранного типа описания (текст, BB-код или HTML). Примеры: - Здравствуйте! Благодарим за обращение. Мы свяжемся с вами в ближайшее время.; - [b]Важно:[/b] Проверьте документы по сделке #{=Document:ID}. Сумма: {=Document:OPPORTUNITY} руб.; - Подготовьте договор для компании {=Document:COMPANY_TITLE}. Контактное лицо: {=Document:CONTACT_NAME}; - ={{={=Variable:DESCRIPTION} & "[br]Дополнительная информация: " & {=Variable:ADDITIONAL_INFO}}}} - объединить несколько переменных с форматированием; - [url={=System:HostUrl}/crm/deal/details/{=Document:ID}/]Ссылка на сделку[/url] - добавить ссылку на сущность. Форматирование BB-код: - [b]жирный текст[/b] - жирное начертание; - [i]курсив[/i] - курсивное начертание; - [u]подчёркнутый[/u] - подчёркнутый текст; - [br] - перенос строки; - [url=ссылка]текст[/url] - ссылка. Важно: Если поле "Описание письма" пустое, активити (робот) завершится с ошибкой. Обязательно укажите содержание письма.
Приоритет	В данном поле указывается приоритет письма. Это необязательный параметр. Варианты выбора: - Низкий (1) - обычный приоритет; - Высокий (3) - высокий приоритет (важное письмо). Примеры использования: - Низкий (1) - для обычных писем; - Высокий (3) - для важных писем, требующих срочной обработки. Рекомендации: - Используйте высокий приоритет только для действительно важных писем; - Высокоприоритетные письма выделяются в интерфейсе CRM.
Дата начала	В данном поле указывается дата и время начала письма. Это необязательный параметр. Если не указано, дата начала будет установлена автоматически. Примеры: - {=System:NowLocal} - установить текущую дату и время; - ={{=dateadd({=System:Now}, "1d")}} - установить дату начала через 1 день от текущего момента; - ={{=workdateadd({=System:Now}, "2d", {=Document:ASSIGNED_BY_ID})}} - установить дату начала через 2 рабочих дня с учётом рабочего времени ответственного; - ={{=dateadd({=Document:BEGINDATE}, "1h")}} - установить дату начала через 1 час от даты начала сделки; - 15.01.2025 10:00:00 - указать конкретную дату и время. Рекомендации: - Используйте функции работы с датами для автоматического расчёта времени начала; - Учитывайте рабочие дни и часы при планировании писем.
Дата завершения	В данном поле указывается дата и время завершения письма. Это необязательный параметр. Если не указано, дата завершения не будет установлена. Примеры: - ={{=dateadd({=System:Now}, "3d")}} - установить дату завершения через 3 дня от текущего момента; - ={{=workdateadd({=System:Now}, "5d", {=Document:ASSIGNED_BY_ID})}} - установить дату завершения через 5 рабочих дней с учётом рабочего времени ответственного; - ={{=dateadd({=Variable:DATE_START}, "2h")}} - установить дату завершения через 2 часа от даты начала (из переменной); - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}} - установить дату завершения на 1 день раньше даты закрытия сделки; - 20.01.2025 18:00:00 - указать конкретную дату и время завершения. Рекомендации: - Дата завершения должна быть позже даты начала; - Используйте функции работы с датами для автоматического расчёта дедлайнов.
Файлы	В данном поле указываются файлы, которые нужно прикрепить к письму. Это необязательный параметр, поддерживается множественный выбор (до 20 файлов за один запрос). Указывается ID файла на диске Битрикс24. Примеры: - 12345 - прикрепить файл с ID 12345 на диске; - {=Variable:FILE_ID} - использовать ID файла из переменной предыдущего активити (робота); - {=Document:FILES} - использовать файлы из текущей сущности (если есть поле FILES); - 12345, 67890, 11111 - прикрепить несколько файлов (множественный выбор). Как получить ID файла: - Из результата активити (робота) загрузки файла; - Из поля документа, если файл прикреплён к документу; - Из переменной, созданной в предыдущих шагах бизнес-процесса. Важно: Активити (робот) может прикрепить до 20 файлов за один запрос. Если указано больше 20 файлов, будут прикреплены только первые 20. Для прикрепления большего количества файлов используйте несколько запусков активити (робота) или итератор.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Создание входящего письма от клиента	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:CONTACT_ID}, Направление письма - 1 (Входящее), Статус письма - N (Не выполнено), От кого (e-mail) - {=Document:EMAIL}, Кому (e-mail) - info@company.com, Тема письма - "Вопрос по сделке #{=Document:ID}", Тип описания - 2 (BBCODE), Описание письма - "Здравствуйте! У меня вопрос по сделке. [url={=System:HostUrl}/crm/deal/details/{=Document:ID}/]Ссылка на сделку[/url]", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание исходящего письма с отправкой	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - Y (Выполнено), Отправлять письмо - Y (Да), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Коммерческое предложение для сделки #{=Document:ID}", Тип описания - 2 (BBCODE), Описание письма - "[b]Уважаемый клиент![/b] Предлагаем вам коммерческое предложение по сделке. Сумма: {=Document:OPPORTUNITY} руб.", Приоритет - 3 (Высокий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - {=Variable:PROPOSAL_FILE_ID}.
Создание письма с прикреплёнными файлами	Параметры: Тип сущности - 3 (Контакт), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - N (Не выполнено), Отправлять письмо - N (Нет), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Документы для ознакомления", Тип описания - 1 (Текст), Описание письма - "Прикрепляю документы для ознакомления. Прошу ознакомиться и дать обратную связь.", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - {=Variable:FILE_ID_1}, {=Variable:FILE_ID_2}, {=Variable:FILE_ID_3}.
Автоматическое создание письма при изменении статуса сделки	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - Y (Выполнено), Отправлять письмо - Y (Да), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Сделка переведена в статус '{=Document:STAGE_ID}'", Тип описания - 2 (BBCODE), Описание письма - "Уведомляем вас, что сделка #{=Document:ID} переведена в новый статус. [url={=System:HostUrl}/crm/deal/details/{=Document:ID}/]Открыть сделку[/url]", Приоритет - 3 (Высокий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание письма для смарт-процесса	Параметры: Тип сущности - 5 (Смарт-процессы), Смарт-процессы - {=Variable:SMART_TYPE}, ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Variable:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - N (Не выполнено), Отправлять письмо - N (Нет), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Variable:CLIENT_EMAIL}, Тема письма - "Обработка заявки", Тип описания - 2 (BBCODE), Описание письма - "Ваша заявка получена и находится в обработке. Номер заявки: {=Document:ID}", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание письма с HTML-форматированием	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - Y (Выполнено), Отправлять письмо - Y (Да), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Красивое письмо", Тип описания - 3 (HTML), Описание письма - "<h1>Заголовок</h1><p>Текст письма с <b>форматированием</b></p>", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание письма с планированием на будущее	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - N (Не выполнено), Отправлять письмо - N (Нет), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Напоминание о дедлайне", Тип описания - 2 (BBCODE), Описание письма - "Напоминаем, что дедлайн по сделке наступает {=Document:CLOSEDATE}", Приоритет - 3 (Высокий), Дата начала - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}}, Дата завершения - {=Document:CLOSEDATE}, Файлы - не указывается.
Массовое создание писем через итератор	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Iterator:Value}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Variable:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - Y (Выполнено), Отправлять письмо - Y (Да), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Variable:CLIENT_EMAIL}, Тема письма - "Уведомление по сделке #{=Iterator:Value}", Тип описания - 1 (Текст), Описание письма - "Создано автоматическое уведомление по сделке.", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание письма с автоматическим определением рабочего адреса	Параметры: Тип сущности - 3 (Контакт), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - Y (Выполнено), Отправлять письмо - Y (Да), От кого (e-mail) - info@company.com, Кому (e-mail) - массив с VALUE_TYPE = 'WORK', Тема письма - "Приветствие", Тип описания - 1 (Текст), Описание письма - "Здравствуйте! Рады приветствовать вас.", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание письма для компании	Параметры: Тип сущности - 4 (Компания), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 4 (Компания), ID сущности, которой принадлежит почта - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - N (Не выполнено), Отправлять письмо - N (Нет), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Предложение для компании {=Document:TITLE}", Тип описания - 2 (BBCODE), Описание письма - "Предлагаем сотрудничество компании {=Document:TITLE}. [b]Наши преимущества:[/b] качество, надёжность, выгодные условия.", Приоритет - 3 (Высокий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - {=Variable:PROPOSAL_FILE_ID}.

Поиск звонков в сущности

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

• Поиск всех звонков, связанных с конкретной сущностью CRM (контакт, компания, лид);
• Фильтрация звонков по типу (входящий/исходящий), длительности и статусу;
• Поиск звонков за определённый период времени;
• Поиск звонков по номеру телефона клиента или оператора;
• Проверка наличия звонка с определёнными параметрами по ID звонка;
• Поиск звонков в контактах, привязанных к сделке;
• Поиск звонков в компании, привязанной к сделке;
• Аналитика и отчётность по звонкам клиентов;
• Автоматизация процессов на основе истории звонков;
• Проверка условий выполнения звонков для условной логики в бизнес-процессах.

Название поля	Описание и примеры использования
ID звонка (если заполнено, то ID сущности не учитывается)	В данном поле указывается идентификатор звонка для проверки его параметров. Это необязательный параметр, но если он указан, то другие параметры поиска (тип сущности, ID сущности и фильтры) не учитываются. Активити (робот) проверит соответствие звонка указанным условиям (тип звонка, длительность, статус). Важно: Если указан ID звонка, активити (робот) работает в режиме проверки условий. Параметры "Тип сущности", "ID Сущности" и все фильтры игнорируются. Результат будет возвращён в параметре conditions (Y - соответствует условиям, N - не соответствует). Примеры: - {=Variable:CALL_ID} - проверить звонок с ID из переменной предыдущего активити (робота); - 12345 - проверить звонок с ID 12345; - {=A1988_22222_92566_99999:calls_array} - использовать ID звонка из результата предыдущего поиска. Режим проверки условий: При указании ID звонка активити (робот) проверяет соответствие звонка указанным условиям: - Тип звонка (если указан); - Длительность звонка (если указана); - Статус звонка (если указан). Если все указанные условия выполнены, возвращается conditions = Y, иначе conditions = N.
Тип сущности	В данном поле указывается тип сущности CRM, в которой будет осуществлён поиск звонков. Это необязательный параметр, используется только если не указан "ID звонка". Выбирается из выпадающего списка. Варианты выбора: - LEAD - Лид; - DEAL - Сделка (с ограничениями, см. важное примечание); - CONTACT - Контакт; - COMPANY - Компания; - СМАРТ: [название смарт-процесса] - для поиска звонков в смарт-процессах (список формируется автоматически на основе настроек вашего портала). Примеры: - CONTACT - искать звонки в контактах; - COMPANY - искать звонки в компаниях; - LEAD - искать звонки в лидах. Важно: Из-за архитектуры Битрикс24, данное активити (робот) не осуществляет поиск звонков напрямую в сделках, так как через REST-API связи сделки и звонка нет. Существует связь между делом типа "звонок" и сделкой, но не существует связи между фактически совершенным звонком и сделкой из-за отсутствия номера телефона у сделки. Для поиска звонков, связанных со сделкой, используйте параметры "Искать звонки, в контактах, привязанных к Сделке" или "Искать звонки, в компании, привязанной к Сделке".
Искать звонки, в контактах, привязанных к Сделке	В данном поле можно указать, нужно ли искать звонки в контактах, привязанных к сделке. Это необязательный параметр (варианты: да/нет), используется только если указан тип сущности "DEAL" (Сделка). Варианты выбора: - Да (Y) - искать звонки во всех контактах, привязанных к указанной сделке; - Нет (N) - не искать звонки в контактах сделки. Примеры использования: - Установите "Да" для поиска всех звонков, связанных с контактами сделки; - Используйте вместе с параметром "Искать звонки, в компании, привязанной к Сделке" для комплексного поиска. Важно: Этот параметр работает только при указании типа сущности "DEAL" (Сделка). Если указан "ID звонка", этот параметр игнорируется. Хотя бы один из параметров "Искать звонки, в контактах, привязанных к Сделке" или "Искать звонки, в компании, привязанной к Сделке" должен быть установлен в "Да" при работе со сделками.
Искать звонки, в компании, привязанной к Сделке	В данном поле можно указать, нужно ли искать звонки в компании, привязанной к сделке. Это необязательный параметр (варианты: да/нет), используется только если указан тип сущности "DEAL" (Сделка). Варианты выбора: - Да (Y) - искать звонки в компании, привязанной к указанной сделке; - Нет (N) - не искать звонки в компании сделки. Примеры использования: - Установите "Да" для поиска звонков, связанных с компанией сделки; - Используйте вместе с параметром "Искать звонки, в контактах, привязанных к Сделке" для комплексного поиска. Важно: Этот параметр работает только при указании типа сущности "DEAL" (Сделка). Если указан "ID звонка", этот параметр игнорируется. Хотя бы один из параметров "Искать звонки, в контактах, привязанных к Сделке" или "Искать звонки, в компании, привязанной к Сделке" должен быть установлен в "Да" при работе со сделками.
ID Сущности	В данном поле указывается идентификатор сущности CRM, в которой будет осуществлён поиск звонков. Это необязательный параметр, используется только если не указан "ID звонка". Примеры: - {=Document:ID} - искать звонки в текущей сущности из документа (контакт, компания, лид); - 123 - искать звонки в сущности с ID 123; - {=Variable:CONTACT_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Особенности работы: - Если указан ID сущности без указания ID звонка, активити (робот) вернёт массив ID найденных звонков; - Если указан ID сущности и ID звонка, ID сущности игнорируется (приоритет у ID звонка); - Для сделок используйте параметры поиска в контактах или компании сделки. Важно: Этот параметр используется только если не указан "ID звонка". Если указан "ID звонка", то этот параметр игнорируется. Для работы этого параметра также рекомендуется указать "Тип сущности".
ID ответившего (звонящего) оператора	В данном поле можно указать идентификатор оператора (пользователя портала), который отвечал на звонок или производил звонок. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков. Примеры: - {=Document:ASSIGNED_BY_ID} - искать звонки оператора, ответственного за текущую сущность; - {=User:ID} - искать звонки текущего пользователя; - 25 - искать звонки оператора с ID 25; - [U1] - искать звонки оператора с ID 1 (формат с префиксом); - user_25 - искать звонки оператора с ID 25 (формат user_ID). Когда использовать: - Для фильтрации звонков конкретного оператора; - Для анализа работы конкретного сотрудника; - Для поиска звонков, выполненных определённым пользователем.
Номер на который поступил звонок	В данном поле можно указать номер телефона портала, на который поступил звонок. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков. Примеры: - +78124243277 - искать звонки на номер +7 (812) 424-32-77; - 8124243277 - искать звонки на номер без префикса; - {=Variable:PORTAL_NUMBER} - использовать номер из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации звонков по номеру портала; - Для поиска звонков на конкретную линию; - Для анализа звонков на определённые номера.
Номер клиента на который звонили	В данном поле можно указать номер телефона клиента, на который происходил звонок или с которого поступил звонок. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков. Примеры: - +79161234567 - искать звонки на номер клиента +7 (916) 123-45-67; - 89161234567 - искать звонки на номер без префикса; - {=Document:PHONE} - использовать номер телефона из текущей сущности; - {=Variable:CLIENT_PHONE} - использовать номер из переменной предыдущего активити (робота). Когда использовать: - Для поиска звонков конкретного клиента; - Для фильтрации звонков по номеру телефона; - Для анализа истории звонков с определённым номером.
Тип звонка	В данном поле можно указать тип искомого звонка: входящий или исходящий. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков или для проверки условий при указании ID звонка. Варианты выбора: - ИСХ (1) - исходящий звонок (звонок от оператора клиенту); - ВХ (2) - входящий звонок (звонок от клиента оператору). Примеры использования: - ИСХ - найти только исходящие звонки; - ВХ - найти только входящие звонки; - При указании ID звонка - проверить, соответствует ли тип звонка указанному значению. Когда использовать: - Для фильтрации звонков по типу (входящие/исходящие); - Для анализа активности операторов (исходящие звонки); - Для анализа входящей активности клиентов (входящие звонки).
Длительность звонка в секундах	В данном поле можно указать минимальную длительность звонка в секундах. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков или для проверки условий при указании ID звонка. Примеры: - 60 - найти звонки длительностью не менее 60 секунд (1 минута); - 300 - найти звонки длительностью не менее 300 секунд (5 минут); - {=Variable:MIN_DURATION} - использовать значение из переменной предыдущего активити (робота); - При указании ID звонка - проверить, соответствует ли длительность звонка указанному значению (точное совпадение). Особенности работы: - При поиске звонков: фильтр работает как "больше или равно" (>=), т.е. найдутся звонки с длительностью >= указанного значения; - При проверке по ID звонка: проверяется точное совпадение длительности (==). Когда использовать: - Для фильтрации коротких звонков (например, пропущенные или неудачные); - Для поиска длительных звонков (например, консультации); - Для проверки длительности конкретного звонка.
Статус звонка	В данном поле можно указать статус звонка, описывающий его состояние (отвечен, пропущен, отклонён и т.д.). Это необязательный параметр, используется как дополнительный фильтр при поиске звонков или для проверки условий при указании ID звонка. Поддерживается множественный выбор (можно указать несколько статусов). Варианты выбора: - 200 - Успешный звонок; - 304 - Пропущенный звонок; - 603 - Отклонено; - 603-S - Вызов отменен; - 403 - Запрещено; - 404 - Неверный номер; - 486 - Занято; - 484 - Данное направление не доступно; - 480 - Временно не доступен; - 402 - Недостаточно средств на счету; - 423 - Заблокировано. Примеры использования: - 200 - найти только успешные звонки; - 304, 603 - найти пропущенные и отклонённые звонки (множественный выбор); - При указании ID звонка - проверить, соответствует ли статус звонка указанному значению. Когда использовать: - Для фильтрации успешных звонков (статус 200); - Для поиска пропущенных звонков (статус 304); - Для анализа неудачных звонков (различные статусы ошибок); - Для проверки статуса конкретного звонка.
Выбрать звонки от указанной даты	В данном поле можно указать дату и время, начиная с которой будет осуществлён поиск звонков. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков. Примеры: - {=System:NowLocal} - искать звонки с текущей даты и времени; - ={{=dateadd({=System:Now}, "-7d")}} - искать звонки за последние 7 дней; - ={{=dateadd({=System:Now}, "-1m")}} - искать звонки за последний месяц; - 01.01.2025 00:00:00 - искать звонки с указанной даты; - {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска звонков за определённый период; - Для анализа звонков за последние дни/месяцы; - Для фильтрации звонков по дате начала.
Выбрать звонки до указанной даты	В данном поле можно указать дату и время, до которой будет осуществлён поиск звонков. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков. Примеры: - {=System:NowLocal} - искать звонки до текущей даты и времени; - ={{=dateadd({=System:Now}, "1d")}} - искать звонки до завтрашнего дня; - 31.12.2025 23:59:59 - искать звонки до указанной даты; - {=Variable:END_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска звонков за определённый период (в паре с параметром "Выбрать звонки от указанной даты"); - Для анализа звонков до определённой даты; - Для фильтрации звонков по дате окончания периода поиска.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Проверка соответствия звонка условиям по ID	Параметры: ID звонка - {=Variable:CALL_ID}, Тип звонка - ИСХ, Длительность звонка в секундах - 120, Статус звонка - 200. Активити (робот) проверит, соответствует ли звонок указанным условиям. Результат будет возвращён в параметре conditions (Y или N).
Поиск всех звонков контакта за последний месяц	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, Выбрать звонки от указанной даты - ={{=dateadd({=System:Now}, "-1m")}}, Выбрать звонки до указанной даты - {=System:NowLocal}. Активити (робот) найдёт все звонки контакта за последний месяц.
Поиск успешных исходящих звонков компании	Параметры: Тип сущности - COMPANY, ID Сущности - {=Document:COMPANY_ID}, Тип звонка - ИСХ, Статус звонка - 200. Активити (робот) найдёт все успешные исходящие звонки компании.
Поиск звонков в контактах сделки	Параметры: Тип сущности - DEAL, ID Сущности - {=Document:ID}, Искать звонки, в контактах, привязанных к Сделке - Да. Активити (робот) найдёт все звонки во всех контактах, привязанных к указанной сделке.
Поиск длительных звонков (более 5 минут)	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, Длительность звонка в секундах - 300. Активити (робот) найдёт все звонки контакта длительностью не менее 300 секунд (5 минут).
Поиск пропущенных входящих звонков	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, Тип звонка - ВХ, Статус звонка - 304. Активити (робот) найдёт все пропущенные входящие звонки контакта.
Поиск звонков конкретного оператора	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, ID ответившего (звонящего) оператора - {=User:ID}. Активити (робот) найдёт все звонки контакта, выполненные текущим пользователем.
Поиск звонков по номеру телефона клиента	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, Номер клиента на который звонили - {=Document:PHONE}. Активити (робот) найдёт все звонки контакта по указанному номеру телефона.
Поиск звонков в компании и контактах сделки	Параметры: Тип сущности - DEAL, ID Сущности - {=Document:ID}, Искать звонки, в контактах, привязанных к Сделке - Да, Искать звонки, в компании, привязанной к Сделке - Да. Активити (робот) найдёт все звонки в контактах и компании, привязанных к сделке.
Поиск звонков за рабочий день	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, Выбрать звонки от указанной даты - ={{=date('d.m.Y 09:00:00', {=System:Now})}}, Выбрать звонки до указанной даты - ={{=date('d.m.Y 18:00:00', {=System:Now})}}. Активити (робот) найдёт все звонки контакта за текущий рабочий день (с 9:00 до 18:00).

Поиск писем в сущности

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

• Поиск всех писем, связанных с конкретной сущностью CRM (контакт, компания, лид, сделка);
• Фильтрация писем по направлению (входящие/исходящие) и статусу;
• Поиск писем за определённый период времени;
• Проверка наличия письма с определёнными параметрами по ID письма;
• Поиск писем в смарт-процессах;
• Проверка статуса прочтения исходящих писем;
• Поиск необработанных входящих писем;
• Аналитика и отчётность по письмам клиентов;
• Автоматизация процессов на основе истории переписки;
• Проверка условий выполнения писем для условной логики в бизнес-процессах.

Название поля	Описание и примеры использования
ID письма	В данном поле указывается идентификатор письма для проверки его параметров. Это необязательный параметр, но если он указан, то другие параметры поиска (тип сущности, ID сущности и фильтры) не учитываются. Активити (робот) проверит соответствие письма указанным условиям (направление, статус письма, статус дела). Важно: Если указан ID письма, активити (робот) работает в режиме проверки условий. Параметры "Тип сущности", "ID сущности" и все фильтры игнорируются. Результат будет возвращён в параметре math_search_results (Y - соответствует условиям, N - не соответствует). Примеры: - {=Variable:LETTER_ID} - проверить письмо с ID из переменной предыдущего активити (робота); - 12345 - проверить письмо с ID 12345; - {=A1988_22222_92566_99999:search_results} - использовать ID письма из результата предыдущего поиска. Режим проверки условий: При указании ID письма активити (робот) проверяет соответствие письма указанным условиям: - Направление письма (обязательно указывается); - Статус письма (для входящих - статус дела, для исходящих - статус прочтения); - Статус дела (выполнено/не выполнено). Если все указанные условия выполнены, возвращается math_search_results = Y, иначе math_search_results = N.
Тип сущности	В данном поле указывается тип сущности CRM, в которой будет осуществлён поиск писем. Это необязательный параметр, используется только если не указан "ID письма". Выбирается из выпадающего списка. Варианты выбора: - LEAD - Лид; - DEAL - Сделка; - CONTACT - Контакт; - COMPANY - Компания; - QUOTE - Предложение; - SMART_INVOICE - Счёт (новый); - ORDER - Заказ; - СМАРТ: [название смарт-процесса] - для поиска писем в смарт-процессах (список формируется автоматически на основе настроек вашего портала). Примеры: - CONTACT - искать письма в контактах; - DEAL - искать письма в сделках; - LEAD - искать письма в лидах. Когда использовать: - Для поиска всех писем конкретной сущности; - Для фильтрации писем по типу сущности перед применением других фильтров.
ID сущности	В данном поле указывается идентификатор сущности CRM, в которой будет осуществлён поиск писем. Это необязательный параметр, используется только если указан "Тип сущности" и не указан "ID письма". Примеры: - {=Document:ID} - искать письма в текущей сущности из документа (контакт, компания, лид, сделка); - 123 - искать письма в сущности с ID 123; - {=Variable:CONTACT_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Когда использовать: - Для поиска всех писем конкретной сущности; - Для фильтрации писем по сущности перед применением других фильтров.
Направление письма	В данном поле указывается направление искомого письма: входящее или исходящее. Это обязательный параметр при поиске писем (если не указан ID письма). Варианты выбора: - Входящее (1) - письмо получено от клиента или партнёра; - Исходящее (2) - письмо отправлено клиенту или партнёру. Примеры использования: - Входящее (1) - найти только входящие письма; - Исходящее (2) - найти только исходящие письма. Особенности работы: - Для входящих писем проверяется статус дела (STATUS); - Для исходящих писем проверяется статус прочтения (READ_CONFIRMED в SETTINGS).
Статус письма	В данном поле указывается статус письма для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске писем или для проверки условий при указании ID письма. Варианты выбора: - Прочитано (1) - для исходящих писем: письмо прочитано получателем; - Не прочитано (2) - для исходящих писем: письмо не прочитано получателем; - Для входящих писем: статус дела (значение из поля STATUS). Примеры использования: - Прочитано (1) - найти только прочитанные исходящие письма; - Не прочитано (2) - найти только непрочитанные исходящие письма; - При указании ID письма - проверить, соответствует ли статус письма указанному значению. Особенности работы: - Для исходящих писем проверяется наличие ключа READ_CONFIRMED в SETTINGS; - Для входящих писем проверяется значение поля STATUS.
Статус дела	В данном поле указывается статус дела (выполнено или не выполнено) для фильтрации писем. Это необязательный параметр, используется как дополнительный фильтр при поиске писем или для проверки условий при указании ID письма. Варианты выбора: - Не выполнено (N) - дело не выполнено; - Выполнено (Y) - дело выполнено. Примеры использования: - Не выполнено (N) - найти только невыполненные письма; - Выполнено (Y) - найти только выполненные письма; - При указании ID письма - проверить, соответствует ли статус дела указанному значению. Когда использовать: - Для фильтрации необработанных писем; - Для поиска уже обработанных писем; - Для проверки статуса конкретного письма.
Дата создания от	В данном поле можно указать дату и время, начиная с которой будет осуществлён поиск писем. Это необязательный параметр, используется как дополнительный фильтр при поиске писем. Примеры: - {=System:NowLocal} - искать письма с текущей даты и времени; - ={{=dateadd({=System:Now}, "-7d")}} - искать письма за последние 7 дней; - ={{=dateadd({=System:Now}, "-1m")}} - искать письма за последний месяц; - 01.01.2025 00:00:00 - искать письма с указанной даты; - {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска писем за определённый период; - Для анализа писем за последние дни/месяцы; - Для фильтрации писем по дате начала.
Дата создания до	В данном поле можно указать дату и время, до которой будет осуществлён поиск писем. Это необязательный параметр, используется как дополнительный фильтр при поиске писем. Примеры: - {=System:NowLocal} - искать письма до текущей даты и времени; - ={{=dateadd({=System:Now}, "1d")}} - искать письма до завтрашнего дня; - 31.12.2025 23:59:59 - искать письма до указанной даты; - {=Variable:END_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска писем за определённый период (в паре с параметром "Дата создания от"); - Для анализа писем до определённой даты; - Для фильтрации писем по дате окончания периода поиска.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Проверка соответствия письма условиям по ID	Параметры: ID письма - {=Variable:LETTER_ID}, Направление письма - 2 (Исходящее), Статус письма - 1 (Прочитано), Статус дела - Y (Выполнено). Активити (робот) проверит, соответствует ли письмо указанным условиям. Результат будет возвращён в параметре math_search_results (Y или N).
Поиск всех входящих писем контакта	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Направление письма - 1 (Входящее), Статус письма - не указывается, Статус дела - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все входящие письма контакта.
Поиск непрочитанных исходящих писем	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - 2 (Не прочитано), Статус дела - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все непрочитанные исходящие письма контакта.
Поиск необработанных входящих писем	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Направление письма - 1 (Входящее), Статус письма - не указывается, Статус дела - N (Не выполнено), Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все необработанные входящие письма сделки.
Поиск писем за последний месяц	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - не указывается, Статус дела - не указывается, Дата создания от - ={{=dateadd({=System:Now}, "-1m")}}, Дата создания до - {=System:NowLocal}. Активити (робот) найдёт все исходящие письма контакта за последний месяц.
Поиск писем в смарт-процессе	Параметры: Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}, Направление письма - 1 (Входящее), Статус письма - не указывается, Статус дела - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все входящие письма элемента смарт-процесса.
Поиск прочитанных исходящих писем за рабочий день	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - 1 (Прочитано), Статус дела - не указывается, Дата создания от - ={{=date('d.m.Y 09:00:00', {=System:Now})}}, Дата создания до - ={{=date('d.m.Y 18:00:00', {=System:Now})}}. Активити (робот) найдёт все прочитанные исходящие письма контакта за текущий рабочий день.
Проверка статуса конкретного письма	Параметры: ID письма - {=Variable:LETTER_ID}, Направление письма - 1 (Входящее), Статус письма - не указывается, Статус дела - Y (Выполнено). Активити (робот) проверит, выполнено ли входящее письмо. Результат будет возвращён в параметре math_search_results.
Поиск писем через итератор	Параметры: Тип сущности - CONTACT, ID сущности - {=Iterator:Value}, Направление письма - 2 (Исходящее), Статус письма - не указывается, Статус дела - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Для каждого контакта из итератора активити (робот) найдёт все исходящие письма.
Поиск писем за определённый период с фильтрацией	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Направление письма - 1 (Входящее), Статус письма - не указывается, Статус дела - N (Не выполнено), Дата создания от - ={{=dateadd({=System:Now}, "-30d")}}, Дата создания до - {=System:NowLocal}. Активити (робот) найдёт все необработанные входящие письма сделки за последние 30 дней.

Поиск встреч в сущности

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

• Поиск всех встреч, связанных с конкретной сущностью CRM (контакт, компания, лид, сделка);
• Фильтрация встреч по ответственному, теме, описанию и месту проведения;
• Поиск встреч за определённый период времени;
• Проверка наличия встречи с определёнными параметрами по ID встречи;
• Поиск встреч в смарт-процессах;
• Проверка статуса встречи (выполнена/не выполнена);
• Поиск невыполненных встреч;
• Аналитика и отчётность по встречам клиентов;
• Автоматизация процессов на основе истории встреч;
• Проверка условий выполнения встреч для условной логики в бизнес-процессах.

Название поля	Описание и примеры использования
ID встречи	В данном поле указывается идентификатор встречи для проверки её параметров. Это необязательный параметр, но если он указан, то другие параметры поиска (тип сущности, ID сущности и фильтры) не учитываются. Активити (робот) проверит соответствие встречи указанным условиям (статус встречи). Важно: Если указан ID встречи, активити (робот) работает в режиме проверки условий. Параметры "Тип сущности", "ID сущности" и все фильтры игнорируются. Результат будет возвращён в параметре math_search_results (Y - соответствует условиям, N - не соответствует). Примеры: - {=Variable:MEETING_ID} - проверить встречу с ID из переменной предыдущего активити (робота); - 12345 - проверить встречу с ID 12345; - {=A1988_22222_92566_99999:search_results} - использовать ID встречи из результата предыдущего поиска. Режим проверки условий: При указании ID встречи активити (робот) проверяет соответствие встречи указанным условиям: - Статус встречи (если указан) - проверяется значение COMPLETED (N - не завершена, Y - завершена). Если все указанные условия выполнены, возвращается math_search_results = Y, иначе math_search_results = N.
Ответственный	В данном поле указывается сотрудник, ответственный за встречу. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - {=Document:ASSIGNED_BY_ID} - искать встречи ответственного из текущей сущности; - {=User:ID} - искать встречи текущего пользователя; - [U1] - искать встречи пользователя с ID 1; - user_25 - искать встречи пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации встреч по ответственному при поиске по сущности; - Для поиска всех встреч конкретного сотрудника, связанных с определённой сущностью; - Для анализа работы конкретного сотрудника.
Тип сущности	В данном поле указывается тип сущности CRM, в которой будет осуществлён поиск встреч. Это необязательный параметр, используется только если не указан "ID встречи". Выбирается из выпадающего списка. Варианты выбора: - LEAD - Лид; - DEAL - Сделка; - CONTACT - Контакт; - COMPANY - Компания; - QUOTE - Предложение; - SMART_INVOICE - Счёт (новый); - ORDER - Заказ; - СМАРТ: [название смарт-процесса] - для поиска встреч в смарт-процессах (список формируется автоматически на основе настроек вашего портала). Примеры: - CONTACT - искать встречи в контактах; - DEAL - искать встречи в сделках; - LEAD - искать встречи в лидах. Когда использовать: - Для поиска всех встреч конкретной сущности; - Для фильтрации встреч по типу сущности перед применением других фильтров.
ID сущности	В данном поле указывается идентификатор сущности CRM, в которой будет осуществлён поиск встреч. Это необязательный параметр, используется только если указан "Тип сущности" и не указан "ID встречи". Примеры: - {=Document:ID} - искать встречи в текущей сущности из документа (контакт, компания, лид, сделка); - 123 - искать встречи в сущности с ID 123; - {=Variable:CONTACT_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Когда использовать: - Для поиска всех встреч конкретной сущности; - Для фильтрации встреч по сущности перед применением других фильтров.
Статус встречи	В данном поле указывается статус встречи (выполнена или не выполнена) для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч или для проверки условий при указании ID встречи. Варианты выбора: - Не завершена (1) - встреча не завершена (COMPLETED = N); - Завершена (2) - встреча завершена (COMPLETED = Y). Примеры использования: - Не завершена (1) - найти только невыполненные встречи; - Завершена (2) - найти только выполненные встречи; - При указании ID встречи - проверить, соответствует ли статус встречи указанному значению. Когда использовать: - Для фильтрации невыполненных встреч; - Для поиска уже выполненных встреч; - Для проверки статуса конкретной встречи.
Тема встречи	В данном поле можно указать тему (заголовок) встречи для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - Презентация продукта - найти встречи с указанной темой; - {=Variable:MEETING_SUBJECT} - использовать тему из переменной предыдущего активити (робота); - Встреча с клиентом - найти встречи, содержащие указанный текст в теме. Когда использовать: - Для поиска встреч по конкретной теме; - Для фильтрации встреч по ключевым словам в теме.
Описание встречи	В данном поле можно указать описание встречи для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - Обсуждение условий договора - найти встречи с указанным описанием; - {=Variable:MEETING_DESCRIPTION} - использовать описание из переменной предыдущего активити (робота); - Консультация - найти встречи, содержащие указанный текст в описании. Когда использовать: - Для поиска встреч по содержанию описания; - Для фильтрации встреч по ключевым словам в описании.
Место проведения	В данном поле можно указать место проведения встречи для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - Офис компании - найти встречи, проводимые в указанном месте; - {=Variable:MEETING_LOCATION} - использовать место из переменной предыдущего активити (робота); - Онлайн - найти встречи, проводимые онлайн. Когда использовать: - Для поиска встреч по месту проведения; - Для фильтрации встреч по локации.
Дата создания от	В данном поле можно указать дату и время, начиная с которой будет осуществлён поиск встреч. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч. Примеры: - {=System:NowLocal} - искать встречи с текущей даты и времени; - ={{=dateadd({=System:Now}, "-7d")}} - искать встречи за последние 7 дней; - ={{=dateadd({=System:Now}, "-1m")}} - искать встречи за последний месяц; - 01.01.2025 00:00:00 - искать встречи с указанной даты; - {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска встреч за определённый период; - Для анализа встреч за последние дни/месяцы; - Для фильтрации встреч по дате начала.
Дата создания до	В данном поле можно указать дату и время, до которой будет осуществлён поиск встреч. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч. Примеры: - {=System:NowLocal} - искать встречи до текущей даты и времени; - ={{=dateadd({=System:Now}, "1d")}} - искать встречи до завтрашнего дня; - 31.12.2025 23:59:59 - искать встречи до указанной даты; - {=Variable:END_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска встреч за определённый период (в паре с параметром "Дата создания от"); - Для анализа встреч до определённой даты; - Для фильтрации встреч по дате окончания периода поиска.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Проверка соответствия встречи условиям по ID	Параметры: ID встречи - {=Variable:MEETING_ID}, Статус встречи - 2 (Завершена). Активити (робот) проверит, завершена ли встреча. Результат будет возвращён в параметре math_search_results (Y или N).
Поиск всех встреч контакта	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все встречи контакта.
Поиск невыполненных встреч сделки	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - 1 (Не завершена), Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все невыполненные встречи сделки.
Поиск встреч ответственного за последний месяц	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Ответственный - {=User:ID}, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - ={{=dateadd({=System:Now}, "-1m")}}, Дата создания до - {=System:NowLocal}. Активити (робот) найдёт все встречи текущего пользователя с контактом за последний месяц.
Поиск встреч по теме	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - "Презентация", Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все встречи сделки с указанной темой.
Поиск встреч в смарт-процессе	Параметры: Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все встречи элемента смарт-процесса.
Поиск встреч за рабочий день	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - ={{=date('d.m.Y 09:00:00', {=System:Now})}}, Дата создания до - ={{=date('d.m.Y 18:00:00', {=System:Now})}}. Активити (робот) найдёт все встречи контакта за текущий рабочий день.
Проверка статуса конкретной встречи	Параметры: ID встречи - {=Variable:MEETING_ID}, Статус встречи - 1 (Не завершена). Активити (робот) проверит, не завершена ли встреча. Результат будет возвращён в параметре math_search_results.
Поиск встреч через итератор	Параметры: Тип сущности - CONTACT, ID сущности - {=Iterator:Value}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Для каждого контакта из итератора активити (робот) найдёт все встречи.
Поиск встреч за определённый период с фильтрацией	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Ответственный - {=Document:ASSIGNED_BY_ID}, Статус встречи - 1 (Не завершена), Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - ={{=dateadd({=System:Now}, "-30d")}}, Дата создания до - {=System:NowLocal}. Активити (робот) найдёт все невыполненные встречи ответственного по сделке за последние 30 дней.

Поиск визитов в сущности

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

• Поиск визитов, привязанных к конкретной сущности CRM (сделка, лид, контакт, компания);
• Проверка статуса визита по его ID;
• Фильтрация визитов по статусу (выполнено/не выполнено);
• Поиск визитов за определённый период времени;
• Поиск визитов по теме или описанию;
• Поиск визитов в смарт-процессах;
• Проверка соответствия визита определённым условиям;
• Аналитика и отчётность по визитам;
• Автоматизация процессов на основе найденных визитов;
• Проверка наличия визитов перед выполнением операций.

Название поля	Описание и примеры использования
ID визитов (если заполнено, то учитывается только статус)	В данном поле указывается идентификатор визита для проверки его статуса. Это необязательный параметр, но если он указан, то другие параметры поиска (тип сущности, ID сущности и фильтры) не учитываются. Активити (робот) проверит соответствие визита указанным условиям (статус визита). Важно: Если указан ID визита, активити (робот) работает в режиме проверки условий. Параметры "Тип Сущности", "ID сущности" и все фильтры игнорируются. Результат будет возвращён в параметре math_search_results (Y - соответствует условиям, N - не соответствует). Примеры: - {=Variable:VISIT_ID} - проверить визит с ID из переменной предыдущего активити (робота); - 12345 - проверить визит с ID 12345; - {=A1988_22222_92566_99999:search_results_array} - использовать ID визита из результата предыдущего поиска. Режим проверки условий: При указании ID визита активити (робот) проверяет соответствие визита указанным условиям: - Статус визита (если указан) - проверяется соответствие статуса (выполнено/не выполнено). Если все указанные условия выполнены, возвращается math_search_results = Y, иначе math_search_results = N.
Тип Сущности	В данном поле указывается тип сущности CRM, в которой будет осуществлён поиск визитов. Это необязательный параметр, используется только если не указан "ID визитов". Выбирается из выпадающего списка. Варианты выбора: - LEAD - Лид; - DEAL - Сделка; - CONTACT - Контакт; - COMPANY - Компания; - QUOTE - Предложение; - SMART_INVOICE - Счёт; - ORDER - Заказ; - СМАРТ: [название смарт-процесса] - для поиска визитов в смарт-процессах (список формируется автоматически на основе настроек вашего портала, формат: TYPE_ID:OWNER_TYPE_ID). Примеры: - CONTACT - искать визиты в контактах; - COMPANY - искать визиты в компаниях; - DEAL - искать визиты в сделках; - СМАРТ: Заявки - искать визиты в смарт-процессе "Заявки". Важно: Этот параметр используется только если не указан "ID визитов". Если указан "ID визитов", то этот параметр игнорируется. Для работы этого параметра также рекомендуется указать "ID сущности".
ID сущности	В данном поле указывается идентификатор сущности CRM, в которой будет осуществлён поиск визитов. Это необязательный параметр, используется только если не указан "ID визитов". Примеры: - {=Document:ID} - искать визиты в текущей сущности из документа (контакт, компания, лид, сделка); - 123 - искать визиты в сущности с ID 123; - {=Variable:CONTACT_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Особенности работы: - Если указан ID сущности без указания ID визита, активити (робот) вернёт массив ID найденных визитов; - Если указан ID сущности и ID визита, ID сущности игнорируется (приоритет у ID визита); - Для работы этого параметра рекомендуется указать "Тип Сущности".
Статус визита	В данном поле можно указать статус визита для фильтрации результатов или для проверки условий при указании ID визита. Это необязательный параметр. Варианты выбора: - Не завершена (1) - визит не выполнен (COMPLETED = N); - Завершена (2) - визит выполнен (COMPLETED = Y). Примеры использования: - Не завершена (1) - найти только невыполненные визиты; - Завершена (2) - найти только выполненные визиты; - При указании ID визита - проверить, соответствует ли статус визита указанному значению. Когда использовать: - Для фильтрации визитов по статусу при поиске в сущности; - Для проверки статуса конкретного визита при указании ID визита; - Для анализа выполненных или невыполненных визитов.
Выбрать визиты от указанной даты	В данном поле можно указать дату и время, начиная с которой будет осуществлён поиск визитов. Это необязательный параметр, используется как дополнительный фильтр при поиске визитов. Примеры: - {=System:NowLocal} - искать визиты с текущей даты и времени; - ={{=dateadd({=System:Now}, "-7d")}} - искать визиты за последние 7 дней; - ={{=dateadd({=System:Now}, "-1m")}} - искать визиты за последний месяц; - 01.01.2025 00:00:00 - искать визиты с указанной даты; - {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска визитов за определённый период; - Для анализа визитов за последние дни/месяцы; - Для фильтрации визитов по дате создания.
Выбрать визиты до указанной даты	В данном поле можно указать дату и время, до которой будет осуществлён поиск визитов. Это необязательный параметр, используется как дополнительный фильтр при поиске визитов. Примеры: - {=System:NowLocal} - искать визиты до текущей даты и времени; - ={{=dateadd({=System:Now}, "1d")}} - искать визиты до завтрашнего дня; - 31.12.2025 23:59:59 - искать визиты до указанной даты; - {=Variable:END_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска визитов за определённый период (в паре с параметром "Выбрать визиты от указанной даты"); - Для анализа визитов до определённой даты; - Для фильтрации визитов по дате окончания периода поиска.
Тема визита содержит	В данном поле можно указать текст, который должен содержаться в теме визита. Это необязательный параметр, используется как дополнительный фильтр при поиске визитов. Примеры: - Важное - найти визиты, тема которых содержит слово "Важное"; - Консультация - найти визиты, тема которых содержит слово "Консультация"; - {=Variable:SEARCH_TEXT} - использовать текст из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации визитов по теме; - Для поиска визитов с определёнными ключевыми словами в теме; - Для анализа визитов по тематике.
Содержание визита содержит	В данном поле можно указать текст, который должен содержаться в описании визита. Это необязательный параметр, используется как дополнительный фильтр при поиске визитов. Примеры: - Демонстрация - найти визиты, описание которых содержит слово "Демонстрация"; - Продукт - найти визиты, описание которых содержит слово "Продукт"; - {=Variable:SEARCH_TEXT} - использовать текст из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации визитов по содержанию; - Для поиска визитов с определёнными ключевыми словами в описании; - Для анализа визитов по содержанию.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Проверка статуса визита по ID	Параметры: ID визитов - {=Variable:VISIT_ID}, Статус визита - Завершена (2). Активити (робот) проверит, является ли визит выполненным. Результат будет возвращён в параметре math_search_results (Y или N).
Поиск всех визитов контакта	Параметры: Тип Сущности - CONTACT, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Активити (робот) найдёт все визиты контакта.
Поиск выполненных визитов сделки	Параметры: Тип Сущности - DEAL, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - Завершена (2), Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Активити (робот) найдёт все выполненные визиты сделки.
Поиск визитов за последний месяц	Параметры: Тип Сущности - CONTACT, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - ={{=dateadd({=System:Now}, "-1m")}}, Выбрать визиты до указанной даты - {=System:NowLocal}, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Активити (робот) найдёт все визиты контакта за последний месяц.
Поиск визитов по теме	Параметры: Тип Сущности - COMPANY, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - Консультация, Содержание визита содержит - не указывается. Активити (робот) найдёт все визиты компании, тема которых содержит слово "Консультация".
Поиск невыполненных визитов за период	Параметры: Тип Сущности - DEAL, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - Не завершена (1), Выбрать визиты от указанной даты - ={{=dateadd({=System:Now}, "-7d")}}, Выбрать визиты до указанной даты - {=System:NowLocal}, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Активити (робот) найдёт все невыполненные визиты сделки за последние 7 дней.
Поиск визитов через итератор	Параметры: Тип Сущности - CONTACT, ID сущности - {=Iterator:Value}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Для каждого ID контакта из итератора активити (робот) найдёт все визиты этого контакта.
Поиск визитов смарт-процесса	Параметры: Тип Сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Активити (робот) найдёт все визиты, привязанные к указанному элементу смарт-процесса "Заявки".
Поиск визитов по содержанию	Параметры: Тип Сущности - CONTACT, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - не указывается, Содержание визита содержит - Демонстрация. Активити (робот) найдёт все визиты контакта, описание которых содержит слово "Демонстрация".
Комплексный поиск визитов	Параметры: Тип Сущности - DEAL, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - Завершена (2), Выбрать визиты от указанной даты - ={{=dateadd({=System:Now}, "-30d")}}, Выбрать визиты до указанной даты - {=System:NowLocal}, Тема визита содержит - Важное, Содержание визита содержит - не указывается. Активити (робот) найдёт все выполненные визиты сделки за последние 30 дней, тема которых содержит слово "Важное".

Парсинг содержимого дела

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

• Извлечение конкретных данных из темы или описания дела;
• Парсинг номеров документов, сумм, дат и других данных из текста дела;
• Извлечение слов до или после указанного слова;
• Извлечение содержимого между двумя словами;
• Поиск и извлечение чисел из текста дела;
  
• Автоматическое извлечение данных для заполнения полей сущностей CRM;
• Парсинг данных из писем, звонков и других дел;
• Обработка структурированных данных в тексте дела;
• Извлечение информации для аналитики и отчётности;
• Автоматизация обработки данных из внешних источников.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, содержимое которого нужно распарсить. Это обязательный параметр. Примеры: - {=Variable:ACTIVITY_ID} - распарсить дело с ID из переменной предыдущего активити (робота); - 123 - распарсить дело с ID 123; - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска дел; - {=Document:ID} - распарсить дело, если ID дела совпадает с ID документа; - {=Iterator:Value} - распарсить дело для каждого ID из итератора. Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если дело с указанным ID не существует, активити (робот) завершится с ошибкой. Всегда проверяйте существование дела перед парсингом.
Парсинг темы дела	В данном поле указываются правила парсинга для темы (заголовка) дела. Это необязательный параметр, поддерживается множественный выбор (до 10 правил). Каждое правило имеет формат: "ТИП_ПАРСИНГА##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2". Типы парсинга: - 1##РАЗДЕЛИТЕЛЬ - получить слово до указанного разделителя (предыдущее слово); - 2##РАЗДЕЛИТЕЛЬ - получить слово после указанного разделителя (следующее слово); - 3##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2 - получить содержимое между двумя разделителями; - 4##КЛЮЧЕВОЕ_СЛОВО - найти и извлечь число из слова, содержащего ключевое слово. Примеры: - 1##Сделка - получить слово перед словом "Сделка" (например, из "Новая Сделка 123" получится "Новая"); - 2##№ - получить слово после символа "№" (например, из "Сделка №123" получится "123"); - 3##от##руб - получить содержимое между словами "от" и "руб" (например, из "Сумма от 10000 руб" получится "10000"); - 4##сумма - найти и извлечь число из слова, содержащего "сумма" (например, из "сумма12345" получится "12345"). Когда использовать: - Для извлечения данных из структурированных тем дел; - Для парсинга номеров, сумм и других данных из заголовка дела; - Для извлечения ключевой информации из темы дела.
Парсинг описания дела	В данном поле указываются правила парсинга для описания (содержания) дела. Это необязательный параметр, поддерживается множественный выбор (до 10 правил). Каждое правило имеет формат: "ТИП_ПАРСИНГА##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2". Типы парсинга: - 1##РАЗДЕЛИТЕЛЬ - получить слово до указанного разделителя (предыдущее слово); - 2##РАЗДЕЛИТЕЛЬ - получить слово после указанного разделителя (следующее слово); - 3##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2 - получить содержимое между двумя разделителями; - 4##КЛЮЧЕВОЕ_СЛОВО - найти и извлечь число из слова, содержащего ключевое слово. Примеры: - 1##Сумма - получить слово перед словом "Сумма" (например, из "Общая Сумма 50000" получится "Общая"); - 2##: - получить слово после двоеточия (например, из "Номер: 12345" получится "12345"); - 3##от##до - получить содержимое между словами "от" и "до" (например, из "Период от 01.01.2025 до 31.01.2025" получится "01.01.2025"); - 4##цена - найти и извлечь число из слова, содержащего "цена" (например, из "цена1000" получится "1000"). Когда использовать: - Для извлечения данных из структурированных описаний дел; - Для парсинга данных из писем, звонков и других дел; - Для извлечения информации из текста дела для дальнейшей обработки.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Извлечение номера сделки из темы дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№ (получить слово после "№"), Парсинг описания дела - не указывается. Если тема дела "Сделка №12345", активити (робот) извлечёт "12345" в параметр found_result_1.
Извлечение суммы из описания дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - не указывается, Парсинг описания дела - 3##Сумма:##руб (получить содержимое между "Сумма:" и "руб"). Если описание "Общая Сумма: 50000 руб", активити (робот) извлечёт "50000" в параметр found_result_1.
Извлечение нескольких данных из темы	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№, 2##от (два правила: получить слово после "№" и после "от"), Парсинг описания дела - не указывается. Если тема "Сделка №123 от 01.01.2025", активити (робот) извлечёт "123" в found_result_1 и "01.01.2025" в found_result_2.
Извлечение числа из слова с ключевым словом	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 4##сумма (найти число в слове, содержащем "сумма"), Парсинг описания дела - не указывается. Если тема содержит "сумма12345" или "сумма_12345", активити (робот) извлечёт "12345" в параметр found_result_1.
Извлечение данных между разделителями	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - не указывается, Парсинг описания дела - 3##от##до (получить содержимое между "от" и "до"). Если описание "Период от 01.01.2025 до 31.01.2025", активити (робот) извлечёт "01.01.2025" в параметр found_result_1.
Извлечение слова до указанного разделителя	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 1##Сделка (получить слово перед "Сделка"), Парсинг описания дела - не указывается. Если тема "Новая Сделка 123", активити (робот) извлечёт "Новая" в параметр found_result_1.
Комплексный парсинг темы и описания	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№ (получить номер после "№"), Парсинг описания дела - 3##Сумма:##руб, 2##Дата: (получить сумму и дату из описания). Активити (робот) извлечёт номер в found_result_1, сумму в found_result_1 (из описания), дату в found_result_2 (из описания).
Парсинг через итератор	Параметры: ID дела - {=Iterator:Value}, Парсинг темы дела - 2##№, Парсинг описания дела - 3##Сумма:##руб. Для каждого дела из итератора активити (робот) извлечёт номер и сумму.
Извлечение данных для заполнения полей	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№ (номер сделки), Парсинг описания дела - 3##Сумма:##руб (сумма сделки). Используйте найденные значения для заполнения полей сущности CRM через активити (робот) "Изменение дела" или другие активити.
Парсинг структурированных данных	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - не указывается, Парсинг описания дела - 2##Номер:, 2##Телефон:, 2##Email: (извлечь номер, телефон и email из структурированного описания). Активити (робот) извлечёт все указанные данные в отдельные параметры.

Слежение за делом

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

• Автоматическое отслеживание создания дел, привязанных к сущности CRM;
• Автоматическое отслеживание обновления дел, привязанных к сущности CRM;
• Реагирование на события создания или изменения дел в бизнес-процессах;
• Фильтрация отслеживаемых дел по типу (звонок, письмо, встреча и т.д.);
• Фильтрация отслеживаемых дел по направлению (входящие/исходящие);
• Автоматизация процессов при создании или изменении дел;
• Отслеживание дел в смарт-процессах;
• Мониторинг активности по сущностям CRM;
• Автоматическое выполнение действий при изменении дел;
• Интеграция с внешними системами на основе событий дел.

Название поля	Описание и примеры использования
Тип CRM сущности	В данном поле указывается тип сущности CRM, за делами которой нужно следить. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Лид (L) - для отслеживания дел, привязанных к лидам; - Сделка (D) - для отслеживания дел, привязанных к сделкам; - Контакт (C) - для отслеживания дел, привязанных к контактам; - Компания (CO) - для отслеживания дел, привязанных к компаниям; - Предложение (Q) - для отслеживания дел, привязанных к предложениям; - Заказ (O) - для отслеживания дел, привязанных к заказам; - Счёт (SI) - для отслеживания дел, привязанных к счетам; - СМАРТ: [название смарт-процесса] - для отслеживания дел, привязанных к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - Сделка (D) - отслеживать дела, привязанные к сделкам; - Контакт (C) - отслеживать дела, привязанные к контактам; - СМАРТ: Заявки - отслеживать дела, привязанные к смарт-процессу "Заявки". Важно: Для смарт-процессов используется формат TYPE_ID:OWNER_TYPE_ID (например, 1:135), где TYPE_ID - тип дела, OWNER_TYPE_ID - ID типа сущности смарт-процесса.
ID CRM сущности	В данном поле указывается идентификатор сущности CRM, за делами которой нужно следить. Это обязательный параметр. Примеры: - {=Document:ID} - следить за делами текущей сущности из документа (сделка, лид, контакт, компания); - 123 - следить за делами сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой.
Тип дела	В данном поле указываются типы дел, за которыми нужно следить. Это обязательный параметр, поддерживается множественный выбор. Можно выбрать несколько типов дел одновременно. Варианты выбора: - Универсальное (CRM_TODO) - универсальные дела; - Встреча (CRM_MEETING) - дела типа "Встреча"; - Звонок (VOXIMPLANT_CALL) - дела типа "Звонок"; - Письмо (CRM_EMAIL) - дела типа "Письмо"; - Задачи (TASKS) - задачи (старые дела для обратной совместимости); - Задача (новая) (CRM_TASKS_TASK) - задачи в новой реализации; - Чат (IMOPENLINES_SESSION) - дела типа "Чат"; - Обзвон (CALL_LIST) - дела типа "Обзвон"; - SMS (CRM_SMS) - дела типа "SMS"; - CRM форма (CRM_WEBFORM) - дела типа "CRM форма"; - Визит (VISIT_TRACKER) - дела типа "Визит"; - Слоты (CRM_CALENDAR_SHARING) - дела типа "Слоты"; - Доставка (CRM_DELIVERY) - дела типа "Доставка"; - Документ подписания (CRM_SIGN_DOCUMENT) - дела типа "Документ подписания"; - Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION) - дела типа "Сообщение в WhatsApp"; - Оплата (CRM_PAYMENT) - дела типа "Оплата"; - Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW) - дела типа "Дело бизнес-процесса"; - И другие типы дел. Примеры использования: - Звонок - отслеживать только дела типа "Звонок"; - Письмо - отслеживать только дела типа "Письмо"; - Звонок, Письмо, Встреча - отслеживать несколько типов дел одновременно (множественный выбор). Когда использовать: - Для фильтрации отслеживаемых дел по типу; - Для отслеживания только определённых типов дел; - Для настройки гибкого мониторинга различных типов активности.
Направление дела	В данном поле указывается направление дел, за которыми нужно следить: входящие или исходящие. Это необязательный параметр, поддерживается множественный выбор. Используется для фильтрации событий по направлению дел. Варианты выбора: - Входящее (1) - отслеживать только входящие дела (полученные от клиентов или партнёров); - Исходящее (2) - отслеживать только исходящие дела (отправленные клиентам или партнёрам). Примеры использования: - Входящее (1) - отслеживать только входящие дела; - Исходящее (2) - отслеживать только исходящие дела; - Входящее, Исходящее - отслеживать дела обоих направлений (множественный выбор). Когда использовать: - Для фильтрации отслеживаемых дел по направлению; - Для отслеживания только входящей или только исходящей активности; - Для настройки различных процессов для разных направлений дел.
На какое событие реагировать	В данном поле указываются события, на которые нужно реагировать. Это обязательный параметр, поддерживается множественный выбор. Можно выбрать одно или оба события одновременно. Варианты выбора: - Создание дела (onCrmActivityAdd) - реагировать на создание нового дела; - Обновление дела (onCrmActivityUpdate) - реагировать на обновление существующего дела. Примеры использования: - Создание дела - реагировать только на создание новых дел; - Обновление дела - реагировать только на обновление существующих дел; - Создание дела, Обновление дела - реагировать на оба события (множественный выбор). Когда использовать: - Для отслеживания только создания новых дел; - Для отслеживания только изменений существующих дел; - Для отслеживания всех изменений дел (создание и обновление).
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Отслеживание создания всех дел по сделке	Параметры: Тип CRM сущности - Сделка (D), ID CRM сущности - {=Document:ID}, Тип дела - не указывается (все типы), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела. Активити (робот) будет отслеживать создание всех дел, привязанных к указанной сделке.
Отслеживание только звонков контакта	Параметры: Тип CRM сущности - Контакт (C), ID CRM сущности - {=Document:ID}, Тип дела - Звонок (VOXIMPLANT_CALL), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела, Обновление дела. Активити (робот) будет отслеживать создание и обновление только звонков, привязанных к указанному контакту.
Отслеживание входящих писем сделки	Параметры: Тип CRM сущности - Сделка (D), ID CRM сущности - {=Document:ID}, Тип дела - Письмо (CRM_EMAIL), Направление дела - Входящее (1), На какое событие реагировать - Создание дела. Активити (робот) будет отслеживать создание только входящих писем, привязанных к указанной сделке.
Отслеживание обновления встреч	Параметры: Тип CRM сущности - Контакт (C), ID CRM сущности - {=Document:ID}, Тип дела - Встреча (CRM_MEETING), Направление дела - не указывается (все направления), На какое событие реагировать - Обновление дела. Активити (робот) будет отслеживать обновление встреч, привязанных к указанному контакту.
Отслеживание дел в смарт-процессе	Параметры: Тип CRM сущности - СМАРТ: Заявки, ID CRM сущности - {=Document:ID}, Тип дела - не указывается (все типы), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела. Активити (робот) будет отслеживать создание всех дел, привязанных к указанному элементу смарт-процесса.
Отслеживание нескольких типов дел	Параметры: Тип CRM сущности - Сделка (D), ID CRM сущности - {=Document:ID}, Тип дела - Звонок (VOXIMPLANT_CALL), Письмо (CRM_EMAIL), Встреча (CRM_MEETING) (множественный выбор), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела. Активити (робот) будет отслеживать создание звонков, писем и встреч, привязанных к указанной сделке.
Отслеживание исходящих дел	Параметры: Тип CRM сущности - Контакт (C), ID CRM сущности - {=Document:ID}, Тип дела - не указывается (все типы), Направление дела - Исходящее (2), На какое событие реагировать - Создание дела, Обновление дела. Активити (робот) будет отслеживать создание и обновление только исходящих дел, привязанных к указанному контакту.
Отслеживание всех изменений дел	Параметры: Тип CRM сущности - Сделка (D), ID CRM сущности - {=Document:ID}, Тип дела - не указывается (все типы), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела, Обновление дела. Активити (робот) будет отслеживать все изменения дел (создание и обновление), привязанных к указанной сделке.
Отслеживание через итератор	Параметры: Тип CRM сущности - Контакт (C), ID CRM сущности - {=Iterator:Value}, Тип дела - не указывается (все типы), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела. Для каждого контакта из итератора активити (робот) настроит отслеживание создания дел.
Отслеживание только задач	Параметры: Тип CRM сущности - Сделка (D), ID CRM сущности - {=Document:ID}, Тип дела - Задача (новая) (CRM_TASKS_TASK), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела, Обновление дела. Активити (робот) будет отслеживать создание и обновление только задач, привязанных к указанной сделке.

Запланировать звонок

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

• Автоматическое планирование звонков клиентам;
• Создание запланированных звонков при изменении статуса сделки или лида;
• Планирование звонков на основе данных из внешних систем;
• Автоматическое создание звонков при поступлении заявок;
• Планирование звонков с автоматическим определением номера телефона;
• Создание звонков, привязанных к сделке с автоматическим определением контакта или компании;
• Автоматизация планирования звонков для менеджеров;
• Создание звонков с указанием даты и времени;
• Планирование звонков с приоритетом;
• Автоматическое создание звонков при выполнении определённых условий.

Название поля	Описание и примеры использования
Тип сущности	В данном поле указывается тип сущности, к которой будет привязан создаваемый звонок. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Лид (1) - для привязки звонка к лиду; - Контакт (3) - для привязки звонка к контакту; - Компания (4) - для привязки звонка к компании. Примеры использования: - Лид (1) - для создания звонка, привязанного к лиду; - Контакт (3) - для создания звонка, привязанного к контакту; - Компания (4) - для создания звонка, привязанного к компании. Важно: Если указан параметр "ID сделки", то параметр "Тип сущности" используется только для определения типа сущности, из которой будет взят номер телефона (контакт или компания сделки).
ID Сущности	В данном поле указывается числовой идентификатор (ID) сущности, к которой будет привязан создаваемый звонок. Это обязательный параметр, используется только если не указан параметр "ID сделки". Примеры: - {=Document:ID} - привязать звонок к текущей сущности из документа (лид, контакт, компания); - 123 - привязать звонок к сущности с ID 123; - {=Variable:LEAD_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой.
ID сделки	В данном поле можно указать идентификатор сделки, к которой будет привязан создаваемый звонок. Это необязательный параметр. Если указан, то звонок будет привязан к сделке, а номер телефона будет взят из контакта или компании, привязанных к сделке. Примеры: - {=Document:ID} - привязать звонок к текущей сделке из документа; - 123 - привязать звонок к сделке с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска. Особенности работы: - Если указан ID сделки, звонок будет привязан к сделке, а не к указанной сущности; - Номер телефона будет автоматически взят из контакта или компании, привязанных к сделке (в зависимости от типа сущности); - Если у сделки нет привязанного контакта или компании, активити (робот) завершится с ошибкой. Важно: Если указан ID сделки, то параметр "ID Сущности" игнорируется. Номер телефона будет взят из контакта или компании сделки в зависимости от типа сущности. Если у сделки нет привязанного контакта (для типа "Контакт") или компании (для типа "Компания"), активити (робот) завершится с ошибкой.
Телефон	В данном поле можно указать номер телефона для звонка. Это необязательный параметр. Если не указан, номер телефона будет автоматически взят из сущности (лид, контакт, компания) или из контакта/компании сделки. Примеры: - +79161234567 - указать номер телефона напрямую; - 89161234567 - указать номер без префикса; - {=Document:PHONE} - использовать номер телефона из текущей сущности; - {=Variable:PHONE_NUMBER} - использовать номер из переменной предыдущего активити (робота). Особенности работы: - Если номер телефона указан, он будет использован напрямую; - Если номер телефона не указан, активити (робот) автоматически возьмёт номер из сущности: * Для лида - из поля PHONE лида; * Для контакта - из поля PHONE контакта; * Для компании - из поля PHONE компании; * Для сделки - из поля PHONE контакта или компании сделки (в зависимости от типа сущности). Важно: Если номер телефона не указан и не найден в сущности, активити (робот) завершится с ошибкой "Отсутствует номер телефона".
Тема	В данном поле указывается тема (заголовок) звонка. Это обязательный параметр. Примеры: - Звонок клиенту по сделке #{=Document:ID}; - Консультация по продукту; - Напоминание о встрече; - ={{={=Variable:SUBJECT} & " - Дополнительная информация"}} - добавить информацию к теме из переменной. Рекомендации: - Используйте информативные темы, которые помогут быстро понять суть звонка; - Можно включать переменные и поля из текущей сущности для персонализации.
Описание	В данном поле указывается описание и содержание звонка. Это обязательный параметр. Примеры: - Необходимо обсудить условия сделки и ответить на вопросы клиента.; - Провести консультацию по продукту. Клиент заинтересован в функциях X и Y.; - Напомнить о предстоящей встрече и уточнить детали.; - ={{={=Variable:DESCRIPTION} & "[br]Дополнительная информация: " & {=Variable:ADDITIONAL_INFO}}}} - объединить несколько переменных с форматированием. Рекомендации: - Используйте подробные описания для лучшего понимания цели звонка; - Можно включать переменные и поля из текущей сущности для персонализации.
Ответственный	В данном поле указывается сотрудник, ответственный за выполнение звонка. Это обязательный параметр. Примеры: - {=Document:ASSIGNED_BY_ID} - назначить ответственным ответственного из текущей сущности; - {=User:ID} - назначить ответственным текущего пользователя; - [U1] - назначить ответственным пользователя с ID 1; - user_25 - назначить ответственным пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Рекомендации: - Используйте ответственного из текущей сущности для автоматического назначения; - Можно назначать конкретного сотрудника для специализированных звонков.
Приоритет	В данном поле можно указать приоритет звонка. Это необязательный параметр (варианты: да/нет). Варианты выбора: - Нет (N) - обычный приоритет; - Да (Y) - высокий приоритет (важный звонок). Примеры использования: - Нет (N) - для обычных звонков; - Да (Y) - для важных звонков, требующих срочного выполнения. Рекомендации: - Используйте высокий приоритет только для действительно важных звонков; - Высокоприоритетные звонки выделяются в интерфейсе CRM.
Дата начала	В данном поле можно указать дату и время начала звонка. Это необязательный параметр. Если не указано, дата начала не будет установлена. Примеры: - {=System:NowLocal} - установить текущую дату и время; - ={{=dateadd({=System:Now}, "1d")}} - установить дату начала через 1 день от текущего момента; - ={{=workdateadd({=System:Now}, "2d", {=Document:ASSIGNED_BY_ID})}} - установить дату начала через 2 рабочих дня с учётом рабочего времени ответственного; - ={{=dateadd({=Document:BEGINDATE}, "1h")}} - установить дату начала через 1 час от даты начала сделки; - 15.01.2025 10:00:00 - указать конкретную дату и время. Рекомендации: - Используйте функции работы с датами для автоматического расчёта времени начала; - Учитывайте рабочие дни и часы при планировании звонков.
Дата завершения	В данном поле можно указать дату и время завершения звонка. Это необязательный параметр. Если не указано, дата завершения не будет установлена. Примеры: - ={{=dateadd({=System:Now}, "30m")}} - установить дату завершения через 30 минут от текущего момента (типичная длительность звонка); - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}} - установить дату завершения через 1 рабочий день с учётом рабочего времени ответственного; - ={{=dateadd({=Variable:DATE_START}, "1h")}} - установить дату завершения через 1 час от даты начала (из переменной); - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}} - установить дату завершения на 1 день раньше даты закрытия сделки; - 15.01.2025 10:30:00 - указать конкретную дату и время завершения. Рекомендации: - Дата завершения должна быть позже даты начала; - Используйте функции работы с датами для автоматического расчёта времени завершения; - Типичная длительность звонка составляет 15-30 минут.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Планирование звонка лиду	Параметры: Тип сущности - Лид (1), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается (будет взят из лида), Тема - "Звонок по заявке #{=Document:ID}", Описание - "Необходимо связаться с клиентом для уточнения деталей заявки", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - ={{=dateadd({=System:Now}, "1d")}}, Дата завершения - ={{=dateadd({=System:Now}, "1d 30m")}}.
Планирование звонка контакту с указанием номера	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - +79161234567, Тема - "Консультация по продукту", Описание - "Провести консультацию по продукту и ответить на вопросы клиента", Ответственный - {=User:ID}, Приоритет - Да (Y), Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "30m")}}.
Планирование звонка по сделке с автоматическим определением контакта	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:CONTACT_ID}, ID сделки - {=Document:ID}, Телефон - не указывается (будет взят из контакта сделки), Тема - "Звонок по сделке #{=Document:ID}", Описание - "Обсудить условия сделки и ответить на вопросы клиента", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}}, Дата завершения - ={{=workdateadd({=System:Now}, "1d 30m", {=Document:ASSIGNED_BY_ID})}}.
Планирование звонка компании	Параметры: Тип сущности - Компания (4), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается (будет взят из компании), Тема - "Звонок в компанию {=Document:TITLE}", Описание - "Связаться с компанией для обсуждения сотрудничества", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Да (Y), Дата начала - ={{=dateadd({=System:Now}, "2d")}}, Дата завершения - ={{=dateadd({=System:Now}, "2d 30m")}}.
Планирование звонка по сделке с автоматическим определением компании	Параметры: Тип сущности - Компания (4), ID Сущности - {=Document:COMPANY_ID}, ID сделки - {=Document:ID}, Телефон - не указывается (будет взят из компании сделки), Тема - "Звонок по сделке #{=Document:ID}", Описание - "Обсудить условия сделки с представителем компании", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}}, Дата завершения - ={{=workdateadd({=System:Now}, "1d 30m", {=Document:ASSIGNED_BY_ID})}}.
Планирование срочного звонка	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается, Тема - "Срочный звонок клиенту", Описание - "Необходимо срочно связаться с клиентом", Ответственный - {=User:ID}, Приоритет - Да (Y), Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "30m")}}.
Планирование звонка через итератор	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Iterator:Value}, ID сделки - не указывается, Телефон - не указывается, Тема - "Звонок контакту #{=Iterator:Value}", Описание - "Связаться с контактом для обсуждения", Ответственный - {=User:ID}, Приоритет - Нет (N), Дата начала - ={{=dateadd({=System:Now}, "1d")}}, Дата завершения - ={{=dateadd({=System:Now}, "1d 30m")}}. Для каждого контакта из итератора будет создан запланированный звонок.
Планирование звонка с указанием конкретного времени	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается, Тема - "Запланированный звонок", Описание - "Звонок запланирован на конкретное время", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - 15.01.2025 10:00:00, Дата завершения - 15.01.2025 10:30:00.
Планирование звонка при изменении статуса сделки	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:CONTACT_ID}, ID сделки - {=Document:ID}, Телефон - не указывается, Тема - "Звонок по сделке в статусе '{=Document:STAGE_ID}'", Описание - "Сделка переведена в новый статус. Необходимо связаться с клиентом", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Да (Y), Дата начала - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}}, Дата завершения - ={{=workdateadd({=System:Now}, "1d 30m", {=Document:ASSIGNED_BY_ID})}}.
Планирование звонка с номером из переменной	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - {=Variable:PHONE_NUMBER}, Тема - "Звонок на указанный номер", Описание - "Связаться с клиентом по указанному номеру телефона", Ответственный - {=User:ID}, Приоритет - Нет (N), Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "30m")}}.

Универсальные дела

Изменение универсального дела

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

• Обновление данных существующего универсального дела;
• Изменение срока выполнения дела при изменении условий;
• Обновление заголовка и описания дела на основе новых данных;
• Изменение ответственного за дело при перераспределении задач;
• Добавление или изменение напоминаний о предстоящем деле;
• Изменение цветовой маркировки дела для визуального разделения;
• Обновление связи с родительским делом в таймлайне;
• Автоматическое обновление дел при изменении статуса сделки или лида;
• Массовое обновление дел по определённым критериям;
• Автоматизация обновления дел при интеграции с внешними системами.

Название поля	Описание и примеры использования
ID дела для обновления	В данном поле указывается идентификатор дела, которое нужно обновить. Это обязательный параметр. Примеры: - {=Variable:ACTIVITY_ID} - обновить дело с ID из переменной предыдущего активити (робота); - 12345 - обновить дело с ID 12345; - {=A1988_22222_92566_99999:new_id_todo} - использовать ID дела из результата активити (робота) "Добавление дела"; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска дел; - {=Document:ID} - обновить дело, если ID дела совпадает с ID документа; - {=Iterator:Value} - обновить дело для каждого ID из итератора. Как получить ID дела: - Из результата активити (робота) "Добавление дела" (параметр new_id_todo); - Из результата активити (робота) "Поиск дел" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если дело с указанным ID не существует, активити (робот) завершится с ошибкой. Всегда проверяйте существование дела перед обновлением.
Тип сущности	В данном поле указывается новый тип сущности, к которой будет привязано дело. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Лид (L) - для привязки дела к лиду; - Сделка (D) - для привязки дела к сделке; - Контакт (C) - для привязки дела к контакту; - Компания (CO) - для привязки дела к компании; - Предложение (Q) - для привязки дела к предложению; - Заказ (O) - для привязки дела к заказу; - Счёт (SI) - для привязки дела к счету; - СМАРТ: [название смарт-процесса] - для привязки дела к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - Сделка (D) - привязать дело к сделке; - Контакт (C) - привязать дело к контакту; - СМАРТ: Заявки - привязать дело к смарт-процессу "Заявки". Когда использовать: - Для изменения привязки дела к другой сущности; - Для переноса дела при изменении типа сущности в бизнес-процессе; - Если тип сущности не нужно менять, укажите текущий тип сущности дела.
ID сущности	В данном поле указывается новый идентификатор сущности CRM, к которой будет привязано дело. Это обязательный параметр. Примеры: - {=Document:ID} - привязать дело к текущей сущности из документа (сделка, лид, контакт, компания); - 123 - привязать дело к сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой. Если ID сущности не нужно менять, укажите текущий ID сущности дела.
Срок выполнения	В данном поле указывается новый срок выполнения дела (дата и время, до которого должно быть выполнено дело). Это обязательный параметр. Примеры: - {=System:NowLocal} - установить текущую дату и время; - ={{=dateadd({=System:Now}, "5d")}} - установить срок выполнения через 5 дней от текущего момента; - ={{=workdateadd({=System:Now}, "3d", {=Document:ASSIGNED_BY_ID})}} - установить срок выполнения через 3 рабочих дня с учётом рабочего времени ответственного; - ={{=dateadd({=Document:CLOSEDATE}, "1d")}} - установить срок выполнения на 1 день позже даты закрытия сделки; - 25.01.2025 18:00:00 - указать конкретную дату и время. Когда использовать: - Для продления срока выполнения дела; - Для изменения дедлайна на основе новых данных; - Для автоматического обновления срока при изменении условий в бизнес-процессе.
Заголовок дела	В данном поле указывается новый заголовок дела. Это необязательный параметр. Если не указан, заголовок останется без изменений. Примеры: - Позвонить клиенту - обновить заголовок на новый текст; - Подготовить коммерческое предложение для сделки #{=Document:ID} - обновить заголовок с использованием переменных; - ={{={=Variable:OLD_TITLE} & " - Обновлено"}} - добавить информацию к существующему заголовку; - Встреча с {=Document:COMPANY_TITLE} - обновить заголовок на основе данных сущности. Когда использовать: - Для обновления заголовка на основе новых данных; - Для добавления дополнительной информации к существующему заголовку; - Если заголовок не нужно менять, оставьте поле пустым.
Описание дела	В данном поле указывается новое описание дела. Это необязательный параметр. Если не указано, описание останется без изменений. Примеры: - Необходимо связаться с клиентом для уточнения деталей сделки - обновить описание на новый текст; - Проверить документы по сделке #{=Document:ID}. Сумма: {=Document:OPPORTUNITY} руб. - обновить описание с использованием переменных; - ={{={=Variable:OLD_DESCRIPTION} & " Дополнительная информация: " & {=Variable:ADDITIONAL_INFO}}}} - добавить информацию к существующему описанию; - Подготовить договор для компании {=Document:COMPANY_TITLE} - обновить описание на основе данных сущности. Когда использовать: - Для обновления описания на основе новых данных; - Для добавления дополнительной информации к существующему описанию; - Если описание не нужно менять, оставьте поле пустым.
Ответственный	В данном поле указывается новый ответственный за дело. Это необязательный параметр. Если не указан, ответственный останется без изменений. Примеры: - {=Document:ASSIGNED_BY_ID} - назначить ответственным сотрудника из текущей сущности; - {=User:ID} - назначить ответственным текущего пользователя; - [U1] - назначить ответственным пользователя с ID 1; - user_25 - назначить ответственным пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для перераспределения задач между сотрудниками; - Для автоматического назначения ответственного на основе данных сущности; - Если ответственного не нужно менять, оставьте поле пустым.
Напоминания (минуты до дедлайна)	В данном поле указывается новое время до дедлайна (в минутах), когда нужно отправить напоминание о предстоящем деле. Это необязательный параметр. Можно указать несколько значений через запятую для множественных напоминаний. Если не указано, напоминания останутся без изменений. Примеры: - 60 - установить напоминание за 60 минут до дедлайна (1 час); - 1440 - установить напоминание за 1440 минут до дедлайна (1 день); - 5, 30, 60 - установить напоминания за 5 минут, за 30 минут и за 1 час до дедлайна; - {=Variable:REMINDER_MINUTES} - использовать значение из переменной предыдущего активити (робота). Особенности работы: - Значения указываются в минутах до срока выполнения дела; - Можно указать несколько значений через запятую для множественных напоминаний; - Новые напоминания заменят существующие напоминания дела; - Если напоминания не указаны, существующие напоминания останутся без изменений. Когда использовать: - Для добавления или изменения напоминаний о предстоящем деле; - Для настройки множественных напоминаний; - Если напоминания не нужно менять, оставьте поле пустым.
Цвет дела	В данном поле указывается новый цвет для визуальной маркировки дела в календаре и списке дел. Это необязательный параметр. Выбирается из выпадающего списка. Если не указан, цвет останется без изменений. Варианты выбора: - Жёлтый (0) - жёлтый цвет; - Синий (1) - синий цвет; - Бирюзовый (2) - бирюзовый цвет; - Оранжевый (3) - оранжевый цвет; - Зелёный (4) - зелёный цвет; - Фиолетовый (5) - фиолетовый цвет; - Серый (6) - серый цвет; - Красный (7) - красный цвет. Примеры использования: - Красный - для срочных и важных дел; - Зелёный - для выполненных или успешных дел; - Жёлтый - для стандартных дел; - Синий - для дел, требующих внимания. Когда использовать: - Для изменения цветовой маркировки дела при изменении приоритета; - Для визуального разделения дел по категориям; - Если цвет не нужно менять, оставьте поле пустым.
Идентификатор дела в таймлайне, с которым можно связать создаваемое дело	В данном поле указывается новый ID родительского дела в таймлайне, с которым нужно связать дело. Это необязательный параметр. Если не указан, связь с родительским делом останется без изменений. Примеры: - {=Variable:PARENT_ACTIVITY_ID} - связать дело с новым родительским делом из переменной; - 12345 - связать дело с родительским делом с ID 12345; - {=A1988_22222_92566_99999:new_id_todo} - использовать ID дела из результата активити (робота) "Добавление дела"; - Если нужно убрать связь с родительским делом, укажите пустое значение или 0. Особенности работы: - Дочернее дело отображается в таймлайне под родительским делом; - Изменение связи с родительским делом позволяет переструктурировать иерархию дел; - Если родительское дело не указано, существующая связь останется без изменений. Когда использовать: - Для изменения связи с родительским делом; - Для переструктурирования иерархии дел; - Если связь с родительским делом не нужно менять, оставьте поле пустым.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Продление срока выполнения дела	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "7d")}}. Активити (робот) продлит срок выполнения дела на 7 дней.
Изменение ответственного за дело	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Контакт (C), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "3d")}}, Ответственный - {=Document:ASSIGNED_BY_ID}. Активити (робот) изменит ответственного на сотрудника из текущей сущности.
Добавление напоминаний к существующему делу	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "2d")}}, Напоминания (минуты до дедлайна) - 1440, 60. Активити (робот) добавит напоминания за день и за час до дедлайна.
Изменение цветовой маркировки дела	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Лид (L), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "1d")}}, Цвет дела - Красный (7). Активити (робот) изменит цвет дела на красный для визуального выделения.
Обновление заголовка и описания дела	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Компания (CO), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "5d")}}, Заголовок дела - Встреча с {=Document:TITLE}, Описание дела - Обсудить условия сотрудничества. Активити (робот) обновит заголовок и описание дела.
Изменение привязки дела к другой сущности	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Variable:NEW_DEAL_ID}, Срок выполнения - ={{=dateadd({=System:Now}, "3d")}}. Активити (робот) перенесёт дело к другой сделке.
Изменение связи с родительским делом	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "4d")}}, Идентификатор дела в таймлайне - {=Variable:NEW_PARENT_ID}. Активити (робот) изменит связь с родительским делом.
Массовое обновление дел через итератор	Параметры: ID дела для обновления - {=Iterator:Value}, Тип сущности - Контакт (C), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "2d")}}, Цвет дела - Зелёный (4). Для каждого дела из итератора будет изменён срок выполнения и цвет.
Автоматическое обновление срока при изменении условий	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}}. Активити (робот) обновит срок выполнения на основе даты закрытия сделки.
Полное обновление дела со всеми параметрами	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "5d")}}, Заголовок дела - Обновлённое дело, Описание дела - Новое описание, Ответственный - {=User:ID}, Напоминания (минуты до дедлайна) - 1440, 60, Цвет дела - Синий (1). Активити (робот) обновит все указанные параметры дела.

Задачи

Задачи

Слежение за статусом задачи

Данное активити позволяет отслеживать статус в указанной Вами задаче.

ID задачи (условие): в данном поле указывается ID задачи, за статусом которой требуется вести наблюдение.

Статус задачи: в данном поле выбирается из выпадающего списка статус задачи.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Удаление задачи

Данное активити позволяет удалить задачу, согласно выбранным Вами параметрам.

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

Владелец (условие): указывается автор задачи из выпадающего списка.

Статус задачи, ID (условие): в данном поле указывается номер статуса задачи.

Номер   статуса	Расшифровка статуса задачи
1	Новая задача
2	Задача принята ответственным
3	Задача выполняется (пользователь нажал начать выполнение)
4	Условно завершена (пользователь закрыл задачу и ждёт согласования от постановщика)
5	Задача выполнена (пользователь завершил выполнение задачи)
6	Задача отложена (пользователь нажал отложить)
7	Задача отклонена ответственным.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:  в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Завершение задач

Данное активити позволяет автоматически закрывать неактуальные задачи, при условии знания их ID
   Логика активити подразумевает, что если не указаны данные, необходимые для выбора конкретной задачи, то будут закрываться все задачи, которые находятся в статусах 1,2,3,4 (о значениях статусов смотрите в описании активити "Получить текущий статус и мета - статус задачи") в той сущности, где запущен данный бизнес-процесс (Лид, Сделка, Контакт, Компания). 

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

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

Ответственный (условие) - позволяет отобрать все задачи в которых ответственным будет выбранный сотрудник. Выбор происходит из выпадающего списка.

Закрывать все задачи указанной сущности: варианты да/нет.
Данное поле позволяет выбрать, нужно ли автоматически закрыть все задачи для указанной сущности или нет. Т.е если указана сущность, то все ее задачи будут или не будут закрыты.
Так же, если указать да/нет в данном поле, но не указать сущность, то активити выдаст ошибку.

Тип сущности: в данном поле из выпадающего списка выбирается тип сущности, задачи которой будут закрыты.

ID сущности: в данном поле указывается ID сущности, либо переменная, указывающая на этот ID.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания (Время ожидания ответа от приложения): это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получить статус и мета-статус задачи

Данное активити позволяет получить статус задачи для того, чтобы понять что с ней происходит. Исходя из нашей логики, получив статус, можно далее реагировать как необходимо. Результатом работы данного активити будет число, которое обозначает конкретный статус задачи.
Результат работы активити можно вывести в ленту с помощью активити "Cоздание сообщения в ленту сущностей CRM"

Номер  статуса	Расшифровка статуса задачи
1	Новая задача
2	Задача принята ответственным
3	Задача выполняется (пользователь нажал начать выполнение)
4	Условно завершена (пользователь закрыл задачу и ждёт согласования от постановщика)
5	Задача выполнена (пользователь завершил выполнение задачи)
6	Задача отложена (пользователь нажал отложить)
7	Задача отклонена ответственным.

Номер   статуса	Расшифровка мета - статуса задачи
-1	Просроченная задача
-2	Непросмотренная задача
-3	Почти просрочена (осталось менее 24х часов до даты крайнего срока)

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, Вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Создание задачи

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

• Автоматическое создание задач при наступлении определённых событий в CRM;
• Создание задач с привязкой к сущностям (сделки, лиды, контакты, компании);
• Формирование задач с чек-листами для контроля выполнения;
• Создание связанных и зависимых задач для управления проектами;
• Автоматическое назначение ответственных и наблюдателей;
• Установка сроков и приоритетов задач на основе данных бизнес-процесса;
• Создание задач в рабочих группах и проектах.

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

Название поля	Описание и примеры использования
Остановить процесс во время выполнения задачи	Позволяет остановить бизнес-процесс до выполнения задачи. После выполнения задачи БП продолжит работу. Варианты: Да, Нет.
Название задачи	Название задачи в дизайнере БП. Рекомендуется использовать модель именования: Задача №1, Задача №2. Название должно заполняться латиницей и без пробелов (для системного идентификатора).
Постановщик	ID сотрудника, который будет принимать задачу. Получает уведомления по каждому изменению. Пример: {=User:ID}, [1], user_1
Ответственный	ID сотрудника, который должен выполнить задачу и отчитаться о проделанной работе. Пример: {=Document:ASSIGNED_BY_ID}
Соисполнители	ID сотрудников, участвующих в работе. Получают уведомления, но не участвуют в отчетах. Пример: несколько ID через запятую или массив.
Наблюдатели	ID сотрудников, наблюдающих за изменениями в задаче. Получают уведомления. Пример: несколько ID через запятую или массив.
Дата начала	Дата начала задачи. Поддерживается выбор формата даты. Пример: {{=dateadd({=System:Now}, "1d")}}
Дата окончания	Дата окончания задачи. Пример: {{=dateadd({=System:Now}, "7d")}}
Крайний срок	Крайний срок по задаче. По этой дате система считает просрочку. ВАЖНО! Изменение крайнего срока ведёт к смещению сроков зависимых задач на диаграмме Ганта.
Описание задачи	Описание того, что необходимо сделать в рамках задачи. Указывайте подробное описание.
Важность	Приоритетность задачи. Задачи с высоким приоритетом отмечаются маркером (огонёк). Значения: 1 (обычная), 2 (важная).
Задача в проекте (группе)	ID группы (проекта) для привязки задачи. Удобно для разделения задач в отчетах.
Разрешить ответственному менять крайний срок	Позволяет ответственному передвигать сроки выполнения задачи. Варианты: Да, Нет.
Включить учет времени по задаче	Включает функцию замера времени в задаче. Варианты: Да, Нет.
Принять работу после завершения задачи	Требует от постановщика принять задачу после завершения. Отображается "Ожидает контроля". Варианты: Да, Нет.
Включить задачу в отчет по эффективности	Добавляет задачу в отчет по эффективности менеджера. Варианты: Да, Нет.
Привязать задачу к текущей сущности (CRM)	Привязывает задачу к сущности из которой запускается БП. Типы: Лид, Контакт, Компания, Сделка.
Привязать задачу к нескольким сущностям	Позволяет привязать задачу к нескольким CRM-сущностям. Формат: тип_ID (L_123, D_456, C_789, CO_101, SI_102, Q_103, T84_1234). Обозначения: L_ - Лид, D_ - Сделка, C_ - Контакт, CO_ - Компания, SI_ - Счёт, Q_ - Предложение.
Коды смарт-процессов	Позволяет выбрать символьный код СП. Для каждого СП код уникален. При добавлении нового СП активити нужно переустановить.
Теги	Теги для маркировки задач и удобного поиска.
Пункт чек-листа	Создание пунктов чек-листа в задаче. Можно создать несколько полей. Чем больше пунктов, тем дольше выполняется БП.
Идентификатор родительской задачи	ID родительской задачи для создания вложенных задач.
Плановые трудозатраты (в секундах)	Запланированное время на выполнение в секундах. Пример: для 2 часов укажите 7200 (2*60*60).
Планируемая длительность	Автоматический расчёт сроков. Указывается число, единица в следующем поле. Единицы: days, hours, minutes.
Идентификатор задачи для зависимости	ID задачи для создания зависимости. Формат: id#тип. Пример: 123456#1, 985#2, 737#1
Прикрепить файл к задаче	ID файла с диска Б24 для прикрепления к задаче.
Крайний срок в рабочее время	Автоматически переносит сроки на рабочие дни (например, с воскресенья на понедельник).

Типы зависимостей между задачами:

Индекс	Описание
1	Когда начнётся указанная - начнётся создаваемая
2	Когда начнётся указанная - закончится создаваемая
3	Когда закончится указанная - начнётся создаваемая
4	Когда закончится указанная - закончится создаваемая
11	Когда начнётся создаваемая - начнётся указанная
12	Когда начнётся создаваемая - закончится указанная
13	Когда закончится создаваемая - начнётся указанная
14	Когда закончится создаваемая - закончится указанная

Примеры использования:

№	Сценарий	Название	Ответственный	Крайний срок
1	Задача при создании сделки	Обработка сделки №{=Document:ID}	{=Document:ASSIGNED_BY_ID}	{{=dateadd({=System:Now}, "3d")}}
2	Задача для менеджера	Связаться с клиентом	user_25	{{=dateadd({=System:Now}, "1d")}}
3	Задача с высоким приоритетом	Срочная задача	{=User:ID}	{=System:Now}
4	Задача в проекте	Задача проекта	{=Variable:RESPONSIBLE_ID}	{{=dateadd({=System:Now}, "7d")}}
5	Подзадача	Подзадача	{=Document:ASSIGNED_BY_ID}	{{=dateadd({=System:Now}, "2d")}}
6	Задача с привязкой к сделке	Контроль сделки	user_1	{{=dateadd({=System:Now}, "5d")}}
7	Задача с чек-листом	Задача с контролем	{=Document:ASSIGNED_BY_ID}	{{=dateadd({=System:Now}, "3d")}}
8	Задача с соисполнителями	Командная задача	user_10	{{=dateadd({=System:Now}, "7d")}}
9	Задача с зависимостью	Зависимая задача	{=Document:ASSIGNED_BY_ID}	{{=dateadd({=System:Now}, "10d")}}
10	Задача с файлом	Задача с документами	{=User:ID}	{{=dateadd({=System:Now}, "5d")}}

Возвращаемые параметры для данного активити:

• ID задачи (task_id) - числовой идентификатор созданной задачи;
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Поиск задачи (v.2)

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

Название	Описание
ID задачи:	В данном пункте указывается ID задачи, которую Вам необходимо найти.
Название задачи:	В данном пункте указывается название задачи, которую необходимо найти.
Истинный статус задачи:	В данном поле выбирается один из вариантов истинного статуса задачи: новая задача,  принята ответственным, выполняется, условно завершена, выполнена, отложена. При поиске задач, нельзя искать по 2 типам статусов одновременно, это приведет к тому, что активити попросту ничего не найдет. Т.е одновременный поиск с фильтрами "Истинный статус" и "Мета статус" - невозможен.
Мета - статус задачи:	В данном поле устанавливается мета - статус искомой задачи: задача почти просрочена, не просмотренная задача, просроченная задача. При поиске задач, нельзя искать по 2 типам статусов одновременно, это приведет к тому, что активити попросту ничего не найдет. Т.е одновременный поиск с фильтрами "Истинный статус" и "Мета статус" - невозможен.
Дата начала:	В данном пункте указывается дата начала выполнения задачи.
Дата окончания:	В данном пункте указывается дата завершения задачи.
Крайний срок:	В данном пункте указывается дата крайнего срока задачи.
ID задачи	В данном пункте указывается ID задач
Привязать к текущей сущности	В данном пункте указывается привязана ли задача к текущей сущности или нет.
ID ответственного:	В данном пункте указывается ID ответственного.
ID постановщика:	В данном пункте указывается ID постановщика, которую Вам необходимо найти.
ID соисполнителей:	В данном пункте указывается ID соисполнителей, которых Вам нужно найти.
ID наблюдателей:	В данном пункте указывается ID наблюдателей, которых Вам нужно найти.
ID родительской задачи:	В данном пункте указывается ID родительской задачи, которую Вам необходимо найти.
ID рабочей группы:	В данном пункте указывается ID рабочей группы, которую Вам необходимо найти.
Плановые трудозатраты (в секундах):	В данном поле указывается плановые трудозатраты на выполнение задачи в виде времени, указывается значение в секундах.
Планируемая длительность в часах или днях:	В данном пункте указывается планируемая длительность задачи в часах или днях.
ID сайта:	В данном пункте указывается ID сайта, который Вам нужно найти.
Дата и время исполнения только в рабочее время:	В данном пункте указывается дата и время исполнения задачи, только в рабочее время.
Стадия:	В данном пункте указывается стадия, в которой находится задача.
Изменил:	В данном поле указывается ID пользователя, который внес какие-либо изменения в задаче.
Дата изменения:	В данном поле указывается дата последнего изменения в задаче.
Изменил статус:	В данном поле указывается ID сотрудника, изменившего статус.
Дата изменения статуса:	В данном поле указывается дата изменения статуса задачи.
Закрыл задачу:	В данном полу указывается ID сотрудника, закрывшего задачу.
Затраченное время из истории изменений:	В данном поле указывается затраченное время из истории изменений задачи.
Дата последнего просмотра:	В данном поле указывается дата последнего просмотра искомой задачи.
Индекс сортировки:	В данном поле указывается индекс сортировки задачи в виде цифры. Данный индекс можно найти в параметрах задачи.
Затрачено (фактически):	В данном поле указывается время, фактически затраченное на выполнение задачи.

Номер  статуса	Расшифровка статуса задачи
1	Новая задача
2	Задача принята ответственным
3	Задача выполняется (пользователь нажал начать выполнение)
4	Условно завершена (пользователь закрыл задачу и ждёт согласования от постановщика)
5	Задача выполнена (пользователь завершил выполнение задачи)
6	Задача отложена (пользователь нажал отложить)
7	Задача отклонена ответственным.

Номер   статуса	Расшифровка мета - статуса задачи
-1	Просроченная задача
-2	Непросмотренная задача
-3	Почти просрочена (осталось менее 24х часов до даты крайнего срока)

Поиск по привязке к сущностям CRM: в поле указывается CRM сущность, к которой привязана искомая задача или задачи.
Поле заполняется в определенном формате.
Пример: L_12345
L_ - обозначение лида.
12345 - ID этого лида.

Обозначения сущностей CRM:
L_ - Лид
D_ - Сделка
C_ - Контакт
CO_ - Компания
SI_ - Счёт
Q_ - Предложение
Символьный код СП из поля ниже_ID элемента СП - Смарт-процесс
Пример заполнения поля: T84_1234. 

Коды смарт-процессов: позволяет посмотреть и выбрать значение символьного кода для СП.
Для каждого СП этот код уникален.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получить все данные по задаче

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

• Получение всех данных задачи по её ID для использования в бизнес-процессе;
• Извлечение информации о задаче для формирования отчётов;
• Получение статуса и мета-данных задачи;
• Автоматическая проверка параметров задачи (сроки, ответственные, соисполнители);
• Получение данных для условного ветвления в бизнес-процессе;
• Синхронизация данных задачи с другими системами;
• Получение результатов из дополнительных результатов выбранной задачи.

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

Название поля	Описание и примеры использования
ID задачи (условие)	Обязательный параметр. В данном поле указывается ID задачи, данные которой необходимо получить. Примеры: - {=Variable:TASK_ID} - ID задачи из переменной; - 123456 - конкретный ID задачи; - {=A1988_22222_92566_99999:task_id} - ID из результата предыдущего активити.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП. Используйте только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию с очередями запросов. Если время истекло и результат не получен, бизнес-процесс продолжит работу по заложенной логике.

Примеры использования:

№	Сценарий	ID задачи	Описание
1	Получить данные созданной задачи	{=A1988_22222_92566_99999:task_id}	Используется после активити создания задачи
2	Получить данные из переменной	{=Variable:TASK_ID}	ID задачи хранится в переменной БП
3	Получить данные конкретной задачи	123456	Указывается конкретный ID
4	Проверить статус задачи	{=Variable:TASK_ID}	Для условного ветвления
5	Получить ответственного	{=Variable:TASK_ID}	Для назначения в другие сущности
6	Получить сроки задачи	{=Variable:TASK_ID}	Для расчёта дедлайнов
7	Получить соисполнителей	{=Variable:TASK_ID}	Для уведомлений или назначений
8	Получить данные для отчёта	{=Variable:TASK_ID}	Для формирования отчётности
9	Проверить привязку к CRM	{=Variable:TASK_ID}	Для связи с сущностями CRM
10	Получить данные в итераторе	{=Iterator:Value}	Для обработки списка задач

Возвращаемые параметры для данного активити:

• Статусы - статус и мета-статус задачи;
• Массивы - соисполнители, наблюдатели, теги, файлы;
• Все параметры по задаче, включая:
  - ID задачи;
  - Название и описание;
  - Постановщик и ответственный;
  - Соисполнители и наблюдатели;
  - Даты начала, окончания, крайний срок;
  - Приоритет;
  - Статус и мета-статус;
  - Привязка к группе/проекту;
  - Привязка к CRM-сущностям;
  - Родительская задача;
  - Затраченное время;
  - и другие поля.

Слежение за изменением в задаче

Данное активити позволяет отслеживать изменения в указанной Вами задаче.

ID задачи (условие):  в данном поле указывается ID задачи, за изменениями в которой требуется вести наблюдение.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Изменение задачи

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

• Автоматическое изменение параметров задачи (название, описание, сроки, приоритет);
• Переназначение ответственного или добавление соисполнителей;
• Изменение сроков выполнения задачи на основе событий в CRM;
• Привязка задачи к сущностям CRM (сделки, лиды, контакты, компании);
• Обновление статуса и приоритета задачи автоматически;
• Добавление тегов и файлов к существующим задачам;
• Управление зависимостями между задачами;
• Привязка задачи к рабочим группам и проектам.

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

Название поля	Описание и примеры использования
ID задачи	Обязательный параметр. ID задачи, которую необходимо изменить. Примеры: - {=Variable:TASK_ID} - из переменной; - 123456 - конкретный ID задачи.
Название задачи	Поле позволяет указать новое название задачи. Примеры: - {=Variable:TASK_TITLE}; - Задача №{=Document:ID}. Рекомендуем использовать модель именования: Задача №1, Задача №2 и т.д.
Описание задачи	В этом поле указывается что необходимо сделать в рамках задачи. Пример: {=Variable:TASK_DESCRIPTION} Рекомендуем заполнять описание максимально подробно.
Дата начала	Дата начала задачи. Есть возможность выбора формата даты. Примеры: - {=Variable:START_DATE}; - {{=dateadd({=System:Now}, "1d")}} - завтра.
Дата завершения	Дата окончания задачи. Примеры: - {=Variable:END_DATE}; - {{=dateadd({=System:Now}, "7d")}} - через 7 дней.
Крайний срок	Крайний срок задачи. Пример: {{=dateadd({=System:Now}, "5d")}} ВАЖНО! Изменение крайнего срока ведёт к смещению сроков зависимых задач на диаграмме Ганта.
Приоритет	Позволяет установить приоритетность задачи. Значения: - 1 - обычная; - 2 - важная (отмечается огоньком).
Идентификатор ответственного	ID сотрудника, который должен выполнить задачу. Форматы: {=Document:ASSIGNED_BY_ID}, [1], user_1.
Идентификатор постановщика	ID сотрудника, который будет принимать задачу. Форматы: {=User:ID}, [1], user_1. ВАЖНО! Постановщик получает уведомления по каждому изменению задачи.
Соисполнители	ID сотрудников, участвующих в работе. Можно указать несколько ID через запятую или массив. Пример: {=Variable:ACCOMPLICES}
Наблюдатели	ID сотрудников, наблюдающих за задачей. Получают уведомления об изменениях. Пример: {=Variable:AUDITORS}
Теги	Теги задач для фильтрации и поиска. Можно указать несколько как массив. Пример: {=Variable:TAGS} Теги - идентификаторы для уточнения категории, описания, поиска данных.
Флаг "Разрешить ответственному менять крайний срок"	Позволяет ответственному передвигать сроки выполнения. Варианты: да/нет.
Флаг "Привязать к текущей сущности CRM"	Привязка задачи к сущности из которой запускается БП. Варианты: да/нет.
Привязать задачу к нескольким сущностям	Позволяет привязать задачу к нескольким CRM-сущностям. Обозначения: - L_ - Лид; - D_ - Сделка; - C_ - Контакт; - CO_ - Компания; - SI_ - Счёт; - Q_ - Предложение; - T84_ - Смарт-процесс (символьный код). Пример: L_123, D_456, C_789
Коды смарт-процессов	Позволяет выбрать символьный код для СП. Для каждого СП код уникален. Если добавляете новый СП, нужно переустановить активити.
Флаг "Принять работу после завершения задачи"	Потребует от постановщика принять задачу после завершения. Отображается "Ожидает контроля".
Идентификатор родительской задачи	ID родительской задачи для создания вложенных задач. Пример: {=Variable:PARENT_TASK_ID}
Идентификатор рабочей группы	Привязка задачи к группе (проекту) для разделения в отчетах. Пример: {=Variable:GROUP_ID}
Плановые трудозатраты (в секундах)	Запланированное время на выполнение. Указывается в секундах. Пример: для 2 часов укажите 7200 (2*60*60).
Идентификатор задачи для зависимости	ID задачи для привязки зависимости. Формат: id#тип. Пример: 123456#1, 985#2, 737#1 Типы зависимостей: - 1 - Когда начнётся указанная - начнётся эта; - 2 - Когда начнётся указанная - закончится эта; - 3 - Когда закончится указанная - начнётся эта; - 4 - Когда закончится указанная - закончится эта; - 11-14 - обратные зависимости. Изменить привязку можно только после ручного удаления связи.
Прикрепить файл к задаче	ID файлов с облачного диска. Можно указать несколько через запятую. Пример: {=Variable:FILE_IDS} или 123, 456, 789
Крайний срок в рабочее время	Автоматически увеличивает сроки в рамках рабочих дней. Воскресенье - на понедельник.

Примеры использования:

№	Сценарий	Параметр	Значение
1	Изменить название	Название задачи	Новое название задачи
2	Сменить ответственного	Идентификатор ответственного	user_25
3	Продлить срок на 7 дней	Крайний срок	{{=dateadd({=System:Now}, "7d")}}
4	Установить высокий приоритет	Приоритет	2
5	Добавить соисполнителей	Соисполнители	user_10, user_15, user_20
6	Привязать к сделке	Привязать к сущностям	D_{=Document:ID}
7	Добавить теги	Теги	срочно, важно
8	Привязать к группе	Идентификатор рабочей группы	{=Variable:GROUP_ID}
9	Установить трудозатраты 4 часа	Плановые трудозатраты	14400
10	Обновить описание	Описание задачи	Обновлено: {=System:Date}

Возвращаемые параметры для данного активити:

• ID изменённой задачи (task_id) - числовой идентификатор изменённой задачи;
• Успех операции (success) - результат выполнения (Y/N);
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Перенос затраченного времени в задаче

Данное активити позволяет переносить информацию о затраченном времени из одной задачи в другую.
Перенос осуществляется путем указания ID-задачи из которой нужно перенести время и ID-задачи в которую необходимо перенести время.

Взять ID гл. задачи из родительской задачи: варианты "да" или "нет". Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.
Данный пункт используется, когда у Вас связаны между собой 2 задачи, одна из этих задач "родительская" (главная), вторая "дочерняя". Сам процесс запускается из "дочерней" задачи, но при этом видит ID "родительской" (главной) задачи.

Продублировать затраченное время в комментарий к главной задаче: варианты да/нет. Позволяет выбрать, нужно ли дублировать затраченное  время в комментарии  к главной задаче или нет.

ID главной задачи: указывается ID главной задачи.

ID задачи из которой будет взято затраченное время: указывается ID задачи из которой будут взяты данные о затраченном времени.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Чек-лист

Проверка чек-листа к задаче

Данное активити проверяет чек-лист в задаче, ID которого Вы указали, и возвращает в БП значение «ложь» или «правда», что означает статус «не выполнено» или «выполнено»

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Сценарий работы робота

Информация о чек-листе в задаче

Активити предоставляет информацию о чек-листа в задаче, ID которой Вы указали.

ID задачи (условие): указывается идентификатор задачи из которой необходимо получить данные чек-листа.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Добавить чек-лист к задаче

Данное активити позволяет добавить пункты чек-листа в задачи, соответствующие указанному ID.

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

Пункт чек-листа - в данном поле пишется важный момент, который должен выполнить ответственный за выполнение задачи. 

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Изменение пункта чек-листа в задаче

Активити позволяет изменить пункты чек-листов указанной задачи.

ID задачи: указывается ID задачи, в которой нужно изменить пункт чек-листа.

ID пункта чек-листа: указывается идентификатор пункта чек-листа.
ID родительского пункта чек-листа: идентификатор чек-листа к которому привязан изменяемый пункт чек-листа.

Текст пункта чек-листа: указывается содержание пункта чек-листа.

Признак выполнения пункта чек-листа: варианты да/нет.
Позволяет указать, выполнен или нет пункт чек-листа.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Удаление пункта чек-листа в задаче

Активити позволяет удалить пункты чек-листа из указанной задачи.

ID задачи (условие): указывается идентификатор задачи из которой необходимо удалить пункты чек-листа.

ID пункта чек-листа: указывается идентификатор удаляемого пункта чек-листа.
Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Комментарии в задачах

Создать комментарии в задаче

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

• Автоматическое добавление комментариев к задачам при наступлении определённых событий;
• Информирование участников задачи о статусе выполнения работ;
• Логирование действий бизнес-процесса в комментариях задачи;
• Автоматическое уведомление о важных изменениях в связанных сущностях CRM;
• Добавление итогов или результатов работы других активити в комментарии;
• Формирование истории обработки задачи для последующего анализа;
• Автоматические напоминания ответственным сотрудникам.

Сценарий работы робота




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

Название поля	Описание и примеры использования
ID задачи	Обязательное поле. В данном поле указывается идентификатор задачи, в которой будет создан комментарий. Примеры: - 123456 - создать комментарий в задаче с ID 123456; - {=Variable:TASK_ID} - использовать ID задачи из переменной; - {=A1988_22222_92566_99999:task_id} - использовать ID из результата предыдущего активити (робота); - {=Document:ID} - использовать ID текущего документа (если БП запущен из задачи).
ID пользователя	В данном поле указывается идентификатор пользователя, от имени которого будет создан комментарий. Примеры: - 1 - создать комментарий от пользователя с ID 1; - user_25 - создать комментарий от пользователя с ID 25; - {=Document:ASSIGNED_BY_ID} - от имени ответственного текущей сущности; - {=User:ID} - от имени текущего пользователя.
Текст сообщения	В данном поле указывается текст комментария. Поддерживается BB-код для форматирования. Примеры: - Задача выполнена успешно - простой текстовый комментарий; - Статус сделки изменён на: {=Variable:STAGE_NAME} - с подстановкой переменной; - [B]Важно![/B] Требуется проверка данных - с форматированием BB-кодом; - Результат обработки: {=A1988_22222_92566_99999:result} - с результатом другого активити.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении указанного времени, то активити завершается.

Примеры использования:

№	Сценарий	ID задачи	ID пользователя	Текст сообщения
1	Уведомление о создании сделки	{=Variable:TASK_ID}	1	Создана новая сделка №{=Document:ID}
2	Логирование статуса	123456	{=Document:ASSIGNED_BY_ID}	Статус изменён на: {=Variable:STATUS}
3	Напоминание ответственному	{=Variable:TASK_ID}	user_1	[B]Напоминание![/B] Срок задачи истекает завтра
4	Отчёт о выполнении	{=A1988_22222_92566_99999:task_id}	{=User:ID}	Обработано записей: {=Variable:COUNT}
5	Информация о клиенте	{=Variable:TASK_ID}	1	Клиент: {=Variable:CLIENT_NAME}, тел: {=Variable:PHONE}
6	Результат проверки	{=Variable:TASK_ID}	{=Document:CREATED_BY}	Проверка завершена. Результат: {=Variable:CHECK_RESULT}
7	Уведомление об ошибке	{=Variable:TASK_ID}	1	[COLOR=red]Ошибка![/COLOR] {=Variable:ERROR_MESSAGE}
8	Информация о платеже	{=Variable:TASK_ID}	{=Document:ASSIGNED_BY_ID}	Получен платёж на сумму: {=Variable:AMOUNT} руб.
9	Результат интеграции	{=Variable:TASK_ID}	user_1	Данные синхронизированы с внешней системой. ID: {=Variable:EXT_ID}
10	Итоги дня	{=Variable:TASK_ID}	1	Итоги за {=System:Date}: обработано {=Variable:COUNT} заявок

Возвращаемые параметры для данного активити:

• ID нового комментария (comment_id) - числовой идентификатор созданного комментария;
• Успех операции (success) - результат выполнения операции (Y/N);
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Получить данные по комментарию в задаче

Активити позволяет получить данные о комментарии в задаче.


ID комментария:  в этом поле нужно указать идентификатор комментария, данные о котором вы хотите получить.

ID задачи:  в этом поле указывается идентификатор задачи, в которой находится комментарий.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск комментариев в задаче

Активити позволяет получить id комментариев в указанной задаче.


ID задачи: в этом поле указывается идентификатор задачи, в которой будет производиться поиск комментариев.

ID пользователя: в этом поле указывается идентификатор пользователя, по которому будет произведен поиск комментариев в задаче.

Имя пользователя: в этом поле указывается имя пользователя, по которому будет произведен поиск комментариев в задаче.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Особенно это важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Изменить комментарий к задаче

Активити позволяет изменить указанный комментарий в указанной задаче, сделанный указанным пользователем


ID задачи:  в этом поле указывается идентификатор задачи, в которой находится комментарий.

ID комментария:  в этом поле указывается идентификатор комментария.
Идентификатор комментария можно получить с помощью активити "Создать комментарий" (если вы его создавали этим активити).

ID пользователя: в этом поле указывается идентификатор пользователя от имени которого был создан комментарий.

Текст сообщения: в этом поле указывается текст комментария.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Перенос комментариев в другую задачу

Данное активити позволяет переносить комментарии из одной задачи в другую. Это можно сделать задав ID задачи из которой будет произведен перенос и ID задачи в которую будет осуществлен перенос комментариев.

Сценарий работы активити бизнес-процесса

Взять ID гл. задачи из родительской задачи: варианты: да/нет. Позволяет получить автоматически ID главной задачи из подзадач для пункта "ID главной задачи".

ID главной задачи: в данном поле указывается ID задачи в которую будет перенесены комментарии.

ID задачи из которой будут взяты комментарии: в данном поле указывается ID задачи из которой будут взяты комментарии.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Живая лента

Добавление сообщения в живую ленту

Данное активити позволяет добавлять сообщения в живую ленту 


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

Название поля	Описание и примеры использования
ID автора сообщения (только один)	Данное поле позволяет указать ID автора сообщения. Можно указывать в форматах: {=Variable:AUTHOR_ID} или [U1].
Получатели сообщения (сотрудники)	Данное поле позволяет выбрать получателей сообщения, указав их ID, либо передав в поле массив с ID пользователей. Пример: {=Variable:RECIPIENTS_USERS} или [U1, U5, U10].
Получатели сообщения (группы)	Позволяет указать ID групп, проектов или отделов, (можно указать несколько) тогда все сотрудники вышеперечисленных структур получат сообщение в разделе "Лента". Чтобы указать получателями группу или подразделение, нужно: 1. Рядом с полем "получатели сообщения" нажать "...". 2. Выбрать пункт категории "пользователей" (как на скриншоте). 3. Выбрать пункт "Группы социальной сети". 4. Выбрав пункт "Группы социальной сети", нужно выбрать фильтр справа "Мои группы". 5. Выбрать нужную Вам группу/подразделение. Категории получателей: [DR2] - Department Recursive (сотрудники отдела с ID = 2 и его подотделов); [SG3_A] - где индекс А, обозначает администратора (владельца) группы соцсети с ID = 3); [SG3_E] - где индекс E, обозначает модераторов группы соцсети с ID = 3); [SG3_K] - где индекс K, обозначает всех членов группы соцсети с ID = 3); Пример: Приложение Лаборатория БП: Все члены группы [SG3_K] Если не поставить галочку "для публикации" в настройках группы, то все сообщения будут сначала поступать на модерацию и не будут общедоступны для просмотра. Если вы пытались добавить сообщение в Группу используя "доп. параметры" и при этом активити пишет, что сообщение добавлено, но в Группе его нет, то нужно удалить индекс категории получателей, т.е [SG3_K] изменить на [SG3]. Это связанно с изменением подстановочных кодов со стороны Б24. Пример: "Все члены группы [SG309_K];" изменяем на "Все члены группы [SG309];"
Заголовок сообщения	Данное поле позволяет указать заголовок сообщения. Пример: {=Variable:TITLE} или "Важное объявление".
Текст сообщения	В данном поле указывается текст сообщения. Пример: {=Variable:MESSAGE_TEXT}.
Важное сообщение	Позволяет выбрать, является ли данное сообщение важным или нет. Варианты: да/нет.
Дата(время) до которого сообщение будет важным	Позволяет указать дату и время, до наступления которых сообщение будет находиться в статусе "Важно". Пример: {=Variable:IMPORTANT_DATE} или {{=dateadd({=System:Now}, "7d")}}.
Прикрепить файл(ы) к сообщению (ID файлов с диска)	В данном поле указывается ID файлов, расположенных на диске, которые должны быть прикреплены к сообщению. Можно указать несколько ID через запятую или использовать массив. Пример: {=Variable:FILE_IDS}.
Добавить видео в сообщение	В данном поле необходимо указать код видео Youtube. Пример: Ссылка на видео https://www.youtube.com/watch?v=jWlAPx4Z40g, где код этого видео jWlAPx4Z40g.
Размер видео	В данном поле из выпадающего списка можно выбрать разрешение прикрепляемого в сообщение видео.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Описание примера	Решение
Создание объявления о корпоративном мероприятии для всего отдела продаж с важным сообщением на 7 дней	Параметры: Получатели сообщения (группы) - [DR5] (отдел продаж), Заголовок сообщения - "Корпоративное мероприятие", Текст сообщения - "Приглашаем всех сотрудников отдела на мероприятие...", Важное сообщение - да, Дата(время) до которого сообщение будет важным - {{=dateadd({=System:Now}, "7d")}}, ID автора сообщения - {=User:ID}
Уведомление руководителю проекта о завершении этапа работы	Параметры: Получатели сообщения (сотрудники) - [U10] (ID руководителя), Заголовок сообщения - "Этап завершен", Текст сообщения - "Этап работы по проекту {=Document:TITLE} завершен", ID автора сообщения - {=User:ID}
Публикация отчета для группы проекта с прикрепленным файлом	Параметры: Получатели сообщения (группы) - [SG15] (ID группы проекта), Заголовок сообщения - {=Variable:REPORT_TITLE}, Текст сообщения - {=Variable:REPORT_TEXT}, Прикрепить файл(ы) к сообщению - {=Variable:REPORT_FILE_ID}, ID автора сообщения - {=User:ID}
Рассылка важного объявления всем авторизованным пользователям с видео-инструкцией	Параметры: Получатели сообщения (группы) - [UA], Заголовок сообщения - "Важное объявление", Текст сообщения - "Ознакомьтесь с новой инструкцией...", Важное сообщение - да, Добавить видео в сообщение - jWlAPx4Z40g, ID автора сообщения - {=User:ID}
Уведомление модераторов группы о новой заявке на вступление	Параметры: Получатели сообщения (группы) - [SG20_E] (модераторы группы 20), Заголовок сообщения - "Новая заявка на вступление", Текст сообщения - "Пользователь {=Variable:USER_NAME} подал заявку на вступление в группу", ID автора сообщения - {=User:ID}
Ежедневный отчет о продажах для руководства отдела	Параметры: Получатели сообщения (сотрудники) - {=Variable:MANAGERS_LIST}, Заголовок сообщения - "Отчет о продажах за {{=date('d.m.Y')}}", Текст сообщения - "Общая сумма продаж: {=Variable:SALES_SUM}, Количество сделок: {=Variable:DEALS_COUNT}", ID автора сообщения - {=User:ID}
Объявление о выходном дне для администраторов группы	Параметры: Получатели сообщения (группы) - [SG25_A] (администраторы группы 25), Заголовок сообщения - "Выходной день", Текст сообщения - "Уважаемые администраторы, {{=dateadd({=System:Now}, '1d')}} - выходной день", Важное сообщение - да, ID автора сообщения - {=User:ID}
Уведомление о новом сотруднике во все отделы компании	Параметры: Получатели сообщения (группы) - [UA], Заголовок сообщения - "Добро пожаловать, {=Variable:NEW_EMPLOYEE_NAME}!", Текст сообщения - "В компанию пришел новый сотрудник {=Variable:NEW_EMPLOYEE_NAME} на должность {=Variable:POSITION}", ID автора сообщения - {=User:ID}
Рассылка технического задания для группы разработки с несколькими файлами	Параметры: Получатели сообщения (группы) - [SG30] (группа разработки), Заголовок сообщения - "Техническое задание: {=Document:TITLE}", Текст сообщения - {=Variable:TASK_DESCRIPTION}, Прикрепить файл(ы) к сообщению - {=Variable:ATTACHED_FILES}, ID автора сообщения - {=User:ID}
Критическое уведомление для всего технического отдела с ограничением времени важности	Параметры: Получатели сообщения (группы) - [DR8] (технический отдел), Заголовок сообщения - "Критическое уведомление", Текст сообщения - "Требуется немедленное внимание к проблеме {=Variable:ISSUE_ID}", Важное сообщение - да, Дата(время) до которого сообщение будет важным - {{=dateadd({=System:Now}, "2h")}}, ID автора сообщения - {=User:ID}

Сценарий работы робота


Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Обновить пост в живой ленте

Данное активити (робот) позволяет обновлять существующие сообщения в живой ленте и группе (проект).

Название поля	Описание и примеры использования
ID поста для обновления	Данное поле является обязательным и позволяет указать ID сообщения в живой ленте, которое необходимо обновить. Пример: {=Variable:POST_ID} или 12345.
ID автора сообщения (только один)	Данное поле позволяет изменить автора сообщения. Поле необязательное - если не указано, автор останется прежним. Пример: {=Variable:AUTHOR_ID} или [U1].
Получатели сообщения (сотрудники)	Данное поле позволяет изменить получателей сообщения, указав их ID, либо передав в поле массив с ID пользователей. Если не указано, список получателей останется прежним. Пример: {=Variable:RECIPIENTS_USERS} или [U1, U5, U10].
Получатели сообщения (группы)	Позволяет изменить список групп, проектов или отделов (можно указать несколько), тогда все сотрудники вышеперечисленных структур получат доступ к сообщению в разделе "Лента". Если не указано, список получателей останется прежним. Чтобы указать получателями группу или подразделение, нужно: 1. Рядом с полем "получатели сообщения" нажать "...". 2. Выбрать пункт категории "пользователей" (как на скриншоте). 3. Выбрать пункт "Группы социальной сети". 4. Выбрав пункт "Группы социальной сети", нужно выбрать фильтр справа "Мои группы". 5. Выбрать нужную Вам группу/подразделение. Категории получателей: [DR2] - Department Recursive (сотрудники отдела с ID = 2 и его подотделов); [SG3_A] - где индекс А, обозначает администратора (владельца) группы соцсети с ID = 3); [SG3_E] - где индекс E, обозначает модераторов группы соцсети с ID = 3); [SG3_K] - где индекс K, обозначает всех членов группы соцсети с ID = 3); Пример: Приложение Лаборатория БП: Все члены группы [SG3_K] Если не поставить галочку "для публикации" в настройках группы, то все сообщения будут сначала поступать на модерацию и не будут общедоступны для просмотра. Если вы пытались обновить сообщение в Группе используя "доп. параметры" и при этом активити пишет, что сообщение обновлено, но изменений в Группе нет, то нужно удалить индекс категории получателей, т.е [SG3_K] изменить на [SG3]. Это связанно с изменением подстановочных кодов со стороны Б24. Пример: "Все члены группы [SG309_K];" изменяем на "Все члены группы [SG309];"
Заголовок сообщения	Данное поле позволяет изменить заголовок сообщения. Если не указано, заголовок останется прежним. Пример: {=Variable:TITLE} или "Обновленное объявление".
Текст сообщения	В данном поле указывается новый текст сообщения. Если не указано, текст останется прежним. Пример: {=Variable:MESSAGE_TEXT}.
Прикрепить файл(ы) к сообщению (ID файлов с диска)	В данном поле указывается ID файлов, расположенных на диске, которые должны быть прикреплены к сообщению. При обновлении новые файлы заменят старые. Пример: {=Variable:FILE_IDS}.
Добавить видео в сообщение	В данном поле необходимо указать код видео Youtube. При обновлении новые видео заменят старые. Пример: Ссылка на видео https://www.youtube.com/watch?v=jWlAPx4Z40g, где код этого видео jWlAPx4Z40g.
Размер видео	В данном поле из выпадающего списка можно выбрать разрешение прикрепляемого в сообщение видео.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Обновление текста объявления о корпоративном мероприятии	Параметры: ID поста для обновления - {=Variable:POST_ID}, Текст сообщения - {=Variable:UPDATED_TEXT}, Заголовок сообщения - "Обновленное объявление о мероприятии".
Изменение получателей сообщения при изменении состава проекта	Параметры: ID поста для обновления - {=Variable:POST_ID}, Получатели сообщения (группы) - [SG15] (новая группа проекта). Старые получатели заменятся новыми.
Добавление файлов к существующему посту	Параметры: ID поста для обновления - {=Variable:POST_ID}, Прикрепить файл(ы) к сообщению - {=Variable:NEW_FILES}. Новые файлы заменят старые.
Обновление важного объявления с изменением даты окончания важности	Параметры: ID поста для обновления - {=Variable:POST_ID}, Заголовок сообщения - {=Variable:UPDATED_TITLE}, Текст сообщения - {=Variable:UPDATED_MESSAGE}.
Замена видео в посте на новую версию	Параметры: ID поста для обновления - {=Variable:POST_ID}, Добавить видео в сообщение - jWlAPx4Z40g (новый код видео). Старое видео будет заменено.
Исправление ошибки в тексте опубликованного поста	Параметры: ID поста для обновления - {=Variable:POST_ID}, Текст сообщения - {=Variable:CORRECTED_TEXT}. Только текст изменяется, остальное остается без изменений.
Изменение автора поста при передаче ответственности	Параметры: ID поста для обновления - {=Variable:POST_ID}, ID автора сообщения - {=Variable:NEW_AUTHOR_ID}. Автор поста изменяется на нового ответственного.
Расширение аудитории поста добавлением нового отдела	Параметры: ID поста для обновления - {=Variable:POST_ID}, Получатели сообщения (группы) - [DR8] (новый отдел). Полностью заменяет список получателей.
Обновление отчета проекта с новыми данными и файлами	Параметры: ID поста для обновления - {=Variable:POST_ID}, Текст сообщения - {=Variable:UPDATED_REPORT}, Прикрепить файл(ы) к сообщению - {=Variable:REPORT_FILES}.
Исправление некорректного заголовка при публикации	Параметры: ID поста для обновления - {=Variable:POST_ID}, Заголовок сообщения - {=Variable:CORRECTED_TITLE}. Обновляется только заголовок.

Получить посты из живой ленты

Данное активити (робот) позволяет получить список пользователей, которые видят важное сообщение в живой ленте.
Результатом работы является получение массива ID пользователей, имеющих доступ к просмотру указанного важного поста.

Название поля	Описание и примеры использования
ID поста	В данном поле указывается числовой идентификатор поста, являющегося важным сообщением в живой ленте. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345. Что такое важное сообщение: Важное сообщение - это пост в живой ленте, у которого установлен флаг "Важное сообщение" и, возможно, указана дата окончания важности. Такие сообщения выделяются особым образом в интерфейсе Битрикс24 и отображаются в верхней части ленты. Данное активити возвращает список пользователей, которые: - Имеют права на просмотр этого сообщения; - Входят в список получателей (напрямую или через группы/отделы); - Видят это сообщение как важное в своей ленте. Как получить ID важного поста: ID поста можно получить несколькими способами: - Использовать активити "Получить посты из живой ленты" с фильтрацией; - Взять из URL при просмотре поста в браузере; - Использовать в цепочке с активити добавления поста с параметром "Важное сообщение = Y"; - Из возвращаемых параметров роботов, срабатывающих при создании важных постов.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Анализ охвата важных объявлений и информационных сообщений	Параметры: ID поста - {=Variable:IMPORTANT_POST_ID}. Результат: Массив результатов (массив ID пользователей), Количество результатов для анализа охвата.
Отслеживание, кто видит критически важную информацию	Параметры: ID поста - {=Variable:CRITICAL_POST_ID}. Результат: Массив результатов для проверки того, кто имеет доступ к критической информации.
Автоматическая отправка дополнительных уведомлений пользователям из списка	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в итераторе и отправки персональных уведомлений каждому пользователю.
Создание отчётов о распространении важной информации	Параметры: ID поста - {=Variable:INFO_POST_ID}. Результат: Количество результатов, Результаты через запятую для формирования отчёта о количестве информированных сотрудников.
Формирование списков для последующей рассылки или создания задач	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в активити создания задач или рассылки сообщений.
Проверка корректности настройки получателей важного сообщения	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов, Соответствует условиям (Y/N) для проверки наличия получателей.
Интеграция с системами аналитики для отслеживания информированности сотрудников	Параметры: ID поста - {=Variable:ANALYTICS_POST_ID}. Результат: Результаты через запятую для передачи данных в системы аналитики.
Автоматическое создание задач для каждого пользователя из списка получателей	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в итераторе и создания задачи каждому получателю.
При публикации важного объявления о корпоративных изменениях - формирование списка для HR-отдела	Параметры: ID поста - {=Variable:HR_POST_ID}. Результат: Массив результатов, Количество результатов для передачи HR-отделу списка информированных сотрудников.
Контроль доступа пользователей к важной информации о проекте	Параметры: ID поста - {=Variable:PROJECT_POST_ID}. Результат: Первый результат, Последний результат, Количество результатов для контроля доступа.

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

• Анализ охвата важных объявлений и информационных сообщений;
• Отслеживание, кто видит критически важную информацию;
• Автоматическая отправка дополнительных уведомлений пользователям из списка;
• Создание отчётов о распространении важной информации;
• Формирование списков для последующей рассылки или создания задач;
• Проверка корректности настройки получателей важного сообщения;
• Интеграция с системами аналитики для отслеживания информированности сотрудников;
• Автоматическое создание задач для каждого пользователя из списка получателей.

Удалить пост из живой ленты

Данное активити (робот) позволяет удалять сообщения из живой ленты.
Результатом работы является удаление указанного поста из живой ленты портала.

Название поля	Описание и примеры использования
ID пользователя, удаляющего сообщение	В данном поле указывается ID пользователя, от имени которого будет выполнено удаление поста. Можно указывать в форматах: {=User:ID}, [1] или [U1].
ID поста	В данном поле указывается числовой идентификатор сообщения, которое необходимо удалить. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Автоматическое удаление устаревших объявлений по истечении срока	Параметры: ID поста - {=Variable:OLD_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. Используется в роботе с условием проверки даты окончания важности поста.
Удаление сообщений при изменении статуса сделки	Параметры: ID поста - {=Variable:RELATED_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. Робот срабатывает при изменении статуса сделки и удаляет связанные сообщения.
Очистка ленты от тестовых сообщений	Параметры: ID поста - {=Variable:TEST_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. Используется для массового удаления тестовых сообщений после завершения тестирования.
Удаление сообщений при выполнении определённых условий в бизнес-процессе	Параметры: ID поста - {=Variable:POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. Условное удаление постов в зависимости от логики бизнес-процесса.
Автоматическое удаление временных уведомлений через определенный период	Параметры: ID поста - {=Variable:TEMP_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. Робот, срабатывающий по расписанию для удаления временных сообщений старше заданной даты.
Удаление дублирующихся сообщений при создании новой версии поста	Параметры: ID поста - {=Variable:DUPLICATE_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. При создании обновленной версии поста предыдущая версия удаляется автоматически.
Удаление сообщений с ошибками после их исправления	Параметры: ID поста - {=Variable:ERROR_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. После публикации исправленной версии сообщения, ошибочное сообщение удаляется.
Очистка постов при архивации проекта	Параметры: ID поста - {=Variable:PROJECT_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. При переводе проекта в архив все связанные посты удаляются для очистки ленты.
Удаление персональных сообщений при увольнении сотрудника	Параметры: ID поста - {=Variable:PERSONAL_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. При деактивации пользователя его персональные сообщения удаляются.
Удаление служебных сообщений после выполнения задачи	Параметры: ID поста - {=Variable:SERVICE_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. После завершения задачи служебные посты автоматически удаляются.

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

• Автоматическое удаление устаревших объявлений по истечении срока;
• Удаление сообщений при изменении статуса сделки или другой сущности;
• Очистка ленты от тестовых сообщений;
• Удаление сообщений при выполнении определённых условий в бизнес-процессе.

Расшарить пост в живой ленте

Данное активити (робот) позволяет расшарить (поделиться) пост в живой ленте, добавляя новых адресатов к существующему сообщению.
Результатом работы является расширение списка получателей поста без изменения его содержимого.

Название поля	Описание и примеры использования
ID поста для расшаривания	В данном поле указывается числовой идентификатор поста, который необходимо расшарить. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345. Как получить ID поста: ID поста можно получить несколькими способами: - Использовать активити "Получить посты из живой ленты" для поиска нужного сообщения; - Взять из URL при просмотре поста в браузере; - Использовать в цепочке с активити добавления поста (возвращает ID созданного поста); - Из возвращаемых параметров роботов, срабатывающих при создании постов.
ID пользователя, добавляющего адресатов	В данном поле можно указать ID пользователя, от имени которого будет выполнено расшаривание поста. Это необязательный параметр. Если не указан, действие выполняется от имени текущего пользователя. Можно указывать в форматах: {=User:ID}, [1] или [U1].
Новые получатели сообщения (сотрудники)	Данное поле позволяет выбрать новых получателей сообщения из числа сотрудников, указав их ID, либо передав в поле массив с ID пользователей. Это необязательный параметр, но должен быть указан хотя бы один тип получателей (сотрудники или группы). Форматы указания сотрудников: - [1] - пользователь с ID=1; - [U1] - пользователь с ID=1 (альтернативный формат); - Можно передать массив: [1, 5, 10] - несколько пользователей. Пример: {=Variable:NEW_USERS} или [U1, U5, U10].
Новые получатели сообщения (группы)	Данное поле позволяет указать ID групп, проектов или отделов (можно указать несколько), тогда все сотрудники вышеперечисленных структур получат доступ к сообщению в разделе "Лента". Это необязательный параметр, но должен быть указан хотя бы один тип получателей (сотрудники или группы). Категории получателей (группы и структуры): [SG2] - Группа социальной сети с ID = 2 (рабочая группа/проект); [DR3] - Department Recursive - сотрудники отдела с ID = 3 и его подотделов; [U2] - Конкретный пользователь с ID = 2; [UA] - Все авторизованные пользователи портала; [SG3_A] - Администратор (владелец) группы соцсети с ID = 3; [SG3_E] - Модераторы группы соцсети с ID = 3; [SG3_K] - Все члены группы соцсети с ID = 3. Примеры: - [SG5] - расшарить для группы с ID=5; - [DR2] - расшарить для отдела с ID=2 и всех его подотделов; - [UA] - расшарить для всех авторизованных пользователей; - [SG10_K] - расшарить для всех членов группы с ID=10.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Постепенное расширение аудитории важных объявлений по мере развития проекта	Параметры: ID поста для расшаривания - {=Variable:PROJECT_POST_ID}, Новые получатели сообщения (группы) - [DR5] (отдел), ID пользователя, добавляющего адресатов - {=User:ID}. По мере готовности проекта аудитория расширяется поэтапно.
Автоматическое добавление новых сотрудников к существующим информационным постам	Параметры: ID поста для расшаривания - {=Variable:INFO_POST_ID}, Новые получатели сообщения (сотрудники) - {=Variable:NEW_EMPLOYEES}, ID пользователя, добавляющего адресатов - {=User:ID}. При приёме нового сотрудника он автоматически получает доступ к важным постам.
Расшаривание отчётов и результатов работы дополнительным заинтересованным лицам	Параметры: ID поста для расшаривания - {=Variable:REPORT_POST_ID}, Новые получатели сообщения (сотрудники) - {=Variable:STAKEHOLDERS}, ID пользователя, добавляющего адресатов - {=User:ID}. После публикации отчёта он расшаривается дополнительным лицам.
Добавление к обсуждению новых участников при изменении статуса задачи или сделки	Параметры: ID поста для расшаривания - {=Variable:DISCUSSION_POST_ID}, Новые получатели сообщения (сотрудники) - {=Variable:NEW_PARTICIPANTS}, ID пользователя, добавляющего адресатов - {=User:ID}. При изменении статуса сделки к обсуждению добавляются новые участники.
Автоматическое расширение видимости поста при достижении определённых условий	Параметры: ID поста для расшаривания - {=Variable:POST_ID}, Новые получатели сообщения (группы) - [SG15] (группа проекта), ID пользователя, добавляющего адресатов - {=User:ID}. При достижении 50% готовности пост расшаривается всей команде проекта.
Включение руководства в обсуждение при возникновении критических ситуаций	Параметры: ID поста для расшаривания - {=Variable:CRITICAL_POST_ID}, Новые получатели сообщения (сотрудники) - [U100] (руководитель), ID пользователя, добавляющего адресатов - {=User:ID}. При критической ситуации руководитель автоматически подключается к обсуждению.
Добавление внешних пользователей (extranet) к проектным обсуждениям	Параметры: ID поста для расшаривания - {=Variable:PROJECT_POST_ID}, Новые получатели сообщения (сотрудники) - {=Variable:EXTRANET_USERS}, ID пользователя, добавляющего адресатов - {=User:ID}. Внешние пользователи добавляются к обсуждению проекта.
Расшаривание постов в новые отделы при реорганизации структуры компании	Параметры: ID поста для расшаривания - {=Variable:POST_ID}, Новые получатели сообщения (группы) - [DR8] (новый отдел), ID пользователя, добавляющего адресатов - {=User:ID}. При реорганизации посты расшариваются новым отделам.
Эскалация проблем - постепенное подключение специалистов при нерешенной проблеме	Параметры: ID поста для расшаривания - {=Variable:ISSUE_POST_ID}, Новые получатели сообщения (сотрудники) - [U5] (технический директор), ID пользователя, добавляющего адресатов - {=User:ID}. Если проблема не решена за 4 часа, подключается технический директор.
Постепенное информирование: от руководства к исполнителям	Параметры: ID поста для расшаривания - {=Variable:POST_ID}, Новые получатели сообщения (группы) - [SG10_K] (все члены группы), ID пользователя, добавляющего адресатов - {=User:ID}. Сначала пост для руководителей, затем для всей группы исполнителей.

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

• Постепенное расширение аудитории важных объявлений по мере развития проекта;
• Автоматическое добавление новых сотрудников к существующим информационным постам;
• Расшаривание отчётов и результатов работы дополнительным заинтересованным лицам;
• Добавление к обсуждению новых участников при изменении статуса задачи или сделки;
• Автоматическое расширение видимости поста при достижении определённых условий;
• Включение руководства в обсуждение при возникновении критических ситуаций;
• Добавление внешних пользователей (extranet) к проектным обсуждениям;
• Расшаривание постов в новые отделы при реорганизации структуры компании.

Добавить комментарий к посту

Данное активити (робот) позволяет добавлять комментарии к постам в живой ленте.
Результатом работы является создание комментария к указанному посту с возможностью прикрепления файлов.

Название поля	Описание и примеры использования
ID автора комментария	В данном поле можно указать ID пользователя, который будет автором комментария. Это необязательный параметр. Если не указан, автором станет текущий пользователь. Пример: {=User:ID} или [U1].
ID поста	В данном поле указывается числовой идентификатор поста, к которому необходимо добавить комментарий. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345. Как получить ID поста: ID поста можно получить несколькими способами: - Использовать активити "Получить посты из живой ленты" для поиска нужного сообщения; - Взять из URL при просмотре поста в браузере; - Использовать в цепочке с активити добавления поста (возвращает ID созданного поста); - Из возвращаемых параметров роботов, срабатывающих при создании постов.
Текст комментария	В данном поле указывается текст комментария, который будет добавлен к посту. Это обязательный параметр. Поддерживается форматирование текста, BB-коды и HTML-разметка. Пример: {=Variable:COMMENT_TEXT}.
Прикрепить файл(ы) к комментарию (ID файлов с диска)	В данном поле указывается массив ID файлов, расположенных на диске Битрикс24, которые должны быть прикреплены к комментарию. Это необязательный параметр. Можно прикрепить до 20 файлов за один раз. Пример: {=Variable:FILE_IDS}. Как получить ID файла с диска: - Использовать активити для работы с диском (например, "Загрузить файл на диск"); - Взять из результатов других активити, работающих с файлами; - Использовать в цепочке с активити загрузки файлов; - Найти ID файла в URL при просмотре файла на диске. Файлы скачиваются с диска, кодируются в base64 и прикрепляются к комментарию.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Автоматическое комментирование постов при изменении статуса сделки	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Статус сделки изменен на: {=Document:STAGE_ID}. Ответственный: {=Document:ASSIGNED_BY_PRINTABLE}", ID автора комментария - {=User:ID}.
Добавление уведомлений о выполнении определённых действий в виде комментариев	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Задача '{=Document:TITLE}' выполнена. Результат: {=Variable:RESULT}", ID автора комментария - {=User:ID}.
Фиксация результатов работы роботов непосредственно в обсуждении поста	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Робот завершил обработку. Обработано записей: {=Variable:PROCESSED_COUNT}", Прикрепить файл(ы) - {=Variable:REPORT_FILE_ID}, ID автора комментария - {=User:ID}.
Создание отчётов и информирование команды о статусе процессов	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Ежедневный отчёт за {{=date('d.m.Y')}}: Выполнено задач: {=Variable:COMPLETED}, В работе: {=Variable:IN_PROGRESS}", Прикрепить файл(ы) - {=Variable:REPORT_FILES}, ID автора комментария - {=User:ID}.
Автоматизация общения в проектных группах при наступлении определённых событий	Параметры: ID поста - {=Variable:PROJECT_POST_ID}, Текст комментария - "Событие: {=Variable:EVENT_NAME}. Участники: {=Variable:PARTICIPANTS}", ID автора комментария - {=User:ID}.
Прикрепление сгенерированных документов или отчётов к обсуждению в виде комментариев	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Сгенерирован документ: {=Variable:DOCUMENT_NAME}", Прикрепить файл(ы) - {=Variable:GENERATED_DOCUMENT_ID}, ID автора комментария - {=User:ID}.
Создание цепочки взаимосвязанных комментариев при многоступенчатых процессах	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Этап {=Variable:STAGE_NUMBER}: {=Variable:STAGE_STATUS}. Следующий шаг: {=Variable:NEXT_STEP}", ID автора комментария - {=User:ID}.
Комментирование с техническим заданием при создании проекта	Параметры: ID поста - {=Variable:PROJECT_POST_ID}, Текст комментария - "Техническое задание проекта '{=Document:TITLE}': {=Variable:TASK_DESCRIPTION}", Прикрепить файл(ы) - {=Variable:TASK_FILE_ID}, ID автора комментария - {=User:ID}.
Добавление комментария с напоминанием о дедлайнах	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Напоминание: дедлайн задачи '{=Document:TITLE}' наступит {{=dateadd({=Document:DEADLINE}, '-1d')}}. Ответственный: {=Document:RESPONSIBLE_BY_PRINTABLE}", ID автора комментария - {=User:ID}.
Информирование о результатах автоматической обработки данных	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Обработка завершена. Обработано: {=Variable:PROCESSED}, Ошибок: {=Variable:ERRORS}. Лог прикреплен.", Прикрепить файл(ы) - {=Variable:LOG_FILE_ID}, ID автора комментария - {=User:ID}.

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

• Автоматическое комментирование постов при изменении статуса сделки или задачи;
• Добавление уведомлений о выполнении определённых действий в виде комментариев;
• Фиксация результатов работы роботов непосредственно в обсуждении поста;
• Создание отчётов и информирование команды о статусе процессов;
• Автоматизация общения в проектных группах при наступлении определённых событий;
• Прикрепление сгенерированных документов или отчётов к обсуждению в виде комментариев;
• Создание цепочки взаимосвязанных комментариев при многоступенчатых процессах.

Получить пользователей важного сообщения

Данное активити (робот) позволяет получить список пользователей, которые видят важное сообщение в живой ленте.
Результатом работы является получение массива ID пользователей, имеющих доступ к просмотру указанного важного поста.

Название поля	Описание и примеры использования
ID поста	В данном поле указывается числовой идентификатор поста, являющегося важным сообщением в живой ленте. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345. Что такое важное сообщение: Важное сообщение - это пост в живой ленте, у которого установлен флаг "Важное сообщение" и, возможно, указана дата окончания важности. Такие сообщения выделяются особым образом в интерфейсе Битрикс24 и отображаются в верхней части ленты. Данное активити возвращает список пользователей, которые: - Имеют права на просмотр этого сообщения; - Входят в список получателей (напрямую или через группы/отделы); - Видят это сообщение как важное в своей ленте. Как получить ID важного поста: ID поста можно получить несколькими способами: - Использовать активити "Получить посты из живой ленты" с фильтрацией; - Взять из URL при просмотре поста в браузере; - Использовать в цепочке с активити добавления поста с параметром "Важное сообщение = Y"; - Из возвращаемых параметров роботов, срабатывающих при создании важных постов.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Анализ охвата важных объявлений и информационных сообщений	Параметры: ID поста - {=Variable:IMPORTANT_POST_ID}. Результат: Массив результатов (массив ID пользователей), Количество результатов для анализа охвата.
Отслеживание, кто видит критически важную информацию	Параметры: ID поста - {=Variable:CRITICAL_POST_ID}. Результат: Массив результатов для проверки того, кто имеет доступ к критической информации.
Автоматическая отправка дополнительных уведомлений пользователям из списка	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в итераторе и отправки персональных уведомлений каждому пользователю.
Создание отчётов о распространении важной информации	Параметры: ID поста - {=Variable:INFO_POST_ID}. Результат: Количество результатов, Результаты через запятую для формирования отчёта о количестве информированных сотрудников.
Формирование списков для последующей рассылки или создания задач	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в активити создания задач или рассылки сообщений.
Проверка корректности настройки получателей важного сообщения	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов, Соответствует условиям (Y/N) для проверки наличия получателей.
Интеграция с системами аналитики для отслеживания информированности сотрудников	Параметры: ID поста - {=Variable:ANALYTICS_POST_ID}. Результат: Результаты через запятую для передачи данных в системы аналитики.
Автоматическое создание задач для каждого пользователя из списка получателей	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в итераторе и создания задачи каждому получателю.
При публикации важного объявления о корпоративных изменениях - формирование списка для HR-отдела	Параметры: ID поста - {=Variable:HR_POST_ID}. Результат: Массив результатов, Количество результатов для передачи HR-отделу списка информированных сотрудников.
Контроль доступа пользователей к важной информации о проекте	Параметры: ID поста - {=Variable:PROJECT_POST_ID}. Результат: Первый результат, Последний результат, Количество результатов для контроля доступа.

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

• Анализ охвата важных объявлений и информационных сообщений;
• Отслеживание, кто видит критически важную информацию;
• Автоматическая отправка дополнительных уведомлений пользователям из списка;
• Создание отчётов о распространении важной информации;
• Формирование списков для последующей рассылки или создания задач;
• Проверка корректности настройки получателей важного сообщения;
• Интеграция с системами аналитики для отслеживания информированности сотрудников;
• Автоматическое создание задач для каждого пользователя из списка получателей.

Интеграции

SENLER - Добавление в группу подписки VK сообщества

Данное активити позволяет добавить подписчика VK в базу данных сервиса Senler.
Senler, это сервис, который позволяет отправлять рассылки через социальную сеть VK, и наше активити работает только с уже импортированными из базы подписчиками. 

Ключ из Callback API: в данное поле вставляется специальный секретный ключ.
Для получения ключа перейдите в следующие пункты меню настроек в личном кабинете Senler: Настройки -> Подключение ->  Ручная настройка (в п. Подключение) -> Секретный ключ. 
Скопируйте ключ (для того, чтобы это сделать, нужно сделать ключ видимым с помощью иконки "Показать ключ" в конце строки с ключем). 

Тип сущности: в этом поле указывается тип сущности с которой будет происходить работа активити.

ID сущности: в этом поле указывается ID сущности, с которой будет происходить работа.

Идентификатор пользователя ВКонтакте: в данном поле указывается ID пользователя в VK (id12345678), в формате 12345678. 
Если ID не указан, то он будет сам подгружаться из сущности.

Числовой идентификатор сообщества ВКонтакте: в данном поле указывается ID группы в VK. 
ID группы можно получить несколькими способами:
1. Скопировать ID группы из адресной строки браузера.
2. В личном кабинете senler, во  вкладке  "Мои сообщества", есть список сообществ, под каждым из сообществ есть перечень данных об этом сообществе, среди этих данных есть ID этого сообщества.
Пример: @club123456789, где 123456789 -  ID сообщества.
3. Если ID сообщества буквенный, а для активити нужно только числовой вариант, то нужно воспользоваться специальным сервисом по получению ID сообщества, таких сервисов довольно много, и их довольно легко найти воспользовавшись поиском в google.
Идентификатор группы подписчиков (0 - без группы): в данном поле указывается ID группы подписчиков (цифрами, без доп знаков)
Сам идентификатор выглядит так:#123456. 
Для его получения личном кабинете Senler нужно: 
1. Выбрать интересующую Вас группу в VK.
2. Перейти во вкладку "Группы подписчиков".
3. Найти нужную группу подписчиков и в правом верхнем углу этой группы будет указан ID этой группы в формате #123456 

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

SENLER - Удаление из группы подписки VK сообщества

Данное активити позволяет удалить подписчика из группы подписки VK сообщества.
Senler, это сервис, который позволяет отправлять рассылки через социальную сеть VK, и наше активити работает только с уже импортированными из базы подписчиками. 

Ключ из Callback API: в данное поле вставляется специальный секретный ключ.
Для получения ключа перейдите в следующие пункты меню настроек в личном кабинете Senler: Настройки -> Подключение ->  Ручная настройка (в п. Подключение) -> Секретный ключ. 
Скопируйте ключ (для того, чтобы это сделать, нужно сделать ключ видимым с помощью иконки "Показать ключ" в конце строки с ключем). 

Тип сущности: в этом поле указывается тип сущности с которой будет происходить работа активити.

ID сущности: в этом поле указывается ID сущности, с которой будет происходить работа.

Идентификатор пользователя ВКонтакте: в данном поле указывается ID пользователя в VK, в формате id12345678. 
Если ID не указан, то он будет сам подгружаться из сущности.

Числовой идентификатор сообщества ВКонтакте: в данном поле указывается ID группы в VK. 
ID группы можно получить несколькими способами:
1. Скопировать ID группы из адресной строки браузера.
2. В личном кабинете senler, во  вкладке  "Мои сообщества", есть список сообществ, под каждым из сообществ есть перечень данных об этом сообществе, среди этих данных есть ID этого сообщества.
Пример: @club123456789, где 123456789 -  ID сообщества.
3. Если ID сообщества буквенный, а для активити нужно только числовой вариант, то нужно воспользоваться специальным сервисом по получению ID сообщества, таких сервисов довольно много, и их довольно легко найти воспользовавшись поиском в google.
Идентификатор группы подписчиков (0 - без группы): в данном поле указывается ID группы подписчиков (цифрами, без доп знаков)
Сам идентификатор выглядит так:#123456. 
Для его получения личном кабинете Senler нужно: 
1. Выбрать интересующую Вас группу в VK.
2. Перейти во вкладку "Группы подписчиков".
3. Найти нужную группу подписчиков и в правом верхнем углу этой группы будет указан ID этой группы в формате #123456 

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Комментарии (таймлайн)

Поиск комментариев из таймлайн сущности CRM

Данное активити позволяет получить список всех комментариев для определенной CRM сущности, указав для фильтра параметры этой сущности.
Результатом работы активити, будет получение списка комментариев из определенной CRM сущности в виде массива для итератора, строки, а так же количества найденных элементов (комментариев), которые соответствуют условиям поиска.

ID сущности: в данном поле указывается ID сущности к которой привязаны записи в тайм лайне.

Тип сущности: в данном поле из выпадающего списка нужно выбрать тип сущности, к которой привязаны записи в тайм лайне.
Активити работает со следующими типами сущностей:

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• Смарт-процесс.

Автор:в данном поле указывается автор искомых сообщений, в виде его ID, при этом ID должен быть указан без скобок или каких-либо лишних данных.

Текст комментария: в данном поле указывается текст комментария.

Делать отладочные сообщения в журнале БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получение всех коментариев из таймлайн сущности CRM

Данное активити позволяет поучить список ID всех комментариев выбранной CRM сущности.

Сценарий работы активити бизнес-процесса

ID сущности: в данном поле указывается ID сущности, к которой привязан комментарий.

Тип сущности: в данном поле, из выпадающего списка нужно выбрать тип сущности, к которой привязан комментарий.
Активити работает со следующими типами сущностей:

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• Смарт-процесс.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Удаление коментария из таймлайна

Данное активити позволяет удалить комментарий из тайм лайна.

Сценарий работы активити бизнес-процесса

ID комментария: в данном поле указывается ID комментария, который нужно удалить.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Список привязок к записи в таймлайне

Данное активити позволяет получить список привязок к записи в тайм лайне.

Сценарий работы активити бизнес-процесса

ID записи в тайм лайне: в данном полу указывается ID записи в тайм лайне CRM сущности.

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

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Изменение коментария из таймлайна

Данное активити позволяет изменить комментарий в тайм лайне сущности.

Сценарий работы активити бизнес-процесса

ID комментария: в данном поле указывается ID изменяемого комментария.
Текст комментария: в данном поле указывается новый текст для изменяемого комментария

ВАЖНО! 
Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

Если вы планируете через интегратор произвести изменение более 1000 сущностей, то нужно встраивать в БП счетчик, и после 1000 изменений делать паузу на 15 минут, если этого не сделать, то это приведет к тормозам в обработке на стороне Б24 и остальные сущности могут не отработаться.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли делать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Создание комментария в тайм лайн сущности CRM

Данное активити позволяет отправлять текст сообщения, выбранному типу сущности с указанным ID сущности.
Так же данное активити позволяет выводить результат работы других активити в ленту, при условии правильной настройки.

Тип сущности: в данном поле указывается тип сущности к которой будет привязан бизнес-процессу данного дела. Выбирается из выпадающего списка.

Активити работает со следующими типами сущностей:

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• Смарт-процесс.

ID Сущности: в данном пункте указывается ID сущности, которую необходимо изменить.

Заголовок сообщения: в данной графе указывается текстовый заголовок сообщения.

Текст сообщения: в данной графе указывается текст сообщения.
Так же в данном поле можно вывести возвращаемые параметры из предшествующих активити.
Для этого нужно нажать кнопку "...", а далее выбрать пункт "Дополнительные результаты", после чего выбрать результаты, который необходимо вывести.

Добавить видео в сообщение: в данном поле необходимо указать код видео Youtube.
Пример:
Ссылка на видео https://www.youtube.com/watch?v=jWlAPx4Z40g, где код этого видео jWlAPx4Z40g .

Размер видео: в данном поле из выпадающего списка можно выбрать разрешение прикрепляемого в сообщение видео.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания(Время ожидания ответа от приложения):
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

 

Получение данных о коментарии из таймлайн сущности CRM

Данное активити позволяет получить данные о комментарии, прикрепленном к сущности CRM.

Сценарий работы активити бизнес-процесса

ID комментария в тайм лайне: в данном поле указывается ID комментария, данные которого Вам нужно получить. Получить эти данные вы можете из возвращаемых параметров другого активити.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Установка-снятие привязки коментария с сущности crm

Данное активити позволяет установить или снять привязку комментария с сущности CRM .

Сценарий работы активити бизнес-процесса

Операция с привязкой: в данном полу указывается тип операции привязки: снять привязку или установить привязку.

ID комментария в тайм лайне: в данном поле указывается ID комментария в тайм лайне.

ID сущности: в данном поле указывается ID сущности, к которой привязаны комментарии.

Тип сущности: в данном поле указывается тип сущности, к которой привязан комментарий.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Компании

Умный поиск компаний по реквизитам

Данное активити позволяет получить список ID компаний у которых заполнены или не заполнены реквизиты.

Заполнены реквизиты: в данном поле указывается заполнены реквизиты или нет.

ИНН, КПП, ОГРН, ОГРНИП, КБЕ, ИИН: в данных полях указываются реквизиты, по которым будет осуществлен поиск компании.
Для поиска любого значения, укажите в поле "##"

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов.
Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания.
Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Получение данных по сущности: Компания

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

• Получение всех данных компании по её ID для использования в бизнес-процессе;
• Извлечение информации о компании для формирования документов или отчётов;
• Получение данных компании для передачи во внешние системы;
• Автоматическая проверка и валидация данных компании;
• Формирование персонализированных коммерческих предложений;
• Синхронизация данных компании между сущностями CRM;
• Подготовка данных для массовых рассылок и уведомлений.

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

Название поля	Описание и примеры использования
ID сущности	Обязательный параметр. В данном поле указывается ID компании, данные которой требуется получить. Примеры: - {=Document:ID} - ID текущей компании из документа; - 123 - конкретный ID компании; - {=Variable:COMPANY_ID} - ID компании из переменной; - {=Document:COMPANY_ID} - ID компании из связанной сущности (сделки, контакта); - {=A1988_22222_92566_99999:search_results} - ID из результата поиска.
Для печати	Варианты: да/нет. Данное поле позволяет включить вывод данных в удобном для печати текстовом виде.
Сообщение об ошибке	Варианты: да/нет. Позволяет выводить ошибки в журнал БП.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Примеры использования:

№	Сценарий	ID сущности	Для печати
1	Получить данные текущей компании	{=Document:ID}	Нет
2	Получить данные компании из сделки	{=Document:COMPANY_ID}	Нет
3	Получить данные для документа	{=Variable:COMPANY_ID}	Да
4	Получить данные из результата поиска	{=A1988_22222_92566_99999:search_results}	Нет
5	Получить данные в итераторе	{=Iterator:Value}	Нет
6	Получить данные конкретной компании	12345	Нет
7	Формирование коммерческого предложения	{=Document:COMPANY_ID}	Да
8	Проверка реквизитов	{=Variable:COMPANY_ID}	Нет
9	Синхронизация с 1С	{=Variable:COMPANY_ID}	Нет
10	Получить данные из контакта	{=Document:COMPANY_ID}	Нет

Возвращаемые параметры для данного активити:

• Все параметры из сущности "Компания" - все стандартные и пользовательские поля компании, включая:
  - ID компании;
  - Название компании;
  - Телефоны, Email, Сайты;
  - Тип компании;
  - Отрасль;
  - Ответственный;
  - Источник;
  - Комментарии;
  - Адресные поля;
  - UTM-метки;
  - Пользовательские поля (UF_*);
  - и другие поля.
• Сообщение об ошибке - текст ошибки при неуспешном выполнении.

Удаление компании

Данное активити позволяет удалить сущность "Компания", указав её ID.

ID компании: в данном поле нужно указать ID удаляемой компании.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск Компаний с реквизитами и без них

Данное активити позволяет получить список ID компаний у которых заполнены или не заполнены реквизиты.
Результатом работы является получение списка ID компаний в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Заполнены реквизиты у компании: в данном поле указывается заполнены реквизиты компании или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск компаний по адресу

Данное активити позволяет выполнить поиск компаний по данным в адресном реквизите.
Результатом работы является получение списка ID, найденных компаний в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Тип адреса: в данном поле указывается тип адреса, который указан в сущности компания: фактический адрес, адрес регистрации, юр. Адрес, адрес бенефициара.
Улица, дом, корпус, строение: в данном поле указывается адрес дома, корпуса, строения, указанный в адресных данных компании.

Квартира / офис: в данном поле указывается квартира или офис, которые указанны в адресных данных компании.

Город: в данном поле указывается город, в котором расположена компания.

Почтовый индекс: в данном поле указывается почтовый индекс, в котором расположена компания.

Район: в данном поле указывается район, в котором расположена компания.

Область: в данном поле указывается область, в которой расположена компания.

Страна: в данном поле указывается страна, в котором расположена и зарегистрирована компания.

Код страны: в данном поле указывается код страны, в которой расположена компания.


Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

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

Период ожидания(Время ожидания ответа от приложения): Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Изменение компании

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

• Автоматическое обновление данных компании на основе информации из других систем;
• Изменение ответственного за компанию по определённым условиям;
• Обновление контактной информации (телефоны, email, адрес);
• Изменение типа компании или сферы деятельности;
• Обновление реквизитов и финансовой информации;
• Синхронизация данных компании с внешними системами (1С, ERP);
• Обновление UTM-меток и рекламных данных.

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

Название поля	Описание и примеры использования
ID компании	Обязательный параметр. ID компании, данные о которой необходимо изменить. Если поле имеет привязку к элементам инфоблоков (привязка к спискам), для изменения значения нужно указывать ID элемента. Примеры: - {=Document:ID} - ID текущей компании; - 123 - конкретный ID компании; - {=Variable:COMPANY_ID} - ID из переменной.
Очистить почты и(или) телефоны	Удаление почт или телефонов в компании. Варианты: почта, телефон, почта и телефон, не очищать.
Название компании	Новое название компании.
Тип компании	Тип к которому принадлежит компания. Значения берутся из справочника CRM.
Фактический адрес	Фактический адрес расположения компании.
Адрес (стр. 2)	Квартира/офис компании.
Город	Город, в котором находится компания.
Почтовый индекс	Почтовый индекс компании.
Район	Район, в котором находится компания.
Область	Область, в которой находится компания.
Страна	Страна, в которой находится компания.
Код страны	Код страны, в которой находится компания.
Юридический адрес	Юридический адрес компании (адрес регистрации, например в налоговой).
Банковские реквизиты	Банковские реквизиты компании.
Сфера деятельности	Сфера деятельности компании. Выбирается из выпадающего списка.
Валюта	Валюта для расчётов с данной компанией.
Годовой оборот	Годовой оборот компании.
Комментарии	Комментарии к компании.
Ответственный	ID ответственного за компанию. Формат: user_ID (например, user_1).
Контакт	ID контакта, связанного с компанией.
UTM-метки	Рекламная система, тип трафика, обозначение рекламной кампании, содержание кампании, условие поиска.
Телефон	Телефон компании. Активити добавляет, не удаляет существующие.
E-MAIL	Email компании. Активити добавляет, не удаляет существующие.
Сайт	Сайт компании. Активити добавляет, не удаляет существующие.

Примеры использования:

№	Сценарий	ID Компании	Изменяемое поле	Значение
1	Изменить ответственного	{=Document:ID}	Ответственный	user_25
2	Обновить название	{=Variable:COMPANY_ID}	Название компании	ООО "Новое название"
3	Изменить тип компании	{=Document:ID}	Тип компании	CLIENT
4	Добавить телефон	{=Document:ID}	Телефон	+79001234567
5	Обновить адрес	{=Variable:COMPANY_ID}	Фактический адрес	ул. Ленина, д. 1
6	Изменить сферу деятельности	{=Document:ID}	Сфера деятельности	IT
7	Очистить телефоны	{=Document:ID}	Очистить	Телефон
8	Добавить комментарий	{=Document:ID}	Комментарии	Обновлено: {=System:Date}
9	Изменить валюту	{=Document:ID}	Валюта	RUB
10	Добавить email	{=Document:ID}	E-MAIL	{=Variable:EMAIL}

Возвращаемые параметры для данного активити:

• ID компании (company_id) - числовой идентификатор изменённой компании;
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Поиск Компаний (v.2)

Активити (робот) "Поиск Компаний (v.2)" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Поиск компаний по различным полям (название, тип, отрасль, ответственный и т.д.);
• Фильтрация компаний по множеству критериев одновременно;
• Поиск компаний по частичному совпадению названия;
• Поиск компаний за определённый период (по дате создания или изменения);
• Поиск компаний по пользовательским полям;
• Проверка наличия компании перед созданием дубликата;
• Получение списка ID компаний для массовых операций.

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

Название поля	Описание и примеры использования
Название компании	Поиск по названию компании. Поддерживается частичное совпадение. Примеры: - ООО "Ромашка" - точное совпадение; - ={%Ромашка%} - частичное совпадение (содержит "Ромашка"); - ={%ООО%} - все компании, содержащие "ООО".
Тип компании	Поиск по типу компании. Указывается символьный код типа из справочника CRM. Примеры: - CLIENT - клиенты; - SUPPLIER - поставщики; - PARTNER - партнёры.
Ответственный	Поиск по ответственному за компанию. Примеры: - {=Document:ASSIGNED_BY_ID} - ответственный из текущего документа; - user_25 - конкретный пользователь; - {=User:ID} - текущий пользователь.
Сфера деятельности	Поиск по сфере деятельности компании. Указывается символьный код.
Дата создания	Поиск по дате создания компании. Поддерживаются операторы сравнения. Примеры: - >={{=dateadd({=System:Now}, "-30d")}} - созданные за последние 30 дней; - <={{=dateadd({=System:Now}, "-1d")}} - созданные до вчерашнего дня.
Пользовательские поля	Активити (робот) автоматически создаёт параметры для всех пользовательских полей (UF_*) вашего портала.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Используйте только по необходимости из-за большого расхода запросов.
Запускать от имени	Сотрудник, с правами которого выполняется активити. Рекомендуется выбирать администратора.

Операторы сравнения для поиска:

Оператор	Описание	Пример
=	Точное совпадение	={123}
!	Не равно	={!123}
>=	Больше или равно	>={100}
<=	Меньше или равно	<={100}
>	Больше	>{100}
<	Меньше	<{100}
%	Содержит (для строк)	={%текст%}
!%	Не содержит (для строк)	={!%текст%}

Примеры использования:

№	Сценарий	Параметры поиска
1	Поиск по названию	Название: ={%Ромашка%}
2	Поиск по типу	Тип: CLIENT
3	Поиск по ответственному	Ответственный: {=Document:ASSIGNED_BY_ID}
4	Поиск за последний месяц	Дата создания: >={{=dateadd({=System:Now}, "-30d")}}
5	Поиск по отрасли	Сфера деятельности: IT
6	Поиск по нескольким критериям	Тип: CLIENT, Ответственный: user_1
7	Проверка дубликата	Название: ={ООО "Точное название"}
8	Поиск по пользовательскому полю	UF_CRM_*: {=Variable:VALUE}
9	Поиск активных компаний	Статус: ACTIVE
10	Поиск по городу	Город: Москва

Возвращаемые параметры для данного активити:

• Результат поиска (массив для итератора) (search_results_array) - массив чисел с ID найденных компаний;
• Результат поиска (строка) (search_results_string) - строка со всеми результатами поиска через запятую;
• Первый результат поиска (search_result_first_string) - строка с первым результатом;
• Последний результат поиска (search_result_last_string) - строка с последним результатом;
• Количество найденных элементов (count_search) - числовое значение;
• Соответствует условиям (math_search_results) - Y (найдены) или N (не найдены);
• Логи ошибок (s_error_logs) - описание ошибки или сообщение об успехе.

Поиск Компании по ИНН КПП

Данное активити позволяет получить список ID компании по ИНН КПП.
Результатом работы является получение списка ID компаний в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

ИНН:  в данном поле указываются реквизиты компаний, которые нужно найти.
Для поиска любого значения ИНН введите "##", если же нужна компания с конкретным ИНН, то нужно указать ИНН этой компании.
Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Контакты

Получение данных по сущности: Контакт

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

• Получение всех данных контакта по его ID для использования в бизнес-процессе;
• Извлечение информации о контакте для формирования документов или отчётов;
• Получение данных контакта для передачи во внешние системы;
• Автоматическая проверка и валидация данных контакта;
• Формирование персонализированных сообщений на основе данных контакта;
• Синхронизация данных контакта между сущностями CRM;
• Подготовка данных для массовых рассылок и уведомлений.

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

Название поля	Описание и примеры использования
ID сущности	Обязательный параметр. В данном поле указывается ID контакта, данные которого необходимо получить. Примеры: - {=Document:ID} - ID текущего контакта из документа; - 123 - конкретный ID контакта; - {=Variable:CONTACT_ID} - ID контакта из переменной; - {=A1988_22222_92566_99999:search_results} - ID из результата поиска.
Для печати	Варианты: да/нет. Данное поле позволяет включить вывод данных в удобном для печати текстовом виде.
Сообщение об ошибке	Варианты: да/нет. Позволяет выводить ошибки в журнал БП.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Данная опция позволяет ограничить срок ожидания ответа. Технические особенности платформы Битрикс24 иногда создают ситуацию с очередями запросов, что может помешать работе активити.

Примеры использования:

№	Сценарий	ID сущности	Для печати
1	Получить данные текущего контакта	{=Document:ID}	Нет
2	Получить данные для отчёта	{=Variable:CONTACT_ID}	Да
3	Получить данные из результата поиска	{=A1988_22222_92566_99999:search_results}	Нет
4	Получить данные из сделки	{=Document:CONTACT_ID}	Нет
5	Получить данные в итераторе	{=Iterator:Value}	Нет
6	Получить данные конкретного контакта	12345	Нет
7	Формирование документа	{=Variable:CONTACT_ID}	Да
8	Проверка данных контакта	{=Document:CONTACT_ID}	Нет
9	Синхронизация с внешней системой	{=Variable:CONTACT_ID}	Нет
10	Формирование персонализированного сообщения	{=Document:CONTACT_ID}	Нет

Возвращаемые параметры для данного активити:

• Все данные из сущности контакт - все стандартные и пользовательские поля контакта, включая:
  - ID контакта;
  - Имя, Фамилия, Отчество;
  - Телефоны, Email, Сайты;
  - Компания (ID связанной компании);
  - Ответственный;
  - Должность;
  - Источник;
  - Комментарии;
  - UTM-метки;
  - Пользовательские поля (UF_*);
  - и другие поля.
• Сообщение об ошибке - текст ошибки при неуспешном выполнении.

Удаление контакта

Данное активити позволяет удалить сущность "Контакт", указав её ID.

ID контакта: в данном поле нужно указать ID удаляемого контакта.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск Контактов с реквизитами и без

Данное активити позволяет получить список ID контактов по наличию или отсутствию у них реквизитов.
Результатом работы является получение списка ID контактов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Заполнены реквизиты у контакта: в данном поле указывается заполнены реквизиты контакта или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск контактов по адресу

Данное активити позволяет выполнить поиск контактов по данным в адресном реквизите.
Результатом работы является получение списка ID контактов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Тип адреса: в данном поле указывается тип адреса реквизитов, который указан в искомом контакте: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.
Улица, дом, корпус, строение: в данном поле указываются адресные данные контакта, такие как улица, дом, корпус, строение, которые указан в адресном реквизите.

Квартира / офис: в данном поле указывается номер квартиры или офиса, который указан в адресном реквизите.

Город: в данном поле указывается город, где проживает или находится данный контакт, который указан в адресном реквизите.

Почтовый индекс: в данном поле указывается почтовый индекс, который указан в адресном реквизите.

Район: в данном поле указывается район расположения контакта, который указан в адресном реквизите.

Область: в данном поле указывается область, которая указана в адресном реквизите.

Страна: в данном поле указывается страна, которая указана в адресном реквизите.

Код страны:  в данном поле указывается код страны, который указан в адресном реквизите.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Изменение Контакта

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

• Автоматическое обновление данных контакта на основе информации из других систем;
• Изменение ответственного за контакт по определённым условиям;
• Обновление контактной информации (телефоны, email, адрес);
• Привязка контакта к компании или нескольким компаниям;
• Изменение типа контакта или источника;
• Обновление UTM-меток и рекламных данных;
• Синхронизация данных контакта с внешними системами.

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

Название поля	Описание и примеры использования
ID Контакта	Обязательный параметр. ID контакта, которого необходимо изменить. Если поле имеет привязку к элементам инфоблоков (привязка к спискам), для изменения значения нужно указывать ID элемента. Примеры: - {=Document:ID} - ID текущего контакта; - 123 - конкретный ID контакта; - {=Variable:CONTACT_ID} - ID из переменной.
Очистить почты и(или) телефоны	Удаление почт или телефонов в контакте. Варианты: почта, телефон, почта и телефон, не очищать.
Обращение	Обращение к клиенту (мистер, товарищ, госпожа и т.д.).
Имя	Новое значение имени контакта.
Фамилия	Новое значение фамилии контакта.
Отчество	Новое значение отчества контакта.
Дата рождения	Новое значение даты рождения контакта.
Тип контакта	Изменение типа контакта. Значения берутся из справочника CRM.
Источник	Изменение источника контакта. Значения берутся из справочника CRM.
Описание	Тип источника, из которого контакт попал в CRM.
Должность	Изменение должности контакта.
Адресные поля	Адрес, город, почтовый индекс, район, область, страна (устаревшие поля, сейчас используются реквизиты).
Комментарий	Изменение комментария контакта.
Доступен для всех	Варианты: да/нет. Доступен ли контакт для всех сотрудников.
Ответственный	Изменение ответственного за контакт. Указывается ID пользователя.
Компания	Изменение компании, которая относится к контакту. Указывается ID компании.
Компании	Изменение нескольких компаний для контакта (когда один контакт привязан к множеству компаний).
UTM-метки	Рекламная система, тип трафика, обозначение рекламной кампании, содержание кампании, условие поиска.
Телефон	Добавление телефонов. Активити только добавляет, не удаляет существующие.
EMAIL	Добавление адресов электронной почты. Активити только добавляет, не удаляет существующие.
Сайт	Добавление адресов сайтов. Активити только добавляет, не удаляет существующие.
Мессенджеры	Добавление адресов интернет-мессенджеров.

Примеры использования:

№	Сценарий	ID Контакта	Изменяемое поле	Значение
1	Изменить ответственного	{=Document:ID}	Ответственный	user_25
2	Обновить должность	{=Variable:CONTACT_ID}	Должность	Директор
3	Привязать к компании	{=Document:ID}	Компания	{=Variable:COMPANY_ID}
4	Добавить телефон	{=Document:ID}	Телефон	+79001234567
5	Изменить тип контакта	{=Document:ID}	Тип контакта	CLIENT
6	Обновить ФИО	{=Variable:CONTACT_ID}	Имя, Фамилия	Иван, Петров
7	Очистить телефоны	{=Document:ID}	Очистить	Телефон
8	Добавить комментарий	{=Document:ID}	Комментарий	Обновлено: {=System:Date}
9	Изменить источник	{=Document:ID}	Источник	WEB
10	Добавить email	{=Document:ID}	EMAIL	{=Variable:EMAIL}

Возвращаемые параметры для данного активити:

• ID контакта (contact_id) - числовой идентификатор изменённого контакта;
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Поиск Контактов по ИНН КПП

Данное активити позволяет получить список ID контактов по ИНН КПП.
Результатом работы является получение списка ID контактов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

ИНН: в данном поле указываются реквизиты контактов, которые нужно найти.
Для поиска любого значения ИНН введите "##", если же нужен контакт с конкретным ИНН, то нужно указать ИНН этого контакта.


Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск Контакта (v.2)

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

• Поиск контактов по ФИО, должности, адресу и другим полям;
• Поиск контактов по телефону или email с использованием механизма поиска дубликатов;
• Фильтрация контактов для создания отчётов и аналитики;
• Автоматический поиск связанных контактов при работе со сделками и лидами;
• Поиск дубликатов контактов для очистки базы данных;
• Поиск контактов по UTM-меткам для анализа эффективности маркетинга;
• Поиск контактов по дате создания или изменения для контроля актуальности данных;
• Поиск контактов по пользовательским полям для сложной фильтрации;
• Массовые операции над группой контактов (изменение полей, назначение ответственного);
• Интеграция с внешними системами через поиск по внешним идентификаторам.

Название поля	Описание и примеры использования
Сообщение об ошибке	В данном поле указывается, будет ли выводиться сообщение об ошибке в журнал БП или нет. Варианты: да/нет.
ID	В данном поле указывается числовой идентификатор искомого контакта. Примеры: - ={123} - найти контакт с ID равным 123; - ={!123} - найти все контакты, кроме контакта с ID 123; - {=Document:CONTACT_ID} - использовать ID контакта из текущего документа.
Имя	В данном поле указывается имя искомого контакта. Поддерживает поиск по частичному совпадению. Примеры: - ={%Иван} - найти контакты, имя которых содержит "Иван"; - ={Иван} - найти контакты с точным именем "Иван"; - ={!%Тест} - найти контакты, имя которых не содержит "Тест".
Отчество	В данном поле указывается отчество искомого контакта. Поддерживает поиск по частичному совпадению. Примеры: - ={%Иванович} - найти контакты с отчеством, содержащим "Иванович"; - ={Петрович} - найти контакты с точным отчеством "Петрович".
Фамилия	В данном поле указывается фамилия искомого контакта. Поддерживает поиск по частичному совпадению. Примеры: - ={%Петров} - найти контакты с фамилией, содержащей "Петров"; - ={Иванов} - найти контакты с точной фамилией "Иванов"; - {=Document:LAST_NAME} - использовать фамилию из текущего документа.
Описание	В данном поле указывается текст описания искомого контакта. Поддерживает поиск по частичному совпадению. Примеры: - ={%VIP} - найти контакты, описание которых содержит "VIP"; - ={!%тест} - найти контакты, описание которых не содержит "тест".
Должность	В данном поле указывается должность искомого контакта. Примеры: - ={%директор} - найти контакты с должностью, содержащей "директор"; - ={Менеджер} - найти контакты с точной должностью "Менеджер".
Адрес	В данном поле указывается фактический адрес контакта (устаревшее поле, сейчас используются реквизиты). Примеры: - ={%Москва} - найти контакты с адресом, содержащим "Москва".
Адрес (стр. 2)	В данном поле указывается адрес квартиры или офиса контакта (устаревшее поле, сейчас используются реквизиты).
Город	В данном поле указывается город расположения контакта (устаревшее поле, сейчас используются реквизиты). Примеры: - ={Санкт-Петербург} - найти контакты из Санкт-Петербурга.
Почтовый индекс	В данном поле указывается почтовый индекс контакта (устаревшее поле, сейчас используются реквизиты).
Район	В данном поле указывается район контакта.
Область	В данном поле указывается область контакта.
Страна	В данном поле указывается страна контакта. Примеры: - ={Россия} - найти контакты из России.
Код страны	В данном поле указывается код страны контакта. Примеры: - ={RU} - найти контакты с кодом страны RU.
Комментарий	В данном поле указывается текст комментария к контакту. Поддерживает поиск по частичному совпадению. Примеры: - ={%важно} - найти контакты, комментарий которых содержит "важно".
Дата создания	В данном поле указывается дата создания контакта. Поддерживает поиск по точной дате и диапазонам дат. Примеры: - ={=>01.01.2025 00:00:00} - найти контакты, созданные после 1 января 2025 года; - ={{01.01.2025 00:00:00}}##{{31.12.2025 23:59:59}} - найти контакты, созданные в 2025 году.
Дата изменения	В данном поле указывается дата последнего изменения контакта. Примеры: - ={=>01.03.2025 00:00:00} - найти контакты, изменённые после 1 марта 2025 года.
Внешний источник	В данном поле указывается идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Идентификатор элемента внешнего источника	В данном поле указывается внешний ключ, используемый для операций обмена. Идентификатор объекта внешней информационной базы.
Версия оригинала	В данном поле указывается версия внешнего ключа, используемого для операций обмена.
Рекламная система (UTM_SOURCE)	В данном поле указывается UTM SOURCE из UTM-метки. Примеры: - ={%google} - найти контакты из рекламной системы Google; - ={%yandex} - найти контакты из рекламной системы Yandex.
Тип трафика (UTM_MEDIUM)	В данном поле указывается UTM MEDIUM из UTM-метки. Примеры: - ={%cpc} - найти контакты с типом трафика "cost per click"; - ={%organic} - найти контакты с органическим трафиком.
Обозначение рекламной кампании (UTM_CAMPAIGN)	В данном поле указывается UTM CAMPAIGN из UTM-метки. Примеры: - ={%летняя} - найти контакты из кампании "летняя распродажа".
Содержание кампании (UTM_CONTENT)	В данном поле указывается UTM CONTENT из UTM-метки.
Условие поиска кампании (UTM_TERM)	В данном поле указывается UTM TERM из UTM-метки (обычно ключевое слово).
Телефон	В данном поле указывается номер телефона для поиска контакта. Поиск осуществляется через механизм поиска дубликатов (crm.duplicate.findbycomm). Примеры: - +79001234567 - найти контакт с указанным телефоном; - {=Document:PHONE} - использовать телефон из текущего документа.
E-mail	В данном поле указывается email для поиска контакта. Поиск осуществляется через механизм поиска дубликатов (crm.duplicate.findbycomm). Примеры: - test@example.com - найти контакт с указанным email; - {=Document:EMAIL} - использовать email из текущего документа.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания (Время ожидания ответа от приложения)	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Поиск контакта по телефону +79001234567	Параметры: Телефон - +79001234567. Активити (робот) найдёт контакт с указанным номером телефона через механизм поиска дубликатов. Результат будет возвращён в параметре search_results_array.
Поиск контакта по email из текущей сделки	Параметры: E-mail - {=Document:EMAIL}. Активити (робот) найдёт контакт с email из текущего документа.
Поиск контактов с фамилией, содержащей "Иванов"	Параметры: Фамилия - ={%Иванов}. Активити (робот) найдёт все контакты, фамилия которых содержит "Иванов" (Иванов, Иванова, Ивановский и т.д.).
Поиск контактов из Москвы с должностью директор	Параметры: Город - ={Москва}, Должность - ={%директор}. Активити (робот) найдёт все контакты из Москвы, должность которых содержит слово "директор".
Поиск контактов, созданных за последний месяц	Параметры: Дата создания - ={=>{=dateadd({=System:Now}, "-1m")}}. Активити (робот) найдёт все контакты, созданные за последний месяц.
Поиск контактов из рекламной кампании Google	Параметры: Рекламная система (UTM_SOURCE) - ={%google}. Активити (робот) найдёт все контакты, пришедшие из рекламной системы Google.
Поиск контактов по точному ФИО: Иванов Иван Иванович	Параметры: Фамилия - ={Иванов}, Имя - ={Иван}, Отчество - ={Иванович}. Активити (робот) найдёт контакт с точным совпадением ФИО.
Поиск контактов, кроме тестовых	Параметры: Имя - ={!%тест}, Описание - ={!%тест}. Активити (робот) найдёт все контакты, имя и описание которых не содержат слово "тест".
Поиск контактов по внешнему идентификатору из 1С	Параметры: Идентификатор элемента внешнего источника - ={1C_12345}. Активити (робот) найдёт контакт с указанным внешним идентификатором для синхронизации с 1С.
Поиск контактов, изменённых в определённый период	Параметры: Дата изменения - ={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}}. Активити (робот) найдёт все контакты, изменённые в январе 2025 года.

Лиды

Поиск Лида (v.2)

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

• Поиск лидов по ФИО, названию компании, должности и другим полям;
• Поиск лидов по телефону или email с использованием механизма поиска дубликатов;
• Фильтрация лидов для создания отчётов и аналитики;
• Поиск дубликатов лидов для очистки базы данных;
• Поиск лидов по источникам для анализа эффективности каналов привлечения;
• Поиск лидов по статусам для автоматизации воронки продаж;
• Массовые операции над группой лидов (изменение статуса, назначение ответственного);
• Поиск лидов по дате создания для контроля актуальности;
• Поиск лидов по пользовательским полям для сложной фильтрации;
• Интеграция с внешними системами через поиск по внешним идентификаторам.

Название поля	Описание и примеры использования
ID	В данном поле указывается числовой идентификатор искомого лида. Примеры: - ={123} - найти лид с ID равным 123; - {=Document:ID} - использовать ID из текущего документа; - ={!123} - найти все лиды, кроме лида с ID 123.
Название лида	В данном поле указывается название искомого лида. Поддерживает поиск по частичному совпадению. Примеры: - ={%заявка} - найти лиды, название которых содержит "заявка"; - ={Заявка с сайта} - найти лид с точным названием; - ={!%тест} - найти лиды, название которых не содержит "тест".
Обращение	В данном поле указывается обращение, которое содержится в искомом лиде. Примеры: - ={Господин} - найти лиды с обращением "Господин".
Имя	В данном поле указывается имя, указанное в искомом лиде. Поддерживает поиск по частичному совпадению. Примеры: - ={%Иван} - найти лиды с именем, содержащим "Иван"; - ={Иван} - найти лиды с точным именем "Иван".
Отчество	В данном поле указывается отчество, указанное в искомом лиде. Примеры: - ={%Иванович} - найти лиды с отчеством, содержащим "Иванович".
Фамилия	В данном поле указывается фамилия, указанная в искомом лиде. Примеры: - ={%Петров} - найти лиды с фамилией, содержащей "Петров"; - {=Document:LAST_NAME} - использовать фамилию из текущего документа.
Название компании	В данном поле указывается название компании, которое указано в поле лида "Название компании". Примеры: - ={%ООО} - найти лиды с названием компании, содержащим "ООО"; - ={ООО Рога и копыта} - найти лид с точным названием компании.
Источник	В данном поле можно выбрать источники искомого лида. Выбрать можно несколько штук, зажав Ctrl и кликая по нужным источникам. Примеры: - WEB - найти лиды из источника "Веб-сайт"; - CALL - найти лиды из источника "Звонок".
Дополнительно об источнике	В данном поле указываются дополнительные сведения об источнике лида. Примеры: - ={%реклама} - найти лиды с дополнительной информацией об источнике, содержащей "реклама".
Статус	В данном поле можно выбрать несколько статусов для искомого лида. Выбрать можно несколько штук, зажав Ctrl и кликая по нужным статусам. Примеры: - Новый - найти новые лиды; - В работе - найти лиды в работе.
Дополнительно о статусе	В данном поле указываются дополнительные сведения о статусе лида.
Состояние статуса	В данном поле указывается состояние статуса искомого лида. Примеры: - ={P} - найти лиды в работе (Process); - ={S} - найти успешно конвертированные лиды (Success); - ={F} - найти проваленные лиды (Failed).
Должность	В данном поле указывается должность, которая указана в поле лида "Должность". Примеры: - ={%директор} - найти лиды с должностью, содержащей "директор".
Адрес	В данном поле указывается значение "фактического адреса", заполненное в искомом лиде. Примеры: - ={%Москва} - найти лиды с адресом, содержащим "Москва".
Адрес (стр. 2)	В данном поле указывается значение "квартира/офис фактического адреса", заполненное в искомом лиде.
Город	В данном поле указывается город, который указан в поле лида "Город". Примеры: - ={Санкт-Петербург} - найти лиды из Санкт-Петербурга.
Телефон	В данном поле указывается телефон, который был указан в лиде в соответствующем поле. Поиск осуществляется через механизм поиска дубликатов. Примеры: - +79001234567 - найти лид с указанным телефоном; - {=Document:PHONE} - использовать телефон из текущего документа.
E-mail	В данном поле указывается email, который был указан в лиде в соответствующем поле. Поиск осуществляется через механизм поиска дубликатов. Примеры: - test@example.com - найти лид с указанным email; - {=Document:EMAIL} - использовать email из текущего документа.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания (Время ожидания ответа от приложения)	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Поиск лида по телефону +79001234567	Параметры: Телефон - +79001234567. Активити (робот) найдёт лид с указанным номером телефона через механизм поиска дубликатов.
Поиск лида по email из текущей сделки	Параметры: E-mail - {=Document:EMAIL}. Активити (робот) найдёт лид с email из текущего документа.
Поиск лидов с фамилией, содержащей "Иванов"	Параметры: Фамилия - ={%Иванов}. Активити (робот) найдёт все лиды, фамилия которых содержит "Иванов".
Поиск лидов из источника "Веб-сайт"	Параметры: Источник - WEB. Активити (робот) найдёт все лиды, пришедшие через веб-сайт.
Поиск новых лидов	Параметры: Статус - Новый. Активити (робот) найдёт все лиды в статусе "Новый".
Поиск лидов в работе	Параметры: Состояние статуса - ={P}. Активити (робот) найдёт все лиды со статусом "В работе" (Process).
Поиск лидов из компании, содержащей "ООО"	Параметры: Название компании - ={%ООО}. Активити (робот) найдёт все лиды, у которых название компании содержит "ООО".
Поиск лидов с должностью "директор"	Параметры: Должность - ={%директор}. Активити (робот) найдёт все лиды, должность которых содержит "директор".
Поиск лидов из Москвы	Параметры: Город - ={Москва}. Активити (робот) найдёт все лиды из Москвы.
Поиск проваленных лидов	Параметры: Состояние статуса - ={F}. Активити (робот) найдёт все проваленные лиды (Failed).

Создание лида с товарами

Данное активити позволяет создавать лид, к которому перекреплены товарные позиции.

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
TITLE (Название Лида):	В данном поле можно указать значение названия Лида.
HONORIFIC(обращение):	Обращение к клиенту (мистер, товарищ, госпожа и т.д.)
NAME (Имя контакта):	В данном поле можно указать значение имени Контакта.
SECOND_NAME (Фамилия контакта):	В данном поле можно указать значение фамилии Контакта.
LAST_NAME (отчество контакта):	В данном поле можно указать значение отчества Контакта.
BIRTHDATE (Дата рождения):	В данном поле можно указать значение даты рождения Контакта.
COMPANY_TITLE (Название компании):	В данном поле можно указать название компании.
SOURCE_ID (Источник Лида):	В данном поле можно указать источник Лида. Значения берутся из одноимённого справочника CRM.

SOURCE_DESCRIPTION (описание источника):    в данном пункте указывается тип источника из которого лид попал в CRM. 

Название	Описание
STATUS_ID(обозначение статуса):	В данном пункте вводится код статуса, который можно получить из специальной таблицы.
STATUS_DESCRIPTION(описание статуса):	В данном пункте указывается тип источника статуса из которого лид попал в CRM.
STATUS_SEMANTIC_ID:	На текущий момент данное поле не используется. Оно будет необходимо для сквозной аналитики от Битрикс24.
POST (должность контакта):	В данном поле можно указать должность Контакта.
ADDRESS (Фактический адрес):	В данном поле можно указать фактический адрес Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_2 (квартира\офис фактического адреса):	В данном поле можно указать адрес квартиры или офиса Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_CITY (Город фактического адреса):	В данном поле можно указать город расположения Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_POSTAL_CODE (Почтовый индекс фактического адреса):	В данном поле можно указать почтовый индекс Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_REGION (Район фактического адреса):	В данном поле можно указать район Контакта (устаревшее поле, сейчас используются реквизиты).
ASSIGNED_BY_ID (Ответственный за компанию):	В данном поле можно указать ответственного за компанию. Следует помнить, что поле должно принимать формат
ADDRESS_PROVINCE (Область фактического адреса):	В данном поле можно указать область Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_COUNTRY (Страна фактического адреса):	В данном поле можно указать страну Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_COUNTRY_CODE (Код страны фактического адреса):	В данном поле можно указать код страны Контакта (устаревшее поле, сейчас используются реквизиты).
CURRENCY_ID (Валюта расчетов):	В данном поле можно указать валюту расчётов Лида. Значения берутся из одноимённого справочника CRM.
OPPORTUNITY (Предполагаемая сумма):	В данном поле можно указать предполагаемую сумму по Лиду. Данное поле заполняется автоматически из товарного раздела и не следует его менять если у Вас заполнены в Лиде товары с ценами.
COMMENTS (Комментарий):	В данном поле можно указать комментарий компании.
ASSIGNED_BY_ID (Ответственный за компанию):	В данном поле можно указать ответственного за компанию. Следует помнить, что поле должно принимать формат - user_ID (например user_1).
ORIGINATOR_ID (Идентификатор внешней информационной базы):	Назначение поля может меняться конечным разработчиком. Это служебное поле, которое не следует трогать.
ORIGIN_ID (Внешний ключ, используется для операций обмена):	Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком. Этот идентификатор используется при обмене компаниями со внешними системами, например 1С, для того, чтобы сопоставить компанию в разных системах.
UTM_SOURCE (метка источника):	В данном поле можно указать метку источника рекламной кампании.
UTM_MEDIUM (метка типа кампании):	В данном поле можно указать метку источника рекламной кампании.
UTM_CAMPAIGN (метка названия кампании):	В данном поле можно указать метку названия рекламной кампании.
UTM_CONTENT (метка контейнера кампании):	В данном поле можно указать метку дополнительного контейнера рекламной кампании.
UTM_TERM (метка ключевого слова кампании):	В данном поле можно указать метку ключевого слова рекламной кампании.
PHONE (Телефон):	В данном поле можно добавить разные номера телефонов. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
EMAIL (адрес электронно почты):	В данном поле можно добавить разные адреса электронной почты. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
WEB (адрес сайта):	В данном поле можно добавить разные адреса сайтов компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
IM (интернет мессенджеры):	В данном поле можно добавить разные адреса интернет - мессенджеров компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.

Товары (ID##количество##ед. измерения##цена): один из самых главных пунктов данного активити. В данный пункт заполняются товарные позиции, которые будут прикреплены к лиду.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Изменение Лида

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

• Автоматическое обновление данных лида на основе информации из других систем;
• Изменение статуса лида при прохождении этапов воронки;
• Обновление контактной информации (телефоны, email);
• Изменение ответственного за лид по определённым условиям;
• Обновление суммы и валюты расчётов;
• Работа с НДС и скидками на товары в лиде;
• Синхронизация данных лида с внешними системами.

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

Название поля	Описание и примеры использования
ID лида	Обязательный параметр. ID лида, который Вы будете редактировать. Если поле имеет привязку к элементам инфоблоков (привязка к спискам), для изменения значения нужно указывать ID элемента. Примеры: - {=Document:ID} - ID текущего лида; - 123 - конкретный ID лида; - {=Variable:LEAD_ID} - ID из переменной.
Очистить почты и(или) телефоны	Удаление почт или телефонов в лиде. Варианты: почта, телефон, почта и телефон, не очищать.
Ставка НДС	Ставка налога в лиде. Работает только если настроено поле "Способ начисления НДС".
Способ начисления НДС	Как будет начисляться НДС: сверху или уже включен в стоимость.
Тип скидки	Тип скидки. Варианты: сумма или процент.
Размер скидки	Размер предоставляемой скидки.
Название Лида	Новое название лида.
Обращение	Обращение к клиенту (мистер, товарищ, госпожа и т.д.).
Имя	Новое значение имени контакта в лиде.
Фамилия	Новое значение фамилии контакта в лиде.
Отчество	Новое значение отчества контакта в лиде.
Дата рождения	Новое значение даты рождения.
Название компании	Название компании в лиде.
Источник	Источник лида. Значения берутся из справочника CRM.
Дополнительно об источнике	Тип источника, из которого лид попал в CRM.
Статус	Код статуса лида. Можно получить из специальной таблицы статусов.
Должность	Должность контакта в лиде.
Адресные поля	Адрес, город, почтовый индекс, район, область, страна (устаревшие поля, сейчас используются реквизиты).
Валюта расчетов	Валюта расчётов лида. Значения берутся из справочника CRM.
Сумма	Предполагаемая сумма по лиду. Данное поле заполняется автоматически из товарного раздела. Не меняйте его, если в лиде заполнены товары с ценами.
Комментарий	Комментарий к лиду.
Ответственный	ID ответственного. Формат: user_ID (например, user_1).
Компания	ID компании, привязанной к лиду.
Контакт	ID контакта, привязанного к лиду.
Телефон	Телефоны. Активити добавляет, не удаляет существующие.
EMAIL	Адреса email. Активити добавляет, не удаляет существующие.
Сайт	Сайты. Активити добавляет, не удаляет существующие.
Мессенджер	Адреса интернет-мессенджеров. Активити добавляет, не удаляет существующие.

Примеры использования:

№	Сценарий	ID Лида	Изменяемое поле	Значение
1	Изменить статус	{=Document:ID}	Статус	IN_PROCESS
2	Изменить ответственного	{=Variable:LEAD_ID}	Ответственный	user_25
3	Обновить название	{=Document:ID}	Название Лида	Новый лид от {=System:Date}
4	Добавить телефон	{=Document:ID}	Телефон	+79001234567
5	Изменить источник	{=Document:ID}	Источник	WEB
6	Обновить сумму	{=Document:ID}	Сумма	{=Variable:AMOUNT}
7	Очистить телефоны	{=Document:ID}	Очистить	Телефон
8	Добавить комментарий	{=Document:ID}	Комментарий	Обработано: {=System:Date}
9	Изменить валюту	{=Document:ID}	Валюта расчетов	RUB
10	Установить скидку	{=Document:ID}	Размер скидки	10

Возвращаемые параметры для данного активити:

• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Получение данных по сущности: Лид

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

• Получение всех данных лида по его ID для использования в бизнес-процессе;
• Извлечение информации о лиде для квалификации и распределения;
• Получение данных лида для формирования документов или отчётов;
• Автоматическая проверка и валидация данных лида;
• Формирование персонализированных сообщений на основе данных лида;
• Подготовка данных для конвертации лида в сделку, контакт, компанию;
• Синхронизация данных лида с внешними системами.

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

Название поля	Описание и примеры использования
ID сущности	Обязательный параметр. В данном поле указывается ID лида, данные которого необходимо получить. Примеры: - {=Document:ID} - ID текущего лида из документа; - 123 - конкретный ID лида; - {=Variable:LEAD_ID} - ID лида из переменной; - {=A1988_22222_92566_99999:search_results} - ID из результата поиска.
Для печати	Вывод данных в пригодном для печати текстовом виде. Варианты: да/нет.
Сообщение об ошибке	Варианты: да/нет. Позволяет выводить ошибки в журнал БП.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Данная опция позволяет ограничить срок ожидания ответа. Технические особенности платформы Битрикс24 иногда создают ситуацию с очередями запросов.

Примеры использования:

№	Сценарий	ID сущности	Для печати
1	Получить данные текущего лида	{=Document:ID}	Нет
2	Получить данные для отчёта	{=Variable:LEAD_ID}	Да
3	Получить данные из результата поиска	{=A1988_22222_92566_99999:search_results}	Нет
4	Получить данные в итераторе	{=Iterator:Value}	Нет
5	Получить данные конкретного лида	12345	Нет
6	Квалификация лида	{=Document:ID}	Нет
7	Подготовка к конвертации	{=Variable:LEAD_ID}	Нет
8	Формирование письма	{=Document:ID}	Нет
9	Синхронизация с CRM	{=Variable:LEAD_ID}	Нет
10	Проверка источника	{=Document:ID}	Нет

Возвращаемые параметры для данного активити:

• Сообщение об ошибке - текст ошибки при неуспешном выполнении;
• Все данные полей по сущности Лид - все стандартные и пользовательские поля лида, включая:
  - ID лида;
  - Название лида;
  - Имя, Фамилия, Отчество;
  - Телефоны, Email;
  - Статус лида;
  - Источник;
  - Ответственный;
  - Сумма и валюта;
  - Комментарии;
  - UTM-метки;
  - Товарные позиции (если есть);
  - Пользовательские поля (UF_*);
  - и другие поля.

Удаление лида

Данное активити позволяет удалить сущность лид, указав её ID.



ID лида: в данном поле нужно указать ID удаляемого лида.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

ТЕСТ

ТЕСТ 1

ТЕСТ2

Подразделения

Поиск подразделений

Данное активити позволяет найти подразделения по заданным параметрам.

ID: в данном поле нужно указать ID искомого подразделения.

Название подразделения: в этом поле указывается название искомого подразделения.

Вышестоящее подразделение: в этом поле указывается ID выше стоящего подразделения (только цифра)
Получить ID этого подразделения можно перейдя в искомое подразделение и посмотрев его ID в адресной строке, либо выбрав из списка в соответствующем меню.
К примеру, содержимое адресной строки TEST.bitrix24.ru/company/structure.php?set_filter_structure=Y&structure_UF_DEPARTMENT=1706, 1706 - это ID подразделения.

Руководитель: в этом поле указывается руководитель подразделения, путем выбора из списка сотрудников портала, либо если указать его ID.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Прочее

Получение телефонов и email из сущности

Данное активити позволяет получить телефон или почты из сущности в формате строки.

Тип сущности: в этом поле из выпадающего списка выбирается тип сущности, из которой будут получены телефоны и e-mail.

ID Сущности: в этом поле указывается ID сущности из которой будут получать телефоны и e-mail.

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

• Почта
• Рабочая почта.
• Частная почта.
• Почта для рассылок.
• Другая.

Какой тип телефона надо получить: значения нужно выбрать из выпадающего списка.
Доступно несколько вариантов:

• Телефон
• Рабочий телефон
  
• Мобильный телефон
  
• Факс телефон
• Домашний телефон
  
• Пейджер телефон
  
• Телефон для рассылок
  
• Другой

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Сценарий работы робота

Отправить PUSH уведомление

Данное активити позволяет отправить PUSH уведомление. 

Сценарий работы активити бизнес-процесса

Идентификаторы пользователей получателей push-уведомлений: в данном поле нужно указать пользователя, который получит PUSH-уведомление.
В данных пользователя должен быть указан номер мобильного телефона.

Произвольный текст: В данном поле указывается текст PUSH-уведомления.

Ссылка на изображение (аватар): в данном поле можно указать ссылку на изображение (аватар) отправителя.
Ссылка должна быть общедоступной, иначе аватар не будет добавлен.

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

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Генерация HTML(BBcode) таблицы

Данное активити генерирует HTML(BBcode) таблицу согласно указанным Вами параметрам.

Тип форматирования: в этом поле можно выбрать в каком формате таблицы будет осуществляться вывод, HTML или BBcode.

Основа заполнения: данное поле позволяет выбрать построчное (tr) или столбовое(td) заполнение строк. 

Построчное (tr): 

Столбовое (td):

Контент для таблицы: в данном поле записывается содержимое таблицы.
В каждом новом поле необходимо заполнить содержимое строки или столбца таким образом: строка1##строка2##строка3, в соответствии с основой заполнения.
Пример заполнения:
Построчное (tr): строка1##строка2##строка3
Столбовое (td): строка1##строка2##строка3
Т.е вне зависимости от выбранной основы заполнения, принцип заполнения одинаковый.
Если Вам нужно указать более трех строк/столбов (нет ограничения), то это тоже возможно, главное, чтобы последующее заполнение соответствовало тому, что вы указали изначально.
Пример:
Правильно:
Построчное (tr): строка1##строка2##строка3##строка4##строка5
                            строка1##строка2##строка3##строка4##строка5
Неправильно:
Построчное (tr):  строка1##строка2##строка3##строка4##строка5
                             строка1##строка2##строка3##строка4

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Постраничный вывод массива

Данное активити позволяет осуществить постраничный вывод массива при помощи бизнес-процесса.

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

Количество элементов на странице: в данном поле указывается какое количество элементов будет отображено на странице при выводе.

Номер страницы для вывода: в данном поле указывается какую страницу выводить.

Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Завершение по условиям

Данное активити завершается по указанным условиям.

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

Условия для завершения: в данном поле указываются условия для завершения активити.
Заполняются в следующем формате: код поля##условие (больше(>), меньше(<),равно(=)/неравно( ! ))##данные в поле.
Пример:
OPPORTUNITY##>##200
Условие означает: В поле OPPORTUNITY , сумма сделки больше 200.

Тип условия для всех параметров: в данном поле указывается один из вариантов  типа условий "и/или".
И - все поля должны совпасть (должны быть соблюдены).
Или - хотя бы одно из условий должно быть соблюдено.

Список событий: в этом поле выбирается вариант событий изменения сущности, на которые может реагировать активити.
Изменение лида/контакта/сделки/компании.


Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Парсинг текста в бизнес-процессах

Данное активити парсит (собирает данные) текст в БП согласно указанным параметрам.

Контент для парсинга: в данном пункте указывается текст, в котором БП будет искать данные согласно заданным ниже параметрам.

Параметры парсинга: в данном пункте настраивается параметр, отвечающий за поиск и выдачу  часть текста.

Для примера рассмотрим фразу: У лукоморья дуб зеленый.   
1##слово - вернет первое слово, расположенное до указанного искомого (обрабатывается вся строка, символы не возвращаются);
1##зеленый — вернёт в дополнительные параметры процесса слово дуб 

2##слово - вернет первое слово, расположенное после указанного искомого (обрабатывается вся строка, символы не возвращаются);
2##дуб — вернёт в дополнительные параметры процесса слово зелёный. 

3##символ/символы1##символ/символы2 - вернёт все символы или группы символов (включая пробел) в строке, расположенные меду указанными символом1 и символом2.
3##У##зе -  вернёт в дополнительные параметры процесса символ —  лукоморья дуб
Для команды 4 возьмем аббревиатуру счета с его номером: НФР-190188
4## - вернет все цифры в строке, без доп. символов.
Пример: Счет №21-сD1234 от 11.02.2020, вернет 21123411022020

5## - вернет ссылку из HTML-тега, который содержится в строке.
Пример: 5##Документ можно скачать перейдя по ссылке: https://test123.ru , вернет https://test123.ru. 
Учитывать регистр при парсинге: варианты да/нет.
Позволяет активировать либо деактивировать учет текстового регистра при парсинге (заглавная/строчная буква).
Пример: 
Звездное1небо5залито7звеЗдами
1. Учет регистра включен, параметр: 3##з##З 
Результат: "дное1небо5залито7зве".
2. Учет регистра выключен, параметр 3##з##З
Результат: "ве".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Сценарий работы робота

Выбор места расположения открытой линии

Данное активити позволяет изменить приоритет использования открытых линий в сущности, к которой они привязаны.

ID сущности: в этом поле указывается ID сущности.

Тип сущности: в этом поле указывается тип сущности, доступны варианты: лид, контакт, компания.

Укажите ID первой линии(не приоритетной): в этом поле указывается ID открытой линии, которая является менее приоритетной.

Укажите ID последней линии(приоритетной): в этом поле указывается приоритетная открытая линия (используется в активити для отправки сообщений через эту линию).

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Возвращаемые параметры данного активити:
- Соответствует условиям.
- Идентификатор пользователей ВКонтакте.
- Сообщение об ошибке.

Объединение массивов

Данное активити позволяет осуществить объединение массивов при помощи бизнес-процесса.

Тип операции: позволяет выбрать один из предложенных вариантов операции объединения "Сформировать результат из повторяющихся значений" или "Сформировать результат из уникальных значений".

• "Сформировать результат из повторяющихся значений"

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

• "Сформировать результат из уникальных значений"

-  результатом работы активити является получение массива для итератора, которое позволяет из нескольких массивов получить уникальные значения каждого из массивов.

Массив для итератора 1-10: Количество полей в каждом пункте этого типа можно увеличивать. Каждый пункт является массивом для итератора. Данный массив может бы получен разными путями: из параметров БП или являться результатом работы активити (возвращаемый параметр).

Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Разделение элементов массива

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

Массив который нужно разделить: множество, которое нужно добавить в данный пункт.
Под множеством понимается несколько однотипных элементов. 
Пример: 

Сообщение об ошибке: да/нет.
Позволяет выводить ошибки в журнал БП.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Получение значения элемента массива по ключу

Данное активити позволяет получить значение элемента массива по указанному вами ключу данного массива.

Массив для обработки: в данном поле указывается массив, значение из которого нужно получить.

Ключ массива: в данном поле указывается ключ, по которому нужно получить значение.
Данный ключ можно получить из самого массива, т.е ключ, это порядковый номер элемента в массиве(считается от 0, и если знак препинания отделен от слова, то считается за элемент).
Пример: 
Передается массив: Звездное небо, но холодная ночь.
Ключ: 3 
Получаемое значение по ключу: холодная.
Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получение id элемента массива по ключу

Данное активити позволяет получить id элемента массива по ключу (порядковому номеру) при помощи БП.

Сценарий работы активити бизнес-процесса

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

Пример: Задан массив элементов 100,57,62,83,145,217 и нам нужно получить ID элемента 83.
Согласно логике отсчета 1=100,2=57, 3=62, 4=83, 5=145, 6=217.
Соответственно указываем 4.

Массив элементов: в данном поле через запятую указывается массив элементов.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Удаление ожидающего события

Данное активити позволяет удалять/завершать ожидающие в очереди или повторяющиеся события (ожидание задачи или статус счета).
Это активити работает со следующими активити:

• Слежение за статусом задаче.
  
• Слежение за изменением в задаче.
  
• Слежение за статусом счета.

Тип сущности: в данном поле указывается тип сущности в которой находится событие (счет/задача)

ID сущности: в этом поле нужно указать ID сущности.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Преобразование из строки в массив и обратно

Данное активити может преобразовать данные (текст) из строки в массив и обратно.

Сценарий работы бизнес-процесса

Выберите операцию: в данном поле из выпадающего списка выбирается тип операции, которую будет выполнять активити:

• Из строки в массив.
• Из массива в строку.

Укажите массив:
ТОЛЬКО! Если выбрана операция из "из массива в строку" - в данном поле указывается массив для итератора, который нужно преобразовать.

ВАЖНО!
Максимальное количество элементов массива, доступных к преобразованию - 50

Укажите строку:
ТОЛЬКО! Если выбрана операция из "из строки в массив" - в данном поле указывается текст для преобразования.

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

• Строка: 1,2,3,4,5

Получиться массив
1
2
3
4
5
Разделителем будет в данном случае "," запятая.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Массив в виде строки.
- Массив в виде строки (массив для итератора).
- Результат: элемент массива 1-50.
- Сообщение об ошибке.

Удаление html тегов из тела письма

Данное активити позволяет удалить html теги из тела письма.

Сценарий работы бизнес-процесса

Тело письма: в поле добавляется текст, который нужно очистить от HTML - тегов.

Какие символы(слова) удалить: позволяет удалить символы, слова или текст, который был указан в поле (поле множественное).

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Возвращаемые параметры данного активити:
- Тело письма - результат.
- Сообщение об ошибке.

Поиск в массиве по фильтру

Данное активити ищет в массиве элементы которые отвечают условиям выбранного Вами фильтра.

Массив который нужно разделить: в это поле вставляется массив.
Пример: Вчера в магазине я купил:,картошка-250р,печения-55р,молотый кофе-600р
Запятая является делителем массива.

Условия: данном поле указывается условия для поиска: больше, меньше, больше чем, меньше чем и т.п
Пример заполнения:

• %картошка-250р
• %печения-55р
  
• %молотый кофе-600р
  

Формат выводов результатов (число):Варианты да/нет.
Позволяет выделить цифры из строки, если выбрано да.
Пример: Вчера в магазине я купил:,картошка-250р,печения-55р,молотый кофе-600р

• нет == картошка-250р,печения-55р,молотый кофе-600р
•  да == 250,55,600

Это поле необходимо использовать тогда, когда вам нужно выделить из текста определенный формат данных для дальнейшего использования.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Реквизиты

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

Данное активити позволяет изменить главный (родительский) реквизит.

ВАЖНО!
УНП (Беларусь) фактически хранится в поле ИНН (Россия) сейчас столкнулись с проблемой получения данных из реквизита.

Название:	Описание:
ID реквизита:	в данном поле указывается ID изменяемого реквизита.
Название:	в данном поле указывается название изменяемого реквизита.
Идентификатор внешней информационной базы:	в данном поле указывается идентификатор внешней информационной базы, например: 1С
Активен:	из выпадающего списка можно выбрать активен реквизит или нет.
Сортировка:	в данном поле указывается индекс сортировки.
Ф.И.О.:	в данном поле указывается фамилия, имя и отчество владельца реквизита.
Имя:	в данном поле указывается имя владельца реквизита
Фамилия:	в данном поле указывается фамилия владельца реквизита.
Отчество:	в данном поле указывается отчество владельца реквизита.
Сокращенное наименование организации:	в данном поле указывается сокращенное наименование организации, указанное в ее документах.
Полное наименование организации:	в данном поле указывается полное наименование организации, указанное в ее документах.
Ген. директор:	в данном поле указывается Ф.И.О ген. директора.
Гл. бухгалтер:	в данном поле указывается Ф.И.О главного бухгалтера.
ФИО первого руководителя:	в данном поле указывается Ф.И.О первого руководителя.
Должность первого руководителя:	в данном поле указывается должность первого руководителя...
Контактное лицо:	в данном поле указывается контактное лицо.
E-Mail:	в данном поле указывается e-mail.
Телефон:	в данном поле указывается телефон.
Факс:	в данном поле указывается факс.
Вид документа:	в данном поле указывается вид документа привязанный к реквизиту, например паспорт.
Серия:	в данном поле указывается серия документа.
Номер:	в данном поле указывается номер документа.
RQ_IDENT_DOC_PERS_NUM:	в данном поле указываются данные иностранных документов.
Дата выдачи:	в данном поле указывается дата выдачи документа.
Кем выдан:	в данном поле указывается кем был выдан данный документ.
Код подразделения:	в данном поле указывается код подразделения, которое выдавало документ.
ИНН:	в данном поле указывается ИНН организации.
КПП:	в данном поле указывается КПП организации.
Handelsregisternummer (для страны DE).:	в данном поле указывается но номер национального реестра юр лиц Германии.
ИФНС:	в данном поле указывается ИФНС организации.
ОГРН:	в данном поле указывается ОРГН организации.
ОГРНИП:	в данном поле указывается ОРГНИП организации.
ОКПО:	в данном поле указывается ОКПО организации.
ОКТМО:	в данном поле указывается ОКТМО организации.
ОКВЭД:	в данном поле указывается ОКВЭД организации.
ЄДРПОУ:	в данном поле указывается ЄДРПОУ организации.
ДРФО:	в данном поле указывается ДРФО организации.
УНП:	в данном поле указывается УНП организации (Беларусь)
КБЕ:	в данном поле указывается информация о получателе денежных средств (бенефициаре Казахстан)
ИИН:	в данном поле указывается ИИН предпринимателя организации (Казахстан).
БИН:	в данном поле уникальный номер, формируемый для юридического лица (филиала и представительства Казахстане)
Серия св. о гос. регистрации:	в данном поле указывается серия свидетельства о гос. регистрации.
Номер св. о гос. регистрации:	в данном поле указывается номер свидетельства о гос. регистрации.
Дата св. о гос. регистрации:	в данном поле указывается дата выдачи свидетельства о гос. регистрации.
Платник ПДВ (для страны UA):	в данном поле указывается регистрационный номер плательщика ПДВ в Украине.
VAT ID (идентификационный номер (плательщика) НДС):	в данном поле указывается идентификационный номер (плательщика) НДС. Т.е номер, под которым налогоплательщик зарегистрирован в бюро учета НДС. Может практически совпадать с номером ИНН.
Серия свидетельства по НДС:	в данном поле указывается серия свидетельства по НДС.
Номер свидетельства по НДС:	в данном поле указывается номер свидетельства по НДС.
Дата свидетельства по НДС:	в данном поле указывается дата выдачи свидетельства по НДС.
Страна резидента:	в данном поле указывается страна резидента.
RQ_BASE_DOC:	в данном поле указываются данные иностранных документов.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: 

в д

анном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

  

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

Данное активити позволяет добавить главный (родительский) реквизит.

ВАЖНО!
УНП (Беларусь) фактически хранится в поле ИНН (Россия) сейчас столкнулись с проблемой получения данных из реквизита.

Название:	Описание:
ID типа сущности:	В данном поле указывается тип сущности к которой будет привязан реквизит.
ID сущности:	В данном поле указывается ID сущности, к которой привязывается создаваемый реквизит.
ID пресета:	В данном поле указывается тип пресета реквизита, к которому относится данный (создаваемый) реквизит.
Название:	В данном поле указывается название изменяемого реквизита.
Код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24.
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.
Идентификатор внешней информационной базы:	в данном поле указывается идентификатор внешней информационной базы, например: 1С
Активен:	Из выпадающего списка можно выбрать активен реквизит или нет.
Сортировка:	В данном поле указывается индекс сортировки.
Ф.И.О.:	В данном поле указывается фамилия, имя и отчество владельца реквизита.
Имя:	В данном поле указывается имя владельца реквизита
Фамилия:	В данном поле указывается фамилия владельца реквизита.
Отчество:	В данном поле указывается отчество владельца реквизита.
Сокращенное наименование организации:	В данном поле указывается сокращенное наименование организации, указанное в ее документах.
Полное наименование организации:	В данном поле указывается полное наименование организации, указанное в ее документах.
Ген. Директор:	В данном поле указывается Ф.И.О ген. Директора.
Гл. Бухгалтер:	В данном поле указывается Ф.И.О главного бухгалтера.
ФИО первого руководителя:	В данном поле указывается Ф.И.О первого руководителя.
Должность первого руководителя:	В данном поле указывается должность первого руководителя…
Контактное лицо:	В данном поле указывается контактное лицо.
E-Mail:	В данном поле указывается e-mail.
Телефон:	В данном поле указывается телефон.
Факс:	В данном поле указывается факс.
Вид документа:	В данном поле указывается вид документа привязанный к реквизиту, например паспорт.
Серия:	В данном поле указывается серия документа.
Номер:	В данном поле указывается номер документа.
RQ_IDENT_DOC_PERS_NUM:	В данном поле указываются данные иностранных документов.
Дата выдачи:	В данном поле указывается дата выдачи документа.
Кем выдан:	В данном поле указывается кем был выдан данный документ.
Код подразделения:	В данном поле указывается код подразделения, которое выдавало документ.
ИНН:	В данном поле указывается ИНН организации.
КПП:	В данном поле указывается КПП организации.
Handelsregisternummer (для страны DE).:	В данном поле указывается, но номер национального реестра юр лиц Германии.
ИФНС:	В данном поле указывается ИФНС организации.
ОГРН:	В данном поле указывается ОРГН организации.
ОГРНИП:	В данном поле указывается ОРГНИП организации.
ОКПО:	В данном поле указывается ОКПО организации.
ОКТМО:	В данном поле указывается ОКТМО организации.
ОКВЭД:	В данном поле указывается ОКВЭД организации.
ЄДРПОУ:	В данном поле указывается ЄДРПОУ организации.
ДРФО:	В данном поле указывается ДРФО организации.
КБЕ:	В данном поле указывается КБЕ организации.
ИИН:	В данном поле указывается ИИН организации.
БИН:	В данном поле указывается БИН организации.
Серия св. о гос. регистрации:	В данном поле указывается серия свидетельства о гос. регистрации.
Номер св. о гос. регистрации:	В данном поле указывается номер свидетельства о гос. регистрации.
Дата св. о гос. регистрации:	В данном поле указывается дата выдачи свидетельства о гос. регистрации.
Платник ПДВ (для страны UA):	В данном поле указывается регистрационный номер плательщика ПДВ в Украине.
VAT ID (идентификационный номер (плательщика) НДС):	В данном поле указывается идентификационный номер (плательщика) НДС. Т.е номер, под которым налогоплательщик         зарегистрирован в бюро учета НДС. Может практически совпадать с номером ИНН.
Серия свидетельства по НДС:	В данном поле указывается серия свидетельства по НДС.
Номер свидетельства по НДС:	В данном поле указывается номер свидетельства по НДС.
Дата свидетельства по НДС:	В данном поле указывается дата выдачи свидетельства по НДС.
Страна резидента:	В данном поле указывается страна резидента.
RQ_BASE_DOC:	В данном поле указываются данные иностранных документов.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: 

в д

анном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

  

Получение данных по сущности: реквизит

Данное активити позволяет получить все данные по сущности реквизит.

Сценарий работы активити бизнес-процесса

ID реквизита: в данном поле указывается ID реквизита.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Поиск реквизитов

Данное активити позволяет найти главный (родительский) реквизит.
Результатом работы является получение ID родительского реквизита в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Название:	Описание:
Тип сущности:	В данном поле из выпадающего списка выбирается тип сущности к которой привязан реквизит.
ID сущности:	В данном поле указывается ID сущности, к которой привязан реквизит.
Тип пресета:	В данном поле указывается тип шаблона реквизита, к которому относится данный (искомый) реквизит.
Название:	В данном поле указывается название искомого реквизита.
Код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.
Идентификатор внешней информационной базы:	В данном поле указывается идентификатор внешней информационной базы, например: 1С
Активен:	Из выпадающего списка можно выбрать активен реквизит или нет.
Сортировка:	В данном поле указывается индекс сортировки.
Ф.И.О.:	В данном поле указывается фамилия, имя и отчество владельца реквизита.
Имя:	В данном поле указывается имя владельца реквизита.
Фамилия:	В данном поле указывается фамилия владельца реквизита.
Отчество:	В данном поле указывается отчество владельца реквизита.
Сокращенное наименование организации:	В данном поле указывается сокращенное наименование организации, указанное в ее документах.
Полное наименование организации:	В данном поле указывается полное наименование организации, указанное в ее документах.
Ген. директор:	В данном поле указывается Ф.И.О ген. директора.
Гл. бухгалтер:	В данном поле указывается Ф.И.О главного бухгалтера.
ФИО первого руководителя:	В данном поле указывается Ф.И.О первого руководителя.
Должность первого руководителя:	В данном поле указывается должность первого руководителя.
Контактное лицо:	В данном поле указывается контактное лицо.
E-Mail:	В данном поле указывается e-mail.
Телефон:	В данном поле указывается телефон.
Факс:	В данном поле указывается факс.
Вид документа:	В данном поле указывается вид документа привязанный к реквизиту, например паспорт.
Серия:	В данном поле указывается серия документа.
Номер:	В данном поле указывается номер документа.
RQ_IDENT_DOC_PERS_NUM:	В данном поле указываются данные иностранных документов.
Дата выдачи:	В данном поле указывается дата выдачи документа.
Кем выдан:	В данном поле указывается кем был выдан данный документ.
Код подразделения:	В данном поле указывается код подразделения, которое выдавало документ.
ИНН:	В данном поле указывается ИНН организации.
КПП:	В данном поле указывается КПП организации.
Handelsregisternummer (для страны DE).:	В данном поле указывается, но номер национального реестра юр лиц Германии.
ИФНС:	В данном поле указывается ИФНС организации.
ОГРН:	В данном поле указывается ОРГН организации.
ОГРНИП:	В данном поле указывается ОРГНИП организации.
ОКПО:	В данном поле указывается ОКПО организации.
ОКТМО:	В данном поле указывается ОКТМО организации.
ОКВЭД:	В данном поле указывается ОКВЭД организации.
ЄДРПОУ:	В данном поле указывается ЄДРПОУ организации.
ДРФО:	В данном поле указывается ДРФО организации.
КБЕ:	В данном поле указывается КБЕ организации.
ИИН:	В данном поле указывается ИИН организации.
БИН:	В данном поле указывается БИН организации.
Серия св. о гос. регистрации:	В данном поле указывается серия свидетельства о гос. регистрации.
Номер св. о гос. регистрации:	В данном поле указывается номер свидетельства о гос. регистрации.
Дата св. о гос. регистрации:	В данном поле указывается дата выдачи свидетельства о гос. регистрации.
Платник ПДВ (для страны UA):	В данном поле указывается регистрационный номер плательщика ПДВ в Украине.
VAT ID (идентификационный номер (плательщика) НДС):	В данном поле указывается идентификационный номер (плательщика) НДС. Т.е номер, под которым налогоплательщик зарегистрирован в бюро учета НДС. Может практически совпадать с номером ИНН.
Серия свидетельства по НДС:	В данном поле указывается серия свидетельства по НДС.
Номер свидетельства по НДС:	В данном поле указывается номер свидетельства по НДС.
Дата свидетельства по НДС:	В данном поле указывается дата выдачи свидетельства по НДС.
Страна резидента:	В данном поле указывается страна резидента.
RQ_BASE_DOC:	В данном поле указываются данные иностранных документов.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Удаление реквизита

Данное активити позволяет удалить реквизит, ID которого указанно в настройках.

Сценарий работы активити бизнес-процесса

ID реквизита: в данном поле указывается ID реквизита, который нужно удалить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Реквизиты (адресные)

Удаление адресного реквизита

Данное активити позволяет выполнить удаление адресного реквизита.

Тип адреса: в данном поле из выпадающего списка можно выбрать тип адресного реквизита.Доступны варианты: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.

ID родительского реквизита: в данном поле указывается ID родительского реквизита в которому привяжется адресный реквизит.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

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

Данное активити позволяет добавить адресный реквизит. 

Тип адреса: в данном поле из выпадающего списка можно выбрать тип адресного реквизита.Доступны варианты: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.

ID родительского реквизита: в данном поле указывается ID родительского реквизита в которому привяжется адресный реквизит.
Улица, дом, корпус, строение: в данном поле указывается адрес улицы,дома/строения и корпус.

Квартира / офис:  в данном поле указывается квартира /офис.

Город: в данном поле указывается город.

Почтовый индекс: в данном поле указывается почтовый индекс.

Район: в донном поле указывается раен.

Область: в данном поле указывается область.

Страна: в данном поле указывается страна.

Код страны: в данном поле указывается код страны.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Изменение адресного реквизита

Данное активити позволяет изменить адресный реквизит, привязанный к родительскому реквизиту.

Тип адреса: в данном поле из выпадающего списка можно выбрать тип адресного реквизита.Доступны варианты: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.

ID родительского реквизита: в данном поле указывается ID родительского реквизита в которому привяжется адресный реквизит.

Улица, дом, корпус, строение: в данном поле указывается адрес улицы,дома/строения и корпус.

Квартира / офис: в данном поле указывается номер квартиры/офиса.

Город: в данном поле указывается город.

Почтовый индекс: в данном поле указывается почтовый индекс.

Район: в донном поле указывается раен.

Область: в данном поле указывается область.

Страна: в данном поле указывается страна.

Код страны: в данном поле указывается код страны.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Получение данных по адресному реквизиту

Данное активити позволяет получить все данные по адресному реквизиту.

Сценарий работы активити бизнес-процесса

Тип адреса: в данном поле из выпадающего списка можно выбрать тип адресного реквизита. Доступны варианты: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.

ID родительского реквизита: в данном поле указывается ID родительского реквизита в которому привяжется адресный реквизит.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли делать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Реквизиты (банковские)

Поиск банковских реквизитов

Данное активити позволяет найти банковский реквизит по указанным ниже параметрам.
Результатом работы будет получение ID банковских реквизитов в виде массива для итератора, строки, соответствия условиям поиска и количества найденных элементов.


Страна: в данном поле указывается ID страны, в банке которой открыт счет.

Название: в данном поле указывается название банковского реквизита.

Код: в данном поле указывается код внешней системы, например 1С.

Внешний код: в данном поле указывается внутренний код Б24.

Активен: в данном поле выбирается активен реквизит или не активен.

Наименование банка: в банном поле указывается наименование банка к которому относятся добавляемые реквизиты.

Адрес банка: в банном поле указывается адрес банка к которому относятся добавляемые реквизиты.

Bank Routing Number: в данном поле вводится номер банка США (это поле заполняется только если счет в банке США).

БИК: в данном поле указывается банковский идентификационный код.

МФО: в данном поле указывается идентификационный код банка.

Bank Account Holder Name: в данном поле указывается имя держателя/владельца банковской карты/счета.

Расчетный счёт: в данном поле указывается номер расчетного счета в банке.

ИИК: в данном поле указывается индивидуальный идентификационный код.

Валюта счёта: в данном поле указывается валюта в которой открыт банковский счет.

Кор. cчёт: в данном поле указывается номер корреспондентского счета.

IBAN: в данном поле указывается номер банковского счета клиента IBAN.

SWIFT: в данном поле указывается SWIFT-код банка.

BIC: в данном поле указывается BIC-код банка (он же БИК).

Комментарий: в данном поле указывается комментарий к счету.

Идентификатор внешней информационной базы: в данном поле указывается идентификатор внешней информационной базы, например 1С.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получение данных по банковскому реквизиту

Данное активити позволяет получить данные по банковскому реквизиту, указав его идентификатор.

Идентификатор банковского реквизита: в данном поле указывается идентификатор банковского реквизита.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
-Все данные из банковского реквизита.

Удаление банковcкого реквизита

Данное активити позволяет удалить банковский реквизит,указав его ID.

ID банковского реквизита: в данном поле указывается ID банковского реквизита, который нужно удалить.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
-Сообщение об ошибке.

Изменение банковского реквизита

Данное активити позволяет изменить банковский реквизит.

Идентификатор банковского реквизита: в данном поле указывается ID банковского реквизита,который планируется изменить.

ВАЖНО!
Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

Если вы планируете через интегратор произвести изменение более 1000 сущностей, то нужно встраивать в БП счетчик, и после 1000 изменений делать паузу на 15 минут, если этого не сделать, то это приведет к тормозам в обработке на стороне Б24 и остальные сущности могут не отработаться.

Название: в данном поле указывается название банковского реквизита.

Код: в данном поле указывается код внешней системы,например 1С.

Внешний код: в данном поле указывается внутренний код Б24.

Активен: в данном поле выбирается активен реквизит или не активен.

Сортировка: в данном поле указывается номер сортировки реквизита.

Наименование банка: в банном поле указывается наименование банка к которому относятся добавляемые реквизиты.

Адрес банка: в банном поле указывается адрес банка к которому относятся добавляемые реквизиты.

Bank Routing Number: в данном поле вводится номер банка США (это поле заполняется только если счет в банке США).

БИК: в данном поле указывается банковский идентификационный код.

МФО: в данном поле указывается идентификационный код банка.

Bank Account Holder Name: в данном поле указывается имя держателя/владельца банковской карты/счета.

Расчетный счёт: в данном поле указывается номер расчетного счета в банке.

ИИК: в данном поле указывается индивидуальный идентификационный код.

Валюта счёта: в данном поле указывается валюта в которой открыт банковский счет.

Кор. счёт: в данном поле указывается номер корреспондентского счета.

IBAN: в данном поле указывается номер банковского счета клиента IBAN.

SWIFT: в данном поле указывается SWIFT-код банка.

BIC: в данном поле указывается BIC-код данка (он же БИК).

Коментарий: в данном поле указывается коментарий к счету.

Идентификатор внешней информационной базы: в данном поле указывается идентификатор внешней информационной базы,например 1С.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
-Сообщение об ошибке.

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

Данное активити позволяет добавить банковский реквизит в сущность, указав её ID.

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

Важно понимать, что данный реквизит не является родительским. Банковский реквизит привязывается к родительскому, а родительский привязывается уже к сущности.
По такому же принципу привязывается и адресный реквизит.
Для создания родительского реквизита вы можете использовать наше активити "Добавление реквизита" из категории "Реквизиты"

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

Название: в данном поле указывается название банковского реквизита.

Код: в данном поле указывается код внешней системы,например 1С.

Внешний код: в данном поле указывается внутренний код Б24.

Активен: в данном поле выбирается активен реквизит или не активен.

Сортировка: в данном поле указывается номер сортировки реквизита.

Наименование банка: в банном поле указывается наименование банка к которому относятся добавляемые реквизиты.

Адрес банка: в банном поле указывается адрес банка к которому относятся добавляемые реквизиты.

Bank Routing Number: в данном поле вводится номер банка США (это поле заполняется только если счет в банке США).

БИК: в данном поле указывается банковский идентификационный код.

МФО: в данном поле указывается идентификационный код банка.

Bank Account Holder Name: в данном поле указывается имя держателя/владельца банковской карты/счета.

Расчетный счёт: в данном поле указывается номер расчетного счета в банке.

ИИК: в данном поле указывается индивидуальный идентификационный код.

Валюта счёта: в данном поле указывается валюта в которой открыт банковский счет.

Кор. счёт: в данном поле указывается номер корреспондентского счета.

IBAN: в данном поле указывается номер банковского счета клиента IBAN.

SWIFT: в данном поле указывается SWIFT-код банка.

BIC: в данном поле указывается BIC-код данка (он же БИК).

Коментарий: в данном поле указывается коментарий к счету.

Идентификатор внешней информационной базы: в данном поле указывается идентификатор внешней информационной базы,например 1С.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
-Идентификатор нового банковского реквизита.
-Сообщение об ошибке.

Роботизация бизнеса (RPA)

Элементы

Удаление элемента процесса

Данное активити позволяет удалить элемент RPA - бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент.

Идентификатор элемента: в этом поле нужно указать ID элемента RPA БП, который вы планируете удалить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Поиск по элементам RPA - процесса

Данное активити выполняет поиск по элементам RPA - бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором будет осуществлен поиск.

Идентификатор стадии на которой находится элемент: в этом поле нужно указать ID стадии, в которой находится искомый элемент RPA БП.

Идентификатор предыдущей стадии элемента: в этом поле указывается ID стадии, в которой элемент находился до перехода на текущую стадию.

Название элемента: в этом поле указывается название искомого элемента RPA БП.

ID пользователя, создавшего элемент: в данном поле нужно указать ID пользователя, который создал элемент.

ID пользователя, изменившего элемент: в данном поле нужно указать ID пользователя, который последним изменил элемент.

Время создания элемента: в этом поле нужно указать дату и время создания элемента.

Количество заданий на элементе для пользователя: в данном поле указывается количество заданий, которое было в элементе для пользователя.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

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

Получить данные о текущих заданиях элемента

Данное активити позволяет получить данные о текущих заданиях элемента RPA - бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент, информацию о заданиях которого нужно получить.

Идентификатор элемента: в этом поле указывается ID элемента в котором содержатся задания, данные о которых нужно получить.

ID задания: в этом поле указывается ID задания, данные которого нужно получить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID задания;
- Заголовок задания;
- Описание задания;
- Ответственный;
- Задания (массив для итератора);
- Результат выполнения;
- Сообщение об ошибке.

 

Создание нового элемента процесса

Данное активити позволяет создать новый элемент RPA - бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором будет создан новый элемент.

Название элемента: в этом поле указывается название элемента, который будет создан.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового элемента;
- Сообщение об ошибке.

 

Обновление данных элемента процесса

Данное активити обновляет данные элемента RPA - бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент, данные которого нужно обновить.

Идентификатор элемента: в этом поле указывается ID элемента который будет обновлен.

Идентификатор стадии, на которой находится элемент: в этом поле нужно указать ID стадии на которой находится обновляемый элемент RPA процесса.

Название элемента: в этом поле нужно указать название элемента.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

 

Данные по элементу процесса

Данное активити позволяет получить данные по элементу RPA - бизнес-процесса. Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент, данные которого нужно получить.

Идентификатор элемента: в этом поле указывается ID элемента данные по которому нужно получить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

 

Стадии

Создать новую стадию

Данное активити создает новую стадию процесса RPA. Название стадии: в этом поле указывается название создаваемой стадии RPA - бизнес-процесса.

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором стадия будет создана.

Символьный код: в этом поле вводится символьный код стадии на латинице.

Цвет стадии в виде НЕХ: в это полу нужно вставить цветовой код стадии в виде HEX кода.
К примеру зеленый цвет в HEX: #008000.
Таблицу с HEX-кодами цветов можно найти в интернете, либо просто перейдя по данной ссылке: ТЫЦ

Код семантики стадии: в этом поле нужно выбрать семантический код стадии, т.е то, что данная стадия означает.
Доступно 2 варианта: Success и FAIL , что в дословном переводе "Успех" и "Провал/неудача".

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Удаление стадии

Данное активити удаляет стадию RPA процесса. ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса которая будет удалена.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Информация о стадии

Данное активити отдает информацию о стадии RPA процесса.

Сценарий работы активити бизнес-процесса

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса о которой нужно получить информацию.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Название стадии;
- Символьный код;
- HEX-код цвета стадии (в виде 6 символов);
- Идентификатор процесса;
- Результат выполнения;
- Сообщение об ошибке.

Список стадий процесса

Данное активити вернет список стадий RPA - процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса список стадий которого надо получить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

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

Изменить стадию

Данное активити позволяет изменять стадии RPA - процесса.

Сценарий работы активити бизнес-процесса

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса которую надо изменить.

Название стадии: в этом поле указывается название изменяемой стадии RPA - бизнес-процесса.

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором стадия будет изменена.

Символьный код: в этом поле вводится символьный код стадии на латинице.

Цвет стадии в виде HEX: в это полу нужно вставить цветовой код стадии в виде HEX кода.
К примеру зеленый цвет в HEX: #008000.
Таблицу с HEX-кодами цветов можно найти в интернете, либо просто перейдя по данной ссылке: ТЫЦ

Код семантики стадии: в этом поле нужно выбрать семантический код стадии, т.е то, что данная стадия означает.
Доступно 2 варианта: Success и FAIL , что в дословном переводе "Успех" и "Провал/неудача".

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Записи таймлайна

Создать новую запись таймлайна у элемента

Данное активити создает новую запись таймлайна у элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

Идентификатор элемента: в данном поле нужно указать ID элемента RPA - бизнес-процесса, в таймлайне которого планируется добавлять новую запись.

ID пользователя: в этом поле указывается ID пользователя от имени которого запись будет добавлена.

Заголовок: в этом поле указывается заголовок добавляемой записи.

Описание: в этом поле указывается описание добавляемой записи.

Флаг прикрепления записи: в этом поле из выпадающего списка можно выбрать, будет ли запись прикреплена к элементу или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID новой записи таймлайна;
- Результат выполнения;
- Сообщение об ошибке.

Удалить запись таймлайна у элемента

Данное активити удаляет запись таймлайна у элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID записи таймлайна: в этом поле нужно указать ID записи таймлайна, которую нужно удалить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Массив записей таймлайна для элемента

Данное активити позволяет получить массив записей таймлайна для элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

Идентификатор элемента: в данном поле нужно указать ID элемента RPA - бизнес-процесса, в таймлайне которого планируется добавлять новую запись.

ID записи таймлайна: в этом поле указывается ID пользователя от имени которого запись будет добавлена.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID пользователя;
- Заголовок;
- Описание;
- Результат поиска (Массив для итератора);
- Результат поиска (строка);
- Последний результат поиска;
- Количество найденных элементов;
- Результат выполнения;
- Сообщение об ошибке.

Изменить запись таймлайна у элемента

Данное активити изменяет запись таймлайна у элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID записи таймлайна: в этом поле указывается ID записи таймлайна в элементе RPA - бизнес-процесса.

ID пользователя: в этом поле указывается ID пользователя от имени которого запись будет изменена.

Заголовок: в этом поле указывается заголовок изменяемой записи.

Описание: в этом поле указывается описание изменяемой записи.

Флаг прикрепления записи: в этом поле из выпадающего списка можно выбрать, будет ли запись прикреплена к элементу или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Открепить/прикрепить запись

Данное активити позволяет прикрепить/открепить запись таймлайна для элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID записи таймлайна: в этом поле указывается ID записи таймлайна, которую нужно открепить или прикрепить.

Флаг прикрепления записи: в этом поле из выпадающего списка можно выбрать, будет ли запись прикреплена к элементу или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Задания

Удалить задание с процесса

Данное активити позволяет удалить задание для робота из процесса RPA

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса.

Имя робота: в этом поле указывается имя робота.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Добавить пользователя к существующему заданию

Данное активити позволяет добавить пользователя к существующему заданию процесса RPA

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса.

Имя робота: в этом поле указывается имя робота.

Cтрока с пользователем формата "Имя Фамилия [ид пользователя]": в этом поле указывается ID пользователя, которого нужно добавить в задание.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Коментарии

Добавить комментарий в таймлайне элементов

Данное активити позволяет добавить комментарий в таймлайне элементов процесса RPA.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

Идентификатор элемента: в этом поле указывается ID элемента RPA - бизнес-процесса.

Описание: в этом поле вводится комментарий.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID комментария;
- Сообщение об ошибке.

Изменить комментарий

Данное активити позволяет изменить комментарий в таймлайне элементов процесса RPA.

Сценарий работы активити бизнес-процесса

ID комментария: в этом поле указывается ID комментария в списке RPA - бизнес-процесса.

Описание: в этом поле вводится комментарий.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Удалить комментарий

Данное активити позволяет удалить комментарий в таймлайне элементов процесса RPA

Сценарий работы активити бизнес-процесса

ID комментария: в этом поле указывается ID комментария элемента RPA - бизнес-процесса.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Сделки

Поиск Сделки (v.2)

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

• Поиск сделок по определённым критериям для массовых операций (изменение стадии, назначение ответственного, обновление полей);
• Фильтрация сделок для создания отчётов и аналитики;
• Автоматический поиск связанных сделок при работе с другими сущностями CRM;
• Поиск дубликатов сделок для очистки базы данных;
• Поиск сделок по датам для автоматизации напоминаний и контроля сроков;
• Фильтрация сделок по ответственным для распределения нагрузки или отчётов;
• Поиск сделок по рекламным кампаниям для анализа эффективности маркетинга;
• Поиск сделок в определённых стадиях для автоматизации бизнес-процессов;
• Поиск сделок по сумме для финансовой аналитики;
• Поиск сделок в определённых направлениях (воронках).

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей сделки из CRM вашего портала через REST API (crm.deal.fields);
- Для каждого поля создаётся параметр поиска, который можно заполнить для фильтрации;
- Рядом с каждым полем создаётся дополнительное поле "Условие поиска" для выбора оператора сравнения;
- Можно комбинировать несколько полей для более точного поиска;
- Поиск выполняется по принципу "И" (AND) - все указанные условия должны выполняться одновременно;
- Поддерживается выбор стадий из всех направлений сделок;
- Поддерживается обработка больших объёмов данных (более 50 сделок);
- Результаты возвращаются в виде массива ID сделок, строки с ID через запятую, первого и последнего ID, количества найденных сделок.

Сценарий работы активити (робота) бизнес-процесса

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

Основные параметры поиска:
Активити (робот) автоматически создаёт параметры для всех полей сделки. Ниже описаны основные и наиболее часто используемые поля. Обратите внимание, что названия полей могут отличаться в зависимости от настроек вашего портала.

Название поля	Описание и примеры использования
ID	В данном поле указывается числовой идентификатор искомой сделки. Примеры: - ={123} - найти сделку с ID равным 123; - {=Document:ID} - найти сделку с ID из текущего документа; - ={!123} - найти все сделки, кроме сделки с ID 123.
Заголовок (TITLE)	Позволяет указать заголовок искомой сделки. Поддерживает поиск по частичному совпадению. Примеры: - ={%договор} - найти все сделки, в заголовке которых содержится слово "договор"; - ={Договор поставки №123} - найти сделку с точным заголовком; - ={!%архив} - найти все сделки, в заголовке которых нет слова "архив".
Тип (TYPE_ID)	В данном поле указывается тип сделки из настроек CRM. Типы сделок настраиваются администратором портала. Примеры: - ={SALE} - найти сделки типа "Продажа"; - ={COMPLEX} - найти сделки типа "Комплексная сделка". Как узнать символьный код типа сделки: - Перейдите в CRM - Настройки - Типы сделок; - Или используйте активити (робот) для получения типов сделок.
Стадии сделки (STAGE_ID)	В данных полях выбираются стадии для искомой сделки. Название этого поля может быть иным, т.к. оно привязывается к названию стадий сделок на вашем портале. Важно: - Можно выбрать несколько стадий, зажав Ctrl и кликнув по нужным стадиям; - Таких полей может быть столько, сколько основных стадий сделок вы создали; - Каждое поле соответствует одной основной стадии. Примеры: - Выберите стадию "Квалификация" - будут найдены все сделки на этой стадии; - Выберите несколько стадий - найдутся сделки на любой из выбранных стадий.
Группа стадии (STAGE_SEMANTIC_ID)	В данном поле указывается группа стадии сделки с помощью символьного кода. Основные группы стадий: - P - "Сделка в работе" (Process); - S - "Сделка заключена" (Success); - F - "Сделка провалена" (Failed). Примеры: - ={P} - найти все сделки в работе; - ={S} - найти все успешно закрытые сделки; - ={F} - найти все проваленные сделки.
Вероятность (PROBABILITY)	В данном поле указывается уровень вероятности успешной сделки (в процентах от 0 до 100). Примеры: - ={50} - найти сделки с вероятностью 50%; - ={>=75} - найти сделки с вероятностью 75% и выше; - ={{20}}##{{60}} - найти сделки с вероятностью от 20% до 60%.
Сумма (OPPORTUNITY)	В данном поле указывается сумма искомой сделки. Примеры: - ={100000} - найти сделки с суммой 100 000; - ={>500000} - найти сделки с суммой больше 500 000; - ={{100000}}##{{500000}} - найти сделки с суммой от 100 000 до 500 000; - ={<=10000} - найти сделки с суммой не более 10 000.
Ставка налога (TAX_VALUE)	В данном поле указывается ставка налога для искомой сделки (в процентах). Примеры: - ={20} - найти сделки со ставкой налога 20%; - ={0} - найти сделки без налога (ставка 0%); - ={!0} - найти все сделки с ненулевой ставкой налога.
Комментарий (COMMENTS)	В данном поле указывается текст комментария для искомой сделки. Поддерживает поиск по частичному совпадению. Примеры: - ={%срочно} - найти сделки, в комментариях которых содержится слово "срочно"; - ={!%архив} - найти сделки, в комментариях которых нет слова "архив".
Дата создания (DATE_CREATE)	В данном поле указывается дата создания искомой сделки. Поддерживает поиск по точной дате и диапазонам дат. Примеры: - ={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}} - найти сделки, созданные в январе 2025 года; - ={=>{=dateadd({=System:Now}, "-30d")}} - найти сделки, созданные за последние 30 дней.
Дата изменения (DATE_MODIFY)	В данном поле указывается дата изменения искомой сделки. Примеры: - ={{01.03.2025 00:00:00}}##{{31.03.2025 23:59:59}} - найти сделки, изменённые в марте 2025 года; - ={=>{=dateadd({=System:Now}, "-7d")}} - найти сделки, изменённые за последнюю неделю.
Ответственный (ASSIGNED_BY_ID)	В данном поле указывается ответственный за сделку. Можно указать ID пользователя или использовать переменные. Примеры: - ={25} - найти сделки пользователя с ID 25; - {=Document:ASSIGNED_BY_ID} - найти сделки текущего ответственного из документа; - {=User:ID} - найти сделки текущего пользователя.
Дата начала (BEGINDATE)	В данном поле указывается дата начала искомой сделки. Примеры: - ={{01.01.2025 00:00:00}}##{{31.12.2025 23:59:59}} - найти сделки с датой начала в 2025 году; - ={=>{=System:Now}} - найти сделки, которые начинаются после текущего момента.
Внешний источник (SOURCE_ID)	В данном поле указывается внешний источник в искомой сделке (символьный код источника). Примеры: - ={WEB} - найти сделки из источника "Веб-сайт"; - ={CALL} - найти сделки из источника "Звонок".
Рекламная система (UTM_SOURCE)	В данном поле указывается рекламная система в искомой сделке (из UTM-меток). Примеры: - ={%google} - найти сделки из рекламной системы Google; - ={%yandex} - найти сделки из рекламной системы Yandex.
Тип трафика (UTM_MEDIUM)	В данном поле указывается тип трафика в искомой сделке (из UTM-меток). Примеры: - ={%cpc} - найти сделки с типом трафика "cost per click"; - ={%organic} - найти сделки с органическим трафиком.
Обозначение рекламной кампании (UTM_CAMPAIGN)	В данном поле указываются обозначения рекламной кампании в искомой сделке (из UTM-меток). Примеры: - ={%летняя} - найти сделки из кампании "летняя распродажа".
Направление (CATEGORY_ID)	В данном поле указывается идентификатор направления сделки. Если не указано, то сделка принадлежит к общему направлению. Примеры: - ={0} - найти сделки в общем направлении; - ={5} - найти сделки в направлении с ID 5; - ={!0} - найти все сделки, которые не в общем направлении.
Новая сделка (IS_NEW)	В данном поле указывается флаг новой сделки (сделки в первой стадии). Примеры: - ={Y} - найти новые сделки; - ={N} - найти не новые сделки.
Шаблон регулярной сделки (IS_RECURRING)	В данном поле указывается флаг шаблона регулярной сделки. Примеры: - ={Y} - найти шаблоны регулярных сделок; - ={N} - найти обычные сделки (исключить шаблоны).
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания (Время ожидания ответа от приложения)	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота).

Операторы сравнения для поиска

Данные символы ставятся перед содержимым ячейки:
- ={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".
- ={!%ваше значение} - не содержит.
Пример заполнения: ={!%123}, это значит, что значение в выбранном поле не содержит 123.
- ={ваше значение} - равно.
Пример заполнения: ={123}, это значит, что значение в выбранном поле равно 123. Если в поле используется текст, то этот текст должен совпадать символ в символ.
- ={!ваше значение} - не равно.
Пример заполнения: ={!123}, это значит, что значение в выбранном поле не равно 123.
- ={>ваше значение} - больше.
Пример заполнения: ={>123}, это значит, что значение в выбранном поле больше 123 (только для поля тип "число").
- ={<ваше значение} - меньше.
- ={=>} - больше или равно.
- ={=<} - меньше или равно.

Для полей типа "дата" и "дата/время":
- Содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}
- В случае с переменной: ={=>{=Variable:search_date}}
- При необходимости поиска диапазона "от и до": ={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

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

Описание примера	Решение
Поиск всех сделок в работе	Параметры: Группа стадии (STAGE_SEMANTIC_ID) - ={P}. Активити (робот) найдёт все сделки со статусом "В работе".
Поиск сделок текущего ответственного с суммой больше 100 000	Параметры: Ответственный - {=Document:ASSIGNED_BY_ID}, Сумма - ={>100000}. Активити (робот) найдёт все сделки ответственного с суммой больше 100 000.
Поиск сделок, созданных за последний месяц	Параметры: Дата создания - ={=>{=dateadd({=System:Now}, "-1m")}}. Активити (робот) найдёт все сделки, созданные за последний месяц.
Поиск сделок с заголовком, содержащим "договор"	Параметры: Заголовок - ={%договор}. Активити (робот) найдёт все сделки, в заголовке которых есть слово "договор".
Поиск успешно закрытых сделок из рекламы Google	Параметры: Группа стадии - ={S}, Рекламная система - ={%google}. Активити (робот) найдёт все успешные сделки из Google.
Поиск сделок в определённом направлении	Параметры: Направление - ={5}. Активити (робот) найдёт все сделки в направлении с ID 5.
Поиск сделок с суммой от 50 000 до 200 000	Параметры: Сумма - ={{50000}}##{{200000}}. Активити (робот) найдёт все сделки с суммой в указанном диапазоне.
Поиск сделок, кроме шаблонов регулярных сделок	Параметры: Шаблон регулярной сделки - ={N}. Активити (робот) найдёт только обычные сделки, исключая шаблоны.
Поиск новых сделок текущего пользователя	Параметры: Новая сделка - ={Y}, Ответственный - {=User:ID}. Активити (робот) найдёт все новые сделки текущего пользователя.
Поиск проваленных сделок за последний квартал	Параметры: Группа стадии - ={F}, Дата изменения - ={{01.01.2025 00:00:00}}##{{31.03.2025 23:59:59}}. Активити (робот) найдёт все проваленные сделки в первом квартале 2025 года.

Сценарий работы робота

Возвращаемые параметры данного активити (робота):
- Результат поиска (массив для итератора) (search_results_array) - массив чисел с ID найденных сделок. Используется для итерации по результатам в бизнес-процессе.
- Результат поиска (строка) (search_results_string) - строка со всеми результатами поиска, разделёнными запятыми. Удобно для передачи в другие активити (роботы).
- Первый результат поиска (search_result_first_string) - строка с первым результатом поиска. Полезно, когда нужно получить только первую найденную сделку.
- Последний результат поиска (search_result_last_string) - строка с последним результатом поиска.
- Количество найденных элементов (count_search) - числовое значение, указывающее количество найденных сделок.
- Соответствует условиям (math_search_results) - строка, указывающая результат поиска. Возможные значения: Y (найдены сделки) или N (сделки не найдены).
- Логи ошибок (s_error_logs) - строка с описанием ошибки или сообщением об успешном выполнении.

Важно о возвращаемых параметрах: Если сделки не найдены, параметр math_search_results будет равен N, а count_search будет равен 0. Всегда проверяйте значение параметра math_search_results перед использованием результатов в дальнейших шагах бизнес-процесса.

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

Динамическая поддержка полей:
Активити (робот) динамически поддерживает все поля сделки, доступные в вашем портале Битрикс24, включая пользовательские поля. Это означает, что вы можете искать по любым критериям.

Стадии сделок:
Для поиска по стадиям используются специальные поля, которые формируются на основе настроек вашего портала. Названия полей соответствуют названиям направлений сделок.

Комбинирование условий:
При указании нескольких полей для поиска, все условия объединяются по принципу "И" (AND). Будут найдены только те сделки, которые соответствуют всем указанным условиям.

Обработка больших объёмов данных:
Активити (робот) автоматически обрабатывает случаи, когда результатов больше 50 сделок. Все сделки будут корректно обработаны и возвращены в результатах.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр сделок в CRM. Рекомендуется использовать пользователя с правами администратора системы.

Использование в итераторе:
Для обработки большого количества сделок рекомендуется использовать итератор с параметром search_results_array. Это позволит обработать все сделки последовательно.

Изменение Сделки

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

• Автоматическое обновление полей сделки на основе данных из других систем или документов;
• Массовое изменение сделок (стадия, ответственный, сумма, вероятность) по определённым условиям;
• Автоматизация перехода сделок между стадиями в зависимости от событий;
• Обновление данных сделки после выполнения определённых действий (подписание договора, оплата и т.д.);
• Синхронизация данных сделки с внешними системами;
• Автоматическое назначение ответственного в зависимости от суммы, типа или других параметров;
• Расчёт и применение НДС и скидок к товарам сделки;
• Прикрепление файлов к сделке из других сущностей CRM.

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

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



Основные параметры:

Название поля

Описание и примеры использования

ID Сделки (o_deal_id)

Обязательное поле. В данном поле необходимо указать числовой идентификатор (ID) сделки, которую необходимо изменить. Примеры: - 123 - изменить сделку с ID 123; - {=Document:ID} - изменить текущую сделку из документа; - {=A1988_22222_92566_99999:search_results} - изменить сделку из результата предыдущего активити; - {=Iterator:Value} - изменить сделку для каждого элемента в итераторе. Важно: Если ID сделки указан в формате [123] (в квадратных скобках), активити автоматически извлечёт числовое значение.

Параметры для работы с полями сделки:

Название поля	Описание и примеры использования
Название (TITLE)	В данном поле можно указать новое значение названия сделки. Примеры: - Договор поставки №123; - ={Договор {={=Document:ID}}}; - Для очистки поля передайте пробел: ={ }
Тип (TYPE_ID)	В данном поле можно изменить тип сделки. Значения берутся из справочника CRM. Примеры: - SALE - тип "Продажа"; - COMPLEX - тип "Комплексная сделка". Символьный код типа можно найти в CRM - Настройки - Типы сделок или использовать специальное активити.
Стадия сделки (STAGE_ID)	В данном поле можно изменить стадию сделки. Примеры: - NEW - стадия "Новая"; - QUALIFICATION - стадия "Квалификация". Как узнать символьный код стадии: 1. Добавьте штатное активити "Изменение документа"; 2. Выберите поле "стадия"; 3. Нажмите F12 и выберите инструмент "выбор элемента страницы"; 4. Найдите нужную стадию в списке. ВАЖНО! НЕЛЬЗЯ изменить одновременно направление и стадию сделки. Делайте это поочерёдно в отдельных активити.
Направление (CATEGORY_ID)	ВАЖНО! Активити (робот) не может изменить направление сделки, т.к механизм REST API Б24 не позволяет это делать напрямую. Используйте штатное активити "Смена направления сделки" или "Изменение документа".
Вероятность (PROBABILITY)	В данном поле можно изменить вероятность заключения сделки (от 0 до 100). Примеры: - ={50} - установить вероятность 50%; - ={{=min({=Variable:PROBABILITY} + 50, 100)}} - увеличить вероятность на 50; - ={0} - сбросить вероятность.
Сумма (OPPORTUNITY)	В данном поле можно изменить предполагаемую сумму. Поле заполняется автоматически из товарного раздела. Примеры: - ={100000} - установить сумму 100 000; - ={{={=Variable:OPPORTUNITY} * 1.1}} - увеличить сумму на 10%; - Для очистки: ={"##"} Важно: Изменение суммы вручную может конфликтовать с автоматическим расчётом из товаров.
Валюта (CURRENCY_ID)	В данном поле можно изменить валюту расчётов. Примеры: - RUB - рубли; - USD - доллары США; - EUR - евро.
Ставка налога (TAX_VALUE)	В данном поле указывается ставка налога (в процентах). Примеры: - ={20} - установить ставку НДС 20%; - ={0} - установить ставку 0%. Важно: Работает только если настроено поле "Способ начисления НДС" (i_active_nds).
Компания (COMPANY_ID)	В данном поле можно изменить привязанную компанию. Примеры: - ={123} - привязать компанию с ID 123; - {=Document:COMPANY_ID} - из текущего документа; - Для отвязки передайте 0.
Контакты (CONTACT_IDS)	В данном поле можно изменить привязанные контакты. Можно указать несколько ID через запятую. Примеры: - ={456,789,101112} - привязать несколько контактов; - {=Document:CONTACT_IDS} - массив из документа. Важно: Это поле заменяет все существующие связи. Для добавления контакта сначала получите текущие через "Получение данных Сделки".
Ответственный (ASSIGNED_BY_ID)	В данном поле можно изменить ответственного за сделку. Примеры: - ={user_25} - назначить пользователя с ID 25; - ={25} - также можно указать только ID; - {=Document:ASSIGNED_BY_ID} - из документа. Важно: В поле должен быть только ID без лишних символов (или в формате user_ID).
Дата начала (BEGINDATE)	В данном поле можно изменить дату начала сделки. Примеры: - ={01.01.2025 00:00:00}; - {=System:NowLocal} - текущая дата и время.
Дата завершения (CLOSEDATE)	В данном поле можно изменить предполагаемую дату завершения. Примеры: - ={31.12.2025 23:59:59}; - ={{=dateadd({=Variable:CLOSEDATE}, "30d")}} - на 30 дней позже.
Источник (SOURCE_ID)	В данном поле указывается источник сделки. Примеры: - WEB - Веб-сайт; - CALL - Звонок; - EMAIL - Email.
Комментарий (COMMENTS)	В данном поле можно изменить комментарий сделки. Примеры: - Важная сделка; - ={{={=Variable:COMMENTS} & " | Дополнительная информация"}} - добавить к существующему.
UTM-метки	Поддерживаются поля: UTM_SOURCE, UTM_MEDIUM, UTM_CAMPAIGN, UTM_CONTENT, UTM_TERM. Примеры: - google - рекламная система; - cpc - тип трафика.
Завершена (CLOSED)	Примеры: - Y или 1 - сделка завершена; - N или 0 - сделка не завершена.
Пользовательские поля (UF_*)	Активити автоматически создаёт параметры для всех пользовательских полей вашего портала.

Примеры использования:

№	Сценарий	ID Сделки	Изменяемое поле	Значение
1	Сменить стадию	{=Document:ID}	STAGE_ID	QUALIFICATION
2	Назначить ответственного	{=Document:ID}	ASSIGNED_BY_ID	user_25
3	Установить сумму	{=Variable:DEAL_ID}	OPPORTUNITY	={500000}
4	Привязать компанию	{=Document:ID}	COMPANY_ID	={123}
5	Изменить название	{=Document:ID}	TITLE	Договор №{=Document:ID}
6	Установить вероятность	{=Document:ID}	PROBABILITY	={75}
7	Добавить комментарий	{=Document:ID}	COMMENTS	Обработано: {=System:Date}
8	Изменить дату завершения	{=Document:ID}	CLOSEDATE	={{=dateadd({=System:Now}, "14d")}}
9	Установить источник	{=Document:ID}	SOURCE_ID	WEB
10	Завершить сделку	{=Document:ID}	CLOSED	Y

Сценарий работы активити (робота)



Возвращаемые параметры для данного активити:

• ID изменённой сделки (deal_id) - числовой идентификатор изменённой сделки;
• Успех операции (success) - результат выполнения операции (Y/N);
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Важно:
- Нельзя изменить направление сделки через это активити - используйте штатные средства Битрикс24;
- Нельзя одновременно изменить направление и стадию - делайте это в разных активити;
- При изменении суммы вручную учитывайте, что она может быть перезаписана при изменении товаров;
- Пользователь, от имени которого запускается активити, должен иметь права на изменение сделки.

Удаление Сделки

Данное активити позволяет удалить сущность "Сделка", указав её ID.

Сценарий работы активити бизнес-процесса

ID сделки: в данном поле нужно указать ID удаляемой сделки.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат выполнения (Y/N);
- Сообщение об ошибке;
- Таймаут операции.

Получение данных по сущности: Сделка

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

• Получение всех данных сделки по её ID;
• Получение значений пользовательских полей сделки;
• Получение данных связанных контактов сделки;
• Формирование отчётов и документов на основе данных сделки;
• Передача данных сделки в другие системы или активити;
• Подготовка данных для печати (с форматированием);
• Получение данных сделки из другой воронки или направления;
• Анализ и аудит данных сделок;
• Копирование данных между сделками;
• Интеграция с внешними системами через REST API.

Как работает активити (робот):
- Активити (робот) получает все данные сделки по указанному ID через REST API (crm.deal.get);
- Автоматически получает список всех доступных полей сделки, включая пользовательские поля;
- Может получать данные связанных контактов сделки (crm.deal.contact.items.get);
- Поддерживает форматирование данных для печати;
- Возвращает все поля сделки как отдельные параметры для использования в бизнес-процессе;
- Работает с любыми сделками, к которым есть доступ у указанного пользователя.

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

Название поля	Описание и примеры использования
ID сущности	В данном поле указывается ID сущности "сделка", данные которой необходимо получить. Это обязательный параметр. Примеры: - {=Document:ID} - получить данные текущей сделки; - 123 - получить данные сделки с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска.
Для печати	Варианты: да/нет. Данное поле позволяет включить вывод данных в удобном для печати текстовом виде. При включении этой опции данные форматируются для удобного отображения в документах и отчётах.
Сообщение об ошибке	Варианты: да/нет. Позволяет выводить ошибки в журнал БП. Рекомендуется включать при отладке бизнес-процесса.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания (Время ожидания ответа от приложения)	Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию, при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити (робота), и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

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

Описание примера	Решение
Получение данных текущей сделки	Параметры: ID сущности - {=Document:ID}. Активити (робот) вернёт все данные текущей сделки, включая стандартные и пользовательские поля.
Получение данных сделки с форматированием для печати	Параметры: ID сущности - {=Document:ID}, Для печати - Да. Активити (робот) вернёт данные сделки в формате, удобном для использования в документах.
Получение данных связанной сделки из переменной	Параметры: ID сущности - {=Variable:RELATED_DEAL_ID}. Активити (робот) получит данные сделки, ID которой хранится в переменной RELATED_DEAL_ID.
Получение данных сделки из результата поиска	Параметры: ID сущности - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) получит данные первой найденной сделки из предыдущего активити поиска.
Получение данных сделки для копирования в новую сделку	Параметры: ID сущности - {=Document:ID}. После получения данных, используйте возвращаемые параметры (TITLE, OPPORTUNITY, STAGE_ID и др.) для создания новой сделки.
Получение данных сделки для формирования отчёта	Параметры: ID сущности - {=Document:ID}, Для печати - Да. Используйте возвращаемые параметры для формирования текстового отчёта о сделке.
Получение данных сделки и её контактов	Параметры: ID сущности - {=Document:ID}. Активити (робот) автоматически получит данные связанных контактов и вернёт их имена в отдельных параметрах.
Получение данных сделки через итератор	Параметры: ID сущности - {=Iterator:Value}. Для каждого ID сделки из итератора активити (робот) получит все данные этой сделки.
Получение данных сделки для отправки во внешнюю систему	Параметры: ID сущности - {=Document:ID}. Используйте возвращаемые параметры для формирования запроса к внешней системе (webhook, API интеграция).
Получение данных сделки для проверки условий	Параметры: ID сущности - {=Variable:CHECK_DEAL_ID}. После получения данных используйте возвращаемые параметры в условиях бизнес-процесса для принятия решений.

Возвращаемые параметры данного активити (робота):
- Все поля сделки - активити (робот) возвращает все стандартные и пользовательские поля сделки как отдельные параметры. Например: ID, TITLE, STAGE_ID, OPPORTUNITY, CURRENCY_ID, ASSIGNED_BY_ID, COMPANY_ID, CONTACT_ID и другие.
- Данные контактов - если к сделке привязаны контакты, их имена будут возвращены в отдельных параметрах.
- Сообщение об ошибке (s_error_logs) - строка с описанием ошибки или сообщением об успешном выполнении. При успешном выполнении содержит сообщение "deal_get_data_error_2: [количество полей]".
- Соответствует условиям (math_search_results) - строка, указывающая результат получения данных. Возможные значения: Y (данные получены) или N (сделка не найдена).

Важно о возвращаемых параметрах: Если сделка не найдена или у пользователя нет доступа к ней, параметр math_search_results будет равен N. Всегда проверяйте значение этого параметра перед использованием данных сделки в дальнейших шагах бизнес-процесса.

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

Обязательный параметр:
Для успешного получения данных обязательно должен быть указан параметр "ID сущности". Без указания ID сделки активити (робот) не сможет получить данные.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр указанной сделки. Если у пользователя нет прав, активити (робот) вернёт ошибку.

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

Связанные контакты:
Если к сделке привязаны контакты, активити (робот) автоматически получит их данные через отдельный запрос (crm.deal.contact.items.get) и вернёт имена контактов в отдельных параметрах.

Форматирование для печати:
При включении опции "Для печати" данные форматируются для удобного отображения. Это особенно полезно при формировании документов и отчётов.

Создание сделки с товарами

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

• Автоматическое создание сделок на основе данных из лидов или других сущностей;
• Создание сделок с предзаполненными товарными позициями;
• Автоматизация процесса конвертации лида в сделку с товарами;
• Создание сделок при интеграции с внешними системами (1С, интернет-магазины);
• Массовое создание сделок с определёнными параметрами;
• Создание сделок в определённом направлении (воронке);
• Автоматическое назначение ответственного и привязка к контактам/компаниям.

Как работает активити (робот):
- Активити (робот) создаёт новую сделку с указанными параметрами;
- Поддерживается добавление товарных позиций непосредственно при создании;
- Можно указать направление (воронку), стадию, ответственного;
- Поддерживается привязка к контактам и компаниям;
- Возвращается ID созданной сделки для использования в дальнейших шагах БП;
- Активити (робот) работает через REST API Битрикс24 (crm.deal.add).

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

Основные параметры:

Название поля	Описание и примеры использования
Название сделки	Название создаваемой сделки. Примеры: - Сделка от {=System:Date}; - Заказ №{=Variable:ORDER_NUMBER}; - {=Document:TITLE} - название из текущего документа.
Направление (воронка)	ID направления (воронки), в котором будет создана сделка. Примеры: - 0 - общая воронка (по умолчанию); - 1, 2, 3... - ID конкретного направления; - {=Variable:CATEGORY_ID} - из переменной.
Стадия сделки	Символьный код стадии, на которой будет создана сделка. Примеры: - NEW - стадия "Новая"; - C1:NEW - стадия "Новая" в воронке 1; - {=Variable:STAGE_ID} - из переменной.
Ответственный	ID ответственного за сделку. Примеры: - {=Document:ASSIGNED_BY_ID} - ответственный из текущего документа; - user_25 - конкретный пользователь; - {=User:ID} - текущий пользователь.
Контакт	ID контакта для привязки к сделке. Примеры: - {=Document:CONTACT_ID} - контакт из текущего документа; - {=Variable:CONTACT_ID} - из переменной; - 123 - конкретный ID.
Компания	ID компании для привязки к сделке. Примеры: - {=Document:COMPANY_ID} - компания из текущего документа; - {=Variable:COMPANY_ID} - из переменной; - 456 - конкретный ID.
Сумма	Сумма сделки (заполняется автоматически из товаров). Примеры: - {=Variable:AMOUNT}; - 100000.
Валюта	Код валюты сделки. Примеры: - RUB - рубли; - USD - доллары; - EUR - евро.
Источник	Код источника сделки из справочника CRM. Примеры: - WEB - веб-сайт; - CALL - звонок; - {=Document:SOURCE_ID} - из документа.
Комментарий	Комментарий к сделке. Примеры: - Создано автоматически {=System:Date}; - {=Document:COMMENTS}.

Параметры товарных позиций:

Название поля	Описание и примеры использования
Товары (массив)	Массив товарных позиций для добавления в сделку. Каждый элемент содержит ID товара, количество, цену. Формат: [{"PRODUCT_ID": 123, "QUANTITY": 2, "PRICE": 1000}]
ID товара	ID товара из каталога Битрикс24. Примеры: - {=Variable:PRODUCT_ID}; - 123.
Количество	Количество товара. Примеры: - {=Variable:QUANTITY}; - 1.
Цена	Цена товара за единицу. Примеры: - {=Variable:PRICE}; - 1000.
Скидка	Размер скидки на товар (в процентах или абсолютном значении).
Ставка НДС	Ставка налога для товара. Примеры: - 20 - 20% НДС; - 0 - без НДС.

Примеры использования:

№	Сценарий	Название	Направление	Ответственный
1	Создание из лида	{=Document:TITLE}	0	{=Document:ASSIGNED_BY_ID}
2	Создание в конкретной воронке	Новая сделка	2	user_1
3	Создание с привязкой к контакту	Заказ клиента	0	{=User:ID}
4	Создание с товарами	Заказ №{=Variable:ORDER_NUM}	0	{=Variable:MANAGER_ID}
5	Создание из интеграции	Заказ из интернет-магазина	1	user_10
6	Создание на определённой стадии	Горячая сделка	0	{=Document:ASSIGNED_BY_ID}
7	Создание с суммой	Сделка на {=Variable:AMOUNT} руб.	0	{=User:ID}
8	Создание с комментарием	Сделка по рекомендации	0	{=Variable:RESPONSIBLE_ID}
9	Создание с источником	Входящий звонок	0	{=Document:ASSIGNED_BY_ID}
10	Создание с UTM-метками	Сделка из рекламы	0	user_5

Возвращаемые параметры для данного активити:

• ID сделки (deal_id) - числовой идентификатор созданной сделки;
• Успех операции (success) - Y при успехе, N при ошибке;
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Важно:
- При создании сделки с товарами сумма рассчитывается автоматически;
- Для добавления товаров нужно указать ID товаров из каталога Битрикс24;
- Пользователь должен иметь права на создание сделок в указанном направлении;
- При указании стадии учитывайте направление (например, C1:NEW для воронки 1).

Рекомендации:
- Используйте переменные для динамического формирования названия сделки;
- При интеграции с внешними системами сохраняйте внешний ID в пользовательском поле для связи;
- Для массового создания сделок используйте итератор с паузами между операциями.

Смарт-процессы

Смарт-процессы

Создать новый смарт-процесс

Данное активити позволяет создать новый смарт-процесс.

Сценарий работы активити бизнес-процесса

Название:	В данном поле указывается название создаваемого смарт-процесса.
Символьный код:	В данном поле нужно указать латиницей символьный код смарт-процесса.
Использовать в смарт-процессе свои направления и туннели продаж:	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться пользовательские направления и туннели продаж.
Использовать в смарт-процессе свои стадии и канбан:	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться пользовательские стадии и канбан.
Поля "Дата начала" и "Дата завершения":	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться поля "Дата начала" и "Дата завершения" .
Поле "Клиент":	Данное поле позволяет выбрать, будет ли в созданном смарт-процессе использоваться поле "Клиент".
Использовать в пользовательском поле:	Данная настройка активирует возможность привязки пользовательских полей сущностей к смарт-процессу.
Привязка товаров каталога:	Данное поле позволяет активировать возможность привязки товаров из каталога. На данный момент работа с товарами в смарт процессах пока не доступна.
Поле "Реквизиты вашей компании":	Данное поле позволяет выбрать, будет ли в созданном смарт-процессе использоваться поле "Реквизиты вашей компании".
Печать документов:	Данный пункт меню позволяет активировать работу с печатной формой отчетов.
Поля "Источник" и "Дополнительно об источнике":	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться поля "Источник" и "Дополнительно об источнике".
Поле "Наблюдатели":	Данное поле позволяет выбрать, будет ли в созданном смарт-процессе использоваться поле  "Наблюдатели".
Использовать корзину:	Данный пункт меню позволяет активировать использование корзины.
Использовать в смарт-процессе роботы и триггеры:	Позволяет активировать работу с роботами и триггерами в смарт процессе (аналогично запуску роботов и триггеров в сделках или лидах).
Использовать в смарт-процессе дизайнер бизнес-процессов:	Позволяет активировать работу с дизайнером БП в смарт процессе.
Делать новые направления доступными для всех:	Данная опция позволяет сделать новые направления при создании доступными для всех ролей пользователей.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового смарт-процесса;
- Сообщение об ошибке.

 

Удалить смарт-процесс

Данное активити позволяет удалить смарт-процесс.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в данном поле указывается ID удаляемого смарт-процесса.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Получить данные по смарт-процессу

Данное активити позволяет получить данные указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в этом поле нужно указать ID смарт-процесса, данные которого нужно получить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID;
- Название;
- Символьный код;
- Кем создан;
- Идентификатор типа смарт-процесса;
- Результат выполнения;
- Сообщение об ошибке.

 

Поиск смарт-процессов

Данное активити позволяет найти смарт-процесс по указанным параметрам.

Сценарий работы активити бизнес-процесса

Название:	В данном поле указывается название искомого смарт-процесса.
Символьный код:	В данном поле нужно указать латиницей символьный код смарт-процесса.
Использовать в смарт-процессе свои направления и туннели продаж:	Данное поле позволяет указать, используются ли в искомом смарт-процессе пользовательские направления и туннели продаж.
Использовать в смарт-процессе свои стадии и канбан:	Данное поле позволяет указать, используются ли в искомом смарт-процессе пользовательские стадии и канбан.
Поля "Дата начала" и "Дата завершения":	Данное поле позволяет указать, используются ли в искомом смарт-процессе поля "Дата начала" и "Дата завершения" .
Поле "Клиент":	Данное поле позволяет указать, используется ли в искомом смарт-процессе поле "Клиент".
Использовать в пользовательском поле:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данная настройка активирует возможность привязки пользовательских полей сущностей к смарт-процессу.
Привязка товаров каталога:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данное поле позволяет активировать возможность привязки товаров из каталога. На данный момент работа с товарами в смарт процессах пока не доступна.
Поле "Реквизиты вашей компании":	Данное поле позволяет указать, используется ли в искомом смарт-процессе поле "Реквизиты вашей компании".
Печать документов:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данный пункт меню позволяет активировать работу с печатной формой отчетов.
Поля "Источник" и "Дополнительно об источнике":	Данное поле позволяет указать, используются ли в искомом смарт-процессе поля "Источник" и "Дополнительно об источнике".
Поле "Наблюдатели":	Данное поле позволяет указать, используется ли в искомом смарт-процессе поле "Наблюдатели".
Использовать корзину:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данный пункт меню позволяет активировать использование корзины.
Использовать в смарт-процессе роботы и триггеры:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром.  Позволяет активировать работу с роботами и триггерами в смарт процессе (аналогично запуску роботов и триггеров в сделках или лидах).
Использовать в смарт-процессе дизайнер бизнес-процессов:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром.  Позволяет активировать работу с дизайнером БП в смарт процессе.
Делать новые направления доступными для всех:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром.  Данная опция позволяет сделать новые направления при создании доступными для всех ролей пользователей.

Если при запуске поиска смарт-процессов по фильтру "Ответственный" по конкретному сотруднику (обычно один из администраторов портала), активити выдает идентификаторы как реально существующих СП, привязку которых вы видите наглядно, так и тех, которые вы не видите наглядно (к примеру смарт-процесс с ID_31 (смарт-счета)), то стоит учитывать, что это может быть особенностью работы метода crm.type.list.

Ограничить количество результатов до: в этом поле указывается предельное количество результатов, которое вернет активити, значение указывается цифрой.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

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

Изменить смарт-процесс

Данное активити позволяет изменить смарт-процесс.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в данном поле указывается ID изменяемого смарт-процесса.

Название:	В данном поле указывается название изменяемого смарт-процесса.
Символьный код:	В данном поле нужно указать латиницей символьный код смарт-процесса.
Идентификатор типа смарт-процесса:	В этом поле нужно указать ID типа смарт-процесса.
Использовать в смарт-процессе свои направления и туннели продаж:	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться пользовательские направления и туннели продаж.
Использовать в смарт-процессе свои стадии и канбан:	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться пользовательские стадии и канбан.
Поля "Дата начала" и "Дата завершения":	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться поля "Дата начала" и "Дата завершения".
Поле "Клиент":	Данное поле позволяет выбрать, будет ли в изменяемом смарт-процессе использоваться поле "Клиент".
Использовать в пользовательском поле:	Данная настройка активирует возможность привязки пользовательских полей сущностей к смарт-процессу.
Привязка товаров каталога:	Данное поле позволяет активировать возможность привязки товаров из каталога. На данный момент работа с товарами в смарт процессах пока не доступна.
Поле "Реквизиты вашей компании":	Данное поле позволяет выбрать, будет ли в изменяемом смарт-процессе использоваться поле "Реквизиты вашей компании".
Печать документов:	Данный пункт меню позволяет активировать работу с печатной формой отчетов.
Поля "Источник" и "Дополнительно об источнике":	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться поля "Источник" и "Дополнительно об источнике".
Поле "Наблюдатели":	Данное поле позволяет выбрать, будет ли в изменяемом смарт-процессе использоваться поле  "Наблюдатели".
Использовать корзину:	Данный пункт меню позволяет активировать использование корзины.
Использовать в смарт-процессе роботы и триггеры:	Позволяет активировать работу с роботами и триггерами в смарт процессе (аналогично запуску роботов и триггеров в сделках или лидах).
Использовать в смарт-процессе дизайнер бизнес-процессов:	Позволяет активировать работу с дизайнером БП в смарт процессе.
Делать новые направления доступными для всех:	Данная опция позволяет сделать новые направления при создании доступными для всех ролей пользователей.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Мониторинг событий смарт-процессов

Данное активити позволяет мониторить события указанного Вами смарт-процесса.

Сценарий работы активити бизнес-процесса

Смарт-процесс: в данном поле из выпадающего списка нужно выбрать смарт-процесс за событиями которого активити будет наблюдать.

Выпадающий список пункта меню "Смарт-процесс" содержит штатные смарт-процессы Б24, которые обычно скрыты от пользователя и не отображаются в в общем списке СП, созданных пользователями вручную или через бизнес-процесс.
Ответственным в этих смарт-процессах обычно является 1 из сотрудников, с правами администратора портала. 

Событие: в этом поле нужно из выпадающего списка нужно выбрать один из видов событий за которыми активити будет следить.
Варианты событий: Добавление/Изменение.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.

Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID смарт-процесса;
- Сообщение об ошибке.

 

Стадии

Добавить стадию смарт-процесса

Данное активити позволяет добавить новую стадию для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором будет добавлена стадия.

ID направления: в этом поле нужно указать ID направления в рамках которого будет создана стадия.

Название стадии: в данном поле указывается название стадии.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID новой стадии;
- Сообщение об ошибке.

 

Удалить стадию смарт-процесса

Данное активити позволяет удалить стадию указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором будет удалена стадия.

ID стадии: в данном поле указывается ID удаляемой стадии.

ID направления: в данном поле указывается ID направления в котором находится удаляемая стадия.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Получить данные по стадии смарт-процесса

Данное активити позволяет получить данные по стадии указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

ID стадии: в данном поле указывается ID стадии данные которой нужно получить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Идентификатор типа смарт процесса;
- ID направления;
- Сущность;
- Статус;
- Название стадии;
- Результат выполнения;
- Сообщение об ошибке.

 

Получить все стадии смарт-процесса

Данное активити позволяет получить все стадии указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором находится стадия.

ID направления: в данном поле указывается ID направления в котором находится стадия.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

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

 

Изменить стадию смарт-процесса

Данное активити позволяет изменить стадию в указанном смарт-процессе.

Сценарий работы активити бизнес-процесса

ID стадии: в данном поле указывается ID изменяемой стадии.

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором находится стадия.

ID направления: в этом поле нужно указать ID направления в котором содержится стадия.

Название стадии: в данном поле указывается название стадии.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Направления

Создать новое направление смарт-процесса

Данное активити позволяет создать новое направление для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID смарт-процесса в котором будет создано направления.

Имя направления: в этом поле нужно указать имя создаваемого направления.

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового направления;
- Сообщение об ошибке.

 

Удалить направление смарт-процесса

Данное активити позволяет удалить направление для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID смарт-процесса в котором будет удалено направление.

ID направления: в этом поле нужно указать ID удаляемого направления.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Получить данные по направлению смарт-процесса

Данное активити позволяет получить данные о направлении для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса.

Идентификатор процесса: в данном поле указывается ID смарт-процесса в котором содержится направление, данные по которому планируется получить.

ID направления: в этом поле нужно указать ID направления.

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Имя направления;
- Результат выполнения;
- Сообщение об ошибке.

 

Получить все направления смарт-процесса

Данное активити позволяет получить все направления указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID смарт-процесса направления которого нужно получить.

Ограничить количество до: в этом поле нужно указать ограничение по количеству получаемых результатов в виде числового значения.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

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

 

Изменить данные направления смарт-процесса

Данное активити позволяет изменить данные направления указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID процесса в котором находится изменяемое направление.

ID направления: в этом поле нужно указать ID направления, данные которого будут изменены.

Имя направления: в этом поле нужно указать имя изменяемого направления.

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Элементы

Создать новый элемент смарт-процесса

Данное активити позволяет создать новый элемент смарт-процесса.

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса:	в данном поле нудно указать ID типа смарт-процесса, в котором будет создан новый элемент.
Название:	в этом поле указывается название нового элемента.
Ответственный:	в данном поле указывается ID сотрудника, который будет ответственным за создаваемый элемент.
Доступно для всех:	в данном поле из выпадающего списка нужно выбрать будет ли данный элемент общедоступен (виден), варианты да/нет.
Создано CRM-формой:	в данном поле указывается ID CRM формы (Контакт-центр --> Форма на сайт), с помощью которой элемент был создан.
Дата начала:	в этом поле указывается дата начала работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
Дата завершения:	в этом поле указывается дата завершения работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
Компания:	в данном поле указывается ID компании с которой данный элемент будет связан.
Контакт:	в данном поле указывается ID контакта с которым данный элемент будет связан.
Наблюдатели:	в данном поле указывается ID сотрудника, который будет в роли наблюдателя в создаваемом элементе.
Направление:	в данном поле указывается ID направления, к которому создаваемый элемент будет относиться.
Реквизиты Вашей компании:	в данном поле указываются ID реквизитов Вашей компании.

   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового элемента;
- Сообщение об ошибке.

Получить данные по элементу смарт-процесса

Данное активити позволяет получить данные по элементу смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID типа смарт-процесса.

ID элемента: в этом поле нужно указать ID элемента смарт-процесса, данные которого нужно получить.

Активити работает только с простыми типами полей: строка, целое число, число, дата/время, дата, да/нет, адрес, ссылка, приваязка к справочникам CRM, привязка к элементам CRM. Поля, которых нет в данном списке - не поддерживаются ввиду того, что БП используют ограниченные типы полей, которые нельзя считать и передать. Если у Вас возникают вопросы по расширению списка поддерживаемых полей, рекомендуем обратиться в ТП Б24.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Название;
- Внешний код;
- Создано CRM-формой;
- ID компании;
- ID контакта;
- Направление;
- ID связанного лида;
- ID связанной сделки;
- ID связанного предложения;
- ID связанного заказа;
- Стадия;
- Предыдущая стадия;
- Источник;
- Сумма;
- Валюта;
- Реквизиты Вашей компании;
- Результат выполнения;
- Сообщение об ошибке.

Удалить элемент смарт-процесса

Данное активити позволяет удалить элемент смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID типа смарт-процесса.

ID элемента: в этом поле нужно указать ID элемента смарт-процесса, который нужно удалить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Изменить данные элемента смарт-процесса

Данное активити позволяет изменить элемент смарт-процесса.

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса:	в данном поле нудно указать ID типа смарт-процесса, в котором будет изменен элемент.
ID элемента:	в этом поле нужно указать ID изменяемого элемента смарт-процесса.
Название:	в этом поле указывается название изменяемого элемента.
Внешний код:	в данном поле нужно указать внешний код элемента.
Ответственный:	в данном поле указывается ID сотрудника, который будет ответственным за элемент.
Доступно для всех:	в данном поле из выпадающего списка нужно выбрать будет ли данный элемент общедоступен (виден), варианты да/нет.
Создано CRM-формой:	в данном поле указывается ID CRM формы (Контакт-центр->Форма на сайт), с помощью которой элемент был создан.
Дата начала:	в этом поле указывается дата начала работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
Дата завершения:	в этом поле указывается дата завершения работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
ID Компании:	в данном поле указывается ID компании с которой данный элемент будет связан.
ID Контакта:	в данном поле указывается ID контакта с которым данный элемент будет связан.
ID связанного лида:	в этом поле нужно указать ID связанного с элементом лида.
ID связанного контакта:	в этом поле нужно указать ID связанного с элементом контакта.
ID связанной сделки:	в этом поле нужно указать ID связанной с элементом сделки.
ID связанного предложения:	в этом поле нужно указать ID связанного с элементом предложения.
ID связанного заказа:	в этом поле нужно указать ID связанного с элементом заказа.
Наблюдатели:	в данном поле указывается ID сотрудника, который будет в роли наблюдателя в изменяемом элементе.
Направление:	в данном поле указывается ID направления, к которому изменяемый элемент будет относиться.
Стадия:	в этом поле указывается ID стадии в которой находится элемент.
Источник:	в данном поле можно изменить источник элемента. Значения берутся из одноимённого справочника CRM.
Дополнительно об источнике:	в этом поле указываются дополнительные данные об источнике.
Сумма:	данное поле аналогично по функционалу полю из сущности сделка, т.е в нем отображается/заполняется общая денежная сумма по элементу.
Режим расчета суммы:	в данном поле из выпадающего списка нужно выбрать активен ли режим автоматического расчета суммы или нет.
Валюта:	в данном поле указывается валюта с в которой происходит расчет.
Реквизиты Вашей компании:	в данном поле указываются ID реквизитов Вашей компании.

   

Если вам нужно перенести элементы поля тип "Список" из одной сущности в другую, к примеру из Компании в Контакт, то, просто так это сделать не получится, даже если это одно и то же поле, которое было конвертировано из Лида в любую другую сущность.
Однако, для полей элементов Смарт-процесса данное правило не актуально, т.к в рамках одного смарт-процесса, элементы поля тип "Список" имеют идентичные ID.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Поиск элементов смарт-процесса

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

• Поиск элементов смарт-процесса по различным критериям (название, стадия, ответственный);
• Фильтрация элементов для создания отчётов и аналитики;
• Поиск связанных элементов при работе с контактами, компаниями или сделками;
• Поиск элементов в определённой воронке (направлении) смарт-процесса;
• Поиск элементов по датам начала, завершения или последней коммуникации;
• Массовые операции над группой элементов (изменение стадии, назначение ответственного);
• Поиск элементов по сумме для финансовой аналитики;
• Интеграция с другими сущностями CRM (лиды, сделки, контакты, компании);
• Автоматизация процессов на основе найденных элементов;
• Поиск элементов по пользовательским полям смарт-процесса.

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей выбранного смарт-процесса через REST API (crm.item.fields);
- Для каждого поля создаётся параметр поиска, который можно заполнить для фильтрации;
- Поддерживается выбор воронки (направления) и стадии для более точного поиска;
- Можно комбинировать несколько полей для более точного поиска;
- Поиск выполняется по принципу "И" (AND) - все указанные условия должны выполняться одновременно;
- Поддерживается обработка больших объёмов данных (более 50 элементов) через специальную обработку;
- Результаты возвращаются в виде массива ID элементов, строки с ID через запятую, первого и последнего ID, количества найденных элементов.

Сценарий работы активити (робота) бизнес-процесса

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

Название поля	Описание и примеры использования
Тип смарт-процесса	В данном поле нужно выбрать из выпадающего списка смарт-процесс, в котором будет осуществляться поиск элементов. Это обязательный параметр. Примеры: - Выберите нужный смарт-процесс из выпадающего списка; - Список смарт-процессов формируется автоматически на основе настроек вашего портала.
Воронка	В этом поле из выпадающего списка нужно выбрать направление (воронку), в которой находится искомый элемент смарт-процесса. Примеры: - Выберите нужную воронку из выпадающего списка; - Если воронка не указана, поиск будет осуществляться по всем воронкам.
Стадия	В этом поле указывается ID стадии, в которой находится элемент. Примеры: - Выберите нужную стадию из выпадающего списка; - Можно выбрать несколько стадий, зажав Ctrl и кликнув по нужным стадиям.
ID	В этом поле нужно указать ID искомого элемента смарт-процесса. Примеры: - ={123} - найти элемент с ID равным 123; - {=Document:ID} - использовать ID из текущего документа; - ={!123} - найти все элементы, кроме элемента с ID 123.
Название	В этом поле указывается название искомого элемента. Поддерживает поиск по частичному совпадению. Примеры: - ={%заявка} - найти элементы, название которых содержит "заявка"; - ={Заявка на ремонт} - найти элемент с точным названием; - ={!%тест} - найти элементы, название которых не содержит "тест".
Ответственный	В данном поле указывается ID сотрудника, который указан как ответственный в элементе. Примеры: - {=Document:ASSIGNED_BY_ID} - использовать ответственного из текущего документа; - ={25} - найти элементы пользователя с ID 25; - {=User:ID} - найти элементы текущего пользователя.
Доступно для всех	В данном поле из выпадающего списка нужно выбрать, является ли элемент общедоступным (виден всем). Варианты: - Да - элемент виден всем пользователям; - Нет - элемент виден только определённым пользователям.
Создано CRM-формой	В данном поле указывается ID CRM формы (Контакт-центр -> Форма на сайт), с помощью которой элемент был создан. Примеры: - ={5} - найти элементы, созданные формой с ID 5.
Дата начала	В этом поле указывается дата начала работы с элементом. Формат: день.месяц.год час:минута:секунда. Примеры: - ={=>08.12.2021 14:00:00} - найти элементы с датой начала после указанной даты; - ={{01.01.2025 00:00:00}}##{{31.12.2025 23:59:59}} - найти элементы с датой начала в 2025 году.
Дата последней коммуникации	В этом поле указывается дата и/или время последней коммуникации с клиентом. Примеры: - ={=>{=dateadd({=System:Now}, "-7d")}} - найти элементы с коммуникацией за последние 7 дней.
Дата завершения	В этом поле указывается дата завершения работы с элементом. Формат: день.месяц.год час:минута:секунда. Примеры: - ={=<31.12.2025 23:59:59} - найти элементы с датой завершения до конца 2025 года.
Компании	В данном поле указывается ID компании, с которой искомый элемент связан. Примеры: - ={123} - найти элементы, связанные с компанией ID 123; - {=Document:COMPANY_ID} - использовать ID компании из текущего документа.
ID Контакта	В данном поле указывается ID контакта, с которым искомый элемент связан. Примеры: - ={456} - найти элементы, связанные с контактом ID 456; - {=Document:CONTACT_ID} - использовать ID контакта из текущего документа.
ID связанного лида	В этом поле нужно указать ID связанного с элементом лида. Примеры: - ={789} - найти элементы, связанные с лидом ID 789.
ID связанного предложения	В этом поле нужно указать ID связанного с элементом предложения.
ID связанного заказа	В этом поле нужно указать ID связанного с элементом заказа.
Наблюдатели	В данном поле указывается ID сотрудника, который является наблюдателем в искомом элементе. Примеры: - ={25} - найти элементы, где пользователь с ID 25 является наблюдателем.
Направление	В данном поле указывается ID направления, к которому искомый элемент относится.
Источник	В данном поле можно указать источник элемента. Значения берутся из одноимённого справочника CRM. Примеры: - ={WEB} - найти элементы из источника "Веб-сайт"; - ={CALL} - найти элементы из источника "Звонок".
Дополнительно об источнике	В этом поле указываются дополнительные данные об источнике.
Сумма	Данное поле аналогично по функционалу полю из сущности сделка - в нем отображается/заполняется общая денежная сумма по элементу. Примеры: - ={>100000} - найти элементы с суммой больше 100 000; - ={{10000}}##{{50000}} - найти элементы с суммой от 10 000 до 50 000.
Режим расчета суммы	В данном поле из выпадающего списка нужно выбрать, активен ли режим автоматического расчета суммы или нет.
Валюта	В данном поле указывается валюта, в которой происходит расчет. Примеры: - ={RUB} - найти элементы в рублях; - ={USD} - найти элементы в долларах.
Реквизиты Вашей компании	В данном поле указываются ID реквизитов Вашей компании.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса.
Текст статуса	В данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания (Время ожидания ответа от приложения)	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Операторы сравнения для поиска

Данные символы ставятся перед содержимым ячейки:
- ={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".
- ={!%ваше значение} - не содержит.
Пример заполнения: ={!%123}, это значит, что значение в выбранном поле не содержит 123.
- ={ваше значение} - равно.
Пример заполнения: ={123}, это значит, что значение в выбранном поле равно 123.
- ={!ваше значение} - не равно.
Пример заполнения: ={!123}, это значит, что значение в выбранном поле не равно 123.
- ={>ваше значение} - больше.
- ={<ваше значение} - меньше.
- ={=>} - больше или равно.
- ={=<} - меньше или равно.

Для полей типа "дата" и "дата/время":
- Содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}
- В случае с переменной: ={=>{=Variable:search_date}}
- При необходимости поиска диапазона "от и до": ={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

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

Описание примера	Решение
Поиск элементов смарт-процесса "Заявки" на стадии "Новая"	Параметры: Тип смарт-процесса - Заявки, Стадия - Новая. Активити (робот) найдёт все элементы на указанной стадии.
Поиск элементов по ответственному из текущего документа	Параметры: Тип смарт-процесса - [выбрать нужный], Ответственный - {=Document:ASSIGNED_BY_ID}. Активити (робот) найдёт все элементы, за которые отвечает тот же сотрудник.
Поиск элементов, связанных с контактом ID 456	Параметры: Тип смарт-процесса - [выбрать нужный], ID Контакта - ={456}. Активити (робот) найдёт все элементы, связанные с указанным контактом.
Поиск элементов с суммой больше 100 000 рублей	Параметры: Тип смарт-процесса - [выбрать нужный], Сумма - ={>100000}, Валюта - ={RUB}. Активити (робот) найдёт все элементы с суммой больше 100 000 рублей.
Поиск элементов с названием, содержащим "ремонт"	Параметры: Тип смарт-процесса - [выбрать нужный], Название - ={%ремонт}. Активити (робот) найдёт все элементы, в названии которых есть слово "ремонт".
Поиск элементов в определённой воронке	Параметры: Тип смарт-процесса - [выбрать нужный], Воронка - [выбрать нужную]. Активити (робот) найдёт все элементы в указанной воронке.
Поиск элементов, созданных за последний месяц	Параметры: Тип смарт-процесса - [выбрать нужный], Дата начала - ={=>{=dateadd({=System:Now}, "-1m")}}. Активити (робот) найдёт все элементы, созданные за последний месяц.
Поиск элементов, связанных с компанией из текущего документа	Параметры: Тип смарт-процесса - [выбрать нужный], Компании - {=Document:COMPANY_ID}. Активити (робот) найдёт все элементы, связанные с компанией из текущего документа.
Поиск элементов с датой завершения в текущем квартале	Параметры: Тип смарт-процесса - [выбрать нужный], Дата завершения - ={{01.01.2025 00:00:00}}##{{31.03.2025 23:59:59}}. Активити (робот) найдёт все элементы с датой завершения в первом квартале 2025 года.
Поиск общедоступных элементов текущего пользователя	Параметры: Тип смарт-процесса - [выбрать нужный], Ответственный - {=User:ID}, Доступно для всех - Да. Активити (робот) найдёт все общедоступные элементы текущего пользователя.

Сценарий работы робота

Возвращаемые параметры данного активити (робота):
- Результат поиска (массив для итератора) (search_results_array) - массив чисел с ID найденных элементов смарт-процесса. Используется для итерации по результатам в бизнес-процессе.
- Результат поиска (строка) (search_results_string) - строка со всеми результатами поиска, разделёнными запятыми. Удобно для передачи в другие активити (роботы).
- Первый результат поиска (search_result_first_string) - строка с первым результатом поиска. Полезно, когда нужно получить только первый найденный элемент.
- Последний результат поиска (search_result_last_string) - строка с последним результатом поиска.
- Количество найденных элементов (count_search) - числовое значение, указывающее количество найденных элементов.
- Сообщение об ошибке (s_error_logs) - строка с описанием ошибки или сообщением об успешном выполнении.

Важно о возвращаемых параметрах: Если элементы не найдены, количество найденных элементов будет равно 0. Всегда проверяйте количество найденных элементов перед использованием результатов в дальнейших шагах бизнес-процесса.

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

Обязательный параметр:
Для успешного поиска обязательно должен быть указан параметр "Тип смарт-процесса". Без указания типа смарт-процесса поиск не будет выполнен.

Динамическая поддержка полей:
Активити (робот) автоматически получает список всех доступных полей выбранного смарт-процесса, включая пользовательские поля. Это означает, что вы можете искать по любым полям, доступным в вашем смарт-процессе.

Воронки и стадии:
Воронки и стадии загружаются динамически для выбранного смарт-процесса. Если вы измените смарт-процесс, список воронок и стадий обновится автоматически.

Обработка больших объёмов данных:
Активити (робот) автоматически обрабатывает случаи, когда результатов больше 50 элементов, используя специальную функцию more50. Все элементы будут корректно обработаны и возвращены в результатах.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр элементов смарт-процесса. Рекомендуется использовать пользователя с правами администратора системы.

Мониторинг событий элементов смарт-процессов

Активити наблюдает за событиями внутри смарт-процесса и если происходит событие указанное в настройках,  возвращает в виде результата ID нового элемента, Смарт процесса или результат выполнения.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в этом поле указывается ID смарт-процесса за событиями которого наблюдает активити.

ID-элемента: в этом поле указывается ID элемента смарт-процесса.
Данное поле нужно для тех случаев когда требуется отслеживать события по конкретному элементу смарт-процесса. Если необходимо отслеживать все элементы смарт-процесса, то данное поле не заполняется.

Событие: в данном поле из выпадающего списка нужно выбрать тип события, на которое будет реагировать данное активити.
Доступно на выбор 3 типа событий: Добавление, Изменение, Удаление элемента любого смарт-процесса

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Данное активити в первую очередь предназначено для использования в конструкторе БП.
Использование в конструкторе роботов может привести к самопроизвольным срабатываниям из-за несовершенства логики работы мехнизма роботов с методами слежения за сущностями.

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового элемента;
- ID смарт-процесса;
- Сообщение об ошибке.

Сотрудники

Поиск сотрудников

Данное активити позволяет найти сотрудника по заданным параметрам.

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

Сценарий работы активити бизнес-процесса

ID: указание ID искомого сотрудника.
Данный пункт рассчитан на вывод данных только 1 сотрудника.

Подразделения: в данном поле указывается код подразделения, т.е его ID, так же можно выбрать подразделение из контекстного меню "..."/ "Категории пользователей"/"Сотрудники и отделы"/ выбрать подходящий отдел. Подразделение/отдел или департамент, это по сути одно и тоже.
Пример заполнения: [D1] , где "1", это ID подразделения, так если выбирать через контекстное меню, то поле может быть заполнено так: BITRIX: Все сотрудники отдела [D1];

Какие параметры выводить: данное поле позволяет ограничить перечень доступных к выводу параметров.
Варианты выбора:

• Только ID/Все данные/Сокращенный список параметров;
• Только ID: активити выдаст только ID пользователя;
• Все данные: Все доступные данные о пользователе;
• Сокращенный список параметров: 24 поля , ID пользователя, e-mail, фамилия, имя , отчество, пол, должность, день рождения, номер телефона мобильный и рабочий, факс, сайт или ссылка на соц сети, улица, город, индекс, страна, номер подразделения в котором работает.

Уволен ли сотрудник(сотрудники)?: варианты да/нет, позволяет указать, уволен ли искомый сотрудник или нет.

Данное поле ЖЕЛАТЕЛЬНО к заполнению, если не указать уволен ли сотрудник или нет, то в результате поиска вы получите всех сотрудников, которые когда-либо работали в отделе, включая уволенных.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Какие параметры выводить: в данном пункте доступны варианты выбора из выпадающего списка.
1. Только ID: в результате поиска выводит только ID искомого сотрудника.
2. Все данные: выводит все доступные данные о сотруднике.
3. Сокращенный список параметров: выводятся только основные параметры о сотруднике(ID, имя, e-mail).

Если какие-либо данные у сотрудников будут совпадать, то активити будет выводить данные сотрудников, у которых эти данные совпадают.
Т.е если у 2 сотрудников совпал телефон или e-mail, то в результате активити выдаст ID этих пользователей.
Однако изначально активити рассчитано на поиск 1 сотрудника.
Если вы хотите вывести один из возвращаемых параметров "Результат.." , то вам необходимо выбрать из выпадающего списка параметр "Все данные".

Если нужно осуществить поиск по полю "Рабочий телефон", то в активити это поле называется "Телефон компании".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса:  данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:  в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат..(ID,EMAIL и пр.)
- ID сотрудника.
- Данные, которые указаны в учетной записи сотрудника(Ф.И.О., почта, телефон и пр.).

Пригласить сотрудника

Данное активити позволяет отправить сотруднику приглашение на портал.

Сценарий работы активити бизнес-процесса

Почта, куда должно прийти приглашение: в данном поле указывается e-mail адрес для отправки приглашения.

Данное поле не поддерживает работу с массивами.

Экстранет:  будет ли данный сотрудник экстанет пользователем или нет.

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

ID группы (проекта): в данном поле указывается ID группы (проекта), в которой будет состоять приглашенный на портал сотрудник.

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

Если сотрудник штатный, то поле "ID подразделения" обязательно к заполнению.

Текст приветствия: в данном поле указывается текст приветствия для приглашенного сотрудника.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: 

в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID приглашенного пользователя.
- Сообщение об ошибке.

Получение отдела сотрудника

Данное активити даёт возможность получить id отдела в котором работает выбранный для анализа сотрудник портала. Это необходимо, когда нужно выбрать другого пользователя из отдела в котором состоит конкретный сотрудник, участвующий в бизнес-процессе.

Сценарий работы активити бизнес-процесса

ID сотрудника - в данное поле необходимо вставить ID сотрудника, отдел которого Вы хотите узнать.

Вывести информацию по названию отдела: варианты: да/нет.
Данный пункт позволяет вывести информацию об отделе сотрудника в текстовом виде.

Результатом работы приложения будет получение ID отдела сотрудника, который Вы уже сможете вставлять в свои бизнес-процессы.

ВАЖНО!
Если у Вас сотрудник участвует сразу в нескольких отделах, то наше активити Вам не поможет, т.к. всегда будет возвращать первый попавшейся.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы роботов

   
   Возвращаемые параметры данного активити:
   - ID отдела (первый, если он в списке)
   - ID отделов пользователя (массив для итератора).
   - Названия отделов пользователя (массив для интегратора)
   - Количество найденных элементов.

Выбор сотрудника по e-mail

Данное активити позволяет выбрать сотрудника по его e-mail адресу. Это особенно важно, когда вы хотите назначать задачи экстранет пользователям, т.к. по другому у вас не получится это сделать в рамках бизнес-процесса. 

Сценарий работы активити бизнес-процесса

Email - в это поле необходимо вставить E-mail сотрудника, которого вы хотите выбрать.
На текущий момент, нет возможности удобно получать список экстранет-пользователей в бизнес-процессах и приходится выстраивать систему через e-mail.
Чтобы получить e-mail, необходимо либо создавать пользовательское поле типа список и туда заносить всех ваших экстранет пользователей, а потом с помощью бизнес-процесса сопоставлять полученного человека и его e-mail. Можно пойти проще. Сделать сразу список e-mail и в нём выбирать значение. 

Добавлять "user_" к ID пользователя: в данном поле указывается, будет ли добавлена текстовая приставка "user_" к ID пользователя.

ВАЖНО!
Необходимо помнить, что система не принимает просто ID пользователя и требуется делать дополнительное действие через изменение переменных, чтобы получить на выходе следующую конструкцию - user_{ID которое получили}. Например, если Вы получили через наше активити ID 13, то для вставки в конкретную сущность необходимо привести его к форме - user_13.

Результатом работы приложения будет получение ID конкретного сотрудника, который Вы уже сможете вставлять в свои бизнес-процессы.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Сценарий работы робота

Возвращаемые параметры данного активити:
- ID сотрудника.
- Сообщение об ошибке.

Изменить данные сотрудника

Данное активити позволяет изменить данные сотрудника по заданным в настройках параметрам.

Сценарий работы активити бизнес-процесса

Пользовательские поля нельзя получить методом rest. Это значит, что пользовательские поля не поддерживаются и если таковые были созданы, то они не появятся в списке полей в меню настройки активити.

ID сотрудника: в данном поле указывается ID сотрудника, данные которого нужно изменить.

Активность: в данном поле выбирается активен пользователь и может совершать действия или нет. Если нет, то пользователь даже не сможет зайти на портал.

В данном активити значительно больше полей, однако их назначение довольно легко понять, если у Вас возникли сложности, то вы можете обратиться за разъяснением их функционала в нашу ТП. 

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

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

Сценарий работы робота

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Выбор сотрудника по должности

Данное активити позволяет получить id сотрудника, который работает на портале зная всего лишь название его должности. Это особенно удобно когда у вас множество бизнес-процессов и в них приписаны должности людей, а не конкретные люди, т.к. при увольнении сотрудника вам придётся переписывать все бизнес-процессы в которых уволенный сотрудник участвовал.

Сценарий работы активити бизнес-процесса

Должность: наш специальный алгоритм собирает в данное поле все доступные на портале должности, выбрать  необходимую должность можно из выпадающего списка… Стоит учитывать, что если у вас есть несколько одинаковых названий должностей, то следует их именовать по другому, например, используя цифры: Менеджер 1 или Менеджер 2. 

Добавлять "user_" к ID пользователя: в данном поле указывается, будет ли добавлена текстовая приставка "user_" к ID пользователя.

ВАЖНО!
Необходимо помнить, что система не принимает просто ID пользователя и требуется делать дополнительное действие через изменение переменных, чтобы получить на выходе следующую конструкцию - user_{ID которое получили}. Например, если Вы получили через наше активити ID 13, то для вставки в конкретную сущность необходимо привести его к форме - user_13.

Резервный пользователь: данное поле обязательно для заполнения и заполняется на тот случай, если сотрудник с искомой должностью уволен. Если сотрудник не был уволен, то данные, заполненные в этом поле игнорируются, а если был, то активити выдаст ID резервного пользователя.

Результатом работы приложения будет получение ID конкретного сотрудника, который Вы уже сможете вставлять в свои бизнес-процессы.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Сценарий работы робота

   
   Возвращаемые параметры данного активити:
   - ID пользователя (первый, если он в списке)
   - ID пользователей (массив для итератора).
   - Количество найденных элементов.

Списки

Первый или последний элемент в списке

Данное активити позволяет выводить первый или последний элементы списка, указав ID и тип этого списка.

Сценарий работы активити бизнес-процесса

Тип инфоблока(списка): из выпадающего списка нужно выбрать тип инфоблока (списка), в котором содержится первый или последний элемент в списке.
Доступно 2 варианта:

• Инфоблок списка;
• Инфоблок процессов;

ID инфоблок (списка): в этом поле указывается ID списка, в котором содержится первый или последний элементы.

Расположение элемента: в этом поле нужно выбрать из выпадающего списка какой элемент нужно вывести: первый или последний.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Соответствует условиям.
- ID выбранного элемента списка.
- Сообщение об ошибке.

Поиск элемента списка

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

Сценарий работы активити бизнес-процесса

Где искать элемент: из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находится.
Если поле является списком, то нужно искать ID элемента, а не его значение.
Для этого нужно:
1. Перейти в режим редактирования элемента списка
2. Нажать F12 и выбрать селектор элементов страницы. 
3. Выбрать поле со списком.
4. Внизу появится список с ID.
Если осуществляется поиск списка групп, то поле "Где искать элемент" не заполняется.

Если в выпадающем списке нет списка, в котором расположен искомый элемент, то причин может быть 3:

• Вы создали список уже после установки активити, и чтобы активити "увидело" этот список, его (активити) нужно переустановить.
• Количество списков более 100, либо у списков слишком большая вложенность. У Б24 есть ограничение по размеру файла, в котором описан перечень списков и элементов, которые они содержат. Если размер файла превышает лимит, то активити попросту не увидит некоторые списки.
  
• У меню с выпадающим списком есть ограничение на отображение не более 50 элементов.

ID группы: в данном поле указывается ID группы, в которой лежит список. Данное поле заполняется цифрой, без каких-либо дополнительных знаков (пробелов тоже не должно быть).

ID списка: в данном поле указывается ID списка, который расположен в группе. Данное поле заполняется цифрой, без каких-либо дополнительных знаков (пробелов тоже не должно быть).

По какому полю выполнять поиск: позволяет выбрать тип поля, по которому будет выполняться поиск.
Доступно 4 варианта типов полей:

1. Вид поля "Код" (Код пользовательского поля); 
2. Тип "Детальное описание"; 
3. Тип "Анонс" (Предварительное описание); 
4. Тип "Название элемента"; 
5. Тип "Код штатного поля". Узнать тип поля можно в редакторе полей (действия>настроить поля).

1. Если выбран тип "Привязка к элементам CRM" и указана только одна сущность (любая), то осуществлять поиск нужно по ID.

2. Если установлен тип "Код" и указанно несколько сущностей(любых), то поиск нужно осуществлять по ID с префиксом.

Префиксы(Содержимое искомого поля):
L_26635 - Лид
C_843 - Контакт
CO_709 - Компания
D_839 - Сделка

Тип поля "код" устанавливается при создании поля в редакторе полей.
Поиск элемента по типу поля "код" не будет работать, если не указать данный тип поля при создании его в редакторе полей.
Это же правило распространяется на тип поля "Строка" или "Число".

CODE - это обозначение вида пользовательских полей при вводе параметров поиска. Оно относится к любым пользовательским полям, вне зависимости от того, какого ого типа (Например: Число, строка, дата  и.т.д)
NAME, DETAIL_TEXT, PREVIEW_TEXT - это системные виды полей.

Код искомого поля: данный код берется из пункта "настройка полей", в выбранном инфо блоке списка.
Если код искомого поля пуст, то активити будет искать согласно полю "Название".
Данное поля только для полей тип "Код".

Если поиск элементов осуществляется по "Код штатного поля", то коды штатных полей Б24 можно узнать перейдя в справку.
В случае, когда осуществляется поиск по штатному полю с кодом "DATE_CREATE" (Дата создания элемента), правильное заполнение поля выглядит так: #DTДата.Месяц.Год.

Пример: #DT23.06.2022.

Пример: NAIMENOVANIE_MATERIALA

Тип условия поиска: в данном поле указывается условие для поиска элемента.
Доступны варианты: равно, не равно, больше или равно, меньше или равно, больше, меньше, содержит, не содержит.

ВАЖНО!
Для полей тип "Список" нельзя использовать числовые значения, например "Содержит 283".

Содержимое искомого элемента: в данном пункте указывается название искомого элемента списка.
Пример: Трос

Данные символы ставятся перед содержимым ячейки:
={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=> больше или равно.
Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<  меньше или равно.
Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так: Вид пользовательского поля##Код поля##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}
Вид пользовательского поля: это тип пользовательского поля (строка, число и прочее смотря какой у вас) заполняется на английском.
Код поля: берется в настройках поля из адресной строки. 
Пример заполнения:
datetime##UF_CRM_1611588337##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Сообщение об ошибке
- Соответствует условиям
- ID элемента списка (первый, если больше 1)
- Результат поиска (массив для итератора) 

Поиск элемента списка по нескольким полям

Активити "Групповой поиск элементов списка" предназначено для использования в бизнес-процессах и роботах, когда требуется найти элементы списка Битрикс24 по нескольким условиям одновременно.

Сценарий работы активити бизнес-процесса

Активити (робот) анализирует выбранный список и находит элементы, удовлетворяющие набору условий. Для каждого условия указывается тип поля, буквенный код, код сравнения и искомое значение. Результатом будет массив ID найденных элементов и ID первого элемента из списка найденных.

Где искать элемент: в выпадающем списке выберите местоположение искомого элемента. Если поле является списком, используйте ID элемента, а не его текстовое значение.

Чтобы определить ID элемента:

1. Перейдите в режим редактирования элемента списка.
2. Нажмите F12 и включите выбор элемента на странице.
3. Укажите нужное поле списка.
4. Внизу появится значение с нужным ID.

Если осуществляется поиск списка групп, поле "Где искать элемент" не заполняется.

Если после установки активити (робота) список не отображается в выпадающем меню, убедитесь, что активити переустановлено после создания новых списков, общее количество списков не превышает 100 и глубина вложенности разумная, а также учитывайте ограничение на отображение не более 50 элементов в выпадающем меню.

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

Название поля	Описание и примеры использования
Где искать элемент	Выберите список, в котором выполняется поиск. Для поиска по групповым спискам поле оставьте пустым. Пример: lists_567.
ID группы	Укажите идентификатор группы соцсети, если используется списочный инфоблок в группе. Пример: {=Variable:GROUP_ID}.
ID списка	Задайте идентификатор инфоблока для поиска. Пример: {=Variable:IBLOCK_ID}.
Параметры поиска элемента(ов)	Укажите одно или несколько условий в формате ТИП##КОД##УСЛОВИЕ##ЗНАЧЕНИЕ. Примеры: CODE##NAME##1##Трос; NAME##7##Заказ {=Document:ID}.
Тип условия для всех параметров	Выберите тип агрегирования условий: 1 — все условия (И); 2 — любое условие (ИЛИ).
Делать отладочные сообщения в журнал БП	Варианты: Да/нет. Включайте только при необходимости детальной диагностики, так как активити использует дополнительные запросы.
Запускать от имени	Укажите сотрудника, от имени которого выполняется поиск. Рекомендуется задавать сотрудника с административными правами. Пример: {=Template:TargetUser}.
Устанавливать текст статуса	Варианты: Да/нет. При выборе «Да» активити обновляет статус шага бизнес-процесса.
Текст статуса	Текстовое описание текущего шага. Пример: Копия {=Document:TITLE}.
Ожидать ответа	Системное поле, определяет необходимость ожидания результата от приложения.
Период ожидания. Время ожидания ответа от приложения	Укажите период ожидания (не менее 5 минут). Пример: 10m.

Формат условий поиска

Условия задаются последовательностью: тип поля##буквенный код##код условия##значение.

Типы полей: 

CODE — пользовательские поля;

NAME — название; 

DETAIL_TEXT — детальный текст;

PREVIEW_TEXT — текст анонса.

Коды условий: 

• Равно - 1 (=); 
• Не равно - 2 (!=);
• Больше или равно - 3 (>=);
• Меньше или равно - 4 (<=);
• Больше - 5 (>);
• Меньше - 6 (<);
• Содержит - 7 (%);
• НЕ Содержит - 8 (!%).

Примеры условий:

• CODE##UF_SUMMA##1##{=Variable:TARGET_SUM}
• DETAIL_TEXT##7##СПБ
• NAME##7##Контракт {=Document:ID}
• PREVIEW_TEXT##8##Архив

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123}, это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123}, это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123}, это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123}, это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123}, это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>ваше значение} - больше или равно.
Пример заполнения: ={=>123}, это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<ваше значение} - меньше или равно.
Пример заполнения: ={=<123}, это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.

Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:

Вид пользовательского поля##Код поля##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}
Вид пользовательского поля: это тип пользовательского поля (строка, число и прочее смотря какой у вас) заполняется на английском.
Код поля: берется в настройках поля из адресной строки.
Пример заполнения:
datetime##UF_CRM_1611588337##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Для полей типа число или дата диапазон задаётся повторением параметра CODE с разными кодами условий.
Пример:
Ищем элемент за период с 01.03.2025 09:00:00 по 03.03.2025 09:00:00.
Заполняем поле: CODE##UF_CRM_DATE##3##{01.03.2025 09:00:00} и CODE##UF_CRM_DATE##4##{03.03.2025 09:00:00}.

При использовании множественного параметра "Параметры поиска элемента(ов)" каждое поле ввода в форме добавляет строку в общий массив content_element_search.
Убедитесь, что условия заполнены последовательно, иначе активити (робот) вернет ошибку формата.

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

Описание примера	Решение
Поиск договора по названию и сумме с обязательным совпадением обоих условий	Где искать элемент — lists_567; Параметры поиска — CODE##UF_CONTRACT_NAME##1##Договор {=Document:ID}; CODE##UF_SUMMA##3##100000; Тип условия — 1.
Нахождение заявок, в детальном тексте которых указан город СПБ	Параметры поиска — DETAIL_TEXT##7##СПБ; Тип условия — 2; Результат используется в итераторе для уведомления {=User:ID}.
Выбор элементов, название которых содержит номер счёта документа	Параметры поиска — NAME##7##Счет {=Document:ACCOUNT_NUMBER}; Тип условия — 1; Группа — {=Variable:GROUP_ID}.
Поиск элементов с анонсом, не содержащим слово "Архив"	Параметры поиска — PREVIEW_TEXT##8##Архив; Тип условия — 2; ID списка — {=Variable:IBLOCK_ID}.
Поиск заявок с датой создания в диапазоне текущей недели	Параметры поиска — datetime##UF_DATE_CREATE##{{01.03.2025 00:00:00}}##{{07.03.2025 23:59:59}}; Тип условия — 1; Результат используется для уведомления {=User:ID}.
Получение списка элементов, где сумма больше значения из переменной	Параметры поиска — CODE##UF_SUMMA##5##{=Variable:TARGET_SUM}; Тип условия — 2; Делать отладку — нет.
Поиск элементов с точным совпадением пользовательского поля "Статус"	Параметры поиска — CODE##UF_STATUS##1##{=Variable:STATUS_TEXT}; Тип условия — 1; Запускать от имени — {=Template:TargetUser}.
Отбор элементов, у которых поле "Регион" не содержит значение {=Variable:REGION_BLOCK}	Параметры поиска — CODE##UF_REGION##8##{=Variable:REGION_BLOCK}; Тип условия — 2.
Поиск элементов по нескольким условиям с типом "ИЛИ"	Параметры поиска — CODE##UF_PRIORITY##1##Высокий, NAME##7##{=Document:TITLE}; Тип условия — 2.
Выбор элементов с детальным текстом, содержащим ссылку на текущий бизнес-процесс	Параметры поиска — DETAIL_TEXT##7##{=Workflow:ID}; Тип условия — 2; Устанавливать текст статуса — да; Текст статуса — Найдено {=System:Date}.

Сценарий работы активити робота

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

• Соответствует условиям;
• Количество найденных элементов;
• Массив ID найденных элементов;
• Строка с ID найденных элементов через запятую;
• Первый ID из результатов;
• Последний ID из результатов;

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

Изменение элемента списка

Данное активити позволяет добавлять элементы списка.

Сценарий работы активити бизнес-процесса

В каком списке меняем элемент: в этом поле нужно выбрать из выпадающего списка, список в котором будет изменен элемент.

Если список добавлен после установки данного активити, то он не будет отображен в выпадающем списке.

ID элемента: в этом поле указывается ID элемента, который нужно изменить.

Какое поле меняется: в этом поле указывается код поля и его значение через решетку (код поля##новое значение)
Пример: KovroviyGazon##321.

Чтобы все верно заполнить, нужно:

• Знать код поля которое планируется изменить в элементе (его можно посмотреть в настройках полей)
  
• Получить значение(я) поля. Пример получения значения приведен на скриншоте ниже, на примере поля тип "Список". (Если смотреть значение поля в настройках полей, то в пункте 4, нужно выбирать значение в LIST [код] [value]) 

Если вы решили добавить в список файл через переменную тип "файл", то добавить можно только один файл за раз.

Делать отладочные сообщения в журнал БП:варианты да/нет.

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

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Добавление элемента списка

Данное активити позволяет добавлять элементы списка.

Сценарий работы активити бизнес-процесса

В каком списке добавляем элемент: в этом поле нужно выбрать из выпадающего списка, список в который будет добавлен новый элемент.

Если список добавлен после установки данного активити, то он не будет отображен в списке.

Название элемента (NAME): в этом поле указываем название добавляемого элемента.

Поле нового элемента списка: при заполнении этого пункта, новое поле не создается, а добавляется в созданный элемент, это значит, что поле, которое Вы указываете должно быть уже создано.
Заполняется поле так: код поля##новое значение. Пример: KovroviyGazon##321
Чтобы все верно заполнить, нужно:

• Знать код поля которое планируется добавить в элемент (его можно посмотреть в настройках полей)
  
• Получить значение(я) поля. Пример получения значения приведен на скриншоте ниже, на примере поля тип "Список". (Если смотреть значение поля в настройках полей, то в пункте 4, нужно выбирать значение в LIST [код] [value]) 

Если вы решили добавить в список файл через переменную тип "файл", то добавить можно только один файл за раз.

Делать отладочные сообщения в журнал БП:варианты да/нет.

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

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- ID нового элемента списка.

Удаление элемента списка

Данное активити позволяет удалять элементы списка, указав где расположен удаляемый элемент и указав его ID.

Сценарий работы активити бизнес-процесса

Где искать элемент: из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находиться.

ВАЖНО!
Если список создан после установки активити, то его не будет в выпадающем списке, для того, чтобы он появился, нужно переустановить активити. Это происходит из-за того, что активити получает перечень списков в момент установки.

ID группы: в этом поле указывается ID группы в которой находится удаляемый список.

ID списка: в этом поле нужно указать ID списка, который расположен в указанной выше группе.

ID удаляемого элемента: в этом поле указывается ID удаляемого элемента списка.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Соответствует условиям.
- ID элемента списка.
- Сообщение об ошибке.

Счета (старые)

Редактирование счета

Данное активити позволяет редактировать все поля сущности "Счет", включая пользовательские.

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
ID счета:	В данном поле указывается ID счета, который необходимо редактировать.
Номер:	В данном поле указывается номер редактируемого счета.
Комментарий:	В данном поле указывается комментарий менеджера.
Дата выставления:	В данном поле указывается дата выставления счета.
Дата создания:	В данном поле указывается дата создания счета.
Дата комментария к статусу:	В данном поле указывается дата комментария к статусу счета
Срок оплаты:	В данном пункте указывается до какой даты необходимо оплатить счет.
Тема:	В данном поле указывается тема выставленного счета.
Печатная форма счёта:	В данном поле указывается идентификатор печатной формы счета. (printable)
Дата оплаты:	В данном поле указываются дата оплаты счета. Дата указывается в формате Битрикс: 2019-07-30T03:00:00+03:00 (Год - месяц - дата - время + часовой пояс)
Номер документа оплаты:	В данном поле указывается номер документа оплаты.
Тип плательщика:	В данном поле указывается ID типа плательщика. ID плательщика, это ID платежной системы.  ID берется из списка плательщиков.
Комментарий к статусу:	В данном поле указываются комментарии к статусу.
Ответственный:	В данном поле указывается ID ответственного.
Статус:	В данном поле из выпадающего меню выбирается подходящий статус счета.
UF_COMPANY_ID:	В данном поле указывается ID компании, которой выставлен счет. Указывается, если плательщик Юридическое лицо
UF_CONTACT_ID:	В данном поле указывается ID плательщика, если тот является Физическим лицом, либо в виде контакта компании.
UF_MYCOMPANY_ID:	В данном поле указывается ID фирмы, которая выставляет счет.
UF_DEAL_ID:	В данном поле указывается идентификатор связанной сделки.
UF_QUOTE_ID:	В данном поле указывается идентификатор связанного коммерческого предложения.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), сам счет является элементом смарт-процесса, т.е для редактирования элемента используйте соответствующее активити из категории "Смарт-процессы".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логик.

Возвращаемые параметры данного активити:
- Сообщение об ошибке.
- Успех редактирования.
- Таймаут операции.

Получение статуса счета

Данное активити позволяет следить за любым статусом счета если вы знаете его id. Результатом его работы является возвращение статуса счета в виде одной латинской буквы через дополнительные результаты.

Сценарий работы активити бизнес-процесса

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

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), так же у смарт-процессов нет статусов, но есть направления, т.е для получения направления смарт-процесса используйте соответствующее активити из категории "Смарт-процессы".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
Возвращаемыми параметрами будут статус счета, которому присвоено значение. Эти значения будут уникальны для каждого портала.
Это значение можно узнать, установив активити "Слежение за статусом счета", нажав F12 и выбрав "просмотр элементов" в пункте, где можно выбрать подходящий статус счета.
Должен появится выделенный пункт с HTML-кодом "select-id", если нажать радом с ним стрелку, то появится список статусов и присвоенные для них значения.

Создание счета

Данное активити создаёт сущность Счет на основании Сделки из которой оно запускается. Если в Сделке правильно указаны все реквизиты контрагента, то они все будут перенесены в созданный счет. Так же активити позволяет возвращать динамическую ссылку на счет, чтобы Вы могли её отправить клиенту в письме из бизнес-процесса.

Название	Описание
Префикс для номера счёта:	позволяет указать префикс для счета.
Использовать номерацию Битрикс24:	позволяет выбрать,будет ли использована нумерация Б24 или нет.
Принудительно выставлять счет только на:	данное поле позволяет принудительно выставлять счет только на Компанию либо на контакт. При работе с данным полем есть ньюансы: Если выбрать "Не важно", то при наличии Компании и Контакта, счет выставляется на Компанию и привязывается Контакт. Если выбрать "Компания", то счет будет выставлен на Компанию без привязки Контакта, даже если он есть в сделке.
Ответственный за счет:	в данном поле можно указать ответственного за созданный счет. Если данное поле не заполнить, то ответственный будет взят из настроек поля "Запускать от имени".
Статус счета:	в данном поле из выпадающего меню выбирается подходящий статус счета.
Срок оплаты в днях:	в данном пункте указывается срок оплаты счета в днях.
ID компании продавца:	в данном пункте указывается ID компании-продавца .
ID реквизита организации продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита организации продавца.
ID банковского реквизита продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID банковского реквизита продавца.
ID способа оплаты из настроек CRM (для контакта): (Это поле обязательно к заполнению)	в данном пункте указывается ID способа оплаты из настроек CRM для контакта. Из-за ошибки в переводе со стороны Б24, это поле отвечает за вывод печатной формы счета для контакта.
ID способа оплаты из настроек CRM (для компании): (Это поле обязательно к заполнению)	в данном пункте указывается ID способа оплаты из настроек CRM для компании. Из-за ошибки в переводе со стороны Б24, это поле отвечает за вывод печатной формы счета для компании.
ID реквизита покупателя (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита покупателя. Если данное поле заполнено, то реквизиты будут браться не автоматически из контакта или компании, а именно из этого поля.
Создавать реквизит для физ. лица (если пустой):	в данном пункте указывается, создавать ли реквизиты для физического лица.
Какой тип реквизита создавать:	в данном поле указывается какой тип реквизита создавать из выпадающего меню.
ID пресета ИП для физ. лица (если не указан, будет искаться с именем "ИП"):	в данном поле указывается ID пресета ИП для физ. лица
ID пресета для физ. лица (шаблон для реквизитов):	в данном поле указывается ID пресета(шаблона) для физ. лица
Ставка НДС:	позволяет выбрать из выпадающего списка ставку НДС.
Принудительно выставлять НДС:	позволяет принудительно выставить НДС, выбрав нужный параметр из выпадающего меню.

Данное активити создает счета "старого" типа. Новый тип счетов относится к смарт-процессам.
Т.е для создания счета нового типа, нужно использовать соответствующее активити и в смарт-процессе с ID_31 (данный смарт-процесс скрыт, однако он отвечает за создание новых счетов) создать элемент смарт-процесса.

Если Вы хотите создать счет для физ. лица, у которого нет реквизитов, то следующие поля обязательны к заполнению:

• Статус счета;
  
• Срок оплаты в днях;
  
• ID компании продавца;
  
• ID реквизита организации продавца (если реквизитов несколько, то и поле "ID банковского реквизита продавца);
  
• ID способа оплаты из настроек CRM (для контакта. печатная форма);
  
• Создавать реквизит для физ. лица (если пустой);
  
• Какой тип реквизита создавать.
• ID пресета для физ. лица (Настройки CRM-->С чего начать-->Шаблоны реквизитов)
  

Предустановленные товары (ID##количество##ед. измерения##цена):  позволяет добавить в счет товары из каталога. 

Если Вам нужно добавить товар из каталога, но при этом его название в счете должно быть отличным от каталожного, то после указания цены нужно добавить ## и указать нужное название товара. Это не изменит название товара в каталоге, но в конкретно созданном счете оно будет другим.  
Пример:Название товара по каталогу "Продление интернета_50Мбит" , в счете нужно назвать Продление интернета_50Мбит для ООО "КаршерингMSK".
Заполняем так: 1684##1##шт##35000##Продление интернета_50Мбит для ООО "КаршерингMSK" 

Название	Описание
Выставить счёт на остаток товаров в сделке:	позволяет выставить счет на разницу товаров указанных в сделке и товаров, которые уже имеются в счетах, при условии, что количество товаров и суммы в счетах не будут превышать аналогичные значения в сделке. Т.е если есть счет, где к примеру продано 5 авто и 4 сникерса, а новый счет выставляется с количеством 7 авто и 4 сникерсами, то активировав данную настройку, в новом счете будет 2 авто, а сникерсы в счет не попадут.
Частичная оплата (в процентах, по-умолчанию 100):	в данном пункте указывается процентная составляющая предоплаты.
Фиксированная сумма предоплаты:	позволяет указать фиксированную сумму предоплаты.
Сократить сумму за счет:	в данном поле можно выбрать за счет чего будет сокращена сумма за счет.
Округлять до целых (при расчете частичной оплаты):	в данном пункте указывается, округлять ли до целых чисел, при расчете частичной оплаты.
Комментарий к счёту (скрытый для покупателя):	позволяет добавить комментарий к счету, который будете видеть только Вы.
Делать отладочные сообщения в журнал БП:	позволяет выводить отладочные сообщения в журнал БП.

Если Сделка создана с компанией у которой нет реквизитов, то счет не выставится даже когда они будут добавлены в компанию, т.к. реквизиты привязываются к сделке.
Решение - перевыбрать компанию в Сделке.

Если вы столкнулись с такой ошибкой при выполнении активити: во время создания счета была обнаружена ошибка: Не введено значение обязательного поля "Печатная форма счёта", нужно заполнять поле "ID способа оплаты из настроек CRM (для компании)".
ID этого способа можно посмотреть в настройках способов оплаты вашего портала.

Возможности:

1. Счёт создаётся автоматически нашим активити.
2. При создании отдаёт ссылку для отправки на почту, поэтому можно в БП это сразу организовать.
3. Счет отслеживает нумерацию и может её сам устанавливать в рамках нескольких юр. лиц (Префиксы допускаются) Нумерация в рамках 1 года, т.е. с первого января другого года будут опять с нуля.
4. Есть возможность автоматически дробить счет на части (предоплата несколькими счетами)
5. Есть возможность отслеживать статус оплаты счета или любой другой статус.
6. Есть возможность выбирать разные платёжные реквизиты плательщика (в одной компании несколько юр. лиц)
7. Есть возможность выставлять счета от разных юр. лиц.
8. Есть возможность автоматически создавать реквизиты для физ. лиц, чтобы можно было выстроить грамотный обмен с 1С.

Обратите внимание на данную схему.
Она отображает все возможные сценарии, которые вам следует учитывать при проектировании бизнес-процесса в Битрикс24, т.к. каждая ветка является отдельным сценарием и его придётся выделять в бизнес-процессе.

Описание полей:

ID компании продавца: в данном поле необходимо указать ID Вашего юридического лица от которого будет выставляться счёт. Для того, чтобы узнать какое число необходимо вписывать это поле, следует перейти в CRM > НАСТРОЙКИ > РЕКВИЗИТЫ ВАШИХ КОМПАНИЙ

В этом списке следует выбрать необходимую Вам компанию и посмотреть её id. Если Вы не видите данное поле, то настройте в шестерёнке его (ID) отображение.

Обращаем Ваше внимание на то, что в созданной вами компании от которой вы собираетесь выставлять счета, должен быть только 1 набор реквизитов (ИНН, КПП и так далее). Если Вы не заполните реквизиты, то счет будет создаваться с пустыми графами.

Для создания реквизитов следует зайти внутрь компании и добавить реквизиты.

 

ID реквизита организации продавца (если не указан, берется 1-й из списка):  в данном поле следует указать id набора реквизитов компании-продавца. Бывают такие случаи, что у одной Вашей компании могут быть несколько реквизитов. Если поле не заполнено, то приложение выберет первый попавшийся из списка реквизитов.

К сожалению, в новой карточке не выводится ID реквизитов и Вам потребуется переключится на отображение старой карточки CRM, чтобы уточнить ID реквизитов. CRM > НАСТРОЙКИ > ДРУГИЕ > ОБЩЕЕ > ВКЛЮЧИТЬ НОВУЮ КАРТОЧКУ CRM - НЕТ

Потом вы возвращаетесь к CRM > НАСТРОЙКИ > РЕКВИЗИТЫ ВАШИХ КОМПАНИЙ 

На вкладке "Реквизиты" Вы можете увидеть ID реквизита. Если вы не видите данного поля, то в настройках заголовка следует его отобразить. 

ID банковского реквизита продавца: в данном поле следует указывать ID банковских реквизитов продавца. Бывают случаи, когда у одной компании с одним набором реквизитов существует несколько наборов банковских реквизитов (открыты счета в разных банках и их требуется указывать в счетах на оплату).

Для получения ID банковского реквизита вам необходимо открыть реквизиты компании и нажать F12 в браузере. Появится для отладки и просмотра кода. В данной панели есть режим, который позволяет выбирать графический элемент, чтобы увидеть код этого элемента. Посмотрите на картинку ниже.  

Вы нажимаете на значок выбора элемента и потом указываете на поле "Названия банка". Внизу появится код элемента. Вам нужен будет код типа BANK_DETAILS[n0] ... цифра в квадратных скобках будет тем самым ID. Его нужно использовать без буквы N. 

Для корректного создания счета, вы должны учитывать следующие моменты:
1. Для сущности Контакт реквизиты нужны из-за коллизий при обмене с 1С, и счет мы можем выставлять только с реквизитами.
2. Для сущности Компания реквизиты нужны в обязательном порядке!
3. Тип сущности покупателя должен совпадать с типом платёжной системы, т.е. если покупатель контакт, то и тип платёжной системы должен быть для контакта.
4. Смотрите результат запуска создания счёта в журнале бизнес-процесса. Там будут отображаться все шаги и вы сможете увидеть ошибку, если счёт не создался.

Реквизиты создаются по следующей логике:

• Если в сущности Сделка выбрана Компания, то реквизиты будут браться только из компании.
  
• Если в сущности Сделка выбран Контакт, то реквизиты будут браться только из Контакт.
• Если в сущности Сделка выбраны и Контакт и Компания, то реквизиты будут браться только из Компании.

ID реквизита покупателя: в данном поле следует указать id набора реквизитов покупателя. Бывают такие случаи, что у покупателя могут быть несколько реквизитов. Если поле не заполнено, то приложение выберет первый попавшийся из списка реквизитов. В описании поля ID реквизита продавцам (выше в данной инструкции) вы можете найти информацию как можно найти значение.

Если поле ID реквизита покупателя заполнено, то реквизиты будут браться не автоматически из контакта или компании, а именно из этого поля.

Создавать реквизит для физ. лица: эта опция необходима когда у Вас имеется обмен Битрикс24 и 1С конфигурации, которая не поддерживает сопоставление по e-mail. Если Вы установите "Да", то при создании счёта для физического лица система проверит наличие реквизитов. Если она их не найдёт, то создаст новый набор реквизитов тип ИП и автоматически проставит ИНН 000000000001 или очередной. Для каждого физ. лица будет присвоен ИНН и это позволит Вам сопоставлять клиента в двух системах.

ID пресета для физ. лица (если не указан, будет искаться с именем "ИП"): данная опция позволяет выбрать id типа набора реквизитов. Если Вы не трогали настройка типов реквизитов, то можете оставить эту опцию. Если Вы меняли название типов реквизитов, то вам необходимо зайти в настройки Битрикс24 и посмотреть ID типа реквизитов ИП.  CRM > НАСТРОЙКИ > ШАБЛОНЫ РЕКВИЗИТОВ

Тип реквизита Компании/Контакта "по умолчанию" для каждого типа сущности можно настроить отдельно.
Т.е если у вас в Сделке есть Компания или Контакт, у которого по умолчанию выбраны реквизиты для ИП, то при переходе в карточку Контакта или Компании вы можете обнаружить, что там по умолчанию указан другой тип реквизитов.
При выставлении счета из Сделки будет браться именно тот тип реквизита, который выбран по умолчанию в Сделке.
Стоит учитывать этот момент при выставлении счетов, т.к при срабатывании БП это может вызывать ошибку.

ID способа оплаты из настроек CRM: в данном поле необходимо указать способ оплаты. Для того, чтобы узнать какое число необходимо вписывать сюда, следует перейти: "CRM > НАСТРОЙКИ > СПОСОБЫ ОПЛАТЫ

В данном списке следует выбрать обработчик способа оплаты, который вы хотите использовать в счете. В способах оплаты указываются данные по ответственным лица, которые будут подписывать счет. Там же загружается бланк с фоном счета и картинка с печатями и подписями.

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

Срок оплаты в днях: в данном поле можно установить количество дней для оплаты счета.

Тип плательщика: в данном поле вы выбираете тип плательщика (юр. лицо или физическое). Это требуется для того, чтобы бланк правильно сформировался, т.к. есть внутренние требования системы и когда вы выбираете физ. лицо, то плательщиком будет на название компании, а ФИО вашего клиента. Это нужно учитывать при создании бизнес-процесса.  

Частичная оплата (в процентах, по-умолчанию 100): это поле позволит Вам делить количество позиций, указанных в счете. Например, у вас в рамках сделки выставляется два счета по 50% (предоплата и окончательная оплата). В данном поле Вы устанавливаете 50 и при создании счета количество всех позиций будет поделено на 2. При этом сами позиции останутся такими, как вы укажите в сделке. Сумма и налоги пересчитаются автоматически исходя из нового количества.

Округлять до целых (при расчете частичной оплаты): в данном поле можно установить округление количества в позициях сделки если выбрали не 100%, а меньшее значение, Например, в одной из позиций сделки у Вас указано количество 3. При делении получится значение 1,5. Эта опция позволит округлить полученное число до целого значения.

ID реквизита плательщика (если не указан, берется 1-й из списка): в данном поле вы можете указать какие выбрать реквизиты клиента для выставления счета. Не редко бывают случаи, когда в рамках одной компании бывают несколько юридических лиц, которые вам могут оплатить. Если в Сделке выбран один набор из множества реквизитов, то он автоматически будет использован нами при создании счета.

Если вы будете использовать наши процессы из примера, то следует учитывать следующие моменты:
1. Вы можете скачать готовый бизнес-процесс, который требуется импортировать в ваш портал.
2. При импортировании затрётся ваш процесс, в который вы будете грузить пример.
3. При импорте в вашем портале будут созданы все поля, которые участвуют в нашем примере сущности Сделка. Вам необходимо будет сделать их отображаемыми в карточке Сделки.
4. Перед импортом необходимо установить наше приложение и в его настройках установить активити "Создание Счета" и "Слежение за статусом счета"
5. Особенностью Битрикс24 (при импорте сторонних бизнес-процессов) является тот факт, что нужно будет проверить правильность подставленных дополнительных значений в местах:
- во всех элементах изменение документа (Прописываем ID счета) - нужно прописать значение из доп. результатов - Создание Счета - ID Созданного Счета
- во всех элементах изменение переменных (Прописываем значение) - нужно прописать значение из доп. результатов - Получение статуса счета - Статус счета
- во всех элементах отправки писем.

Кейс № 1 - Простое создание Счёта

Давайте рассмотрим пример в котором мы просто создаём Счёт от одной организации автоматически с помощью нашего приложения. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

В данном бизнес-процессе рассматривается модель создания счета без наличия проверки его оплаты. Такой сценарий подходит в тех случаях, когда сотрудники компании вручную присваивают счетам оплату и можно настроить робот в автоматизации, который переведёт стадию сделки после получения оплаты счета. Бизнес-процесс проверяет наличие компании в Сделке и если он её не обнаруживает, то автоматически выставляет счет контакту.

В этой схеме мы заложили проверку на зависание приложения, чтобы ответственный за сделку смог вовремя вмешаться в процесс. Так же в процесс добавлена проверка на повторное создание счета, чтобы не делать дубликатов.  

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 1

Кейс № 2 - Простое создание Счёта и слежение за оплатой

Давайте рассмотрим пример, в котором мы создаём Счёт от одной организации автоматически с помощью нашего приложения и начинаем следить за его статусом. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

В данном бизнес-процессе рассматривается модель создания счета с наличием проверки его оплаты. При обмене данными с 1С конфигурациями, робот в Битрикс24 не получает сведений от системы, что счет был оплачен и Вы не можете ничего делать. Наше активити "Слежение за статусом счета" решает данный вопрос простым методом. Оно (активити) обращается через наш сервер к вашему порталу и опрашивает конкретный счет на предмет оплаты. Если говорить конкретнее, то оно может не только отслеживать оплату, а любой статус счета.

Мы не рекомендуем делать проверку статуса счета чаще чем 1 раз в час, т.к. вы будете создавать большую нагрузку на сервера 1С-Битрикс и наш сервер, а это неминуемо приведёт к блокировке вашего портала.

В рамках данного кейса рассматривается вариант при котором проверяется создавался ли ранее счет или нет. Если бизнес-процесс обнаруживает, что ранее он создавался, то автоматически запускается механизм проверки его статуса. Это позволяет огородить вас от дубликатов счетов, которые возникают по причине ошибок персонала.

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 2

Кейс № 3 - Создание Счета со слежением и отправкой на почту клиенту

Давайте рассмотрим пример, в котором мы создаём Счёт от одной организации автоматически с помощью нашего приложения, отправляем его клиенту и начинаем следить за его статусом. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

В данном бизнес-процессе появляются дополнительные проверки и поля, которые необходимы для нормальной работы всего процесса. Самое главное в автоматических алгоритмах - это не создавать неприятностей для ваших клиентов из-за своей беспечности, поэтому приходится проверять логику процесса несколько раз, чтобы убедиться в правильности выбранного пути. Мы дополнительно вынесли e-mail адрес для отправки писем, чтобы можно было точно его указать, т.к. в раках компании или контакта может быть куча адресов и какой из них правильный знает только менеджер, а машина может ошибиться. 

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

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 3

Кейс № 4 - Создание Счёта от нескольких ваших организаций.

Давайте рассмотрим пример в котором мы создаём Счёт от разных ваших компаний в зависимости от условий оплаты (компания с НДС и без НДС). Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

В данном бизнес-процессе создаются две альтернативные ветки каждая из которых соответствует своей компании со своими реквизитами и платёжной системой, которые вы предварительно должны настроить. Особенностью такой схемы является то, что в рамках нашего активити присваивается своя нумерация для счетов. Для полноценного запуска вам необходимо будет создать в системе два счета (для каждой вашей компании отдельно) с каким-то номером (можно с префиксом) и при запуске наше активити начнёт считать очередной номер начиная с того, который будет указан в вашем счете. Это особенно актуально, когда вы вели до этого момента оформление счетов в других программах и нумерация у вас есть. Возьмите из программы, в которой оформлялись счета крайний номер и создайте пустой счет с этим номером.

Если мы говорим про 1С-конфигурации, то важно использовать и префиксы, чтобы при выгрузке документов номер назначался такой, какой необходимо. Если в 1С ведётся работа по нескольким организациям и счета грузятся из Битрикс24, то нужно учитывать следующее:

1. Счета будут выгружаться с номерами и префиксами.

2. При проведении документа в 1С номер будет затираться на тот, который 1С считает очередным для проведённых документов.

3. Все счета нужно будет создавать ТОЛЬКО! в Битрикс24 если Вы не хотите, чтобы нумерация у Вас сбилась.

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 4

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логик

Возвращаемые параметры для данного активити:
- ID созданного счета.
- Номер созданного счета.
- Публичная ссылка на созданного счета.
- ID нового реквизита.
- Сообщение об ошибке.

Слежение за статусом счета

Данное активити позволяет следить за любым статусом счета если вы знаете его id. Результатом его работы является возвращение статуса счета в виде одной латинской буквы через дополнительные результаты.

Сценарий работы активити бизнес-процесса

ID счета (условие): в данном поле указывается ID статуса счета, за которым необходимо проследить.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), так же у смарт-процессов нет статусов, но есть направления по этому используйте соответствующее активити из категории "Смарт-процессы" --> "Мониторинг событий элементов СП".

Подходящий статус счета (условие): выбор из выпадающего списка подходящего статуса счета.

ВАЖНО!
Период слежения длится в течении  одного месяца, после чего останавливается.
Это связанно с тем, что забивается база данных сведениями, которые не востребованы, что ведет за собой ухудшение быстродействия приложения в целом. 

Количество запросов зависит от общего количества счетов в системе т.к. "слежение" получает ВСЕ обновления ВСЕХ счетов, даже тех, результат обновления которых нас не интересует.

Пример:
БП создал один счёт и следит за его статусом, а в ручную создали 1000 счетов и за ними никто не следит.
В таком случае события будут приходить по 1001 счету, т.е по любому изменению любого счета. Т.е количество запросов зависит от таких изменений.
Как только вы получаете нужное событие, "слежение" срабатывает и мы перестаем получать эти запросы.

Сообщение об ошибке:да/нет.
Позволяет выводить ошибки в журнал БП.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

ВАЖНО!
Данное поле на данный момент не доступно для корректировки.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
Возвращаемыми параметрами будут статус счета, которому присвоено значение. Эти значения будут уникальны для каждого портала. Это значение можно узнать, выбрав "просмотр элементов" в пункте, где можно выбрать подходящий статус счета.
Должен появится выделенный пункт с HTML-кодом "select-id", если нажать радом с ним стрелку,то появится список статусов и присвоенные для них значения.

Получение данных по сущности счет

Данное активити получает все возможные данные из полей Счета (включая пользовательские), для того, чтобы их можно было использовать в рамках бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID сущности: в данном поле указывается ID сущности "Счет", из которой планируется получить все данные. 

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), а сам счет является элементом смарт-процесса. Для получения данных по элементу смарт-процесса используйте соответствующее активити из категории "Смарт-процессы".

Для печати: выводит данные в доступном для печати виде.

Ссылка на счет: варианты да/нет.
Указав "Да", активити выведет в возвращаемых параметрах ссылку на необходимый счет.

Сообщение об ошибке: да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы активити бизнес-процесса

Возвращаемые параметры для данного активити:
- Все параметры из сущности "Счет" 

Поиск счетов в сделке по статусу

Данное активити ищет в сделке все счета у которых нет статуса "Оплачено" или у них статус указан в параметрах.
Результатом работы является получение списка ID счетов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сценарий работы активити бизнес-процесса

ID Сделки (обязательное): в данном пункте указывается ID сделки, в которой будет осуществлен поиск счета.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Данное активити работает только со "старым" типом счетов. Новый тип счетов относится к смарт-процессам (ID_31), а сами счета являются элементами этого смарт-процесса. Для поиска элементов смарт-процесса используйте соответствующее активити из категории "Смарт-процессы".

Статус счета: в данном поле указывается статус искомого счета.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры данного активити:
- Найденные счета;
- Найденные счета (массив для итератора);
- Сообщение об ошибке.

Удаление счета

Данное активити позволяет удалить сущность "Счет", указав её ID.

Сценарий работы активити бизнес-процесса

ID счета: в данном поле нужно указать ID удаляемого счета.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), т.е для удаления элемента смарт-процесса используйте соответствующее активити из категории "Смарт процессы".

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат выполнения (Y/N).
- Сообщение об ошибке.
- Таймаут операции.

Поиск счетов

Данное активити позволяет осуществлять поиск счетов по выбранным параметрам.
Результатом работы является получение списка ID счетов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сценарий работы активити бизнес-процесса

Название	Описание
Номер:	В данном поле указывается номер искомого счета.
Валюта:	В данном пункте указывается валюта, указанная в искомом счете.
Дата создания:	В данном поле указывается дата создания, искомого счета.
Дата комментария к статусу:	В данном поле указывается дата комментария к статусу.
Дата оплаты:	В данном поле указывается дата оплаты искомого счета.
Дата изменения статуса:	В данном поле указывается дата изменения статуса искомого счета.
Дата изменения:	В данном поле указывается дата изменения искомого счета.
Кем создан:	В данном пункте указывается кем создан искомый счет.
Кто изменил поле оплаты:	В данном поле указывается кто изменил поле оплаты.
Кто изменил статус:	В данном поле указывается кто изменил статус искомого счета.
ID:	В данном пункте указывается ID искомого счета.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), т.е для поиска счета, который является элементом смарт-процесса, используйте соответствующее активити из категории "Смарт процессы".

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы активити бизнес-процесса

Возвращаемые параметры для данного активити:
- Массив для итератора;
- Результат поиска (строка);
- Количество найденных элементов;
- Соответствует условиям;
- Сообщение об ошибке.

Перезаполнение товаров счета

Данное активити позволяет автоматически перезаполнять товары в Счёте при изменении Сделки. Это позволяет облегчать работу менеджерам. Особенно актуально, когда в счетах более 10 позиций.

Сценарий работы бизнес-процесса

ID Счёта: в данном пункте указывается ID счета, который планируется перезаполнять.

Данное активити работает только со "старыми" счетами, а новый тип счетов относится к смарт-процессам, и счета в нем являются элементами смарт-процесса. Т.е для работы с элементами смарт-процесса "счет" (его ID_31), нужно использовать соответствующее активити из категории "Смарт-процессы".

ID Сделки (Если ID счета не задано): в данном пункте указывается ID сделки к которой привязан счет. Если указан ID счета, то ID сделки не обязателен к заполнению.

Не менять Счёт в статусе: позволяет выбрать из выпадающего списка статус, при котором счет не будет изменен.

Принудительно выставлять НДС: позволяет выбрать из выпадающего списка будет ли НДС добавлен в стоимость или поверх счета.

Ставка налога: позволяет выбрать из выпадающего списка, ставку налога.

Предустановленные товары (ID##количество##ед. измерения##цена): в данном пункте добавляются товары, которые ранее были предустановлены.

Поле "Предустановленные товары" нужно для того, чтобы добавлять дополнительные товары в счет помимо тех, что уже есть в сделке. Т.е если у вас в сделке есть некий товар "Чашка" и выставлен счет на эту чашку, то указав в поле "Предустановленные товары"  товар "доставка", этот товар будет дополнительно добавлен в счет и в счете будет уже 2 товара.
Если Вам не нужно добавлять дополнительный товар в счет, то это поле нужно оставить пустым.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Счета (новые)

Создать новый счет(новый)

Данное активити позволяет создавать новые элементы внутри смарт-процесса тип "счет".
Созданные этим активити элементы будут являться "счетами" и отобразятся в сущности, во вкладке "Счета".

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса: в этом поле указывается ID типа смарт-процесса в котором будет создан элемент (смарт-счет).
Для смарт-процессов тип "счет" этот ID всегда 31.

Тип реквизита Компании/Контакта "по умолчанию" для каждого типа сущности можно настроить отдельно.
Т.е если у вас в Сделке есть Компания или Контакт, у которого по умолчанию выбраны реквизиты для ИП, то при переходе в карточку Контакта или Компании вы можете обнаружить, что там по умолчанию указан другой тип реквизитов.
При выставлении счета из Сделки будет браться именно тот тип реквизита, который выбран по умолчанию в Сделке.
Стоит учитывать этот момент при выставлении счетов, т.к при срабатывании БП это может вызывать ошибку.

Направление: это поле доступно только при первичной настройке и позволяет указать направление, к которому относятся элементы смарт-процесса с которыми планируется работать.

Название	Описание
ID сделки:	в данном поле указывается ID сделки, к которой будет привязан созданный счет.
Ответственный за счет:	в этом поле нужно указать ID сотрудника, который будет ответственен за созданный счет
Количество платежей, на которое разделить сумму сделки:	в данном поле цифрой указывается количество платежей на которое можно разделить сумму сделки. При активации данной настройки (заполнение поля), нужно учитывать, что разделение работает ТОЛЬКО тогда, когда товарная позиция в счете 1 и количество этого товара тоже равно 1. Если позиций товара или его количество будет более 1, то приложение выдаст ошибку с уведомлением.
Принудительно выставлять счет только на:	данное поле позволяет принудительно выставлять счет только на Компанию либо на контакт. При работе с данным полем есть нюансы:  Если выбрать "Не важно", то при наличии Компании и Контакта, счет выставляется на Компанию и привязывается Контакт. Если выбрать "Компания", то счет будет выставлен на Компанию без привязки Контакта, даже если он есть в сделке.
Статус счета:	в этом поле из выпадающего списка нужно выбрать статус, в котором будет находиться счет при создании.
Срок оплаты в днях:	в данном пункте указывается срок оплаты счета в днях.
ID компании продавца:	в данном пункте указывается ID компании-продавца.
ID реквизита организации продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита организации продавца.
ID банковского реквизита продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID банковского реквизита продавца.
ID способа оплаты из настроек CRM (для контакта. Печатная форма):	в данном пункте указывается ID способа оплаты из настроек CRM для контакта.
ID способа оплаты из настроек CRM (для компании. Печатная форма):	в данном пункте указывается ID способа оплаты из настроек CRM для компании.
ID реквизита покупателя (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита покупателя. Если данное поле заполнено, то реквизиты будут браться не автоматически из контакта или компании, а именно из этого поля.
Создавать реквизит для физ. лица (если пустой):	варианты да/нет. в данном пункте указывается, создавать ли реквизиты для физического лица или нет. Если Вы хотите создать счет для физ. лица, у которого нет реквизитов, то следующие поля обязательны к заполнению: Статус счета; Срок оплаты в днях; ID компании продавца; ID реквизита организации продавца (если реквизитов несколько, то и поле "ID банковского реквизита продавца); ID способа оплаты из настроек CRM (для контакта. печатная форма); Создавать реквизит для физ. лица (если пустой); Какой тип реквизита создавать. ID пресета для физ. лица (Настройки CRM-->С чего начать-->Шаблоны реквизитов)
Какой тип реквизита создавать:	в данном поле нужно выбрать тип реквизита, который нужно создавать, Физ. лицо или ИП.
ID пресета ИП для физ. лица (если не указан, будет искаться с именем "ИП"):	в данном поле указывается ID пресета ИП для физ. лица.
ID пресета для физ. лица:	в данном поле указывается ID пресета(шаблона) для физ. лица.
Ставка НДС:	в данном поле нужно выбрать из выпадающего списка ставку НДС, которая будет применяться при выставлении счета. Сами ставки настраиваются в настройках CRM в пункте "налоги".
Принудительно выставлять НДС:	позволяет принудительно выставить НДС, выбрав нужный параметр из выпадающего меню.
Предустановленные товары (ID##количество##ед. измерения (буквами)##цена):	позволяет добавить в счет товары из каталога. Если Вам нужно добавить товар из каталога, но при этом его название в счете должно быть отличным от каталожного, то после указания цены нужно добавить ## и указать нужное название товара. Это не изменит название товара в каталоге, но в конкретно созданном счете оно будет другим.   Пример:  Название товара по каталогу "Продление интернета_50Мбит" , в счете нужно назвать Продление интернета_50Мбит для ООО "КаршерингMSK" Заполняем так: 1684##1##шт##35000##Продление интернета_50Мбит для ООО "КаршерингMSK"
Выставить счёт на остаток товаров в сделке:	варианты да/нет. Позволяет выставить счет на разницу товаров указанных в сделке и товаров, которые уже имеются в счетах, при условии, что количество товаров и суммы в счетах не будут превышать аналогичные значения в сделке. Т.е если есть счет, где к примеру продано 5 авто и 4 сникерса, а новый счет выставляется с количеством 7 авто и 4 сникерсами, то активировав данную настройку, в новом счете будет 2 авто, а сникерсы в счет не попадут.
Частичная оплата (в процентах, по-умолчанию 100):	в данном пункте указывается процентная составляющая предоплаты.
Фиксированная сумма предоплаты:	позволяет указать фиксированную сумму предоплаты.
Сократить сумму за счет:	в данном поле можно выбрать за счет чего будет сокращена сумма за счет. Варианты: стоимость товара/количество товара.
Округлять до целых (при расчете частичной оплаты):	варианты да/нет. Позволяет указать округлять ли до целых чисел, при расчете частичной оплаты или нет.
Комментарий к счёту (скрытый для покупателя):	позволяет добавить комментарий к счету, который будете видеть только Вы.

Если Сделка создана с компанией у которой нет реквизитов, то счет не выставится даже когда они будут добавлены в компанию, т.к. реквизиты привязываются к сделке.
Решение - перевыбрать компанию в Сделке.

Если вы столкнулись с такой ошибкой при выполнении активити: во время создания счета была обнаружена ошибка: Не введено значение обязательного поля "Печатная форма счёта" , нужно заполнять поле "ID способа оплаты из настроек CRM (для компании)". ID этого способа можно посмотреть в настройках способов оплаты вашего портала.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID созданного счета.
- ID нового реквизита.
- Сообщение об ошибке.

Поиск счета(новые)

Данное активити позволяет осуществлять поиск элементов смарт-процесса тип "счет".

Сценарий работы активити бизнес-процесса

Название	Описание
Название:	в данном поле нужно указать название искомого счета.
Ответственный:	в данном поле указывается ответственный за счет, который будет искать активити.
Доступно для всех:	выпадающий список с вариантами да/нет. Позволяет указать доступен ли данный счет для всех или для конкретных пользователей.
Создано CRM-формой:	в данном поле указывается ID CRM формы (Контакт-центр->Форма на сайт), с помощью которой элемент был создан.
Поля "Дата начала" и "Дата завершения":	в этих полях указывается дата начала и завершения работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
ID компании:	в данном поле указывается ID компании с которой искомый элемент (счет) связан.
ID контакта:	в данном поле указывается ID контакта с которым искомый элемент (счет) связан.
ID связанной сделки:	в данном поле указывается ID сделки с которой искомый элемент (счет) связан.
Стадия:	в этом поле из выпадающего списка нужно выбрать стадию, на которой элемент (счет) находится.
Источник:	в данном поле указывается источник элемента. Значения берутся из одноимённого справочника CRM.
Дополнительно об источнике:	в этом поле указываются дополнительные данные об источнике.
Сумма:	в этом поле указывается общая денежная сумма по элементу.
Сумма налога:	в этом поле указывается сумма налога в денежном эквиваленте. Т.е если у Вас сумма товаров в сделке на 3000р и ставка налога составляет 10%, то сумма налога будет 10% от 3000, т.е 300р.
Валюта:	в этом поле указывается валюта, в которой выставлен счет.
Реквизиты Вашей компании:	в этом поле указывается ID реквизита Вашей компании, в которой был выставлен счет.

Для поиска счета с суммой 0, нужно в поле "Сумма" указать не 0, а ##.
Так же, стоит учитывать, что поиск по названию не поддерживает спец. символы. Т.е если в названии есть "№" или подобные символы, то активити не найдет счет с таким названием.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

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

Слежение за статусом счета(новые)

Данное активити позволяет отслеживать статус смарт счета, при условии, что известен его ID.

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса: в этом поле указывается ID типа смарт-процесса за статусом которого наблюдает активити. Для смарт процессов тип "счет" этот ID всегда 31.

Направление: это поле доступно только при первичной настройке и позволяет указать направление, к которому относятся элементы смарт процесса с которыми планируется работать.

ID счета (условие): в данном поле нужно указать ID счета, за статусом которого активити будет наблюдать.

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

Если вы добавили новый статус счета, то переустанавливать активити не обязательно. Данный статус должен самостоятельно подтянуться в список статусов.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Статус счета;
- Название статуса счета;
- ID счета;
- Сообщение об ошибке.

 

Удалить счет(новый)

Данное активити позволяет удалить элемент смарт процесса тип "счет".

Сценарий работы активити бизнес-процесса

ID счета: в данном поле нужно указать ID элемента смарт-процесса тип "счет", который нужно удалить. Этот элемент сп, по сути и является счетом.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Изменить счет(новый)

Данное активити позволяет изменить элемент смарт-процесса тип "счет".
Созданные этим активити элементы будут являться "счетами" и отобразятся в сущности, во вкладке "Счета".

Сценарий работы активити бизнес-процесса

Название	Описание
ID счета:	в этом поле нужно указать ID элемента смарт-процесса тип "счет".
Название:	в данном поле указывается название изменяемого счета.
Ответственный за счет:	в этом поле нужно указать ID сотрудника, который будет ответственен за измененный счет.
Доступно для всех:	в данном поле указывается, будет ли данный счет общедоступным или нет.
Создано CRM-формой:	в данном пункте указывается ID компании указываются специфические данные, которые можно получить при создании счет с помощью CRM-форм.
ID компании:	в этом поле указывается ID компании, на которую выставлен счет.
ID контакта:	в этом поле указывается ID контакта, на который выставлен счет.
ID связанной сделки:	в этом поле указывается ID сделки, к которой данный счет имеет отношение.
Наблюдатели:	в данном поле можно указать сотрудника, который будет наблюдателем в счете после его изменения.
Статус счета:	в этом поле из выпадающего списка нужно выбрать статус, в котором будет находиться счет после изменения.
Источник:	в этом поле можно указать идентификатор источника из соответствующего каталога
Сумма:	в этом поле нужно указать общую сумму за товары в счете.
Сумма налога:	в данном поле указывается сумма налога, в которой был создан счет, значение указывается не в процентной составляющей.
Валюта:	в данном поле указывается валюта в которой выставлен счет.
Реквизиты Вашей компании:	в этом поле нужно указать ID реквизитов компании-продавца из каталога реквизитов (CRM-> Настройки-> С чего начать-> Реквизиты ваших компаний)

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения.
- Сообщение об ошибке.

 

Получение данных по счету(новому)

Данное активити позволяет получить данные по элементу смарт-процесса тип "счет".

Сценарий работы активити бизнес-процесса

ID счета: в данном поле нужно указать ID элемента смарт-процесса тип "счет", данные которого нужно получить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Название;
- Ответственный;
- Создано CRM-формой;
- Дата начала;
- Дата завершения;
- ID компании;
- ID контакта;
- ID связанной сделки;
- Статус счета;
- Источник;
- Дополнительно об источнике;
- Сумма;
- Сумма налога;
- Валюта;
- Реквизиты Вашей компании;
- Результат выполнения;
- Сообщение об ошибке.

 

Партнерский REST

Получить список клиентов (коробка)

Информация по-данному активити будет добавлена в ближайшее время.

Получить список клиентов Б24 (облако)

Информация по-данному активити будет добавлена в ближайшее время.

Товары

Замена товара в товарной позиции

Данное активити позволяет отобразить товарные позиции сущности в виде таблицы. 

Сценарий работы активити бизнес-процесса

Тип сущности: позволяет выбрать из выпадающего списка тип сущности, в которой произойдет замена товара.

ID сущности: указывается идентификатор сущности в которой будет заменен товар.

Товар под замену:указывается ID товара, который будет заменен в сущности.

Товар на который надо заменить: указывается ID товара, который будет добавлен в сущность вместо товара, который там был до этого.

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

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов.
Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания.
Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Товарные позиции;
- ID товаров (массив);
- Сообщение об ошибке;

Перенос товаров в другую сущность

Данное активити позволяет осуществить перенос и копирование товаров из одной сущности в другую, зная ID и тип сущности из и в которую необходимо осуществить перенос.

Сценарий работы бизнес-процесса

Тип сущности (из которой берутся товары):  выбор типа сущности из которой будет осуществлен перенос товаров.

Активити работает со следующими типами товаров: Лид, Сделка, Счет, Ком. предложение, Смарт-процесс.

ID сущности (из которой берутся товары): в данном поле указывается ID сущности из которой будет осуществлен перенос товаров.

Тип сущности (куда перемещаются товары): выбор типа сущности в которую будет осуществлен перенос товаров.

ID сущности (куда перемещаются товары): в данном поле указывается ID сущности в которую будет осуществлен перенос товаров.

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

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:  в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Добавление товаров к сущности

Данное активити позволяет добавлять товары в сущности:лид, сделка, счет, предложение.

Сценарий работы бизнес-процесса

Тип сущности: в данном поле указывается в какой тип сущности будет добавлен товар.

Если вы работаете с новыми счетами, то вы должны использовать роботы из категории "смарт процессы" и ID смарт процесса всегда будет "31", именно ID, а не идентификатор типа. Данный смарт-процесс присутствует на портале, но по умолчанию скрыт в компонентах. Перейти в него можно отредактировав ссылку в браузере.

Внимание! Режим работы с заказами больше не поддерживается в Битрикс24.

• Если вы уже работаете в режиме «Сделки + Заказы», то он продолжит работать без изменений.
• При переходе в «Сделки» вернуться в режим «Сделки + Заказы», не получится.
• Информация в данной статье применима к режиму «Сделки + Заказы».

Подробнее читайте в статье Как в магазине работать без заказов.

ID сущности: в данном пункте указывается ID  сущности, в которую будет добавлен товар.

Товары (ID##количество##ед. измерения##цена##название): в данный пункт добавляют товары из предустановленного списка.
Заполняется в таком порядке и через разделители "##" : ID##количество##ед. измерения##цена##название.

Указав название отличное от того, что в каталоге, товар в сущность будет добавлен с указанным в настройках активити названием.

Что делаем с существующими товарами: в данном пункте выбирается оставить товары, которые уже были в сущности или удалить.

ВАЖНО!
Данное активити не работает с типом поля "Деньги".
Так же данным активити нельзя добавлять более 3 одинаковых товаров в рамках одного БП.

Сообщение об ошибке: в данном пункте указывается надо выводить сообщения об ошибке или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы бизнес-процесса

Возвращаемые параметры для данного активити:
Результат выполнения (good_operation): Y - удачно, N - ошибка.
Результат выполнения - текст (да/нет)

Редактирование количества и перенос товара между сущностями

Активити позволяет изменить количество товара (прибавить/вычесть), удалить совпадающие позиции, либо взять товар из одной сущности и перенести в другую. Кроме того можно добавить или удалить товар из каталога в выбранную CRM сущность.

Сценарий работы активити бизнес-процесса

Операция: этот пункт меню позволяет выбрать из выпадающего списка тип операций, который проводится с выбранным типом сущности.
Доступны варианты: 

1. Добавить товар - позволяет добавить товар параметры которого указаны в поле "Товар"; 
2. Удалить товар - позволяет удалить товар, ID которого указан в поле "Товар"; 
3. Вычесть количество от существующего товара - позволяет вычесть количество ед. товара из товарной позиции, ID которой указан в п.м "Товары".
   
   Если активна опция "Взять товары из текущей сущности", то данная операция позволяет вычитать количество товара, который есть в сущности А из количества товаров аналогичной товарной позиции в сущности Б.
   БП в таком случае должен запускаться из сущности A, а ID сущности Б должен быть указан в п.м "ID сущности".
   
4. Прибавить количество к существующему товару - позволяет прибавить количество ед. товара к товарной позиции, ID которой указан в п.м "Товары".
   
   Если активна опция "Взять товары из текущей сущности", то данная операция позволяет прибавить количество товара, который есть в сущности А к количеству товаров аналогичной товарной позиции в сущности Б.
   БП в таком случае должен запускаться из сущности A, а ID сущности Б должен быть указан в п.м "ID сущности".
   
5. Удалить совпадения товаров в сущности - работает в паре с п.м "Взять товары из текущей сущности", и позволяет уравнять количество ед. товара товарной позиции, ID которой указан в п.м "Товары".
   "Уравнивание" происходит на основе сущности из которой произошел запуск БП.

Принцип работы операций, если включена опция "Взять товары из текущей сущности":

Вычесть количество от существующего товара: А-B;
Если в п.м "Товар" указано количество товара (С), то товар будет вычтен по формуле: (А-В)-С; 

Прибавить количество к существующему товару: A+B;
Если в п.м "Товар" указано количество товара (С), то товар будет добавлен по формуле: (А+В)+С;

Удалить совпадения товаров в сущности: количество ед. товара товарной позиции в сущности Б, становится равным количеству Аналогичному товару в сущности из которой запустили БП. 

Вычитание, добавление и "Удаление совпадения" товара из других типов сущностей в смарт процесс ВОЗМОЖЕН и работает так же, как и с другим типом сущностей.

Тип сущности: позволяет выбрать из выпадающего списка тип сущности с которой будет работать активити.
Доступны варианты:

• Лид;
• Сделка;
• Счет (обычный, и смарт);
• Ком. Предложение;
• Смарт-процесс. 

Активити поддерживает перенос товаров ТОЛЬКО в рамках одного типа сущности.
Если вы хотите перенести товар из сущности одного типа в сущность другого типа, то это работать не будет.

ID сущности: указывается ID сущности с которой будут проводиться те или иные операции.

При работе с типом сущности "Смарт-процесс", содержимое поля заполняется так:  ID см.-процесса_ID элемента см.-процесса.
Пример: 182_7.

Взять товары из текущей сущности: варианты да/нет.
Активация данного п.м необходима при использовании параметров "Вычесть количество от существующего товара", "Прибавить количество к существующему товару", "Удалить совпадения товаров в сущности".

Заполнение поля "Товары" опционально, если активен п.м "Взять товары из текущей сущности", т.к товар берется из сущности, где он уже есть. 

Товары: поле предназначено для указания ID товара, а так же его количества, цены, и названия.
Указание количества, цены и названия опционально.

Поле заполняется в формате ID##количество##цена## название.
Когда требуется указать только ID товара, то в поле указывается только ID товара, без разделителя "##".
Если требуется указать ID товара и количество, то указывается ID##количество , без разделителя "##" после количества.
С ценой и названием по той же логике.

Активити работает ТОЛЬКО с товарами из каталога.
Если не указать количество товара, то по умолчанию будет прибавлена или вычтена 1 ед. товара.
Для параметра "Удалить совпадения товаров в сущности", указание единиц товара не требуется.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:

- Результат выполнения Да/Нет(Y/N).
- Сообщение об ошибке.

Получение товаров из сущности заказ

Данное активити позволяет получить ID товаров из сущности "заказ"

Сценарий работы бизнес-процесса

ID заказа: в этом поле указывается ID заказа из которого планируется получить ID товаров.

Внимание! Режим работы с заказами больше не поддерживается в Битрикс24.

• Если вы уже работаете в режиме «Сделки + Заказы», то он продолжит работать без изменений.
• При переходе в «Сделки» вернуться в режим «Сделки + Заказы», не получится.
• Информация в данной статье применима к режиму «Сделки + Заказы».

Подробнее читайте в статье Как в магазине работать без заказов.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле нужно для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это нужно для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно нужно для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат поиска (Массив для итератора); - ID товаров+ количество (Массив для итератора);
- ID товаров+ сумма (Массив для итератора);
- ID товаров+ количество+ цена (Массив для итератора);
- Всего найдено (Массив для итератора);
- Результат поиска;
- ID товаров+ количество;
- ID товаров+ количество+ цена;
- ID товаров+ сумма;
- Соответствует условиям;
- Сообщение об ошибке.

Поиск Товара (v.2)

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

Активити работает с товарами CRM, корректная работа с товарами каталога - НЕ ГАРАНТИРУЕТСЯ

Сценарий работы активити бизнес-процесса

Поле "Условие для…" : в данных полях указывается условия для соответствия для полей (равно/неравно, больше или равно, меньше или равно,больше/меньше).

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
ID:	В данном пункте указывается ID искомого товара.
Каталог:	В данном пункте указывается ID каталога.
Цена:	В данном пункте указывается цена товара
Валюта:	В данном пункте указывается валюта, указанная в товаре
Название:	В данном пункте указывается название товара
Описание:	В данном пункте указывается описание товара
Тип описания:	В данном пункте указывается значение:1,2,3. Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Раздел:	В данном пункте указывается ID раздела.
Ставка НДС:	В данном пункте указывается ставка НДС, указанная в товаре.
Единица измерения:	В данном пункте указывается единица измерения, указанная в товаре
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:<варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска для итератора;
- Результат поиска строка;
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Соответствует условиям;
- Сообщение об ошибке.

Получение товара из сущности

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

• Получение списка товарных позиций из сделки, лида, счёта или смарт-процесса;
• Формирование таблицы товаров для отправки в письме или сообщении;
• Анализ и обработка товаров в бизнес-процессе;
• Перенос товаров между сущностями CRM;
• Формирование отчётов по товарным позициям;
• Проверка наличия товаров в сущности перед выполнением действий;
• Получение ID товаров для дальнейшей обработки в итераторе.

Как работает активити (робот):
- Активити (робот) получает все товарные позиции из указанной сущности CRM;
- Результат можно вывести в виде таблицы (HTML или BBCode);
- Поддерживается настройка отображения количества, цены и суммы;
- Возвращается массив ID товаров для дальнейшей обработки в итераторе;
- Активити (робот) работает через REST API Битрикс24.

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

Название поля	Описание и примеры использования
Тип Сущности	Обязательный параметр. Выбор типа сущности, товарные позиции которой будут получены. Поддерживаемые типы: Лид; Сделка; Счет; Ком. предложение; Смарт-процесс.
ID сущности	Обязательный параметр. ID сущности, из которой будут взяты товарные позиции. Примеры: - {=Document:ID} - ID текущей сущности из документа; - 123 - конкретный ID сущности; - {=Variable:DEAL_ID} - ID из переменной.
Тип Сущности (при выбранных смарт-процессах)	Этот параметр работает только если в поле "Тип сущности" выбрано "Смарт-процесс". Позволяет выбрать из списка конкретный смарт-процесс для получения товаров.
Способ вывода таблицы	Позволяет вывести результат в виде таблицы. Доступные способы: - HTML - для использования в письмах и документах; - BBCode - для использования в комментариях и сообщениях Битрикс24.
Включить количество в таблицу	Включение данных о количестве товара в выводимую таблицу. Варианты: да/нет.
Включить цену в таблицу	Включение данных о цене товара в выводимую таблицу. Варианты: да/нет.
Включить сумму в таблицу	Включение данных об общей сумме товара в выводимую таблицу. Варианты: да/нет.
Делать отладочные сообщения в журнал БП	Вывод отладочных данных в журнале бизнес-процесса. Варианты: да/нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для информирования пользователя в истории о том, что БП остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для определения, нужно ли ожидать реакции от активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Данная опция позволяет ограничить срок ожидания ответа. Технические особенности платформы Битрикс24 иногда создают ситуацию с большой очередью запросов. Для того чтобы не останавливать дальнейшие действия, можно установить своё время ожидания.

Примеры использования:

№	Сценарий	Тип сущности	ID сущности	Способ вывода
1	Получить товары из текущей сделки	Сделка	{=Document:ID}	HTML
2	Получить товары из лида	Лид	{=Variable:LEAD_ID}	HTML
3	Получить товары из счёта	Счет	{=Variable:INVOICE_ID}	BBCode
4	Получить товары из ком. предложения	Ком. предложение	{=Variable:QUOTE_ID}	HTML
5	Получить товары из смарт-процесса	Смарт-процесс	{=Document:ID}	HTML
6	Сформировать таблицу для письма	Сделка	{=Document:ID}	HTML (с ценой и суммой)
7	Получить ID для итератора	Сделка	{=Document:ID}	-
8	Таблица для комментария	Сделка	{=Document:ID}	BBCode
9	Проверка наличия товаров	Лид	{=Document:ID}	-
10	Анализ товаров в другой сделке	Сделка	{=Variable:OTHER_DEAL_ID}	HTML

Возвращаемые параметры для данного активити:

• Товарные позиции (products_table) - таблица с товарами в выбранном формате (HTML или BBCode);
• ID товаров (массив) (product_ids_array) - массив ID товаров для использования в итераторе;
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

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

Удаление товара

Данное активити позволяет удалять товар из каталога, указав его ID.

Сценарий работы бизнес-процесса

 






















ID товара: в данном пункте указывается ID товара, который планируется удалить.

Делать отладочные сообщения в журнал БП: варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
1 - успешное удаление.
0 - удалить товар не удалось.

Создание товара

Данное активити позволяет создать товар в CRM.

Сценарий работы бизнес-процесса

Название	Описание
Каталог:	В данном пункте указывается ID каталога.
Цена:	В данном пункте указывается цена товара
Валюта:	В данном пункте указывается валюта, указанная в товаре
Название:	В данном пункте указывается название товара
Описание:	В данном пункте указывается описание товара
Тип описания:	В данном пункте указывается значение:1,2,3. Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Активен:	Доступно значение: да/нет. В данном поле указывается доступность товара.
Раздел:	В данном пункте указывается ID раздела.
Сортировка:	В данном поле указывается индекс сортировки товара.
Ставка НДС:	В данном пункте указывается ставка НДС.
НДС включен в цену:	Доступно значение: да/нет. В данном пункте указывается включен ли НДС в стоимость товара.
Единица измерения:	В данном пункте указывается единица измерения, указанная в товаре
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- ID нового товара.
- Сообщение об ошибке.

Редактирование товара

Данное активити позволяет изменять поля сущности "Товар".

Сценарий работы бизнес-процесса

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
ID:	В данном пункте указывается ID редактируемого товара.
Каталог:	В данном пункте указывается ID каталога.
Цена:	В данном пункте указывается цена товара.
Валюта:	В данном пункте указывается валюта расчетов, указанная в товаре
Название:	В данном пункте указывается название товара.
Описание:	В данном пункте указывается описание товара.
Тип описания:	В данном пункте указывается значение:1,2,3. Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Активен:	Доступно значение: да/нет. В данном поле указывается доступность товара.
Раздел:	В данном пункте указывается ID раздела.
Сортировка:	В данном поле указывается индекс сортировки товара.
Ставка НДС:	В данном пункте указывается ставка НДС, указанная в товаре.
НДС включён в цену:	Доступно значение: да/нет. В данном пункте указывается включен ли НДС в стоимость товара.
Единица измерения:	В данном пункте указывается единица измерения, указанная в товаре
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.

Для работы с полем тип "Привязка к сотруднику" используйте числовое значение без доп. символов или букв.
Пример заполнения поля: 12345 , где 12345 - ID сотрудника.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Получение данных по сущности товар

Данное активити позволяет получить все данные по сущности "товар" в том числе и из пользовательских полей.

Сценарий работы активити бизнес-процесса

ID товара: в данном пункте указывается ID товара, данные которого необходимо получить.

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

ВАЖНО!
Данное активити не работает с массивами.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Все параметры из сущности "Товар", включая данные пользовательских полей.

Получение параметров товаров из сущности

Данное активити позволяет отобразить товарные позиции сущности в виде таблицы. 

Сценарий работы активити бизнес-процесса

Тип Сущности: выбор типа сущности, товарные позиции которой будут отображены.

ID сущности: ID сущности, из которой будут взяты товарные позиции.

Условие отбора: в этом поле нужно указать параметры, которые вы хотите получить в результате работы активити.
Пример заполнения:  1#1, где 1 до решетки - номер товарной позиции, 1 после решетки - номер параметра товарной позиции.
Разделителем между параметрами является пробел.
Товарные позиции:

• 1- ID товара;
• 2- Название товара;
• 3 - Количество товара;
• 4 - Цена;
• 5 - Сумма;
• 6 - Налог;
• 7- Скидка.
  

 1#1 1#2 1#3 - вернет в доп. параметрах 2658 Tesla Model X 10 , где 2658- ID товара, Tesla Model - название товара, 10 - количество товара.

Мы получаем только те параметры товаров, которые вы видите во вкладке "Товары", выбранной Вами сущности.
Если вы указываете один параметр для получения каждого товара, то после заполнения параметра нужно добавлять пробел.

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

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы активити бизнес-процесса

Возвращаемые параметры данного активити:
- Данные товара.
- Сообщение об ошибке.

Вычисление себестоимости товара каталога

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

• Расчёт себестоимости товара на основе данных документов прихода;
• Получение цены товара из последнего проведённого документа прихода;
• Расчёт средней себестоимости товара за определённый период;
• Автоматизация расчёта себестоимости при создании или обновлении товара;
• Использование себестоимости для расчёта прибыли и наценки;
• Обновление закупочной цены товара на основе данных документов;
• Анализ динамики изменения себестоимости товара;
• Автоматизация учёта себестоимости при работе с торговым каталогом;
• Расчёт себестоимости для отчётности и аналитики;
• Использование себестоимости в бизнес-процессах формирования цен.

Как работает активити (робот):
- Активити (робот) находит все документы, в которых фигурирует указанный товар;
- Поддерживается два типа расчёта: по последнему проведённому документу или за определённый период;
- При расчёте по последнему проведённому документу возвращается цена из самого последнего проведённого документа прихода;
- При расчёте за период суммируются цены из документов прихода за указанный период (1, 3, 6 или 12 месяцев);
- Активити (робот) работает через REST API Битрикс24 (catalog.document.element.list и catalog.document.list);
- Возвращается себестоимость товара для использования в дальнейших шагах бизнес-процесса.

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

Название поля	Описание и примеры использования
ID товара	В данном поле указывается идентификатор товара торгового каталога, для которого нужно рассчитать себестоимость. Это необязательный параметр. Примеры использования: - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - 123 - использовать ID товара 123; - {=A1988_22222_92566_99999:id_new_product} - использовать ID товара из результата активити (робота) "Создание товара торгового каталога"; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Если товар не указан или товар не найден в документах, активити (робот) завершится с ошибкой. Убедитесь, что указанный товар существует и участвует в документах прихода.
Тип расчета	В данном поле указывается тип расчёта себестоимости товара. Это необязательный параметр. Варианты выбора: - Крайний проведенный документ (1) - использовать цену из последнего проведённого документа прихода; - За определённый период (2) - суммировать цены из документов прихода за указанный период. Примеры использования: - Крайний проведенный документ - получить актуальную себестоимость из последнего документа; - За определённый период - рассчитать среднюю себестоимость за период для анализа динамики цен.
Период	В данном поле указывается период времени для расчёта себестоимости. Это необязательный параметр. Используется только при выборе типа расчёта "За определённый период". Варианты выбора: - 1 месяц (1); - 3 месяца (3); - 6 месяцев (6); - 12 месяцев (12). Примеры использования: - 1 месяц - рассчитать себестоимость за последний месяц; - 3 месяца - рассчитать себестоимость за последний квартал; - 6 месяцев - рассчитать себестоимость за последнее полугодие; - 12 месяцев - рассчитать себестоимость за последний год.

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

Описание примера	Решение
Расчёт себестоимости по последнему документу	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип расчета - Крайний проведенный документ. Активити (робот) вернёт себестоимость товара из последнего проведённого документа прихода в параметре price_product.
Расчёт себестоимости за последний месяц	Параметры: ID товара - {=Document:PRODUCT_ID}, Тип расчета - За определённый период, Период - 1 месяц. Активити (робот) вернёт суммарную себестоимость товара из документов прихода за последний месяц.
Расчёт себестоимости за квартал	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип расчета - За определённый период, Период - 3 месяца. Активити (робот) вернёт суммарную себестоимость товара из документов прихода за последний квартал.
Автоматическое обновление закупочной цены	Сначала используйте активити (робот) "Вычисление себестоимости товара каталога" с параметрами ID товара - {=Variable:PRODUCT_ID}, Тип расчета - Крайний проведенный документ, затем используйте активити (робот) "Обновить товар торгового каталога" с параметрами ID товара - {=Variable:PRODUCT_ID}, Закупочная цена - {=A1988_22222_92566_99999:price_product}.
Расчёт себестоимости для отчётности	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип расчета - За определённый период, Период - 6 месяцев. Активити (робот) вернёт суммарную себестоимость за полугодие, которую можно использовать для формирования отчётов.
Расчёт себестоимости при создании товара	После создания товара используйте активити (робот) "Вычисление себестоимости товара каталога" с параметрами ID товара - {=A1988_22222_92566_99999:id_new_product}, Тип расчета - Крайний проведенный документ для получения актуальной себестоимости.
Расчёт средней себестоимости за год	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип расчета - За определённый период, Период - 12 месяцев. Активити (робот) вернёт суммарную себестоимость товара из документов прихода за последний год.
Массовый расчёт себестоимости через итератор	Параметры: ID товара - {=Iterator:Value}, Тип расчета - Крайний проведенный документ. Активити (робот) вернёт себестоимость для каждого товара из итератора в параметре price_product.
Расчёт себестоимости для анализа прибыли	Используйте активити (робот) "Вычисление себестоимости товара каталога" для получения себестоимости, затем используйте формулу для расчёта прибыли: ={{={=Variable:SELLING_PRICE} - {=A1988_22222_92566_99999:price_product}}}}.
Расчёт себестоимости при изменении цены в сделке	Параметры: ID товара - {=Document:PRODUCT_ID}, Тип расчета - Крайний проведенный документ. Активити (робот) вернёт актуальную себестоимость товара, которую можно использовать для расчёта прибыли при изменении цены в сделке.

Возвращаемые параметры данного активити (робота):
- Себестоимость товара (price_product) - строковое значение себестоимости товара, рассчитанной на основе данных документов;
- Готовность операции (ok_ready) - логическое значение (true/false), указывающее, была ли операция успешной.

Значения параметра price_product:
- При типе расчёта "Крайний проведенный документ" - цена из последнего проведённого документа прихода;
- При типе расчёта "За определённый период" - сумма цен из документов прихода за указанный период;
- Пустая строка или 0 - если документы не найдены или товар не участвует в документах.

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

Важно о возвращаемых параметрах: Если документы не найдены, параметр price_product будет равен 0 или пустой строке, а ok_ready будет равен false. Всегда проверяйте значение возвращаемых параметров перед использованием в дальнейших шагах бизнес-процесса.

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

Необязательные параметры:
Все параметры активити (робота) являются необязательными, но для успешного расчёта себестоимости рекомендуется указать ID товара.

Проверка существования товара в документах:
Активити (робот) проверяет наличие указанного товара в документах прихода. Если товар не найден в документах или документы отсутствуют, активити (робот) завершится с ошибкой "Не найдены документы в которых фигурирует указанный Вами продукт".

Типы документов:
Активити (робот) работает только с документами прихода (тип документа 'A'). Документы других типов не учитываются при расчёте себестоимости.

Ограничение количества документов:
При расчёте учитываются только последние 50 документов, в которых фигурирует товар. Для более точного расчёта рекомендуется регулярно обновлять данные документов.

Расчёт за период:
При выборе типа расчёта "За определённый период" учитываются только проведённые документы прихода за указанный период времени. Непроведённые документы не учитываются.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр документов каталога. Рекомендуется использовать пользователя с правами администратора системы.

Производительность:
При массовом расчёте себестоимости через итератор рекомендуется ограничивать количество обрабатываемых товаров. Для массового расчёта используйте модуль "Массовый запуск Бизнес-процессов".

Вариации товара

Добавить вариацию товара

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

• Автоматическое создание вариаций товара при добавлении нового товара в каталог;
• Создание вариаций товара с различными характеристиками (размер, цвет, артикул);
• Автоматизация создания вариаций товара на основе данных из сделок или других сущностей CRM;
• Массовое создание вариаций товара для товаров с множественными характеристиками;
• Создание вариаций товара при импорте данных из внешних систем;
• Автоматическое создание вариаций товара при изменении статуса сделки;
• Создание вариаций товара для товаров с различными ценами и валютой;
• Автоматизация создания вариаций товара при работе с торговым каталогом;
• Создание вариаций товара с указанием количества и резервирования;
• Автоматическое создание вариаций товара при синхронизации с внешними каталогами.

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

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

Название поля	Описание и примеры использования
ID товара	В данном поле указывается числовой идентификатор (ID) товара, к которому будет привязана создаваемая вариация. Это обязательный параметр. Примеры использования: - 30287 - привязать вариацию к товару с ID 30287; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки); - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:product_id} - использовать ID товара из результата поиска; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID товара существует в каталоге. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается текстовое наименование создаваемой вариации товара. Это обязательный параметр. Примеры использования: - Тест вариации - простое наименование; - {=Document:TITLE} - размер {=Variable:SIZE} - использовать наименование из документа и переменной; - Вариация товара #{=Document:PRODUCT_ID} - {=Variable:COLOR} - комбинированное наименование; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
Активность	В данном поле указывается, будет ли вариация товара активна. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация будет активна и доступна для использования; - Нет (N) - вариация будет неактивна. Примеры использования: - Да - создать активную вариацию; - Нет - создать неактивную вариацию для последующей активации.
Доступность к покупке	В данном поле указывается, доступна ли вариация товара для покупки. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация доступна для покупки; - Нет (N) - вариация недоступна для покупки. Примеры использования: - Да - создать вариацию, доступную для покупки; - Нет - создать вариацию, которая временно недоступна для покупки.
Уникальные штрихкоды для каждого экземпляра	В данном поле указывается, используются ли уникальные штрихкоды для каждого экземпляра товара. Это необязательный параметр. Варианты выбора: - Да (Y) - используются уникальные штрихкоды; - Нет (N) - не используются уникальные штрихкоды. Примеры использования: - Да - для товаров, где каждый экземпляр имеет свой уникальный штрихкод; - Нет - для товаров, где все экземпляры имеют одинаковый штрихкод.
Наличие набора	В данном поле указывается, является ли вариация товара набором. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация является набором; - Нет (N) - вариация не является набором. Примеры использования: - Да - для вариаций, которые представляют собой набор товаров; - Нет - для обычных вариаций товара.
Разрешение покупки при отсутствии товара	В данном поле указывается, разрешена ли покупка вариации товара при отсутствии товара на складе. Это необязательный параметр. Варианты выбора: - Да (Y) - покупка разрешена даже при отсутствии товара; - Нет (N) - покупка запрещена при отсутствии товара. Примеры использования: - Да - для товаров, которые можно заказать под заказ; - Нет - для товаров, которые можно купить только при наличии на складе.
Символьный код	В данном поле указывается символьный код вариации товара. Это необязательный параметр. Примеры использования: - Символьный код - простой код; - {=Variable:PRODUCT_CODE} - использовать код из переменной; - ={{={=Document:PRODUCT_CODE} & "_" & {=Variable:VARIANT_CODE}}}} - объединение кодов.
Детальное описание	В данном поле указывается детальное описание вариации товара. Это необязательный параметр. Примеры использования: - Детальное описание - простое описание; - {=Variable:DESCRIPTION} - использовать описание из переменной; - Описание вариации товара с характеристиками: размер {=Variable:SIZE}, цвет {=Variable:COLOR} - комбинированное описание.
Тип детального описания	В данном поле указывается тип детального описания вариации товара. Это необязательный параметр. Варианты выбора: - Текст (text) - обычный текст; - HTML (html) - HTML-разметка. Примеры использования: - Текст - для простого текстового описания; - HTML - для описания с HTML-разметкой.
Валюта закупочной цены	В данном поле указывается валюта закупочной цены вариации товара. Это необязательный параметр. Варианты выбора: - Рубль (RUB); - Доллар США (USD); - Евро (EUR). Примеры использования: - RUB - для товаров с ценой в рублях; - USD - для товаров с ценой в долларах; - EUR - для товаров с ценой в евро.
Доступное количество	В данном поле указывается доступное количество вариации товара на складе. Это необязательный параметр. Примеры использования: - 1 - указать количество 1; - {=Variable:QUANTITY} - использовать количество из переменной; - ={{=intval({=Document:QUANTITY})}} - преобразовать количество из документа в целое число.
Режим количественного учета	В данном поле указывается режим количественного учета вариации товара. Это необязательный параметр. Варианты выбора: - Включен (Y) - количественный учет включен; - Выключен (N) - количественный учет выключен; - По умолчанию (D) - использовать настройки по умолчанию. Примеры использования: - Включен - для товаров, где требуется точный учет количества; - Выключен - для товаров, где количественный учет не требуется; - По умолчанию - использовать настройки товара.
Единица времени периода оплаты	В данном поле указывается единица времени периода оплаты для вариации товара. Это необязательный параметр. Варианты выбора: - Час (H); - День (D); - Неделя (W); - Месяц (M); - Квартал (Q); - Полугодие (S); - Год (Y). Примеры использования: - Месяц - для подписок с ежемесячной оплатой; - Год - для подписок с годовой оплатой.
НДС включен в цену	В данном поле указывается, включен ли НДС в цену вариации товара. Это необязательный параметр. Варианты выбора: - Да (Y) - НДС включен в цену; - Нет (N) - НДС не включен в цену. Примеры использования: - Да - для товаров, где НДС уже включен в цену; - Нет - для товаров, где НДС добавляется к цене.

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

Описание примера	Решение
Создание вариации товара при добавлении нового товара в каталог	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара {=Variable:PRODUCT_NAME}", Активность - Да, Доступность к покупке - Да, Разрешение покупки при отсутствии товара - Нет, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание вариации товара с указанием размера и цвета	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Товар {=Document:TITLE} - Размер {=Variable:SIZE}, Цвет {=Variable:COLOR}", Активность - Да, Доступность к покупке - Да, Символьный код - ={{={=Variable:PRODUCT_CODE} & "_" & {=Variable:SIZE} & "_" & {=Variable:COLOR}}}}, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание вариации товара для товара с подпиской	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Подписка на {=Variable:SERVICE_NAME}", Активность - Да, Доступность к покупке - Да, Разрешение подписки на товар - Да, Единица времени периода оплаты - Месяц, Длина периода оплаты - 1, НДС включен в цену - Да.
Создание вариации товара с указанием закупочной цены в валюте	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Вариация товара {=Document:TITLE}", Активность - Да, Доступность к покупке - Да, Валюта закупочной цены - USD, Закупочная цена - {=Variable:PURCHASE_PRICE}, НДС включен в цену - Нет.
Создание вариации товара с количественным учетом	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара с учетом количества", Активность - Да, Доступность к покупке - Да, Режим количественного учета - Включен, Доступное количество - {=Variable:QUANTITY}, Зарезервированное количество - {=Variable:RESERVED_QUANTITY}, НДС включен в цену - Да.
Создание вариации товара для товара под заказ	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Вариация товара {=Document:TITLE} под заказ", Активность - Да, Доступность к покупке - Да, Разрешение покупки при отсутствии товара - Да, Доступное количество - 0, НДС включен в цену - Да.
Создание вариации товара с детальным описанием в HTML	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара с HTML описанием", Активность - Да, Доступность к покупке - Да, Детальное описание - {=Variable:HTML_DESCRIPTION}, Тип детального описания - HTML, НДС включен в цену - Да.
Создание вариации товара для набора товаров	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Набор товаров {=Document:TITLE}", Активность - Да, Доступность к покупке - Да, Наличие набора - Да, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание вариации товара с уникальными штрихкодами	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара с уникальными штрихкодами", Активность - Да, Доступность к покупке - Да, Уникальные штрихкоды для каждого экземпляра - Да, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Массовое создание вариаций товара через итератор	Параметры: ID товара - {=Iterator:Value}, Наименование - "Вариация товара #{=Iterator:Value}", Активность - Да, Доступность к покупке - Да, Доступное количество - 1, НДС включен в цену - Да.

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

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

Важно о возвращаемых параметрах: Если создание вариации товара завершилось с ошибкой, параметр id_offer_product будет равен 0. Всегда проверяйте значение возвращаемого параметра перед использованием в дальнейших шагах бизнес-процесса.

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

Обязательные параметры:
Для успешного создания вариации товара обязательно должны быть заполнены следующие параметры:
- ID товара (parentId);
- Наименование (name).

Проверка существования товара:
Активити (робот) проверяет существование указанного товара перед созданием вариации. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.

Обработка boolean полей:
Поля типа boolean (Активность, Доступность к покупке, НДС включен в цену и др.) принимают значения "Y" (Да) или "N" (Нет) и автоматически преобразуются в соответствующий формат при отправке в API.

Порядок параметров:
Параметры ID товара и Наименование всегда отображаются первыми в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на создание вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству создаваемых вариаций:
При массовом создании вариаций через итератор рекомендуется не создавать более 100 вариаций за один запуск бизнес-процесса. Для массового создания используйте модуль "Массовый запуск Бизнес-процессов".

Удаление вариации товара

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

• Удаление вариаций товара по их ID;
• Удаление неактивных или устаревших вариаций товара;
• Удаление вариаций товара с нулевым количеством на складе;
• Массовое удаление вариаций товара, соответствующих определённым критериям;
• Очистка старых или неактуальных вариаций товара;
• Удаление вариаций товара после выполнения определённых условий в бизнес-процессе;
• Автоматическое удаление вариаций товара при изменении статуса сделки или товара;
• Удаление вариаций товара при интеграции с внешними системами;
• Очистка вариаций товара для оптимизации работы с каталогом;
• Удаление тестовых вариаций товара после завершения разработки.

Как работает активити (робот):
- Активити (робот) удаляет вариацию товара по указанному ID через REST API Битрикс24;
- Поддерживается удаление только одной вариации за один запуск активити (робота);
- Активити (робот) возвращает результат удаления (успешно или нет) для дальнейшего использования в бизнес-процессе;
- Активити (робот) работает через REST API Битрикс24 (catalog.product.offer.delete);
- Для массового удаления вариаций используйте итератор с активити (роботом) "Поиск вариаций товара".

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

Название поля

Описание и примеры использования

ID вариации товара

В данном поле указывается идентификатор вариации товара, которую нужно удалить. Это обязательный параметр. Примеры использования: - {=Variable:OFFER_ID} - удалить вариацию с ID из переменной предыдущего активити (робота); - 123 - удалить вариацию с ID 123; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата активити (робота) "Поиск вариаций товара"; - {=A1988_22222_92566_99999:id_offer_product} - использовать ID вариации из результата активити (робота) "Добавить вариацию товара"; - {=Document:OFFER_ID} - удалить вариацию, если ID вариации указан в документе; - {=Iterator:Value} - удалить вариацию для каждого ID из итератора. Как получить ID вариации: - Из результата активити (робота) "Добавить вариацию товара" (параметр id_offer_product); - Из результата активити (робота) "Поиск вариаций товара" (параметр search_results_array или search_result_first_string); - Из результата активити (робота) "Получить данные по вариации товара" (параметр id); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если вариация связана с документом. Важно: Удаление вариации товара является необратимой операцией. После удаления вариацию нельзя восстановить. Всегда проверяйте необходимость удаления перед выполнением операции. Если вариация с указанным ID не существует, активити (робот) завершится с ошибкой.

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

Описание примера	Решение
Удаление вариации товара по ID	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) удалит вариацию с указанным ID и вернёт результат удаления в параметре good_delete (true - успешно, false - ошибка).
Удаление вариации после её создания (откат)	Параметры: ID вариации товара - {=A1988_22222_92566_99999:id_offer_product}. Активити (робот) удалит только что созданную вариацию товара, если она была создана с ошибкой или не соответствует требованиям.
Удаление первой найденной вариации	Параметры: ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) удалит первую вариацию из результата поиска вариаций товара.
Удаление неактивной вариации товара	Сначала используйте активити (робот) "Поиск вариаций товара" с параметром Активность - N для поиска неактивных вариаций, затем используйте активити (робот) "Удаление вариации товара" с параметром ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}.
Удаление вариации с нулевым количеством	Сначала используйте активити (робот) "Поиск вариаций товара" с параметром Доступное количество - 0 для поиска вариаций с нулевым количеством, затем используйте активити (робот) "Удаление вариации товара" с параметром ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}.
Массовое удаление вариаций через итератор	Сначала используйте активити (робот) "Поиск вариаций товара" для получения списка ID вариаций в параметре search_results_array, затем используйте итератор с активити (роботом) "Удаление вариации товара" с параметром ID вариации товара - {=Iterator:Value}.
Удаление вариации при изменении статуса сделки	В условии бизнес-процесса проверьте статус сделки, и если статус соответствует определённому значению, используйте активити (робот) "Удаление вариации товара" с параметром ID вариации товара - {=Document:OFFER_ID}.
Удаление тестовых вариаций товара	Сначала используйте активити (робот) "Поиск вариаций товара" с параметром Наименование - "Тест" для поиска тестовых вариаций, затем используйте итератор с активити (роботом) "Удаление вариации товара" для удаления всех найденных тестовых вариаций.
Удаление вариации с проверкой результата	Параметры: ID вариации товара - {=Variable:OFFER_ID}. После выполнения активити (робота) проверьте возвращаемый параметр good_delete в условии бизнес-процесса. Если good_delete = true, вариация успешно удалена. Если good_delete = false, произошла ошибка при удалении.
Удаление вариации товара при интеграции с внешними системами	Параметры: ID вариации товара - {=Variable:EXTERNAL_OFFER_ID}. Активити (робот) удалит вариацию товара при синхронизации данных с внешней системой, если вариация была удалена во внешней системе.

Возвращаемые параметры данного активити (робота):
- Успешное удаление (good_delete) - логическое значение (true/false), указывающее, было ли удаление успешным.

Значения параметра good_delete:
- true - вариация товара успешно удалена;
- false - произошла ошибка при удалении вариации товара (вариация не существует, нет прав доступа и т.д.).

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

Важно о возвращаемых параметрах: Если удаление завершилось с ошибкой, параметр good_delete будет равен false. Всегда проверяйте значение возвращаемого параметра перед выполнением дальнейших действий в бизнес-процессе. Удаление вариации товара является необратимой операцией.

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

Обязательные параметры:
Для успешного удаления вариации товара обязательно должен быть заполнен следующий параметр:
- ID вариации товара (id_offer).

Проверка существования вариации:
Активити (робот) проверяет существование указанной вариации перед удалением. Если вариация с указанным ID не существует, активити (робот) вернёт good_delete = false.

Необратимость операции:
Удаление вариации товара является необратимой операцией. После удаления вариацию нельзя восстановить. Всегда проверяйте необходимость удаления перед выполнением операции.

Массовое удаление:
Для массового удаления вариаций используйте комбинацию активити (робота) "Поиск вариаций товара" и итератора с активити (роботом) "Удаление вариации товара".

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на удаление вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству удаляемых вариаций:
При массовом удалении вариаций через итератор рекомендуется не удалять более 100 вариаций за один запуск бизнес-процесса. Для массового удаления используйте модуль "Массовый запуск Бизнес-процессов".

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

Получить данные по вариации товара

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

• Получение всех данных вариации товара по её ID для дальнейшей обработки;
• Извлечение конкретных полей вариации (наименование, код, размеры, вес, цены);
• Получение информации о количестве товара на складе;
• Получение данных о статусе активности и доступности вариации товара;
• Проверка параметров вариации товара перед выполнением операций;
• Извлечение данных вариации для использования в других активити (роботах);
• Получение информации о ценах и валюте вариации товара;
• Автоматизация обработки данных вариаций в бизнес-процессах;
• Получение данных вариации для аналитики и отчётности;
• Извлечение данных вариации для интеграции с внешними системами.

Как работает активити (робот):
- Активити (робот) получает все данные вариации товара по указанному ID через REST API Битрикс24;
- Возвращаются все доступные поля вариации (ID, наименование, код, размеры, вес, цены, количество, статусы и т.д.);
- Поддерживается получение информации о количестве товара на складе и резервировании;
- Возвращаются данные о статусе активности, доступности для покупки и других параметрах;
- Все поля вариации возвращаются в возвращаемых параметрах активити (робота);
- Активити (робот) работает через REST API Битрикс24 (catalog.product.offer.get);
- Поддерживается обработка множественных ID вариаций (массивы для итератора).

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

Название поля

Описание и примеры использования

ID вариации товара

В данном поле указывается идентификатор вариации товара, данные которой нужно получить. Это обязательный параметр. Если указан массив ID, будет обработан только первый элемент массива. Примеры использования: - {=Variable:OFFER_ID} - получить данные вариации с ID из переменной предыдущего активити (робота); - 123 - получить данные вариации с ID 123; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска вариаций; - {=A1988_22222_92566_99999:id_offer_product} - использовать ID вариации из результата активити (робота) "Добавить вариацию товара"; - {=Document:OFFER_ID} - получить данные вариации, если ID вариации указан в документе; - {=Iterator:Value} - получить данные вариации для каждого ID из итератора. Как получить ID вариации: - Из результата активити (робота) "Добавить вариацию товара" (параметр id_offer_product); - Из результата активити (робота) "Поиск вариаций товара" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если вариация связана с документом. Важно: Если вариация с указанным ID не существует, активити (робот) завершится с ошибкой "Результатов не найдено". Всегда проверяйте существование вариации перед получением данных.

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

Описание примера	Решение
Получение всех данных вариации товара по ID	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт все доступные поля вариации: ID, наименование, код, размеры, вес, цены, количество, статусы и другие поля. Все данные будут доступны в возвращаемых параметрах активити (робота).
Получение данных вариации после её создания	Параметры: ID вариации товара - {=A1988_22222_92566_99999:id_offer_product}. Активити (робот) вернёт все данные только что созданной вариации товара для проверки корректности создания.
Получение данных первой найденной вариации	Параметры: ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) вернёт все данные первой вариации из результата поиска.
Проверка количества товара на складе	Параметры: ID вариации товара - {=Document:OFFER_ID}. Активити (робот) вернёт данные вариации, включая доступное количество в возвращаемом параметре quantity, которое можно использовать в условиях бизнес-процесса.
Проверка статуса активности вариации	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт данные вариации, включая статус активности в возвращаемом параметре active, который можно использовать в условиях для проверки активности вариации.
Получение цены и валюты вариации	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт данные вариации, включая закупочную цену в возвращаемом параметре purchasingPrice и валюту в возвращаемом параметре purchasingCurrency.
Получение данных вариации для обновления	Параметры: ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) вернёт все данные вариации, которые можно использовать в активити (роботе) "Обновить вариацию товара" для частичного обновления полей.
Массовое получение данных вариаций через итератор	Параметры: ID вариации товара - {=Iterator:Value}. Активити (робот) вернёт данные вариации для каждого ID из итератора. Все данные будут доступны в возвращаемых параметрах для каждого элемента итератора.
Получение наименования и описания вариации	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт наименование вариации в возвращаемом параметре name и описание в возвращаемом параметре detailText, которые можно использовать для формирования отчётов или уведомлений.
Проверка доступности вариации для покупки	Параметры: ID вариации товара - {=Document:OFFER_ID}. Активити (робот) вернёт данные вариации, включая статус доступности в возвращаемом параметре available, который можно использовать в условиях для проверки возможности покупки.

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

Основные возвращаемые параметры (примеры):
- Наименование (name) - текстовое наименование вариации товара;
- Символьный код (code) - символьный код вариации товара;
- Активность (active) - статус активности вариации (Y/N);
- Доступность к покупке (available) - статус доступности для покупки (Y/N);
- Доступное количество (quantity) - количество товара на складе;
- Закупочная цена (purchasingPrice) - закупочная цена вариации;
- Валюта закупочной цены (purchasingCurrency) - валюта закупочной цены;
- НДС включен в цену (vatIncluded) - статус включения НДС в цену (Y/N);
- Детальное описание (detailText) - детальное описание вариации;
- И другие поля вариации товара в зависимости от настроек каталога.

Примеры использования возвращаемых параметров:
- Использовать параметр name для формирования названия в уведомлениях;
- Использовать параметр quantity для проверки наличия товара на складе;
- Использовать параметр active для проверки активности вариации в условиях;
- Использовать параметр purchasingPrice для расчётов в бизнес-процессе;
- Использовать все параметры для передачи в активити (робот) "Обновить вариацию товара";
- Использовать параметры для формирования отчётов и аналитики.

Важно о возвращаемых параметрах: Если вариация с указанным ID не найдена, активити (робот) завершится с ошибкой "Результатов не найдено". Всегда проверяйте существование вариации перед использованием возвращаемых параметров в дальнейших шагах бизнес-процесса. Список возвращаемых параметров может отличаться в зависимости от настроек каталога вашего портала.

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

Обязательные параметры:
Для успешного получения данных вариации товара обязательно должен быть заполнен следующий параметр:
- ID вариации товара (id_offer).

Проверка существования вариации:
Активити (робот) проверяет существование указанной вариации перед получением данных. Если вариация с указанным ID не существует, активити (робот) завершится с ошибкой "Результатов не найдено".

Обработка множественных ID:
Если в параметре указан массив ID вариаций, будет обработан только первый элемент массива. Для обработки множественных ID используйте итератор.

Список возвращаемых параметров:
Список возвращаемых параметров формируется автоматически на основе настроек каталога вашего портала и может отличаться в зависимости от конфигурации системы.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Производительность:
При массовом получении данных вариаций через итератор рекомендуется ограничивать количество обрабатываемых элементов. Для массовой обработки используйте модуль "Массовый запуск Бизнес-процессов".

Поиск вариаций товара

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

• Поиск вариаций товара по ID главного товара;
• Поиск вариаций товара по различным характеристикам (наименование, код, размеры, вес);
• Фильтрация вариаций товара по параметрам активности и доступности;
• Поиск вариаций товара по количеству на складе;
• Поиск вариаций товара по ценам и валюте;
• Фильтрация вариаций товара по режиму количественного учета;
• Поиск вариаций товара с определенными свойствами (размер, цвет, артикул);
• Массовый поиск вариаций товара для обработки в итераторе;
• Поиск активных или неактивных вариаций товара;
• Автоматизация процессов на основе найденных вариаций товара.

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей вариации товара из каталога CRM вашего портала;
- Для каждого поля (кроме недоступных для поиска) создаётся параметр, который можно использовать для фильтрации;
- Поддерживается поиск по ID главного товара (parentId) - необязательный параметр;
- Можно указать любые поля вариации товара для фильтрации результатов поиска;
- Поддерживается поиск по множественным критериям одновременно;
- Результаты возвращаются в виде массива ID вариаций, строки с ID через запятую, первого и последнего ID, количества найденных вариаций;
- Активити (робот) работает через REST API Битрикс24 (catalog.product.offer.list);
- Поддерживается обработка больших объёмов данных (более 50 вариаций) через batch-запросы;
- Можно ограничить количество результатов поиска с помощью параметра "Ограничение количества результатов".

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

Название поля	Описание и примеры использования
ID главного товара	В данном поле указывается числовой идентификатор (ID) главного товара, вариации которого нужно найти. Это необязательный параметр. Примеры использования: - 30287 - найти все вариации товара с ID 30287; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки); - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:product_id} - использовать ID товара из результата поиска; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Если указан ID главного товара, будут найдены только вариации, принадлежащие этому товару. Можно комбинировать с другими параметрами поиска для более точной фильтрации.
Наименование	В данном поле указывается наименование вариации товара для поиска. Это необязательный параметр. Примеры использования: - Тест вариации - найти вариации с точным наименованием; - {=Variable:VARIANT_NAME} - использовать наименование из переменной; - Можно использовать операторы поиска для частичного совпадения (зависит от настроек поиска).
Активность	В данном поле указывается статус активности вариации товара для поиска. Это необязательный параметр. Примеры использования: - Y - найти только активные вариации; - N - найти только неактивные вариации; - {=Variable:ACTIVE_STATUS} - использовать статус из переменной.
Доступность к покупке	В данном поле указывается статус доступности вариации товара для покупки. Это необязательный параметр. Примеры использования: - Y - найти только доступные для покупки вариации; - N - найти только недоступные для покупки вариации.
Доступное количество	В данном поле указывается количество товара на складе для поиска. Это необязательный параметр. Примеры использования: - 0 - найти вариации с нулевым количеством; - {=Variable:QUANTITY} - найти вариации с указанным количеством; - Можно использовать операторы сравнения (>, <, >=, <=) для поиска по диапазону.
Ограничение количества результатов	В данном поле указывается максимальное количество результатов поиска, которые нужно вернуть. Это необязательный параметр. Примеры использования: - 10 - вернуть только первые 10 результатов; - 50 - вернуть только первые 50 результатов; - {=Variable:LIMIT} - использовать ограничение из переменной. Важно: Если параметр не указан, будут возвращены все найденные результаты. Рекомендуется использовать ограничение при больших объёмах данных для оптимизации производительности.

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

Описание примера	Решение
Поиск всех вариаций товара по ID главного товара	Параметры: ID главного товара - {=Document:PRODUCT_ID}. Активити (робот) вернёт массив ID всех вариаций указанного товара в параметре search_results_array.
Поиск активных вариаций товара с наличием на складе	Параметры: ID главного товара - {=Variable:PRODUCT_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только активные и доступные вариации с наличием на складе.
Поиск вариаций товара по наименованию	Параметры: Наименование - {=Variable:VARIANT_NAME}. Активити (робот) вернёт все вариации с указанным наименованием в параметре search_results_array.
Поиск неактивных вариаций товара	Параметры: ID главного товара - {=Document:PRODUCT_ID}, Активность - N. Активити (робот) вернёт все неактивные вариации указанного товара.
Поиск вариаций товара с нулевым количеством	Параметры: ID главного товара - {=Variable:PRODUCT_ID}, Доступное количество - 0. Активити (робот) вернёт все вариации с нулевым количеством на складе.
Поиск вариаций товара с ограничением результатов	Параметры: ID главного товара - {=Document:PRODUCT_ID}, Ограничение количества результатов - 10. Активити (робот) вернёт только первые 10 найденных вариаций.
Поиск вариаций товара для массовой обработки	Параметры: ID главного товара - {=Iterator:Value}, Активность - Y. Активити (робот) вернёт активные вариации для каждого товара из итератора в параметре search_results_array.
Поиск доступных для покупки вариаций товара	Параметры: ID главного товара - {=Variable:PRODUCT_ID}, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только вариации, доступные для покупки и имеющие товар на складе.
Поиск вариаций товара по нескольким критериям	Параметры: ID главного товара - {=Document:PRODUCT_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >5. Активити (робот) вернёт активные и доступные вариации с количеством больше 5.
Поиск первой вариации товара	Параметры: ID главного товара - {=Variable:PRODUCT_ID}, Ограничение количества результатов - 1. Активити (робот) вернёт первую найденную вариацию в параметре search_result_first_string.

Возвращаемые параметры данного активити (робота):
- Условия поиска выполнены (math_search_results) - строка, указывающая, выполнены ли условия поиска ("Y" - да, "N" - нет);
- Количество найденных результатов (count_search) - числовое значение количества найденных вариаций товара;
- Массив ID найденных вариаций (search_results_array) - массив числовых идентификаторов найденных вариаций товара (множественное значение);
- Строка с ID найденных вариаций (search_results_string) - строка с идентификаторами найденных вариаций, разделёнными запятой;
- Первый ID из результатов (search_result_first_string) - строковое значение первого идентификатора из найденных вариаций;
- Последний ID из результатов (search_result_last_string) - строковое значение последнего идентификатора из найденных вариаций;
- Лог ошибок (s_error_logs) - строка с информацией о результатах поиска для отладки.

Примеры использования возвращаемых параметров:
- Использовать search_results_array для итератора при массовой обработке вариаций;
- Использовать search_result_first_string для получения первой найденной вариации;
- Использовать count_search для проверки количества найденных результатов;
- Использовать search_results_string для передачи списка ID в другие активити (роботы);
- Использовать math_search_results для проверки успешности поиска в условиях бизнес-процесса.

Важно о возвращаемых параметрах: Если вариации не найдены, параметр math_search_results будет равен "N", а count_search будет равен 0. Всегда проверяйте значение math_search_results перед использованием результатов поиска в дальнейших шагах бизнес-процесса.

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

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

Проверка существования вариаций:
Активити (робот) проверяет существование вариаций по указанным критериям. Если вариации не найдены, активити (робот) вернёт math_search_results = "N" и count_search = 0.

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

Ограничение количества результатов:
Рекомендуется использовать параметр "Ограничение количества результатов" при больших объёмах данных для оптимизации производительности и уменьшения времени выполнения активити (робота).

Порядок параметров:
Параметр ID главного товара всегда отображается первым в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Производительность:
При массовом поиске вариаций через итератор рекомендуется ограничивать количество результатов поиска для каждого товара. Для массового поиска используйте модуль "Массовый запуск Бизнес-процессов".

Изменить вариацию товара

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

• Автоматическое обновление параметров вариации товара при изменении данных в сделке;
• Обновление количества товара на складе при поступлении или продаже;
• Изменение статуса активности вариации товара в зависимости от условий бизнес-процесса;
• Обновление цен и валюты вариации товара при изменении курса валют;
• Автоматическое обновление характеристик вариации товара при изменении данных в других сущностях CRM;
• Изменение доступности вариации товара для покупки в зависимости от наличия на складе;
• Обновление описания и свойств вариации товара при синхронизации с внешними системами;
• Массовое обновление вариаций товара через итератор;
• Изменение режима количественного учета вариации товара;
• Обновление параметров подписки для вариации товара с периодической оплатой.

Как работает активити (робот):
- Активити (робот) обновляет существующую вариацию товара в каталоге CRM с указанными параметрами;
- Для обновления необходимо указать ID вариации товара (обязательный параметр);
- Можно обновить любые параметры вариации (наименование, код, размеры, вес, цены);
- Поддерживается обновление параметров активности, доступности, количества и резервирования;
- Можно изменить НДС и валюту закупочной цены;
- Обновляются только те поля, которые указаны в параметрах активити (робота);
- Поддерживается обновление пользовательских свойств товара (property1635, property1637 и др.).

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

Название поля	Описание и примеры использования
ID вариации	В данном поле указывается числовой идентификатор (ID) вариации товара, которую необходимо обновить. Это обязательный параметр. Примеры использования: - 30287 - обновить вариацию с ID 30287; - {=Document:OFFER_ID} - использовать ID вариации из поля документа (сделки); - {=Variable:OFFER_ID} - использовать ID вариации из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:offer_id} - использовать ID вариации из результата поиска; - {=Iterator:Value} - использовать ID вариации для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID вариации существует в каталоге. Если вариация с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается новое текстовое наименование вариации товара. Это необязательный параметр. Примеры использования: - Тест вариации - простое наименование; - {=Document:TITLE} - размер {=Variable:SIZE} - использовать наименование из документа и переменной; - Вариация товара #{=Document:PRODUCT_ID} - {=Variable:COLOR} - комбинированное наименование; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
Активность	В данном поле указывается, будет ли вариация товара активна. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация будет активна и доступна для использования; - Нет (N) - вариация будет неактивна. Примеры использования: - Да - активировать вариацию; - Нет - деактивировать вариацию для временного скрытия из каталога.
Доступность к покупке	В данном поле указывается, доступна ли вариация товара для покупки. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация доступна для покупки; - Нет (N) - вариация недоступна для покупки. Примеры использования: - Да - сделать вариацию доступной для покупки; - Нет - временно запретить покупку вариации.
Уникальные штрихкоды для каждого экземпляра	В данном поле указывается, используются ли уникальные штрихкоды для каждого экземпляра товара. Это необязательный параметр. Варианты выбора: - Да (Y) - используются уникальные штрихкоды; - Нет (N) - не используются уникальные штрихкоды. Примеры использования: - Да - включить использование уникальных штрихкодов; - Нет - отключить использование уникальных штрихкодов.
Наличие набора	В данном поле указывается, является ли вариация товара набором. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация является набором; - Нет (N) - вариация не является набором. Примеры использования: - Да - преобразовать вариацию в набор; - Нет - преобразовать набор в обычную вариацию.
Разрешение покупки при отсутствии товара	В данном поле указывается, разрешена ли покупка вариации товара при отсутствии товара на складе. Это необязательный параметр. Варианты выбора: - Да (Y) - покупка разрешена даже при отсутствии товара; - Нет (N) - покупка запрещена при отсутствии товара. Примеры использования: - Да - разрешить покупку под заказ; - Нет - запретить покупку при отсутствии товара на складе.
Символьный код	В данном поле указывается новый символьный код вариации товара. Это необязательный параметр. Примеры использования: - Символьный код - простой код; - {=Variable:PRODUCT_CODE} - использовать код из переменной; - ={{={=Document:PRODUCT_CODE} & "_" & {=Variable:VARIANT_CODE}}}} - объединение кодов.
Детальное описание	В данном поле указывается новое детальное описание вариации товара. Это необязательный параметр. Примеры использования: - Детальное описание - простое описание; - {=Variable:DESCRIPTION} - использовать описание из переменной; - Описание вариации товара с характеристиками: размер {=Variable:SIZE}, цвет {=Variable:COLOR} - комбинированное описание.
Тип детального описания	В данном поле указывается тип детального описания вариации товара. Это необязательный параметр. Варианты выбора: - Текст (text) - обычный текст; - HTML (html) - HTML-разметка. Примеры использования: - Текст - изменить тип описания на простой текст; - HTML - изменить тип описания на HTML-разметку.
Валюта закупочной цены	В данном поле указывается валюта закупочной цены вариации товара. Это необязательный параметр. Варианты выбора: - Рубль (RUB); - Доллар США (USD); - Евро (EUR). Примеры использования: - RUB - изменить валюту на рубли; - USD - изменить валюту на доллары; - EUR - изменить валюту на евро.
Доступное количество	В данном поле указывается новое доступное количество вариации товара на складе. Это необязательный параметр. Примеры использования: - 1 - установить количество 1; - {=Variable:QUANTITY} - использовать количество из переменной; - ={{=intval({=Document:QUANTITY})}} - преобразовать количество из документа в целое число.
Режим количественного учета	В данном поле указывается режим количественного учета вариации товара. Это необязательный параметр. Варианты выбора: - Включен (Y) - количественный учет включен; - Выключен (N) - количественный учет выключен; - По умолчанию (D) - использовать настройки по умолчанию. Примеры использования: - Включен - включить количественный учет; - Выключен - выключить количественный учет; - По умолчанию - использовать настройки товара.
Единица времени периода оплаты	В данном поле указывается единица времени периода оплаты для вариации товара. Это необязательный параметр. Варианты выбора: - Час (H); - День (D); - Неделя (W); - Месяц (M); - Квартал (Q); - Полугодие (S); - Год (Y). Примеры использования: - Месяц - изменить период оплаты на ежемесячный; - Год - изменить период оплаты на годовой.
НДС включен в цену	В данном поле указывается, включен ли НДС в цену вариации товара. Это необязательный параметр. Варианты выбора: - Да (Y) - НДС включен в цену; - Нет (N) - НДС не включен в цену. Примеры использования: - Да - включить НДС в цену; - Нет - исключить НДС из цены.

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

Описание примера	Решение
Обновление количества товара при поступлении на склад	Параметры: ID вариации - {=Document:OFFER_ID}, Доступное количество - ={{={=Variable:CURRENT_QUANTITY} + {=Variable:INCOMING_QUANTITY}}}}, Режим количественного учета - Включен.
Деактивация вариации товара при отсутствии на складе	Параметры: ID вариации - {=Variable:OFFER_ID}, Активность - Нет, Доступность к покупке - Нет, Доступное количество - 0.
Обновление цены и валюты вариации товара при изменении курса	Параметры: ID вариации - {=Document:OFFER_ID}, Валюта закупочной цены - USD, Закупочная цена - {=Variable:NEW_PRICE}, НДС включен в цену - Да.
Активация вариации товара при поступлении на склад	Параметры: ID вариации - {=Variable:OFFER_ID}, Активность - Да, Доступность к покупке - Да, Доступное количество - {=Variable:QUANTITY}, Разрешение покупки при отсутствии товара - Нет.
Обновление наименования и описания вариации товара	Параметры: ID вариации - {=Document:OFFER_ID}, Наименование - "Товар {=Document:TITLE} - Размер {=Variable:SIZE}", Детальное описание - {=Variable:DESCRIPTION}, Тип детального описания - HTML.
Изменение режима количественного учета вариации товара	Параметры: ID вариации - {=Variable:OFFER_ID}, Режим количественного учета - Включен, Доступное количество - {=Variable:QUANTITY}.
Обновление параметров подписки для вариации товара	Параметры: ID вариации - {=Document:OFFER_ID}, Единица времени периода оплаты - Месяц, Разрешение подписки на товар - Да.
Массовое обновление вариаций товара через итератор	Параметры: ID вариации - {=Iterator:Value}, Активность - Да, Доступность к покупке - Да, НДС включен в цену - Да.
Обновление вариации товара при изменении статуса сделки	Параметры: ID вариации - {=Document:OFFER_ID}, Активность - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}, Доступность к покупке - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}.
Обновление вариации товара для товара под заказ	Параметры: ID вариации - {=Variable:OFFER_ID}, Разрешение покупки при отсутствии товара - Да, Доступное количество - 0, Доступность к покупке - Да.

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

Обязательные параметры:
Для успешного обновления вариации товара обязательно должен быть заполнен следующий параметр:
- ID вариации (id).

Проверка существования вариации:
Активити (робот) проверяет существование указанной вариации перед обновлением. Если вариация с указанным ID не существует, активити (робот) завершится с ошибкой.

Обработка boolean полей:
Поля типа boolean (Активность, Доступность к покупке, НДС включен в цену и др.) принимают значения "Y" (Да) или "N" (Нет) и автоматически преобразуются в соответствующий формат при отправке в API.

Обновление только указанных полей:
Активити (робот) обновляет только те поля, которые указаны в параметрах. Поля, которые не указаны, остаются без изменений.

Порядок параметров:
Параметры ID вариации и Наименование всегда отображаются первыми в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на обновление вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству обновляемых вариаций:
При массовом обновлении вариаций через итератор рекомендуется не обновлять более 100 вариаций за один запуск бизнес-процесса. Для массового обновления используйте модуль "Массовый запуск Бизнес-процессов".

Часовые пояса в активити

Параметры дат и часовые пояса в активити.

Когда вы заполняете поля с датами, нужно учитывать, что значение "Время сервера" не сохраняет часовой пояс для формул {-System:Now}. 
Это значение работает только со статическим значением даты и времени. На практике такой сценарий обычно не используется.  Дата и время рассчитываются динамически.

Для того чтобы сделать поддержку часовых пояса для формул, в том числе, чтобы не сбрасывалось значение при сохранении активити, необходимо перевести текущее время во время необходимого пользователя.

В переменной типа "Дата" и "Дата\Время" в БП сейчас уже имеется информация о смещении, поэтому там оно не нужно.

=toUserDate({=Document:ASSIGNED_BY_ID})  - эта формула используется для того, чтобы привести текущее значение даты и времени к времени пользователя.

=workdateadd({=System:Now}, "2h", {=Document:ASSIGNED_BY_ID}) - эта функция позволяет добавлять определенное время к текущему времени (согласно настройкам часового пояса на ПК пользователя), т.е если по МСК 12:00, то эта формула прибавит N-е количество часов, например 2 и получится 14:00.

Установка и удаление активити на коробочном портале

Установка

1. Заходим в административный раздел, в папку "Контент".
2. Далее "файлы и папки" и переходим в раздел  bitrix/modules/
   
3. Распакуйте архив в папку bitrix/modules/ в корневом каталоге портала с помощью "загрузить".
   
4. Выбираем архив и загружаем.
   
5. Находим архив, нажимаем ПКМ (прав кн мыши) и распаковать (обязательно проверяем, чтобы адрес распаковки был bitrix/modules/)
   
6. После распаковки появится директория kosasrobots
   
7. Далее переходим в настройки/модули и находим модуль "Лаборатория роботов (kosasrobots)" и нажимаем "Установить".
8. После установки, переходите в конструктор БП и используете.
   

Удаление

1. В административном разделе переходим в настройки/модули и находим модуль "Лаборатория роботов (kosasrobots)" и нажимаем "Удалить".
   
2. Далее переходим в "файлы и папки", потом в раздел  bitrix/modules/
3. Находим папку kosasrobots и удаляем её.
4. Удаление завершено.

Торговый каталог

Каталог

Поиск торгового каталога

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

• Поиск торговых каталогов по идентификатору информационного блока;
• Поиск каталогов по типу информационного блока;
• Поиск каталогов по идентификатору каталога;
• Поиск каталогов по сайту (lid);
• Поиск каталогов по названию;
• Поиск каталогов по идентификатору родительского информационного блока товаров;
• Поиск каталогов по идентификатору свойства SKU;
• Фильтрация каталогов по параметрам продажи контента;
• Поиск каталогов по идентификатору НДС;
• Фильтрация каталогов по параметру экспорта в Яндекс.Маркет;
• Ограничение количества результатов поиска;
• Автоматизация процессов на основе найденных каталогов.

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей торгового каталога из CRM вашего портала;
- Для каждого поля (кроме недоступных для поиска) создаётся параметр, который можно использовать для фильтрации;
- Поддерживается поиск по различным параметрам каталога (идентификатор блока, тип блока, название и т.д.);
- Можно указать ограничение на количество возвращаемых результатов;
- Результаты возвращаются в виде массива ID каталогов, строки с ID через запятую, первого и последнего ID, количества найденных каталогов;
- Активити (робот) работает через REST API Битрикс24 (catalog.catalog.list);
- Поддерживается обработка больших объёмов данных (более 50 каталогов) через batch-запросы.

Активити (робот) анализирует указанные параметры поиска и находит торговые каталоги, удовлетворяющие заданным условиям. Для поиска можно использовать любые доступные поля каталога. Результатом будет массив ID найденных каталогов и дополнительная информация о результатах поиска.

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

Название поля	Описание и примеры использования
Идентификатор информационного блока	В данном поле указывается идентификатор информационного блока для поиска каталогов. Это необязательный параметр типа "Число". Примеры: - 21 - найти каталоги с идентификатором информационного блока 21; - {=Variable:IBLOCK_ID} - использовать ID из переменной предыдущего активити (робота); - {=Document:IBLOCK_ID} - использовать ID из поля документа.
Тип информационного блока	В данном поле указывается тип информационного блока для поиска каталогов. Это необязательный параметр типа "Строка". Примеры: - CRM_PRODUCT_CATALOG - найти каталоги с типом "CRM_PRODUCT_CATALOG"; - {=Variable:IBLOCK_TYPE} - использовать тип из переменной предыдущего активити (робота).
Идентификатор каталога	В данном поле указывается идентификатор каталога для поиска. Это необязательный параметр типа "Число". Примеры: - 21 - найти каталог с идентификатором 21; - {=Variable:CATALOG_ID} - использовать ID из переменной предыдущего активити (робота).
Сайт	В данном поле указывается код сайта (lid) для поиска каталогов. Это необязательный параметр типа "Строка". Примеры: - s1 - найти каталоги для сайта s1; - {=Variable:SITE_ID} - использовать код сайта из переменной предыдущего активити (робота).
Название	В данном поле указывается название каталога для поиска. Это необязательный параметр типа "Строка". Примеры: - Товарный каталог CRM - найти каталоги с названием "Товарный каталог CRM"; - {=Variable:CATALOG_NAME} - использовать название из переменной предыдущего активити (робота).
Идентификатор родительского информационного блока товаров	В данном поле указывается идентификатор родительского информационного блока товаров. Это необязательный параметр типа "Число". Примеры: - 22 - найти каталоги с идентификатором родительского блока 22; - {=Variable:PARENT_IBLOCK_ID} - использовать ID из переменной предыдущего активити (робота).
Идентификатор свойства, в котором храниться ссылка на родительский элемент информационного блока Товаров	В данном поле указывается идентификатор свойства SKU. Это необязательный параметр типа "Число". Примеры: - 15 - найти каталоги с идентификатором свойства SKU 15; - {=Variable:SKU_PROPERTY_ID} - использовать ID из переменной предыдущего активити (робота).
Продажа контента	В данном поле указывается параметр продажи контента (Y/N). Это необязательный параметр типа "Да/Нет". Примеры: - Да (Y) - найти каталоги с включенной продажей контента; - Нет (N) - найти каталоги с отключенной продажей контента.
Идентификатор НДС	В данном поле указывается идентификатор НДС для поиска каталогов. Это необязательный параметр типа "Число". Примеры: - 5 - найти каталоги с идентификатором НДС 5; - {=Variable:VAT_ID} - использовать ID из переменной предыдущего активити (робота).
Экспортировать в Яндекс.Маркет	В данном поле указывается параметр экспорта в Яндекс.Маркет (Y/N). Это необязательный параметр типа "Да/Нет". Примеры: - Да (Y) - найти каталоги с включенным экспортом в Яндекс.Маркет; - Нет (N) - найти каталоги с отключенным экспортом в Яндекс.Маркет.
Ограничение количества результатов	В данном поле можно указать максимальное количество возвращаемых результатов поиска. Это необязательный параметр типа "Число". Если не указано, возвращаются все найденные каталоги. Примеры: - 10 - вернуть только первые 10 найденных каталогов; - 50 - вернуть только первые 50 найденных каталогов; - {=Variable:LIMIT} - использовать ограничение из переменной предыдущего активити (робота).

Важно: Для выполнения поиска необходимо указать хотя бы один параметр поиска. Если все параметры пусты, активити (робот) вернёт ошибку "Ни один параметр для поиска не был заполнен".

Возвращаемые параметры

После успешного выполнения поиска активити (робот) возвращает следующие параметры:

math_search_results - результат поиска (Y - найдены каталоги, N - каталоги не найдены);
count_search - количество найденных каталогов (число);
search_results_array - массив ID найденных каталогов (множественное поле типа "Число");
search_results_string - строка с ID найденных каталогов через запятую (например: "21,22,23");
search_result_first_string - ID первого найденного каталога (строка);
search_result_last_string - ID последнего найденного каталога (строка);
s_error_logs - сообщение об ошибке или информационное сообщение (строка).

Важно о возвращаемых параметрах: Если поиск не дал результатов, параметр math_search_results будет равен "N", а параметр s_error_logs будет содержать сообщение об ошибке "Каталоги не найдены". Массив search_results_array будет пустым.

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

Описание примера	Решение
Найти каталог по идентификатору информационного блока 21	Идентификатор информационного блока — 21. Результат: search_results_array содержит [21], search_results_string = "21", search_result_first_string = "21", search_result_last_string = "21", count_search = 1.
Найти каталоги с типом "CRM_PRODUCT_CATALOG" и ограничить результат до 5 каталогов	Тип информационного блока — CRM_PRODUCT_CATALOG; Ограничение количества результатов — 5. Результат: search_results_array содержит массив ID (максимум 5 элементов), count_search показывает количество найденных каталогов.
Найти каталог по названию "Товарный каталог CRM"	Название — Товарный каталог CRM. Результат: search_results_array содержит ID найденного каталога, search_results_string содержит строку с ID.
Найти каталоги с включенным экспортом в Яндекс.Маркет	Экспортировать в Яндекс.Маркет — Да (Y). Результат: search_results_array содержит массив ID всех каталогов с включенным экспортом.
Найти каталоги по идентификатору НДС из переменной	Идентификатор НДС — {=Variable:VAT_ID}. Результат: search_results_array содержит ID каталогов с указанным НДС.
Найти каталоги для конкретного сайта с ограничением результатов	Сайт — s1; Ограничение количества результатов — 10. Результат: search_results_array содержит максимум 10 ID каталогов для сайта s1.
Найти каталоги по нескольким параметрам одновременно	Идентификатор информационного блока — 21; Тип информационного блока — CRM_PRODUCT_CATALOG; Название — Товарный каталог CRM. Результат: search_results_array содержит ID каталогов, удовлетворяющих всем условиям.
Найти каталоги с отключенной продажей контента	Продажа контента — Нет (N). Результат: search_results_array содержит ID всех каталогов с отключенной продажей контента.
Использовать результат поиска в итераторе для обработки каждого каталога	Идентификатор информационного блока — {=Variable:IBLOCK_ID}. Результат: search_results_array передаётся в итератор, который обрабатывает каждый найденный каталог. В итераторе используется {=Iterator:Value} для получения ID текущего каталога.
Найти первый каталог и использовать его ID в следующем активити	Идентификатор информационного блока — 21. Результат: search_result_first_string содержит ID первого найденного каталога, который можно использовать в следующем активити как {=A1988_22222_92566_99999:search_result_first_string}.

Пример возвращаемых данных

При успешном выполнении поиска активити (робот) возвращает данные в следующем формате:

Пример данных каталога:
"iblockId": "21"
"iblockTypeId": "CRM_PRODUCT_CATALOG"
"id": "21"
"lid": "s1"
"name": "Товарный каталог CRM"
"productIblockId": null
"skuPropertyId": null
"subscription": "N"
"vatId": "5"
"yandexExport": "N"

Возвращаемые параметры активити:
math_search_results = "Y"
count_search = 1
search_results_array = ["21"]
search_results_string = "21"
search_result_first_string = "21"
search_result_last_string = "21"
s_error_logs = "catalog_catalog_search_error_2: 1"

Примечание: Если найдено несколько каталогов, массив search_results_array будет содержать все ID найденных каталогов, а search_results_string будет содержать строку с ID через запятую (например: "21,22,23"). Параметр search_result_first_string содержит ID первого элемента массива, а search_result_last_string - ID последнего элемента массива.

Складской учет

Добавить документ складского учета

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

• Автоматическое создание документов складского учета при поступлении товаров на склад;
• Создание документов оприходования товаров при приемке;
• Автоматизация документооборота при перемещении товаров между складами;
• Создание документов возврата товаров от поставщиков;
• Автоматическое списание товаров со склада;
• Создание документов с автоматическим добавлением товарных позиций;
• Привязка документов к поставщикам (контактам или компаниям);
• Автоматическое проведение документов после создания;
• Интеграция складского учета с бизнес-процессами CRM;
• Массовое создание документов складского учета через бизнес-процессы.

Как работает активити (робот):
- Активити (робот) создаёт новый документ складского учета через API catalog.document.add;
- Поддерживается создание документов различных типов: приход, оприходование, перемещение, возврат, списание;
- После создания документа автоматически добавляются поставщики (контакт или компания), если они указаны;
- Поддерживается автоматическое добавление товаров к документу с указанием количества, цены и складов;
- При указании нескольких товаров используется batch-запрос для оптимизации производительности;
- Поддерживается автоматическое проведение документа после создания, если указан параметр "Провести документ";
- Активити (робот) возвращает ID созданного документа для использования в дальнейших шагах бизнес-процесса;
- Активити (робот) работает через REST API Битрикс24 (catalog.document.add, catalog.documentcontractor.add, catalog.document.element.add, catalog.document.conduct).

Сценарий работы активити (робота) бизнес-процесса

  Активити (робот) создаёт документ складского учета с указанными параметрами. После успешного создания документа автоматически добавляются поставщики (если указаны), затем товары (если указаны), и в конце документ проводится (если указан параметр "Провести документ"). Результатом работы является ID созданного документа, который можно использовать в последующих шагах бизнес-процесса.

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

Название поля	Описание и примеры использования
Тип документа	В данном поле указывается тип создаваемого документа складского учета. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Приход товара на склад (A) - для документов поступления товаров на склад; - Оприходование товара (S) - для документов оприходования товаров; - Перемещение товара между складами (M) - для документов перемещения товаров; - Возврат товара (R) - для документов возврата товаров; - Списание товара (D) - для документов списания товаров. Примеры: - Приход товара на склад (A) - создать документ прихода товаров; - Перемещение товара между складами (M) - создать документ перемещения; - Списание товара (D) - создать документ списания товаров. Когда использовать: - Для документирования различных операций складского учета; - Для автоматизации процессов приёмки и отгрузки товаров; - Для учета перемещений товаров между складами.
Заголовок документа	В данном поле указывается заголовок создаваемого документа. Это необязательный параметр типа "Строка". Примеры: - Приход товара от поставщика №123; - Перемещение товаров со склада А на склад Б; - Списание товара {=Document:TITLE}; - Документ от {=System:NowLocal}; - ={{={=Variable:SUPPLIER_NAME} & " - Приход товара"}} - объединить переменную с текстом.
Номер документа	В данном поле указывается номер создаваемого документа. Это необязательный параметр типа "Строка". Примеры: - ПР-001; - ДОК-{=Document:ID}; - ={{=date('Ymd') & "-" & {=Variable:COUNTER}}}} - сгенерировать номер с датой и счётчиком; - {=Variable:DOC_NUMBER} - использовать номер из переменной предыдущего активити (робота).
Общая сумма товаров	В данном поле указывается общая сумма товаров в документе. Это необязательный параметр типа "Число". Примеры: - 150000 - указать сумму 150000; - {=Variable:TOTAL_AMOUNT} - использовать сумму из переменной предыдущего активити (робота); - ={{={=Variable:QUANTITY} * {=Variable:PRICE}}}} - рассчитать сумму из количества и цены.
Валюта	В данном поле указывается валюта документа. Это обязательный параметр. Выбирается из выпадающего списка доступных валют портала. Варианты выбора: - Рубль (RUB) - российский рубль; - Доллар (USD) - доллар США; - Евро (EUR) - евро; - Другие валюты, настроенные в вашем портале. Примеры: - Рубль (RUB) - использовать рубли; - Доллар (USD) - использовать доллары; - {=Variable:CURRENCY} - использовать валюту из переменной (если переменная содержит код валюты).
Комментарий	В данном поле указывается комментарий к документу. Это необязательный параметр типа "Строка". Примеры: - Документ создан автоматически; - Приход товара от поставщика {=Variable:SUPPLIER_NAME}; - ={{="Основание: " & {=Document:TITLE}}}} - добавить комментарий с информацией из документа.
Ответственный	В данном поле указывается ответственный за документ сотрудник. Это обязательный параметр типа "Пользователь". Примеры: - {=Document:ASSIGNED_BY_ID} - назначить ответственного из текущего документа; - {=User:ID} - назначить ответственным текущего пользователя; - [U1] - назначить ответственным пользователя с ID 1; - user_25 - назначить ответственным пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Важно: При выборе сотрудника, в поле должен быть указан только его ID без лишних символов (или в формате user_ID). Если пользователь не найден по указанному ID, документ не будет создан.
Поставщик (контакт)	В данном поле указывается идентификатор контакта-поставщика, который будет привязан к документу. Это необязательный параметр типа "Число". Важно: Необходимо выбирать контакты ТОЛЬКО из раздела "Клиенты > Поставщики". Обычные контакты из раздела CRM не подойдут. Если указан ID обычного контакта (не из раздела поставщиков), операция завершится с ошибкой. Примеры: - 123 - привязать контакт-поставщик с ID 123 из раздела "Клиенты > Поставщики"; - {=Variable:SUPPLIER_CONTACT_ID} - использовать ID контакта-поставщика из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать ID из результата поиска контактов-поставщиков. Когда использовать: - Для привязки документа к контакту-поставщику из раздела "Клиенты > Поставщики"; - Для автоматизации документооборота с поставщиками-контактами; - Если указан, контакт автоматически добавляется к документу после его создания.
Поставщик (компания)	В данном поле указывается идентификатор компании-поставщика, которая будет привязана к документу. Это необязательный параметр типа "Число". Важно: Необходимо выбирать компании ТОЛЬКО из раздела "Клиенты > Поставщики". Обычные компании из раздела CRM не подойдут. Если указан ID обычной компании (не из раздела поставщиков), операция завершится с ошибкой. Примеры: - 456 - привязать компанию-поставщик с ID 456 из раздела "Клиенты > Поставщики"; - {=Variable:SUPPLIER_COMPANY_ID} - использовать ID компании-поставщика из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать ID из результата поиска компаний-поставщиков. Когда использовать: - Для привязки документа к компании-поставщику из раздела "Клиенты > Поставщики"; - Для автоматизации документооборота с поставщиками-компаниями; - Если указана, компания автоматически добавляется к документу после его создания.
Товар	В данном поле указываются товары, которые будут добавлены к документу. Это необязательный параметр типа "Строка" с множественным значением. Каждый товар указывается в строгой последовательности через разделитель ## в формате: id товара##Количество##Цена##Склад источник##Склад получатель. Формат записи товара: - Первое значение (id товара) - идентификатор товара в каталоге (число); - Второе значение (Количество) - количество товара (число с плавающей точкой); - Третье значение (Цена) - цена за единицу товара (число с плавающей точкой); - Четвёртое значение (Склад источник) - идентификатор склада-источника (число); - Пятое значение (Склад получатель) - идентификатор склада-получателя (число). Примеры: - 312##15##1250.5##2##3 - добавить товар с ID 312, количеством 15, ценой 1250.5, со склада 2 на склад 3; - {=Variable:PRODUCT_ID}##{=Variable:QUANTITY}##{=Variable:PRICE}##1##2 - использовать значения из переменных; - 100##10##500##1##1 - добавить товар с ID 100, количеством 10, ценой 500, со склада 1 на склад 1 (для прихода); - Для добавления нескольких товаров укажите каждую строку отдельно в множественном поле. Важно: Формат записи товара должен строго соблюдаться. Все пять значений должны быть указаны через разделитель ##. Если формат не соблюдён (не указаны все 5 значений), активити (робот) завершится с ошибкой "Вы неправильно заполнили товар". Когда использовать: - Для автоматического добавления товаров к документу при его создании; - Для массового добавления товаров через множественное поле; - Для автоматизации заполнения документов товарными позициями.
Провести документ	В данном поле указывается, нужно ли автоматически провести документ после его создания. Это необязательный параметр типа "Да/Нет". Варианты выбора: - Да (Y) - провести документ автоматически после создания; - Нет (N) - оставить документ непроведённым. Примеры: - Да (Y) - автоматически провести документ после создания; - Нет (N) - создать документ без проведения (можно провести вручную позже). Когда использовать: - Для автоматического проведения документов при создании; - Для документов, которые не требуют дополнительной проверки перед проведением; - Если не указано, документ будет создан без проведения.

Важно: Для успешного создания документа необходимо указать обязательные параметры: "Тип документа", "Валюта" и "Ответственный". Если хотя бы один из обязательных параметров не указан, активити (робот) завершится с ошибкой.

Возвращаемые параметры

После успешного выполнения активити (робот) возвращает следующие параметры:

id_new_document - идентификатор созданного документа складского учета (число);
ok_ready - результат выполнения активити (робота) (Y - документ успешно создан, N - произошла ошибка).

Важно о возвращаемых параметрах: Если при создании документа произошла ошибка, параметр ok_ready будет равен "N", и активити (робот) завершится с сообщением об ошибке. Параметр id_new_document будет доступен только при успешном создании документа.

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

Описание примера	Решение
Создать документ прихода товара на склад с указанием поставщика-контакта	Тип документа — Приход товара на склад (A); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Заголовок документа — Приход товара от поставщика; Поставщик (контакт) — {=Document:CONTACT_ID}. Результат: id_new_document содержит ID созданного документа, к которому привязан контакт-поставщик.
Создать документ перемещения товаров между складами с добавлением товаров	Тип документа — Перемещение товара между складами (M); Валюта — Рубль (RUB); Ответственный — {=Document:ASSIGNED_BY_ID}; Товар — 312##15##1250.5##2##3 (товар ID 312, количество 15, цена 1250.5, со склада 2 на склад 3). Результат: id_new_document содержит ID созданного документа с добавленным товаром.
Создать документ оприходования товара с автоматическим проведением	Тип документа — Оприходование товара (S); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — 100##10##500##1##1; Провести документ — Да (Y). Результат: id_new_document содержит ID созданного и проведённого документа.
Создать документ возврата товара с привязкой к компании-поставщику	Тип документа — Возврат товара (R); Валюта — Доллар (USD); Ответственный — {=Document:ASSIGNED_BY_ID}; Поставщик (компания) — {=Document:COMPANY_ID}; Заголовок документа — Возврат товара поставщику. Результат: id_new_document содержит ID созданного документа, к которому привязана компания-поставщик.
Создать документ списания товара с несколькими товарными позициями	Тип документа — Списание товара (D); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — 200##5##1000##1##0, 201##3##1500##1##0 (два товара: ID 200 и 201, со склада 1, получатель 0 для списания). Результат: id_new_document содержит ID созданного документа с двумя добавленными товарами через batch-запрос.
Создать документ прихода с использованием данных из переменных	Тип документа — Приход товара на склад (A); Валюта — {=Variable:CURRENCY}; Ответственный — {=Variable:RESPONSIBLE_ID}; Заголовок документа — {=Variable:DOC_TITLE}; Номер документа — {=Variable:DOC_NUMBER}; Общая сумма товаров — {=Variable:TOTAL_AMOUNT}. Результат: id_new_document содержит ID созданного документа с данными из переменных.
Создать документ перемещения с товаром из результата поиска	Тип документа — Перемещение товара между складами (M); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — {=A1988_22222_92566_99999:search_result_first_string}##10##500##1##2 (ID товара из результата поиска, количество 10, цена 500, со склада 1 на склад 2). Результат: id_new_document содержит ID созданного документа с товаром из поиска.
Создать документ прихода с товаром и автоматическим проведением	Тип документа — Приход товара на склад (A); Валюта — Рубль (RUB); Ответственный — {=Document:ASSIGNED_BY_ID}; Товар — 150##20##750##0##1 (товар ID 150, количество 20, цена 750, источник 0, получатель склад 1); Провести документ — Да (Y). Результат: id_new_document содержит ID созданного, заполненного товаром и проведённого документа.
Создать документ оприходования с комментарием из поля документа	Тип документа — Оприходование товара (S); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Комментарий — Оприходование товара по сделке {=Document:ID}. Результат: id_new_document содержит ID созданного документа с комментарием, содержащим ID сделки.
Создать документ списания с использованием ID документа в итераторе	Тип документа — Списание товара (D); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — {=Iterator:Value}##1##100##1##0 (ID товара из итератора, количество 1, цена 100, со склада 1, получатель 0). Результат: для каждого товара в итераторе создаётся документ списания с соответствующим товаром.

Пример возвращаемых данных

При успешном выполнении активити (робот) возвращает данные в следующем формате:

Пример данных при успешном создании документа:
id_new_document = 142
ok_ready = "Y"

Использование результата в следующем активити:
Для использования ID созданного документа в следующем активити (роботе) используйте:
{=A1988_22222_92566_99999:id_new_document}
где A1988_22222_92566_99999 - это код активити (робота) "Добавить документ складского учета".

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

Товар

Создание товара торгового каталога

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

• Автоматическое создание товара в торговом каталоге при добавлении нового товара в систему;
• Создание товара с различными характеристиками (наименование, код, размеры, вес, цены);
• Автоматизация создания товара на основе данных из сделок или других сущностей CRM;
• Массовое создание товаров при импорте данных из внешних систем;
• Автоматическое создание товара при изменении статуса сделки;
• Создание товара для товаров с различными ценами и валютой;
• Автоматизация создания товара при работе с торговым каталогом;
• Создание товара с указанием количества и резервирования;
• Автоматическое создание товара при синхронизации с внешними каталогами;
• Создание товара с указанием раздела каталога для организации структуры товаров.

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

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

Название поля	Описание и примеры использования
Наименование	В данном поле указывается текстовое наименование создаваемого товара. Это обязательный параметр. Примеры использования: - Новый товар - простое наименование; - {=Document:TITLE} - использовать наименование из документа (сделки); - Товар {=Variable:PRODUCT_NAME} - размер {=Variable:SIZE} - использовать наименование из переменной; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
ID каталога	В данном поле указывается каталог, в который будет добавлен товар. Это обязательный параметр. Выбирается из выпадающего списка доступных каталогов. Примеры использования: - Выбрать каталог из списка - выбрать нужный каталог из выпадающего списка; - {=Variable:CATALOG_ID} - использовать ID каталога из переменной предыдущего активити (робота); - {=Document:CATALOG_ID} - использовать ID каталога из поля документа. Важно: Убедитесь, что выбранный каталог существует в системе. Если каталог с указанным ID не существует, активити (робот) завершится с ошибкой.
ID раздела каталога	В данном поле указывается числовой идентификатор (ID) раздела каталога, в который будет добавлен товар. Это необязательный параметр. Примеры использования: - 123 - добавить товар в раздел с ID 123; - {=Variable:SECTION_ID} - использовать ID раздела из переменной предыдущего активити (робота); - {=Document:SECTION_ID} - использовать ID раздела из поля документа; - {=A1988_22222_92566_99999:section_id} - использовать ID раздела из результата поиска. Важно: Если раздел не указан, товар будет добавлен в корневой раздел каталога. Убедитесь, что указанный раздел существует в выбранном каталоге.
Активность	В данном поле указывается, будет ли товар активен. Это необязательный параметр. Варианты выбора: - Да (Y) - товар будет активен и доступен для использования; - Нет (N) - товар будет неактивен. Примеры использования: - Да - создать активный товар; - Нет - создать неактивный товар для последующей активации.
Доступность к покупке	В данном поле указывается, доступен ли товар для покупки. Это необязательный параметр. Варианты выбора: - Да (Y) - товар доступен для покупки; - Нет (N) - товар недоступен для покупки. Примеры использования: - Да - создать товар, доступный для покупки; - Нет - создать товар, который временно недоступен для покупки.
Уникальные штрихкоды для каждого экземпляра	В данном поле указывается, используются ли уникальные штрихкоды для каждого экземпляра товара. Это необязательный параметр. Варианты выбора: - Да (Y) - используются уникальные штрихкоды; - Нет (N) - не используются уникальные штрихкоды. Примеры использования: - Да - для товаров, где каждый экземпляр имеет свой уникальный штрихкод; - Нет - для товаров, где все экземпляры имеют одинаковый штрихкод.
Наличие набора	В данном поле указывается, является ли товар набором. Это необязательный параметр. Варианты выбора: - Да (Y) - товар является набором; - Нет (N) - товар не является набором. Примеры использования: - Да - для товаров, которые представляют собой набор товаров; - Нет - для обычных товаров.
Разрешение покупки при отсутствии товара	В данном поле указывается, разрешена ли покупка товара при отсутствии товара на складе. Это необязательный параметр. Варианты выбора: - Да (Y) - покупка разрешена даже при отсутствии товара; - Нет (N) - покупка запрещена при отсутствии товара. Примеры использования: - Да - для товаров, которые можно заказать под заказ; - Нет - для товаров, которые можно купить только при наличии на складе.
Символьный код	В данном поле указывается символьный код товара. Это необязательный параметр. Примеры использования: - Символьный код - простой код; - {=Variable:PRODUCT_CODE} - использовать код из переменной; - ={{={=Document:PRODUCT_CODE} & "_" & {=Variable:VARIANT_CODE}}}} - объединение кодов.
Детальное описание	В данном поле указывается детальное описание товара. Это необязательный параметр. Примеры использования: - Детальное описание - простое описание; - {=Variable:DESCRIPTION} - использовать описание из переменной; - Описание товара с характеристиками: размер {=Variable:SIZE}, цвет {=Variable:COLOR} - комбинированное описание.
Тип детального описания	В данном поле указывается тип детального описания товара. Это необязательный параметр. Варианты выбора: - Текст (text) - обычный текст; - HTML (html) - HTML-разметка. Примеры использования: - Текст - для простого текстового описания; - HTML - для описания с HTML-разметкой.
Валюта закупочной цены	В данном поле указывается валюта закупочной цены товара. Это необязательный параметр. Варианты выбора: - Рубль (RUB); - Доллар США (USD); - Евро (EUR). Примеры использования: - RUB - для товаров с ценой в рублях; - USD - для товаров с ценой в долларах; - EUR - для товаров с ценой в евро.
Доступное количество	В данном поле указывается доступное количество товара на складе. Это необязательный параметр. Примеры использования: - 1 - указать количество 1; - {=Variable:QUANTITY} - использовать количество из переменной; - ={{=intval({=Document:QUANTITY})}} - преобразовать количество из документа в целое число.
Режим количественного учета	В данном поле указывается режим количественного учета товара. Это необязательный параметр. Варианты выбора: - Включен (Y) - количественный учет включен; - Выключен (N) - количественный учет выключен; - По умолчанию (D) - использовать настройки по умолчанию. Примеры использования: - Включен - для товаров, где требуется точный учет количества; - Выключен - для товаров, где количественный учет не требуется; - По умолчанию - использовать настройки каталога.
Единица времени периода оплаты	В данном поле указывается единица времени периода оплаты для товара. Это необязательный параметр. Варианты выбора: - Час (H); - День (D); - Неделя (W); - Месяц (M); - Квартал (Q); - Полугодие (S); - Год (Y). Примеры использования: - Месяц - для подписок с ежемесячной оплатой; - Год - для подписок с годовой оплатой.
НДС включен в цену	В данном поле указывается, включен ли НДС в цену товара. Это необязательный параметр. Варианты выбора: - Да (Y) - НДС включен в цену; - Нет (N) - НДС не включен в цену. Примеры использования: - Да - для товаров, где НДС уже включен в цену; - Нет - для товаров, где НДС добавляется к цене.

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

Описание примера	Решение
Создание товара при добавлении нового товара в каталог	Параметры: Наименование - {=Variable:PRODUCT_NAME}, ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Разрешение покупки при отсутствии товара - Нет, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание товара с указанием раздела каталога	Параметры: Наименование - "Товар {=Document:TITLE}", ID каталога - {=Variable:CATALOG_ID}, ID раздела каталога - {=Variable:SECTION_ID}, Активность - Да, Доступность к покупке - Да, НДС включен в цену - Да.
Создание товара для товара с подпиской	Параметры: Наименование - "Подписка на {=Variable:SERVICE_NAME}", ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Разрешение подписки на товар - Да, Единица времени периода оплаты - Месяц, Длина периода оплаты - 1, НДС включен в цену - Да.
Создание товара с указанием закупочной цены в валюте	Параметры: Наименование - "Товар {=Document:TITLE}", ID каталога - {=Document:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Валюта закупочной цены - USD, Закупочная цена - {=Variable:PURCHASE_PRICE}, НДС включен в цену - Нет.
Создание товара с количественным учетом	Параметры: Наименование - "Товар с учетом количества", ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Режим количественного учета - Включен, Доступное количество - {=Variable:QUANTITY}, Зарезервированное количество - {=Variable:RESERVED_QUANTITY}, НДС включен в цену - Да.
Создание товара для товара под заказ	Параметры: Наименование - "Товар {=Document:TITLE} под заказ", ID каталога - {=Document:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Разрешение покупки при отсутствии товара - Да, Доступное количество - 0, НДС включен в цену - Да.
Создание товара с детальным описанием в HTML	Параметры: Наименование - "Товар с HTML описанием", ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Детальное описание - {=Variable:HTML_DESCRIPTION}, Тип детального описания - HTML, НДС включен в цену - Да.
Создание товара для набора товаров	Параметры: Наименование - "Набор товаров {=Document:TITLE}", ID каталога - {=Document:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Наличие набора - Да, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание товара с уникальными штрихкодами	Параметры: Наименование - "Товар с уникальными штрихкодами", ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Уникальные штрихкоды для каждого экземпляра - Да, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Массовое создание товаров через итератор	Параметры: Наименование - "Товар #{=Iterator:Value}", ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Доступное количество - 1, НДС включен в цену - Да.

Возвращаемые параметры данного активити (робота):
- ID нового товара каталога (id_new_product) - числовой идентификатор созданного товара, который можно использовать для дальнейших операций в бизнес-процессе.
- Готовность операции (ok_ready) - логическое значение (true/false), указывающее, была ли операция успешной.

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

Важно о возвращаемых параметрах: Если создание товара завершилось с ошибкой, параметр id_new_product будет равен null, а ok_ready будет равен false. Всегда проверяйте значение возвращаемых параметров перед использованием в дальнейших шагах бизнес-процесса.

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

Обязательные параметры:
Для успешного создания товара обязательно должны быть заполнены следующие параметры:
- Наименование (name);
- ID каталога (iblockId).

Проверка существования каталога:
Активити (робот) проверяет существование указанного каталога перед созданием товара. Если каталог с указанным ID не существует, активити (робот) завершится с ошибкой.

Обработка boolean полей:
Поля типа boolean (Активность, Доступность к покупке, НДС включен в цену и др.) принимают значения "Y" (Да) или "N" (Нет) и автоматически преобразуются в соответствующий формат при отправке в API.

Порядок параметров:
Параметры Наименование, ID каталога и ID раздела каталога всегда отображаются первыми в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на создание товаров в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству создаваемых товаров:
При массовом создании товаров через итератор рекомендуется не создавать более 100 товаров за один запуск бизнес-процесса. Для массового создания используйте модуль "Массовый запуск Бизнес-процессов".

Удаление товара торгового каталога

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

• Удаление товаров по их ID;
• Удаление неактивных или устаревших товаров;
• Удаление товаров с нулевым количеством на складе;
• Массовое удаление товаров, соответствующих определённым критериям;
• Очистка старых или неактуальных товаров;
• Удаление товаров после выполнения определённых условий в бизнес-процессе;
• Автоматическое удаление товаров при изменении статуса сделки;
• Удаление товаров при интеграции с внешними системами;
• Очистка товаров для оптимизации работы с каталогом;
• Удаление тестовых товаров после завершения разработки.

Как работает активити (робот):
- Активити (робот) удаляет товар по указанному ID через REST API Битрикс24;
- Поддерживается удаление только одного товара за один запуск активити (робота);
- Активити (робот) возвращает результат удаления (успешно или нет) для дальнейшего использования в бизнес-процессе;
- Активити (робот) работает через REST API Битрикс24 (catalog.product.delete);
- Для массового удаления товаров используйте итератор с активити (роботом) "Поиск товара торгового каталога".

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

Название поля

Описание и примеры использования

ID товара каталога

В данном поле указывается идентификатор товара торгового каталога, который нужно удалить. Это обязательный параметр. Примеры использования: - {=Variable:PRODUCT_ID} - удалить товар с ID из переменной предыдущего активити (робота); - 123 - удалить товар с ID 123; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата активити (робота) "Поиск товара торгового каталога"; - {=A1988_22222_92566_99999:id_new_product} - использовать ID товара из результата активити (робота) "Создание товара торгового каталога"; - {=Document:PRODUCT_ID} - удалить товар, если ID товара указан в документе; - {=Iterator:Value} - удалить товар для каждого ID из итератора. Как получить ID товара: - Из результата активити (робота) "Создание товара торгового каталога" (параметр id_new_product); - Из результата активити (робота) "Поиск товара торгового каталога" (параметр search_results_array или search_result_first_string); - Из результата активити (робота) "Данные товара каталога" (параметр id); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если товар связан с документом. Важно: Удаление товара торгового каталога является необратимой операцией. После удаления товар нельзя восстановить. Всегда проверяйте необходимость удаления перед выполнением операции. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.

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

Описание примера	Решение
Удаление товара по ID	Параметры: ID товара каталога - {=Variable:PRODUCT_ID}. Активити (робот) удалит товар с указанным ID и вернёт результат удаления в параметре ok_ready (true - успешно, false - ошибка).
Удаление товара после его создания (откат)	Параметры: ID товара каталога - {=A1988_22222_92566_99999:id_new_product}. Активити (робот) удалит только что созданный товар торгового каталога, если он был создан с ошибкой или не соответствует требованиям.
Удаление первого найденного товара	Параметры: ID товара каталога - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) удалит первый товар из результата поиска товаров торгового каталога.
Удаление неактивного товара	Сначала используйте активити (робот) "Поиск товара торгового каталога" с параметром Активность - N для поиска неактивных товаров, затем используйте активити (робот) "Удаление товара торгового каталога" с параметром ID товара каталога - {=A1988_22222_92566_99999:search_result_first_string}.
Удаление товара с нулевым количеством	Сначала используйте активити (робот) "Поиск товара торгового каталога" с параметром Доступное количество - 0 для поиска товаров с нулевым количеством, затем используйте активити (робот) "Удаление товара торгового каталога" с параметром ID товара каталога - {=A1988_22222_92566_99999:search_result_first_string}.
Массовое удаление товаров через итератор	Сначала используйте активити (робот) "Поиск товара торгового каталога" для получения списка ID товаров в параметре search_results_array, затем используйте итератор с активити (роботом) "Удаление товара торгового каталога" с параметром ID товара каталога - {=Iterator:Value}.
Удаление товара при изменении статуса сделки	В условии бизнес-процесса проверьте статус сделки, и если статус соответствует определённому значению, используйте активити (робот) "Удаление товара торгового каталога" с параметром ID товара каталога - {=Document:PRODUCT_ID}.
Удаление тестовых товаров	Сначала используйте активити (робот) "Поиск товара торгового каталога" с параметром Наименование - "Тест" для поиска тестовых товаров, затем используйте итератор с активити (роботом) "Удаление товара торгового каталога" для удаления всех найденных тестовых товаров.
Удаление товара с проверкой результата	Параметры: ID товара каталога - {=Variable:PRODUCT_ID}. После выполнения активити (робота) проверьте возвращаемый параметр ok_ready в условии бизнес-процесса. Если ok_ready = true, товар успешно удалён. Если ok_ready = false, произошла ошибка при удалении.
Удаление товара при интеграции с внешними системами	Параметры: ID товара каталога - {=Variable:EXTERNAL_PRODUCT_ID}. Активити (робот) удалит товар торгового каталога при синхронизации данных с внешней системой, если товар был удалён во внешней системе.

Возвращаемые параметры данного активити (робота):
- Успешное удаление (ok_ready) - логическое значение (true/false), указывающее, было ли удаление успешным.

Значения параметра ok_ready:
- true - товар торгового каталога успешно удалён;
- false - произошла ошибка при удалении товара торгового каталога (товар не существует, нет прав доступа и т.д.).

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

Важно о возвращаемых параметрах: Если удаление завершилось с ошибкой, параметр ok_ready будет равен false. Всегда проверяйте значение возвращаемого параметра перед выполнением дальнейших действий в бизнес-процессе. Удаление товара торгового каталога является необратимой операцией.

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

Обязательные параметры:
Для успешного удаления товара торгового каталога обязательно должен быть заполнен следующий параметр:
- ID товара каталога (id_product).

Проверка существования товара:
Активити (робот) проверяет существование указанного товара перед удалением. Если товар с указанным ID не существует, активити (робот) вернёт ok_ready = false.

Необратимость операции:
Удаление товара торгового каталога является необратимой операцией. После удаления товар нельзя восстановить. Всегда проверяйте необходимость удаления перед выполнением операции.

Массовое удаление:
Для массового удаления товаров используйте комбинацию активити (робота) "Поиск товара торгового каталога" и итератора с активити (роботом) "Удаление товара торгового каталога".

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на удаление товаров в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству удаляемых товаров:
При массовом удалении товаров через итератор рекомендуется не удалять более 100 товаров за один запуск бизнес-процесса. Для массового удаления используйте модуль "Массовый запуск Бизнес-процессов".

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

Данные товара каталога

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

• Автоматическое обновление параметров товара при изменении данных в сделке;
• Обновление количества товара на складе при поступлении или продаже;
• Изменение статуса активности товара в зависимости от условий бизнес-процесса;
• Обновление цен и валюты товара при изменении курса валют;
• Автоматическое обновление характеристик товара при изменении данных в других сущностях CRM;
• Изменение доступности товара для покупки в зависимости от наличия на складе;
• Обновление описания и свойств товара при синхронизации с внешними системами;
• Массовое обновление товаров через итератор;
• Изменение режима количественного учета товара;
• Обновление параметров подписки для товара с периодической оплатой.

Как работает активити (робот):
- Активити (робот) обновляет существующий товар в торговом каталоге CRM с указанными параметрами;
- Для обновления необходимо указать ID товара (обязательный параметр);
- Можно обновить любые параметры товара (наименование, код, размеры, вес, цены);
- Поддерживается обновление параметров активности, доступности, количества и резервирования;
- Можно изменить НДС и валюту закупочной цены;
- Обновляются только те поля, которые указаны в параметрах активити (робота);
- Поддерживается обновление пользовательских свойств товара (property1917, property1925 и др.).

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

Название поля	Описание и примеры использования
ID товара	В данном поле указывается числовой идентификатор (ID) товара, который необходимо обновить. Это обязательный параметр. Примеры использования: - 30287 - обновить товар с ID 30287; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки); - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска товаров; - {=A1988_22222_92566_99999:id_new_product} - использовать ID товара из результата активити (робота) "Создание товара торгового каталога"; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID товара существует в каталоге. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается новое текстовое наименование товара. Это необязательный параметр. Примеры использования: - Тест товара - простое наименование; - {=Document:TITLE} - использовать наименование из документа; - Товар #{=Document:PRODUCT_ID} - {=Variable:COLOR} - комбинированное наименование; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
Активность	В данном поле указывается, будет ли товар активен. Это необязательный параметр. Варианты выбора: - Да (Y) - товар будет активен и доступен для использования; - Нет (N) - товар будет неактивен. Примеры использования: - Да - активировать товар; - Нет - деактивировать товар для временного скрытия из каталога.
Доступность к покупке	В данном поле указывается, доступен ли товар для покупки. Это необязательный параметр. Варианты выбора: - Да (Y) - товар доступен для покупки; - Нет (N) - товар недоступен для покупки. Примеры использования: - Да - сделать товар доступным для покупки; - Нет - временно запретить покупку товара.
Уникальные штрихкоды для каждого экземпляра	В данном поле указывается, используются ли уникальные штрихкоды для каждого экземпляра товара. Это необязательный параметр. Варианты выбора: - Да (Y) - используются уникальные штрихкоды; - Нет (N) - не используются уникальные штрихкоды. Примеры использования: - Да - включить использование уникальных штрихкодов; - Нет - отключить использование уникальных штрихкодов.
Наличие набора	В данном поле указывается, является ли товар набором. Это необязательный параметр. Варианты выбора: - Да (Y) - товар является набором; - Нет (N) - товар не является набором. Примеры использования: - Да - преобразовать товар в набор; - Нет - преобразовать набор в обычный товар.
Разрешение покупки при отсутствии товара	В данном поле указывается, разрешена ли покупка товара при отсутствии товара на складе. Это необязательный параметр. Варианты выбора: - Да (Y) - покупка разрешена даже при отсутствии товара; - Нет (N) - покупка запрещена при отсутствии товара. Примеры использования: - Да - разрешить покупку под заказ; - Нет - запретить покупку при отсутствии товара на складе.
Символьный код	В данном поле указывается новый символьный код товара. Это необязательный параметр. Примеры использования: - Символьный код - простой код; - {=Variable:PRODUCT_CODE} - использовать код из переменной; - ={{={=Document:PRODUCT_CODE} & "_" & {=Variable:VARIANT_CODE}}}} - объединение кодов.
Детальное описание	В данном поле указывается новое детальное описание товара. Это необязательный параметр. Примеры использования: - Детальное описание - простое описание; - {=Variable:DESCRIPTION} - использовать описание из переменной; - Описание товара с характеристиками: размер {=Variable:SIZE}, цвет {=Variable:COLOR} - комбинированное описание.
Тип детального описания	В данном поле указывается тип детального описания товара. Это необязательный параметр. Варианты выбора: - Текст (text) - обычный текст; - HTML (html) - HTML-разметка. Примеры использования: - Текст - изменить тип описания на простой текст; - HTML - изменить тип описания на HTML-разметку.
Валюта закупочной цены	В данном поле указывается валюта закупочной цены товара. Это необязательный параметр. Варианты выбора: - Рубль (RUB); - Доллар США (USD); - Евро (EUR). Примеры использования: - RUB - изменить валюту на рубли; - USD - изменить валюту на доллары; - EUR - изменить валюту на евро.
Доступное количество	В данном поле указывается новое доступное количество товара на складе. Это необязательный параметр. Примеры использования: - 1 - установить количество 1; - {=Variable:QUANTITY} - использовать количество из переменной; - ={{=intval({=Document:QUANTITY})}} - преобразовать количество из документа в целое число.
Режим количественного учета	В данном поле указывается режим количественного учета товара. Это необязательный параметр. Варианты выбора: - Включен (Y) - количественный учет включен; - Выключен (N) - количественный учет выключен; - По умолчанию (D) - использовать настройки по умолчанию. Примеры использования: - Включен - включить количественный учет; - Выключен - выключить количественный учет; - По умолчанию - использовать настройки каталога.
Единица времени периода оплаты	В данном поле указывается единица времени периода оплаты для товара. Это необязательный параметр. Варианты выбора: - Час (H); - День (D); - Неделя (W); - Месяц (M); - Квартал (Q); - Полугодие (S); - Год (Y). Примеры использования: - Месяц - изменить период оплаты на ежемесячный; - Год - изменить период оплаты на годовой.
НДС включен в цену	В данном поле указывается, включен ли НДС в цену товара. Это необязательный параметр. Варианты выбора: - Да (Y) - НДС включен в цену; - Нет (N) - НДС не включен в цену. Примеры использования: - Да - включить НДС в цену; - Нет - исключить НДС из цены.

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

Описание примера	Решение
Обновление количества товара при поступлении на склад	Параметры: ID товара - {=Document:PRODUCT_ID}, Доступное количество - ={{={=Variable:CURRENT_QUANTITY} + {=Variable:INCOMING_QUANTITY}}}}, Режим количественного учета - Включен.
Деактивация товара при отсутствии на складе	Параметры: ID товара - {=Variable:PRODUCT_ID}, Активность - Нет, Доступность к покупке - Нет, Доступное количество - 0.
Обновление цены и валюты товара при изменении курса	Параметры: ID товара - {=Document:PRODUCT_ID}, Валюта закупочной цены - USD, Закупочная цена - {=Variable:NEW_PRICE}, НДС включен в цену - Да.
Активация товара при поступлении на склад	Параметры: ID товара - {=Variable:PRODUCT_ID}, Активность - Да, Доступность к покупке - Да, Доступное количество - {=Variable:QUANTITY}, Разрешение покупки при отсутствии товара - Нет.
Обновление наименования и описания товара	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Товар {=Document:TITLE}", Детальное описание - {=Variable:DESCRIPTION}, Тип детального описания - HTML.
Изменение режима количественного учета товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Режим количественного учета - Включен, Доступное количество - {=Variable:QUANTITY}.
Обновление параметров подписки для товара	Параметры: ID товара - {=Document:PRODUCT_ID}, Единица времени периода оплаты - Месяц, Разрешение подписки на товар - Да.
Массовое обновление товаров через итератор	Параметры: ID товара - {=Iterator:Value}, Активность - Да, Доступность к покупке - Да, НДС включен в цену - Да.
Обновление товара при изменении статуса сделки	Параметры: ID товара - {=Document:PRODUCT_ID}, Активность - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}, Доступность к покупке - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}.
Обновление товара для товара под заказ	Параметры: ID товара - {=Variable:PRODUCT_ID}, Разрешение покупки при отсутствии товара - Да, Доступное количество - 0, Доступность к покупке - Да.

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

Обязательные параметры:
Для успешного обновления товара обязательно должен быть заполнен следующий параметр:
- ID товара (id_product).

Проверка существования товара:
Активити (робот) проверяет существование указанного товара перед обновлением. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.

Обработка boolean полей:
Поля типа boolean (Активность, Доступность к покупке, НДС включен в цену и др.) принимают значения "Y" (Да) или "N" (Нет) и автоматически преобразуются в соответствующий формат при отправке в API.

Обновление только указанных полей:
Активити (робот) обновляет только те поля, которые указаны в параметрах. Поля, которые не указаны, остаются без изменений.

Порядок параметров:
Параметры ID товара и Наименование всегда отображаются первыми в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на обновление товаров в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству обновляемых товаров:
При массовом обновлении товаров через итератор рекомендуется не обновлять более 100 товаров за один запуск бизнес-процесса. Для массового обновления используйте модуль "Массовый запуск Бизнес-процессов".

Поиск товара торгового каталога

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

• Поиск товаров по ID каталога;
• Поиск товаров по различным характеристикам (наименование, код, размеры, вес);
• Фильтрация товаров по параметрам активности и доступности;
• Поиск товаров по количеству на складе;
• Поиск товаров по ценам и валюте;
• Фильтрация товаров по режиму количественного учета;
• Поиск товаров с определёнными свойствами (размер, цвет, артикул);
• Массовый поиск товаров для обработки в итераторе;
• Поиск активных или неактивных товаров;
• Автоматизация процессов на основе найденных товаров.

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей товара из каталога CRM вашего портала;
- Для каждого поля (кроме недоступных для поиска) создаётся параметр, который можно использовать для фильтрации;
- Поддерживается поиск по ID каталога - обязательный параметр;
- Можно указать любые поля товара для фильтрации результатов поиска;
- Поддерживается поиск по множественным критериям одновременно;
- Результаты возвращаются в виде массива ID товаров, строки с ID через запятую, первого и последнего ID, количества найденных товаров;
- Активити (робот) работает через REST API Битрикс24 (catalog.product.list);
- Поддерживается обработка больших объёмов данных (более 50 товаров) через batch-запросы;
- Можно ограничить количество результатов поиска с помощью параметра "Ограничение количества результатов".

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

Название поля	Описание и примеры использования
Каталог	В данном поле указывается каталог товаров, в котором необходимо выполнить поиск. Это обязательный параметр. Выбирается из выпадающего списка доступных каталогов. Примеры использования: - Выбрать каталог из списка - выбрать нужный каталог из выпадающего списка; - {=Variable:CATALOG_ID} - использовать ID каталога из переменной предыдущего активити (робота); - {=Document:CATALOG_ID} - использовать ID каталога из поля документа. Важно: Убедитесь, что выбранный каталог существует в системе. Если каталог с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается наименование товара для поиска. Это необязательный параметр. Примеры использования: - Тест товара - найти товары с точным наименованием; - {=Variable:PRODUCT_NAME} - использовать наименование из переменной; - Можно использовать операторы поиска для частичного совпадения (зависит от настроек поиска).
Активность	В данном поле указывается статус активности товара для поиска. Это необязательный параметр. Примеры использования: - Y - найти только активные товары; - N - найти только неактивные товары; - {=Variable:ACTIVE_STATUS} - использовать статус из переменной.
Доступность к покупке	В данном поле указывается статус доступности товара для покупки. Это необязательный параметр. Примеры использования: - Y - найти только доступные для покупки товары; - N - найти только недоступные для покупки товары.
Доступное количество	В данном поле указывается количество товара на складе для поиска. Это необязательный параметр. Примеры использования: - 0 - найти товары с нулевым количеством; - {=Variable:QUANTITY} - найти товары с указанным количеством; - Можно использовать операторы сравнения (>, <, >=, <=) для поиска по диапазону.

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

Описание примера	Решение
Поиск всех товаров в каталоге	Параметры: Каталог - {=Variable:CATALOG_ID}, Наименование - не указывать. Активити (робот) вернёт массив ID всех товаров указанного каталога в параметре search_results_array.
Поиск активных товаров с наличием на складе	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только активные и доступные товары с наличием на складе.
Поиск товаров по наименованию	Параметры: Каталог - {=Variable:CATALOG_ID}, Наименование - {=Variable:PRODUCT_NAME}. Активити (робот) вернёт все товары с указанным наименованием в параметре search_results_array.
Поиск неактивных товаров	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - N. Активити (робот) вернёт все неактивные товары указанного каталога.
Поиск товаров с нулевым количеством	Параметры: Каталог - {=Variable:CATALOG_ID}, Доступное количество - 0. Активити (робот) вернёт все товары с нулевым количеством на складе.
Поиск товаров с ограничением результатов	Параметры: Каталог - {=Variable:CATALOG_ID}, Ограничение количества результатов - 10. Активити (робот) вернёт только первые 10 найденных товаров.
Поиск товаров для массовой обработки	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - Y. Активити (робот) вернёт активные товары для каждого каталога из итератора в параметре search_results_array.
Поиск доступных для покупки товаров	Параметры: Каталог - {=Variable:CATALOG_ID}, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только товары, доступные для покупки и имеющие товар на складе.
Поиск товаров по нескольким критериям	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >5. Активити (робот) вернёт активные и доступные товары с количеством больше 5.
Поиск первого товара	Параметры: Каталог - {=Variable:CATALOG_ID}, Ограничение количества результатов - 1. Активити (робот) вернёт первый найденный товар в параметре search_result_first_string.

Возвращаемые параметры данного активити (робота):
- Условия поиска выполнены (math_search_results) - строка, указывающая, выполнены ли условия поиска ("Y" - да, "N" - нет);
- Количество найденных результатов (count_search) - числовое значение количества найденных товаров;
- Массив ID найденных товаров (search_results_array) - массив числовых идентификаторов найденных товаров (множественное значение);
- Строка с ID найденных товаров (search_results_string) - строка с идентификаторами найденных товаров, разделёнными запятой;
- Первый ID из результатов (search_result_first_string) - строковое значение первого идентификатора из найденных товаров;
- Последний ID из результатов (search_result_last_string) - строковое значение последнего идентификатора из найденных товаров;
- Лог ошибок (s_error_logs) - строка с информацией о результатах поиска для отладки.

Примеры использования возвращаемых параметров:
- Использовать search_results_array для итератора при массовой обработке товаров;
- Использовать search_result_first_string для получения первого найденного товара;
- Использовать count_search для проверки количества найденных результатов;
- Использовать search_results_string для передачи списка ID в другие активити (роботы);
- Использовать math_search_results для проверки успешности поиска в условиях бизнес-процесса.

Важно о возвращаемых параметрах: Если товары не найдены, параметр math_search_results будет равен "N", а count_search будет равен 0. Всегда проверяйте значение math_search_results перед использованием результатов поиска в дальнейших шагах бизнес-процесса.


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

Обязательные параметры:
Для успешного выполнения поиска необходимо указать хотя бы один параметр поиска кроме обязательного параметра "Каталог". Если не указан ни один дополнительный параметр поиска, активити (робот) завершится с ошибкой "Ни один параметр для поиска не был заполнен".

Проверка существования товаров:
Активити (робот) проверяет существование товаров по указанным критериям. Если товары не найдены, активити (робот) вернёт math_search_results = "N" и count_search = 0.

Обработка больших объёмов данных:
При поиске большого количества товаров (более 50) активити (робот) автоматически обрабатывает результаты через batch-запросы для оптимизации производительности.

Ограничение количества результатов:
Рекомендуется использовать параметр "Ограничение количества результатов" при больших объёмах данных для оптимизации производительности и уменьшения времени выполнения активити (робота).

Порядок параметров:
Параметр "Каталог" всегда отображается первым в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр товаров в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Производительность:
При массовом поиске товаров через итератор рекомендуется ограничивать количество результатов поиска. Для массового поиска используйте модуль "Массовый запуск Бизнес-процессов".

Изменение товара торгового каталога

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

• Автоматическое обновление параметров товара при изменении данных в сделке;
• Обновление количества товара на складе при поступлении или продаже;
• Изменение статуса активности товара в зависимости от условий бизнес-процесса;
• Обновление цен и валюты товара при изменении курса валют;
• Автоматическое обновление характеристик товара при изменении данных в других сущностях CRM;
• Изменение доступности товара для покупки в зависимости от наличия на складе;
• Обновление описания и свойств товара при синхронизации с внешними системами;
• Массовое обновление товаров через итератор;
• Изменение режима количественного учета товара;
• Обновление параметров подписки для товара с периодической оплатой.

Как работает активити (робот):
- Активити (робот) обновляет существующий товар в торговом каталоге CRM с указанными параметрами;
- Для обновления необходимо указать ID товара (обязательный параметр);
- Можно обновить любые параметры товара (наименование, код, размеры, вес, цены);
- Поддерживается обновление параметров активности, доступности, количества и резервирования;
- Можно изменить НДС и валюту закупочной цены;
- Обновляются только те поля, которые указаны в параметрах активити (робота);
- Поддерживается обновление пользовательских свойств товара (property1917, property1925 и др.).

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

Название поля	Описание и примеры использования
ID товара	В данном поле указывается числовой идентификатор (ID) товара, который необходимо обновить. Это обязательный параметр. Примеры использования: - 30287 - обновить товар с ID 30287; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки); - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска товаров; - {=A1988_22222_92566_99999:id_new_product} - использовать ID товара из результата активити (робота) "Создание товара торгового каталога"; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID товара существует в каталоге. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается новое текстовое наименование товара. Это необязательный параметр. Примеры использования: - Тест товара - простое наименование; - {=Document:TITLE} - использовать наименование из документа; - Товар #{=Document:PRODUCT_ID} - {=Variable:COLOR} - комбинированное наименование; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
Активность	В данном поле указывается, будет ли товар активен. Это необязательный параметр. Варианты выбора: - Да (Y) - товар будет активен и доступен для использования; - Нет (N) - товар будет неактивен. Примеры использования: - Да - активировать товар; - Нет - деактивировать товар для временного скрытия из каталога.
Доступность к покупке	В данном поле указывается, доступен ли товар для покупки. Это необязательный параметр. Варианты выбора: - Да (Y) - товар доступен для покупки; - Нет (N) - товар недоступен для покупки. Примеры использования: - Да - сделать товар доступным для покупки; - Нет - временно запретить покупку товара.
Уникальные штрихкоды для каждого экземпляра	В данном поле указывается, используются ли уникальные штрихкоды для каждого экземпляра товара. Это необязательный параметр. Варианты выбора: - Да (Y) - используются уникальные штрихкоды; - Нет (N) - не используются уникальные штрихкоды. Примеры использования: - Да - включить использование уникальных штрихкодов; - Нет - отключить использование уникальных штрихкодов.
Наличие набора	В данном поле указывается, является ли товар набором. Это необязательный параметр. Варианты выбора: - Да (Y) - товар является набором; - Нет (N) - товар не является набором. Примеры использования: - Да - преобразовать товар в набор; - Нет - преобразовать набор в обычный товар.
Разрешение покупки при отсутствии товара	В данном поле указывается, разрешена ли покупка товара при отсутствии товара на складе. Это необязательный параметр. Варианты выбора: - Да (Y) - покупка разрешена даже при отсутствии товара; - Нет (N) - покупка запрещена при отсутствии товара. Примеры использования: - Да - разрешить покупку под заказ; - Нет - запретить покупку при отсутствии товара на складе.
Символьный код	В данном поле указывается новый символьный код товара. Это необязательный параметр. Примеры использования: - Символьный код - простой код; - {=Variable:PRODUCT_CODE} - использовать код из переменной; - ={{={=Document:PRODUCT_CODE} & "_" & {=Variable:VARIANT_CODE}}}} - объединение кодов.
Детальное описание	В данном поле указывается новое детальное описание товара. Это необязательный параметр. Примеры использования: - Детальное описание - простое описание; - {=Variable:DESCRIPTION} - использовать описание из переменной; - Описание товара с характеристиками: размер {=Variable:SIZE}, цвет {=Variable:COLOR} - комбинированное описание.
Тип детального описания	В данном поле указывается тип детального описания товара. Это необязательный параметр. Варианты выбора: - Текст (text) - обычный текст; - HTML (html) - HTML-разметка. Примеры использования: - Текст - изменить тип описания на простой текст; - HTML - изменить тип описания на HTML-разметку.
Валюта закупочной цены	В данном поле указывается валюта закупочной цены товара. Это необязательный параметр. Варианты выбора: - Рубль (RUB); - Доллар США (USD); - Евро (EUR). Примеры использования: - RUB - изменить валюту на рубли; - USD - изменить валюту на доллары; - EUR - изменить валюту на евро.
Доступное количество	В данном поле указывается новое доступное количество товара на складе. Это необязательный параметр. Примеры использования: - 1 - установить количество 1; - {=Variable:QUANTITY} - использовать количество из переменной; - ={{=intval({=Document:QUANTITY})}} - преобразовать количество из документа в целое число.
Режим количественного учета	В данном поле указывается режим количественного учета товара. Это необязательный параметр. Варианты выбора: - Включен (Y) - количественный учет включен; - Выключен (N) - количественный учет выключен; - По умолчанию (D) - использовать настройки по умолчанию. Примеры использования: - Включен - включить количественный учет; - Выключен - выключить количественный учет; - По умолчанию - использовать настройки каталога.
Единица времени периода оплаты	В данном поле указывается единица времени периода оплаты для товара. Это необязательный параметр. Варианты выбора: - Час (H); - День (D); - Неделя (W); - Месяц (M); - Квартал (Q); - Полугодие (S); - Год (Y). Примеры использования: - Месяц - изменить период оплаты на ежемесячный; - Год - изменить период оплаты на годовой.
НДС включен в цену	В данном поле указывается, включен ли НДС в цену товара. Это необязательный параметр. Варианты выбора: - Да (Y) - НДС включен в цену; - Нет (N) - НДС не включен в цену. Примеры использования: - Да - включить НДС в цену; - Нет - исключить НДС из цены.

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

Описание примера	Решение
Обновление количества товара при поступлении на склад	Параметры: ID товара - {=Document:PRODUCT_ID}, Доступное количество - ={{={=Variable:CURRENT_QUANTITY} + {=Variable:INCOMING_QUANTITY}}}}, Режим количественного учета - Включен.
Деактивация товара при отсутствии на складе	Параметры: ID товара - {=Variable:PRODUCT_ID}, Активность - Нет, Доступность к покупке - Нет, Доступное количество - 0.
Обновление цены и валюты товара при изменении курса	Параметры: ID товара - {=Document:PRODUCT_ID}, Валюта закупочной цены - USD, Закупочная цена - {=Variable:NEW_PRICE}, НДС включен в цену - Да.
Активация товара при поступлении на склад	Параметры: ID товара - {=Variable:PRODUCT_ID}, Активность - Да, Доступность к покупке - Да, Доступное количество - {=Variable:QUANTITY}, Разрешение покупки при отсутствии товара - Нет.
Обновление наименования и описания товара	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Товар {=Document:TITLE}", Детальное описание - {=Variable:DESCRIPTION}, Тип детального описания - HTML.
Изменение режима количественного учета товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Режим количественного учета - Включен, Доступное количество - {=Variable:QUANTITY}.
Обновление параметров подписки для товара	Параметры: ID товара - {=Document:PRODUCT_ID}, Единица времени периода оплаты - Месяц, Разрешение подписки на товар - Да.
Массовое обновление товаров через итератор	Параметры: ID товара - {=Iterator:Value}, Активность - Да, Доступность к покупке - Да, НДС включен в цену - Да.
Обновление товара при изменении статуса сделки	Параметры: ID товара - {=Document:PRODUCT_ID}, Активность - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}, Доступность к покупке - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}.
Обновление товара для товара под заказ	Параметры: ID товара - {=Variable:PRODUCT_ID}, Разрешение покупки при отсутствии товара - Да, Доступное количество - 0, Доступность к покупке - Да.

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

Обязательные параметры:
Для успешного обновления товара обязательно должен быть заполнен следующий параметр:
- ID товара (id_product).

Проверка существования товара:
Активити (робот) проверяет существование указанного товара перед обновлением. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.

Обработка boolean полей:
Поля типа boolean (Активность, Доступность к покупке, НДС включен в цену и др.) принимают значения "Y" (Да) или "N" (Нет) и автоматически преобразуются в соответствующий формат при отправке в API.

Обновление только указанных полей:
Активити (робот) обновляет только те поля, которые указаны в параметрах. Поля, которые не указаны, остаются без изменений.

Порядок параметров:
Параметры ID товара и Наименование всегда отображаются первыми в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на обновление товаров в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству обновляемых товаров:
При массовом обновлении товаров через итератор рекомендуется не обновлять более 100 товаров за один запуск бизнес-процесса. Для массового обновления используйте модуль "Массовый запуск Бизнес-процессов".

Цена

Добавление цены товара

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

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

Сценарий работы активити (робота) бизнес-процесса

Активити (робот) получает параметры от бизнес-процесса, проверяет обязательные поля (ID товара, значение цены, валюта, тип цены), формирует запрос к API Битрикс24 для создания новой цены товара и возвращает ID созданной цены в переменную id_new_price.

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

Название поля	Описание и примеры использования
ID товара	В данном поле указывается идентификатор товара, для которого создаётся цена. Это обязательный параметр. ID товара можно получить методами catalog.product.list, catalog.product.offer.list, catalog.product.service.list, catalog.product.sku.list. Примеры: - 123 - указать ID товара напрямую; - {=Variable:PRODUCT_ID} - использовать ID товара из переменной бизнес-процесса; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки, лида и т.д.). Важно: Если поле "ID товара" пустое или указан несуществующий товар, активити (робот) завершится с ошибкой. Обязательно укажите корректный ID товара.
Значение цены	В данном поле указывается числовое значение цены товара. Это обязательный параметр. Поддерживаются дробные значения (например, 123.45). Примеры: - 1000 - указать цену 1000; - 1250.50 - указать цену с копейками 1250.50; - {=Variable:PRICE} - использовать значение цены из переменной бизнес-процесса; - ={{={=Document:OPPORTUNITY} * 0.9}} - вычислить цену как 90% от суммы сделки; - ={{=round({=Variable:BASE_PRICE} * 1.2, 2)}} - вычислить цену с наценкой 20% и округлить до 2 знаков после запятой. Важно: Если поле "Значение цены" пустое или равно нулю, активити (робот) завершится с ошибкой. Обязательно укажите положительное значение цены.
Валюта	В данном поле выбирается валюта для цены товара из списка доступных валют портала. Это обязательный параметр. Список валют формируется автоматически при установке активити (робота) на основе настроек портала. Примеры: - RUB - выбрать российский рубль; - USD - выбрать доллар США; - EUR - выбрать евро; - {=Variable:CURRENCY} - использовать валюту из переменной бизнес-процесса (значение должно быть кодом валюты, например RUB, USD). Важно: Если поле "Валюта" не выбрано, активити (робот) завершится с ошибкой. Обязательно выберите валюту из списка.
Тип цены	В данном поле выбирается тип цены из списка доступных типов цен портала. Это обязательный параметр. Типы цен формируются автоматически при установке активити (робота) на основе настроек торгового каталога (например, базовая цена, оптовая цена и т.д.). Примеры: - 1 - выбрать тип цены с ID 1 (обычно базовая цена); - 2 - выбрать тип цены с ID 2 (например, оптовая цена); - {=Variable:PRICE_TYPE_ID} - использовать тип цены из переменной бизнес-процесса. Важно: Если поле "Тип цены" не выбрано, активити (робот) завершится с ошибкой. Обязательно выберите тип цены из списка.
Количество от	В данном поле указывается минимальное количество товара, начиная с которого действует указанная цена. Это необязательный параметр. Используется для установки оптовых цен или скидок при покупке большого количества товара. Примеры: - 10 - цена действует от 10 штук; - 100 - цена действует от 100 штук; - {=Variable:QUANTITY_FROM} - использовать значение из переменной бизнес-процесса; - Пусто - цена действует для любого количества (начиная с 1).
Количество до	В данном поле указывается максимальное количество товара, до которого действует указанная цена. Это необязательный параметр. Используется вместе с полем "Количество от" для установки диапазона количества, на который распространяется цена. Примеры: - 50 - цена действует до 50 штук; - 999 - цена действует до 999 штук; - {=Variable:QUANTITY_TO} - использовать значение из переменной бизнес-процесса; - Пусто - цена действует без ограничения по максимальному количеству.
Внешний идентификатор	В данном поле указывается внешний идентификатор цены для синхронизации с внешними системами. Это необязательный параметр. Примеры: - EXT_PRICE_001 - указать внешний идентификатор; - {=Variable:EXTERNAL_ID} - использовать внешний идентификатор из переменной бизнес-процесса.
Вес цены (для сортировки)	В данном поле указывается числовое значение для сортировки цен. Это необязательный параметр. Используется для определения порядка отображения цен при наличии нескольких цен у одного товара. Примеры: - 100 - установить вес цены 100; - {=Variable:PRICE_SCALE} - использовать значение из переменной бизнес-процесса.

Возвращаемые параметры:
- ID цены товара (Число) - ID созданной цены товара.
Используйте этот параметр для дальнейшей работы с созданной ценой в бизнес-процессе, например, для обновления цены или получения информации о цене.
- Успех операции (Да/Нет) - Флаг успешного выполнения активити (робота).
Принимает значение "Да" при успешном создании цены, "Нет" при возникновении ошибки.
- Сообщение на ошибке - выводит текст ошибки, если таковая имеется.

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

Описание примера	Решение
Создать базовую цену для товара в рублях	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 1000, Валюта - RUB, Тип цены - 1. Активити (робот) создаст базовую цену 1000 рублей для товара с указанным ID.
Добавить оптовую цену с минимальным количеством	Параметры: ID товара - {=Document:PRODUCT_ID}, Значение цены - 800, Валюта - RUB, Тип цены - 2, Количество от - 10. Активити (робот) создаст оптовую цену 800 рублей, действующую при покупке от 10 штук товара.
Установить цену в долларах США	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 50, Валюта - USD, Тип цены - 1. Активити (робот) создаст цену 50 долларов США для товара.
Создать цену с вычислением на основе суммы сделки	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - ={{={=Document:OPPORTUNITY} / {=Variable:QUANTITY}}}, Валюта - RUB, Тип цены - 1. Активити (робот) вычислит цену как частное от деления суммы сделки на количество товара.
Добавить цену с наценкой 15% от базовой цены	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - ={{={=Variable:BASE_PRICE} * 1.15}}, Валюта - RUB, Тип цены - 1. Активити (робот) вычислит цену с наценкой 15% от базовой цены из переменной.
Установить цену для диапазона количества товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 700, Валюта - RUB, Тип цены - 2, Количество от - 50, Количество до - 100. Активити (робот) создаст оптовую цену 700 рублей для покупки от 50 до 100 штук товара.
Создать цену с внешним идентификатором для синхронизации	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 1200, Валюта - RUB, Тип цены - 1, Внешний идентификатор - EXT_{=Variable:PRODUCT_ID}_PRICE. Активити (робот) создаст цену с внешним идентификатором для последующей синхронизации с внешней системой.
Добавить цену в евро с округлением до 2 знаков	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - ={{=round({=Variable:PRICE_EUR}, 2)}}, Валюта - EUR, Тип цены - 1. Активити (робот) создаст цену в евро, округлённую до 2 знаков после запятой.
Установить цену с приоритетом сортировки	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 1500, Валюта - RUB, Тип цены - 1, Вес цены (для сортировки) - 200. Активити (робот) создаст цену с высоким приоритетом сортировки (200), которая будет отображаться первой среди других цен.
Создать цену для товара из сделки с автоматическим вычислением	Параметры: ID товара - {=Document:PRODUCT_ID}, Значение цены - ={{={=Document:OPPORTUNITY} * 0.95}}, Валюта - {=Document:CURRENCY_ID}, Тип цены - 1. Активити (робот) создаст цену со скидкой 5% от суммы сделки в валюте сделки.

Изменить цену товара

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

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

Сценарий работы активити (робота) бизнес-процесса

Активити (робот) получает параметры от бизнес-процесса, проверяет обязательные поля (ID цены товара, значение цены, валюта), формирует запрос к API Битрикс24 для обновления существующей цены товара и возвращает результат выполнения операции.

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

Название поля	Описание и примеры использования
ID цены товара	В данном поле указывается идентификатор существующей цены товара, которую необходимо обновить. Это обязательный параметр. ID цены можно получить методом catalog.price.list, с помошью активити "Поиск цен товаров по фильтру" или из возвращаемого параметра активити (робота) "Добавить цену товара". Примеры: - 456 - указать ID цены напрямую; - {=Variable:PRICE_ID} - использовать ID цены из переменной бизнес-процесса; - {=Variable:id_new_price} - использовать ID цены, полученный после создания цены активити (роботом) "Добавить цену товара". Важно: Если поле "ID цены товара" пустое или указана несуществующая цена, активити (робот) завершится с ошибкой. Обязательно укажите корректный ID цены товара. Цена - это не поле, а отдельный справочник. Каждый раз, когда вы присвваиваете цену товару, в него делается запись с уникальным ID.
Значение цены	В данном поле указывается новое числовое значение цены товара. Это обязательный параметр. Поддерживаются дробные значения (например, 123.45). Примеры: - 1500 - указать новую цену 1500; - 1250.75 - указать новую цену с копейками 1250.75; - {=Variable:NEW_PRICE} - использовать новое значение цены из переменной бизнес-процесса; - ={{={=Variable:OLD_PRICE} * 1.1}} - увеличить цену на 10%; - ={{=round({=Variable:BASE_PRICE} * 0.9, 2)}} - установить цену со скидкой 10% и округлить до 2 знаков после запятой. Важно: Если поле "Значение цены" пустое, активити (робот) завершится с ошибкой. Обязательно укажите новое значение цены.
Валюта	В данном поле выбирается новая валюта для цены товара из списка доступных валют портала. Это обязательный параметр. Список валют формируется автоматически при установке активити (робота) на основе настроек портала. Примеры: - RUB - выбрать российский рубль; - USD - выбрать доллар США; - EUR - выбрать евро; - {=Variable:CURRENCY} - использовать валюту из переменной бизнес-процесса (значение должно быть кодом валюты, например RUB, USD). Важно: Если поле "Валюта" не выбрано, активити (робот) завершится с ошибкой. Обязательно выберите валюту из списка.
ID товара	В данном поле указывается идентификатор товара, к которому относится цена. Это необязательный параметр. Используется для изменения привязки цены к другому товару. Примеры: - 789 - указать новый ID товара напрямую; - {=Variable:NEW_PRODUCT_ID} - использовать ID товара из переменной бизнес-процесса.
Количество от	В данном поле указывается новое минимальное количество товара, начиная с которого действует указанная цена. Это необязательный параметр. Используется для изменения условий оптовых цен. Примеры: - 20 - цена будет действовать от 20 штук; - {=Variable:QUANTITY_FROM} - использовать значение из переменной бизнес-процесса; - Пусто - не изменять текущее значение.
Количество до	В данном поле указывается новое максимальное количество товара, до которого действует указанная цена. Это необязательный параметр. Используется вместе с полем "Количество от" для изменения диапазона количества. Примеры: - 200 - цена будет действовать до 200 штук; - {=Variable:QUANTITY_TO} - использовать значение из переменной бизнес-процесса; - Пусто - не изменять текущее значение.
Внешний идентификатор	В данном поле указывается новый внешний идентификатор цены для синхронизации с внешними системами. Это необязательный параметр. Примеры: - EXT_PRICE_002 - указать новый внешний идентификатор; - {=Variable:EXTERNAL_ID} - использовать внешний идентификатор из переменной бизнес-процесса.
Вес цены (для сортировки)	В данном поле указывается новое числовое значение для сортировки цен. Это необязательный параметр. Используется для изменения порядка отображения цен при наличии нескольких цен у одного товара. Примеры: - 300 - установить новый вес цены 300; - {=Variable:PRICE_SCALE} - использовать значение из переменной бизнес-процесса.

Возвращаемые параметры:
- Успех операции (Да/Нет) - Флаг успешного выполнения активити (робота).
Принимает значение "Да" при успешном обновлении цены, "Нет" при возникновении ошибки.
- Сообщение об ошибке - выводит текст ошибки, если таковая имеется.

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

Описание примера	Решение
Обновить значение цены товара	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - 2000, Валюта - RUB. Активити (робот) обновит цену с указанным ID, установив новое значение 2000 рублей.
Увеличить цену на 15%	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - ={{={=Variable:CURRENT_PRICE} * 1.15}}, Валюта - RUB. Активити (робот) вычислит новую цену как текущую цену, увеличенную на 15%.
Изменить валюту цены с рубля на доллар	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - {=Variable:PRICE}, Валюта - USD. Активити (робот) обновит валюту цены на доллар США, сохранив текущее значение цены.
Применить скидку 20% к существующей цене	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - ={{={=Variable:OLD_PRICE} * 0.8}}, Валюта - RUB. Активити (робот) установит новую цену со скидкой 20% от старой цены.
Обновить диапазон количества для оптовой цены	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - {=Variable:PRICE}, Валюта - RUB, Количество от - 25, Количество до - 100. Активити (робот) обновит диапазон количества, на который распространяется оптовая цена.
Изменить цену на основе курса валют	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - ={{={=Variable:PRICE_USD} * {=Variable:EXCHANGE_RATE}}}, Валюта - RUB. Активити (робот) вычислит новую цену в рублях на основе цены в долларах и текущего курса обмена.
Округлить цену до целого числа	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - ={{=round({=Variable:PRICE})}}, Валюта - RUB. Активити (робот) обновит цену, округлив её до ближайшего целого числа.
Обновить цену после создания через активити "Добавить цену товара"	Параметры: ID цены товара - {=Variable:id_new_price}, Значение цены - ={{={=Variable:id_new_price} * 1.05}}, Валюта - RUB. Активити (робот) обновит только что созданную цену, увеличив её на 5%.
Изменить приоритет сортировки цены	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - {=Variable:PRICE}, Валюта - RUB, Вес цены (для сортировки) - 500. Активити (робот) обновит приоритет сортировки цены, установив высокий вес для отображения первой среди других цен.
Синхронизировать цену с внешней системой	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - {=Variable:EXTERNAL_PRICE}, Валюта - RUB, Внешний идентификатор - EXT_{=Variable:PRICE_ID}. Активити (робот) обновит цену и внешний идентификатор для синхронизации с внешней системой.

Поиск цен товаров по фильтру

Активити (робот) "Поиск цен товаров по фильтру" предназначено для использования в роботах и может быть полезно в следующих сценариях: поиск цен по ID товара, поиск базовых и оптовых цен по типу цены, поиск цен по валюте, поиск цен с диапазоном количества (quantityFrom/quantityTo), поиск цен для массовой обработки через итератор, подготовка списка ID цен для последующего получения данных или удаления.

Как работает активити (робот):
- Активити (робот) формирует фильтр из заполненных параметров поиска;
- Если не заполнен ни один параметр, активити (робот) завершится с ошибкой;
- Выполняет поиск цен через API Битрикс24 и получает список найденных цен;
- Возвращает результаты в виде массива ID (для итератора), строки ID через запятую, первого и последнего результата, а также количество найденных элементов;
- Возвращает флаг результата поиска math_search_results (Y/N).

Сценарий работы активити (робота) бизнес-процесса

Активити (робот) получает параметры фильтра, выполняет поиск цен товаров и возвращает список ID найденных цен.
Далее эти ID можно передать в итератор, в активити (робот) "Данные по цене товара" для получения подробностей или в активити (робот) "Удалить цену товара" для удаления.

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

Название поля	Описание и примеры использования
ID цены	Поиск по идентификатору цены. Полезно, когда нужно проверить существование цены или отфильтровать конкретную запись. Примеры: - 456 - найти цену с ID 456; - {=Variable:PRICE_ID} - использовать ID цены из переменной бизнес-процесса.
ID товара	Поиск цен, относящихся к конкретному товару. Это один из самых распространённых сценариев. Примеры: - 123 - найти все цены товара с ID 123; - {=Variable:PRODUCT_ID} - использовать ID товара из переменной бизнес-процесса; - {=Document:ID} - использовать ID текущего документа, если документом является товар.
Значение цены	Поиск по значению цены. Допускается указание числового значения, а также сравнительных выражений (например >1000), если это поддерживается API Битрикс24 в фильтрах для цен. Примеры: - 1000 - найти цены со значением 1000; - >1000 - найти цены больше 1000; - {=Variable:PRICE_VALUE} - использовать значение из переменной бизнес-процесса.
Валюта	В данном поле выбирается валюта цены из списка валют портала. Полезно для поиска цен в конкретной валюте. Примеры: - RUB - найти цены в рублях; - USD - найти цены в долларах США; - {=Variable:CURRENCY} - использовать код валюты из переменной.
Тип цены	Поиск по типу цены (например, базовая, оптовая и т.д.). Поле выбирается из списка типов цен торгового каталога. Примеры: - 1 - найти цены типа с ID 1 (часто базовая цена); - 2 - найти цены типа с ID 2 (например, оптовая цена); - {=Variable:PRICE_TYPE_ID} - использовать ID типа цены из переменной бизнес-процесса.
Количество от	Поиск цен, действующих от определённого количества. Удобно для поиска оптовых цен. Примеры: - 10 - найти цены, которые начинаются от 10 единиц; - >=50 - найти цены, где минимальное количество 50 и больше (если поддерживается API); - {=Variable:QUANTITY_FROM} - использовать значение из переменной.
Количество до	Поиск цен, действующих до определённого количества. Используется вместе с полем "Количество от" для диапазона. Примеры: - 100 - найти цены, которые действуют до 100 единиц; - <=500 - найти цены с максимальным количеством до 500 (если поддерживается API); - {=Variable:QUANTITY_TO} - использовать значение из переменной.
Внешний идентификатор	Поиск по внешнему идентификатору цены для синхронизации с внешними системами. Примеры: - EXT_PRICE_001 - найти цену по внешнему идентификатору; - EXT_{=Variable:PRODUCT_ID}_BASE - использовать значение, собранное из переменных бизнес-процесса.
Вес цены (для сортировки)	Поиск по весу цены. Используется, если на портале применяются веса для сортировки цен. Примеры: - 100 - найти цены с весом 100; - {=Variable:PRICE_SCALE} - использовать значение из переменной.

Возвращаемые параметры:
- Результат поиска (строка) : Y (найдено) или N (не найдено);
- Количество найденных элементов (Число);
- Массив ID найденных цен (Число, множественное, удобно для итератора);

- Строка ID найденных цен через запятую (Строка) ;
- Первый ID из результата поиска (Строка) ;
- Последний ID из результата поиска (Строка) ;
- Строка для служебных сообщений и отладки (Строка) .

Важно о возвращаемых параметрах: Если цены не найдены, параметр math_search_results будет равен N, а count_search будет равен 0.
Всегда проверяйте math_search_results перед использованием массива search_results_array.

Важно! Ограничения и рекомендации:
- Для успешного запуска должен быть заполнен хотя бы один параметр поиска;
- Рекомендуется по возможности указывать ID товара и тип цены, чтобы получить точные результаты;
- Если ожидается много результатов, используйте итератор по search_results_array и обрабатывайте цены последовательно.

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

Описание примера	Решение
Найти все цены конкретного товара	Параметры: ID товара - {=Variable:PRODUCT_ID}. Активити (робот) вернёт массив ID всех цен данного товара в параметре search_results_array.
Найти базовую цену товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип цены - 1. Активити (робот) вернёт ID базовой цены товара.
Найти оптовые цены товара в рублях	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип цены - 2, Валюта - RUB. Активити (робот) вернёт ID оптовых цен в рублях.
Найти цены, действующие от 10 единиц товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Количество от - 10. Активити (робот) вернёт цены, у которых quantityFrom равен 10.
Найти цены в долларах США по всему каталогу	Параметры: Валюта - USD. Активити (робот) вернёт ID всех цен в валюте USD.
Найти цену по внешнему идентификатору	Параметры: Внешний идентификатор - EXT_PRICE_001. Активити (робот) вернёт ID цены, связанной с записью во внешней системе.
Подготовить список цен для получения подробных данных	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип цены - 1. Затем используйте итератор по search_results_array и запускайте активити (робот) "Данные по цене товара" с ID цены товара - {=Variable:search_results_array}.
Найти цены для последующего удаления (очистка тестовых данных)	Параметры: Внешний идентификатор - TEST_{=Variable:PRODUCT_ID}. Затем используйте итератор по search_results_array и запускайте активити (робот) "Удалить цену товара" с ID цены товара - {=Variable:search_results_array}.
Найти цены по диапазону количества	Параметры: Количество от - 50, Количество до - 100, Валюта - RUB. Активити (робот) вернёт цены для диапазона 50-100 в рублях.
Найти цены с заданным весом сортировки	Параметры: Вес цены (для сортировки) - 200. Активити (робот) вернёт цены с указанным весом priceScale.

Пункт меню "настройки"

В данном уроке описан функционал пункта меню "Настройки" в приложениях "Лаборатория БП" и "Лаборатория роботов".

Процент запросов для уведомлений: эта опция позволяет настроить уведомление об исчерпании запросов к REST.
Т.е вы указываете цифрой значение, которое отображает остаточный процент от общего числа запросов,
при котором администраторы приложения получат уведомление, о том, что запросы к REST скоро закончатся.
Например у Вас 300 000 запросов и Вы поставили 10%, то уведомление придет когда, останется меньше 30 000 запросов.

Введите количество offline событий:эта опция нужна для создания отложенной очереди обработки эвентов на портале.
Делается это для того, чтобы некоторые активити, обработка событий (эвентов) которых не приоритетна, не мешали обработке других БП и их эвентов. 
Для настройки, нужно указать количество (число) эвентов, которые система сохранит, но выполнит, только после превышения указанного числа эвентов.

Обратите внимание, что более 100 эвентов в очереди оставить нельзя. Даже если вы укажите более, например 101, то при сохранении настроек останется все равно 100 эвентов.
Это нужно для того, чтобы Ваш портал не был заблокирован нашей автоматикой или Б24, когда отложенные 100 (или меньше) эвентов пойдут в обработку.

Offline События: эта настройка позволяет выбрать события REST, которые будут храниться на портале.
Портал хранит указанное количество offline событий для каждого метода, т.е если у вас отмечены для хранения событий методы ONCRMINVOICESETSTATUS и ONCRMLEADUPDATE,
то для каждого из них будет сохранено не более 100 эвентов.
Количество событий, которое представлены фиксировано и не зависит от количества установленных активити, т.к некоторые активити работают с использованием данных событий.
Перечень offline событий и активити, которые его используют:

• ONCRMINVOICESETSTATUS: Слежение за статусом счета.
• ONCRMLEADUPDATE: Завершение по условиям.
• ONCRMDEALUPDATE: Изменение сделки.
• ONCRMCOMPANYUPDATE: Изменение компании.
• ONCRMCONTACTUPDATE: Изменение контакта.
• ONCRMACTIVITYADD, ONCRMACTIVITYUPDATE: Слежение за делом.
• ONTASKUPDATE: Слежение за изменением в задаче.
• ONIMBOTMESSAGEADD, ONIMCOMMANDADD: Создание сообщения в чат от робота.

Чат и боты

Для того, чтобы сделать чат-бота, наносящего пользу вашему бизнесу, не нужно сложное программирование - нужны дополнительные действия в бизнес-процессах Битрикс24 из Приложений24. Мы пройдёмся по всем этапам создания чатботов от момента регистрации на портале до обучения чатбота понимать клиента или коллегу по работе. Покажем, как создать чат-бота в Битрикс24 с помощью приложения "Лаборатория бизнес-процессов" и решать следующие задачи: 

1. 17:42 - Провести первичное общение с клиентом в открытой линии. 

2. 01:10:00 - Создать чат-бота помощника, который будет подсказывать наличие товара в интернет-магазине. 

3. 29:55 - Создать чат-бота для согласования документов и дел в карточках CRM и чате. 

4. 01:30:34 - Создать чат-бота, который может давать ответы на часто задаваемые вопросы как клиентов, так и сотрудников.

Примеры бизнес-процессов, которые описаны в видеоролике - СКАЧАТЬ

Чат

Создание чата

Данное активити позволяет создать новый чат и пригласить туда участников.

Сценарий работы активити бизнес-процесса

Тип чата: данное поле позволяет указать тип чата, который будет создан, т.е открытый для вступления или внутренний чат (закрытый).

Заголовок чата: в данном поле указывается заголовок чата.

Создавать чаты с помощью активити из нашего приложения "Лаборатория роботов" или "Лаборатория БП" и писать сообщения в них (как и любые другие действия) могут только чат-боты, которые созданы с использованием нашего приложения, т.к у них есть права доступа к приложению, сторонние чат-боты работать не будут.

Описание чата: в данном поле указывается заголовок чата.

Цвет чата: в данном поле можно выбрать из выпадающего списка цвет чата.

Один из способов создать чат с привязкой к сущности, это с помощью штатного активити "Изменение наблюдателей".
В данной процедуре очень Важна очередность действий, и это де-факто костыль.

Процедура такая:
1. Создаете БП с активити "Изменение наблюдателей" и указываете одного или нескольких наблюдателей в его настройках.
2. Далее в ручную или роботом из сущности запускаете этот БП, у Вас добавятся наблюдатели, но сам созданный чат вы не увидите.
3. Далее, инициируете создание чата, нажатием на область чата в самой сущности, и после этих действий, все наблюдатели в него подтянутся.
  

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

Тип сущности (Тип сущности для привязки): в этом поле указывается тип сущности к которой будет прикреплен чат.
На данный момент для работы доступны 3 типа сущностей: Лид, Сделка, Контакт, Компания, Счет, Предложение, Смарт-процесс.
Сущность выбирается из выпадающего списка, однако можно указать тип сущности в дополнительном поле.

Пример заполнения типов сущностей:
Лид: LEAD
Сделка: DEAL
Контакт: CONTACT
Компания: COMPANY
Счет: SMART_INVOICE
Предложение: QUOTE
Смарт-процесс: DYNAMIC_ID Типа СП

ID сущности:ID сущности (число) в этом поле указывается идентификатор сущности, к которой будет привязан чат.

Активити может создать несколько чатов для одной сущности, вернет их ID и прикрепит их к сущности, НО, в самой сущности будь то Сделка или СП будет виден только 1 чат, самый первый, который был создан, в разделе "чаты точно так же".
И это при условии, что пользователь в чате не состоял или в сущности не было изначально активных чатов.
Количество созданых и прикрепленных к сущности чатов может быть каким угодно, но пользователь разделе "Чаты", увидит только 1 чат для 1 конкретной сущности, это особенность работы REST Б24.

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

Участники чата(указать одного или более пользователя): в данном поле указываются ID участников чата. 

Участники чатов добавляются только поименно, нельзя добавлять участников отделами или как-либо еще.
Правильное заполнение участников чата: Николай Администратор [13]; Вадим Кириленко [1643]; Игорь Куницын [2868], при этом ID пользователей должны быть внутри квадратных скобок.

Аватар чата (ссылка на картинку): в данном поле ссылка на картинку, которая будет аватаркой чата. Ссылка должна быть публично - доступной для скачивания.
Даже если картинка находится на диске облака, то указывается ссылка, а не ID файла из облака. 

Создавая чат, нужно сразу же добавлять в него хотя бы 1 пользователя и чат-бота (при необходимости).

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- ID созданного чата
- Успех создания чата
- Таймаут операции

Обновление чата

Данное активити (робот) позволяет обновлять параметры чата в Битрикс24: владельца, название, аватар и цвет.
Результатом работы является обновление указанных параметров чата по его ID.

ВАЖНО!
Запускать активити может ТОЛЬКО владелец чата, который необходимо изменить. Если активити запускает пользователь, который не является владельцем чата, операция обновления не будет выполнена.

НЕЛЬЗЯ менять аватар у чатов, привязанных к CRM сущностям (сделки, лиды, контакты, компании и т.д.). Попытка изменения аватара у таких чатов приведёт к ошибке выполнения активити.

Для обновления чата необходимо указать ID чата и хотя бы один из параметров для обновления:
- ID нового владельца (owner_id);
- Новое название (title_chat);
- Путь к файлу аватара (avatar_chat);
- Цвет чата (color_chat).

Если ни один из параметров обновления не будет указан, активити вернёт ошибку.

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

Название поля	Описание и примеры использования
ID чата	В данном поле указывается числовой идентификатор чата, который необходимо обновить. Это обязательный параметр. Пример: {=Variable:CHAT_ID} или 12345. Как получить ID чата: - Из результата работы активити "Создание чата" (поле return_id_chat); - Из результата работы активити "Добавление сообщения в чат" (поле return_id_chat); - Сохранённый из предыдущих операций с чатами; - Переменная бизнес-процесса, в которой хранится ID чата. Примеры указания ID: - Прямое указание: 123, 456; - Через переменную: {=Variable:CHAT_ID}; - Из результата предыдущего активити: {=Activity123:return_id_chat}.
ID нового владельца чата	В данном поле указывается идентификатор пользователя, который станет новым владельцем чата. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:NEW_OWNER_ID} или [U1]. Форматы указания пользователя: - Числовой ID: 123; - Формат Битрикс24: [U1], [U5], [U10]; - Через переменную: {=Variable:OWNER_ID}; - Из поля документа: {=Document:ASSIGNED_BY_ID}. Важно: Изменить владельца может только текущий владелец чата. После смены владельца права на управление чатом переходят к новому владельцу.
Новое название чата	В данном поле указывается новое название (заголовок) чата. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:NEW_TITLE} или "Проект Альфа". Примеры использования: - Прямое указание: "Новое название чата"; - Через переменную: {=Variable:CHAT_TITLE}; - Из поля документа: "Чат по сделке {=Document:TITLE}"; - С использованием функций: "Чат от {{=date('d.m.Y')}}". Ограничения: Название чата не должно быть пустым. Максимальная длина названия ограничена возможностями API Битрикс24.
Путь к файлу аватара	В данном поле указывается путь к файлу изображения, который будет использован в качестве аватара чата. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:AVATAR_PATH} или "https://example.com/avatar.jpg". Форматы указания пути: - Полный URL: "https://example.com/images/avatar.png"; Требования к файлу: - Файл должен быть доступен для чтения; - Поддерживаемые форматы: JPG, PNG, GIF; - Рекомендуемый размер: не более 2 МБ; - Изображение будет автоматически конвертировано в формат base64. ВАЖНО! Нельзя изменять аватар у чатов, привязанных к CRM сущностям (сделки, лиды, контакты, компании, смарт-процессы и т.д.). Попытка изменения аватара у таких чатов приведёт к ошибке выполнения активити.
Цвет чата	В данном поле из выпадающего списка можно выбрать цвет чата для мобильного приложения. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:CHAT_COLOR} или выбор из списка. Доступные цвета: - КРАСНЫЙ (RED); - ЗЕЛЕНЫЙ (GREEN); - МОНЕТНЫЙ ДВОР (MINT); - СВЕТЛО ГОЛУБОЙ (LIGHT_BLUE); - ТЁМНО ГОЛУБОЙ (DARK_BLUE); - ФИОЛЕТОВЫЙ (PURPLE); - ВОДА (AQUA); - РОЗОВАЯ (PINK); - ИЗВЕСТЬ (LIME); - КОРИЧНЕВАЯ (BROWN); - ГОЛУБАЯ (AZURE); - ЦВЕТА (KHAKI); - ХАКИ (SAND); - ПЕСОК (MARENGO); - СЕРЫЙ (GRAY); - ГРАФИТ (GRAPHITE). Примеры использования: - Прямой выбор из списка; - Через переменную: {=Variable:COLOR} (значение должно соответствовать одному из доступных цветов).
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Важно: Указанный сотрудник должен быть владельцем чата, иначе обновление не будет выполнено. Рекомендуем выбирать владельца чата или сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Описание примера	Решение
Смена владельца чата при передаче проекта	Параметры: ID чата - {=Variable:PROJECT_CHAT_ID}, ID нового владельца - {=Document:NEW_MANAGER_ID}. При передаче проекта новому менеджеру робот автоматически меняет владельца чата проекта, передавая права управления новому ответственному.
Обновление названия чата при изменении названия сделки	Параметры: ID чата - {=Variable:DEAL_CHAT_ID}, Новое название - "Чат по сделке {=Document:TITLE}". При изменении названия сделки робот синхронизирует название связанного чата, чтобы оно соответствовало текущему названию сделки.
Изменение цвета чата для визуального разделения по приоритетам	Параметры: ID чата - {=Activity123:return_id_chat}, Цвет чата - RED (для высокого приоритета) или GREEN (для низкого приоритета). Робот меняет цвет чата в зависимости от приоритета задачи или проекта для быстрой визуальной идентификации.
Обновление аватара чата при создании нового проекта	Параметры: ID чата - {=Activity456:return_id_chat}, Путь к файлу аватара - {=Variable:PROJECT_LOGO_URL}. При создании нового проекта робот устанавливает логотип проекта в качестве аватара чата для лучшей визуальной идентификации.
Массовое обновление названий чатов при реорганизации	Параметры: ID чата - {=Variable:CHAT_ID}, Новое название - "Отдел {=Variable:NEW_DEPARTMENT_NAME} - {=Variable:CHAT_NUMBER}". При реорганизации отделов робот обновляет названия всех чатов отдела, добавляя новое название отдела в начало названия чата.
Смена владельца и цвета при эскалации задачи	Параметры: ID чата - {=Document:CHAT_ID}, ID нового владельца - {=Document:ESCALATED_TO_ID}, Цвет чата - RED. При эскалации задачи робот передаёт чат новому ответственному и меняет цвет на красный для привлечения внимания к срочной задаче.
Обновление названия чата с датой создания	Параметры: ID чата - {=Variable:CHAT_ID}, Новое название - "Чат от {{=date('d.m.Y', {=Variable:CREATED_DATE})}}". Робот обновляет название чата, добавляя дату его создания для удобства навигации по истории чатов.
Изменение цвета чата в зависимости от статуса проекта	Параметры: ID чата - {=Variable:PROJECT_CHAT_ID}, Цвет чата - {{=if({=Document:STATUS_ID}=="ACTIVE", "GREEN", "GRAY")}}. Робот автоматически меняет цвет чата в зависимости от статуса проекта: зелёный для активных, серый для завершённых.
Обновление названия и владельца при смене ответственного за сделку	Параметры: ID чата - {=Variable:DEAL_CHAT_ID}, ID нового владельца - {=Document:ASSIGNED_BY_ID}, Новое название - "Чат по сделке {=Document:TITLE}". При смене ответственного за сделку робот обновляет владельца чата и синхронизирует название с текущим названием сделки.
Установка корпоративного аватара для всех новых чатов отдела	Параметры: ID чата - {=Activity789:return_id_chat}, Путь к файлу аватара - "https://company.com/logos/department_logo.png". При создании нового чата отдела робот автоматически устанавливает корпоративный логотип отдела в качестве аватара для единообразия визуального стиля.

Сценарий работы активити бизнес-процесса

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

• Смена владельца чата при передаче проекта или задачи другому сотруднику;
• Синхронизация названия чата с названием связанной сущности (сделка, проект, задача);
• Визуальное разделение чатов по приоритетам или статусам через изменение цвета;
• Установка корпоративных аватаров для чатов отделов или проектов;
• Массовое обновление параметров чатов при реорганизации структуры компании;
• Автоматическое обновление названий чатов при изменении статусов или приоритетов;
• Эскалация чатов с изменением владельца и визуального оформления;
• Персонализация чатов с установкой индивидуальных аватаров и цветов.

Особенности работы с параметрами обновления:
- Можно указать только один параметр для обновления (например, только название);
- Можно указать несколько параметров одновременно (например, название и цвет);
- Все указанные параметры будут обновлены в рамках одного вызова активити;
- Если ни один параметр обновления не указан, активити вернёт ошибку;

Лучшие практики использования обновления чатов:
1. Всегда проверяйте права доступа перед обновлением чата (убедитесь, что пользователь является владельцем);
2. Не пытайтесь изменять аватар у чатов, привязанных к CRM сущностям;
3. Используйте переменные для хранения ID чатов для последующего обновления;
4. Сохраняйте return_id_chat из активити создания чата для дальнейшего использования;
5. Комбинируйте несколько параметров обновления для комплексного изменения чата;
6. Используйте цвета для визуального разделения чатов по категориям или приоритетам;
7. Синхронизируйте названия чатов с названиями связанных сущностей для удобства навигации;
8. При смене владельца убедитесь, что новый владелец имеет необходимые права доступа.

Получение ID чата по сущности

Данное активити (робот) позволяет получить ID чата по сущности.
Результатом работы является ID чата, который можно использовать в других активити для работы с чатами (например, отправка сообщений, обновление чата и т.д.).

Как работает активити (робот):
- Вы выбираете Тип чата и указываете ID сущности;
- Для CRM можно дополнительно выбрать Тип CRM сущности, чтобы упростить заполнение;
- Активити выполняет запрос im.chat.get и возвращает ID найденного чата;
- Если чат по указанной сущности не найден, активити завершится с ошибкой.

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

Название поля	Описание и примеры использования
Тип чата	Определяет, как формировать запрос к im.chat.get. Доступные значения: - CRM - чат, привязанный к CRM сущности; - LINES - чат открытой линии; - LIVECHAT - чат с коллегами.
Тип CRM сущности	Используется только при Тип чата = CRM. Позволяет выбрать тип CRM сущности из списка (лид, сделка, контакт, компания, счета, смарт-процессы и т.д.). Примеры: LEAD, DEAL, DYNAMIC_167.
ID сущности	Идентификатор сущности. Формат зависит от выбранного Типа чата. Тип чата = CRM - Если вы заполняете поле Тип CRM сущности, то можно не заполнять ID сущности - тогда ID будет взят из текущего документа бизнес-процесса. - Если вы заполняете ID сущности вручную, указывайте его так, как он задан в вашей логике процесса (например, из переменной/поля документа). Тип чата = LINES Укажите идентификатор диалога открытой линии в формате Битрикс24. Пример для LINES: - telegrambot|2|209607941|744.

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

Описание примера	Решение
CRM: указать ID сущности вручную	Тип чата = CRM, ID сущности заполнен вручную (например, из переменной или поля документа). Активити вернёт chat_id.
CRM: взять ID из текущего документа БП	Тип чата = CRM, Тип CRM сущности = DEAL, ID сущности не заполнять. Активити возьмёт ID из текущего документа и сформирует ENTITY_ID автоматически.
Сделка: получить ID чата и отправить важную информацию	В роботе сделки добавьте шаг 1: "Получение ID чата по сущности" (Тип чата = CRM, Тип CRM сущности = DEAL, ID сущности можно не заполнять). Шаг 2: используйте полученный chat_id в активити отправки сообщения, чтобы написать клиенту или коллеге важную информацию по сделке.
Смарт-процесс: получить ID чата по элементу и уведомить участников	В роботе смарт-процесса добавьте "Получение ID чата по сущности" (Тип чата = CRM, Тип CRM сущности = нужный смарт-процесс). Далее используйте chat_id для отправки сообщения в чат по элементу смарт-процесса (например, о смене стадии или необходимости действия).
Счет: получить ID чата и отправить реквизиты/статус	В роботе по счету добавьте "Получение ID чата по сущности" (Тип чата = CRM, Тип CRM сущности = счет). После получения chat_id отправьте сообщение с важной информацией: статус оплаты, сумма, срок оплаты или ссылка на счет.
Добавить пользователя в чат по сущности	Сначала получите chat_id через "Получение ID чата по сущности". Затем используйте chat_id в активити добавления пользователя в чат, чтобы подключить нужного сотрудника (например, юриста или бухгалтера) к обсуждению.
LINES: получить чат открытой линии	Тип чата = LINES, ID сущности = telegrambot|2|209607941|744. Активити вернёт chat_id.

Возвращаемые параметры данного активити:
- ID чата (chat_id) - числовой идентификатор чата, найденный по сущности.

Исключение участников из чата

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

Сценарий работы активити бизнес-процесса

ID чата: указывается идентификатор чата, из которого планируется удалить сотрудника(ов).

Удалять сотрудников из чата может только владелец чата, это значит, что активити должно быть запущено от имени владельца чата.
При этом владелец чата должен быть администратором приложения, чтобы активити сработало.

ID пользователя, которого надо оставить: указываются идентификаторы сотрудников, которых необходимо оставить в чате.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.

Возвращаемые параметры для данного активити:
- Успех операции;
- Сообщение об ошибке.

Отправить сообщение в чат от человека

Данное активити позволяет отправить сообщение в чат от человека от имени которого запускается данное активити.

Сценарий работы активити бизнес-процесса

Куда отправить сообщение: в этом поле из выпадающего списка можно выбрать куда или кому будет отправлено сообщение.
Варианты :

Сотруднику.

В чат.

Если выбрано значение "сотрудник", то ID сотрудника нужно указать в поле ID чата.

ID чата: в данном пункте указывается ID чата, в который планируется отправить сообщение. (или ID сотрудника, если в поле выше выбрано значение "сотрудник")
Примеры заполнения:

12345 , где 12345, это ID чата.

Если в поле передается массив с ID - {=A12345_6789_98745_43210:search_results_array} , где {=A12345_6789_98745_43210:search_results_array} - массив.

Если в поле передается строка с ID -  {=A42670_95917_50084_86351:search_results_string} , где {=A42670_95917_50084_86351:search_results_string} - строка.

Если в поле передается переменная с ID - {=Variable:Variable1} ,где {=Variable:Variable1} - переменная.

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

Текст сообщения: в этом поле нужно указать текст отправляемого сообщения в формате TEXT или BBcode.

В виде системного сообщения: варианты да/нет , выбрав "ДА", сообщение в чат будет выведено в виде системного сообщения, но не от имени пользователя.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Сообщение об ошибке.

Создание сообщения в чат от робота

Данное активити позволяет создать сообщение в чат от имени робота.

Сценарий работы активити бизнес-процесса

ID чат-бота: в данном поле указывается ID чат-бота, от имени которого будет отправлено сообщение.
ID чат-бота можно узнать, перейдя в его профиль в структуре компании (раздел сотрудники ->чат-боты) и просмотрев в URL его ID
Пример: 
URL: xxx.xxxxxx.ru/company/personal/user/1679/, где 1679 является ID, бота.

Чтобы данное активити работало корректно, чат-бот должен быть владельцем чата и запуск активити должен происходить от имени владельца чата, т.е от имени бота.

ID чата: в данном поле указывается ID чата, в который будет отправлено сообщение.
Получить данный параметр можно их возвращаемых параметров активити "Создание чата" или "Создание сообщения в чат от робота".

ВАЖНО!
В конструкторе БП нельзя использовать более 5 наших активити подряд, т.к на 6 активити, БП зависнет, ввиду того, что Б24 не разрешает использование более 5 активити подряд.

Создавать чаты с помощью активити из нашего приложения "Лаборатория роботов" или "Лаборатория БП" и писать сообщения в них (как и любые другие действия) могут только чат-боты, которые созданы с использованием нашего приложения, т.к у них есть права доступа к приложению, сторонние чат-боты работать не будут.

Название Кнопки 1: в данном поле указывается название кнопки 1, которая располагается под текстом сообщения.
Цвет текста Кнопки 1 (например, черный - 000): в данном поле указывается цвет текста кнопки 1 в формате "hex".
Цвет кнопки 1 (например, зеленый - d2f95f): в данном поле указывается цвет кнопки 1 в формате "hex".

Название Кнопки 2: в данном поле указывается название кнопки 2, которая располагается под текстом сообщения.
Цвет текста Кнопки 2 (например, черный - 000): в данном поле указывается цвет текста кнопки 2 в формате "hex".
Цвет кнопки 2 (например, красный - f1361b): в данном поле указывается цвет кнопки 2 в формате "hex".

Название Кнопки 3: в данном поле указывается название кнопки 3, которая располагается под текстом сообщения.
Цвет текста Кнопки 3 (например, черный - 000): в данном поле указывается цвет текста кнопки 2 в формате "hex".
Цвет кнопки 3 (например, прозрачный - f9fafb): в данном поле указывается цвет кнопки 2 в формате "hex".

Вариант работы чат-бота: в данном поле можно указать по какому сценарию чат-бот будет отправлять сообщение.
Доступно 3 варианта:

• Отправить сообщение без кнопок, и ожидать ответ.
• Отправить сообщение без кнопок, и не ожидать ответ.
  
• Отправить сообщение с кнопками, и ожидать ответ.

Текст сообщения: в данном поле указывается текст отправляемого сообщения.

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

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается нужно ли делать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

ВАЖНО!
Запускать данное активити необходимо от имени Чат-бота, иначе активити может не сработать и вывести сообщение об ошибке.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Ответ пользователя(вернет текст ответа только если выбран вариант "Отправить сообщение без кнопок, и ожидать ответ" ). - Какая кнопка нажата.
- ID привязанной сущности.
- ID чата.
- Сообщение об ошибке.

Поиск ID чата по названию или ФИО участников

Данное активити позволяет искать ID чата по названию чата или ФИО участников при помощи бизнес-процесса.
Результатом работы данного активити будет получение ID чата в виде массива для итератора, строки и соответствия условиям поиска.

Сценарий работы активити бизнес-процесса 

Поисковая фраза: в данном поле указывается название чата или ФИО его участников.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Возвращаемые параметры данного активити:
- Результат поиска (Массив для интегратора)
- Результат поиска (строка)
- Соответствует условиям

Добавление пользователя в чат открытой линии по CRM сущности

Данное активити позволяет искать ID чата открытой линии по сущности CRM и добавлять туда пользователя при помощи бизнес-процесса.

Сценарий работы активити бизнес-процесса

Тип CRM сущности: в данном поле указывается тип сущности CRM, к которой привязан чат, в который планируется добавлять пользователя.

ID CRM сущности: в данном поле указывается идентификатор сущности CRM к которой привязан чат.

С помощью данного активити НЕЛЬЗЯ добавлять пользователей в обычный чат, только в чат открытых линий.
Так же, другие активити для работы с обычными (открытыми/закрытыми) чатами не совместимы с данным активити.

ID пользователя или бота: в данном поле указывается ID бота или пользователя, которого нужно добавить в чат.

Указывается только один ID бота или пользователя.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Успех добавления участников.

Добавление участников в чат

Данное активити позволяет добавлять участников чата, указав ID чата в который необходимо добавить и ID новых участников этого чата.

Сценарий работы активити бизнес-процесса

ID чата: в данном поле указывается ID чата.
Получить данный параметр можно их возвращаемых параметров активити "Создание чата" или "Создание сообщения в чат от робота".

Добавление участников в чат(указать одного или более пользователя): в данном поле указывается ID участников чата.

ID участника нужно указывать с использованием квадратных скобок. Пример: [12345].

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.

Возвращаемые параметры для данного активити:
- Успех добавления участников.

Боты

Выход чат-бота из указанного чата

Данное активити позволяет вывести чат-бота из указанного диалога при помощи бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID чата: в данном поле указывается ID чата из которого планируется вывести бота.
Получить данный параметр можно их возвращаемых параметров активити "Создание чата" или "Создание сообщения в чат от робота".

ID бота: в данном поле указывается ID бота выводимого из чата.
ID чат-бота можно узнать, перейдя в его профиль в структуре компании (раздел сотрудники ->чат-боты) и просмотрев в URL его ID.

ID нового владельца чата: в данном поле указывается ID пользователя, которого бот добавил в чат вместо себя.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Успех добавления участников.

Создание Чат-бота

Данное активити позволяет добавить чат-бота в ваш портал, чтобы потом вести диалоги от него через бизнес-процессы.

Сценарий работы активити бизнес-процесса

ID чата (если хотите добавить туда бота): в данном поле указывается ID чата, в который планируется добавить бота.
Получить данный параметр можно из возвращаемых параметров активити "Создание чата" или "Создание сообщения в чат от робота".

Код бота: в данном поле указывается уникальный идентификатор (латиницей), по которому можно распознать бота.

Имя бота: в данном поле указывается имя бота, которого планируется создать (латиницей)…

Для открытых линий: в данном поле указывается, будет работать робот в открытых линиях или нет.

Чат-боты для открытых линий не поддерживают работу с кнопками из активити "создание сообщения в чат от робота"

Цвет бота: в данном поле указывается цвет используемый  для иконки бота или диалогового окна.

Почта для связи (если сообщение не прочитано, то отправиться на почту): в данном поле указывается e-mail на который будут присылаться уведомления, если бот недоступен.

ВАЖНО!
НЕЛЬЗЯ ИСПОЛЬЗОВАТЬ email зарегистрированного сотрудника на портале, для регистрации БОТА, нужно использовать технический адрес почты, не фигурирующий на портале.

Аватар бота (ссылка на картинку): в данном поле указывается ссылка на публично доступное изображение.
Даже если картинка находится на диске облака, то указывается ссылка, а не ID файла из облака.
Ограничение на тип изображений и их размер регулируются настройками портала.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

 Возвращаемые параметры для данного активити:
-ID созданного чат-бота

Смена владельца чата от лица чат-бота

Данное активити позволяет сменить владельца чата на другого от лица чат-бота.

Сценарий работы активити бизнес-процесса

ID чата: в данном пункте указывается ID чата, владельца которого надо сменить.

Новый владелец чата: в данном пункте указывается ID нового владельца чата.

ID чат-бота:в данном пункте указывается ID чат-бота, который участвует в чате, и от имени которого должна произойти смена владельца.

Чат-бот, от имени которого происходит смена владельца чата, должен быть его владельцем.
Данное активити можно использовать только для смены владельца чата с чат-бота на сотрудника или другого чат-бота.
Если владельцем чата является сотрудник, то данное активити не сможет сделать владельцем чата чат-бота из-за особенностей метода REST Б24.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Успех смены владельца

Удаление чат-бота

Данное активити позволяет удалить чат-бота, указав его данные.
Активити ищет бота последовательно по указанным данным и если находит, то удаляет бота.

Сценарий работы активити бизнес-процесса

ID бота: в данном поле указывается ID бота, которого надо удалить.
ID чат-бота можно узнать, перейдя в его профиль в структуре компании (раздел сотрудники ->чат-боты) и просмотрев в URL его ID

Код бота: в данном поле указывается код бота, которого надо удалить.
Данный код указывается при создании чат-бота, т.е тот, кто его создавал должен знать этот код. 

Имя бота: в данном поле указывается имя бота, которого надо удалить.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- успех удаления чат-бота.

Уведомления

Отправить персональные уведомления пользователям Битрикс24

Данное активити (робот) позволяет отправлять персональные уведомления пользователям Битрикс24.
Результатом работы является отправка персонального уведомления указанному пользователю с возможностью настройки тегов и вложений.

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

Название поля	Описание и примеры использования
ID пользователя получателя уведомления	В данном поле указывается числовой идентификатор пользователя, которому будет отправлено персональное уведомление. Это обязательный параметр. Пример: {=Document:ASSIGNED_BY_ID} или [U1]. Форматы указания пользователя: - Числовой ID: 1, 25, 100; - Формат с префиксом: [U1], [U25]; - Можно использовать переменные из предыдущих активити или полей сущности. Как получить ID пользователя-получателя: - Из полей CRM-сущностей (ответственный, контакт и т.д.); - Из результатов активити поиска пользователей; - Использовать текущего пользователя через системные переменные; - Из справочника сотрудников портала.
Текст персонального уведомления	В данном поле указывается текст персонального уведомления, который увидит пользователь. Это обязательный параметр. Поддерживается форматирование текста, BB-коды и HTML-разметка. Пример: {=Variable:MESSAGE_TEXT}. Форматирование текста уведомления: - Можно использовать BB-коды: [b]жирный[/b], [i]курсив[/i], [u]подчёркнутый[/u]; - Поддерживается HTML-разметка для более сложного форматирования; - Можно вставлять ссылки на элементы CRM, задачи, файлы; - Доступны переменные и поля из текущей сущности; - Персональные уведомления могут содержать обращение к пользователю по имени.
Текст уведомления для почты	В данном поле можно указать альтернативный текст уведомления, который будет использоваться при отправке на email. Это необязательный параметр. Если не задано, то используется поле "Текст уведомления". Пример: {=Variable:EMAIL_TEXT}. Когда использовать отдельный текст для почты: - Если основной текст содержит BB-коды, которые некорректно отображаются в email; - Когда нужен более развёрнутый текст для почтового уведомления; - Для добавления дополнительных ссылок и контактов в email-версию; - Если нужен упрощённый текст без форматирования для почты.
Тег уведомления	В данном поле указывается тег, уникальный в рамках системы. Это необязательный параметр, но очень важный для контроля дублирования уведомлений. Пример: {=Variable:NOTIFICATION_TAG} или "PERSONAL_DEAL_123". Важно (особенности работы тегов): При добавлении уведомления с существующим тегом другие уведомления с таким же тегом будут удалены. Это позволяет избежать дублирования однотипных уведомлений у пользователя. Примеры использования тегов: - TAG="PERSONAL_DEAL_123" - для персональных уведомлений о конкретной сделке; - TAG="PERSONAL_TASK_456" - для личных напоминаний о задаче; - TAG="WELCOME_MESSAGE" - для приветственных сообщений; - TAG="BIRTHDAY_GREETING_2025" - для персональных поздравлений. Если отправить новое уведомление с тем же тегом, старое уведомление с этим тегом удалится автоматически.
Дополнительный тег	В данном поле указывается дополнительный тег, без проверки на уникальность. Это необязательный параметр. Используется для дополнительной классификации уведомлений. Пример: {=Variable:SUB_TAG} или "TYPE|PERSONAL". Отличие от основного тега: - Основной тег (TAG) - проверяется на уникальность, удаляет предыдущие уведомления с таким же тегом; - Дополнительный тег (SUB_TAG) - НЕ проверяется на уникальность, используется только для группировки. Примеры использования дополнительного тега: - SUB_TAG="TYPE|PERSONAL" - тип персонального сообщения; - SUB_TAG="CATEGORY|GREETING" - категория приветствий; - SUB_TAG="EVENT|BIRTHDAY" - событие день рождения; - SUB_TAG="PRIORITY|HIGH" - высокий приоритет.
Вложение	В данном поле можно указать вложение к уведомлению в формате Битрикс24. Это необязательный параметр. Используется для передачи структурированных данных в уведомлении. Пример: {=Variable:ATTACH}. Формат вложений: Вложения передаются в специальном формате Битрикс24 Attach, который позволяет создавать изображения, ссылки, файлы, сетки с данными, форматированные блоки информации. Подробнее о формате вложений можно узнать в документации Битрикс24 REST API (раздел im.attach).
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. Важно: ID отправителя берётся из поля "Запускать от имени". Уведомление будет отправлено от имени пользователя, указанного в этом поле.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Описание примера	Решение
Поздравление с днём рождения	Параметры: ID пользователя получателя - {=Document:ID} (ID сотрудника), Текст персонального уведомления - "🎉 Поздравляем с Днём рождения, {=Document:NAME}! Желаем крепкого здоровья, профессиональных успехов и достижения всех целей!", Текст уведомления для почты - "Уважаемый {=Document:NAME}! От лица всего коллектива поздравляем Вас с Днём рождения! Желаем счастья, здоровья и новых профессиональных достижений.", Тег уведомления - BIRTHDAY_{=Document:ID}_{=Variable:current_year}, Дополнительный тег - EVENT|BIRTHDAY.
Приветствие нового сотрудника	Параметры: ID пользователя получателя - {=Document:ID} (ID нового сотрудника), Текст персонального уведомления - "Добро пожаловать в команду, {=Document:NAME}! 👋 Мы рады видеть Вас в нашей компании. Если возникнут вопросы, обращайтесь к своему наставнику или в отдел кадров.", Текст уведомления для почты - "Здравствуйте, {=Document:NAME}! Добро пожаловать в нашу компанию! В этом письме Вы найдете основную информацию для начала работы...", Тег уведомления - WELCOME_MESSAGE_{=Document:ID}, Дополнительный тег - TYPE|WELCOME.
Персональное напоминание о встрече	Параметры: ID пользователя получателя - {=Document:ATTENDEE_ID} (ID участника встречи), Текст персонального уведомления - "📅 {=Document:ATTENDEE_NAME}, через 30 минут у Вас встреча: '{=Document:EVENT_NAME}'. Место: {=Document:LOCATION}. Не забудьте подготовить необходимые материалы!", Тег уведомления - MEETING_REMINDER_{=Document:EVENT_ID}_{=Document:ATTENDEE_ID}, Дополнительный тег - TYPE|REMINDER.
Благодарность за выполненную работу	Параметры: ID пользователя получателя - {=Document:RESPONSIBLE_ID} (ответственный за задачу), Текст персонального уведомления - "⭐ {=Document:RESPONSIBLE_NAME}, благодарим за отличную работу над задачей '{=Document:TITLE}'! Ваш профессионализм и ответственный подход высоко ценятся командой.", Тег уведомления - THANK_YOU_{=Document:ID}, Дополнительный тег - TYPE|GRATITUDE.
Уведомление о бонусе	Параметры: ID пользователя получателя - {=Document:USER_ID}, Текст персонального уведомления - "💰 Отличная новость, {=Document:USER_NAME}! Вам начислен бонус в размере {=Document:BONUS_AMOUNT} руб. за {=Document:REASON}. Продолжайте в том же духе!", Текст уведомления для почты - "Уважаемый {=Document:USER_NAME}! Информируем Вас о начислении премии в размере {=Document:BONUS_AMOUNT} руб. Основание: {=Document:REASON}.", Тег уведомления - BONUS_NOTIFICATION_{=Document:USER_ID}_{=Variable:timestamp}, Дополнительный тег - TYPE|BONUS.
Персональные поздравления с годовщиной работы	Параметры: ID пользователя получателя - {=Document:USER_ID}, Текст персонального уведомления - "🎊 {=Document:USER_NAME}, поздравляем с {=Document:YEARS} летним юбилеем работы в компании! Благодарим за преданность и профессионализм!", Тег уведомления - ANNIVERSARY_{=Document:USER_ID}_{=Document:YEARS}, Дополнительный тег - EVENT|ANNIVERSARY.
Индивидуальное информирование о результатах выполнения задач	Параметры: ID пользователя получателя - {=Document:RESPONSIBLE_ID}, Текст персонального уведомления - "✅ Задача '{=Document:TITLE}' успешно выполнена! Результат: {=Variable:RESULT}. Отличная работа!", Тег уведомления - TASK_COMPLETE_{=Document:ID}, Дополнительный тег - TYPE|TASK_STATUS.
Личное напоминание о необходимости выполнения действий	Параметры: ID пользователя получателя - {=Document:ASSIGNED_BY_ID}, Текст персонального уведомления - "⏰ {=Document:ASSIGNED_BY_PRINTABLE}, напоминаем о необходимости выполнить действие по сделке '{=Document:TITLE}'. Срок истекает {{=dateadd({=Document:CLOSEDATE}, '-1d')}}.", Тег уведомления - ACTION_REMINDER_{=Document:ID}, Дополнительный тег - TYPE|REMINDER.
Индивидуальное сообщение при назначении ответственным	Параметры: ID пользователя получателя - {=Document:NEW_ASSIGNED_BY_ID}, Текст персонального уведомления - "👤 {=Document:NEW_ASSIGNED_BY_PRINTABLE}, Вы назначены ответственным за сделку '{=Document:TITLE}'. Сумма: {=Document:OPPORTUNITY} руб.", Тег уведомления - DEAL_ASSIGNED_{=Document:ID}, Дополнительный тег - TYPE|ASSIGNMENT.
Персональное уведомление о достижении цели	Параметры: ID пользователя получателя - {=Document:USER_ID}, Текст персонального уведомления - "🏆 {=Document:USER_NAME}, поздравляем с достижением цели! Вы выполнили план продаж на {=Variable:PERCENT}%. Так держать!", Тег уведомления - GOAL_ACHIEVED_{=Document:USER_ID}_{=Variable:MONTH}, Дополнительный тег - TYPE|ACHIEVEMENT.

Сценарий работы робота

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

• Персональные поздравления сотрудников с днём рождения или годовщиной работы;
• Личные напоминания о важных встречах и мероприятиях;
• Индивидуальное информирование о результатах выполнения задач;
• Персональные благодарности и поощрения от руководства;
• Личные уведомления о бонусах, премиях и достижениях;
• Приветственные сообщения для новых сотрудников;
• Персональные напоминания о необходимости выполнения действий;
• Индивидуальные сообщения при назначении ответственным за задачу или сделку.

Отличие персональных уведомлений от системных и сообщений в чат:
- Персональное уведомление (im.notify.personal.add) - личное сообщение от имени конкретного пользователя или с личным обращением;
- Системное уведомление (im.notify.system.add) - официальное уведомление от системы, более формальное;
- Сообщение в чат (imbot.message.add) - требует наличия чат-бота, отображается как сообщение в чате.

Используйте персональные уведомления для:
- Поздравлений и благодарностей;
- Личных обращений к сотрудникам;
- Неформальных напоминаний и уведомлений;
- Сообщений, требующих индивидуального подхода.

Возвращаемые параметры данного активити:
- Статус отправки (send_status) - Y (успешно) или N (ошибка);
- ID уведомления (notification_id) - числовой идентификатор созданного уведомления (для дальнейшего использования);
- Сообщение об ошибке (s_error_logs) - сообщение о результате выполнения или описание ошибки.

Лучшие практики использования персональных уведомлений:
1. Используйте обращение к пользователю по имени для создания дружественной атмосферы;
2. Персонализируйте текст в зависимости от контекста и получателя;
3. Используйте эмодзи для создания более живого и дружелюбного стиля общения;
4. Для важных формальных уведомлений лучше использовать системные уведомления;
5. Применяйте уникальные теги для предотвращения спама и дублирования сообщений.

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

Данное активити (робот) позволяет отправлять системные уведомления пользователям Битрикс24.
Результатом работы является отправка уведомления указанному пользователю с возможностью настройки тегов и вложений.

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

Название поля	Описание и примеры использования
ID пользователя	В данном поле указывается числовой идентификатор пользователя, которому будет отправлено системное уведомление. Это обязательный параметр. Пример: {=Document:ASSIGNED_BY_ID} или [U1]. Форматы указания пользователя: - Числовой ID: 1, 25, 100; - Формат с префиксом: [U1], [U25]; - Можно использовать переменные из предыдущих активити или полей сущности. Как получить ID пользователя: - Из полей CRM-сущностей (ответственный, контакт и т.д.); - Из результатов активити поиска пользователей; - Использовать текущего пользователя через системные переменные; - Из справочника сотрудников портала.
Текст уведомления	В данном поле указывается текст системного уведомления, который увидит пользователь. Это обязательный параметр. Поддерживается форматирование текста, BB-коды и HTML-разметка. Пример: {=Variable:MESSAGE_TEXT}. Форматирование текста уведомления: - Можно использовать BB-коды: [b]жирный[/b], [i]курсив[/i], [u]подчёркнутый[/u]; - Поддерживается HTML-разметка для более сложного форматирования; - Можно вставлять ссылки на элементы CRM, задачи, файлы; - Доступны переменные и поля из текущей сущности.
Текст для почты	В данном поле можно указать альтернативный текст уведомления, который будет использоваться при отправке на email. Это необязательный параметр. Если не указан, то в email будет отправлен текст из поля "Текст уведомления". Пример: {=Variable:EMAIL_TEXT}. Когда использовать отдельный текст для почты: - Если основной текст содержит BB-коды, которые некорректно отображаются в email; - Когда нужен более развёрнутый текст для почтового уведомления; - Для добавления дополнительных ссылок и контактов в email-версию; - Если нужен упрощённый текст без форматирования для почты.
Тег уведомления	В данном поле указывается уникальный тег уведомления в рамках системы. Это необязательный параметр, но очень важный для контроля дублирования уведомлений. Пример: {=Variable:NOTIFICATION_TAG} или "DEAL_STATUS_123". Важно (особенности работы тегов): При добавлении уведомления с существующим тегом все предыдущие уведомления с таким же тегом будут автоматически удалены. Это позволяет избежать дублирования однотипных уведомлений у пользователя. Примеры использования тегов: - TAG="DEAL_STATUS_123" - для уведомлений об изменении статуса конкретной сделки; - TAG="TASK_DEADLINE_456" - для напоминаний о дедлайне задачи; - TAG="PAYMENT_REMINDER" - для напоминаний об оплате; - TAG="DAILY_REPORT_2025-01-15" - для ежедневных отчётов с датой. Если отправить новое уведомление с тем же тегом, старое уведомление с этим тегом удалится автоматически.
Дополнительный тег	В данном поле указывается дополнительный тег без проверки на уникальность. Это необязательный параметр. Используется для дополнительной классификации уведомлений. Пример: {=Variable:SUB_TAG} или "CATEGORY|URGENT". Отличие от основного тега: - Основной тег (TAG) - проверяется на уникальность, удаляет предыдущие уведомления с таким же тегом; - Дополнительный тег (SUB_TAG) - НЕ проверяется на уникальность, используется только для группировки. Примеры использования дополнительного тега: - SUB_TAG="CATEGORY|URGENT" - категория срочности; - SUB_TAG="TYPE|PAYMENT" - тип уведомления; - SUB_TAG="PROJECT|25" - привязка к проекту; - SUB_TAG="DEPARTMENT|SALES" - привязка к отделу.
Вложение	В данном поле можно указать вложение к уведомлению в формате Битрикс24. Это необязательный параметр. Используется для передачи структурированных данных в уведомлении. Пример: {=Variable:ATTACH}. Формат вложений: Вложения передаются в специальном формате Битрикс24 Attach, который позволяет создавать изображения, ссылки, файлы, сетки с данными, форматированные блоки информации. Подробнее о формате вложений можно узнать в документации Битрикс24 REST API (раздел im.attach).
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Описание примера	Решение
Уведомление об изменении статуса сделки	Параметры: ID пользователя - {=Document:ASSIGNED_BY_ID} (ответственный за сделку), Текст уведомления - "Сделка #{=Document:ID} «{=Document:TITLE}» переведена на стадию 'Выставлен счёт'. Сумма счёта: {=Document:OPPORTUNITY} руб.", Тег уведомления - DEAL_STATUS_{=Document:ID}, Дополнительный тег - CATEGORY|DEAL_STATUS.
Напоминание о задаче с дедлайном	Параметры: ID пользователя - {=Document:RESPONSIBLE_ID} (ответственный за задачу), Текст уведомления - "⏰ Напоминание: задача «{=Document:TITLE}» должна быть выполнена через 2 часа! Срок: {=Document:DEADLINE}", Текст для почты - "Уважаемый коллега! Напоминаем, что задача '{=Document:TITLE}' должна быть завершена {=Document:DEADLINE}. Ссылка на задачу: [ссылка]", Тег уведомления - TASK_REMINDER_{=Document:ID}, Дополнительный тег - TYPE|DEADLINE_ALERT.
Уведомление руководителя о превышении суммы сделки	Параметры: ID пользователя - 1 (ID руководителя отдела продаж), Текст уведомления - "🔔 Крупная сделка! Менеджер {=Document:ASSIGNED_BY_PRINTABLE} создал сделку на сумму {=Document:OPPORTUNITY} руб. Требуется контроль. Сделка: {=Document:TITLE}", Тег уведомления - BIG_DEAL_ALERT_{=Document:ID}, Дополнительный тег - ALERT|BIG_AMOUNT.
Ежедневная сводка по задачам	Параметры: ID пользователя - {=Variable:user_id} (из переменной цикла по всем сотрудникам), Текст уведомления - "Доброе утро! У вас {=Variable:task_count} активных задач. Задачи с истекающим сроком: {=Variable:urgent_tasks}", Текст для почты - "Ежедневная сводка по задачам на {=Variable:current_date}. Активных задач: {=Variable:task_count}. Срочных задач: {=Variable:urgent_count}. Подробнее в Битрикс24.", Тег уведомления - DAILY_TASKS_{=Variable:current_date}, Дополнительный тег - REPORT|DAILY.
Уведомление об ошибке в процессе	Параметры: ID пользователя - 1 (ID администратора системы), Текст уведомления - "⚠️ ОШИБКА в бизнес-процессе! Процесс: '{=Document:BP_NAME}', Документ: {=Document:ID}, Ошибка: {=Variable:error_message}", Тег уведомления - BP_ERROR_{=Document:BP_ID}_{=Variable:timestamp}, Дополнительный тег - ERROR|CRITICAL.
Информирование руководителей о достижении KPI	Параметры: ID пользователя - {=Variable:MANAGER_ID}, Текст уведомления - "KPI достигнут! Показатель: {=Variable:KPI_NAME}, Значение: {=Variable:KPI_VALUE}, Цель: {=Variable:KPI_TARGET}. Отлично!", Тег уведомления - KPI_ACHIEVED_{=Variable:KPI_ID}_{=Variable:MONTH}, Дополнительный тег - REPORT|KPI.
Уведомление о необходимости согласования документов	Параметры: ID пользователя - {=Document:APPROVER_ID}, Текст уведомления - "Требуется согласование документа '{=Document:TITLE}'. Документ: {=Document:ID}, Инициатор: {=Document:CREATED_BY_PRINTABLE}", Тег уведомления - DOC_APPROVAL_{=Document:ID}, Дополнительный тег - TYPE|APPROVAL.
Автоматическое информирование о статусе выполнения бизнес-процессов	Параметры: ID пользователя - {=Document:ASSIGNED_BY_ID}, Текст уведомления - "Бизнес-процесс '{=Variable:BP_NAME}' завершён. Результат: {=Variable:RESULT}. Документ: {=Document:ID}", Тег уведомления - BP_COMPLETE_{=Document:ID}, Дополнительный тег - TYPE|BP_STATUS.
Информирование о новых назначениях и изменениях в рабочих задачах	Параметры: ID пользователя - {=Document:NEW_ASSIGNED_BY_ID}, Текст уведомления - "Назначение: Вы назначены исполнителем задачи '{=Document:TITLE}'. Срок: {=Document:DEADLINE}, Приоритет: {=Document:PRIORITY}", Тег уведомления - TASK_ASSIGNED_{=Document:ID}, Дополнительный тег - TYPE|ASSIGNMENT.
Уведомление о превышении лимитов	Параметры: ID пользователя - {=Variable:MANAGER_ID}, Текст уведомления - "⚠️ Внимание! Превышен лимит по показателю '{=Variable:LIMIT_NAME}'. Текущее значение: {=Variable:CURRENT_VALUE}, Лимит: {=Variable:LIMIT_VALUE}", Тег уведомления - LIMIT_EXCEEDED_{=Variable:LIMIT_ID}, Дополнительный тег - ALERT|LIMIT.

Сценарий работы робота

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

• Уведомление ответственного о важных изменениях в сделке, лиде или другой CRM-сущности;
• Напоминания о приближающихся дедлайнах задач и событий;
• Информирование руководителей о достижении KPI или превышении лимитов;
• Уведомление о необходимости согласования документов;
• Автоматическое информирование о статусе выполнения бизнес-процессов;
• Отправка персональных отчётов и сводок по расписанию;
• Уведомление об ошибках или проблемах в автоматизированных процессах;
• Информирование о новых назначениях и изменениях в рабочих задачах.

Отличие системных уведомлений от персональных и сообщений в чат:
- Системное уведомление (im.notify.system.add) - официальное уведомление от системы, отображается в центре уведомлений;
- Персональное уведомление (im.notify.personal.add) - персональное сообщение, больше похоже на личное обращение;
- Сообщение в чат (imbot.message.add) - требует наличия чат-бота, отображается как сообщение в чате.

Используйте системные уведомления для:
- Официальных оповещений о статусах и изменениях;
- Напоминаний о важных событиях;
- Технических уведомлений от автоматизированных процессов;
- Информирования о необходимости действий.

Возвращаемые параметры данного активити:
- Статус отправки (send_status) - Y (успешно) или N (ошибка);
- ID уведомления (notification_id) - числовой идентификатор созданного уведомления (для дальнейшего использования);
- Сообщение об ошибке (s_error_logs) - сообщение о результате выполнения или описание ошибки.

Лучшие практики использования тегов:
1. Используйте уникальные теги для каждого типа уведомлений;
2. Включайте в тег ID документа, чтобы уведомления не смешивались между разными сущностями;
3. Используйте префиксы для категоризации: DEAL_, TASK_, LEAD_, PROJECT_;
4. Добавляйте дату в тег для ежедневных/еженедельных уведомлений;
5. Дополнительный тег используйте для группировки по типам: ALERT|, REPORT|, INFO|, ERROR|.

Удаление уведомления

Данное активити (робот) позволяет удалять уведомления пользователей Битрикс24.
Результатом работы является удаление уведомления по его ID, тегу или дополнительному тегу.

ВАЖНО!
Для удаления уведомления необходимо указать хотя бы один из трёх параметров на выбор:
- ID (идентификатор уведомления);
- TAG (тег уведомления);
- SUB_TAG (дополнительный тег).

Можно также комбинировать несколько параметров для более точного удаления.
Если ни один из параметров не будет указан, активити вернёт ошибку.

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

Название поля	Описание и примеры использования
ID уведомления	В данном поле указывается числовой идентификатор уведомления, которое необходимо удалить. Это необязательный параметр, но хотя бы один из трёх параметров (ID, Тег или Дополнительный тег) должен быть заполнен. Пример: {=Variable:notification_id} или 12345. Как получить ID уведомления: - Из результата работы активити "Отправка персонального уведомления" (поле notification_id); - Из результата работы активити "Отправка системного уведомления" (поле notification_id); - Сохранённый из предыдущих операций с уведомлениями; - Переменная бизнес-процесса, в которой хранится ID уведомления. Примеры указания ID: - Прямое указание: 123, 456; - Через переменную: {=Variable:notification_id}; - Из результата предыдущего активити: {=Activity123:notification_id}.
Тег уведомления	В данном поле указывается тег уведомления, уникальный в рамках системы. Это необязательный параметр, но хотя бы один из трёх параметров должен быть заполнен. Пример: {=Variable:NOTIFICATION_TAG} или "PERSONAL_DEAL_123". Удаление по тегу: При указании тега будут удалены все уведомления с этим тегом у пользователя. Это особенно удобно для массового удаления однотипных уведомлений. Примеры использования тегов: - TAG="PERSONAL_DEAL_123" - удалить все персональные уведомления о сделке 123; - TAG="PERSONAL_TASK_456" - удалить напоминания о задаче 456; - TAG="WELCOME_MESSAGE" - удалить приветственные сообщения; - TAG="BIRTHDAY_GREETING_2025" - удалить поздравления с днём рождения за 2025 год. Практическое применение: Если вы отправляли уведомления с определённым тегом, вы можете удалить все эти уведомления, указав тот же тег.
Дополнительный тег	В данном поле указывается дополнительный тег уведомления, без проверки на уникальность. Это необязательный параметр, но хотя бы один из трёх параметров должен быть заполнен. Пример: {=Variable:SUB_TAG} или "TYPE|PERSONAL". Удаление по дополнительному тегу: При указании дополнительного тега будут удалены все уведомления с этим SUB_TAG. Это позволяет удалять уведомления по категориям или типам. Примеры использования дополнительного тега: - SUB_TAG="TYPE|PERSONAL" - удалить все персональные сообщения; - SUB_TAG="CATEGORY|GREETING" - удалить все поздравления; - SUB_TAG="EVENT|BIRTHDAY" - удалить все уведомления о днях рождения; - SUB_TAG="PRIORITY|HIGH" - удалить все высокоприоритетные уведомления. Важно: Можно комбинировать несколько параметров для более точного удаления. Например, указать и TAG, и SUB_TAG одновременно.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Описание примера	Решение
Удаление напоминания после выполнения задачи	Параметры: ID уведомления - {=Activity456:notification_id} (ID из активити отправки), Тег уведомления - TASK_REMINDER_{=Document:ID}, Дополнительный тег - TYPE|REMINDER. Когда задача выполнена, робот автоматически удаляет уведомление-напоминание.
Удаление уведомлений при отмене встречи	Параметры: Тег уведомления - MEETING_REMINDER_{=Document:EVENT_ID}, Дополнительный тег - EVENT|MEETING. При отмене или переносе встречи робот удаляет все связанные уведомления, все участники больше не будут получать напоминания об отменённом событии.
Массовая очистка по категории в конце года	Параметры: Дополнительный тег - EVENT|BIRTHDAY_2024. В конце года робот удаляет все поздравительные уведомления прошлого года для поддержания порядка и актуальности уведомлений в системе.
Удаление при смене ответственного за сделку	Параметры: Тег уведомления - DEAL_NOTIFICATION_{=Document:ID}_{=Document:OLD_ASSIGNED_BY_ID}, Дополнительный тег - TYPE|DEAL_ALERT. При смене ответственного робот удаляет уведомления предыдущего ответственного, новому ответственному будут отправлены новые уведомления.
Удаление при закрытии сделки	Параметры: Тег уведомления - DEAL_TEMP_{=Document:ID}, Дополнительный тег - STATUS|TEMPORARY. При успешном закрытии сделки робот удаляет все временные уведомления, после завершения работы по сделке все промежуточные напоминания становятся неактуальными.
Удаление дублирующихся уведомлений	Параметры: Тег уведомления - UNIQUE_NOTIFICATION_{=Document:ID}. При повторной отправке уведомления с уникальным тегом робот сначала удаляет старое уведомление, затем отправляет новое, гарантируя, что пользователь увидит только актуальную версию уведомления.
Удаление устаревших уведомлений о встречах	Параметры: Тег уведомления - {=Variable:MEETING_TAG}, Дополнительный тег - TYPE|MEETING. Автоматическое удаление уведомлений о встречах, которые уже прошли или были отменены.
Очистка при переводе пользователя в другой отдел	Параметры: Дополнительный тег - DEPARTMENT|OLD_DEPT_{=Variable:OLD_DEPARTMENT_ID}. При переводе пользователя робот удаляет все уведомления, связанные с его предыдущим отделом.
Удаление служебных уведомлений по расписанию	Параметры: Дополнительный тег - CATEGORY|SERVICE, Тег уведомления - {=Variable:SERVICE_TAG}. Робот по расписанию удаляет все служебные уведомления определённого типа для очистки системы.
Удаление тестовых уведомлений после завершения тестирования	Параметры: Тег уведомления - TEST_NOTIFICATION_{=Variable:TEST_ID}, Дополнительный тег - TYPE|TEST. После завершения тестирования робот удаляет все тестовые уведомления для очистки системы от временных данных.

Сценарий работы робота

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

• Удаление устаревших уведомлений о встречах и событиях;
• Очистка уведомлений при отмене задач или изменении статусов;
• Удаление временных напоминаний после выполнения действия;
• Массовое удаление однотипных уведомлений по тегу;
• Очистка уведомлений при закрытии сделок или завершении проектов;
• Удаление дублирующихся уведомлений;
• Очистка спам-уведомлений или ошибочно отправленных сообщений;
• Удаление уведомлений при переводе пользователя в другой отдел.

Особенности работы с параметрами удаления:
- Можно указать только ID для удаления конкретного уведомления;
- Можно указать только TAG для удаления всех уведомлений с этим тегом;
- Можно указать только SUB_TAG для удаления всех уведомлений с этим дополнительным тегом;
- Можно комбинировать параметры для более точного удаления;
- Если ни один параметр не указан, активити вернёт ошибку.

Связь с другими активити уведомлений:
- Отправка персонального уведомления (notify_personal_add) - создаёт персональное уведомление, возвращает notification_id;
- Отправка системного уведомления (notify_system_add) - создаёт системное уведомление, возвращает notification_id;
- Удаление уведомления (notify_delete) - удаляет уведомления по ID, TAG или SUB_TAG.

Используйте эти активити вместе для полного управления уведомлениями в бизнес-процессах.

Важно помнить:
Удалённые уведомления невозможно восстановить. Убедитесь, что удаляете правильные уведомления, проверив параметры перед запуском робота.

При использовании тегов для удаления будут удалены ВСЕ уведомления с указанным тегом или дополнительным тегом.
Будьте внимательны при массовом удалении.

Возвращаемые параметры данного активити:
- Статус удаления (delete_status) - Y (успешно) или N (ошибка);
- Сообщение об ошибке (s_error_logs) - сообщение о результате выполнения или описание ошибки.

Лучшие практики использования удаления уведомлений:
1. Всегда используйте теги при отправке уведомлений, если планируете их удалять;
2. Сохраняйте notification_id из активити отправки для точечного удаления;
3. Используйте дополнительные теги для категоризации и массового удаления;
4. Удаляйте устаревшие уведомления автоматически при изменении статусов;
5. Комбинируйте параметры для более точного контроля удаления;
6. Регулярно очищайте временные и промежуточные уведомления;
7. При массовых рассылках используйте уникальные теги для каждой категории.

Прочитать уведомления

Данное активити (робот) позволяет отмечать уведомления пользователей Битрикс24 как прочитанные или непрочитанные.
Результатом работы является изменение статуса прочтения для указанных уведомлений.

Основное назначение:
Активити позволяет программно управлять статусом прочтения уведомлений, что полезно для:
- Автоматической отметки уведомлений при выполнении определённых действий;
- Массовой обработки уведомлений по категориям;
- Сброса статуса для повторного привлечения внимания;
- Интеграции с системами обработки задач и уведомлений.

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

Название поля	Описание и примеры использования
ID уведомлений	В данном поле указывается массив идентификаторов уведомлений, которые необходимо отметить. Это обязательный параметр. Можно указать одно или несколько ID уведомлений. Пример: {=Variable:notification_ids} или "1,2,3,4,5". Как получить ID уведомлений: - Из результата работы активити "Отправка персонального уведомления" (поле notification_id); - Из результата работы активити "Отправка системного уведомления" (поле notification_id); - Из результата активити поиска или получения списка уведомлений; - Сохранённые из предыдущих операций в переменные бизнес-процесса; - Массив ID из итератора или цикла обработки. Форматы указания ID: - Прямое указание нескольких ID: 123, 456, 789; - Через переменную с массивом: {=Variable:notification_ids}; - Из результата предыдущего активити: {=Activity123:search_results_array}; - Строка с ID через запятую: "1,2,3,4,5" (автоматически преобразуется в массив). Важно: Поле поддерживает множественный выбор (Multiple), поэтому можно указать несколько ID одновременно.
Действие	В данном поле выбирается, как отметить уведомления - как прочитанные или непрочитанные. Это необязательный параметр, по умолчанию используется значение Y (прочитанные). Варианты действия: - Y (прочитанные) - уведомления будут отмечены как прочитанные и исчезнут из списка непрочитанных; - N (непрочитанные) - уведомления будут отмечены как непрочитанные и появятся в списке активных уведомлений. Когда использовать разные действия: Отметить как прочитанные (Y): После автоматической обработки уведомления; При выполнении связанной задачи или действия; Для массовой очистки уведомлений определённого типа; При закрытии связанных сделок или проектов. Отметить как непрочитанные (N): Для повторного привлечения внимания к важному уведомлению; При эскалации проблемы или задачи; Если действие требует повторного рассмотрения; Для сброса статуса при изменении условий.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Описание примера	Решение
Автоматическая отметка после выполнения задачи	Параметры: ID уведомлений - {=Variable:saved_notification_id}, Действие - Y (отметить как прочитанные). При завершении задачи робот отмечает связанное уведомление как прочитанное, условие: статус задачи = "Завершена". Уведомление о задаче автоматически исчезает из списка непрочитанных.
Массовая обработка уведомлений по тегу	Параметры: ID уведомлений - {=Activity456:search_results_array} (из результата поиска по тегу), Действие - Y (отметить как прочитанные). После завершения проекта робот отмечает все связанные уведомления как прочитанные, все уведомления автоматически очищаются.
Повторная активация важного уведомления	Параметры: ID уведомлений - {=Variable:urgent_notification_id}, Действие - N (отметить как непрочитанные). Если сотрудник не отреагировал на важное уведомление в течение более 24 часов и задача не выполнена, робот возвращает уведомление в статус "непрочитанное" для повторного привлечения внимания.
Очистка после изменения статуса сделки	Параметры: ID уведомлений - {=Activity789:search_results_array} (из поиска по тегу DEAL_{=Document:ID}), Действие - Y (отметить как прочитанные). При переходе сделки на стадию "Успешно реализовано" робот автоматически отмечает все уведомления по сделке как прочитанные.
Эскалация с возвратом уведомления	Параметры: ID уведомлений - {=Variable:original_notification_id}, Действие - N (отметить как непрочитанные). При эскалации проблемы (проблема не решена в срок) робот возвращает уведомление в статус "непрочитанное" для повторного рассмотрения, одновременно отправляя новое уведомление руководителю.
Итератор для массовой обработки	Параметры: ID уведомлений - {=Variable:current_notification_id}, Действие - Y (если условие выполнено) или N (если нужно вернуть внимание). Обработка большого количества уведомлений через итератор: получить список всех уведомлений определённого типа, обработать каждое уведомление индивидуально с проверкой условий.
Массовая отметка уведомлений после закрытия проекта	Параметры: ID уведомлений - {=Variable:PROJECT_NOTIFICATIONS} (массив ID всех уведомлений проекта), Действие - Y (отметить как прочитанные). При закрытии проекта все связанные уведомления автоматически отмечаются как прочитанные.
Возврат уведомления при изменении приоритета задачи	Параметры: ID уведомлений - {=Variable:TASK_NOTIFICATION_ID}, Действие - N (отметить как непрочитанные). При изменении приоритета задачи с обычного на высокий робот возвращает связанное уведомление в статус "непрочитанное" для привлечения внимания к изменившейся ситуации.
Очистка уведомлений по расписанию	Параметры: ID уведомлений - {=Variable:OLD_NOTIFICATIONS} (получены через поиск по дате), Действие - Y (отметить как прочитанные). Робот по расписанию отмечает все уведомления старше определенной даты как прочитанные для очистки списка непрочитанных.
Управление статусом уведомлений при смене ответственного	Параметры: ID уведомлений - {=Variable:OLD_RESPONSIBLE_NOTIFICATIONS}, Действие - Y (отметить как прочитанные). При смене ответственного за сделку робот отмечает все уведомления предыдущего ответственного как прочитанные, так как они больше не актуальны для него.

Сценарий работы робота

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

• Автоматическая отметка уведомлений при выполнении связанных действий;
• Массовая обработка уведомлений по результатам других активити;
• Очистка прочитанных уведомлений определённых типов;
• Повторная активация важных уведомлений для привлечения внимания;
• Управление статусом уведомлений в зависимости от изменения данных;
• Интеграция с системой задач и автоматическая отметка связанных уведомлений;
• Синхронизация статусов уведомлений между разными системами;
• Автоматическая очистка уведомлений при закрытии сделок или проектов.

Особенности работы с массовыми операциями:
- Можно отметить одно уведомление, указав один ID;
- Можно отметить несколько уведомлений, указав массив ID;
- Все указанные уведомления будут обработаны одним запросом;
- При ошибке операция не выполняется ни для одного из ID;
- Поле processed_count показывает фактическое количество обработанных уведомлений.

Интеграция с другими активити уведомлений:
Активити "Отметка уведомлений" является частью комплексной системы управления уведомлениями:
- Отправка персонального уведомления (notify_personal_add) → создаёт уведомление, возвращает notification_id;
- Отправка системного уведомления (notify_system_add) → создаёт уведомление, возвращает notification_id;
- Отметка уведомлений (notify_read_list) → изменяет статус прочтения по ID;
- Удаление уведомления (notify_delete) → удаляет уведомления по ID, TAG или SUB_TAG.

Типичный цикл работы: 1. Создание уведомления (personal_add или system_add) → получение ID; 2. Сохранение ID в переменную для последующего использования; 3. Выполнение бизнес-логики и ожидание действий; 4. Отметка уведомления (read_list) или удаление (delete) в зависимости от результата.

Разница между отметкой и удалением уведомлений:
Отметка уведомлений (notify_read_list): Уведомления остаются в системе, но меняют статус прочтения; Можно вернуть уведомление обратно в статус "непрочитанное"; Сохраняется история уведомлений; Подходит для временного управления видимостью.
Удаление уведомлений (notify_delete): Уведомления полностью удаляются из системы; Операция необратима, восстановить уведомление нельзя; Используется для окончательной очистки; Подходит для устаревших или ошибочных уведомлений.
Рекомендация: Используйте отметку для управления вниманием, а удаление - для окончательной очистки системы.

Возвращаемые параметры данного активити:
- Статус операции (read_status) - Y (успешно) или N (ошибка);
- Количество обработанных уведомлений (processed_count) - число успешно обработанных ID;
- Тип выполненного действия (action_type) - Y (прочитанные) или N (непрочитанные);
- Сообщение об ошибке (s_error_logs) - сообщение о результате выполнения или описание ошибки.

Лучшие практики использования отметки уведомлений:
1. Сохраняйте ID уведомлений в переменные БП для последующей работы с ними;
2. Используйте теги при создании уведомлений для удобного поиска и группировки;
3. Отмечайте уведомления как прочитанные автоматически после выполнения связанных действий;
4. Используйте возврат в статус "непрочитанное" для эскалации и повторного привлечения внимания;
5. При массовой обработке используйте активити поиска для получения списка ID;
6. Проверяйте поле processed_count для контроля успешности операции;
7. Комбинируйте с условиями и итераторами для сложной логики обработки;
8. Используйте отметку вместо удаления, если уведомления могут понадобиться в истории.

Режим отладки

Данная статья описывает как пользоваться режимом отладки в наших активити.

Для активации режима отладки требуется в настройках активити, в поле "Делать отладочные сообщения в журнал БП" выбрать "Да".

После активации этой опции, активити в случае ошибки или неисправности, будет выводить сообщение в журнал БП.

ВАЖНО!
Нужно не забывать выключать режим отладки после использования, т.к данный режим может более - чем в двое увеличить количество запросов к REST Api.

Подробности ошибок описываются после слова ОШИБКА(ERROR).

Если в поле "Делать отладочные сообщения в журнал БП", выбрано значение "Не установлено", то по умолчанию, это значит, что отладочные сообщения выводиться не будут.

Нет описания

Информация по данному активити будет добавлена в ближайшее время.