Сервис «По поиску информации по пострадавшему работнику»
Материал из Wiki ГКБ
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
| Главная страница | Предыдущая страница |
В данной статье описывается принцип работы сервиса по получению сведений о по пострадавшему работнику (далее – Сервис) посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.
Содержание
Сервис по поиску информации по пострадавшему работнику
| Адреса web сервисов: | |
|---|---|
| Тестовый сервис | https://testscbws.mkb.kz/mtsznServices/GetInfoDegreeWorkerImplService?wsdl |
| Продуктивный сервис | https://scbws.mkb.kz/mtsznServices/GetInfoDegreeWorkerImplService?wsdl |
| Метод сервиса: | getInfoDegreeWorker
getInfoDegreeWorkerUseToken |
При вызове веб-сервиса обязательно указываются следующие параметры:
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.mtszn.scb.kz/">
2. <soapenv:Header>
3. <userId> xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx </userId>
4. </soapenv:Header>
5. <soapenv:Body>
6. </data:getInfoDegreeWorker>
7. </soapenv:Body>
8. </soapenv:Envelope>
Метод getInfoDegreeWorker
Метод предназначен для получения выходных документов.
Состав данных запроса: [Показать ответ]
| № | Наименование | Формат | Поле | Обязательность | Описание |
|---|---|---|---|---|---|
| 1 | ИИН | xs:string | iin | Да | ИИН пострадавшего работника |
| 2 | Номер запроса | xs:string | requestNumber | Да | Присвоенный системный номер исходящего ответа |
| 3 | Подтверждение субъекта | xs:integer | consent | Да | Согласие true – (Да) или false – (Нет) |
Метод getInfoDegreeWorkerUseToken
Состав данных запроса: [Показать ответ]
| № | Наименование | Формат | Поле | Обязательность | Описание |
|---|---|---|---|---|---|
| Входные параметры метода getInfoDegreeWorker | |||||
| 1 | ИИН | xs:string | iin | Да | ИИН пострадавшего работника |
| 2 | Номер запроса | xs:string | requestNumber | Да | Присвоенный системный номер исходящего ответа |
| 3 | Подтверждение субъекта | xs:integer | consent | Да | Согласие true – (Да) или false – (Нет) |
| 4 | Токен КДП | xs:string | token | Да | Наличие согласия субъекта на предоставление информации из ГБД |
Состав данных ответа метода GgetInfoDegreeWorker и GetInfoDegreeWorkerUseToken: [Показать ответ]
| № | Наименование | Формат | Обязательность | Примечание |
|---|---|---|---|---|
| 1. | iin | string | Да | ИИН пострадавшего работника |
| 2. | responseNumber | string | Да | Присвоенный системный номер исходящего ответа |
| 3. | dateSurvey | date | Да | Дата освидетельствования, в формате dd.mm.yyyy |
| 4. | degree | integer | Да | Степень УПТ, % |
| 5. | termDegree | string | Да | Срок степени УПТ |
| 6. | dateTermDegree | string | Да | Срок зачтен с, в формате dd.mm.yyyy |
| 7. | responseNumber | string | Да | Номер ответа |
| 8. | gruppaInv | string | Да | Группа инвалидности |
| 9. | appointDate | date | Да | Дата назначения |
| 10. | endDateExpertise | date | Да | Дата окончания |
| 11. | srokInv | string | Да | Срок инвалидности |
| 12. | dataOkonInv | date | Да | Дата окончания инвалидности |
| 13. | reExaminationDate | date | Да | Дата повторного осмотра |
| 14. | numberAct | integer | Да | Номер АКТа |
| 15. | srokZachtenS | date | Да | Срок начала |
| 16. | prInv | string | Да | Причина инвалидности |
| 17. | IPRNumber | integer | Да | Номер ИПРН |
| 18. | mainDiagnosis | string | Да | Основной диагноз |
| 19. | mseName | string | Да | Наименования МСЭ |
| 20. | hospitalName | string | Да | Наименования мед. учреждения |
| 21. | workPlace | string | Да | Место работы |
| 22. | workPosition | string | Да | Должность |
| 23. | mseZakl | string | Да | Заключение МСЭ |
| 24. | medicalRehabilation | string | Да | Медицинская реабилитация |
| 25. | srokUPT | date | Да | Срок УПТ |
| 26. | numberN1 | integer | Да | Номер Н1 |
| 27. | nameOrg | string | Да | Наименования организации |
| 28. | referenceUpt | integer | Да | Справка УПТ |
Пример вызова сервиса
Пример вызова метода getInfoDegreeWorker [Показать ответ]
1. <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.mtszn.scb.kz/">
2. <soapenv:Header>
3. <userId>Ваш пользователь</userId>
4. </soapenv:Header>
5. <soapenv:Body>
6. <data:getInfoDegreeWorker>
7. <iin>ИИН</iin>
8. <requestNumber>номер запроса</requestNumber>
9. <consent>подтверждение </consent>
10. </data:getInfoDegreeWorker>
11. </soapenv:Body>
12. </soapenv:Envelope>
Пример вызова метода getInfoDegreeWorkerUseToken [Показать ответ]
1. <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.mtszn.scb.kz/">
2. <soapenv:Header>
3. <userId>Ваш пользователь</userId>
4. </soapenv:Header>
5. <soapenv:Body>
6. <data:getInfoDegreeWorkerUseToken>
7. <requestNumber>Номер запроса</requestNumber>
8. <iin>ИИН субъекта</iin>
9. <token>Токен КДП</token>
10. <consent>Согласие субъекта</consent>
11. </data:getInfoDegreeWorkerUseToken>
12. </soapenv:Body>
13. </soapenv:Envelope>
Пример ответа на вызов методов getInfoDegreeWorker и getInfoDegreeWorkerUseToken
Пример ответа [Показать ответ]
1<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2 <soap:Body wsu:Id="id-D927B52BE810283BC71678167574122119429" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
3 <ns2:SendMessageResponse xmlns:ns2="http://bip.bee.kz/SyncChannel/v10/Types">
4 <response>
5 <responseInfo>
6 <messageId>Идентификатор сообщения</messageId>
7 <responseDate>Дата ответа</responseDate>
8 <status>
9 <code>КОД</code>
10 <message>Сообщение о статусе</message>
11 </status>
12 <sessionId>Идентификатор сессии</sessionId>
13 </responseInfo>
14 <responseData>
15 <data>
16 <data>
17 <ResponseInfoInv>
18 <responseNumber>Номер отчета</responseNumber>
19 <iin>ИИН пострадавшего работника</iin>
20 <gruppaInv>Группа инвалидности</gruppaInv>
21 <appointDate>Дата назначения</appointDate>
22 <endDateExpertise>Дата окончания</endDateExpertise>
23 <srokInv>Срок инвалидности</srokInv>
24 <dataOkonInv>Дата окончания инвалидности</dataOkonInv>
25 <reExaminationDate>Дата повторного осмотра</reExaminationDate>
26 <numberAct>Номер АКТа</numberAct>
27 <srokZachtenS>Срок начала</srokZachtenS>
28 <prInv>Причина инвалидности</prInv>
29 <IPRNumber>Номер ИПРН </IPRNumber>
30 <mainDiagnosis>Основной диагноз</mainDiagnosis>
31 <mseName>Наименования МСЭ</mseName>
32 <hospitalName>Наименования мед. учреждения</hospitalName>
33 <workPlace>Место работы</workPlace>
34 <workPosition>Должность</workPosition>
35 <mseZakl>Заключение МСЭ</mseZakl>
36 <medicalRehabilation>Медицинская реабилитация</medicalRehabilation>
37 </ResponseInfoInv>
38 <ResponseInfoDegreeWorker>
39 <ResponseInfoDegreeWorkerData>
40 <dateSurvey>Дата освидетельствования, в формате dd.mm.yyyy</dateSurvey>
41 <degree>Степень УПТ, %</degree>
42 <termDegree>Срок степени УПТ</termDegree>
43 <srokUPT>Срок УПТ</srokUPT>
44 <dateTermDegree>Срок зачтен с, в формате dd.mm.yyyy</dateTermDegree>
45 <numberN1>Номер Н1</numberN1>
46 <nameOrg>Наименования организации</nameOrg>
47 <referenceUpt>Справка УПТ</referenceUpt>
48 </ResponseInfoDegreeWorkerData>
49 <ResponseInfoDegreeWorkerData>
50 <dateSurvey>Дата освидетельствования, в формате dd.mm.yyyy</dateSurvey>
51 <degree>Степень УПТ, %</degree>
52 <termDegree>Срок степени УПТ</termDegree>
53 <srokUPT>Срок УПТ</srokUPT>
54 <dateTermDegree>Срок зачтен с, в формате dd.mm.yyyy</dateTermDegree>
55 <numberN1>33</numberN1>
56 <nameOrg>Наименования организации</nameOrg>
57 <referenceUpt>Справка УПТ</referenceUpt>
58 </ResponseInfoDegreeWorkerData>
59 </ResponseInfoDegreeWorker>
60 <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
61 <ds:SignedInfo>
62 <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
63 <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34310-gost34311"/>
64 <ds:Reference URI="">
65 <ds:Transforms>
66 <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
67 <ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/>
68 </ds:Transforms>
69 <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34311"/>
70 <ds:DigestValue>Ваш DigestValue</ds:DigestValue>
71 </ds:Reference>
72 </ds:SignedInfo>
73 <ds:SignatureValue>Ваш SignatureValue</ds:SignatureValue>
74 <ds:KeyInfo>
75 <ds:X509Data>
76 <ds:X509Certificate>Ваш X509Certificate</ds:X509Certificate>
77 </ds:X509Data>
78 </ds:X509Data>
79 </ds:KeyInfo>
80 </ds:Signature>
81 </data>
82 </data>
83 </responseData>
84 </response>
85 </ns2:SendMessageResponse>
86 </soap:Body>
87 </soap:Envelope>
Обработка исключений
При обработке запроса методов getInfoDegreeWorker и getInfoDegreeWorkerUseToken может возвращать следующие виды ошибок: [Показать ответ]
| Код ошибки | Описание ошибки |
|---|---|
| SBF-VE-8 | Номер "ИИН" должен содержать 12 цифр |
| VAL-JSR-001 | Обязательное поле "%s" отсутствует |
| SBF-AD-1 | Пользователь %s не имеет прав для выполнения действия |
| FAULT-015 | Сервис на стороне ГБД недоступен |
| VAL-R-004 | Для получения отчета необходимо подтвердить согласие субъекта на запрос его данных из ГБД |
| Главная страница | Предыдущая страница |