Получение данных по сущности: Компания

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

Получение всех данных компании по её ID для использования в бизнес-процессе;
Извлечение информации о компании для формирования документов или отчётов;
Получение данных компании для передачи во внешние системы;
Автоматическая проверка и валидация данных компании;
Формирование персонализированных коммерческих предложений;
Синхронизация данных компании между сущностями CRM;
Подготовка данных для массовых рассылок и уведомлений.

Как работает активити (робот):
- Активити (робот) получает все возможные данные из полей Компании (включая пользовательские);
- Данные можно использовать в рамках бизнес-процесса для дальнейшей обработки;
- Поддерживается вывод данных в удобном для печати виде;
- Активити (робот) работает через REST API Битрикс24 (crm.company.get).

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

Название поля	Описание и примеры использования
ID сущности	Обязательный параметр. В данном поле указывается ID компании, данные которой требуется получить. Примеры: - `{=Document:ID}` - ID текущей компании из документа; - `123` - конкретный ID компании; - `{=Variable:COMPANY_ID}` - ID компании из переменной; - `{=Document:COMPANY_ID}` - ID компании из связанной сущности (сделки, контакта); - `{=A1988_22222_92566_99999:search_results}` - ID из результата поиска.
Для печати	Варианты: да/нет. Данное поле позволяет включить вывод данных в удобном для печати текстовом виде.
Сообщение об ошибке	Варианты: да/нет. Позволяет выводить ошибки в журнал БП.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

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

№	Сценарий	ID сущности	Для печати
1	Получить данные текущей компании	`{=Document:ID}`	Нет
2	Получить данные компании из сделки	`{=Document:COMPANY_ID}`	Нет
3	Получить данные для документа	`{=Variable:COMPANY_ID}`	Да
4	Получить данные из результата поиска	`{=A1988_22222_92566_99999:search_results}`	Нет
5	Получить данные в итераторе	`{=Iterator:Value}`	Нет
6	Получить данные конкретной компании	`12345`	Нет
7	Формирование коммерческого предложения	`{=Document:COMPANY_ID}`	Да
8	Проверка реквизитов	`{=Variable:COMPANY_ID}`	Нет
9	Синхронизация с 1С	`{=Variable:COMPANY_ID}`	Нет
10	Получить данные из контакта	`{=Document:COMPANY_ID}`	Нет

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

Все параметры из сущности "Компания" - все стандартные и пользовательские поля компании, включая:
- ID компании;
- Название компании;
- Телефоны, Email, Сайты;
- Тип компании;
- Отрасль;
- Ответственный;
- Источник;
- Комментарии;
- Адресные поля;
- UTM-метки;
- Пользовательские поля (UF_*);
- и другие поля.
Сообщение об ошибке - текст ошибки при неуспешном выполнении.

Важно:
- Пользователь, от имени которого запускается активити, должен иметь права на просмотр указанной компании;
- Множественные поля (телефоны, email) возвращаются в виде массивов;
- Поля типа "Список" возвращают ID элемента списка, а не его название;
- Для получения реквизитов компании используйте отдельное активити "Получение данных реквизита".

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

Получение данных по сущности: Компания