Получение данных по коммерческому предложению

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

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

Как работает активити (робот):
- По указанному ID загружаются данные коммерческого предложения из CRM;
- Для поля статуса дополнительно возвращается название статуса (nm_stageId);
- Все поля записи доступны как отдельные возвращаемые параметры бизнес-процесса;
- При отсутствии записи возвращается return_execution_result = N.

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

Название поля	Описание и примеры использования
ID коммерческого предложения	Числовой идентификатор коммерческого предложения, данные которого нужно получить. Примеры: - {=Document:ID} — если процесс на коммерческом предложении; - {=Variable:QUOTE_ID}; - {=A1988_22222_92566_99999:search_result_first_string}.

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

Описание примера	Решение
Получить данные текущего КП	Параметры: ID — {=Document:ID}. Используйте title, opportunity, stageId в следующих шагах.
Получить данные КП из переменной	Параметры: ID — {=Variable:QUOTE_ID}. Результат: return_execution_result — Y или N.
Проверить статус перед обновлением	Получите данные, проверьте stageId или nm_stageId, затем вызовите робот изменения.
Сформировать письмо с данными КП	Параметры: ID — {=Variable:QUOTE_ID}. В текст письма подставьте title, opportunity, nm_stageId.
Получить данные первого КП из поиска	Параметры: ID — {=Variable:FIRST_QUOTE_ID} из search_result_first_string.
Сверить сумму КП со сделкой	Получите opportunity и currencyId КП, сравните с {=Document:OPPORTUNITY} в условии БП.
Получить привязку к сделке	Параметры: ID — {=Variable:QUOTE_ID}. Используйте возвращаемый parentId2.
Получить данные в цикле по списку ID	Итератор по search_results_array, в цикле: ID — {=Iterator:Value}.
Проверить существование КП	Параметры: ID — {=Variable:QUOTE_ID}. Если return_execution_result = N, запись не найдена.
Получить данные после создания КП	Параметры: ID — {=A1988_22222_92566_99999:i_quote_id} из робота «Создать коммерческое предложение».

Возвращаемые параметры данного активити (робота):
- Результат выполнения (return_execution_result) — Y или N;
- Название (title), Ответственный (assignedById), Доступно для всех (opened);
- Дата начала (begindate), Дата завершения (closedate);
- ID компании (companyId), ID контакта (contactId), ID связанной сделки (parentId2);
- Статус (stageId) и Название статуса (nm_stageId);
- Сумма (opportunity), НДС (taxValue), Валюта (currencyId);
- Реквизиты Вашей компании (mycompanyId), Источник (sourceId), Дополнительно об источнике (sourceDescription).

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

Проверка результата:
Всегда проверяйте return_execution_result перед использованием возвращаемых полей. При значении N запись не найдена или недоступна.

Права доступа:
Данные возвращаются только если у пользователя, от имени которого выполняется робот, есть права на просмотр коммерческого предложения.

ID записи:
Указывайте корректный числовой ID. Ошибочный ID приведёт к return_execution_result = N.

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

Получение данных по коммерческому предложению