GetAdmProtocols: различия между версиями

Версия от 06:54, 19 апреля 2023

Назначение

Метод GetAdmProtocols предназначен для получения сведений по административным протоколам по ИИН и ГРНЗ нарушителя.

Параметры

aSessionID Идентификатор сессии
aIIN ИИН субъекта
aGRNZ Государственный регистрационный номерной знак

Состав данных запроса на получение информации
№	Наименование	Поле	Тип данных	Обязательность
1	Идентификатор сессии	aSessionID	s:string	✓
2	ИИН субъекта	aIIN	s:string	✓
3	Государственный регистрационный номерной знак	aGRNZ	s:string	✓

Пример вызова метода

GetAdmProtocols получение административного протокола

 1 <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:iic="https://icweb/IICWebService">
 2   <soap:Header/>
 3   <soap:Body>
 4      <iic:GetAdmProtocols>
 5         <iic:aSessionID>*******************</iic:aSessionID>
 6         <iic:aIIN>************</iic:aIIN>
 7         <iic:aGRNZ>O2*******</iic:aGRNZ>
 8      </iic:GetAdmProtocols>
 9   </soap:Body>
10</soap:Envelope>

Возвращаемое значение

Состав данных ответа на запрос получения информации <SUBJECT></SUBJECT>

Состав данных ответа на запрос получения информации
Наименование	Тип данных	Описание	Примечание	Обязательность	NEW
IIN	s:string	ИИН нарушителя		✓	✓
LNAME	s:string	Фамилия нарушителя		✓	✓
FNAME	s:string	Имя нарушителя		✓	✓
MNAME	s:string	Отчество нарушителя		✓	✓
BIRTHDAY	s:string	Дата рождения нарушителя	в формате dd.mm.yyyy	✓	✓
GRNZ_SUBJECT	s:string	ГРНЗ нарушителя		✓	✓
CASE_NUMBER	s:string	Номер кейса		✓	✓
PARTICIPANTS	s:list	Участники Адм. протокола	PARTICIPANT	✓	✓
PARTICIPANT_DOCUMENTS	s:list	Документы участников Адм. протокола	DOCUMENT	✓	✓
DOCUMENTS	s:list	Документы Адм. протокола	DOCUMENT	✓	✓

Пример ответа на вызов метода

<GetAdmProtocolsResult></GetAdmProtocolsResult>

 1  <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
 2  <soap:Body>
 3      <GetAdmProtocolsResponse xmlns="https://icweb/IICWebService">
 4         <GetAdmProtocolsResult>
 5            <SUBJECT>
 6               <IIN>************</IIN>
 7               <LNAME>*******</LNAME>
 8               <FNAME>*******</FNAME>
 9               <MNAME>***********</MNAME>
10               <BIRTHDAY>16.07.1995</BIRTHDAY>
11               <GRNZ_SUBJECT>O2*******</GRNZ_SUBJECT>
12               <CASE_NUMBER>232310030026827</CASE_NUMBER>
13               <PARTICIPANTS>
14                  <PARTICIPANT>
15                     <IIN>************</IIN>
16                     <LNAME>***********</LNAME>
17                     <FNAME>********</FNAME>
18                     <BIRTHDAY>22.03.2023</BIRTHDAY>
19                     <GRNZ_VICTIM>******06</GRNZ_VICTIM>
20                     <PARTICIPANT_TYPE>Потерпевшие</PARTICIPANT_TYPE>
21                  </PARTICIPANT>
22                  <PARTICIPANT>
23                     <IIN>************</IIN>
24                     <LNAME>*********</LNAME>
25                     <FNAME>******</FNAME>
26                     <BIRTHDAY>22.03.2023</BIRTHDAY>
27                     <GRNZ_VICTIM>8*****06</GRNZ_VICTIM>
28                     <PARTICIPANT_TYPE>Потерпевшие</PARTICIPANT_TYPE>
29                  </PARTICIPANT>
30               </PARTICIPANTS>
31               <PARTICIPANT_DOCUMENTS/>
32               <DOCUMENTS>
33                  <DOCUMENT>
34                     <DOCUMENT_ID>72**026d-****-****-****-******81**51</DOCUMENT_ID>
35                     <DOCUMENT_NAME>Фотофиксация составления протокола-232***********.jpg</DOCUMENT_NAME>
36                     <DOCUMENT_CONTENT>BASE64</DOCUMENT_CONTENT>
37                  <DOCUMENT>
38                     <DOCUMENT_ID>b0**c3e1-****-****-****-******26**86</DOCUMENT_ID>
39                     <DOCUMENT_NAME>9 СТРАХОВКА.PDF</DOCUMENT_NAME>
40                     <DOCUMENT_CONTENT>BASE64</DOCUMENT_CONTENT>
41			     </DOCUMENT>
42                 <DOCUMENT>
43                     <DOCUMENT_ID>56**75fb-****-****-****-*******e5**52</DOCUMENT_ID>
44                     <DOCUMENT_NAME>10 КПСИСУ.PDF</DOCUMENT_NAME>
45                     <DOCUMENT_CONTENT>BASE64</DOCUMENT_CONTENT>
46				  </DOCUMENT>
47              </DOCUMENTS>
48            </SUBJECT>
49         </GetAdmProtocolsResult>
50      </GetAdmProtocolsResponse>
51   </soap:Body>
52</soap:Envelope>

