Добавление банковского реквизита
Робот «Добавление банковского реквизита» добавляет банковский реквизит к существующему реквизиту компании.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Менеджеру документов и администратору CRM, который добавляет банковскую запись к уже существующему реквизиту компании.
Банковские данные должны быть связаны с правильным набором реквизитов. Робот находит его по компании и ИНН и требует единственность. Это помогает не прикрепить новый счёт к случайной записи, когда у компании несколько реквизитов.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ID компании (companyId) |
Обязательное поле |
ИНН основного реквизита для связи (inn) |
Обязательное поле |
NAME (NAME) |
Необязательное поле |
CODE (CODE) |
Необязательное поле |
XML_ID (XML_ID) |
Необязательное поле |
ACTIVE (ACTIVE) |
Необязательное поле |
SORT (SORT) |
Необязательное поле |
RQ_BANK_NAME (RQ_BANK_NAME) |
Необязательное поле |
RQ_BANK_ADDR (RQ_BANK_ADDR) |
Необязательное поле |
RQ_BANK_CODE (RQ_BANK_CODE) |
Необязательное поле |
RQ_BANK_ROUTE_NUM (RQ_BANK_ROUTE_NUM) |
Необязательное поле |
RQ_BIK (RQ_BIK) |
Необязательное поле |
RQ_CODEB (RQ_CODEB) |
Необязательное поле |
RQ_CODEG (RQ_CODEG) |
Необязательное поле |
RQ_RIB (RQ_RIB) |
Необязательное поле |
RQ_MFO (RQ_MFO) |
Необязательное поле |
RQ_ACC_NAME (RQ_ACC_NAME) |
Необязательное поле |
RQ_ACC_NUM (RQ_ACC_NUM) |
Необязательное поле |
RQ_ACC_TYPE (RQ_ACC_TYPE) |
Необязательное поле |
RQ_AGENCY_NAME (RQ_AGENCY_NAME) |
Необязательное поле |
RQ_IIK (RQ_IIK) |
Необязательное поле |
RQ_ACC_CURRENCY (RQ_ACC_CURRENCY) |
Необязательное поле |
RQ_COR_ACC_NUM (RQ_COR_ACC_NUM) |
Необязательное поле |
RQ_IBAN (RQ_IBAN) |
Необязательное поле |
RQ_SWIFT (RQ_SWIFT) |
Необязательное поле |
RQ_BIC (RQ_BIC) |
Необязательное поле |
COMMENTS (COMMENTS) |
Необязательное поле |
ORIGINATOR_ID (ORIGINATOR_ID) |
Необязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Укажите companyId компании и точный ИНН основного реквизита. В CRM уже должен существовать ровно один подходящий реквизит этой компании.
- Заполните нужные банковские поля: NAME для названия записи, RQ_BANK_NAME для банка, RQ_ACC_NUM для счёта, RQ_BIK и другие по вашему формату.
- Номера счетов и банковские коды передавайте строками с ведущими нулями. Не включайте рабочие сведения в общедоступные примеры.
- После создания сохраните возвращённый id и проверьте родительский реквизит. При ошибке сверяйте список банковских записей до повторного создания.
Учебный пример и ожидаемый результат
В учебной компании 51 существует один реквизит с выбранным учебным ИНН. Укажите companyId=51, тот же inn, NAME=«Учебный банковский реквизит» и согласованные демонстрационные банковские поля. Ожидается новая банковская запись под этим реквизитом и её положительный ID. Если по ИНН два реквизита, создание не продолжается.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «ID реквизита» (
id).
Выход id содержит ID новой банковской записи, хотя подпись использует общее слово «реквизит». Он отличается от ID родительского реквизита и компании. Используйте его в последующем выборе банковских данных.
Выход «Статус» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Ошибка» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Для привязки нужны companyId и ИНН уже существующего единственного реквизита этой компании. Банковские поля заполняются отдельными параметрами. Создание возвращает ID банковской записи и статус; неоднозначная привязка останавливает действие.
Робот не создаёт основной реквизит при отсутствии, не проверяет возможность банковского перевода и не предотвращает повторное создание при новом запуске. Все необязательные банковские поля передаются отдельно, а не одним JSON-объектом.