В данной статье описывается принцип работы сервиса, для работы с временными файлами в «Едином Хранилище Электронных Данных» (ЕХЭД) посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.
Сервис для работы с временными файлами в «Едином Хранилище Электронных Данных» (ЕХЭД)
При вызове веб-сервиса обязательно указываются следующие параметры:
- 1. ID и пароль клиента (организации) в HTTP Header, необходимые для базовой аутентификации. Так как коммуникация с веб-сервисами системы идет по защищенному протоколу HTTPS, то базовая аутентификация представляется безопасным решением.
- 2. ID пользователя, от имени которого будет выполнена запрашиваемая операция в SOAP Header:
Http Headers: {Authorization=[Basic c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2]}
Метод edsFilesDownload
Сервис для работы с временными файлами в «Едином Хранилище Электронных Данных» (ЕХЭД) и позволяет использовать ранее приложенные файлы заново
Состав данных запроса edsFilesDownload: [Показать ответ]
№
|
Наименование
|
Поле
|
Формат
|
1
|
Идентификационный номер пользователя
|
userId
|
xs:string
|
2
|
Идентификатор файла
|
fileIdentifiers
|
xs:string
|
3
|
Тип запроса
|
type
|
xs:string
|
|
Состав данных ответа edsFilesDownload: [Показать ответ]
№
|
Наименование
|
Поле
|
Формат
|
1
|
Идентификатор сообщения
|
messageId
|
xs:string
|
2
|
Дата ответа
|
responseDate
|
xs:string
|
3
|
Отчество
|
code
|
xs:string
|
4
|
Сообщение
|
message
|
xs:string
|
5
|
Идентификатор сессии
|
sessionId
|
xs:string
|
6
|
Тип запроса
|
ns2:type
|
xs:string
|
7
|
Информация о скачиваемом файле и его содержимое
|
FileDownloadResult
|
xs:string
|
8
|
Код статуса
|
ns2:code
|
xs:string
|
9
|
Статус скачивания файла
|
ns2:status
|
xs:string
|
10
|
Идентификатор файла
|
ns2:fileIdentifier
|
xs:string
|
11
|
Содержимое файла
|
ns2:content
|
xs:string
|
12
|
Название файла
|
ns2:name
|
xs:string
|
13
|
Тип содержимого
|
ns2:mime
|
xs:string
|
14
|
Дата и время загрузки
|
ns2:uploadDate
|
xs:string
|
15
|
Идентификатор системы
|
ns2:id
|
xs:string
|
16
|
Загрузившая система
|
uploaderSystem
|
xs:string
|
17
|
Дата и время окончания жизни файла
|
ns2:expirationTime
|
xs:string
|
18
|
Признак необходимости подтверждения скачивания файла
|
ns2:needToBeConfirmed
|
xs:string
|
19
|
Размер файла
|
ns2:size
|
xs:string
|
20
|
Признак удаления файла
|
ns2:deleted
|
xs:string
|
21
|
Признак подтверждения скачивания файла
|
ns2:confirmed
|
xs:string
|
|
Пример вызова метода edsFilesDownload: [Показать ответ]
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.mtszn.scb.kz/">
<soapenv:Header>
<userId>xxxxxx-xxxxxx-xxxxxx</userId>
</soapenv:Header>
<soapenv:Body>
<data:edsFilesDownload>
<fileIdentifiers>00000000-0000-testtesttest</fileIdentifiers>
<type>DOWNLOAD</type>
</data:edsFilesDownload>
</soapenv:Body>
</soapenv:Envelope>
Пример ответа на вызов метода edsFilesDownload: [Показать ответ]
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:edsFilesDownloadResponse xmlns:ns2="http://data.mtszn.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
<return>
<response>
<responseInfo>
<messageId>puZgwP3sDnNkSeonCu_xZcvuGJoUWdLsI</messageId>
<correlationId/>
<responseDate>2023-12-19T17:09:41.934+06:00</responseDate>
<status>
<code>1</code>
<message>Success</message>
</status>
<sessionId>puZgwP3sIpO7K3DDnNkSeonCu_xZcvuGJoUWdLsI</sessionId>
</responseInfo>
<responseData>
<data xmlns:ns2="http://bip.bee.kz/SyncChannel/v10/Types">
<ns2:tempStorageResponse xmlns:ns2="http://egov.bee.kz/eds/tempstorage/v2/">
<ns2:type>DOWNLOAD</ns2:type>
<ns2:downloadResponse>
<ns2:fileDownloadResults>
<ns2:status>
<ns2:code>TS-001</ns2:code>
<ns2:status>Success</ns2:status>
</ns2:status>
<ns2:fileIdentifier>00000000-0000-testtesttest</ns2:fileIdentifier>
<ns2:content>M4gItCd0JDQptCY0J7QndCQ0JvQrNCd0KvQlSDQmNCd0KTQntCg0JzQkNCm0JjQntCd0J3Qq9CVINCi0JXQpdCd0J7Qm9Ce0JPQmNCYIjEYMBYGA1UECwwPQklOMDAwNzQwMDAwNzI4MGwwJQYJKoMOAwoBAQEBMBgGCiqDDgMKAQEBAQEGCiqDDgMKAQMBAQADQwAEQO/toVMC+ss907UZho9cxXK0bg2/xdeUGsQbEn9p5AoBBfRuRzK3wsnreqjCGSoXEae2S0pWb78X1eWOodpxhzKjggFpMIIBZTAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAPBgNVHSMECDAGgARbanPpMB0GA1UdDgQWBBTtj/3msmimOadDFjRIUN0zkgKaZDBYBgNVHR8EUTBPME2gS6BJhiJodHRwOi8vY3JsLnBraS5nb3Yua3ovbmNhX2dvc3QuY3JshiNodHRwOi8vY3JsMS5wa2kuZ292Lmt6L25jYV9nb3N0LmNybDBcBgNVHS4EVTBTMFGgT6BNhiRodHRwOi8vY3JsLnBraS5nb3Yua3ovbmNhX2RfZ29zdC5jcmyGJWh0dHA6Ly9jcmwxLnBraS5nb3Yua3ovbmNhX2RfZ29zdC5jcmwwYwYIKwYBBQUHAQEEVzBVMC8GCCsGAQUFBzAChiNodHRwOi8vcGtpLmdvdi5rei9jZXJ0L25jYV9nb3N0LmNlcjAiBggrBgEFBQcwAYYWaHR0cDovL29jc3AucGtpLmdvdi5rejANBgkqgw4DCgEBAQIFAANBAPQmuXwQw8oMHwsQxUl8biBvaaXSVS8iOHCY5vh5qqTXWFLe3P5xqg39T8DRlPjPmhu49YfDWbslI4RserhbZGQxggFuMIIBagIBATBrMFMxCzAJBgNVBAYTAktaMUQwQgYDVQQDDDvSsNCb0KLQotCr0pog0JrQo9OY0JvQkNCd0JTQq9Cg0KPQqNCrINCe0KDQotCQ0JvQq9KaIChHT1NUKQIUVZIwj3INaP/J2U3jtGpqzncP0ckwDAYIKoMOAwoBAwEFAKCBmDAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTE5MTIzMTA5NDQwN1owKwYLKoZIhvcNAQkQAgwxHDAaMBgwFgQUe4DPqsrsTYDw0G6cNx02JdRFZG0wLwYJKoZIhvcNAQkEMSIEIFC2vJC00P7TrYBYRQnamP/g+qpLaUJsuDQJMM3jjuSkMA0GCSqDDgMKAQEBAgUABEDtG4ATT5O2rTmhvxhncauWVF4jHHpGJ0FZ0rUcy5rvUzcYQPrsvWUIBSUc6CSwbfuiBXpoP3B8Ed9lPzBXJF8m</ns2:content>
<ns2:meta>
<ns2:name>ТЕCTОВ_TЕCT_2019-12-31_15-44-07.sign</ns2:name>
<ns2:mime>application/octet-stream</ns2:mime>
<ns2:uploadDate>2023-12-13T17:11:17.954+06:00</ns2:uploadDate>
<ns2:uploaderSystem>
<ns2:id>test</ns2:id>
</ns2:uploaderSystem>
<ns2:expirationTime>2023-12-14T01:11:17.954+06:00</ns2:expirationTime>
<ns2:needToBeConfirmed>false</ns2:needToBeConfirmed>
<ns2:size>5610</ns2:size>
<ns2:deleted>false</ns2:deleted>
<ns2:confirmed>false</ns2:confirmed>
</ns2:meta>
</ns2:fileDownloadResults>
<ns2:status>
<ns2:code>TS-001</ns2:code>
<ns2:status>Success</ns2:status>
</ns2:status>
</ns2:downloadResponse>
</ns2:tempStorageResponse>
</data>
</responseData>
</response>
<gbdStatusResponse xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</return>
</ns2:edsFilesDownloadResponse>
</soap:Body>
</soap:Envelope>
Обработка исключений методов edsFilesDownload
При обработке запроса метода edsFilesDownload может возвращать следующие виды ошибок: [Показать ответ]
Код ошибки
|
Описание ошибки
|
SBF-AD-1
|
Пользователь %s не имеет прав для выполнения действия
|
SBF-AD-1
|
Пользователь не соответствует данному кредитору
|
SBF-AD-1
|
Пользователь %s не активен
|
FAULT-015
|
Сервис на стороне ГБД недоступен
|
FAULT-015
|
Null value exception
|
|