Добавление адресного реквизита

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

Добавление адреса к реквизиту компании или контакта для документов (счета, договоры);
Автоматическое заполнение юридического адреса после создания реквизита в бизнес-процессе;
Добавление почтового адреса для доставки или корреспонденции;
Заполнение адресных данных при интеграции с 1С или другими системами;
Массовое добавление адресов для списка реквизитов через итератор;
Добавление фактического адреса к реквизиту по шаблону;
Синхронизация адресов между CRM и учётными системами;
Добавление адреса реквизита при создании счёта или договора;
Заполнение адреса из полей лида или сделки при конвертации;
Автоматизация ввода адресов после проверки или при импорте.

Как работает активити (робот):
- Адрес привязывается к реквизиту (ENTITY_TYPE_ID=8). Реквизит должен существовать в CRM;
- Обязательными являются ID реквизита (ENTITY_ID) и тип адреса (TYPE_ID);
- Типы адресов (юридический, почтовый, фактический и др.) задаются настройками портала;
- У реквизита может быть только один адрес каждого типа. Если адрес такого типа уже есть, активити (робот) завершится с ошибкой;
- При успешном создании возвращается идентификатор нового адреса (id_address).

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

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

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

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

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

- id_address (ID адреса) — число, идентификатор созданного адреса. Используется для изменения адреса через «Изменение адресного реквизита», получения данных или удаления.

Примеры использования возвращаемых параметров:
- Передать id_address в активити «Изменение адресного реквизита» для обновления данных;
- Использовать id_address в «Получение данных по адресному реквизиту»;
- Сохранить id_address в переменную для условий или следующих шагов.

Важно о возвращаемых параметрах: При ошибке (нет обязательных параметров, реквизит не найден или адрес такого типа уже существует) адрес не создаётся; в журнал записывается сообщение об ошибке.

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

Обязательные параметры: ID реквизита и Тип адреса. Реквизит должен существовать в CRM. Если реквизит не найден — ошибка «Указанной сущности не существует».

Уникальность типа: У одного реквизита может быть только один адрес каждого типа. Если адрес такого типа уже есть — ошибка «Адрес такого типа уже существует». Используйте «Изменение адресного реквизита» для обновления.

Порядок создания: Сначала создайте реквизит активити «Добавление реквизита», затем добавляйте адрес. ID реквизита передайте в ENTITY_ID.

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

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

Добавление адресного реквизита