Удалить подразделение

Активити (робот) «Удалить подразделение» предназначено для использования в роботах и может быть полезно в следующих сценариях: ликвидация временного отдела после закрытия проекта, очистка тестовых записей оргструктуры, автоматическое удаление дубля после слияния команд при условии, что сотрудники и дочерние отделы уже перенесены вручную или другими шагами процесса.

Удаление необратимо на стороне портала: перед вызовом убедитесь, что у подразделения нет дочерних отделов и привязанных сотрудников, иначе API вернёт ошибку.
Требуются права на изменение структуры компании.

Как работает активити (робот):
- Вы передаёте числовой ID удаляемого подразделения;
- Выполняется запрос удаления;
- Возвращается признак успеха и служебное сообщение.

Сценарий работы активити бизнес-процесса

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

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

Название поля	Описание и примеры использования
ID подразделения	Числовой идентификатор удаляемого отдела. Пример: 22

При неснятых зависимостях портал отклонит запрос.
Удаление корневого или единственного раздела может быть запрещено политикой Битрикс24.

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

Описание примера	Решение
Удаление после успешного переноса людей	ID подразделения = {=Variable:OLD_DEPT_ID}. Перед шагом убедитесь, что список сотрудников пуст в карточке отдела.
Удаление тестового отдела по флагу	Условие: Variable:REMOVE_TEST = Y, затем ID = {=Variable:TEST_DEPT_ID}.
Отложенное удаление по таймеру	Через день после завершения проекта робот удаляет отдел с ID из поля документа.
Связка со списком	ID возьмите из результата робота «Поиск подразделений» при уникальном фильтре по названию (первый элемент массива ID).
Уведомление при ошибке	Если значение параметра "Успешное удаление" = N, отправьте сообщение в чат с текстом параметра "Сообщение об ошибке".
Запрет удаления без согласования	Оборачивайте шаг условием «согласовано» из предыдущего шага задания с руководителем.
Очистка после слияния	После переноса подчинённых в целевой отдел удалите пустой исходный ID.
Проверка перед удалением	Сначала робот списка с фильтром по родителю: если "Количество найденных элементов"= 0 для дочерних, разрешите удаление.
Логирование	Запишите в журнал сделки ID удалённого отдела и {=User:ID} инициатора.
Повтор при временной ошибке	При сетевой ошибке в логе настройте повтор шага через ожидание и повторный запуск вложенного процесса.

Возвращаемые параметры данного активити:
- Успешное удаление — Y при успешном удалении, N при ошибке;
- Сообщение об ошибке — служебная строка с результатом или описанием ошибки API.

Важно о возвращаемых параметрах: при N не считайте отдел удалённым; проверьте состояние в интерфейсе портала.

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

Удалить подразделение