Получение данных по адресному реквизиту

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

Получение данных адреса реквизита для подстановки в документы (счета, договоры);
Извлечение адреса для доставки, почтовых отправлений;
Проверка заполненности адреса перед формированием документа;
Получение адреса после создания реквизита для проверки или передачи дальше;
Копирование адреса в переменные для условий или расчётов;
Сравнение адресов реквизита и контрагента;
Выгрузка адресов для интеграции с 1С;
Массовое получение данных адресов в цикле по списку реквизитов;
Заполнение полей сделки или задачи данными адреса;
Валидация адреса (проверка наличия города, индекса и т.д.).

Как работает активити (робот):
- Активити (робот) получает данные адреса по типу адреса (TYPE_ID) и ID реквизита (ENTITY_ID) через crm.address.list;
- Обязательны тип адреса и ID реквизита. Адрес с такой комбинацией должен существовать;
- Возвращаются все поля адреса: ID, TYPE_ID, ENTITY_ID, ADDRESS_1, ADDRESS_2, CITY, COUNTRY_CODE и др.;
- Если адрес не найден, в журнал записывается ошибка «Адрес не найден».

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

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

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

Описание примера	Решение
Получить юридический адрес для счёта	Тип адреса — «Юридический», ID реквизита — {=Variable:REQUISITE_ID}. Используйте возвращаемые ADDRESS_1, ADDRESS_2, CITY в шаблоне счёта.
Извлечь адрес после создания реквизита	Тип адреса — «Юридический», ID реквизита — {=A1988_22222_92566_99999:id_requisite}. Проверьте корректность или передайте данные дальше.
Проверить, заполнен ли адрес	Тип адреса и ID реквизита — по задаче. В условии проверьте ADDRESS_1: если пусто — ветка «Заполнить адрес» или уведомление.
Получить адрес первого реквизита компании	После «Поиск реквизитов» по ENTITY_ID — {=Document:COMPANY_ID}: ID реквизита — {=A1988_22222_92566_99999:search_result_first_string}, Тип адреса — нужный.
Массовое получение адресов в цикле	В цикле по итератору (ID реквизитов): ID реквизита — {=Iterator:Value}, Тип адреса — «Юридический». Соберите ADDRESS_1 и др. для выгрузки.
Адрес для доставки	Тип адреса — «Почтовый» или «Фактический», ID реквизита — {=Variable:REQUISITE_ID}. Используйте возвращаемые поля в активити доставки или уведомления.
Сравнить адреса компании и контрагента	Получите адрес реквизита компании, сохраните ADDRESS_1 в переменную. Получите адрес контрагента — ID реквизита — {=Variable:CONTACT_REQUISITE_ID}. В условии сравните.
Выгрузка адресов для 1С	В цикле: ID реквизита — {=Iterator:Value}, Тип адреса — «Юридический». Соберите ID, ADDRESS_1, CITY, COUNTRY_CODE для передачи во внешнюю систему.
Заполнить поле сделки адресом	ID реквизита — {=Variable:REQUISITE_ID}, Тип адреса — нужный. Передайте ADDRESS_1 или полный адрес в «Изменение сделки» через переменную.
Адрес для письма или уведомления	Тип адреса — «Почтовый», ID реквизита — {=Variable:REQUISITE_ID}. Подставьте ADDRESS_1, CITY в текст письма или шаблон уведомления.

Сценарий работы активити бизнес-процесса

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

Активити (робот) возвращает все доступные поля адреса: ID, TYPE_ID, ENTITY_ID, ENTITY_TYPE_ID, ADDRESS_1, ADDRESS_2, CITY, REGION, POSTAL_CODE, COUNTRY_CODE, а также поля реквизита (RQ_*, если есть в crm.address.fields). Список формируется при установке активити (робота). Используйте нужные параметры в следующих шагах.

Важно о возвращаемых параметрах: Если адрес с указанными TYPE_ID и ENTITY_ID не найден, данные не возвращаются и в журнал записывается «Адрес не найден». Проверяйте наличие адреса перед вызовом или обрабатывайте ошибку.

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

Обязательные параметры: Тип адреса и ID реквизита. Адрес должен существовать. У реквизита может быть только один адрес каждого типа.

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

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

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

Получение данных по адресному реквизиту