Прочитать поля банковского реквизита
Робот «Прочитать поля банковского реквизита» возвращает выбранные банковские данные, проверяя принадлежность записи ожидаемому реквизиту клиента.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Менеджеру документов и администратору, который читает выбранные поля банковской записи внутри определённого реквизита.
ID банковского счёта сам по себе не подтверждает принадлежность нужному клиенту. Робот требует ожидаемый реквизит и проверяет связь перед возвратом полей. Неполные данные выделяются отдельно, чтобы не подставить пустой счёт в документ.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ID банковского реквизита (BANK_DETAIL_ID) |
Обязательное поле |
Ожидаемый ID реквизита (REQUISITE_ID) |
Обязательное поле |
Коды полей JSON (FIELDS) |
Обязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Получите BANK_DETAIL_ID через выбор банковского реквизита. В REQUISITE_ID передайте тот же ожидаемый родительский реквизит.
- Перечислите нужные коды в FIELDS JSON-массивом из 1–50 уникальных полей. Например, название банка и номер счёта.
- После успешного статуса проверьте complete и unknown. Неподтверждённое поле не заменяется строкой из другого банковского реквизита.
- Используйте values только для подготовленного документа или дальнейшей проверки. Для оплаты отдельно подтвердите применимость и актуальность банковских данных.
Как заполнить JSON-поля
Коды полей JSON (FIELDS)
[
"RQ_BANK_NAME",
"RQ_ACC_NUM"
]
От 1 до 50 уникальных кодов полей банковской записи. [] запрещён. BANK_DETAIL_ID предварительно получите выбором записи выбранного REQUISITE_ID.
Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.
Учебный пример и ожидаемый результат
BANK_DETAIL_ID=91, REQUISITE_ID=81, FIELDS=["RQ_BANK_NAME","RQ_ACC_NUM"]. При подтверждённой принадлежности и полном ответе values содержит выбранные значения, complete включён. Если поле счёта не передано, оно появляется в unknown; явный null при этом сохраняется как null в values.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «ID банковского реквизита» (
bankDetailId). - «ID реквизита» (
requisiteId). - «Выбранные значения JSON» (
values). - «Поля без значения в ответе» (
unknown), список значений. - «Все выбранные поля получены» (
complete).
Возвращённые bankDetailId и requisiteId связывают результат с исходными настройками. Пустой unknown означает наличие запрошенных полей в ответе, но не подтверждает, что все они непустые и пригодны для платежа.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Принимает BANK_DETAIL_ID, ожидаемый REQUISITE_ID и FIELDS: 1–50 разных кодов полей JSON. Проверяет доступ к реквизиту и его владельцу, существование выбранных полей и принадлежность банковской записи. Возвращает values JSON, список unknown и complete. Явный null сохраняется; пропуск в ответе считается unknown, не пустой строкой. Не выбирает другой счёт и не проверяет возможность платежа. Данные не изменяет.
Робот не выбирает другой банковский счёт при ошибке и не проводит платёж. Если ID относится к другому реквизиту, исправьте связку исходных данных. Банковские значения не нормализуются и не проверяются на возможность реального перевода.