Изменение Лида

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

Автоматическое обновление данных лида на основе информации из других систем;
Изменение статуса лида при прохождении этапов воронки;
Обновление контактной информации (телефоны, email);
Изменение ответственного за лид по определённым условиям;
Обновление суммы и валюты расчётов;
Работа с НДС и скидками на товары в лиде;
Синхронизация данных лида с внешними системами.

Как работает активити (робот):
- Активити (робот) изменяет указанные поля лида по его ID;
- Можно изменить одно или несколько полей одновременно;
- Поддерживается работа со всеми типами полей (строка, список, множественные и т.д.);
- Поддерживается работа с НДС и скидками на товары;
- Активити (робот) работает через REST API Битрикс24 (crm.lead.update).

Полезные советы:
- При выборе сотрудника в поле "привязка к пользователю" должен быть только его ID без лишних символов;
- Чтобы очистить поля типа "строка" - нужно передать пробел: ={ };
- Для очистки полей типа "список" - передайте кавычки: =" ".

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

Название поля	Описание и примеры использования
ID лида	Обязательный параметр. ID лида, который Вы будете редактировать. Если поле имеет привязку к элементам инфоблоков (привязка к спискам), для изменения значения нужно указывать ID элемента. Примеры: - `{=Document:ID}` - ID текущего лида; - `123` - конкретный ID лида; - `{=Variable:LEAD_ID}` - ID из переменной.
Очистить почты и(или) телефоны	Удаление почт или телефонов в лиде. Варианты: почта, телефон, почта и телефон, не очищать.
Ставка НДС	Ставка налога в лиде. Работает только если настроено поле "Способ начисления НДС".
Способ начисления НДС	Как будет начисляться НДС: сверху или уже включен в стоимость.
Тип скидки	Тип скидки. Варианты: сумма или процент.
Размер скидки	Размер предоставляемой скидки.
Название Лида	Новое название лида.
Обращение	Обращение к клиенту (мистер, товарищ, госпожа и т.д.).
Имя	Новое значение имени контакта в лиде.
Фамилия	Новое значение фамилии контакта в лиде.
Отчество	Новое значение отчества контакта в лиде.
Дата рождения	Новое значение даты рождения.
Название компании	Название компании в лиде.
Источник	Источник лида. Значения берутся из справочника CRM.
Дополнительно об источнике	Тип источника, из которого лид попал в CRM.
Статус	Код статуса лида. Можно получить из специальной таблицы статусов.
Должность	Должность контакта в лиде.
Адресные поля	Адрес, город, почтовый индекс, район, область, страна (устаревшие поля, сейчас используются реквизиты).
Валюта расчетов	Валюта расчётов лида. Значения берутся из справочника CRM.
Сумма	Предполагаемая сумма по лиду. Данное поле заполняется автоматически из товарного раздела. Не меняйте его, если в лиде заполнены товары с ценами.
Комментарий	Комментарий к лиду.
Ответственный	ID ответственного. Формат: `user_ID` (например, `user_1`).
Компания	ID компании, привязанной к лиду.
Контакт	ID контакта, привязанного к лиду.
Телефон	Телефоны. Активити добавляет, не удаляет существующие.
EMAIL	Адреса email. Активити добавляет, не удаляет существующие.
Сайт	Сайты. Активити добавляет, не удаляет существующие.
Мессенджер	Адреса интернет-мессенджеров. Активити добавляет, не удаляет существующие.

ВАЖНО!
- Запускать изменение сразу более 1000 сущностей не стоит. Это может привести к проблемам с обработкой на стороне Б24;
- Если планируете изменение более 1000 сущностей, встройте в БП счётчик и после 1000 изменений делайте паузу на 15 минут.

Перенос полей типа "Список" между сущностями:
ID элементов в поле типа "Список" в каждом типе сущности свои. Для переноса нужно сопоставлять элементы в переменной.

Формат сопоставления:
[6891] 10671
[6893] 10673
Где значение в квадратных скобках - ID элемента в сущности-получателе, за скобками - в сущности-источнике.

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

№	Сценарий	ID Лида	Изменяемое поле	Значение
1	Изменить статус	`{=Document:ID}`	Статус	`IN_PROCESS`
2	Изменить ответственного	`{=Variable:LEAD_ID}`	Ответственный	`user_25`
3	Обновить название	`{=Document:ID}`	Название Лида	`Новый лид от {=System:Date}`
4	Добавить телефон	`{=Document:ID}`	Телефон	`+79001234567`
5	Изменить источник	`{=Document:ID}`	Источник	`WEB`
6	Обновить сумму	`{=Document:ID}`	Сумма	`{=Variable:AMOUNT}`
7	Очистить телефоны	`{=Document:ID}`	Очистить	Телефон
8	Добавить комментарий	`{=Document:ID}`	Комментарий	`Обработано: {=System:Date}`
9	Изменить валюту	`{=Document:ID}`	Валюта расчетов	`RUB`
10	Установить скидку	`{=Document:ID}`	Размер скидки	`10`

Возвращаемые параметры для данного активити:

Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Важно:
- Поля типа "Список" требуют передачи ID элемента, а не названия;
- Активити только добавляет телефоны и email, не удаляет существующие;
- Не запускайте изменение более 1000 сущностей одновременно;
- Изменение суммы вручную может конфликтовать с автоматическим расчётом из товаров.

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

Изменение Лида