Обработка исключений при вызове метода GetAdmProtocols

Обработка исключений метода GetAdmProtocols
Код/Текст ошибки/сообщения	Описание ошибки/сообщения	Примечание
Нет договоров по заданным параметрам	в случае если нет ни одного административного протокола по нарушителю
Неверный ИИН	в случае если количество символов ИИН нарушителя не равен 12
Субъект не найден	в случае если ИИН нарушителя не существует в базе ЕСБД
Не заполнены обязательные поля	в случае если ИИН или ГРНЗ нарушителя пустые
Неожиданная ошибка

@@ Строка 14: / Строка 14: @@
 !Обязательность
 !Примечание
-!NEW
 |-
 |1
@@ Строка 22: / Строка 21: @@
 |<span style="color:#ff0000"><p align="center">'''✓'''</p></span>
 |
-|<span style="color:#ff0000"><p align="center">'''✓'''</p></span>
 |-
 |-
@@ Строка 31: / Строка 29: @@
 |<span style="color:#ff0000"><p align="center">'''✓'''</p></span>
 |
-|<span style="color:#ff0000"><p align="center">'''✓'''</p></span>
 |-
 |-
@@ Строка 40: / Строка 37: @@
 |<span style="color:#ff0000"><p align="center">'''✓'''</p></span>
 |
-|<span style="color:#ff0000"><p align="center">'''✓'''</p></span>
 |}
-== Пример вызова для TESTESBD-BETA ==
+== Пример вызова метода ==
+<div class="toccolours mw-collapsible mw-collapsed" style="width:1500px" data-expandtext="Показать пример" data-collapsetext="Скрыть">
+'''GetAdmProtocols получение административного протокола'''
+<div class="mw-collapsible-content">
 <syntaxhighlight lang="xml" line="1">
   <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:iic="https://icweb/IICWebService">
@@ Строка 57: / Строка 55: @@
     </soap:Body>
 </soap:Envelope>
-</syntaxhighlight>
+</syntaxhighlight></div>
+</div>
+<br/>
-==Возвращаемое значение <SUBJECT></SUBJECT>==
+== Возвращаемое значение ==
+<div class="toccolours mw-collapsible mw-collapsed" style="width:1500px" data-expandtext="Показать" data-collapsetext="Скрыть">
+'''Состав данных ответа на запрос получения информации <SUBJECT></SUBJECT>'''
+<div class="mw-collapsible-content">
 {| class="wikitable"
 |+Состав данных ответа на запрос получения информации
@@ Строка 139: / Строка 142: @@
 |<span style="color:#ff0000"><p align="center">'''✓'''</p></span>
 |<span style="color:#ff0000"><p align="center">'''✓'''</p></span>
-|}
+|}</div>
+</div>
-== Пример ответа на вызов метода GetAdmProtocols TESTESBD-BETA ==
+== Пример ответа на вызов метода ==
+<div class="toccolours mw-collapsible mw-collapsed" style="width:1500px" data-expandtext="Показать пример" data-collapsetext="Скрыть">
+'''<GetAdmProtocolsResult></GetAdmProtocolsResult>'''
+<div class="mw-collapsible-content">
 <syntaxhighlight lang="xml" line="1">
    <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
@@ Строка 232: / Строка 238: @@
 |-
 |}
+</div>
+</div>