Изменить цену товара

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