18-07-2022 14:19

Расчет суммы задолженности для текущего или досрочного погашения

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]

Общая сумма платежа