Выбрать банковский реквизит по точным условиям

Робот «Выбрать банковский реквизит по точным условиям» выбирает счёт конкретного реквизита по заданным признакам и явно обрабатывает несколько совпадений.

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

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

Менеджеру документов и администратору CRM, которому нужно выбрать банковскую запись внутри уже выбранного реквизита.

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

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

Поле	Как заполнить
ID реквизита (REQUISITE_ID)	Обязательное поле
Активность (ACTIVE)	Обязательное поле. Активен (Y); Неактивен (N)
Точные условия JSON (CONDITIONS)	Обязательное поле
Несколько совпадений (AMBIGUITY)	Обязательное поле. Только единственное (unique); Наименьший ID (lowest_id)

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

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

1. Получите REQUISITE_ID предыдущим шагом выбора клиента. Укажите ACTIVE=Y для активных либо N для неактивных банковских записей.
2. В CONDITIONS передайте объект точных условий. Пустой {} означает отсутствие дополнительных условий, но активность всё равно учитывается.
3. Выберите unique для единственного результата либо lowest_id для явно согласованного выбора минимального ID.
4. После успешного статуса проверьте found, ambiguous и bankDetailId. Наличие нескольких совпадений в режиме unique не даёт выбранного ID.

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

Точные условия JSON (CONDITIONS)

{
  "NAME": "Основной счёт"
}

Объект точных условий. Все заполненные условия действуют одновременно. {} допустим и не ограничивает выбор дополнительно к ACTIVE. COUNTRY_ID положительный ID, остальные значения строки; ведущие нули сохраняются.

Это объект с именованными полями. Не заменяйте его массивом []. Имена полей и их регистр должны совпасть с приведённым форматом.

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

Для учебного реквизита 81 передайте ACTIVE=Y и CONDITIONS={"NAME":"Основной счёт"}, AMBIGUITY=unique. Если найдена одна соответствующая запись 91, ожидается bankDetailId=91, count=1 и отсутствие неоднозначности. Если совпадают две записи, ID будет 0 и ambiguous включится.

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

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

• «ID банковского реквизита» (bankDetailId).
• «Есть совпадения» (found).
• «Несколько совпадений» (ambiguous).
• «Число совпадений» (count).

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

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

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

Принимает REQUISITE_ID, ACTIVE Y/N, CONDITIONS JSON и AMBIGUITY unique/lowest_id. Условия: NAME, COUNTRY_ID, RQ_ACC_CURRENCY, RQ_BIK, RQ_ACC_NUM, RQ_IBAN, RQ_SWIFT. Сравнивает строки точно, сохраняя ведущие нули; страну сравнивает по ID. Читает весь доступный список до 1000 записей/100 страниц, проверяет владельца. Неизвестное необходимое поле вызывает ошибку, а не отсутствие совпадения. Возвращает ID, found, ambiguous и count. Правило lowest_id явно выбирает наименьший ID; unique при дублях возвращает ID=0. Не проверяет возможность платежа и не изменяет данные.

Допустимые условия: NAME, COUNTRY_ID, RQ_ACC_CURRENCY, RQ_BIK, RQ_ACC_NUM, RQ_IBAN, RQ_SWIFT. Страна задаётся положительным ID, остальные условия непустыми строками. Робот не проверяет возможность платежа и не изменяет банковский выбор карточки.