Добавить вариацию товара

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

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

Как работает активити (робот):
- Активити (робот) создаёт новую вариацию товара в каталоге CRM с указанными параметрами;
- Вариация автоматически привязывается к указанному товару (parentId);
- Поддерживается указание всех основных характеристик вариации (наименование, код, размеры, вес, цены);
- Можно указать параметры активности, доступности, количества и резервирования;
- Поддерживается указание НДС и валюты закупочной цены;
- Активити (робот) возвращает ID созданной вариации для использования в дальнейших шагах бизнес-процесса;
- Поддерживается указание пользовательских свойств товара (property1635, property1637 и др.).

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

Название поля	Описание и примеры использования
ID товара	В данном поле указывается числовой идентификатор (ID) товара, к которому будет привязана создаваемая вариация. Это обязательный параметр. Примеры использования: - 30287 - привязать вариацию к товару с ID 30287; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки); - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:product_id} - использовать ID товара из результата поиска; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID товара существует в каталоге. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается текстовое наименование создаваемой вариации товара. Это обязательный параметр. Примеры использования: - Тест вариации - простое наименование; - {=Document:TITLE} - размер {=Variable:SIZE} - использовать наименование из документа и переменной; - Вариация товара #{=Document:PRODUCT_ID} - {=Variable:COLOR} - комбинированное наименование; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
Активность	В данном поле указывается, будет ли вариация товара активна. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация будет активна и доступна для использования; - Нет (N) - вариация будет неактивна. Примеры использования: - Да - создать активную вариацию; - Нет - создать неактивную вариацию для последующей активации.
Доступность к покупке	В данном поле указывается, доступна ли вариация товара для покупки. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация доступна для покупки; - Нет (N) - вариация недоступна для покупки. Примеры использования: - Да - создать вариацию, доступную для покупки; - Нет - создать вариацию, которая временно недоступна для покупки.
Уникальные штрихкоды для каждого экземпляра	В данном поле указывается, используются ли уникальные штрихкоды для каждого экземпляра товара. Это необязательный параметр. Варианты выбора: - Да (Y) - используются уникальные штрихкоды; - Нет (N) - не используются уникальные штрихкоды. Примеры использования: - Да - для товаров, где каждый экземпляр имеет свой уникальный штрихкод; - Нет - для товаров, где все экземпляры имеют одинаковый штрихкод.
Наличие набора	В данном поле указывается, является ли вариация товара набором. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация является набором; - Нет (N) - вариация не является набором. Примеры использования: - Да - для вариаций, которые представляют собой набор товаров; - Нет - для обычных вариаций товара.
Разрешение покупки при отсутствии товара	В данном поле указывается, разрешена ли покупка вариации товара при отсутствии товара на складе. Это необязательный параметр. Варианты выбора: - Да (Y) - покупка разрешена даже при отсутствии товара; - Нет (N) - покупка запрещена при отсутствии товара. Примеры использования: - Да - для товаров, которые можно заказать под заказ; - Нет - для товаров, которые можно купить только при наличии на складе.
Символьный код	В данном поле указывается символьный код вариации товара. Это необязательный параметр. Примеры использования: - Символьный код - простой код; - {=Variable:PRODUCT_CODE} - использовать код из переменной; - ={{={=Document:PRODUCT_CODE} & "_" & {=Variable:VARIANT_CODE}}}} - объединение кодов.
Детальное описание	В данном поле указывается детальное описание вариации товара. Это необязательный параметр. Примеры использования: - Детальное описание - простое описание; - {=Variable:DESCRIPTION} - использовать описание из переменной; - Описание вариации товара с характеристиками: размер {=Variable:SIZE}, цвет {=Variable:COLOR} - комбинированное описание.
Тип детального описания	В данном поле указывается тип детального описания вариации товара. Это необязательный параметр. Варианты выбора: - Текст (text) - обычный текст; - HTML (html) - HTML-разметка. Примеры использования: - Текст - для простого текстового описания; - HTML - для описания с HTML-разметкой.
Валюта закупочной цены	В данном поле указывается валюта закупочной цены вариации товара. Это необязательный параметр. Варианты выбора: - Рубль (RUB); - Доллар США (USD); - Евро (EUR). Примеры использования: - RUB - для товаров с ценой в рублях; - USD - для товаров с ценой в долларах; - EUR - для товаров с ценой в евро.
Доступное количество	В данном поле указывается доступное количество вариации товара на складе. Это необязательный параметр. Примеры использования: - 1 - указать количество 1; - {=Variable:QUANTITY} - использовать количество из переменной; - ={{=intval({=Document:QUANTITY})}} - преобразовать количество из документа в целое число.
Режим количественного учета	В данном поле указывается режим количественного учета вариации товара. Это необязательный параметр. Варианты выбора: - Включен (Y) - количественный учет включен; - Выключен (N) - количественный учет выключен; - По умолчанию (D) - использовать настройки по умолчанию. Примеры использования: - Включен - для товаров, где требуется точный учет количества; - Выключен - для товаров, где количественный учет не требуется; - По умолчанию - использовать настройки товара.
Единица времени периода оплаты	В данном поле указывается единица времени периода оплаты для вариации товара. Это необязательный параметр. Варианты выбора: - Час (H); - День (D); - Неделя (W); - Месяц (M); - Квартал (Q); - Полугодие (S); - Год (Y). Примеры использования: - Месяц - для подписок с ежемесячной оплатой; - Год - для подписок с годовой оплатой.
НДС включен в цену	В данном поле указывается, включен ли НДС в цену вариации товара. Это необязательный параметр. Варианты выбора: - Да (Y) - НДС включен в цену; - Нет (N) - НДС не включен в цену. Примеры использования: - Да - для товаров, где НДС уже включен в цену; - Нет - для товаров, где НДС добавляется к цене.

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

