API Documentation - Инициализация новой заявки на займ

03-12-2018 23:59

Инициализация новой заявки на займ

GET /bs-core/main/loan-apps/init/client-id/{clientId}

Инициализация новой заявки на займ для последующего заполнения полей и сохранения. Заявка инициализируется по указанному Id клиента.

Существует следующий процесс создания заявки с определенным кредитным продуктом:

--> 1. Инициализация заявки методом "Инициализация новой заявки на займ". Полученый ответ копируем и вставляем в тело запроса следующего метода, описанного в следующем шаге.

2. Добавление кредитного продукта, в инициализированную в предыдущем шаге заявку, при помощи метода "Автоматическое добавление кредитного продукта в заявку".

3. Создание заявки методом "Создание новой заявки на займ".

Запрос

GET /bs-core/main/loan-apps/init/client-id/101321923 HTTP/1.1

Описание параметров
Нет описанных параметров

Ответ


                        {
    "status": "ok",
    "timestamp": 1508161164944,
    "data": {
        "id": null,
        "name": null,
        "creationDate": 1508161164915,
        "clientId": 101322764,
        "activitySubtypeId": 1014167,
        "loanTypeId": 101531,
        "loanStage": 5,
        "liabilityId": 101931,
        "creditProductId": null,
        "creditProductName": "",
        "creditFieldReq": {
            "id": null,
            "dateCalcMethodId": null,
            "allowHolidaysPayment": false,
            "shortTermControl": false,
            "interestChargeMethodId": null,
            "interestCalcMethodId": null,
            "repaymentNorm": 0,
            "calcIntOnIssueDate": false,
            "calcInterestOnDelinqBalance": false,
            "calcArrearInterest": false,
            "arrearInterestFirstDay": 1,
            "arrearInterestLastDay": 9999,
            "principalDistribMethodId": null,
            "forepaymentConsiderationMethodId": null,
            "creditLineId": null,
            "trancheDuration": 0,
            "interestForTranche": 0,
            "delinquencyIntRate": 0,
            "interestRateTypeId": null,
            "chargeExtraInterest": false,
            "interestFreePeriod": 0,
            "interestGracePeriod": 0,
            "trancheCount": 0,
            "repaymentSequenceId": null,
            "verticalSequenceForDelinqOnly": false,
            "mandatoryChargePeriod": 0,
            "allowPrepayment": false,
            "prolongationPeriod": 0,
            "earlyProlongationFromCurrentDate": false,
            "penaltyTypeId": null,
            "calendarDaysPenalty": false,
            "firstWeekendWithoutPenalty": false,
            "stopPenaltyOnClose": false,
            "qtyDaysStopPenaltyOnClose": 0,
            "fixedDelayPenalty": 0,
            "delayPenaltyDay": 1,
            "inviteAmountPct": 0,
            "inviteDiscountPerFriend": 0,
            "inviteMinIntRate": 0,
            "scheduleRecalcEnabled": false,
            "fullScheduleDatesRecalc": false,
            "discountingEnabled": false,
            "fees": [
                {
                    "id": 10254442,
                    "amountTypeId": 101293,
                    "chargeMomentId": 101032,
                    "valueTypeId": 102522,
                    "chargeBaseId": 102531,
                    "value": 3,
                    "compositeValue": "1",
                    "chargePenalty": false,
                    "notForCharge": false,
                    "notForRepayment": false,
                    "involvedInFullCostCalc": true
                }
            ],
            "principalParts": [
                {
                    "id": 101614343,
                    "trancheNo": 1,
                    "part": 100
                }
            ],
            "penaltyRates": [
                {
                    "id": 101621833,
                    "periodBegin": 1,
                    "periodEnd": 9999,
                    "principalRate": 0.05,
                    "interestRate": 0.05,
                    "feeRate": 0.05
                }
            ],
            "qtyTranchesFirstPeriod": 0,
            "intRateFirstPeriod": 0,
            "qtyTranchesSecondPeriod": 0,
            "intRateSecondPeriod": 0,
            "interestOnLoanAmount": false
        },
        "currencyId": 101011,
        "loanAmount": 0,
        "loanDeniedRejectionId": null,
        "creditPurposeId": 101682,
        "managerId": null,
        "mainManagerId": null,
        "contractName": 0,
        "collateralIds": [],
        "coborrowers": [],
        "issueSteps": [],
        "gettingMoneyMethodId": null,
        "bureauScoringPoint": 0,
        "siteName": "",
        "ipAddress": "",
        "applyPlace": "",
        "socialNetwork": "",
        "userIDinSocialNetwork": "",
        "friendsQuantityInSocialNetwork": "",
        "mainPhotoLinkOnSocialNetwork": "",
        "selectedPhotosLinksWithLike": "",
        "selectedPhotosLinksWithMarkedPersons": "",
        "groupsListFromSocialNetworks": "",
        "groupsLinksofFromSocialNetworks": "",
        "age": "",
        "tenderName": null,
        "tenderNo": null,
        "tenderNoticeNo": null,
        "tenderDelayedAppNo": null,
        "tenderPlatformCode": null,
        "repeatedLoan": false,
        "premiumLoan": false,
        "shopAddressId": null,
        "conclusionDate": null,
        "initialInstallment": 0
    }
}

