Creating a new client
The client creation process takes place in two stages:
-> 2. Create a new client.
When creating a new client, you need to extract the entire body returned by the initialization method of the new client into the request body. In the body of the request, you need to enter data about the client:
-
** firstName ** - name,
-
** lastName ** - last name,
-
** sexId ** - gender ,
-
** birthDate ** - date of birth in YYYY-MM-DD format,
-
** passport ** (passport.seria, passport.no, passport.issueDate) - passport data (passport series, passport number, passport issue date in YYYY-MM-DD format)
-
** mobilePhone ** - mobile phone number in digital form of international format (eg 89031001112, 37369123456)
-
** managerId ** - client manager ID
-
** addressData ** ( addressData.fias , addressData.fullAddressText) - actual address
-
** registrationAddressData ** (registrationAddressData.fias, registrationAddressData.fullAddressText) - registration address
You can transfer a completely filled address structure as client addresses, or you can specify only two fields - FIAS code and an address string (including apartment number ), and all other fields will be filled in automatically.
The trigger for sending a separate request to clarify the address is the filled FIAS code and address line fields, as well as the empty fiasChainText field
The minimum set of fields to fill in the request body from the previous list are: firstName, lastName, sexId, birthDate, passport.seria, passport.no, passport.issueDate, mobilePhone, addressData.fias , addressData.fullAddressText. The managerId field (you can find it out in the reference books - loan specialist ) is already filled with a default value during client initialization
Request Body
Chief Accountant
Activity subtype identifier , this link can be used to get "Activities", which in their queue can contain activity subtypes
"int64""int64"other expenses
"double"Additional income
"double"Additional Information
Alimony Yes / No
Scheduled inspection date in the format YYYY-MM-DD
"date"Conviction Yes / No
Are there any restrictions on the right to conclude a loan transaction (including a marriage contract) Yes / No
The risk of using public services (risk of involvement) for the purpose of legalizing (laundering) proceeds from crime and financing terrorism
Are there or have been in the past court decisions limiting the client's legal capacity or establishing guardianship over the client? Yes / No
Please enter a title
Results of checking the client, client's representative, beneficiary, beneficial owners for the presence / absence of a close relationship to a person included in the list of Extremists
Information (documents) on the financial position
Resident Yes / No
Date of registration of the Questionnaire of the client, client's representative, beneficiary, beneficial owners in the YYYY-MM-DD format
"date"Dates of updating the client's questionnaire
Provided sureties
You have already contacted banks Yes / No
Additional information identifier
"int64"Lawsuits Yes / No
Client license information
Origin of funds
Is the client a manager, founder or employee of public organizations and associations (religious organizations, political parties, organizations, associations), foundations, foreign non-profit non-governmental organizations, their branches and representative offices operating in the territory of the Russian Federation
Pregnancy Yes / No
Personal property - apartment
Registered with a psychiatrist or narcologist Yes / No
Information about the client's (his relatives, indicating the degree of relationship or status), beneficial owners (his relatives, indicating the degree of relationship or status) to a foreign public official
Results of checking the registration address (location or place of residence) of the client, the client's representative, beneficiary, beneficial owners in the country / region / subject with a high risk of terrorist and extremist manifestations, interethnic conflicts, armed conflicts and hostilities
Risk degree
"int64"Are there any taxes and duties arrears Yes / No
Are there any overdue debts?
Personal property - car
Additional telephone number in digital form in international format (e.g. 74951001112, 37369123456)
Residence address (for legal entities Actual address)
Apartment number
Building number
Building number
The FIAS address chain. This parameter is optional. When creating a client, you can choose not to transfer
JSON URL string
Address chain
FIAS address string
House number
Housing type
Residence Address ID
"int64"District
Nearest metro station
An outdated address, for example, an old street name in a passport. Used for informational purposes only!
Postal Code
Registration date in YYYY-MM-DD format
"date"Scope
Locality, street, house
Landline telephone in digital form of international format (e.g. 74951001112, 37369123456)
Collection of additional addresses
Apartment number
Building number
Building number
Country identifier
"int64"FIAS address chain
JSON URL string
FIAS code (street level)
FIAS address string
House number
Housing type
Additional address identifier
"int64"Name of the settlement
Nearest metro station
The string of the address entered manually (not the actual address as in the passport)
Index of the position of the address in the collection of additional addresses
"byte"Postal Code
Address assignment (registration, place of work, etc.)
"int64"Registration date in YYYY-MM-DD format
"date"Scope
Street name
Landline telephone in digital form of international format (e.g. 74951001112, 37369123456)
Alimony
"double"Car availability Yes / No
Availability of real estate
Average monthly expenses
"double"Collection of beneficial owners. Beneficial owner (also beneficial owner) is a person or several persons who directly or indirectly own a legal entity or have a significant influence on its decision-making. (see also here )
Object identifier within the collection of beneficialOwners
"int64"Customer ID who, based on substantiation justification, should be considered the beneficial owner
"int64"Rationale. On the basis of which, it was decided to consider the beneficial owner with the given ownerId as such
Date of birth in YYYY-MM-DD format
"date"Place of Birth
Prizes
"double"Flag of consent to transfer given to credit bureau Yes / No
Date of consent to transfer data to the credit bureau in the format YYYY-MM-DD
"date"Workplace address
Apartment number
Building number
Building number
The FIAS address chain. This parameter is optional. When creating a client, you can choose not to transfer
JSON URL string
Address chain
FIAS address string
House number
Housing type
Residence Address ID
"int64"District
Nearest metro station
An outdated address, for example, an old street name in a passport. Used for informational purposes only!
Postal Code
Registration date in YYYY-MM-DD format
"date"Scope
Locality, street, house
Landline telephone in digital form of international format (e.g. 74951001112, 37369123456)
Business owner Yes / No
IP sign Yes / No. According to the law of the Russian Federation, an individual entrepreneur (IP) is a physical. face. If the client is an individual entrepreneur, then this field and the naturalperson field are true. For legal entities persons (for example LLC) values for the fields businessman and naturalperson are passed false
Bankcard number
Activity certificate
"int64"Expiration date in YYYY-MM-DD format
"date"Founder's document type identifier : - 102121 - Driver's license - 102122 - SNILS - 102123 - Foreign passport - 102126 - Passport - 102127 - Other document - 102128 - No Currently, although this parameter is present, it will have the null value in the passport,
because there is a complementaryDoc object that contains the complementaryDocTypeId parameter, which has a value (see the description of this parameter above)
"int64"Additional number
Certificate ID
"int64"Date of issue in YYYY-MM-DD format
"date"Issued by
Certificate number
Certificate Series
Department code
Type Certificate
"int64"Has your full name changed Yes / No
Reason for changing name
The size of the authorized capital or authorized capital
Of them adult children
"int64"Children's age
No. of children
"int64"Agent
"int64"Client risk status
Client risk status Comment
Client's risk status identifier
"int64"Customer Risk Status Date in YYYY-MM-DD format
"date-time"Client risk status Username
"int32"Client risk status
"int64"Client type - BORROWER - Borrower - COBORROWER - Co-borrower - GUARANTOR - Guarantor - PLEDGER - Pledger - DEPOSITOR - Investor - REPRESENTATIVE - Client's representative - BENEFICIARY - Beneficiary
"BENEFICIAL_OWNER""BENEFICIARY""BORROWER""COBORROWER""DEPOSITOR""GUARANTOR""PLEDGER""REPRESENTATIVE"Comment
Additional documents
"int64"Validity of add. document in YYYY-MM-DD format
"date"Additional document type. Record ID in the "Document Type " reference
"int64"Additional identifier document. When creating a new client, null is written, the number is assigned automatically
"int64"Date of issue add. document in YYYY-MM-DD format
"date"Issued by add. document
Additional number document
Creation date in YYYY-MM-DD format
"date"Current credit limit
"double"Maximum credit limit
"double""date"Are you a dependent? Well no
Number of dependents
"int32"Director
E-mail address
Number of employees
"int32"Date of termination of the relationship with the customer in the format YYYY-MM-DD
"date"Additional field identifier
"int64"The name of the additional field.
If you want the variables from the lead to be taken from the lead to the client / application / contract during the operation of the decision making system (DSS),
then you need to transfer them as follows: - client.field_name - for placing a field in the client - loanApplication.field_name - for placing a field in an application - contract.field_name - for placing a field in a contract
Additional field value
Faculty
Fax
Name
Foreign organization code
Registration number in the country of registration
Organization name in a foreign language
Group id
"int64"Identifier of an entry in the directory "Position of the head"
"int64"University
Home telephone number in digital form in international format (e.g. 74951001112, 37369123456)
ID of the entry in the directory "How did you hear about us?"
"int64"Client ID. When creating a new client, null is written, the ID is assigned automatically
"int64"Even list Yes / No
On the email list
Red List Yes / No
In the SMS mailing list Yes / No
Investor Yes / No
Client join date in YYYY-MM-DD format
"date"The manager acts on the basis
Checkpoint
"int32""int32""int32""int32""int32""int32""int64""int32""int32"Surname
Old name in Latin
Old surname in Latin
Old patronymic in Latin
Reason for termination of membership
"int64"Organizational and legal form
Document confirming the right to stay on the territory of the Russian Federation
"int64"Expiration date in YYYY-MM-DD format
"date"Founder's document type identifier : - 102121 - Driver's license - 102122 - SNILS - 102123 - Foreign passport - 102126 - Passport - 102127 - Other document - 102128 - No Currently, although this parameter is present, it will have the null value in the passport,
because there is a complementaryDoc object that contains the complementaryDocTypeId parameter, which has a value (see the description of this parameter above)
"int64"Additional number
Certificate ID
"int64"Date of issue in YYYY-MM-DD format
"date"Issued by
Certificate number
Certificate Series
Department code
Loan payments
"double"Maiden name
ID of an entry from the "Loan Specialist" directory
"int64"Marital Status Identifier - 101151 - SINGLE - 101152 - MARRIED - 101153 - DIVORCED ( Divorced / Divorced) - 101154 - WIDOW (Widow / Widow) - 101155 - CIVIL_MARRIAGE (Civil marriage)
"int64"Average monthly income
"double"Migration card
"int64"Expiration date in YYYY-MM-DD format
"date"Founder's document type identifier : - 102121 - Driver's license - 102122 - SNILS - 102123 - Foreign passport - 102126 - Passport - 102127 - Other document - 102128 - No Currently, although this parameter is present, it will have the null value in the passport,
because there is a complementaryDoc object that contains the complementaryDocTypeId parameter, which has a value (see the description of this parameter above)
"int64"Additional number
Certificate ID
"int64"Date of issue in YYYY-MM-DD format
"date"Issued by
Certificate number
Certificate Series
Department code
Is your mobile phone number registered to you?
Mobile phone number in digital form in international format (e.g. 79031001112, 37369123456)
Monthly income for 2NDFL
"double"Average monthly pension
"double"Monthly net profit
"double"SME (Small / Medium Enterprise)
Natural person attribute Yes / No
OKATO
OKFS
OKOGU
OKOPF
OKTMO
OKVED
Old name
Old surname
Old passport
Old patronymic
Initial experience (before joining the program) in months:
"int32"The passport
"int64"Expiration date in YYYY-MM-DD format
"date"Founder's document type identifier : - 102121 - Driver's license - 102122 - SNILS - 102123 - Foreign passport - 102126 - Passport - 102127 - Other document - 102128 - No Currently, although this parameter is present, it will have the null value in the passport,
because there is a complementaryDoc object that contains the complementaryDocTypeId parameter, which has a value (see the description of this parameter above)
"int64"Additional number
Certificate ID
"int64"Date of issue in YYYY-MM-DD format
"date"Issued by
Certificate number
Certificate Series
Department code
middle name
"int64"Customer accounts
Account number
Bank ID
"int64"Name of the bank. The field is needed in case the bank is not selected from the directory, but is indicated on the client accounts page
BIK
Availability of a file cabinet
Comments
Cor. score
"int64"Recipient's TIN
Average monthly account turnover
Account opening date in YYYY-MM-DD format
"date"Recipient
Founders
"int64"Date of birth of the founder
"date"Founder ID
"int64"Founder's mobile phone
Full name of the founder
Founder's passport details
Founder's passport
Founder Position ID
"int64"Founder's registration address
Resident
Founder's share
"double"Founder's office phone number
Income
Amount
"double"Income ID
"int64"Income type identifier
"int64"Information (comment)
List of relatives
Relative address
Relative's date of birth (YYYY-MM-DD)
"date"Affinity identifier : - 102141 - Wife - 102142 - Husband - 102143 - Mom - 102144 - Dad - 102145 - Daughter - 102146 - Son - 102147 - Brother - 102148 - Sister - 102149 - Colleagues - 1021410 - Friends - 1021411 - Grandmother - 1021412 - Grandfather - 1021413 - Uncle - 1021414 - Aunt - 1021415 - Other
"int64"Comments by relatives
Relative email
Relative name
Relative ID
"int64"Relative surname
Relative's passport
Relative patronymic
Resident
TIN of a relative
Relative phone number
Verified
A relative's place of work
Personal account
Data processing consent flag Yes / No
Date of consent to data processing in YYYY-MM-DD format
"date"Pin
Rating
"APPROVE""DENY""GOOD""MEDIUM""TECH_FAULT""UNDEFINED""VALIDATION_ERROR"Rating date in YYYY-MM-DD format
"date"Registration address (for legal entities Legal address)
Apartment number
Building number
Building number
The FIAS address chain. This parameter is optional. When creating a client, you can choose not to transfer
JSON URL string
Address chain
FIAS address string
House number
Housing type
Residence Address ID
"int64"District
Nearest metro station
An outdated address, for example, an old street name in a passport. Used for informational purposes only!
Postal Code
Registration date in YYYY-MM-DD format
"date"Scope
Locality, street, house
Landline telephone in digital form of international format (e.g. 74951001112, 37369123456)
OGRNIP
"int64"Expiration date in YYYY-MM-DD format
"date"Founder's document type identifier : - 102121 - Driver's license - 102122 - SNILS - 102123 - Foreign passport - 102126 - Passport - 102127 - Other document - 102128 - No Currently, although this parameter is present, it will have the null value in the passport,
because there is a complementaryDoc object that contains the complementaryDocTypeId parameter, which has a value (see the description of this parameter above)
"int64"Additional number
Certificate ID
"int64"Date of issue in YYYY-MM-DD format
"date"Issued by
Certificate number
Certificate Series
Department code
Rental income
"double"Resident Yes / No
INN
Role ID
"int64"Current loans and borrowings
The presence of delays in an existing loan or loan
Bank of an active loan or loan
Number / Date of the current credit or loan agreement
The amount of the current loan or loan
"double"Object identifier bank of active credit or loan
"int64"The name of the current loan or loan
Current loan or loan identifier
"int64"Interest rate of an active loan or loan
"double"Date of the last actual payment on an active loan or loan in the format YYYY-MM-DD
"date"Monthly payment of an existing loan or loan
"double"Frequency of payments of an existing loan or loan
Remaining debt of the current loan or loan
"double"Details of a valid loan or loan
Gender
"int64"Shareholder
Abbreviated name of the organization
SMS history
SNILS
Form of study
Year of graduation
OKPO code (for legal entities)
Name of company
Validity - month
Validity - year
Work place information
Comment
I don't work for a reason
Second employee's phone number
Director's telephone number in digital form in international format (e.g. 74951001112, 37369123456)
Executive phone number in digital form of international format (e.g. 74951001112, 37369123456)
Colleague's phone number in digital form in international format (e.g. 74951001112, 37369123456)
Additional telephone in digital form of international format (e.g. 74951001112, 37369123456)
Employment rate. Record identifier in the "Degree of employment" reference
"int64"Workplace information identifier
"int64"TIN of the organization
Date of next salary in YYYY-MM-DD format
"date"previous place of work
Job website
Experience
International digital work phone (e.g. 74951001112, 37369123456)
Place of work
Job type
"int64"Position
Job type
"int64"Employment date in YYYY-MM-DD format
"date"Responses
OK
Chief Accountant
Activity subtype identifier , this link can be used to get "Activities", which in their queue can contain activity subtypes
"int64""int64"other expenses
"double"Additional income
"double"Additional Information
Additional telephone number in digital form in international format (e.g. 74951001112, 37369123456)
Residence address
Alimony
"double"Car availability Yes / No
Availability of real estate
Average monthly expenses
"double"Collection of beneficial owners. Beneficial owner (also beneficial owner) is a person or several persons who directly or indirectly own a legal entity or have a significant influence on its decision-making. (see also here )
Date of birth in YYYY-MM-DD format
"date"Place of Birth
Prizes
"double"Flag of consent to transfer given to credit bureau Yes / No
Date of consent to transfer data to the credit bureau in the format YYYY-MM-DD
"date"Address of the place of work
Business owner Yes / No
IP sign Yes / No. According to the law of the Russian Federation, an individual entrepreneur (IP) is a physical. face. If the client is an individual entrepreneur, then this field and the naturalperson field are true. For legal entities persons (for example LLC) values for the fields businessman and naturalperson are passed false
Bankcard number
Activity certificate
Type Certificate
"int64"Has your full name changed Yes / No
Reason for changing name
The size of the authorized capital or authorized capital
Of them adult children
"int64"Children's age
No. of children
"int64"Agent
"int64"Client risk status
Client type - BORROWER - Borrower - COBORROWER - Co-borrower - GUARANTOR - Guarantor - PLEDGER - Pledger - DEPOSITOR - Depositor - REPRESENTATIVE - Client Representative - BENEFICIARY - Beneficiary - BENEFICIAL_OWNER - Beneficial Owner
"BENEFICIAL_OWNER""BENEFICIARY""BORROWER""COBORROWER""DEPOSITOR""GUARANTOR""PLEDGER""REPRESENTATIVE"Comment
Additional documents
Unit ID
"int64"User ID
"int32"Creation date in YYYY-MM-DD format
"date"Current credit limit
"double"Maximum credit limit
"double""date"Are you a dependent? Well no
Number of dependents
"int32"Director
E-mail address
Number of employees
"int32"Date of termination of the relationship with the customer in the format YYYY-MM-DD
"date"Faculty
Fax
Name
Foreign organization code
Registration number in the country of registration
Organization name in a foreign language
Group id
"int64"Identifier of an entry in the directory "Position of the head"
"int64"University
Home telephone number in digital form in international format (e.g. 74951001112, 37369123456)
ID of the entry in the directory "How did you hear about us?"
"int64"Client ID. When creating a new client, null is written, the number is assigned automatically
"int64"Even list Yes / No
On the email list
Red List Yes / No
In the SMS mailing list Yes / No
Investor Yes / No
Client join date in YYYY-MM-DD format
"date"The manager acts on the basis
Checkpoint. Field for a client-legal entity
"int32"Surname
Old name in Latin
Old surname in Latin
Old patronymic in Latin
Reason for termination of membership
"int64"Organizational and legal form
Document confirming the right to stay on the territory of the Russian Federation
Loan payments
"double"Maiden name
ID of an entry from the "Loan Specialist" directory
"int64"Marital Status Identifier - 101151 - SINGLE - 101152 - MARRIED - 101153 - DIVORCED ( Divorced / Divorced) - 101154 - WIDOW (Widow / Widow) - 101155 - CIVIL_MARRIAGE (Civil marriage)
"int64"Average monthly income
"double"Migration card
Is your mobile phone number registered to you?
Mobile phone number in digital form in international format (e.g. 79031001112, 37369123456)
Monthly income for 2NDFL
"double"Average monthly pension
"double"Monthly net profit
"double"SME (Small / Medium Enterprise)
Natural person attribute Yes / No
OKATO
OKFS
OKOGU
OKOPF
OKTMO
OKVED
Old name
Old surname
Old passport
Old patronymic
Initial experience (before joining the program) in months:
"int32"The passport
middle name
"int64"Customer accounts
Founders
Income
List of relatives
Personal account
Data processing consent flag Yes / No
Date of consent to data processing in YYYY-MM-DD format
"date"Pin
Rating
"APPROVE""DENY""GOOD""MEDIUM""TECH_FAULT""UNDEFINED""VALIDATION_ERROR"Rating date in YYYY-MM-DD format
"date"Registration address (for legal entities Legal address)
OGRNIP
Rental income
"double"Resident Yes / No
INN
Role ID
"int64"Current loans and borrowings
Gender
"int64"Shareholder
Abbreviated name of the organization
SMS history
SNILS
Form of study
Year of graduation
OKPO code (for legal entities)
Name of company
Validity - month
Validity - year
Work place information
"error""ok""int64"