Skip to content

Creating a new loan application

POST

The creation of a Loan Application using the parameters of the selected loan product in the Loan Application should be carried out in the following order:

  1. Initialization of an application using the " Initialization of a new application for a loan " method.

  2. Adding a loan product to the application initialized in the previous step using the method " Automatically adding a loan product to the application ".

-> 3. Enter the value of the parameters "clientId" - the client's identifier, "creationDate" - the date the order was created, "currencyId" - the currency identifier and "loanAmount" - the amount of the order. If necessary, you can replace other product parameters: fields affecting the loan term: number of tranches, duration of the period with m / y repayments, interest rates, as well as the value of the gettingMoneyMethodId field (possible values ​​can be obtained using the " Methods of obtaining a loan ").

Creating an order using the current method. (In fact, saving the received / filled data to create a Loan Application in the previous steps). When creating an application, a lead will be created automatically

Request Body

application/json
object

Activity Subtype ID

Format"int64"

Age

Client's place of contact

KB Scoring

Format"double"

Client ID

Format"int64"
object[]

Co-Borrower

Format"int64"

Id

Format"int64"
integer[]

Collateral ID

Format"int64"
Format"int64"
Format"double"

Date of the agreement

Format"date"
Format"int64"

Contract name. This field is filled in if you need to know the contract number at the application stage, when the contract itself is not yet available

Format"int32"
Format"int64"

Creation date in milliseconds

Format"date-time"
object

Loan conditions

Format"double"

Do not carry over from holidays and weekends (Yes / No)

Possibility of repayment before maturity upon auto-acceptance (Yes / No)

Format"double"

the first day of accrual of additional interest on overdue fixed assets

Format"int32"

last day of accrual of additional interest on overdue fixed assets

Format"int32"

charge additional interest on overdue fixed assets (as a separate type of amount)

accrue interest on the day the contract is issued (in this case, interest is accrued on both the first and last days of the tranche)

Accrue interest on overdue fixed assets (Yes / No)

Penalty on calendar days (Yes / No)

Accrue interest at the end of the loan term (Yes / No)

Credit line type

Format"int64"

Method for calculating dates

Format"int64"

Day of delay for calculating late penalties

Format"int32"
Format"int32"

Number of days before switching to a rate in case of delay. If the delinqIntRateDelay field has a value of 0, then the interest rate in case of delay is used from the first day of interest accrual on the tranche (if there is a delay in the previous tranches), otherwise, the usual interest rate will continue to operate from the beginning of the tranche for the specified number of days

Format"int32"

Interest rate on delay

Format"double"

Discounting activated

Early renewal from the current date (Yes / No) (otherwise, prolongation from the end date of the current tranche)

Format"int32"
object[]

Fees

Do not charge first weekend penalties

Late Penalty (Fixed Amount)

Format"double"

Prepayment offset method

Format"int64"

Full shift of the schedule from the actual date of issue (Yes / No)

Loan product identifier

Format"int64"

rate in the first period

Format"double"

rate in the second period

Format"double"
Format"int64"

Interest method

Format"int64"

Interest rate

Format"double"

Grace period (without interest accrued for this period)

Format"int32"

Deferred grace period (in days)

Format"int32"
Format"double"

Calculate percentage of the amount in the contract

object[]

Interest rate type

Format"int64"

Percentage of the issue amount (by which we determine whether to consider it as a friend)

Format"double"

Reduced interest rate for each friend

Format"double"

Minimum interest rate

Format"double"
Format"int32"

Mandatory interest period

Format"int32"
Format"double"
Valid values"LOAN_AMOUNT_PERCENTAGE_PER_YEAR"
Format"double"
Valid values"FROM_DELINQUENCY_START_BY_STATUS""FROM_TRANCHE_REPAYMENT_DATE"
object[]

Penalty rates

Type of fines calculation

Format"int64"
Format"int64"
object[]

Parts of the principal

Prolongation period (Specified in days)

Format"int32"

Number of days after the end of the schedule until the fines stop

Format"int32"

number of tranches in the first period

Format"int32"

Number of tranches to calculate the second period repayment rate. Now it makes sense to display this field only when the interest calculation method is selected (parameter interestCalcMethodId) Remaining with two rates (101226). If this field is greater than zero, then when calculating the schedule for the second period, the repayment rate is calculated based on the specified number of tranches, the calculated repayment rate is stored in the contract

Format"int32"

number of tranches in the second period

Format"int32"

Maturity rate

Format"double"

Order of repayment

Format"int64"

To recalculate the schedule to the budget billing date (Yes / No)

