Получить данные по вариации товара

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

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

Как работает активити (робот):
- Активити (робот) получает все данные вариации товара по указанному ID через REST API Битрикс24;
- Возвращаются все доступные поля вариации (ID, наименование, код, размеры, вес, цены, количество, статусы и т.д.);
- Поддерживается получение информации о количестве товара на складе и резервировании;
- Возвращаются данные о статусе активности, доступности для покупки и других параметрах;
- Все поля вариации возвращаются в возвращаемых параметрах активити (робота);
- Активити (робот) работает через REST API Битрикс24 (catalog.product.offer.get);
- Поддерживается обработка множественных ID вариаций (массивы для итератора).

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

Название поля	Описание и примеры использования
ID вариации товара	В данном поле указывается идентификатор вариации товара, данные которой нужно получить. Это обязательный параметр. Если указан массив ID, будет обработан только первый элемент массива. Примеры использования: - {=Variable:OFFER_ID} - получить данные вариации с ID из переменной предыдущего активити (робота); - 123 - получить данные вариации с ID 123; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска вариаций; - {=A1988_22222_92566_99999:id_offer_product} - использовать ID вариации из результата активити (робота) "Добавить вариацию товара"; - {=Document:OFFER_ID} - получить данные вариации, если ID вариации указан в документе; - {=Iterator:Value} - получить данные вариации для каждого ID из итератора. Как получить ID вариации: - Из результата активити (робота) "Добавить вариацию товара" (параметр id_offer_product); - Из результата активити (робота) "Поиск вариаций товара" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если вариация связана с документом. Важно: Если вариация с указанным ID не существует, активити (робот) завершится с ошибкой "Результатов не найдено". Всегда проверяйте существование вариации перед получением данных.

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

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

ID вариации товара

В данном поле указывается идентификатор вариации товара, данные которой нужно получить. Это обязательный параметр. Если указан массив ID, будет обработан только первый элемент массива.

Примеры использования:
- {=Variable:OFFER_ID} - получить данные вариации с ID из переменной предыдущего активити (робота);
- 123 - получить данные вариации с ID 123;
- {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска вариаций;
- {=A1988_22222_92566_99999:id_offer_product} - использовать ID вариации из результата активити (робота) "Добавить вариацию товара";
- {=Document:OFFER_ID} - получить данные вариации, если ID вариации указан в документе;
- {=Iterator:Value} - получить данные вариации для каждого ID из итератора.

Как получить ID вариации:
- Из результата активити (робота) "Добавить вариацию товара" (параметр id_offer_product);
- Из результата активити (робота) "Поиск вариаций товара" (параметр search_results_array или search_result_first_string);
- Из переменной, созданной в предыдущих шагах бизнес-процесса;
- Из поля документа, если вариация связана с документом.

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

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

Описание примера	Решение
Получение всех данных вариации товара по ID	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт все доступные поля вариации: ID, наименование, код, размеры, вес, цены, количество, статусы и другие поля. Все данные будут доступны в возвращаемых параметрах активити (робота).
Получение данных вариации после её создания	Параметры: ID вариации товара - {=A1988_22222_92566_99999:id_offer_product}. Активити (робот) вернёт все данные только что созданной вариации товара для проверки корректности создания.
Получение данных первой найденной вариации	Параметры: ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) вернёт все данные первой вариации из результата поиска.
Проверка количества товара на складе	Параметры: ID вариации товара - {=Document:OFFER_ID}. Активити (робот) вернёт данные вариации, включая доступное количество в возвращаемом параметре quantity, которое можно использовать в условиях бизнес-процесса.
Проверка статуса активности вариации	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт данные вариации, включая статус активности в возвращаемом параметре active, который можно использовать в условиях для проверки активности вариации.
Получение цены и валюты вариации	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт данные вариации, включая закупочную цену в возвращаемом параметре purchasingPrice и валюту в возвращаемом параметре purchasingCurrency.
Получение данных вариации для обновления	Параметры: ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) вернёт все данные вариации, которые можно использовать в активити (роботе) "Обновить вариацию товара" для частичного обновления полей.
Массовое получение данных вариаций через итератор	Параметры: ID вариации товара - {=Iterator:Value}. Активити (робот) вернёт данные вариации для каждого ID из итератора. Все данные будут доступны в возвращаемых параметрах для каждого элемента итератора.
Получение наименования и описания вариации	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт наименование вариации в возвращаемом параметре name и описание в возвращаемом параметре detailText, которые можно использовать для формирования отчётов или уведомлений.
Проверка доступности вариации для покупки	Параметры: ID вариации товара - {=Document:OFFER_ID}. Активити (робот) вернёт данные вариации, включая статус доступности в возвращаемом параметре available, который можно использовать в условиях для проверки возможности покупки.

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

Основные возвращаемые параметры (примеры):
- Наименование (name) - текстовое наименование вариации товара;
- Символьный код (code) - символьный код вариации товара;
- Активность (active) - статус активности вариации (Y/N);
- Доступность к покупке (available) - статус доступности для покупки (Y/N);
- Доступное количество (quantity) - количество товара на складе;
- Закупочная цена (purchasingPrice) - закупочная цена вариации;
- Валюта закупочной цены (purchasingCurrency) - валюта закупочной цены;
- НДС включен в цену (vatIncluded) - статус включения НДС в цену (Y/N);
- Детальное описание (detailText) - детальное описание вариации;
- И другие поля вариации товара в зависимости от настроек каталога.

Примеры использования возвращаемых параметров:
- Использовать параметр name для формирования названия в уведомлениях;
- Использовать параметр quantity для проверки наличия товара на складе;
- Использовать параметр active для проверки активности вариации в условиях;
- Использовать параметр purchasingPrice для расчётов в бизнес-процессе;
- Использовать все параметры для передачи в активити (робот) "Обновить вариацию товара";
- Использовать параметры для формирования отчётов и аналитики.

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

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

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

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

Обработка множественных ID:
Если в параметре указан массив ID вариаций, будет обработан только первый элемент массива. Для обработки множественных ID используйте итератор.

Список возвращаемых параметров:
Список возвращаемых параметров формируется автоматически на основе настроек каталога вашего портала и может отличаться в зависимости от конфигурации системы.

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

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

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

Получить данные по вариации товара