Создание бенефициара

Метод для создания зависит от того, кем является бенефициар. Для юрлица — create_beneficiary_ul, для ИП, самозанятого или физлица — create_beneficiary.

Регистрация в мастер-системе банка происходит асинхронно. После вызова метода бенефициар появляется не сразу — нужно дождаться, пока поле is_added_to_ms не станет true - метод Информация по бенефициару. Только после этого можно загружать документы. Если не передать реквизиты номинального счёта, будет использован счёт по умолчанию.

Создание бенефициара — ЮЛ

Метод create_beneficiary_ul регистрирует бенефициара-юрлицо. Вызывается по адресу <Адреса слоёв>/v2/jsonrpc. Поля метода — в разделе Создать бенефициара ЮЛ.

В данных бенефициара обязательны наименование организации и КПП. При сверке наименования с ЕГРЮЛ регистр букв не учитывается, а символы „»«”().- и двойные пробелы удаляются. Необязательный признак is_active_activity показывает, откуда компания получает больше половины доходов: true — от активной деятельности (купля-продажа, строительство, услуги), false — от пассивной (дивиденды, проценты, рента, доходы от продажи имущества). По умолчанию true.

Возможные ошибки:

Код	Текст
4403	The beneficiary is already exists
4405	The system with the same beneficiary data already exists. It's not allow to use beneficiary as a already registered system
4956	The check concluded that the input INN does not match the input company name
4958	The check concluded that the input KPP does not match the input beneficiary data

Создание бенефициара — ИП и физлицо

Метод create_beneficiary регистрирует ИП, самозанятого или физлицо. Это метод— он вызывается по отдельному адресу <Адреса слоёв>/v3/jsonrpc. Поля метода — в разделе Создать бенефициара.

Тип субъекта задаётся полем legal_type: F — физлицо или самозанятый, I — ИП. Обязателен адрес регистрации. Признак tax_resident показывает, платит ли бенефициар налоги в РФ; по умолчанию true.

Этот метод версии 3, поэтому ошибки приходят в новом формате — с кодом 6001 и текстовым кодом ошибки. Подробнее о формате — на странице Формат логических ошибок.

Возможные ошибки:

Код	Код текстом	Текст
6001	nominal_account_not_found	Nominal account not found
6001	internal_error_please_again_later_or_contact_with_support_team	Internal error, please again later or contact with support team
6001	ip_with_provided_inn_and_name_is_not_found	IP with provided INN and name is not found
6001	ip_with_provided_inn_is_closed	IP with provided INN is closed
6001	incorrect_registration_address	Incorrect registration address
6001	the_inn_is_the_same_as_the_inn_of_the_system	The INN is the same as the INN of the system
6001	the_beneficiary_is_already_exists	The beneficiary is already exists
6001	invalid_inn	Invalid INN

Устаревающие методы

Для ИП и физлиц раньше были отдельные методы create_beneficiary_ip и create_beneficiary_fl. Они ещё работают, но будут отключены — для новых интеграций используйте create_beneficiary. Дату отключения уточняйте в поддержке сервиса. Поля этих методов — в разделах Создать бенефициара ИП и Создать бенефициара ФЛ.

Возможные ошибки create_beneficiary_ip:

Код	Текст
4403	The beneficiary is already exists
4405	The system with the same beneficiary data already exists. It's not allow to use beneficiary as a already registered system
4960	Beneficiary with provided INN and name is not found
4961	Beneficiary with provided INN is closed

Возможные ошибки create_beneficiary_fl:

Код	Текст
4403	The beneficiary is already exists
4405	The system with the same beneficiary data already exists. It's not allow to use beneficiary as a already registered system
4421	Incorrect addresses