Shift the date of the first repayment to the next business day when calculating

Control of short-term (adjusting the date of the last repayment so that the term of the contract does not exceed 1 year)

Stop penalties after the end of the schedule (Yes / No)

Number of tranches

Format"int32"

The length of the period between redemptions

Format"int32"

Use the interest rate on arrears to calculate the UCI.

If the contract under this field is YES, and the interest rate on arrears is not zero, then when calculating the UCI for the contract, a schedule is created taking into account the interest rate for arrears and UCI is calculated from this schedule

Return to regular interest rate from the next tranche after the delay is repaid. If the useDelinqIntRateTillNextTranche field = YES (true), then the return to the regular rate after the delay is repaid will be from the beginning of the next tranche, if NO (false) - from the next day after the delay is repaid

Use EPS for discounting (instead of CPM)

Loan product identifier

Format"int64"

Name of the loan product

Format"int64"
Format"int64"

Order currency identifier

Format"int64"
Format"double"

The validity period of the SBOF decision

Format"date"

The number of user's social friends networks

Format"double"

How to receive money

Format"int64"

Links to groups from social. chains (maximum 100 pcs.)

List of social groups chains (maximum 100 pcs.)

Co-Borrowers Id

Format"int64"

Down payment

Format"double"

IP address

object[]

Issuance stages

Amount of issue

Format"double"

Date of issue

Format"date"

Identifier

Format"int64"
Format"int64"

Financial position identifier

Format"int64"

Loan amount

Format"double"

Refusal reason identifier

Format"int64"

Loan grade

Format"int32"

Loan type identifier

Format"int64"

Chief Loan Officer

Format"int64"

Link to the main photo from the social. networks

Loan Specialist

Format"int64"
Format"int64"
Format"int64"
Format"double"
Format"double"

Application code

Format"int64"
Format"int64"
object[]
Format"double"
Format"int64"

Client Premium

Format"double"

Repeated loan

Format"int64"
object
Format"double"

Do not carry over from holidays and weekends (Yes / No)

Possibility of repayment before maturity upon auto-acceptance (Yes / No)

Format"double"

the first day of accrual of additional interest on overdue fixed assets

Format"int32"

last day of accrual of additional interest on overdue fixed assets

Format"int32"

charge additional interest on overdue fixed assets (as a separate type of amount)

accrue interest on the day the contract is issued (in this case, interest is accrued on both the first and last days of the tranche)

Accrue interest on overdue fixed assets (Yes / No)

Penalty on calendar days (Yes / No)

Accrue interest at the end of the loan term (Yes / No)

Credit line type

Format"int64"

Method for calculating dates

Format"int64"

Day of delay for calculating late penalties

Format"int32"
Format"int32"

Number of days before switching to a rate in case of delay. If the delinqIntRateDelay field has a value of 0, then the interest rate in case of delay is used from the first day of interest accrual on the tranche (if there is a delay in the previous tranches), otherwise, the usual interest rate will continue to operate from the beginning of the tranche for the specified number of days

Format"int32"

Interest rate on delay

Format"double"

Discounting activated

Early renewal from the current date (Yes / No) (otherwise, prolongation from the end date of the current tranche)

Format"int32"
object[]

Fees

Do not charge first weekend penalties

Late Penalty (Fixed Amount)

Format"double"

Prepayment offset method

Format"int64"

Full shift of the schedule from the actual date of issue (Yes / No)

Loan product identifier

Format"int64"

rate in the first period

Format"double"

rate in the second period

Format"double"
Format"int64"

Interest method

Format"int64"

Interest rate

Format"double"

Grace period (without interest accrued for this period)

Format"int32"

Deferred grace period (in days)

Format"int32"
Format"double"

Calculate percentage of the amount in the contract

object[]

Interest rate type

Format"int64"

Percentage of the issue amount (by which we determine whether to consider it as a friend)

Format"double"

Reduced interest rate for each friend

Format"double"

Minimum interest rate

Format"double"
Format"int32"

Mandatory interest period

Format"int32"
Format"double"
Valid values"LOAN_AMOUNT_PERCENTAGE_PER_YEAR"
Format"double"
Valid values"FROM_DELINQUENCY_START_BY_STATUS""FROM_TRANCHE_REPAYMENT_DATE"
object[]

Penalty rates

Type of fines calculation

Format"int64"
Format"int64"
object[]

Parts of the principal

Prolongation period (Specified in days)

Format"int32"

Number of days after the end of the schedule until the fines stop

Format"int32"

number of tranches in the first period

Format"int32"

