Поиск цен товаров по фильтру

Активити (робот) "Поиск цен товаров по фильтру" предназначено для использования в роботах и может быть полезно в следующих сценариях: поиск цен по 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 из результата поиска (Строка) ;
- Строка для служебных сообщений и отладки (Строка) .

Важно о возвращаемых параметрах: Если цены не найдены, параметр "Результат поиска" будет равен N, а "Количество найденных элементов" будет равено 0.
Всегда проверяйте "Результат поиска" перед использованием параметра "Массив ID найденных цен".

Важно! Ограничения и рекомендации:
- Для успешного запуска должен быть заполнен хотя бы один параметр поиска;
- Рекомендуется по возможности указывать ID товара и тип цены, чтобы получить точные результаты;
- Если ожидается много результатов, используйте итератор по массиву и обрабатывайте цены последовательно.

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

Описание примера	Решение
Найти все цены конкретного товара	Параметры: ID товара - {=Variable:PRODUCT_ID}. Активити (робот) вернёт массив ID всех цен данного товара в параметре "Массив ID".
Найти базовую цену товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип цены - 1. Активити (робот) вернёт ID базовой цены товара.
Найти оптовые цены товара в рублях	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип цены - 2, Валюта - RUB. Активити (робот) вернёт ID оптовых цен в рублях.
Найти цены, действующие от 10 единиц товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Количество от - 10. Активити (робот) вернёт цены, у которых "Количество от" равно 10.
Найти цены в долларах США по всему каталогу	Параметры: Валюта - USD. Активити (робот) вернёт ID всех цен в валюте USD.
Найти цену по внешнему идентификатору	Параметры: Внешний идентификатор - EXT_PRICE_001. Активити (робот) вернёт ID цены, связанной с записью во внешней системе.
Подготовить список цен для получения подробных данных	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип цены - 1. Затем используйте итератор по массиву значений и запускайте активити (робот) "Данные по цене товара" с ID цены товара - {=Variable:search_results_array}.
Найти цены для последующего удаления (очистка тестовых данных)	Параметры: Внешний идентификатор - TEST_{=Variable:PRODUCT_ID}. Затем используйте итератор по search_results_array и запускайте активити (робот) "Удалить цену товара" с ID цены товара - {=Variable:search_results_array}.
Найти цены по диапазону количества	Параметры: Количество от - 50, Количество до - 100, Валюта - RUB. Активити (робот) вернёт цены для диапазона 50-100 в рублях.
Найти цены с заданным весом сортировки	Параметры: Вес цены (для сортировки) - 200. Активити (робот) вернёт цены с указанным индексом сортировки.

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

Поиск цен товаров по фильтру