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