Удаление реквизита

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

Удаление ошибочно созданного реквизита после проверки или отмены действия;
Очистка дубликатов реквизитов: удаление лишних записей, оставшихся после объединения контактов или компаний;
Удаление устаревшего реквизита при замене на новый (например, после смены юридического лица или реквизитов компании);
Массовое удаление реквизитов по списку ID из результата поиска или итератора;
Удаление тестовых реквизитов после переноса данных или отладки бизнес-процесса;
Очистка реквизитов контакта или компании при закрытии или отмене сделки по условию;
Синхронизация с внешней системой: удаление реквизитов, которых больше нет в 1С или учётной системе;
Удаление реквизита перед повторным созданием с актуальными данными (сначала удалить, затем добавить);
Очистка карточки при переводе контакта или компании в архив или неактивные;
Удаление реквизита по запросу пользователя или по результату условия в процессе.

Как работает активити (робот):
- Активити (робот) удаляет реквизит по указанному ID через метод REST API Битрикс24 crm.requisite.delete;
- Обязателен один параметр — ID реквизита (id_requisite). Реквизит с этим ID должен существовать в CRM;
- После успешного удаления реквизит исчезает из карточки контакта или компании; связанные банковские реквизиты (если есть) могут обрабатываться системой в соответствии с настройками CRM;
- Активити (робот) не возвращает отдельные возвращаемые параметры.

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

Название поля	Описание и примеры использования
ID реквизита	Обязательный параметр. Идентификатор реквизита, который нужно удалить. Примеры: - {=Variable:REQUISITE_ID} — ID из переменной предыдущего шага; - {=A1988_22222_92566_99999:id_requisite} — ID реквизита из возвращаемого параметра активити (робота) «Добавление реквизита» (например, для отката только что созданного реквизита); - {=A1988_22222_92566_99999:search_result_first_string} — первый ID из результата активити (робота) «Поиск реквизитов»; - {=Iterator:Value} — для массового удаления реквизитов в цикле по списку ID; - {=Document:ID} — если ID реквизита хранится в поле документа.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется выбирать сотрудника с правами администратора. При недостаточных правах удаление может завершиться с ошибкой.
Устанавливать текст статуса	Позволяет включать установку статуса бизнес-процесса для отображения в истории, на каком шаге остановился процесс. Удобно при отладке.
Текст статуса	Текстовый статус, отображаемый в истории бизнес-процесса при включённом параметре «Устанавливать текст статуса».
Ожидать ответа	Параметр не управляется пользователем; определяет, нужно ли ожидать ответа от активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Ограничение времени ожидания ответа (в секундах, минутах, часах, днях). Рекомендуется не менее 5 минут и не более 1 часа. При истечении времени бизнес-процесс продолжит выполнение по заданной логике.

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

Описание примера	Решение
Удалить ошибочно созданный реквизит в той же цепочке процесса	ID реквизита — {=A1988_22222_92566_99999:id_requisite} (код активити «Добавление реквизита»). Используйте после условия «если проверка не прошла» или «если отмена» для отката только что созданного реквизита.
Удалить реквизит по результату поиска	После активити (робота) «Поиск реквизитов» укажите ID реквизита — {=A1988_22222_92566_99999:search_result_first_string} (или другой элемент массива результатов). Подходит для удаления одного из найденных реквизитов.
Массовое удаление реквизитов по списку ID	В цикле по итератору: ID реквизита — {=Iterator:Value}. Передайте в итератор массив ID реквизитов (например, из результата «Поиск реквизитов» или из переменной). Каждый реквизит будет удалён за один проход.
Удалить устаревший реквизит перед добавлением нового	ID реквизита — {=Variable:OLD_REQUISITE_ID}. Выполните активити (робот) «Удаление реквизита», затем активити (робот) «Добавление реквизита» с новыми данными. Переменная OLD_REQUISITE_ID может быть получена из поиска или из предыдущего шага.
Удалить реквизит при отмене сделки по условию	В ветке «Отмена» после условия по статусу сделки: ID реквизита — {=Variable:REQUISITE_ID}, где REQUISITE_ID сохранён при создании реквизита для этой сделки. Так можно убрать реквизит, созданный под отменённую сделку.
Синхронизация с 1С: удалить реквизиты, отсутствующие во внешней системе	Получите список ID реквизитов, которые нужно удалить (например, сравнением с выгрузкой из 1С). В цикле по итератору передайте ID реквизита — {=Iterator:Value}. Каждый реквизит из списка будет удалён.
Удалить дубликат реквизита после объединения компаний	ID реквизита — {=Variable:DUPLICATE_REQUISITE_ID}. Переменная может быть заполнена на предыдущем шаге при сравнении реквизитов объединённых компаний. Удаляется лишний реквизит, оставшийся после слияния.
Удалить тестовый реквизит после отладки	ID реквизита — константа или переменная с ID тестового реквизита (например, {=Variable:TEST_REQUISITE_ID}). Запускайте вручную или по условию «режим отладки выключен».
Очистка реквизитов при переводе компании в архив	Перед или после изменения статуса компании получите ID реквизитов компании (поиск или получение данных). В цикле выполните удаление с ID реквизита — {=Iterator:Value} для каждого ID.
Удалить реквизит по ID из поля документа	ID реквизита — {=Document:REQUISITE_ID} (если в документе есть поле с ID реквизита). Подходит для процессов, где реквизит привязан к сделке или задаче через пользовательское поле.

Возвращаемые параметры данного активити (робота):

Активити (робот) выполняет удаление реквизита в CRM и не возвращает отдельные возвращаемые параметры. При успешном выполнении реквизит с указанным ID удаляется из карточки контакта или компании.

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

Обязательный параметр:
Для выполнения активити (робота) обязательно указать ID реквизита. Реквизит с указанным ID должен существовать в CRM. Если реквизит не найден или ID указан неверно, вызов crm.requisite.delete может завершиться ошибкой.

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

Связанные банковские реквизиты:
При удалении главного (родительского) реквизита поведение связанных банковских реквизитов зависит от настроек CRM. При необходимости сначала удалите банковские реквизиты активити (роботом) «Удаление банковского реквизита», затем удаляйте основной реквизит.

Права доступа:
Сотрудник, указанный в поле «Запускать от имени», должен иметь права на удаление реквизитов в CRM. Рекомендуется использовать сотрудника с правами администратора.

Источник ID реквизита:
ID реквизита можно получить из активити (робота) «Добавление реквизита» (id_requisite), «Поиск реквизитов», «Получение данных по сущности: реквизит», а также из переменных или полей документа, заполненных на предыдущих шагах.

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

Удаление реквизита