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

Обновлено 20 февраля 2025

POST

/beneficiaries/create

Запрос отправляет анкету бенефициара для добавления в реестр бенефициаров номинального счета
Чтобы использовать метод, в параметре scope ссылки авторизации пользователя должен быть указан сервис nominal_accounts для получения доступа к этому ресурсу
Значение атрибута beneficiaryId в запросе должно быть уникально относительно beneficiaryId ранее созданных бенефициаров
Схема блока data должна соответствовать типу бенефициара (beneficiaryType)
БИК банка счета бенефициара в запросе (account.bankBIC) должен соответствовать номеру счета бенефициара в запросе (account.accountNumber). Подробности правил соответствия по ссылке
Значение ИНН бенефициара (inn) в запросе должно быть уникально относительно ранее созданных бенефициаров
Значение атрибута contractExpDate в запросе должно быть больше текущей даты и больше значения атрибута contractDate в запросе

Запрос

Header Parameters

RqUID

RqUID

required

Возможные значения: Value must match regular expression ^[0-9a-fA-F]{32}$

Authorization

Authorization

required

Возможные значения: Value must match regular expression ^([a-zA-Z0-9]){38}$

• application/json

Body

required

content

object

required

Подписываемый контент

data

object

required

oneOf

• beneficiaryIndividuallite
• beneficiaryOrglite
• beneficiaryIndividualEntrepreneurlite

beneficiaryId

uuid

required

Возможные значения: Value must match regular expression ^[0-9a-fA-F-]{36}$

Идентификатор бенефициара номинального счета

beneficiaryType

string

required

Возможные значения: Value must match regular expression ^3$

Тип бенефициара 3 - ФЛ

nominalAccountId

uuid

required

Возможные значения: Value must match regular expression ^[0-9a-fA-F-]{36}$

id номинального счета

contractNumber

contractNumber (string)

required

Возможные значения: <= 25 characters, Value must match regular expression ^[А-ЯЁа-яеA-Za-z\d\/\-\_]+$

Номер договора-основания

contractDate

basisContractDate (string)

required

Возможные значения: Value must match regular expression ^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$

дата заключения договора-основания

contractExpDate

basisContractExpDate (string)

Возможные значения: Value must match regular expression ^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$

дата истечения срока действия договора-основания

surname

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[А-ЯЁ][А-ЯЁа-яе -]+$

Фамилия

name

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[А-ЯЁ][А-ЯЁа-яе -]+$

Имя

patronymic

string

Возможные значения: <= 50 characters, Value must match regular expression ^[А-ЯЁ][А-Яа-яеЁ -]+$

Отчество

birthDate

birthDate (string)

required

