В данной статье описывается принцип работы сервиса, предоставляющего сведения для заключения договора пенсионного аннуитета (ДПА) или дополнительного соглашения к ДПА, и сервиса, предоставляющего статусы по ДПА и ДС к ДПА посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.
Сервис, предоставляющий сведения для заключения договора пенсионного аннуитета или ДС к ДПА и статусов по договорам
При вызове веб-сервиса обязательно указываются следующие параметры:
- 1. ID и пароль клиента (организации) в HTTP Header, необходимые для базовой аутентификации. Так как коммуникация с веб-сервисами системы идет по защищенному протоколу HTTPS, то базовая аутентификация представляется безопасным решением.
- 2. ID пользователя, от имени которого будет выполнена запрашиваемая операция в SOAP Header:
Http Headers: {Authorization=[Basic c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2]}
Метод getPreInfo
Посредством данного метода страховщику возвращаются сведения из ЕНПФ по субъекту (клиенту), необходимые для заключения ДПА или ДС к ДПА. На основании данных сведений страховщик принимает решение о заключении ДПА или ДС к ДПА.
Состав данных запроса getPreInfo: [Показать ответ]
№
|
Наименование
|
Поле
|
Формат
|
Примечание
|
1
|
Идентификационный номер пользователя
|
userId
|
xs:string
|
|
2
|
Идентификатор страховой организации
|
ICCode
|
xs:string
|
|
3
|
Индивидуальный идентификационный номер
|
IIN
|
xs:string
|
ИИН страхователя
|
4
|
Идентификатор согласия страхователя на передачу сведений в СО
|
InfoID
|
xs:string
|
Идентификатор, присвоенный ЕНПФ при подписании согласия на передачу сведений в СО через ГКБ
|
|
Состав данных ответа getPreInfo: [Показать ответ]
№
|
Наименование
|
Поле
|
Формат
|
Примечание
|
1
|
Идентификатор сообщения в системе получателя
|
messageId
|
xs:string
|
|
2
|
Дата ответа
|
responseDate
|
xs:string
|
|
3
|
Идентификатор корреляции
|
correlationId
|
xs:string
|
|
4
|
Идентификатор согласия страхователя на передачу сведений в СО
|
info_ID
|
xs:string
|
Идентификатор, присвоенный ЕНПФ при подписании согласия на передачу сведений в СО через ГКБ
|
5
|
Пенсионные накопления за счет ОПВ, подлежащие переводу в СО
|
sumOPV
|
xs:string
|
Суммы, доступные для перевода в СО, указанные страхователем и подтвержденные ЕНПФ
|
6
|
Пенсионные накопления за счет ОППВ, подлежащие переводу в СО
|
sumOPPV
|
xs:string
|
|
7
|
Пенсионные накопления за счет ДПВ, подлежащие переводу в СО
|
sumDPV
|
xs:string
|
|
8
|
Наличие уплаченных в ЕНПФ ОППВ в совокупности не менее 60 календарных месяцев
|
has60OPPV
|
xs:string
|
0-нет
1-да
|
|
Пример вызова метода getPreInfo: [Показать ответ]
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
<soapenv:Header>
<userId>BILLING.SSL.INTEGRATOR</userId>
</soapenv:Header>
<soapenv:Body>
<data:getPreInfo>
<ICCode>1</ICCode>
<IIN>ИИН</IIN>
<InfoID>1234567890ABC</InfoID>
</data:getPreInfo>
</soapenv:Body>
</soapenv:Envelope>
Пример ответа на вызов метода getPreInfo: [Показать ответ]
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:getPreInfoResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
<return>
<response>
<responseInfo>
<messageId>ade9ec72-48b0-4575-a359-38f56edf53a7</messageId>
<correlationId>Cmm2R_mkTep7Yi0ohMxfIk_9hmw9RyFPHvUvr-Gy</correlationId>
<responseDate>2023-12-04T12:35:30.481754267+06:00</responseDate>
</responseInfo>
<responseData>
<data xmlns:ns2="http://bip.bee.kz/SyncChannel/v10/Types">
<PRE_INFO>
<info_ID>1234567890ABC</info_ID>
<sumOPV>1</sumOPV>
<sumOPPV>3</sumOPPV>
<sumDPV>2</sumDPV>
<has60OPPV>1</has60OPPV>
</PRE_INFO>
</data>
</responseData>
</response>
<gbdStatusResponse xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</return>
</ns2:getPreInfoResponse>
</soap:Body>
</soap:Envelope>
Справочник наименований (ЕНПФ и страховых организаций): [Показать ответ]
Наименование организации
|
Код
|
АО «ЕНПФ»
|
1
|
АО «Дочерняя компания Народного Банка Казахстана по страхованию жизни «Халык-Life»
|
2
|
АО «Компания по страхованию жизни «Freedom Finance Life»
|
3
|
АО «Компания по страхованию жизни «Standard Life»
|
4
|
АО «Компания по страхованию жизни «Евразия»
|
5
|
АО «Компания по страхованию жизни «Nomad LIFE»
|
6
|
АО «Компания по страхованию жизни «Коммеск-Өмір»
|
7
|
АО «Компания по страхованию жизни «Государственная аннуитетная компания»
|
8
|
|
Метод getDpaSts
Посредством метода страховщик получает сведения по статусу запрашиваемого идентификатора договора пенсионного аннуитета. Справочник причин отказа в переводе пенсионных накоплений в страховую организацию приложен ниже.
Состав данных запроса getDpaSts: [Показать ответ]
№
|
Наименование
|
Поле
|
Формат
|
1
|
Индивидуальный идентификационный номер пользователя
|
userId
|
xs:string
|
2
|
ID ДПА в ЕСБД
|
ContractID
|
xs:string
|
|
Состав данных ответа getDpaSts: [Показать ответ]
№
|
Наименование
|
Поле
|
Формат
|
Примечание
|
1
|
Идентификатор сообщения в системе получателя
|
messageId
|
xs:string
|
|
2
|
Идентификатор корреляции
|
correlationId
|
xs:string
|
|
3
|
Дата ответа
|
responseDate
|
xs:string
|
|
4
|
Идентификатор корреляции
|
correlationId
|
xs:string
|
|
5
|
Идентификатор контракта
|
contractID
|
xs:string
|
|
6
|
Идентификатор ДС контракта
|
addcontractID
|
xs:string
|
|
7
|
Сообщение
|
message
|
xs:string
|
|
8
|
1.1.3 Код статуса ДПА
(результат обработки полученных сведений о заключенном ДПА и (или) ДС к ДПА) Числовой status Да Указывается согласно кодировке
-1 – не найдено (ДПА отсутствует в ИС ЕНПФ);
0 – в обработке;
1 – перевод накоплений осуществлен;
2 – отказано в переводе накоплений
|
status
|
xs:string
|
Указывается согласно кодировке
-1 – не найдено (ДПА отсутствует в ИС ЕНПФ);
0 – в обработке;
1 – перевод накоплений осуществлен;
2 – отказано в переводе накоплений
|
9
|
Дата перевода либо отказа в переводе страховой премии
|
completDate
|
xs:string
|
Да для кода статуса ДПА - [1, 2]
|
10
|
Код причины отказа
|
reasonCode
|
xs:string
|
Код причины отказа в осуществлении перевода страховой премии в соответствии со справочником
|
11
|
Статус ДПА в текстовом виде
|
statusMessage
|
xs:string
|
|
12
|
Статус ДПА в текстовом виде на гос. языке
|
statusMessageKZ
|
xs:string
|
|
|
Пример вызова метода getDpaSts с помощью SOAP запроса имеет следующий вид: [Показать ответ]
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
<soapenv:Header>
<userId>Индивидуальный идентификационный номер пользователя</userId>
</soapenv:Header>
<soapenv:Body>
<data:getDpaSts>
<ContractID>Идентификатор контракта</ContractID>
</data:getDpaSts>
</soapenv:Body>
</soapenv:Envelope>
Пример ответа на вызов метода getDpaSts с помощью SOAP запроса имеет следующий вид: [Показать ответ]
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:getDpaStsResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
<return>
<response>
<responseInfo>
<messageId>707f4a3e-56cd-4970-8356-c56bb2aad6fb</messageId>
<correlationId>4U4ESRC9fSOd8KPL8YqjDjcBW_IC1W_ymaLDXEzH</correlationId>
<responseDate>2023-12-04T10:40:12.589940337+06:00</responseDate>
</responseInfo>
<responseData>
<data xmlns:ns2="http://bip.bee.kz/SyncChannel/v10/Types">
<DPA_STS>
<contractList>
<contract>
<contractID>Идентификатор контракта</contractID>
<status>-1</status>
</contract>
</contractList>
</DPA_STS>
</data>
</responseData>
</response>
<gbdStatusResponse xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</return>
</ns2:getDpaStsResponse>
</soap:Body>
</soap:Envelope>
Справочник причин отказа в переводе пенсионных накоплений в страховую организацию [Показать ответ]
Причина отказа в переводе пенсионных накоплений
|
Код причины отказа
|
несоответствие страхователя категориям лиц, указанных в пункте 1 статьи 207, подпункте 4) пункта 1 статьи 220, подпункте 4) пункта 1 статьи 221 Кодекса
|
1
|
размер ежемесячной страховой выплаты страхователя меньше размера, установленного Кодексом и действующего на дату заключения ДПА
|
2
|
сумма пенсионных накоплений на соответствующих индивидуальных пенсионных счетах страхователя на дату перевода пенсионных накоплений меньше суммы пенсионных накоплений, указанных в ДПА или ДС к ДПА
|
3
|
недействительность документа, удостоверяющего личность страхователя на дату заключения ДПА или ДС к ДПА
|
4
|
смерть страхователя
|
5
|
|
Обработка исключений методов getPreInfo и getDpaSts
При обработке запроса методов getPreinfo и getDpaSts может возвращать следующие виды ошибок: [Показать ответ]
Код ошибки
|
Описание ошибки
|
SBF-VE-8
|
Номер "ИИН/БИН" должен содержать 12 цифр
|
VAL-JSR-001
|
Обязательное поле "IINBIN" отсутствует
|
SBF-AD-1
|
Пользователь %s не имеет прав для выполнения действия
|
SBF-AD-1
|
Пользователь не соответствует данному кредитору
|
SBF-AD-1
|
Пользователь %s не активен
|
FAULT-015
|
Сервис на стороне ГБД недоступен
|
FAULT-015
|
Ошибка обработки сообщения на стороне ГБД
|
FAULT-015
|
Null value exception
|
|