Number of tranches to calculate the second period repayment rate. Now it makes sense to display this field only when the interest calculation method is selected (parameter interestCalcMethodId) Remaining with two rates (101226). If this field is greater than zero, then when calculating the schedule for the second period, the repayment rate is calculated based on the specified number of tranches, the calculated repayment rate is stored in the contract

Format"int32"

number of tranches in the second period

Format"int32"

Maturity rate

Format"double"

Order of repayment

Format"int64"

To recalculate the schedule to the budget billing date (Yes / No)

Shift the date of the first repayment to the next business day when calculating

Control of short-term (adjusting the date of the last repayment so that the term of the contract does not exceed 1 year)

Stop penalties after the end of the schedule (Yes / No)

Number of tranches

Format"int32"

The length of the period between redemptions

Format"int32"

Use the interest rate on arrears to calculate the UCI.

If the contract under this field is YES, and the interest rate on arrears is not zero, then when calculating the UCI for the contract, a schedule is created taking into account the interest rate for arrears and UCI is calculated from this schedule

Return to regular interest rate from the next tranche after the delay is repaid. If the useDelinqIntRateTillNextTranche field = YES (true), then the return to the regular rate after the delay is repaid will be from the beginning of the next tranche, if NO (false) - from the next day after the delay is repaid

Use EPS for discounting (instead of CPM)

Format"int64"

Links to selected photos with "Like" (maximum 100)

Links to selected photos with tagged people (maximum 100)

Store address

Format"int64"

Date of signing

Format"date"

Application number on the site

Social network (vk; ok; fb)

Format"double"

Number of the deferred tender application

Tender name

Tender number

Tender Notice Number

Site code

Valid values"LoanApplication""RentalApplication"

Social network user ID

Responses

OK

*/*
object
object

Activity subtype identifier , this link can be used to get "Activities", which in turn may contain activity subtypes

Format"int64"

Age

Client's place of contact

KB Scoring

Format"double"

Client ID

Format"int64"
object[]

Co-Borrowers

integer[]

Collateral ID

Format"int64"
Format"double"

Date of the agreement

Format"date"
Format"int64"

Contract name. This field is filled in if you need to know the contract number at the application stage, when the contract itself is not yet available

Format"int32"
Format"int64"

ID of the department where the ticket was created

Format"int64"

ID of the user who created the request

Format"int32"

Creation date in milliseconds

Format"date-time"
object

Loan conditions

Format"int64"
Format"int64"
Format"int64"
Format"int64"
Format"int64"

Current status. For the description see here

Format"int64"
Format"double"

The validity period of the SBOF decision

Format"date"

The number of user's social friends networks

Format"double"
Format"int64"

Links to groups from social. chains (maximum 100 pcs.)

List of social groups chains (maximum 100 pcs.)

Order ID. When creating a new application - not specified

Format"int64"

Down payment

Format"double"

IP address

object[]

Issuance stages. A collection linked to a loan application, not used for calculations, was introduced to generate printable forms in case the issuance is carried out in several stages (credit line)

Format"int64"

Loan amount

Format"double"
Format"int64"

Loan step.

The mechanism for setting loanStage is as follows:
The loanStage parameter is set to the value of the loanStage parameter (1, 2, 3 ... etc.). When creating a new application for a loan (if it is the first for this client), this field is filled with the value 1. If the application is approved, then in the contract this field will contain the value 1. When creating a new application for a loan for this client, this field will accordingly value 2 (step 2), provided that the first application for this client was approved.
Example:
an application with step 3 is created, the application goes to the decision making system (which will be pre-configured in the system), there an expression will be executed that will apply the loan product that corresponds to the loan tier

Format"int32"

Loan type identifier

Format"int64"

Regional Loan Manager. Implementation of a dealer network of stores

Format"int64"

Link to the main photo from the social. networks

Personal loan manager. Implementation of a dealer network of stores

Format"int64"
Format"int64"
Format"int64"
Format"double"
Format"double"

Application code

Format"int64"
Format"int64"
object[]

Client Premium. Implementation of a dealer network of stores

Format"double"

Repeated loan. Implementation of a dealer network of stores

Format"int64"
object
Format"int64"

Links to selected photos with "Like" (maximum 100)

Links to selected photos with tagged people (maximum 100)

Shop address identifier. Implementation of a dealer network of stores

Format"int64"

Date of signing

Format"date"

Application number on the site

Social network (vk; ok; fb)

Format"double"

Number of the deferred tender application

Tender name

Tender number

Tender Notice Number

Site code

Valid values"LoanApplication""RentalApplication"

Social network user ID

Valid values"error""ok"
Format"int64"