Возможные значения: Value must match regular expression ^(19|20)[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$

Дата рождения

identificationDoc

object

required

Документ удостоверяющий личность

identificationDocType

string

Возможные значения: [Паспорт гражданина РФ]

По умолчанию: Паспорт гражданина РФ

Тип (наименование) документа удостоверяющего личность - Паспорт гражданина РФ (общедоступно для ИП)

seria

string

required

Возможные значения: Value must match regular expression ^[0-9]{4}$

Серия документа

number

string

required

Возможные значения: Value must match regular expression ^[0-9]{6}$

Номер документа

issuer

string

required

Возможные значения: Value must match regular expression ^[А-ЯЁа-яе0-9 -/.№]{0,150}$

Наименование органа, выдавшего документ

issueDate

string

required

Возможные значения: Value must match regular expression ^(19|20)[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$

Дата выдачи паспорта

issuerCode

string

required

Возможные значения: Value must match regular expression ^[0-9-]{7}$

Код подразделения

regAddress

addresslite (string)

required

Possible values: Value must match regular expression ^[1-9А-ЯЁа-яеA-Za-z][0-9А-ЯЁа-яеA-Za-z №N.,()/\"«»-]{1,250}$

Юридический алрес

birthPlace

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[А-ЯЁа-яе .-]+$

Место рождения – Город

account

object

required

Структура описания реквизитов расчетного счета

accountNumber

basisAccountNumber (string)

required

Возможные значения: Value must match regular expression ^[0-9]{20,25}$

номер расчетного счета

bankBIC

string

required

Возможные значения: Value must match regular expression ^[0-9]{9}$

БИК

bankCorAccount

string

required

Возможные значения: Value must match regular expression ^[0-9]{20}$

Корреспондентский счет

bankName

string

required

Возможные значения: <= 140 characters, Value must match regular expression ^[А-ЯЁа-яеa-zA-Z][А-ЯЁа-яеa-zA-Z0-9 №N.,()\"#$%&\'\*{|}~\[\]-]+$

Наименование банка

isOnlyTaxResidentRF

boolean

required

Признак налогового резиденства только в РФ: true – да, false – нет

phone

phone (string)

required

Возможные значения: Value must match regular expression ^((8|\+7)[ -]?)?(\(?\d{3}\)?[ -]?)?[\d -]{7,10}$

Номер телефона для контактов (общедоступно)

email

email

required

Возможные значения: <= 40 characters

Адрес электронной почты для контактов (общедоступно)

inn

string

required

Возможные значения: Value must match regular expression ^[0-9]{12}$

ИНН

beneficiaryId

uuid

required

Возможные значения: Value must match regular expression ^[0-9a-fA-F-]{36}$

Идентификатор бенефициара номинального счета

beneficiaryType

string

required

Возможные значения: Value must match regular expression ^1$

Тип бенефициара 1 - ЮЛ

nominalAccountId

uuid

required

Возможные значения: Value must match regular expression ^[0-9a-fA-F-]{36}$

id номинального счета

contractNumber

contractNumber (string)

required

Возможные значения: <= 25 characters, Value must match regular expression ^[А-ЯЁа-яеA-Za-z\d\/\-\_]+$

Номер договора-основания

contractDate

basisContractDate (string)

required

Возможные значения: Value must match regular expression ^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$

дата заключения договора-основания

contractExpDate

basisContractExpDate (string)

Возможные значения: Value must match regular expression ^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$

дата истечения срока действия договора-основания

ogrn

string

required

Возможные значения: Value must match regular expression ^[0-9]{13}$

ОГРН (общедоступно)

inn

string

required

Возможные значения: Value must match regular expression ^[0-9]{10}$

ИНН (общедоступно)

kpp

kpp (string)

required

Возможные значения: Value must match regular expression ^[0-9]{9}$

Код причины постановки на учет (общедоступно)

orgName

orgShortNameRu (string)

required

Возможные значения: Value must match regular expression ^[А-Яа-яеЁ0-9 "№+-]{3,160}$

Наименование организации (общедоступно)

account

object

required

Структура описания реквизитов расчетного счета

accountNumber

basisAccountNumber (string)

required

Возможные значения: Value must match regular expression ^[0-9]{20,25}$

номер расчетного счета

bankBIC

string

required

Возможные значения: Value must match regular expression ^[0-9]{9}$

БИК

bankCorAccount

string

required

Возможные значения: Value must match regular expression ^[0-9]{20}$

Корреспондентский счет

bankName

string

required

Возможные значения: <= 140 characters, Value must match regular expression ^[А-ЯЁа-яеa-zA-Z][А-ЯЁа-яеa-zA-Z0-9 №N.,()\"#$%&\'\*{|}~\[\]-]+$

Наименование банка

legalAddress

addresslite (string)

required

Possible values: Value must match regular expression ^[1-9А-ЯЁа-яеA-Za-z][0-9А-ЯЁа-яеA-Za-z №N.,()/\"«»-]{1,250}$

Юридический алрес

isForeignOrg

boolean

required

Признак зарубежной организации: true – да, false – нет (общедоступно)

isTaxResidentRF

boolean

required

Признак налогового резидента РФ: true – да, false – нет (общедоступно)

isOnlyTaxResidentRF

boolean

required

Признак налогового резиденства только в РФ: true – да, false – нет

isControlPersonsRF

boolean

required

Являются ли все контролирующие лица организации налоговыми резидентами только РФ?: true – да, false – нет (общедоступно)

phone

phone (string)

required

Возможные значения: Value must match regular expression ^((8|\+7)[ -]?)?(\(?\d{3}\)?[ -]?)?[\d -]{7,10}$

Номер телефона для контактов (общедоступно)

email

email

required

Возможные значения: <= 40 characters

Адрес электронной почты для контактов (общедоступно)

beneficiaryId

uuid

required

Возможные значения: Value must match regular expression ^[0-9a-fA-F-]{36}$

Идентификатор бенефициара номинального счета

beneficiaryType

string

required

Возможные значения: Value must match regular expression ^2$

Тип бенефициара 2 - ИП

nominalAccountId

uuid

required

Возможные значения: Value must match regular expression ^[0-9a-fA-F-]{36}$

id номинального счета

contractNumber

contractNumber (string)

required

Возможные значения: <= 25 characters, Value must match regular expression ^[А-ЯЁа-яеA-Za-z\d\/\-\_]+$

Номер договора-основания

contractDate

basisContractDate (string)

required

Возможные значения: Value must match regular expression ^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$

дата заключения договора-основания

contractExpDate

basisContractExpDate (string)

Возможные значения: Value must match regular expression ^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$

дата истечения срока действия договора-основания

surname

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[А-ЯЁ][А-ЯЁа-яе -]+$

Фамилия (общедоступно для ИП)

name

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[А-ЯЁ][А-ЯЁа-яе -]+$

Имя (общедоступно для ИП)

patronymic

string

Возможные значения: <= 50 characters, Value must match regular expression ^[А-ЯЁ][А-ЯЁа-яе -]+$

Отчество (общедоступно для ИП)

birthDate

birthDate (string)

required

Возможные значения: Value must match regular expression ^(19|20)[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$

Дата рождения

identificationDoc

object

required

Документ удостоверяющий личность

identificationDocType

string

Возможные значения: [Паспорт гражданина РФ]

По умолчанию: Паспорт гражданина РФ

Тип (наименование) документа удостоверяющего личность - Паспорт гражданина РФ (общедоступно для ИП)

seria

string

required

Возможные значения: Value must match regular expression ^[0-9]{4}$

Серия документа

number

string

required

Возможные значения: Value must match regular expression ^[0-9]{6}$

Номер документа

issuer

string

required

Возможные значения: Value must match regular expression ^[А-ЯЁа-яе0-9 -/.№]{0,150}$

Наименование органа, выдавшего документ

issueDate

string

required

Возможные значения: Value must match regular expression ^(19|20)[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$

Дата выдачи паспорта

issuerCode

string

required

Возможные значения: Value must match regular expression ^[0-9-]{7}$

Код подразделения

inn

string

required

Возможные значения: Value must match regular expression ^[0-9]{12}$

ИНН

account

object

required

Структура описания реквизитов расчетного счета

accountNumber

basisAccountNumber (string)

required

Возможные значения: Value must match regular expression ^[0-9]{20,25}$

номер расчетного счета

bankBIC

string

required

Возможные значения: Value must match regular expression ^[0-9]{9}$

БИК

bankCorAccount

string

required

Возможные значения: Value must match regular expression ^[0-9]{20}$

Корреспондентский счет

bankName

string

required

Возможные значения: <= 140 characters, Value must match regular expression ^[А-ЯЁа-яеa-zA-Z][А-ЯЁа-яеa-zA-Z0-9 №N.,()\"#$%&\'\*{|}~\[\]-]+$

Наименование банка

ogrnip

string

required

Возможные значения: Value must match regular expression ^3[0-9]{14}$

ОГРНИП (общедоступно)

postAddress

addresslite (string)

required

Possible values: Value must match regular expression ^[1-9А-ЯЁа-яеA-Za-z][0-9А-ЯЁа-яеA-Za-z №N.,()/\"«»-]{1,250}$

Юридический алрес

isOnlyTaxResidentRF

boolean

required

Признак налогового резиденства только в РФ: true – да, false – нет

phone

phone (string)

required

Возможные значения: Value must match regular expression ^((8|\+7)[ -]?)?(\(?\d{3}\)?[ -]?)?[\d -]{7,10}$

Номер телефона для контактов (общедоступно)

email

email

required

Возможные значения: <= 40 characters

Адрес электронной почты для контактов (общедоступно)

agreement

agreement (string)

required

Возможные значения: [Клиент подтверждает, что операция совершается в соответствии с условиями Договора номинального счета]

Соглашение

signature

signature (string)

required

Возможные значения: <= 16000 characters, Value must match regular expression ^[A-Za-z0-9+/=]+$

Подпись над content

Ответы

• 201
• 400
• 401
• 403
• 404
• 405
• 429
• 500
• 502
• 503
• 504

Created

• application/json

• Схема
• Пример из схемы

Schema

beneficiaryId

uuid

Возможные значения: Value must match regular expression ^[0-9a-fA-F-]{36}$

Идентификатор бенефициара номинального счета

{
  "beneficiaryId": "99ee301b-8e06-4fd5-88d4-2ca5668294b1"
}

Bad Request

• application/json

• Схема
• Пример из схемы

Schema

httpCode

string

required

Возможные значения: Value must match regular expression ^[0-9]{3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z '.-]+$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-ZА-ЯЁа-яе.,@№^)(}{$|\s:_!=?/-]*$

Дополнительная информация об ошибке

{
  "httpCode": "400",
  "httpMessage": "Error description",
  "moreInformation": "Error details"
}

Unauthorized

• application/json

• Схема
• Пример из схемы

Schema

httpCode

string

required

Возможные значения: Value must match regular expression ^[0-9]{3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z '.-]+$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-ZА-ЯЁа-яе.,@№^)(}{$|\s:_!=?/-]*$

Дополнительная информация об ошибке

{
  "httpCode": "400",
  "httpMessage": "Error description",
  "moreInformation": "Error details"
}

Forbidden

• application/json

• Схема
• Пример из схемы

Schema

httpCode

string

required

Возможные значения: Value must match regular expression ^[0-9]{3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z '.-]+$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-ZА-ЯЁа-яе.,@№^)(}{$|\s:_!=?/-]*$

Дополнительная информация об ошибке

{
  "httpCode": "400",
  "httpMessage": "Error description",
  "moreInformation": "Error details"
}

Not Found

• application/json

• Схема
• Пример из схемы

Schema

httpCode

string

required

Возможные значения: Value must match regular expression ^[0-9]{3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z '.-]+$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-ZА-ЯЁа-яе.,@№^)(}{$|\s:_!=?/-]*$

Дополнительная информация об ошибке

{
  "httpCode": "400",
  "httpMessage": "Error description",
  "moreInformation": "Error details"
}

Method Not Allowed

• application/json

• Схема
• Пример из схемы

Schema

httpCode

string

required

Возможные значения: Value must match regular expression ^[0-9]{3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z '.-]+$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-ZА-ЯЁа-яе.,@№^)(}{$|\s:_!=?/-]*$

Дополнительная информация об ошибке

{
  "httpCode": "400",
  "httpMessage": "Error description",
  "moreInformation": "Error details"
}

Too Many Requests

• application/json

• Схема
• Пример из схемы

Schema

httpCode

string

required

Возможные значения: Value must match regular expression ^[0-9]{3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z '.-]+$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-ZА-ЯЁа-яе.,@№^)(}{$|\s:_!=?/-]*$

Дополнительная информация об ошибке

{
  "httpCode": "400",
  "httpMessage": "Error description",
  "moreInformation": "Error details"
}

Internal Server Error

• application/json

• Схема
• Пример из схемы

Schema

httpCode

string

required

Возможные значения: Value must match regular expression ^[0-9]{3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z '.-]+$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-ZА-ЯЁа-яе.,@№^)(}{$|\s:_!=?/-]*$

Дополнительная информация об ошибке

{
  "httpCode": "400",
  "httpMessage": "Error description",
  "moreInformation": "Error details"
}

Bad Gateway

Service Unavailable

Gateway Timeout

Loading...

Loading...