Описание параметров

Параметр	Обязателен	Тип данных	Описание
id	R	[int]	Идентификатор заявки. При создании новой заявки - не указывается
name	R	[string][50]	Код заявки
creationDate	R	[date]	Дата создания в миллисекундах
clientId	R	[int]	Идентификатор клиента
activitySubtypeId	R	[int]	Идентификатор подтипа деятельности
loanTypeId	R	[int]	Идентификатор типа займа
loanStage	R	[int]	Ступень займа
liabilityId	R	[int]	Идентификатор финансового положения
creditProductId	R	[int]	Идентификатор кредитного продукта
creditProductName	R	[string][250]	Наименование кредитного продукта
creditFieldReq	R	[object]	Условия кредита
creditFieldReq.id	R	[int]	Идентификатор кредитного продукта
creditFieldReq.dateCalcMethodId	R	[int]	Метод расчета дат
creditFieldReq.allowHolidaysPayment	R	[bool]	Не переносить с праздников и выходных
creditFieldReq.shortTermControl	R	[bool]	Контроль краткосрочности займа
creditFieldReq.interestChargeMethodId	R	[int]	Метод начисления процентов
creditFieldReq.interestCalcMethodId	О	[int][20]	Метод расчета процентов
creditFieldReq.repaymentNorm	R	[float]	Норма погашения
creditFieldReq.calcIntOnIssueDate	R	[bool]	Начислять проценты в день выдачи контракта (в этом случае проценты начисляются и на первый и на последний день транша)
creditFieldReq.calcInterestOnDelinqBalance	R	[bool]	Начислять процента на просроченную ОС
creditFieldReq.calcArrearInterest	R	[bool]	Начислять доп. проценты на просроченную ОС (отдельным видом суммы)
creditFieldReq.arrearInterestFirstDay	R	[int]	первый день начисления доп.процентов на просроченную ОС
creditFieldReq.arrearInterestLastDay	R	[int]	последний день начисления доп.процентов на просроченную ОС
creditFieldReq.principalDistribMethodId	О	[int][20]	Метод распределения основной суммы
creditFieldReq.forepaymentConsiderationMethodId	R	[int]	Метод зачета предоплаты
creditFieldReq.creditLineId	R	[int]	Тип кредитной линии
creditFieldReq.trancheDuration	R	[int]	Длительность периода между погашениями
creditFieldReq.interestForTranche	R	[float]	Процентная ставка
creditFieldReq.delinquencyIntRate	R	[float]	Процентная ставка при просрочке
creditFieldReq.interestRateTypeId	R	[int]	Тип процентной ставки
creditFieldReq.chargeExtraInterest	R	[bool]	Начислять проценты по окончанию срока кредита
creditFieldReq.interestFreePeriod	R	[int]	Беспроцентный период в днях
creditFieldReq.interestGracePeriod	R	[int]	Беспроцентный льготный период (в днях)
creditFieldReq.trancheCount	R	[int]	Количество траншей
creditFieldReq.repaymentSequenceId	R	[int]	Порядок погашения
creditFieldReq.verticalSequenceForDelinqOnly	R	[bool]	Погашать вертикально только просроченные транши
creditFieldReq.mandatoryChargePeriod	R	[int]	Период обязательного начисления процентов
creditFieldReq.allowPrepayment	R	[bool]	Возможно погашение до срока при автоакцепте
creditFieldReq.ProlongationPeriod	R	[int]	Срок пролонгации
creditFieldReq.earlyProlongationFromCurrentDate	R	[bool]	Досрочная пролонгация с текущей даты (иначе пролонгация с даты окончания текущего транша)
creditFieldReq.penaltyTypeId	R	[int]	Вид начисления штрафов
creditFieldReq.calendarDaysPenalty	R	[bool]	Штраф по календарным дням
creditFieldReq.firstWeekendWithoutPenalty	R	[bool]	Первые выходные штрафы не начислять
creditFieldReq.stopPenaltyOnClose	R	[bool]	Останавливать штрафы после окончания графика
creditFieldReq.qtyDaysStopPenaltyOnClose	R	[int]	Кол-во дней после окончания графика до остановки штрафов
creditFieldReq.fixedDelayPenalty	R	[float]	Штраф за опоздание (Фиксированная сумма)
creditFieldReq.delayPenaltyDay	R	[int]	День просрочки для начисления штрафа за опоздание
creditFieldReq.inviteAmountPct	R	[float]	Процент от суммы выдачи (по которому определяем считать ли другом)
creditFieldReq.inviteDiscountPerFriend	R	[float]	Снижение процентной ставки за каждого друга
creditFieldReq.inviteMinIntRate	R	[float]	Минимальная процентная ставка
creditFieldReq.scheduleRecalcEnabled	R	[bool]	Перерасчет графика в дату планового платежа
creditFieldReq.fullScheduleDatesRecalc	R	[bool]	Полное смещение графика от фактической даты выдачи
creditFieldReq.discountingEnabled	R	[bool]	Дисконтирование активировано
creditFieldReq.fees	R	[collection]	Сборы
creditFieldReq.fees._.id	R	[int]	Идентификатор
creditFieldReq.fees._.amountTypeId	О	[int][20]	Вид суммы
creditFieldReq.fees._.chargeMomentId	R	[int]	Момент начисления
creditFieldReq.fees._.valueTypeId	R	[int]	Вид сбора
creditFieldReq.fees._.chargeBaseId	R	[int]	База начисления
creditFieldReq.fees._.value	R	[float]	Значение
creditFieldReq.fees._.compositeValue	R	[string][100]	Составная ставка
creditFieldReq.fees._.chargePenalty	R	[bool]	Штраф за просрочку
creditFieldReq.fees._.notForCharge	R	[bool]	Не начислять
creditFieldReq.fees._.notForRepayment	R	[bool]	Не погашать
creditFieldReq.fees._.involvedInFullCostCalc	R	[bool]	Участвует в расчете ПСК
creditFieldReq.principalParts	R	[collection]	Части основной суммы
creditFieldReq.principalParts._.id	R	[int]	Идентификатор транша
creditFieldReq.principalParts._.trancheNo	R	[int]	Порядковый номер транша
creditFieldReq.principalParts._.part	R	[float]	Доля основной суммы в процентах
creditFieldReq.penaltyRates	R	[collection]	Ставки штрафа
creditFieldReq.penaltyRates._.id	R	[int]	Идентификатор ставки
creditFieldReq.penaltyRates._.periodBegin	R	[int]	Начало периода начисления штрафов
creditFieldReq.penaltyRates._.periodEnd	R	[int]	Конец периода начисления штрафов
creditFieldReq.penaltyRates._.principalRate	R	[float]	Ставка на ОС
creditFieldReq.penaltyRates._.interestRate	R	[float]	Ставка на проценты
creditFieldReq.penaltyRates._.feeRate	R	[float]	Ставка на сбор
creditFieldReq.qtyTranchesFirstPeriod	R	[int]	Кол-во траншей в 1-м периоде
creditFieldReq.intRateFirstPeriod	R	[float]	Процентная ставка в 1-м периоде
creditFieldReq.qtyTranchesSecondPeriod	R	[int]	Кол-во траншей в 2-м периоде
creditFieldReq.intRateSecondPeriod	R	[float]	Процентная ставка в 2-м периоде
creditFieldReq.qtyTranchesRepNormSecondPeriod	О	[int][11]	Количество траншей для расчета нормы погашения второго периода. Это поле сейчас имеет смысл отображать только при выборе метода расчета процентов (параметр interestCalcMethodId) Остаточный с двумя ставками (101226). Если это поле больше нуля, то при расчете графика для второго периода рассчитывается норма погашения исходя из указанного кол-ва траншей, рассчитанная норма погашения сохраняется в контракте.
creditFieldReq.interestOnLoanAmount	R	[bool]	Рассчитывать проценты от суммы в контракте
currencyId	R	[int]	Идентификатор валюты заявки
loanAmount	R	[float]	Сумма займа
loanDeniedRejectionId	R	[int]	Идентификатор причины отказа
creditPurposeId	R	[int]	Идентификатор цели кредита
managerId	R	[int]	Cпециалист по займам
mainManagerId	R	[int]	Главный специалист по займам
contractName	R	[int]	Имя контракта. Данное поле заполняется, если нужно знать номер контракта на этапе заявки, когда самого контракта еще нет
collateralIds	R	[collection]	Идентификатор залогов
collateralIds._.*	R	[int]	Идентификатор залога
сoborrowers	R	[collection]	Созаемщики
сoborrowers	О	[]
сoborrowers._.id	R	[int]	Созаемщики Id
сoborrowers._.coborrowerId	R	[int]	ФИО созаемщика
issueSteps	R	[collection]	Этапы выдачи
issueSteps._.id	R	[int]	Идентификатор
issueSteps._.date	О	[date]	Дата выдачи
issueSteps._.amount	О	[float]	Сумма выдачи
issueSteps._.issueMethodId	О	[int][20]	Способ выдачи
gettingMoneyMethodId	О	[int][20]	Способ получения денег
bureauScoringPoint	О	[float]	Скоринговый балл КБ
siteName	О	[string][50]	Номер заявки на сайте
ipAddress	О	[string][50]	IP адрес
applyPlace	О	[string][150]	Место обращения клиента
socialNetwork	О	[string][100]	Социальная сеть (vk; ok; fb)
userIDinSocialNetwork	О	[string][50]	ID пользователя в социальной сети
friendsQuantityInSocialNetwork	О	[string][50]	Количество друзей пользователя в соц. сети
mainPhotoLinkOnSocialNetwork	О	[string][100]	Ссылка на основную фотографию из соц. сети
selectedPhotosLinksWithLike	О	[string][255]	Ссылки на отобранные фотографии с отметкой "Мне нравится" (максимум 100 шт.)
selectedPhotosLinksWithMarkedPersons	О	[string][255]	Ссылки на отобранные фотографии с отмеченными людьми (максимум 100 шт.)
groupsListFromSocialNetworks	О	[string][255]	Список групп из соц. сети (максимум 100 шт.)
groupsLinksofFromSocialNetworks	О	[string][255]	Ссылки на группы из соц. сети (максимум 100 шт.)
age	О	[string][25]	Возраст
tenderName	О	[string][150]	Название тендера
tenderNo	О	[string][100]	Номер тендера
tenderNoticeNo	О	[string][100]	Номер извещения тендера
tenderDelayedAppNo	О	[string][100]	Номер отложенной заявки тендера
tenderPlatformCode	О	[string][100]	Код площадки
repeatedLoan	О	[bool]	Повторный займ
premiumLoan	О	[bool]	Клиент Премиум
shopAddressId	О	[int][20]	Адрес магазина
conclusionDate	О	[date]	Дата заключения соглашения
signingDate	О	[date]	Дата подписания
decisionExpDate	О	[bool]	Срок действия решения СБОФ
initialInstallment	О	[float]	Первоначальный взнос