Создание товара торгового каталога

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

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

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

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

Название поля	Описание и примеры использования
Наименование	В данном поле указывается текстовое наименование создаваемого товара. Это обязательный параметр. Примеры использования: - Новый товар - простое наименование; - {=Document:TITLE} - использовать наименование из документа (сделки); - Товар {=Variable:PRODUCT_NAME} - размер {=Variable:SIZE} - использовать наименование из переменной; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
ID каталога	В данном поле указывается каталог, в который будет добавлен товар. Это обязательный параметр. Выбирается из выпадающего списка доступных каталогов. Примеры использования: - Выбрать каталог из списка - выбрать нужный каталог из выпадающего списка; - {=Variable:CATALOG_ID} - использовать ID каталога из переменной предыдущего активити (робота); - {=Document:CATALOG_ID} - использовать ID каталога из поля документа. Важно: Убедитесь, что выбранный каталог существует в системе. Если каталог с указанным ID не существует, активити (робот) завершится с ошибкой.
ID раздела каталога	В данном поле указывается числовой идентификатор (ID) раздела каталога, в который будет добавлен товар. Это необязательный параметр. Примеры использования: - 123 - добавить товар в раздел с ID 123; - {=Variable:SECTION_ID} - использовать ID раздела из переменной предыдущего активити (робота); - {=Document:SECTION_ID} - использовать ID раздела из поля документа; - {=A1988_22222_92566_99999:section_id} - использовать ID раздела из результата поиска. Важно: Если раздел не указан, товар будет добавлен в корневой раздел каталога. Убедитесь, что указанный раздел существует в выбранном каталоге.
Активность	В данном поле указывается, будет ли товар активен. Это необязательный параметр. Варианты выбора: - Да (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) - НДС не включен в цену. Примеры использования: - Да - для товаров, где НДС уже включен в цену; - Нет - для товаров, где НДС добавляется к цене.

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

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

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

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

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

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

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

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

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

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

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

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

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

Создание товара торгового каталога