Сервис «Банкротство физического лица сокращенная информация»: различия между версиями

Материал из Wiki ГКБ
Перейти к навигации Перейти к поиску
(Новая страница: «<center> {| width="auto" cellspacing="0" cellpadding="2" style="border:none;" | width="auto" valign="top"| | style="border-bottom:5px solid #20B2AA;font:110% Aria...»)
 
(нет различий)

Текущая версия от 08:40, 9 октября 2023

Главная страница Предыдущая страница


В данной статье описывается принцип работы сервиса ««Банкротство физического лица»» посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.


Описание сервиса БФЛ

Адреса web сервиса:
Тестовый сервис https://testws.mkb.kz/reportServices/PersonCreditDebtService?wsdl
Продуктивный сервис https://ws.mkb.kz/reportServices/PersonCreditDebtService?wsdl


При вызове веб-сервиса обязательно указываются следующие параметры:

1. Отличительное имя пользователя и пароль (организации) в HTTP Header, необходимые для базовой аутентификации. Так как коммуникация с веб-сервисами системы идет по защищенному протоколу HTTPS, то базовая аутентификация представляется безопасным решением.

2. Отличительное имя пользователя, от имени которого будет выполнена запрашиваемая операция в SOAP Header:

Http Headers: {Authorization=[Basic Отличительное имя пользователя]

SOAP Message: [Показать ответ] 
1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:rep="http://report.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>

где Отличительное имя пользователя - есть значение HTTP Header, представляющее собой ID оператора и его пароль в формате «clientId:password» и кодировке Base64 как того требует механизм Basic Authentication.


Состав данных запроса метода requestPersonCreditDebt

Состав данных запроса метода requestPersonCreditDebt [Показать ответ]


№ Наименование Поле Формат Обяза­тельность Примечание
Входные параметры запроса для получения отчета

(reportRequest)

1 Язык, на котором будет возвращена информация language xs:string Да Получение информации на языках: kk –Казахский, ru – Русский, en – Английский 
2 Формат отчета outputFormats xs:int Да Форматы отчетов: PDF, XML
3 Тип отчета reportType xs:int Да personDebtVerification - Персональный БФЛ– Физическое лицо (краткая форма)
Поисковые параметры запроса для получения отчета <reportParams>
4 ИИН субъекта iin xs:string Да Значение должно со­держать 12 цифр.


Пример вызова метода requestPersonCreditDebt с помощью SOAP запроса имеет следующий вид:

Пример вызова метода requestPersonCreditDebt с помощью SOAP запроса имеет следующий вид: [Показать ответ] 
1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:rep="http://report.chdb.scb.kz" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
2.	      <soapenv:Header>
3.	  <userId>Ваш userId</userId>
4.	   </soapenv:Header>
5.	   <soapenv:Body>
6.	      <rep:requestPersonCreditDebt>
7.	                <reportRequest>
8.	            <generationParams>
9.	               <language>язык</language>
10.	               <outputFormats>формат</outputFormats>
11.	               <reportType>тип</reportType>
12.	            </generationParams>
13.	            <reportParams xsi:type="rep:personCreditReportParams">
14.	                <iin>иин</iin>
15.	            </reportParams>
16.	         </reportRequest>
17.	      </rep:requestPersonCreditDebt>
18.	   </soapenv:Body>
19.	</soapenv:Envelope>


Пример успешного ответа на вызов метода requestPersonCreditDebt с помощью SOAP запроса имеет следующий вид:

Пример успешного ответа на вызов метода requestPersonCreditDebt с помощью SOAP запроса имеет следующий вид: [Показать ответ] 
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> Ваш userId </userId>
4.	      <creditorId>идентификатор кредитора</creditorId>
5.	      <timestamp></timestamp>
6.	   </SOAP-ENV:Header>
7.	   <soap:Body>
8.	      <ns2:requestPersonCreditDebtResponse xmlns:ns2="http://report.chdb.scb.kz">
9.	         <reportResponse>
10.	            <reportId>идентификатор отчета</reportId>
11.	            <reportContents>
12.	               <content>
13.	                  <xop:Include href="cid:f7ced2fd-2450-462d-93d5-151faa709813-6@cxf.apache.org" xmlns:xop="http://www.w3.org/2004/08/xop/include"/>
14.	               </content>
15.	               <filename>имя файла</filename>
16.	               <language>ru</language>
17.	               <outputFormat>PDF</outputFormat>
18.	               <size>размер</size>
19.	            </reportContents>
20.	            <reportContext>
21.	               <reportRequest>
22.	                  <generationParams>
23.	                     <language>язык</language>
24.	                     <onlySnmReport>false</onlySnmReport>
25.	                     <outputFormats>PDF</outputFormats>
26.	                     <reportType>тип отчета</reportType>
27.	                  </generationParams>
28.	                  <reportParams xsi:type="ns2:personCreditReportParams" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
29.	                     <formatXReport>false</formatXReport>
30.	                     <fromChdbUi>false</fromChdbUi>
31.	                     <new>false</new>
32.	                     <reportNumber>номер отчета</reportNumber>
33.	                     <withPawnshopInfo>false</withPawnshopInfo>
34.	                     <consentConfirmed>false</consentConfirmed>
35.	                     <personId>Идентификатор субъекта</personId>
36.	                  </reportParams>
37.	                  <isXmlBillable>true</isXmlBillable>
38.	                  <requestType>Автоматический</requestType>
39.	               </reportRequest>
40.	               <billable>false</billable>
41.	               <startDate>2023-01-19T11:35:39.629+06:00</startDate>
42.	               <data/>
43.	               <requestType>Автоматический</requestType>
44.	               <xmlReportContent><![CDATA[<kz.scb.credithistory.services.model.reports.individual.PersonDebtVerificationDto><kz.scb.credithistory.services.model.reports.individual.PersonDebtVerificationDto><header><updateDate>дата обновления</updateDate><id>идентификатор</id><firstName>имя</firstName><lastName>фамилия</lastName><middleName>отчество</middleName><birthDate>дата рождения</birthDate><iin>иин</iin><citizenship>гражданство</citizenship><gender>пол</gender><actualPlace><updateDate>дата обновления</updateDate><country>страна</country><region>регион</region><area>область</area><street>улица</street></actualPlace><registrationPlace><updateDate>дата обновления</updateDate><country>страна</country><region>регион</region><area>область</area><street>улица</street></registrationPlace><resident>признак резидентства</resident><mobilePhone>номер мобильного телефона</mobilePhone><documentNumber>номер документа</documentNumber><documentType>тип документа</documentType></header><actualDocuments><documentNumber>номер документа</documentNumber><documentType>тип</documentType><name> ФИО</name><updateDate>дата обновления</updateDate></actualDocuments><actualDocuments><documentNumber>041689497</documentNumber><documentType>тип документа</documentType><issueDate>Дата выпуска</issueDate><name>ФИО</name><updateDate>дата обновления</updateDate></actualDocuments><debtVerificationInfo><bflFlg>false</bflFlg><bflMsg>Кол-во дней просрочки должно превышать 365 дней при сумме задолженности менее 1600 МРП.</bflMsg><creditCount>1</creditCount><daysFlg>false</daysFlg><daysOverdue>0</daysOverdue><debtFlg>false</debtFlg><debtValue>160832.0</debtValue></debtVerificationInfo><contractDetailsByCreditor><creditorName>Имя кредитора</creditorName><creditCount>1</creditCount><totalDebtValue>160832.00</totalDebtValue><maxPaymentDaysOverdue>0</maxPaymentDaysOverdue></contractDetailsByCreditor></kz.scb.credithistory.services.model.reports.individual.PersonDebtVerificationDto></kz.scb.credithistory.services.model.reports.individual.PersonDebtVerificationDto>]]></xmlReportContent>
45.	               <saveToBilling>false</saveToBilling>
46.	            </reportContext>
47.	         </reportResponse>
48.	      </ns2:requestPersonCreditDebtResponse>
49.	   </soap:Body>
50.	</soap:Envelope>


Обработка исключений методов requestPersonCreditDebt

При обработке запроса методов requestPersonCreditDebt и requestXmlPersonCreditDebt могут возвращаться следующие виды ошибок/исключений/сообщений: [Показать ответ]
Код/Текст ошибки/сообщения Описание ошибки/сообщения Примечание
SBF-AD-1 Пользователь %s не имеет прав для выполне­ния действия
SBF-VE-8 Номер "ИИН" должен содержать 12 цифр
VAL-JSR-001 Значение обязательного поля "%s" не должно быть пустым
VAL-JSR-001 Обязательное поле "%s" отсутствует


Главная страница Предыдущая страница
Источник — https://wiki.gkb.kz/?title=Сервис_«Банкротство_физического_лица_сокращенная_информация»&oldid=7163