В данной статье описывается сервис АО «Государственное кредитное бюро» (далее - ГКБ) по получению коэффициента долговой нагрузки из базы данных кредитных историй (далее - Сервис), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.
Общая часть
Расчет КДН осуществляется по формуле: [Показать ответ]
где,
КДН - коэффициент долговой нагрузки;
ПНЗi - ежемесячный платеж по непогашенному займу (непогашенным займам) субъекта;
ППі - сумма просроченных платежей по непогашенному займу (непогашенным займам) субъекта;
n - количество непогашенных займов субъекта;
Д - средний ежемесячный доход субъекта, передаваемый Получателем.
При расчете КДН учитываются обязательства по контрактам в Базе данных кредитных историй ГКБ (далее - БДКИ), в которых субъект кредитной истории указан только в ролях «Заемщик», «Арендатор», «Содолжник с солидарной ответственностью», «Должник с субсидиарной ответственностью» либо «Должник с долевой ответственностью», при этом:
1. Обязательства по контрактам субъекта кредитной истории в роли «Заемщик» принимаются в расчет в полном объеме;
2. Обязательства по контрактам субъекта кредитной истории в роли «Содолжник с солидарной ответственностью», «Должник с субсидиарной ответственностью» либо «Должник с долевой ответственностью» принимаются в расчет в соответствии с Индексом созаемщика.
Сервис по получению КДН субъекта кредитной истории
Сервис предназначен для получения КДН субъекта кредитной истории.
При вызове веб-сервиса обязательно указываются следующие параметры:
1. ID и пароль клиента (организации) в HTTP Header, необходимые для базовой аутентификации. Так как коммуникация с веб-сервисами системы идет по защищенному протоколу HTTPS, то базовая аутентификация представляется безопасным решением.
2. ID пользователя, от имени которого будет выполнена запрашиваемая операция в SOAP Header:
Http Headers: {Authorization=[Basic c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2]}
SOAP Message: [Показать ответ]
1. <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:deb="http://debtRatio.chdb.scb.kz" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
2. <soapenv:Header>
3. <userId>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</userId>
4. </soapenv:Header>
5. <soapenv:Body>
6. <getDebtCapacityRatio/>
7. </soapenv:Body>
8. </soapenv:Envelope>
где c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2 - есть значение HTTP Header, представляющее собой ID клиента и его пароль в формате «clientId:password» и кодировке Base64 как того требует механизм Basic Authentication.
Метод getDebtCapacityRatio
Метод getDebtCapacityRatio возвращает цифровое значение КДН и максимальное количество дней просрочки. Максимальное количество дней просрочки по всем непогашенным займам возвращается в случае наличия у субъекта кредитной истории просрочки по непогашенным займам свыше 90 дней.
Состав данных запроса на получение информации по КДН (debtRatioRequest): [Показать ответ]
| № |
Поле |
Наименование |
Тип
|
Примечание
|
| 1
|
userId
|
Идентификационный номер пользователя
|
xs:string
|
|
| 2
|
iin
|
ИИН субъекта
|
xs:long
|
|
| 3
|
averageMonthlyIncome
|
Средний ежемесячный доход субъекта
|
xs:decimal
|
|
| 4
|
coBorrowerIndex
|
Индекс созаемщика
|
xs:int
|
1 - "100%",
2 - "50%",
3 - "0%"
|
| 5
|
consentConfirmed
|
согласие субъекта
|
xs:boolean
|
1-да 0-нет
|
Состав данных ответа на запрос информации по КДН (debtRatioResponse): [Показать ответ]
| № |
Поле |
Наименование |
Тип
|
Примечание
|
| 1
|
debtRatio
|
Цифровое значение КДН
|
xs:decimal
|
|
| 2
|
maxPaymentDaysOverdue
|
Максимальное количество дней просрочки
|
xs:int
|
Возвращается в случае наличия у субъекта кредитной истории просрочки по непогашенным займам свыше 90 дней.
|
| 3
|
billingNumber
|
Номер биллинга
|
xs:long
|
|
| 4
|
debtRatioType
|
Тип запроса КДН
|
xs:string
|
Возвращается в том случае, если субъект не найден.
|
Примеры вызова и ответа на вызов метода getDebtCapacityRatio
В параметрах debtRatioRequest передаются поисковые данные (входные параметры), по которым осуществляется поиск субъекта. Если субъект будет найден, то будет сформирован требуемый ответ. Если будет найдено несколько субъектов или требуемый субъект не будет найден, то будет сформирована ошибка. Ниже приведены пример вызова метода getDebtCapacityRatio, а также пример ответа на вызов.
Пример вызова метода: [Показать ответ]
1. <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:deb="http://debtRatio.chdb.scb.kz">
2. <soapenv:Header>
3. <!-- Передается UserID -->
4. <userId>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</userId>
5. </soapenv:Header>
6. <soapenv:Body>
7. <deb:getDebtCapacityRatio>
8. <debtRatioRequest>
9. <!-- Передается ИИН субъекта: -->
10. <iin>ИИН субъекта</iin>
11. <!-- Передается Средний ежемесячный доход субъекта -->
12. <averageMonthlyIncome>100000.00</averageMonthlyIncome>
13. <!-- Передается Индекс созаемщика -->
14. <coBorrowerIndex>3</coBorrowerIndex>
15. <consentConfirmed>1</consentConfirmed>
16. <subjectParams/>
17. </debtRatioRequest>
18. </deb:getDebtCapacityRatio>
19. </soapenv:Body>
20. </soapenv:Envelope>
Пример ответа на запрос вызова метода: [Показать ответ]
1. <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2. <SOAP-ENV:Header xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
3. <userId>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</userId>
4. <creditorId>xxx</creditorId>
5. <timestamp>1569833020075</timestamp>
6. </SOAP-ENV:Header>
7. <soap:Body>
8. <ns2:getDebtCapacityRatioResponse xmlns:ns2="http://debtRatio.chdb.scb.kz">
9. <debtRatioResponse>
10. <debtRatio>1.16</debtRatio>
11. <maxPaymentDaysOverdue>190</maxPaymentDaysOverdue>
12. <billingNumber>178484</billingNumber>
13. </debtRatioResponse>
14. </ns2:getDebtCapacityRatioResponse>
15. </soap:Body>
16. </soap:Envelope>
Примеры вызова и ответа на вызов метода getDebtCapacityRatio
Веб-сервис по получению КДН может возвращать следующие виды ошибок: [Показать ответ]
1. ScbBusinessFault - бизнес-ошибки
ScbBusinessFault - это предсказуемые ошибки, связанные, как правило, с бизнес-логикой работы ПО БДКИ. Например, бизнес-проверки, проверки безопасности, данные не найдены и т.д.
| Код ошибки
|
Описание ошибки
|
Примечание
|
| SBF-VE-8
|
Номер "ИИН" должен содержать 12 цифр.
|
|
| VAL-JSR-001
|
Обязательное поле "%s" отсутствует.
|
|
| SBF-IC-1
|
Ошибка в процессе генерации отчета. Более одного субъекта найдено по данному запросу.
|
|
| BR-DR-3
|
Средний ежемесячный доход субъекта кредитной истории должно быть больше 0.
|
|
| BR-DR-1
|
Индекс созаемщика могут быть введены только значения 1 - "100%", 2 - "50%" или 3 - "0%".
|
|
2. ScbSystemFault - системные ошибки
ScbSystemFault - это непредвиденные ошибки, которые могут возникнуть при работе ПО БДКИ. Например, ошибки подключения к каким-то ресурсам, сетевые ошибки, ошибки недостаточности памяти и т.д.
| Наименование ошибки
|
Тип ошибки
|
Описание ошибки
|
| faultCode
|
xs:string
|
Код ошибки
|
| faultDescription
|
xs:string
|
Описание ошибки
|
| faultId
|
xs:string
|
Уникальный идентификатор ошибки
|
| faultTimestamp
|
xs:dateTime
|
Дата, время ошибки
|
| faultType
|
xs:string
|
Тип ошибки
ScbBusinessFault:
DATA_NOT_FOUND
FILE_NOT_FOUND
ACCESS_DENIED
VALIDATION_ERROR
INTEGRITY_CHECK
CONCURRENT_MODIFICATION
ScbSystemFault:
DATABASE_ERROR
HTTP_CONNECTION_PROBLEM
LDAP_CONNECTION_PROBLEM
JMS_CONNECTION_PROBLEM
FILE_IO_ERROR
PROGRAMMATIC_ERROR
UNEXPECTED_INTERNAL_ERROR
|
