Сервис «По предоставлению страхового отчета ОС ГПО ВТС»: различия между версиями

Текущая версия от 07:50, 22 октября 2023

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

Описание сервиса InsuranceReport

Сервис InsuranceReport предназначен для получения сведений по страховому отчету «Обязательного страхования гражданской правовой ответственности Владельцев Транспортных Средств» (далее ОС ГПО ВТС).

Адреса web сервисов:
Тестовый сервис	https://testscbws.mkb.kz/gbdServices/InsuranceReportImplService?wsdl
Продуктивный сервис	https://scbws.mkb.kz/gbdServices/InsuranceReportImplService?wsdl
Метод сервиса:	getInsuranceReportPdf, getInsuranceReportXml

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

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:data="http://data.gbd.chdb.scb.kz/">
2.	      <soapenv:Header>
3.	   <userId> xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx </userId>
4.       <ds:Signature></ds:Signature>
5.	   </soapenv:Header> 
6.	   <soapenv:Body>
7.	      <data:getInsurancePolicyXml>

Состав данных запроса метода getInsurancePolicyPdf/ getInsurancePolicyXml

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

№	Наименование	Поле	Формат	Обязательность	Примечание
Блок header включает в себя ЭЦП субъекта и userId
1	ИИН субъекта	request → iin	xs:string	Да	Значение должно содержать 12 цифр.
2	Язык	request → language	xs:string	Да	Получение информации на языках: kk –Казахский, ru – Русский, en – Английский
3	Тип отчета	request → reportType	xs:int	Да	Заполнить любыми цифрами
4	Имя пользователя	request → senderId	xs:int	Да	Отличительное имя пользователя
5	Пароль	request → password	xs:int	Да	Указать пароль
6	Подтверждение	request → consentConfirmed	xs:int	Да	Подтверждение субъекта

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

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

 1 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
 2      <soapenv:Header>
 3     <userId>Ваш userId</userId>
 4     <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="">
 5     <ds:SignedInfo>
 6     <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
 7     <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34310-gost34311"/>
 8     <ds:Reference URI="">
 9     <ds:Transforms>
10     <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
11     <ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/>
12     </ds:Transforms>
13     <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34311"/>
14     <ds:DigestValue>BgqyQ8lHgj3MsE+rC8e2Cuqv100pSOCzMUX+DVFUxm4=</ds:DigestValue>
15     </ds:Reference>
16     </ds:SignedInfo>
17     <ds:SignatureValue>OF3KtHDvw18np/Cc2U+w+VD8wwNTe2nVtogCBLlyVHEsxSRP+ivIWPkMDPfRbSmP6aPVL/orlBFsQNyKJpHfuQ==</ds:SignatureValue>
18     <ds:KeyInfo>
19     <ds:X509Data>
20     <ds:X509Certificate>publicKey</ds:X509Certificate>
21     </ds:X509Data>
22     </ds:KeyInfo>
23     </ds:Signature>
24	   </soapenv:Header> 
25	   <soapenv:Body>
26	      <data:getInsuranceReportPdf>
27	          <iinBin>Иин субъекта</iinBin>
28	         <language>указать язык</language>
29	         <reportType>123</reportType>
30	         <senderId>логин</senderId>
31	         <password>пароль</password>
32	         <consentConfirmed>согласие субъекта</consentConfirmed>
33	       </data:getInsuranceReportPdf>
34	   </soapenv:Body>
35	</soapenv:Envelope>

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

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

 1	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
 2	   <soapenv:Header>
 3	   <userId>xxx-xx-xxx-xxxx-xxxx-xx-xxxx</userId>
 4	   </soapenv:Header> 
 5           <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="">
 6           <ds:SignedInfo>
 7           <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
 8           <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34310-gost34311"/>
 9           <ds:Reference URI="">
