SetAgentDetails
Назначение
Метод SetAgentDetails предназначен для сохранения ФИО/Наименования и информации об адресах, телефонах и документах Страховых агентов в систему ЕСБД.
Позволяет создать новую запись или внести изменения в имеющуюся.
Параметры
- aSessionID Идентификатор сессии
- aAgentDetails структура класса AGENT_DETAILS
Состав данных
| Наименование | Тип данных | Описание | Примечание | Обязательность |
|---|---|---|---|---|
| AGENT_DETAIL_ID | s:int |
Идентификатор детализации по агенту (ID) | ||
| MIDDLEMAN_ID | s:int |
Идентификатор агента (ID) | MIDDLEMAN | ✓ |
| AGENT_TITLE | s:string |
Наименование/ФИО агента | ||
| ADDRESS | s:string |
Адрес (фактический/регистрации) | ✓ | |
| JURIDICAL_ADDRESS | s:string |
Юридический адрес/Адрес прописки | ||
| PHONES | s:string |
Контактные телефонные номера | ✓ | |
| DOCUMENT_TYPE_ID | s:int |
Идентификатор Типа документа (ID) | Допустимые значения для document_type_id:
|
|
| DOCUMENT_NUMBER | s:string |
Номер документа | ||
| DOCUMENT_GIVED_BY_ID | s:int |
Идентификатор органа выдавшего документ (ID) | Допустимые значения для document_gived_by:
|
|
| DOCUMENT_GIVED_DATE | s:string |
Когда выдан документ | в формате dd.mm.yyyy | |
| CRIMINAL_CERT_NUMBER | s:string |
Номер справки о несудимости | ||
| CRIMINAL_CERT_GIVED_BY_ID | s:int |
Идентификатор органа выдавшего справку о несудимости (ID) | Допустимые значения для criminal_cert_gived_by:
6 - КПСиСУ ГП РК |
|
| CRIMINAL_CERT_GIVED_DATE | s:string |
Дата выдачи справки о несудимости | в формате dd.mm.yyyy |
Состав данных ответа на запрос сохранения/изменения информации <SetAgentDetailsResult></SetAgentDetailsResult>
| Наименование | Тип данных | Описание | Примечание |
|---|---|---|---|
| AGENT_DETAIL_ID | s:int |
Идентификатор детализации по агенту (ID) | |
| MIDDLEMAN_ID | s:int |
Идентификатор агента (ID) | MIDDLEMAN |
| MIDDLEMAN | s:string |
Ссылка на агента | |
| AGENT_TITLE | s:string |
Наименование/ФИО агента | |
| ADDRESS | s:string |
Адрес (фактический/регистрации) | |
| JURIDICAL_ADDRESS | s:string |
Юридический адрес/Адрес прописки | |
| PHONES | s:string |
Контактные телефонные номера | |
| DOCUMENT_TYPE_ID | s:int |
Идентификатор Типа документа (ID) | Допустимые значения для document_type_id:
|
| DOCUMENT_TYPE | s:string |
Тип документа (наименование) | |
| DOCUMENT_NUMBER | s:string |
Номер документа | |
| DOCUMENT_GIVED_BY_ID | s:int |
Идентификатор органа выдавшего документ (ID) | Допустимые значения для document_gived_by:
|
| DOCUMENT_GIVED_BY | s:string |
Кем выдан документ (наименование) | |
| DOCUMENT_GIVED_DATE | s:string |
Когда выдан документ | в формате dd.mm.yyyy |
| CRIMINAL_CERT_NUMBER | s:string |
Номер справки о несудимости | |
| CRIMINAL_CERT_GIVED_BY_ID | s:int |
Идентификатор органа выдавшего справку о несудимости (ID) | Допустимые значения для criminal_cert_gived_by:
6 - КПСиСУ ГП РК |
| CRIMINAL_CERT_GIVED_BY | s:string |
Кем выдана справка о несудимости (наименование) | |
| CRIMINAL_CERT_GIVED_DATE | s:string |
Дата выдачи справки о несудимости | в формате dd.mm.yyyy |
| SYSTEM_DELIMITER_ID | s:int |
Идентификатор Страховой компании (ID) | |
| SYSTEM_DELIMITER | s:string |
Страховая компания (наименование) |
Примеры запросов
Если идентификатор посредника AGENT_DETAIL_ID больше нуля, то редактируется запись, иначе добавляет нового.
Тэг <iic:INPUT_DATE/> может быть передан для внесения ретроактивных данных по документам и/или ФИО/Наименование. Если агент новый, тэг не заполняется.
SetAgentDetails запрос на сохранение новой записи <iic:aAgentDetails></iic:aAgentDetails>
1<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:iic="https://icweb/IICWebService">
2 <soapenv:Header/>
3 <soapenv:Body>
4 <iic:SetAgentDetails>
5 <iic:aSessionID>********************************</iic:aSessionID>
6 <iic:aAgentDetails>
7 <iic:MIDDLEMAN_ID>21**89</iic:MIDDLEMAN_ID>
8 <iic:AGENT_TITLE>ТЕСТ ИП Тест Тестович</iic:AGENT_TITLE>
9 <iic:ADDRESS>тест</iic:ADDRESS>
10 <iic:JURIDICAL_ADDRESS>тест</iic:JURIDICAL_ADDRESS>
11 <iic:PHONES>7 777 777 777</iic:PHONES>
12 <iic:DOCUMENT_TYPE_ID>1</iic:DOCUMENT_TYPE_ID>
13 <iic:DOCUMENT_NUMBER>тест 1</iic:DOCUMENT_NUMBER>
14 <iic:DOCUMENT_GIVED_BY_ID>1</iic:DOCUMENT_GIVED_BY_ID>
15 <iic:DOCUMENT_GIVED_DATE>01.01.2023</iic:DOCUMENT_GIVED_DATE>
16 <iic:CRIMINAL_CERT_NUMBER>тест 2</iic:CRIMINAL_CERT_NUMBER>
17 <iic:CRIMINAL_CERT_GIVED_BY_ID>6</iic:CRIMINAL_CERT_GIVED_BY_ID>
18 <iic:CRIMINAL_CERT_GIVED_DATE>31.01.2023</iic:CRIMINAL_CERT_GIVED_DATE>
19 <iic:INPUT_DATE>12.12.2022</iic:INPUT_DATE>
20 </iic:aAgentDetails>
21 </iic:SetAgentDetails>
22 </soapenv:Body>
23</soapenv:Envelope>
SetAgentDetails ответ на запрос сохранения новой записи <SetAgentDetailsResult></SetAgentDetailsResult>
1<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
2 <soap:Body>
3 <SetAgentDetailsResponse xmlns="https://icweb/IICWebService">
4 <SetAgentDetailsResult>
5 <AGENT_DETAIL_ID>***</AGENT_DETAIL_ID>
6 <MIDDLEMAN_ID>21***89</MIDDLEMAN_ID>
7 <MIDDLEMAN>*****************</MIDDLEMAN>
8 <AGENT_TITLE>ТЕСТ ИП Тест Тестович</AGENT_TITLE>
9 <ADDRESS>тест</ADDRESS>
10 <JURIDICAL_ADDRESS>тест</JURIDICAL_ADDRESS>
11 <PHONES>7 777 777 777</PHONES>
12 <DOCUMENT_TYPE_ID>1</DOCUMENT_TYPE_ID>
13 <DOCUMENT_TYPE>Удостоверение личности</DOCUMENT_TYPE>
14 <DOCUMENT_NUMBER>тест 1</DOCUMENT_NUMBER>
15 <DOCUMENT_GIVED_BY_ID>1</DOCUMENT_GIVED_BY_ID>
16 <DOCUMENT_GIVED_BY>МВД РК</DOCUMENT_GIVED_BY>
17 <DOCUMENT_GIVED_DATE>01.01.2023</DOCUMENT_GIVED_DATE>
18 <CRIMINAL_CERT_NUMBER>тест 2</CRIMINAL_CERT_NUMBER>
19 <CRIMINAL_CERT_GIVED_BY_ID>6</CRIMINAL_CERT_GIVED_BY_ID>
20 <CRIMINAL_CERT_GIVED_BY>КПСиСУ ГП РК</CRIMINAL_CERT_GIVED_BY>
21 <CRIMINAL_CERT_GIVED_DATE>31.01.2023</CRIMINAL_CERT_GIVED_DATE>
22 <SYSTEM_DELIMITER_ID>*</SYSTEM_DELIMITER_ID>
23 <SYSTEM_DELIMITER>*************</SYSTEM_DELIMITER>
24 <INPUT_DATE>12.12.2022 00:00:00</INPUT_DATE>
25 <CREATED_BY_USER_ID>15***</CREATED_BY_USER_ID>
26 <RECORD_CHANGED_AT>03.07.2023 11:57:16</RECORD_CHANGED_AT>
27 <CHANGED_BY_USER_ID>0</CHANGED_BY_USER_ID>
28 </SetAgentDetailsResult>
29 </SetAgentDetailsResponse>
30 </soap:Body>
31</soap:Envelope>
Исключения
| Код ошибки | Текст ошибки | Описание | Примечание |
|---|---|---|---|
EMD-0003 |
No Active records found for change | Для вашей СК нет активных записей для изменения | |
EMD-0004 |
Agent details not changed | в Детализации агента изменено 0 записей | |
EMD-0005 |
No records found for middleman_id | Посредник не найден |