Расчет суммы задолженности для текущего или досрочного погашения
POST   /bs-core/reports/contracts/{contractId}/estimated-payment/{date}/{isEarlyRepayment}
Расчет задолженности по текущему платежу или для полного досрочного погашения.
С помощью этого метода можно получить рассчитанные данные по задолженности на дату как для досрочного погашения, так и по сумме текущей задолженности.
1. Если в {isEarlyRepayment} передать true , то произойдет расчет задолженности для полного досрочного погашения (данный параметр нужно обязательно передавать с true/false значением, если не передать данный параметр в ответе по методу будет ошибка). В сумму задолженности войдут:
- Рассчитанная задолженность на дату по процентам, штрафам и др. видам сумм
- ОС до конца срока займа (т.е. включаются и все будущие транши)
-
2. Если false - то, выведется рассчитанная задолженность только по траншам, по которым дата погашения уже наступила, т.е.
если по графику даты платежей следующие:
10.09.17
10.10.17
10.11.17
10.12.17
делаем запрос на 20.10.17 , при том что контракт находится в просрочке, получаем задолженность по траншу 10.09.17 (ОС, %%, штрафы) и 10.10.17 (ОС, %%, включая штрафы начисленные по 20.10.17)
Не будут рассчитаны проценты за период с 11.10 по 20.10, так как дата платежа по ним еще не наступила, т.е. они еще не к погашению.
Если - необходимо получать рассчитанную сумму штрафов и процентов на текущую дату, то необходимо использовать метод в режиме {isEarlyRepayment} - "true". При этом учитывать задолженность по ОС будет выведена полностью.
Запрос
POST /bs-core/reports/contracts/101342184/estimated-payment/2022-07-18/false
Описание параметров
Параметр | Обязателен | Тип данных | Описание |
contractId | R | [int] | Идентификатор контракта. Параметр пути. |
date | R | [date] | Дата на которую происходит расчет суммы задолженности. Параметр пути. Формат YYYY-MM-DD например 2019-06-24. |
isEarlyRepayment | R | [string] | Рассчитать с учетом досрочного погашения. Параметр запроса. |
Ответ
{
"status": "ok",
"timestamp": 1658131374618,
"data": {
"date": "2022-07-18",
"principal": 0.0,
"interest": 923.66,
"fee": 0.0,
"stateDuty": 0.0,
"penalty": 3.19,
"otherRepayables": 0.0,
"prForepayment": 0.0,
"intForepayment": 0.0,
"interestCalcDate": "2022-07-18",
"totalPaymentAmount": 926.85
}
}
Описание параметров
Параметр | Обязателен | Тип данных | Описание |
principal | О | [float] | ОС (основная сумма) |
interest | О | [float] | Проценты по основному долгу |
fee | О | [float] | Сборы |
stateDuty | О | [float] | Госпошлина |
penalty | О | [float] | Штрафы |
prForepayment | О | [float] | Предоплата по основному долгу. Возвращается позитивное значение. Для расчетов суммы задолженности это значение необходимо отнимать. |
intForepayment | О | [float] | Предоплата по процентам. Возвращается позитивное значение. Для расчетов суммы задолженности это значение необходимо отнимать. |
totalPaymentAmount | О | [float] | Общая сумма платежа |