10           <ds:Transforms>
11           <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
12           <ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/>
13           </ds:Transforms>
14           <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34311"/>
15           <ds:DigestValue>BgqyQ8lHgj3MsE+rC8e2Cuqv100pSOCzMUX+DVFUxm4=</ds:DigestValue>
16           </ds:Reference>
17           </ds:SignedInfo>
18           <ds:SignatureValue>OF3KtHDvw18np/Cc2U+w+VD8wwNTe2nVtogCBLlyVHEsxSRP+ivIWPkMDPfRbSmP6aPVL/orlBFsQNyKJpHfuQ==</ds:SignatureValue>
19           <ds:KeyInfo>
20           <ds:X509Data>
21           <ds:X509Certificate>publicKey</ds:X509Certificate>
22           </ds:X509Data>
23           </ds:KeyInfo>
24           </ds:Signature>
25	   <soapenv:Body>
26	      <data:getInsuranceReportXml>
27	         <iinBin> Иин субъекта </iinBin>
28	         <language> указать язык </language>
29	         <reportType>123</reportType>
30	         <senderId> логин </senderId>
31	         <password> пароль </password>
32	         <consentConfirmed> согласие субъекта </consentConfirmed>
33	      </data:getInsuranceReportXml>
34	   </soapenv:Body>
35	</soapenv:Envelope>

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

Пример успешного ответа на вызов метода getInsuranceReportPDF с помощью SOAP запроса имеет следующий вид: в ответе метода getInsuranceReportPDF строка <qrCode> не предоставлен т.к оно защита внутри сгенерированного PDF файла в строке <responseResult> [Показать ответ]

1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2.	   <soap:Body>
3.	      <ns2:getInsuranceReportPdfResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
4.	         <return>
5.	            <response>
6.	               <responseInfo>
7.	                  <sessionId> Текущая сессия </sessionId>
8.	               </responseInfo>
9.	               <responseData>
10.	                  <data xmlns:typ="http://bip.bee.kz/SyncChannel/v10/Types">
11.	                     <status>Запрос успешно обработан, PDF сгенерирова в виде BASE64</status>
12.	                     <responseResult>Результат</responseResult>
13.	                     <qrCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
14.	                     <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
15.	                        <ds:SignedInfo>
16.	                           <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
17.	                           <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34310-gost34311"/>
18.	                           <ds:Reference URI="">
19.	                              <ds:Transforms>
20.	                                 <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
21.	                                 <ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/>
22.	                              </ds:Transforms>
23.	                              <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34311"/>
24.	                              <ds:DigestValue> Ваш Сгенерированный-DigestValue </ds:DigestValue>
25.	                           </ds:Reference>
26.	                        </ds:SignedInfo>
27.	                        <ds:SignatureValue> Ваш Сгенерированный-SignatureValue </ds:SignatureValue>
28.	                        <ds:KeyInfo>
29.	                           <ds:X509Data>
30.	                              <ds:X509Certificate> Ваш Сертификат-X509Certificate </ds:X509Certificate>
31.	                           </ds:X509Data>
32.	                        </ds:KeyInfo>
33.	                     </ds:Signature>
34.	                  </data>
35.	               </responseData>
36.	            </response>
37.	         </return>
38.	      </ns2:getInsuranceReportPdfResponse>
39.	   </soap:Body>
40.	</soap:Envelope>

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

Пример успешного ответа на вызов метода getInsuranceReportXml с помощью SOAP запроса имеет следующий вид: в ответе метода getInsuranceReportXml строка <qrCode> не предоставлен т.к оно защита внутри сгенерированного XML файла в строке <responseResult> [Показать ответ]

