Выбрать курс
- Приложение для Битрикс24 "Лаборатория роботов"
- Приложение для Битрикс24 "Сквозная аналитика 2.0"
- Приложение для Битрикс24 "Уничтожитель дубликатов"
- Приложение для Битрикс24 "Межпортальные задачи"
- Приложение для Битрикс24 "Немой чат-бот"
- Приложение для Битрикс24 "Доходы и расходы CRM"
- Приложение для Битрикс24 "Продуктивный Jivosite"
263
/
307
Удаление вариации товара
Активити (робот) "Удаление вариации товара" предназначено для использования в роботах и может быть полезно в следующих сценариях:
- Удаление вариаций товара по их ID;
- Удаление неактивных или устаревших вариаций товара;
- Удаление вариаций товара с нулевым количеством на складе;
- Массовое удаление вариаций товара, соответствующих определённым критериям;
- Очистка старых или неактуальных вариаций товара;
- Удаление вариаций товара после выполнения определённых условий в бизнес-процессе;
- Автоматическое удаление вариаций товара при изменении статуса сделки или товара;
- Удаление вариаций товара при интеграции с внешними системами;
- Очистка вариаций товара для оптимизации работы с каталогом;
- Удаление тестовых вариаций товара после завершения разработки.
Как работает активити (робот):
- Активити (робот) удаляет вариацию товара по указанному ID через REST API Битрикс24;
- Поддерживается удаление только одной вариации за один запуск активити (робота);
- Активити (робот) возвращает результат удаления (успешно или нет) для дальнейшего использования в бизнес-процессе;
- Активити (робот) работает через REST API Битрикс24 (catalog.product.offer.delete);
- Для массового удаления вариаций используйте итератор с активити (роботом) "Поиск вариаций товара".
- Активити (робот) удаляет вариацию товара по указанному ID через REST API Битрикс24;
- Поддерживается удаление только одной вариации за один запуск активити (робота);
- Активити (робот) возвращает результат удаления (успешно или нет) для дальнейшего использования в бизнес-процессе;
- Активити (робот) работает через REST API Битрикс24 (catalog.product.offer.delete);
- Для массового удаления вариаций используйте итератор с активити (роботом) "Поиск вариаций товара".
Описание параметров активити (робота)
| Название поля | Описание и примеры использования |
|---|---|
| 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 | Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) удалит вариацию с указанным ID и вернёт результат удаления в параметре good_delete (true - успешно, false - ошибка). |
| Удаление вариации после её создания (откат) | Параметры: ID вариации товара - {=A1988_22222_92566_99999:id_offer_product}. Активити (робот) удалит только что созданную вариацию товара, если она была создана с ошибкой или не соответствует требованиям. |
| Удаление первой найденной вариации | Параметры: ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) удалит первую вариацию из результата поиска вариаций товара. |
| Удаление неактивной вариации товара | Сначала используйте активити (робот) "Поиск вариаций товара" с параметром Активность - N для поиска неактивных вариаций, затем используйте активити (робот) "Удаление вариации товара" с параметром ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}. |
| Удаление вариации с нулевым количеством | Сначала используйте активити (робот) "Поиск вариаций товара" с параметром Доступное количество - 0 для поиска вариаций с нулевым количеством, затем используйте активити (робот) "Удаление вариации товара" с параметром ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}. |
| Массовое удаление вариаций через итератор | Сначала используйте активити (робот) "Поиск вариаций товара" для получения списка ID вариаций в параметре search_results_array, затем используйте итератор с активити (роботом) "Удаление вариации товара" с параметром ID вариации товара - {=Iterator:Value}. |
| Удаление вариации при изменении статуса сделки | В условии бизнес-процесса проверьте статус сделки, и если статус соответствует определённому значению, используйте активити (робот) "Удаление вариации товара" с параметром ID вариации товара - {=Document:OFFER_ID}. |
| Удаление тестовых вариаций товара | Сначала используйте активити (робот) "Поиск вариаций товара" с параметром Наименование - "Тест" для поиска тестовых вариаций, затем используйте итератор с активити (роботом) "Удаление вариации товара" для удаления всех найденных тестовых вариаций. |
| Удаление вариации с проверкой результата | Параметры: ID вариации товара - {=Variable:OFFER_ID}. После выполнения активити (робота) проверьте возвращаемый параметр good_delete в условии бизнес-процесса. Если good_delete = true, вариация успешно удалена. Если good_delete = false, произошла ошибка при удалении. |
| Удаление вариации товара при интеграции с внешними системами | Параметры: ID вариации товара - {=Variable:EXTERNAL_OFFER_ID}. Активити (робот) удалит вариацию товара при синхронизации данных с внешней системой, если вариация была удалена во внешней системе. |
Возвращаемые параметры данного активити (робота):
- Успешное удаление (good_delete) - логическое значение (true/false), указывающее, было ли удаление успешным.
Значения параметра good_delete:
- true - вариация товара успешно удалена;
- false - произошла ошибка при удалении вариации товара (вариация не существует, нет прав доступа и т.д.).
Примеры использования возвращаемого параметра:
- Использовать good_delete в условиях бизнес-процесса для проверки успешности удаления;
- Использовать good_delete для отправки уведомлений о результате удаления;
- Использовать good_delete для логирования результатов операции;
- Использовать good_delete для выполнения дополнительных действий при успешном удалении;
- Использовать good_delete для обработки ошибок при неудачном удалении.
- Успешное удаление (good_delete) - логическое значение (true/false), указывающее, было ли удаление успешным.
Значения параметра good_delete:
- true - вариация товара успешно удалена;
- false - произошла ошибка при удалении вариации товара (вариация не существует, нет прав доступа и т.д.).
Примеры использования возвращаемого параметра:
- Использовать good_delete в условиях бизнес-процесса для проверки успешности удаления;
- Использовать good_delete для отправки уведомлений о результате удаления;
- Использовать good_delete для логирования результатов операции;
- Использовать good_delete для выполнения дополнительных действий при успешном удалении;
- Использовать good_delete для обработки ошибок при неудачном удалении.
Важно о возвращаемых параметрах: Если удаление завершилось с ошибкой, параметр good_delete будет равен false. Всегда проверяйте значение возвращаемого параметра перед выполнением дальнейших действий в бизнес-процессе. Удаление вариации товара является необратимой операцией.
Важно! Ограничения и рекомендации:
Обязательные параметры:
Для успешного удаления вариации товара обязательно должен быть заполнен следующий параметр:
- ID вариации товара (id_offer).
Проверка существования вариации:
Активити (робот) проверяет существование указанной вариации перед удалением. Если вариация с указанным ID не существует, активити (робот) вернёт good_delete = false.
Необратимость операции:
Удаление вариации товара является необратимой операцией. После удаления вариацию нельзя восстановить. Всегда проверяйте необходимость удаления перед выполнением операции.
Массовое удаление:
Для массового удаления вариаций используйте комбинацию активити (робота) "Поиск вариаций товара" и итератора с активити (роботом) "Удаление вариации товара".
Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на удаление вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.
Ограничение по количеству удаляемых вариаций:
При массовом удалении вариаций через итератор рекомендуется не удалять более 100 вариаций за один запуск бизнес-процесса. Для массового удаления используйте модуль "Массовый запуск Бизнес-процессов".
Проверка связанных данных:
Перед удалением вариации товара убедитесь, что она не используется в активных сделках, предложениях или заказах. Удаление вариации, используемой в активных документах, может привести к ошибкам в работе системы.
Обязательные параметры:
Для успешного удаления вариации товара обязательно должен быть заполнен следующий параметр:
- ID вариации товара (id_offer).
Проверка существования вариации:
Активити (робот) проверяет существование указанной вариации перед удалением. Если вариация с указанным ID не существует, активити (робот) вернёт good_delete = false.
Необратимость операции:
Удаление вариации товара является необратимой операцией. После удаления вариацию нельзя восстановить. Всегда проверяйте необходимость удаления перед выполнением операции.
Массовое удаление:
Для массового удаления вариаций используйте комбинацию активити (робота) "Поиск вариаций товара" и итератора с активити (роботом) "Удаление вариации товара".
Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на удаление вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.
Ограничение по количеству удаляемых вариаций:
При массовом удалении вариаций через итератор рекомендуется не удалять более 100 вариаций за один запуск бизнес-процесса. Для массового удаления используйте модуль "Массовый запуск Бизнес-процессов".
Проверка связанных данных:
Перед удалением вариации товара убедитесь, что она не используется в активных сделках, предложениях или заказах. Удаление вариации, используемой в активных документах, может привести к ошибкам в работе системы.