+7 (961) 805-51-93ТелеграмMAXОставить заявку
К приложениюУстановка
CRM роботы 2.0 + AI (300+ роботов)

Прочитать адреса реквизита по типам

Робот «Прочитать адреса реквизита по типам» получает выбранные адреса клиента и отдельно показывает отсутствующие типы и неполные данные.

Настройки робота «Прочитать адреса реквизита по типам» в Битрикс24

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую задачу решает

Администратору CRM и сотруднику, который готовит юридический, фактический или иной адрес реквизита для документов.

У реквизита может быть несколько адресов разного типа. Подстановка первого адреса рискует смешать назначения. Робот читает только перечисленные типы и отдельно сообщает, каких адресов или полей не хватает.

Параметры и подготовка

Поле Как заполнить
ID реквизита (REQUISITE_ID) Обязательное поле
Типы адресов JSON (TYPE_IDS) Обязательное поле
Коды полей JSON (FIELDS) Обязательное поле

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

Как использовать

  1. Укажите REQUISITE_ID выбранного реквизита. Получите ID типов адресов из используемого справочника портала.
  2. Передайте TYPE_IDS массивом из 1–100 уникальных положительных типов. В FIELDS перечислите поддерживаемые текстовые поля адреса.
  3. После выполнения проверьте complete и missingTypes. Отсутствие адреса нужного типа является допустимым результатом чтения, а не разрешением взять другой тип.
  4. В addresses найдите запись нужного typeId и значения values. Дополнительно проверьте unknown этой записи до подстановки в документ.

Как заполнить JSON-поля

Типы адресов JSON (TYPE_IDS)

[
  1
]

От 1 до 100 уникальных положительных ID типов адреса. Получите реальные типы из справочника вашего портала; 1 здесь учебный. [] запрещён.

Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.

Коды полей JSON (FIELDS)

[
  "CITY",
  "ADDRESS_1",
  "POSTAL_CODE"
]

Непустой список разных поддерживаемых полей адреса. Допустимы ADDRESS_1, ADDRESS_2, CITY, POSTAL_CODE, REGION, PROVINCE, COUNTRY, COUNTRY_CODE. [] запрещён.

Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.

Учебный пример и ожидаемый результат

REQUISITE_ID=81, TYPE_IDS=[1], FIELDS=["CITY","ADDRESS_1","POSTAL_CODE"]. Если учебный реквизит имеет адрес типа 1 с этими полями, вернётся одна запись. Если такого адреса нет, missingTypes содержит 1, count равен 0 и complete выключен. Номер типа в примере замените на нужный тип вашего портала.

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

  • «Адреса и неизвестные поля JSON» (addresses).
  • «Отсутствующие типы» (missingTypes), список значений.
  • «Число найденных адресов» (count).
  • «Все выбранные данные получены» (complete).

Каждая запись результата содержит typeId, выбранные values и список unknown. Явный null не равен отсутствующему полю. count отражает число найденных адресов, а не число заполненных полей.

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Принимает REQUISITE_ID, TYPE_IDS: 1–100 разных типов адреса JSON, FIELDS: выбранные ADDRESS_1, ADDRESS_2, CITY, POSTAL_CODE, REGION, PROVINCE, COUNTRY, COUNTRY_CODE. Проверяет владельца реквизита и каждой записи. Возвращает addresses JSON с typeId/values/unknown, missingTypes, count и complete. Явный null сохраняет, пропуск поля не заменяет пустой строкой. Отсутствие адреса выбранного типа: успешный результат с missingTypes; complete=N. До 1000 записей/100 страниц. Не нормализует адреса, не проверяет доставку и ничего не записывает.

Допустимые поля: ADDRESS_1, ADDRESS_2, CITY, POSTAL_CODE, REGION, PROVINCE, COUNTRY, COUNTRY_CODE. Робот не стандартизирует написание и не проверяет возможность доставки. Для исправления адреса используйте отдельное действие с подтверждёнными прежними значениями.