Текущая версия от 09:20, 16 июня 2023
В данной статье описывается принцип работы сервиса Get_LRF (далее - Сервис) посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.
Целью использования Сервиса является:
- расчет универсального коэффициента убыточности по ИИН клиента;
- содействие участникам финансового рынка в их деятельности, сохранении стабильности и развития финансового сектора Республики Казахстан.
Сервис получения данных из ЕСБД
При вызове веб-сервиса обязательно указываются следующие параметры:
1. Отличительное имя пользователя и пароль (организации) в Body, необходимые для базовой аутентификации.
2. Отличительное имя пользователя, от имени которого будет выполнена запрашиваемая операция в SOAP Body:
SOAP Message: [Показать ответ]
1. <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:mkb="https://icweb/mkbWsExecute">
2. <soapenv:Header/>
3. <soapenv:Body>
4. <mkb:AuthenticateUser>
5. <mkb:aName> Имя пользователя </mkb:aName>
6. <mkb:aPassword> Пароль </mkb:aPassword>
7. </mkb:AuthenticateUser>
8. </soapenv:Body>
9. </soapenv:Envelope>
Метод Execute
Сервис Get_LRF работает через метод Execute.
Метод Execute предназначен для выполнения методов интеграционной службы ЕСБД. Входными параметрами данного метода являются: [Показать ответ]
1. <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:mkb="https://icweb/mkbWsExecute">
2. <soapenv:Header/>
3. <soapenv:Body>
4. <mkb:Execute>
5. <mkb:aSessionId> Сессия </mkb:aSessionId>
6. <mkb:aRequest>
7. <mkb:Type> Наименование сервиса </mkb:Type>
8. <mkb:Version>1</mkb:Version>
9. <mkb:Body> Закодированный запрос в формате base64</mkb:Body>
10. <mkb:Parameters>0</mkb:Parameters>
11. </mkb:aRequest>
12. <mkb:consent_bool>1</mkb:consent_bool>
13. </mkb:Execute>
14. </soapenv:Body>
15. </soapenv:Envelope>
Ответ данных метода: [Показать ответ]
1. <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
2. <soap:Body>
3. <ExecuteResponse xmlns="https://icweb/IICWebService">
4. <ExecuteResult>
5. <ResultCode>0</ResultCode>
6. <Body>Ответ в закодированном формате base64</Body>
7. </ExecuteResult>
8. </ExecuteResponse>
9. </soap:Body>
10. </soap:Envelope>
Сервис Get_LRF
Сервис Get_LRF возвращает расчет универсального коэффициента убыточности. Выплаты учитываются в расчетах только если клиент не является Выгодоприобретателем (клиент является виновником).
Состав данных запроса по сервису Get_LRF: [Показать ответ]
| №
|
Наименование
|
Формат
|
Поле
|
Обязательность
|
Примечание
|
| 1
|
ИИН/БИН
|
xs:int
|
iinBin
|
Да
|
Значение должно содержать 12 цифр
|
| 2
|
Переменный v1
|
xs:float
|
v1
|
Нет
|
Коэффициент
|
| 3
|
Переменный v2
|
xs:int
|
v2
|
Нет
|
Сумма выплата
|
| 4
|
Переменный v3
|
xs:int
|
v3
|
Нет
|
Сумма выплата
|
Состав данных ответа на запрос сервиса Get_LRF: [Показать ответ]
| №
|
Наименование
|
Формат
|
Поле
|
Обязательность
|
Примечание
|
| 1
|
Ответ
|
Get_LRF
|
xs:string
|
Да
|
Расчет универсального коэффициента убыточности
|
Пример запроса на вызов сервиса Get_LRF имеет следующий вид: [Показать ответ]
1. <request>
2. <iinBin>ИИН/БИН субъекта</iinBin>
3. <v1>Коэффициент</v1>
4. <v2> Сумма выплат</v2>
5. <v3> Сумма выплат </v3>
6. </request>
Пример ответа на вызов сервиса Get_LRF имеет следующий вид: [Показать ответ]
1. <response>Расчет универсального коэффициента убыточности </response>
Пример ответа на вызов сервиса Get_LRF с помощью SOAPUI запроса в случае, если передан некорректный ИИН, имеет следующий вид: [Показать ответ]
1. <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
2. <soap:Body>
3. <ExecuteResponse xmlns="https://icweb/IICWebService">
4. <ExecuteResult>
5. <ResultCode>1</ResultCode>
6. <ErrorMessage>ORA-20029: ORA-20001: Неверный ИИН
7. ORA-06512: at "IIC.PKG_WS_REP", line 278
8. ORA-06512: at "IIC.PKG_WEBSERVICE", line 1008
9. ORA-06512: at "IIC.PKG_WEBSERVICE", line 1020
10. ORA-06512: at line 1</ErrorMessage>
11. </ExecuteResult>
12. </ExecuteResponse>
13. </soap:Body>
14. </soap:Envelope>