Описание примера	Решение
Создание вариации товара при добавлении нового товара в каталог	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара {=Variable:PRODUCT_NAME}", Активность - Да, Доступность к покупке - Да, Разрешение покупки при отсутствии товара - Нет, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание вариации товара с указанием размера и цвета	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Товар {=Document:TITLE} - Размер {=Variable:SIZE}, Цвет {=Variable:COLOR}", Активность - Да, Доступность к покупке - Да, Символьный код - ={{={=Variable:PRODUCT_CODE} & "_" & {=Variable:SIZE} & "_" & {=Variable:COLOR}}}}, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание вариации товара для товара с подпиской	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Подписка на {=Variable:SERVICE_NAME}", Активность - Да, Доступность к покупке - Да, Разрешение подписки на товар - Да, Единица времени периода оплаты - Месяц, Длина периода оплаты - 1, НДС включен в цену - Да.
Создание вариации товара с указанием закупочной цены в валюте	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Вариация товара {=Document:TITLE}", Активность - Да, Доступность к покупке - Да, Валюта закупочной цены - USD, Закупочная цена - {=Variable:PURCHASE_PRICE}, НДС включен в цену - Нет.
Создание вариации товара с количественным учетом	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара с учетом количества", Активность - Да, Доступность к покупке - Да, Режим количественного учета - Включен, Доступное количество - {=Variable:QUANTITY}, Зарезервированное количество - {=Variable:RESERVED_QUANTITY}, НДС включен в цену - Да.
Создание вариации товара для товара под заказ	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Вариация товара {=Document:TITLE} под заказ", Активность - Да, Доступность к покупке - Да, Разрешение покупки при отсутствии товара - Да, Доступное количество - 0, НДС включен в цену - Да.
Создание вариации товара с детальным описанием в HTML	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара с HTML описанием", Активность - Да, Доступность к покупке - Да, Детальное описание - {=Variable:HTML_DESCRIPTION}, Тип детального описания - HTML, НДС включен в цену - Да.
Создание вариации товара для набора товаров	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Набор товаров {=Document:TITLE}", Активность - Да, Доступность к покупке - Да, Наличие набора - Да, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание вариации товара с уникальными штрихкодами	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара с уникальными штрихкодами", Активность - Да, Доступность к покупке - Да, Уникальные штрихкоды для каждого экземпляра - Да, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Массовое создание вариаций товара через итератор	Параметры: ID товара - {=Iterator:Value}, Наименование - "Вариация товара #{=Iterator:Value}", Активность - Да, Доступность к покупке - Да, Доступное количество - 1, НДС включен в цену - Да.

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

Примеры использования возвращаемого параметра:
- Передать ID в следующее активити (робот) для получения данных вариации;
- Использовать в условиях для проверки успешности создания вариации;
- Сохранить в переменную для использования в других шагах процесса;
- Создать связь между вариацией и другими сущностями CRM;
- Использовать ID для обновления данных вариации товара.

Важно о возвращаемых параметрах: Если создание вариации товара завершилось с ошибкой, параметр id_offer_product будет равен 0. Всегда проверяйте значение возвращаемого параметра перед использованием в дальнейших шагах бизнес-процесса.

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

Обязательные параметры:
Для успешного создания вариации товара обязательно должны быть заполнены следующие параметры:
- ID товара (parentId);
- Наименование (name).

Проверка существования товара:
Активити (робот) проверяет существование указанного товара перед созданием вариации. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.

Обработка boolean полей:
Поля типа boolean (Активность, Доступность к покупке, НДС включен в цену и др.) принимают значения "Y" (Да) или "N" (Нет) и автоматически преобразуются в соответствующий формат при отправке в API.

Порядок параметров:
Параметры ID товара и Наименование всегда отображаются первыми в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на создание вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству создаваемых вариаций:
При массовом создании вариаций через итератор рекомендуется не создавать более 100 вариаций за один запуск бизнес-процесса. Для массового создания используйте модуль "Массовый запуск Бизнес-процессов".

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

Добавить вариацию товара