Изменение компании

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

Автоматическое обновление данных компании на основе информации из других систем;
Изменение ответственного за компанию по определённым условиям;
Обновление контактной информации (телефоны, email, адрес);
Изменение типа компании или сферы деятельности;
Обновление реквизитов и финансовой информации;
Синхронизация данных компании с внешними системами (1С, ERP);
Обновление UTM-меток и рекламных данных.

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

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

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

Название поля	Описание и примеры использования
ID компании	Обязательный параметр. ID компании, данные о которой необходимо изменить. Если поле имеет привязку к элементам инфоблоков (привязка к спискам), для изменения значения нужно указывать ID элемента. Примеры: - `{=Document:ID}` - ID текущей компании; - `123` - конкретный ID компании; - `{=Variable:COMPANY_ID}` - ID из переменной.
Очистить почты и(или) телефоны	Удаление почт или телефонов в компании. Варианты: почта, телефон, почта и телефон, не очищать.
Название компании	Новое название компании.
Тип компании	Тип к которому принадлежит компания. Значения берутся из справочника CRM.
Фактический адрес	Фактический адрес расположения компании.
Адрес (стр. 2)	Квартира/офис компании.
Город	Город, в котором находится компания.
Почтовый индекс	Почтовый индекс компании.
Район	Район, в котором находится компания.
Область	Область, в которой находится компания.
Страна	Страна, в которой находится компания.
Код страны	Код страны, в которой находится компания.
Юридический адрес	Юридический адрес компании (адрес регистрации, например в налоговой).
Банковские реквизиты	Банковские реквизиты компании.
Сфера деятельности	Сфера деятельности компании. Выбирается из выпадающего списка.
Валюта	Валюта для расчётов с данной компанией.
Годовой оборот	Годовой оборот компании.
Комментарии	Комментарии к компании.
Ответственный	ID ответственного за компанию. Формат: `user_ID` (например, `user_1`).
Контакт	ID контакта, связанного с компанией.
UTM-метки	Рекламная система, тип трафика, обозначение рекламной кампании, содержание кампании, условие поиска.
Телефон	Телефон компании. Активити добавляет, не удаляет существующие.
E-MAIL	Email компании. Активити добавляет, не удаляет существующие.
Сайт	Сайт компании. Активити добавляет, не удаляет существующие.

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

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

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

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

№	Сценарий	ID Компании	Изменяемое поле	Значение
1	Изменить ответственного	`{=Document:ID}`	Ответственный	`user_25`
2	Обновить название	`{=Variable:COMPANY_ID}`	Название компании	`ООО "Новое название"`
3	Изменить тип компании	`{=Document:ID}`	Тип компании	`CLIENT`
4	Добавить телефон	`{=Document:ID}`	Телефон	`+79001234567`
5	Обновить адрес	`{=Variable:COMPANY_ID}`	Фактический адрес	`ул. Ленина, д. 1`
6	Изменить сферу деятельности	`{=Document:ID}`	Сфера деятельности	`IT`
7	Очистить телефоны	`{=Document:ID}`	Очистить	Телефон
8	Добавить комментарий	`{=Document:ID}`	Комментарии	`Обновлено: {=System:Date}`
9	Изменить валюту	`{=Document:ID}`	Валюта	`RUB`
10	Добавить email	`{=Document:ID}`	E-MAIL	`{=Variable:EMAIL}`

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

ID компании (company_id) - числовой идентификатор изменённой компании;
Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

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

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

Изменение компании