В данной статье описывается сервис по получению отчетов об оценке из депозитария финансовой отчетности посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.
Описание сервиса DFO Bagalau
Сервис предназначен для получения отчетов об оценке из депозитария финансовой отчетности.
При вызове веб-сервиса обязательно указываются следующие параметры:
1. Отличительное имя пользователя и пароль (организации) в HTTP Header, необходимые для базовой аутентификации. Так как коммуникация с веб-сервисами системы идет по защищенному протоколу HTTPS, то базовая аутентификация представляется безопасным решением.
2. Отличительное имя пользователя, от имени которого будет выполнена запрашиваемая операция в SOAP Header:
Http Headers: {Authorization=[Basic Отличительное имя пользователя]
где Отличительное имя пользователя - есть значение HTTP Header, представляющее собой логин и его пароль для авторизации Basic Authentication.
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. <data:userId>ххх хххх хххх хххх</data:userId>
4. </soapenv:Header>
5. <soapenv:Body>
6. <data:getDfoBagalauByBin>
7. </data:getDfoBagalauByBin>
8. </soapenv:Body>
9. </soapenv:Envelope>
getDfoBagalauByBin
Метод предназначен для получения информации по БИН .
Состав данных запроса тип getDfoBagalauByBin: [Показать ответ]
| №
|
Наименование
|
Поле
|
Формат
|
Примечание
|
| 1
|
Индивидуальный номер пользователя
|
kdpToken
|
userid
|
xs:string
|
| 2
|
БИН
|
bin
|
xs:string
|
БИН должен содержать 12 цифр
|
| 3
|
Номер отчета
|
Report number
|
xs:string
|
номер присваивается внутри документа при проведении оценки имущества
|
Состав данных ответа на запрос по методу getDfoBagalauByBin: [Показать ответ]
| №
|
Наименование
|
Поле
|
Формат
|
Примечание
|
| 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
|
|
Пример вызова метода getDfoBagalauByBin с помощью SOAP запроса имеет следующий вид: [Показать ответ]
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>
Пример ответа на вызов метода getDfoBagalauByBin с помощью SOAP запроса имеет следующий вид: [Показать ответ]
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>
getDfoBagalauByIin
Метод предназначен для получения информации по ИИН
Состав данных запроса по методу getDfoBagalauByIin [Показать ответ]
| №
|
Наименование
|
Поле
|
Формат
|
| 1
|
Идентификационный номер пользователя
|
userId
|
xs:string
|
| 2
|
Номер отчета
|
reportNumber
|
xs:string
|
| 3
|
ИИН
|
iin
|
xs:string
|
| 4
|
Публичный ключ
|
publicKey
|
xs:string
|
| 5
|
Код
|
Code
|
xs:string
|
Состав данных ответа на тип запроса Тип RequestByIin: [Показать ответ]
| №
|
Наименование
|
Поле
|
Формат
|
| 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
|
Пример вызова метода getDfoBagalauByIin с помощью SOAP запроса имеет следующий вид: [Показать ответ]
Пример вызова метода с помощью 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>
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>
Пример ответа на вызов метода getDfoBagalauByIin с помощью SOAP запроса имеет следующий вид: [Показать ответ]
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>
Обработка исключений метода getDfoBagalau
При обработке запроса метод сервиса может возвращать следующие виды ошибок/исключений/сообщений: [Показать ответ]
| Код ошибки
|
Описание ошибки
|
| SBF-VE-8
|
Номер "ИИН"/"БИН" должен содержать 12 цифр
|
| VAL-JSR-001
|
Обязательное поле "БИН" отсутствует
|
| GBD_EPTS
|
Null value exception
|
| FAULT-015
|
Сервис на стороне ГБД недоступен
|