Поиск коммерческого предложения

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

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

Как работает активити (робот):
- Формирует фильтр по заполненным полям параметров и выполняет поиск коммерческих предложений в CRM;
- Поддерживает операторы сравнения в текстовых и числовых полях (равно, не равно, больше, меньше, содержит и др.);
- Условия по разным полям объединяются по принципу «И» — должны выполняться одновременно;
- При успешном поиске возвращает стандартный набор полей: массив ID, строку ID, первый и последний ID, количество;
- Если записи не найдены, возвращается признак неуспешного поиска math_search_results = N.

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

Название поля	Описание и примеры использования
ID коммерческого предложения	Числовой идентификатор коммерческого предложения. Примеры: - ={123} — найти КП с ID 123; - {=Variable:QUOTE_ID}.
Название	Название коммерческого предложения. Поддерживаются операторы сравнения. Примеры: - ={%КП} — найти КП, в названии которых есть «КП»; - ={Коммерческое предложение по сделке}.
Ответственный	ID ответственного сотрудника. Примеры: - ={user_1}; - {=User:ID}.
ID связанной сделки	ID сделки, к которой привязано коммерческое предложение. Примеры: - {=Document:ID} — найти все КП текущей сделки; - ={456}.
ID компании / ID контакта	Фильтр по привязанной компании или контакту. Примеры: - ID компании — {=Document:COMPANY_ID}; - ID контакта — {=Document:CONTACT_ID}.
Статус коммерческого предложения	Один или несколько статусов из справочника портала (множественный выбор). Примеры: - Выберите статус «Принято» для поиска согласованных КП.
Сумма / Валюта	Фильтр по сумме и коду валюты коммерческого предложения. Примеры: - Сумма — ={>100000}; - Валюта — ={RUB}.
Дата начала / Дата завершения	Фильтр по датам коммерческого предложения с поддержкой операторов и диапазонов. Примеры: - Дата начала — ={>=01.01.2026}; - Дата завершения — ={{01.01.2026}}##{{31.01.2026}}.

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

Описание примера	Решение
Найти все КП по текущей сделке	Параметры: ID связанной сделки — {=Document:ID}. Результат: search_results_array — массив ID найденных КП.
Найти КП по точному ID	Параметры: ID коммерческого предложения — ={=Variable:QUOTE_ID}. Результат: search_result_first_string — ID записи.
Найти КП по части названия	Параметры: Название — ={%договор}. Результат: count_search — количество найденных записей.
Найти КП ответственного менеджера	Параметры: Ответственный — {=Document:ASSIGNED_BY_ID}. Используйте для отчётов по нагрузке.
Найти КП в статусе «Отправлено»	Параметры: Статус — выбрать нужный статус из списка. Далее обработайте search_results_string.
Найти КП компании из сделки	Параметры: ID компании — {=Document:COMPANY_ID}, ID связанной сделки — {=Document:ID}.
Найти КП с суммой больше порога	Параметры: Сумма — ={>500000}, Валюта — ={RUB}. Результат: math_search_results — Y или N.
Проверить наличие КП перед созданием	Параметры: ID связанной сделки — {=Document:ID}. Если math_search_results = N, создайте новое КП следующим шагом.
Обработать все найденные КП в цикле	После поиска передайте search_results_array в итератор и для каждого ID вызовите робот обновления или получения данных.
Найти КП за период	Параметры: Дата начала — ={>=01.06.2026}, Дата завершения — ={<=30.06.2026}. Результат: search_results_string через запятую.

Возвращаемые параметры данного активити (робота):
- Соответствует условиям (math_search_results) — Y или N;
- Количество (count_search) — число найденных коммерческих предложений;
- Массив ID (search_results_array) — список идентификаторов;
- Строка ID (search_results_string) — ID через запятую;
- Первый ID (search_result_first_string) и Последний ID (search_result_last_string);
- Сообщение (s_error_logs) — служебная информация о результате поиска.

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

Хотя бы одно поле:
Для поиска заполните хотя бы один параметр фильтра. Пустой фильтр не даст осмысленного результата.

Комбинация условий:
Все указанные поля объединяются условием «И». Для более гибкой логики выполните несколько поисков в разных ветках бизнес-процесса.

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

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

Поиск коммерческого предложения