Поиск Сделки (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. Это позволит обработать все сделки последовательно.

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

Поиск Сделки (v.2)