Добавление цены товара

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

Название поля	Описание и примеры использования
ID товара	В данном поле указывается идентификатор товара, для которого создаётся цена. Это обязательный параметр. ID товара можно получить методами catalog.product.list, catalog.product.offer.list, catalog.product.service.list, catalog.product.sku.list. Примеры: - 123 - указать ID товара напрямую; - {=Variable:PRODUCT_ID} - использовать ID товара из переменной бизнес-процесса; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки, лида и т.д.). Важно: Если поле "ID товара" пустое или указан несуществующий товар, активити (робот) завершится с ошибкой. Обязательно укажите корректный ID товара.
Значение цены	В данном поле указывается числовое значение цены товара. Это обязательный параметр. Поддерживаются дробные значения (например, 123.45). Примеры: - 1000 - указать цену 1000; - 1250.50 - указать цену с копейками 1250.50; - {=Variable:PRICE} - использовать значение цены из переменной бизнес-процесса; - ={{={=Document:OPPORTUNITY} * 0.9}} - вычислить цену как 90% от суммы сделки; - ={{=round({=Variable:BASE_PRICE} * 1.2, 2)}} - вычислить цену с наценкой 20% и округлить до 2 знаков после запятой. Важно: Если поле "Значение цены" пустое или равно нулю, активити (робот) завершится с ошибкой. Обязательно укажите положительное значение цены.
Валюта	В данном поле выбирается валюта для цены товара из списка доступных валют портала. Это обязательный параметр. Список валют формируется автоматически при установке активити (робота) на основе настроек портала. Примеры: - RUB - выбрать российский рубль; - USD - выбрать доллар США; - EUR - выбрать евро; - {=Variable:CURRENCY} - использовать валюту из переменной бизнес-процесса (значение должно быть кодом валюты, например RUB, USD). Важно: Если поле "Валюта" не выбрано, активити (робот) завершится с ошибкой. Обязательно выберите валюту из списка.
Тип цены	В данном поле выбирается тип цены из списка доступных типов цен портала. Это обязательный параметр. Типы цен формируются автоматически при установке активити (робота) на основе настроек торгового каталога (например, базовая цена, оптовая цена и т.д.). Примеры: - 1 - выбрать тип цены с ID 1 (обычно базовая цена); - 2 - выбрать тип цены с ID 2 (например, оптовая цена); - {=Variable:PRICE_TYPE_ID} - использовать тип цены из переменной бизнес-процесса. Важно: Если поле "Тип цены" не выбрано, активити (робот) завершится с ошибкой. Обязательно выберите тип цены из списка.
Количество от	В данном поле указывается минимальное количество товара, начиная с которого действует указанная цена. Это необязательный параметр. Используется для установки оптовых цен или скидок при покупке большого количества товара. Примеры: - 10 - цена действует от 10 штук; - 100 - цена действует от 100 штук; - {=Variable:QUANTITY_FROM} - использовать значение из переменной бизнес-процесса; - Пусто - цена действует для любого количества (начиная с 1).
Количество до	В данном поле указывается максимальное количество товара, до которого действует указанная цена. Это необязательный параметр. Используется вместе с полем "Количество от" для установки диапазона количества, на который распространяется цена. Примеры: - 50 - цена действует до 50 штук; - 999 - цена действует до 999 штук; - {=Variable:QUANTITY_TO} - использовать значение из переменной бизнес-процесса; - Пусто - цена действует без ограничения по максимальному количеству.
Внешний идентификатор	В данном поле указывается внешний идентификатор цены для синхронизации с внешними системами. Это необязательный параметр. Примеры: - EXT_PRICE_001 - указать внешний идентификатор; - {=Variable:EXTERNAL_ID} - использовать внешний идентификатор из переменной бизнес-процесса.
Вес цены (для сортировки)	В данном поле указывается числовое значение для сортировки цен. Это необязательный параметр. Используется для определения порядка отображения цен при наличии нескольких цен у одного товара. Примеры: - 100 - установить вес цены 100; - {=Variable:PRICE_SCALE} - использовать значение из переменной бизнес-процесса.

Описание примера	Решение
Создать базовую цену для товара в рублях	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 1000, Валюта - RUB, Тип цены - 1. Активити (робот) создаст базовую цену 1000 рублей для товара с указанным ID.
Добавить оптовую цену с минимальным количеством	Параметры: ID товара - {=Document:PRODUCT_ID}, Значение цены - 800, Валюта - RUB, Тип цены - 2, Количество от - 10. Активити (робот) создаст оптовую цену 800 рублей, действующую при покупке от 10 штук товара.
Установить цену в долларах США	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 50, Валюта - USD, Тип цены - 1. Активити (робот) создаст цену 50 долларов США для товара.
Создать цену с вычислением на основе суммы сделки	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - ={{={=Document:OPPORTUNITY} / {=Variable:QUANTITY}}}, Валюта - RUB, Тип цены - 1. Активити (робот) вычислит цену как частное от деления суммы сделки на количество товара.
Добавить цену с наценкой 15% от базовой цены	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - ={{={=Variable:BASE_PRICE} * 1.15}}, Валюта - RUB, Тип цены - 1. Активити (робот) вычислит цену с наценкой 15% от базовой цены из переменной.
Установить цену для диапазона количества товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 700, Валюта - RUB, Тип цены - 2, Количество от - 50, Количество до - 100. Активити (робот) создаст оптовую цену 700 рублей для покупки от 50 до 100 штук товара.
Создать цену с внешним идентификатором для синхронизации	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 1200, Валюта - RUB, Тип цены - 1, Внешний идентификатор - EXT_{=Variable:PRODUCT_ID}_PRICE. Активити (робот) создаст цену с внешним идентификатором для последующей синхронизации с внешней системой.
Добавить цену в евро с округлением до 2 знаков	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - ={{=round({=Variable:PRICE_EUR}, 2)}}, Валюта - EUR, Тип цены - 1. Активити (робот) создаст цену в евро, округлённую до 2 знаков после запятой.
Установить цену с приоритетом сортировки	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 1500, Валюта - RUB, Тип цены - 1, Вес цены (для сортировки) - 200. Активити (робот) создаст цену с высоким приоритетом сортировки (200), которая будет отображаться первой среди других цен.
Создать цену для товара из сделки с автоматическим вычислением	Параметры: ID товара - {=Document:PRODUCT_ID}, Значение цены - ={{={=Document:OPPORTUNITY} * 0.95}}, Валюта - {=Document:CURRENCY_ID}, Тип цены - 1. Активити (робот) создаст цену со скидкой 5% от суммы сделки в валюте сделки.