SetAgentDetails

Материал из Wiki ГКБ
Перейти к навигации Перейти к поиску

Назначение

Метод SetAgentDetails предназначен для сохранения ФИО/Наименования и информации об адресах, телефонах и документах Страховых агентов в систему ЕСБД.
Позволяет создать новую запись или внести изменения в имеющуюся.

Параметры

  • aSessionID Идентификатор сессии
  • aAgentDetails структура класса AGENT_DETAILS

Состав данных

Состав данных для передачи в ЕСБД <aAgentDetails></aAgentDetails>
Наименование Тип данных Описание Примечание Обязательность
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:
1 - Мин Юст РК;
2 - МВД РК;
3 - МИД РК;
4 - Прочие уполномоченные органы; id на BETA TEST ESBD
Для получения актуальных Id используйте GetItems
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:
1 - Мин Юст РК;
2 - МВД РК;
3 - МИД РК;
4 - Прочие уполномоченные органы; id на BETA TEST ESBD
Для получения актуальных Id используйте GetItems
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 Посредник не найден
Источник — https://wiki.gkb.kz/?title=SetAgentDetails&oldid=6776