Данные по цене товара

Активити (робот) "Данные по цене товара" предназначено для использования в роботах и может быть полезно в следующих сценариях: получение текущей цены для расчётов в бизнес-процессе, проверка валюты и типа цены перед изменением, получение диапазона количества для оптовых цен, получение внешнего идентификатора для синхронизации с внешними системами, контроль корректности данных цены по её ID.

Как работает активити (робот):
- Активити (робот) принимает ID цены товара;
- Выполняет запрос к API Битрикс24 для получения данных цены;
- Возвращает основные поля цены (ID товара, значение, валюта, тип цены, количество от/до, внешний идентификатор);
- Возвращает флаг успешного выполнения ok_ready (Да/Нет).

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

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

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

Название поля	Описание и примеры использования
ID цены товара	В данном поле указывается идентификатор цены товара, по которому нужно получить данные. Это обязательный параметр. ID цены можно получить из результата активити (робота) "Добавить цену товара" (параметр id_new_price) или из результатов активити (робота) "Поиск цен товаров по фильтру" (параметр search_results_array). Примеры: - 456 - указать ID цены напрямую; - {=Variable:PRICE_ID} - взять ID цены из переменной бизнес-процесса; - {=Variable:id_new_price} - взять ID цены из результата активити (робота) "Добавить цену товара"; - {=Variable:search_result_first_string} - взять первый найденный ID из результата поиска цен. Важно: Если поле "ID цены товара" пустое или указан несуществующий ID, активити (робот) завершится с ошибкой. Обязательно передавайте корректный идентификатор цены.

Название поля

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

ID цены товара

В данном поле указывается идентификатор цены товара, по которому нужно получить данные.
Это обязательный параметр.
ID цены можно получить из результата активити (робота) "Добавить цену товара" (параметр id_new_price) или из результатов активити (робота) "Поиск цен товаров по фильтру" (параметр search_results_array).

Примеры:
- 456 - указать ID цены напрямую;
- {=Variable:PRICE_ID} - взять ID цены из переменной бизнес-процесса;
- {=Variable:id_new_price} - взять ID цены из результата активити (робота) "Добавить цену товара";
- {=Variable:search_result_first_string} - взять первый найденный ID из результата поиска цен.

Важно: Если поле "ID цены товара" пустое или указан несуществующий ID, активити (робот) завершится с ошибкой.
Обязательно передавайте корректный идентификатор цены.

Возвращаемые параметры:
- ID цены (Число) - ID цены товара;
- ID товара (Число) - ID товара, к которому относится цена;
- Значение цены (Строка) - значение цены;
- Валюта (Строка) - валюта цены (например RUB, USD, EUR);
- Тип цены (Число) - ID типа цены (например базовая, оптовая и т.д.);
- Количество (от) (Число) - количество "от" (если цена действует от определённого количества);
- Количество (до) (Число) - количество "до" (если цена действует до определённого количества);
- Внешний идентификатор (Строка) - внешний идентификатор цены (если используется для синхронизации);
- Успех операции (статус выполнения) - (Да/Нет), флаг успешного выполнения активити (робота).

Важно о возвращаемых параметрах: Если цена не найдена, параметр "Успех операции" будет равен "Нет".
Рекомендуется сначала проверить параметр "Успех операции", и только после этого использовать параметры Цена, Валюта и другие.

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

Описание примера	Решение
Получить данные цены по ID из переменной	Параметры: ID цены товара - {=Variable:PRICE_ID}. Активити (робот) вернёт данные цены, а вы сможете использовать Цена и Валюта в дальнейших шагах.
Получить данные цены сразу после создания	Параметры: ID цены товара - {=Variable:id_new_price}. Активити (робот) вернёт данные созданной цены, чтобы проверить корректность заполнения.
Получить данные первой найденной цены после поиска	Параметры: ID цены товара - {=Variable:search_result_first_string}. Активити (робот) вернёт данные первой найденной цены из результата активити (робота) "Поиск цен товаров по фильтру".
Проверить валюту цены перед конвертацией	Параметры: ID цены товара - {=Variable:PRICE_ID}. После выполнения активити (робота) используйте возвращаемый параметр Валюта для проверки (например, RUB) и выбора нужной ветки бизнес-процесса.
Получить диапазон количества для оптовой цены	Параметры: ID цены товара - {=Variable:PRICE_ID}. После выполнения активити (робота) используйте "Количество (от)" и "Количество (до)", чтобы определить для какого количества действует оптовая цена.
Получить ID товара по ID цены	Параметры: ID цены товара - 456. Активити (робот) вернёт productId, чтобы затем работать с товаром (например, обновлять поля товара или формировать уведомления).
Получить тип цены для ветвления логики (базовая/оптовая)	Параметры: ID цены товара - {=Variable:PRICE_ID}. Используйте возвращаемый параметр "Тип цены" для выбора сценария обновления или проверки.
Получить внешний идентификатор цены для синхронизации	Параметры: ID цены товара - {=Variable:PRICE_ID}. Используйте возвращаемый параметр "Внешний идентификатор" для сопоставления цены с записью во внешней системе.
Проверить, что цена существует перед удалением	Параметры: ID цены товара - {=Variable:PRICE_ID}. Если ok_ready = "Да", можно безопасно запускать активити (робот) "Удалить цену товара" с тем же ID.
Собрать текст для уведомления с ценой и валютой	Параметры: ID цены товара - {=Variable:PRICE_ID}. После выполнения активити (робота) сформируйте сообщение вида "Цена: [значение] [валюта]" на основе возвращаемых параметров price и currency.

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

Данные по цене товара