1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2.	   <soap:Body>
3.	      <ns2:getInsurancePolicyXmlResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
4.	         <return>
5.	            <response>
6.	               <responseInfo>
7.	                  <sessionId> Текущая сессия </sessionId>
8.	               </responseInfo>
9.	               <responseData>
10.	                  <data xmlns:typ="http://bip.bee.kz/SyncChannel/v10/Types">
11.	                     <status>Запрос успешно обработан</status>
12.	                     <responseResult></responseResult>
13.	                     <qrCode></qrCode>
14.	                     <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
15.	                        <ds:SignedInfo>
16.	                           <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
17.	                           <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34310-gost34311"/>
18.	                           <ds:Reference URI="">
19.	                              <ds:Transforms>
20.	                                 <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
21.	                                 <ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/>
22.	                              </ds:Transforms>
23.	                              <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34311"/>
24.	                              <ds:DigestValue> Ваш Сгенерированный-DigestValue </ds:DigestValue>
25.	                           </ds:Reference>
26.	                        </ds:SignedInfo>
27.	                        <ds:SignatureValue> Ваш Сгенерированный-SignatureValue </ds:SignatureValue>
28.	                        <ds:KeyInfo>
29.	                           <ds:X509Data>
30.	                              <ds:X509Certificate> Ваш Сертификат-X509Certificate </ds:X509Certificate>
31.	                           </ds:X509Data>
32.	                        </ds:KeyInfo>
33.	                     </ds:Signature>
34.	                  </data>
35.	               </responseData>
36.	            </response>
37.	            <gbdStatusResponse xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
38.	         </return>
39.	      </ns2:getInsurancePolicyXmlResponse>
40.	   </soap:Body>
41.	</soap:Envelope>

Пример ответа на вызов метода InsuranceReport с помощью SOAP запроса в случае, если не заполнено обязательное поле ИИН, имеет следующий вид:

Пример ответа на вызов метода InsuranceReport с помощью 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.	   <soap:Body>
4.	      <soap:Fault>
5.	         <faultcode>soap:Server</faultcode>
6.	         <faultstring>Ошибки:</faultstring>
7.	         <detail>
8.	            <ns2:ValidationFault xmlns:ns2="http://scoring.chdb.scb.kz">
9.	               <constraintViolations>
10.	                  <code>VAL-JSR-001</code>
11.	                  <description>Обязательное поле "иин" отсутствует.</description>
12.	                  <placeholders>иин</placeholders>
13.	               </constraintViolations>
14.	            </ns2:ValidationFault>
15.	         </detail>
16.	      </soap:Fault>
17.	   </soap:Body>
18.	</soap:Envelope>

Пример ответа на вызов метода InsuranceReport с помощью SOAP запроса в случае, если отсутствует права пользователя, имеет следующий вид:

Пример ответа на вызов метода InsuranceReport с помощью SOAP запроса в случае, если отсутствует права пользователя, имеет следующий вид: [Показать ответ]

1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2.	   <soap:Body>
3.	      <soap:Fault>
4.	         <faultcode>soap:Server</faultcode>
5.	         <faultstring>Пользователь xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx не имеет прав для выполнения действия</faultstring>
6.	         <detail>
7.	            <ns2:ScbException xmlns:ns2="http://data.gbd.chdb.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
8.	               <faultCode>SBF-AD-1</faultCode>
9.	            </ns2:ScbException>
10.	         </detail>
11.	      </soap:Fault>
12.	   </soap:Body>
13.	</soap:Envelope>

Пример ответа на вызов метода InsuranceReport с помощью SOAP запроса в случае, если отсутствует обязательное поле, имеет следующий вид:

Пример ответа на вызов метода InsuranceReport с помощью SOAP запроса в случае, если отсутствует обязательное поле, имеет следующий вид: [Показать ответ]

1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2.	   <soap:Body>
3.	      <soap:Fault>
4.	         <faultcode>soap:Server</faultcode>
5.	         <faultstring> " Обязательное поле " отсутствует</faultstring>
6.	         <detail>
7.	            <ns2:ScbException xmlns:ns2="http://data.gbd.chdb.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
8.	               <faultCode>VAL-JSR-001</faultCode>
9.	            </ns2:ScbException>
10.	         </detail>
11.	      </soap:Fault>
12.	   </soap:Body>
13.	</soap:Envelope>

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

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

Главная страница

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