Просмотр кода страницы Сервис «По получению отчетов об оценке из депозитария финансовой отчетности»

<center>
{| width="auto" cellspacing="0" cellpadding="2" style="border:none;"
| width="auto" valign="top"|
| style="border-bottom:5px solid #20B2AA;font:110% Arial, Helvetica, sans-serif; color: #000000;text-align:center; padding-left:15px; padding-right:15px;" |<span class="plainlinks">[https://wiki.mkb.kz/ Главная страница]</span>
|
| style="border-bottom:5px solid #20B2AA;font:110% Arial, Helvetica, sans-serif; color: #000000;text-align:center; padding-left:15px; padding-right:15px;" |<span class="plainlinks">[https://wiki.mkb.kz/w/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%B2_%D0%93%D0%91%D0%94 Предыдущая страница]</span>
|}


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


=='''Описание сервиса DFO Bagalau'''==
Сервис предназначен для получения отчетов об оценке из депозитария финансовой отчетности.

{| class="wikitable"
|-
! style="text-align: center;" |'''Адреса web сервисов:'''
! style="text-align: center;" |
|-
| style="text-align: left;" | Тестовый сервис
| style="text-align: left;" | https://testscbws.mkb.kz/gbdServices/DfoBagalauImplService?wsdl 
|-
| style="text-align: left;" | Продуктивный сервис
| style="text-align: left;" | https://scbws.mkb.kz/gbdServices/DfoBagalauImplService?wsdl 
|-
| style="text-align: left;" | '''Метод сервиса:'''
| style="text-align: left;" |getDfoBagalauByBin 
getDfoBagalauByIin

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

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

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

Http Headers: {Authorization=[Basic Отличительное имя пользователя]
где Отличительное имя пользователя - есть значение HTTP Header, представляющее собой логин и его пароль для авторизации Basic Authentication.

<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_0001" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">''SOAP Message:''<small style="color:#0645ad;"> [Показать ответ] </small></div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_0001" style="padding:10px">

<syntaxhighlight lang="xml">
1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
2.	   <soapenv:Header>
3.	      <data:userId>ххх хххх хххх хххх</data:userId>
4.	      </soapenv:Header>
5.	   <soapenv:Body>
6.	      <data:getDfoBagalauByBin>
7.	      </data:getDfoBagalauByBin>
8.	   </soapenv:Body>
9.	</soapenv:Envelope>
</syntaxhighlight>

</div>
</div>


=='''getDfoBagalauByBin'''==

Метод предназначен для получения  информации по БИН .

<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_0002" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">''Состав данных запроса тип getDfoBagalauByBin:''<small style="color:#0645ad;"> [Показать ответ] </small></div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_0002" style="padding:10px">

{| class="wikitable"
|-
|'''№'''
|'''Наименование'''
|'''Поле'''
|'''Формат'''
|'''Примечание'''
|-
|'''1'''
|Индивидуальный номер пользователя
|kdpToken
|userid
|xs:string
|-
|'''2'''
|БИН
|bin
|xs:string
|БИН должен содержать 12 цифр
|-
|'''3'''
|Номер отчета
|Report number
|xs:string
|номер присваивается внутри документа при проведении оценки имущества
|}
</div>
</div>
<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_0003" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">'' Состав данных ответа на запрос по методу getDfoBagalauByBin:''<small style="color:#0645ad;"> [Показать ответ] </small></div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_0003" style="padding:10px">

{| class="wikitable"
|'''№'''
|'''Наименование'''
|'''Поле'''
|'''Формат'''
|'''Примечание'''
|-
|'''1'''
|Возврат
|return
|xs:string
|
|-
|'''2'''
|ответ
|response
|xs:string
|
|-
|'''3'''
|Информация  об ответе
|responseInfo
|SyncMessageInfoResponse
|
|-
|'''4'''
|Идентификатор  сообщения в системе получателя
|messageId
|xs:string
|
|-
|'''5'''
|Дата  ответа в системе получателя запроса
|responseDate
|xs:dateTime
|
|-
|'''6'''
|Статус
|status
|StatusInfo
|Статус справочник:

''Active =  "Активный"''

''Recalled =  "Отозван"''

''Corrected =  "Откорректирован"''

''Notactual =  "Неактуальный''
|-
|'''7'''
|Код статуса
|code
|xs:string
|
|-
|'''8'''
|Сообщение о статусе
|message
|xs:string
|
|-
|'''9'''
|Идентификатор сессии
|sessionId
|guid
|
|-
|'''10'''
|Объект «Данные  ответа»
|responseData
|responseData
|
|-
|'''11'''
|Тип
|type
|xs:string
|
|-
|'''12'''
|Отчеты
|reports
|xs:string
|
|-
|'''13'''
|идентификатор отчета
|Report id
|xs:string
|
|-
|'''14'''
|ИИН\БИН заказчика оченки
|Rate order xin
|xs:string
|
|-
|'''15'''
|Имя заказчика оценки
|RateOrdererNameRu
|xs:string
|
|-
|'''16'''
|Тапсырыс берушінің аты-жөні
|RateOrdererNameKz
|xs:string
|
|-
|'''17'''
|Номер отчета
|ReportNumber
|xs:string
|
|-
|'''18'''
|Название отчета
|ReportName
|xs:string
|
|-
|'''19'''
|Дата составления отчета
|ReportDate
|xs:string
|
|-
|'''20'''
|Дата оценки
|RateDate
|xs:string
|
|-
|'''21'''
|Цель оценки
|RateAim
|xs:string
|
|-
|'''22'''
|Стоимость объекта оценки, тенге
|RateAmount
|xs:string
|
|-
|'''23'''
|Наименование объекта оценки
|ObjectInfo
|xs:string
|
|-
|'''24'''
|Вид определяемой стоимости
|DefiningCostType
|xs:string
|Справочник вид  определяемой стоимости: ''MarketPrice =  "Рыночная стоимость"''

''InvestmentCost = "Инвестиционная  стоимость"''

''LiquidityCost = "Ликвидационная стоимость"''

''CadastralCost= "Кадастровая стоимость"''
|-
|'''25'''
|URL  активен до
|UrlActiveUntil
|xs:string
|
|-
|'''26'''
|URL файла отчета
|ReportFileUrls
|xs:string
|
|-
|'''27'''
|URL-адрес  файла отчета
|ReportFileUrl
|xs:string
|
|-
|'''28'''
|URL-адрес  загрузки
|DownloadUrl
|xs:string
|
|-
|'''29'''
|Статус  отчета
|Reportstatus
|xs:string
|
|}
</div>
</div>

<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_0004" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">''Пример вызова метода getDfoBagalauByBin с помощью SOAP запроса имеет следующий вид:''<small style="color:#0645ad;"> [Показать ответ] </small></div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_0004" style="padding:10px">

<syntaxhighlight lang="xml">
1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
2.	   <soapenv:Header>
3.	      <data:userId>Идентификационный номер пользователя</data:userId>
4.	      </soapenv:Header>
5.	   <soapenv:Body>
6.	      <data:getDfoBagalauByBin>
7.	         <Bin>БИН</Bin>
8.	         <ReportNumber>Номер отчета</ReportNumber>
9.	      </data:getDfoBagalauByBin>
10.	   </soapenv:Body>
11.	</soapenv:Envelope>
</syntaxhighlight><br />
</div>

<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_0005" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">''Пример ответа на вызов метода getDfoBagalauByBin с помощью SOAP запроса имеет следующий вид:''<small style="color:#0645ad;"> [Показать ответ] </small></div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_0005" style="padding:10px">

<syntaxhighlight lang="xml">
1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2.	   <soap:Body>
3.	      <ns2:getDfoBagalauByBinResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
4.	         <return>
5.	            <response>
6.	               <responseInfo>
7.	                  <messageId>Идентификатор сообщения</messageId>
8.	                  <responseDate>Дата ответа в системе получателя</responseDate>
9.	                  <sessionId>Идентификатор сессии</sessionId>
10.	               </responseInfo>
11.	               <responseData>
12.	                  <data xsi:type="BagalauGetReportsRes" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
13.	                     <Reports>
14.	                        <BagalauReport>
15.	                           <ReportId>идентификатор отчета</ReportId>
16.	                           <RateOrdererXin></RateOrdererXin>
17.	                           <RateOrdererNameRu>Имя заказчика оценки</RateOrdererNameRu>
18.	                           <RateOrdererNameKz>Тапсырыс берушінің аты-жөні</RateOrdererNameKz>
19.	                           <ReportNumber>Номер отчета</ReportNumber>
20.	                           <ReportName>Название отчета</ReportName>
21.	                           <ReportDate>Дата отчета</ReportDate>
22.	                           <RateDate>Дата оценки</RateDate>
23.	                           <RateAim>Дата оценки</RateAim>
24.	                           <RateAmount>Сумма ставки</RateAmount>
25.	                           <ObjectInfo>Информация о объекте</ObjectInfo>
26.	                           <DefiningCostType>Определение типа стоимости</DefiningCostType>
27.	                           <ReportStatus>Статус отчета</ReportStatus>
28.	                           <ReportFileUrls><ReportFileUrl>    
29.	                                 <DownloadUrl> URL-адрес загрузки</DownloadUrl>
30.	                                 <UrlActiveUntil>Url активен до</UrlActiveUntil>
31.	                              </ReportFileUrl>
32.	                           </ReportFileUrls>
33.	                        </BagalauReport>
34.	                     </Reports>
35.	                  </data>
36.	               </responseData>
37.	            </response>
38.	            <gbdStatusResponse xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
39.	         </return>
40.	      </ns2:getDfoBagalauByBinResponse>
41.	   </soap:Body>
42.	</soap:Envelope>
</syntaxhighlight>

</div>
</div>


=='''getDfoBagalauByIin'''==

Метод предназначен для получения  информации по ИИН 
<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_0006" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">''Состав данных запроса по методу getDfoBagalauByIin''<small style="color:#0645ad;"> [Показать ответ] </small></div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_0006" style="padding:10px">

{| class="wikitable"
|-
|'''№'''
|'''Наименование'''
|'''Поле'''
|'''Формат'''
|-
|'''1'''
|Идентификационный номер пользователя
|userId
|xs:string
|-
|'''2'''
|Номер отчета
|reportNumber
|xs:string
|-
|'''3'''
|ИИН
|iin
|xs:string
|-
|'''4'''
|Публичный ключ
|publicKey
|xs:string
|-
|'''5'''
|Код
|Code
|xs:string
|-
|}
</div>
</div>

<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_0007" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">''Состав данных ответа на тип запроса Тип RequestByIin:''<small style="color:#0645ad;"> [Показать ответ] </small></div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_0007" style="padding:10px">

{| class="wikitable"
|'''№'''
|'''Наименование'''
|'''Поле'''
|'''Формат'''
|-
|'''1'''
|Возврат
|return
|xs:string
|-
|'''2'''
|ответ
|response
|xs:string
|-
|'''3'''
|Информация  об ответе
|responseInfo
|SyncMessageInfoResponse
|-
|'''4'''
|Идентификатор  сообщения в системе получателя
|messageId
|xs:string
|-
|'''5'''
|Дата  ответа в системе получателя запроса
|responseDate
|xs:dateTime
|-
|6
|Отчет
|reports
|StatusInfo
|-
|'''7'''
|идентификатор отчета
|Report id
|xs:string
|-
|'''8'''
|ИИН\БИН заказчика оценки
|Rate order xin
|xs:string
|-
|'''9'''
|Имя заказчика оценки
|RateOrdererNameRu
|xs:string
|-
|'''10'''
|Тапсырыс берушінің аты-жөні
|RateOrdererNameKz
|xs:string
|-
|'''11'''
|Номер отчета
|ReportNumber
|xs:string
|-
|'''12'''
|Название отчета
|ReportName
|xs:string
|-
|'''13'''
|Дата составления отчета
|ReportDate
|xs:string
|-
|'''14'''
|Дата оценки
|RateDate
|xs:string
|-
|'''15'''
|Цель оценки
|RateAim
|xs:string
|-
|'''16'''
|Стоимость объекта оценки, тенге
|RateAmount
|xs:string
|-
|'''17'''
|Наименование объекта оценки
|ObjectInfo
|xs:string
|-
|'''18'''
|Определение типа стоимости
|DefiningCostType
|xs:string
|-
|'''19'''
|URL активен до
|UrlActiveUntil
|xs:string
|-
|'''20'''
|URL файла отчета    
|ReportFileUrls
|xs:string
|-
|'''21'''
|URL-адрес файла отчета
|ReportFileUrl
|xs:string
|-
|'''22'''
|URL-адрес загрузки
|DownloadUrl
|xs:string
|-
|'''23'''
|Статус отчета
|Reportstatus
|xs:string
|}
</div>
</div>

<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_0008" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">''Пример вызова метода getDfoBagalauByIin с помощью SOAP запроса имеет следующий вид:''<small style="color:#0645ad;"> [Показать ответ] </small></div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_0008" style="padding:10px">
Пример вызова метода с помощью SOAP запроса имеет следующий вид:

<syntaxhighlight lang="xml">
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>
4.	   </soapenv:Header>
5.	   <soapenv:Body>
6.	      <data:getDfoBagalauByIin>
7.	         <Iin>ИИН</Iin>
8.	         <ReportNumber>Номер отчета</ReportNumber>
9.	         <Code>КОД</Code>
10.	         <PublicKey>Публичный ключ</PublicKey>
11.	      </data:getDfoBagalauByIin>
12.	   </soapenv:Body>
13.	</soapenv:Envelope>
</syntaxhighlight><br />

</div>
</div>

<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_0009" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">''Пример ответа на вызов метода getDfoBagalauByIin с помощью SOAP запроса имеет следующий вид:''<small style="color:#0645ad;"> [Показать ответ] </small></div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_0009" style="padding:10px">

<syntaxhighlight lang="xml">
1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2.	   <soap:Body>
3.	      <ns2:getDfoBagalauByIinResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
4.	         <return>
5.	            <response>
6.	               <responseInfo>
7.	                  <messageId>Идентификатор сообщения</messageId>
8.	                  <responseDate>Дата ответа</responseDate>
9.	                  <sessionId>Идентификатор сессии</sessionId>
10.	               </responseInfo>
11.	               <responseData>
12.	                  <data xsi:type="BagalauGetReportsRes" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
13.	                     <Reports>
14.	                        <BagalauReport>
15.	                           <ReportId>Идентификатор отчета</ReportId>
16.	                           <RateOrdererXin>ИИН/БИН заказчика оценки</RateOrdererXin>
17.	                           <RateOrdererNameRu>ФИО</RateOrdererNameRu>
18.	                           <RateOrdererNameKz>ТАӘ</RateOrdererNameKz>
19.	                           <ReportNumber>Номер отчета</ReportNumber>
20.	                           <ReportName>Наименование отчета</ReportName>
21.	                           <ReportDate>Дата отчета</ReportDate>
22.	                           <RateDate>Дата отчета</RateDate>
23.	                           <RateAim>Цель оценки</RateAim>
24.	                           <RateAmount>Стоимость объекта оценки,тенге</RateAmount>
25.	                           <ObjectInfo>Наименование объекта оценки</ObjectInfo>
26.	                           <DefiningCostType>Определение типа стоимости</DefiningCostType>
27.	                           <ReportStatus>Статус Отчета</ReportStatus>
28.	                           <ReportFileUrls>
29.	                              <ReportFileUrl>
30.	                                 <DownloadUrl>Url  адрес загрузки</DownloadUrl>
31.	                                 <UrlActiveUntil>Url активен до</UrlActiveUntil>
32.	                              </ReportFileUrl>
33.	                           </ReportFileUrls>
34.	                        </BagalauReport>
35.	                     </Reports>
36.	                  </data>
37.	               </responseData>
38.	            </response>
39.	            <gbdStatusResponse xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
40.	         </return>
41.	      </ns2:getDfoBagalauByIinResponse>
42.	   </soap:Body>
43.	</soap:Envelope>
</syntaxhighlight><br />

</div>
</div>


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

<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_00023" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">''При обработке запроса метод сервиса может возвращать следующие виды ошибок/исключений/сообщений:''<small style="color:#0645ad;"> [Показать ответ] </small></div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_00023" style="padding:10px">

{| class="wikitable"
|'''Код  ошибки'''
|'''Описание  ошибки'''
|-
|SBF-VE-8
|Номер  "ИИН"/"БИН" должен содержать 12 цифр
|-
|VAL-JSR-001
|Обязательное поле "БИН" отсутствует
|-
|GBD_EPTS
|Null value exception
|-
|FAULT-015
|Сервис на стороне  ГБД недоступен
|-
|}
</div>
</div>


<center>
{| width="auto" cellspacing="0" cellpadding="2" style="border:none;"
| width="auto" valign="top"|
| style="border-bottom:5px solid #20B2AA;font:110% Arial, Helvetica, sans-serif; color: #000000;text-align:center; padding-left:15px; padding-right:15px;" |<span class="plainlinks">[https://wiki.mkb.kz/ Главная страница]</span>
|
| style="border-bottom:5px solid #20B2AA;font:110% Arial, Helvetica, sans-serif; color: #000000;text-align:center; padding-left:15px; padding-right:15px;" |<span class="plainlinks">[https://wiki.mkb.kz/w/%D0%A1%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D1%8B_%D0%93%D0%91%D0%94 Предыдущая страница]</span>
|}
</center>
<br/>