Подсистема обмен УНПФ: различия между версиями

Материал из OrticonWiki
Перейти к навигации Перейти к поиску
← Предыдущая правка

Vakhrulina (обсуждение | вклад)

1 группа участника
5057 правок
Нет описания правки
м Vakhrulina переименовал страницу ПодсистемаОбменУНПФ в Подсистема обмен УНПФ
 
(не показано 50 промежуточных версий этого же участника)
Строка 37: Строка 37:
*[[#6.1 Авторизация|<span style="color:#000000"><small>6.1 Авторизация</small></span>]]
*[[#6.1 Авторизация|<span style="color:#000000"><small>6.1 Авторизация</small></span>]]
*[[#6.2 Общие сервисы. (StatusExchange) Подтверждение успешного обмена (НПО/ПДС/ОПС)|<span style="color:#000000"><small>6.2 Общие сервисы. (StatusExchange) Подтверждение успешного обмена (НПО/ПДС/ОПС)</small></span>]]
*[[#6.2 Общие сервисы. (StatusExchange) Подтверждение успешного обмена (НПО/ПДС/ОПС)|<span style="color:#000000"><small>6.2 Общие сервисы. (StatusExchange) Подтверждение успешного обмена (НПО/ПДС/ОПС)</small></span>]]
*[[#6.2.1 Описание параметров, которые следует учесть в сообщении при обмене|<span style="color:#000000"><small>6.2.1 Описание параметров, которые следует учесть в сообщении при обмене</small></span>]]
*[[#6.2.2 Описание запроса и ответа для подтверждения успешного принятия сообщения из сервиса|<span style="color:#000000"><small>6.2.2 Описание запроса и ответа для подтверждения успешного принятия сообщения из сервиса</small></span>]]
*[[#6.3 Общие сервисы. (ClientsChg_Request) Обмен изменениями по Клиентам|<span style="color:#000000"><small>6.3 Общие сервисы. (ClientsChg_Request) Обмен изменениями по Клиентам</small></span>]]
*[[#6.3 Общие сервисы. (ClientsChg_Request) Обмен изменениями по Клиентам|<span style="color:#000000"><small>6.3 Общие сервисы. (ClientsChg_Request) Обмен изменениями по Клиентам</small></span>]]
*[[#6.3.1 Описание параметров, которые подлежат регистрации по ФЛ/ЮЛ и используются при обмене данными|<span style="color:#000000"><small>6.3.1 Описание параметров, которые подлежат регистрации по ФЛ/ЮЛ и используются при обмене данными</small></span>]]
*[[#6.3.1 Описание параметров, которые подлежат регистрации по ФЛ/ЮЛ и используются при обмене данными|<span style="color:#000000"><small>6.3.1 Описание параметров, которые подлежат регистрации по ФЛ/ЮЛ и используются при обмене данными</small></span>]]
Строка 49: Строка 51:
*[[#6.6 Сервисы по ОПС. (OPS_PSChg_Request) Обмен изменениями по Договорам (ОПС)|<span style="color:#000000"><small>6.6 Сервисы по ОПС. (OPS_PSChg_Request) Обмен изменениями по Договорам (ОПС)</small></span>]]
*[[#6.6 Сервисы по ОПС. (OPS_PSChg_Request) Обмен изменениями по Договорам (ОПС)|<span style="color:#000000"><small>6.6 Сервисы по ОПС. (OPS_PSChg_Request) Обмен изменениями по Договорам (ОПС)</small></span>]]
*[[#6.6.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными|<span style="color:#000000"><small>6.6.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными</small></span>]]
*[[#6.6.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными|<span style="color:#000000"><small>6.6.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными</small></span>]]
*[[#6.7 Сервисы по НПО. (NPO_OperationsChg_Request) Обмен изменениями в движениях по счету ПС и ПД (НПО)|<span style="color:#000000"><small>6.7 Сервисы по НПО. (NPO_OperationsChg_Request) Обмен изменениями в движениях по счету ПС и ПД (НПО)</small></span>]]
*[[#6.7.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете НПО и используются при обмене данными|<span style="color:#000000"><small>6.7.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете НПО и используются при обмене данными</small></span>]]
*[[#6.7.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (НПО)|<span style="color:#000000"><small>6.7.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (НПО)</small></span>]]
*[[#6.8 Сервисы по ПДС. (PDS_OperationsChg_Request) Обмен изменениями в движениях по счету ПС и ПД (ПДС)|<span style="color:#000000"><small>6.8 Сервисы по ПДС. (PDS_OperationsChg_Request) Обмен изменениями в движениях по счету ПС и ПД (ПДС)</small></span>]]
*[[#6.8.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете ПДС и используются при обмене данными|<span style="color:#000000"><small>6.8.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете ПДС и используются при обмене данными</small></span>]]
*[[#6.8.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС)|<span style="color:#000000"><small>6.8.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС)</small></span>]]
*[[#6.9 Сервисы по ОПС. (OPS_OperationsChg_Request) Обмен изменениями в движениях по Договору (ОПС)|<span style="color:#000000"><small>6.9 Сервисы по ОПС. (OPS_OperationsChg_Request) Обмен изменениями в движениях по Договору (ОПС)</small></span>]]
*[[#6.9.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными|<span style="color:#000000"><small>6.9.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными</small></span>]]
*[[#6.9.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС)|<span style="color:#000000"><small>6.9.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС)</small></span>]]
*[[#6.10 Общие сервисы. (ClientsID_Request) Получение полного списка идентификаторов клиентов (без персональных данных)|<span style="color:#000000"><small>6.10 Общие сервисы. (ClientsID_Request) Получение полного списка идентификаторов клиентов (без персональных данных)</small></span>]]
*[[#6.10.1 Описание объектов и параметров, которые используются при обмене данными|<span style="color:#000000"><small>6.10.1 Описание объектов и параметров, которые используются при обмене данными</small></span>]]
*[[#6.10.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам|<span style="color:#000000"><small>6.10.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам</small></span>]]
*[[#6.11 Общие сервисы. (ClientsInfo_Request) Получение информации по клиентам ЮЛ/ФЛ (персональные данные)|<span style="color:#000000"><small>6.11 Общие сервисы. (ClientsInfo_Request) Получение информации по клиентам ЮЛ/ФЛ (персональные данные)</small></span>]]
*[[#6.11.1 Описание объектов и параметров, которые используются при обмене данными|<span style="color:#000000"><small>6.11.1 Описание объектов и параметров, которые используются при обмене данными</small></span>]]
*[[#6.11.2 Описание полей запроса и ответа для получения информации по клиентам|<span style="color:#000000"><small>6.11.2 Описание полей запроса и ответа для получения информации по клиентам</small></span>]]
*[[#6.12 Сервисы по НПО. (NPO_PS_Request) Получить данные по ПС клиентов НПО|<span style="color:#000000"><small>6.12 Сервисы по НПО. (NPO_PS_Request) Получить данные по ПС клиентов НПО</small></span>]]
*[[#6.12.1 Описание объектов и параметров, которые используются при обмене данными|<span style="color:#000000"><small>6.12.1 Описание объектов и параметров, которые используются при обмене данными</small></span>]]
*[[#6.12.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам НПО|<span style="color:#000000"><small>6.12.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам НПО</small></span>]]
*[[#6.13 Сервисы по ПДС. (PDS_PS_Request) Получить данные по ПС клиентов ПДС|<span style="color:#000000"><small>6.13 Сервисы по ПДС. (PDS_PS_Request) Получить данные по ПС клиентов ПДС</small></span>]]
*[[#6.13.1 Описание объектов и параметров, которые используются при обмене данными|<span style="color:#000000"><small>6.13.1 Описание объектов и параметров, которые используются при обмене данными</small></span>]]
*[[#6.13.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам ПДС|<span style="color:#000000"><small>6.13.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам ПДС</small></span>]]
*[[#6.14 Сервисы по ОПС. (OPS_PS_Request) Получить данные по Договора клиентов ОПС|<span style="color:#000000"><small>6.14 Сервисы по ОПС. (OPS_PS_Request) Получить данные по Договора клиентов ОПС</small></span>]]
*[[#6.14.1 Описание объектов и параметров, которые используются при обмене данными|<span style="color:#000000"><small>6.14.1 Описание объектов и параметров, которые используются при обмене данными</small></span>]]
*[[#6.14.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам ПДС|<span style="color:#000000"><small>6.14.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам ПДС</small></span>]]
*[[#6.15 Сервисы по НПО. (NPO_Operations_Request) Получить данные выписки по ПС клиентов НПО|<span style="color:#000000"><small>6.15 Сервисы по НПО. (NPO_Operations_Request) Получить данные выписки по ПС клиентов НПО</small></span>]]
*[[#6.15.1 Описание объектов и параметров, которые используются при обмене данными|<span style="color:#000000"><small>6.15.1 Описание объектов и параметров, которые используются при обмене данными</small></span>]]
*[[#6.15.2 Описание Запроса и ответа получения полной выписки по ПС клиентов НПО|<span style="color:#000000"><small>6.15.2 Описание Запроса и ответа получения полной выписки по ПС клиентов НПО</small></span>]]
*[[#6.16 Сервисы по ПДС. (PDS_Operations_Request) Получить данные выписки по ПС клиентов ПДС|<span style="color:#000000"><small>6.16 Сервисы по ПДС. (PDS_Operations_Request) Получить данные выписки по ПС клиентов ПДС</small></span>]]
*[[#6.16.1 Описание объектов и параметров, которые используются при обмене данными|<span style="color:#000000"><small>6.16.1 Описание объектов и параметров, которые используются при обмене данными</small></span>]]
*[[#6.16.2 Описание Запроса и ответа получения полной выписки по ПС клиентов ПДС|<span style="color:#000000"><small>6.16.2 Описание Запроса и ответа получения полной выписки по ПС клиентов ПДС</small></span>]]
*[[#6.17 Сервисы по ОПС. (OPS_Operations_Request) Получить данные выписки по Договорам клиентов ОПС|<span style="color:#000000"><small>6.17 Сервисы по ОПС. (OPS_Operations_Request) Получить данные выписки по Договорам клиентов ОПС</small></span>]]
*[[#6.17.1 Описание объектов и параметров, которые используются при обмене данными|<span style="color:#000000"><small>6.17.1 Описание объектов и параметров, которые используются при обмене данными</small></span>]]
*[[#6.17.2 Описание Запроса и ответа получения полной выписки по ПС клиентов ОПС|<span style="color:#000000"><small>6.17.2 Описание Запроса и ответа получения полной выписки по ПС клиентов ОПС</small></span>]]
*[[#7 Приложения|<span style="color:#000000"><small>7 Приложения</small></span>]]
</div>
</div>
|style="vertical-align:top;|
|style="vertical-align:top;|
Строка 399: Строка 435:
Параметры этого обмена будут скорректированы по мере необходимости или по мере реализации.
Параметры этого обмена будут скорректированы по мере необходимости или по мере реализации.


<h2>'''6.2.1 Описание параметров, которые следует учесть в сообщении при обмене'''</h2>
<h2>'''6.2.1 Описание параметров, которые следует учесть в сообщении при обмене'''</h2>


Для подтверждения успешного прохождения обмена требуется передать информацию:
Для подтверждения успешного прохождения обмена требуется передать информацию:
Строка 407: Строка 443:
* номер последнего принятого сообщения.
* номер последнего принятого сообщения.


</h2>'''6.2.2 Описание запроса и ответа для подтверждения успешного принятия сообщения из сервиса'''</h2>
<h2>'''6.2.2 Описание запроса и ответа для подтверждения успешного принятия сообщения из сервиса'''</h2>


Входящие параметры:  
Входящие параметры:  
Строка 2343: Строка 2379:


<h2>'''6.6 Сервисы по ОПС. (OPS_PSChg_Request) Обмен изменениями по Договорам (ОПС)'''</h2>
<h2>'''6.6 Сервисы по ОПС. (OPS_PSChg_Request) Обмен изменениями по Договорам (ОПС)'''</h2>
Регистрация изменений ведется по всем Договорам (ОПС).


<h2>'''6.6.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными'''</h2>
<h2>'''6.6.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными'''</h2>
Объекты для учета регистрации изменений и последующей передаче через сервис
'''1. Объекты контроля для регистрации изменений:'''
1.1. Справочник.уп_ДоговорыОПС,
1.2. РС.уп_СостоянияДоговораОПС
1.3. РС.уп_ПричиныЗакрытияДоговоровОПС
1.4. РС.уп_ПериодичностьВыплатОПС
1.5. РС.уп_РазмерПенсииОПС
1.6. РС.уп_ЛицевыеСчетаЗастрахованныхЛиц
'''2. Извлекаемые данные из объектов контроля для передачи через сервис:'''
'''2.1. Договор (ОПС):'''
2.1.1. ГИУД ПД /
2.1.2. Код ПД /
2.1.3. ПД -ПометкаНаУдаление
2.1.4. Код участника/
2.1.5. ГИУД участника/
2.1.6. Состояние ПД /
2.1.7. Причина закрытия ПД /
2.1.8. Дата открытия ПД (накопит. период)/
2.1.9. Дата закрытия ПД /
2.1.10. Пенсионные параметры (По НП и СВ отдельно):
2.1.10.1. Дата назначения пенсии (Дата начала = 22.01.2024) /
2.1.10.2. Дата решения о назначении (01.03.2024)
2.1.10.3. Тип  пенсии = Пожизненная, срочная
2.1.10.4. Размер пенсии
2.1.10.5. Периодичность выплаты
2.1.10.6. Срок выплат
2.1.10.7. Дата окончания срочных выплат (из РС)
2.1.11. Единовременные выплаты (Данные по каждому Решению ЕВ):
2.1.11.1. Дата решения
2.1.11.2. Основание – вид заявления
2.1.11.3. Сумма к выплате
2.1.12. Переводы СПН в ПДС (Данные по каждому Решению):
2.1.12.1. Дата решения
2.1.12.2. Основание – вид заявления
2.1.12.3. Сумма
2.1.13. Назначенные выкупные суммы правопреемникам (Данные по каждому Решению ВС ПП):
2.1.13.1. Дата решения
2.1.13.2. Основание – вид заявления ()
2.1.13.3. Сумма к выплате
2.1.14. Платежные реквизиты (По НП и СВ отдельно)
2.1.14.1. Форма выплаты
2.1.14.2. Получатель (Участник\Банк) /
2.1.14.3. Тип ЛС
2.1.14.4. Номер ЛС
2.1.14.5. Расчетный счет
2.1.14.6. БИК Банка
<h2>'''6.6.2 Описание Запроса и ответа на Обмен изменениями по Договорам (ОПС)'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: [host]/…/OPS_PSChg_Request
'''Описание JSON запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|'''OPS_PSChg_Request'''
|
|-
|Без параметров
|
|
|}
'''Описание JSON ответа:'''
Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД узла изменений
|GUID
|-
|Msg
|Номер пакета сообщения
|Число
|}
Структура массива «clients»: массив объектов с информацией о пенсионных счетах ПДС контрагента
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД контрагента
|GUID
|-
|Exist
|Признак нахождения контрагента по ГУИД
|boolean
|-
|accounts
|массив Договоров ОПС
|Массив объектов
|}
Структура массива «accounts»: массив объектов с информацией, отраженной на Договоре ОПС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД пенсионного счета
|GUID
|-
|Code
|Код Договора ОПС
|Строка
|-
|CodeLS
|Код лицевого счета Договора ОПС
|Строка
|-
|DeletionMark
|Признак пометки на удаление пенсионного счета ПДС
|boolean
|-
|RefKeyUCH
|ГУИД контрагента-участника
|Строка
|-
|CodeUCH
|Код участника
|Строка
|-
|NameUCH
|Полное наименование участника (ФИО)
|Строка
|-
|TypeUCH
|Тип участника (1- Физическое лицо)
|Строка
|-
|State
|Текущее состояние Договора ОПС
|Строка
|-
|StopReason
|Причина закрытия Договора ОПС
|Строка
|-
|DateSign
|Дата заключения Договора ОПС
|Дата
|-
|DateOpen
|Дата открытия Договора ОПС
|Дата
|-
|DateClose
|Дата закрытия Договора ОПС
|Дата
|-
|InsurerPrev
|Информация о предыдущем Фонде
|Объект
|-
|InsurerNext
|Информация о следующем Фонде
|Объект
|-
|PensionNP
|Информация о назначенной накопительной пенсии
|Объект
|-
|PensionSV
|Информация о назначенной срочной выплате
|Объект
|-
|PaymentDetailsNP
|Информация о банковских реквизитах участника для накопительной пенсии
|Объект
|-
|PaymentDetailsSV
|Информация о банковских реквизитах участника для срочной выплаты
|Объект
|-
|OnePay
|Массив решений о единовременной выплате по договору
|Массив Объектов
|-
|PdsPay
|Массив решений о переводе СПН в ПДС
|Массив Объектов
|-
|OutPay
|Массив решений о выплате выкупных сумм ПП по Договору
|Массив Объектов
|-
|Balance
|Массив с информацией об остатке на ПС ПДС
|Массив Объектов
|}
Таблица. Значения Текущего состояние договора ОПС (State)
: {|class="wikitable"
! style="background:#EAECF0"| '''Значение'''
|-
|Заключен
|-
|Ожидание подтверждения ПФР
|-
|Ожидание поступления взносов
|-
|Накопительный период
|-
|Выплатной период
|-
|Приостановлен по отказу из ПФР
|-
|Подготовка к прекращению
|-
|Закрыт
|-
|Начисления приостановлены
|-
|Обязательства выполнены
|}
Таблица. Значения Причина закрытия договора ОПС (StopReason)
: {|class="wikitable"
! style="background:#EAECF0"| '''Значение'''
|-
|По смерти
|-
|Переход в другой ПФ
|-
|Переход в другой ПФ (досрочный)
|-
|Закрыт по отказу из ПФР
|-
|Аннулирование лицензии
|-
|Единовременная выплата
|-
|Не вступил в силу
|-
|По решению суда
|-
|Договор выполнен
|-
|Объединение СНИЛС
|-
|По иным причинам
|}
Состав объектов «InsurerPrev» и «InsurerNext»: информация о предыдущем и последующем страховщиках
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД страховщика
|Строка
|-
|Code
|Код страховщика
|Строка
|-
|Name
|Наименование страховщика
|Строка
|-
|INN
|ИНН страховщика
|Строка
|}
Состав объектов «PensionNP» и «PensionSV»: информация о назначенной периодической выплате
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DatePension
|Дата назначения пенсии
|Дата
|-
|DateDecision
|Дата решения о назначении пенсии
|Дата
|-
|Sum
|Размер пенсии
|Строка
|-
|Periodicity
|Периодичность выплаты пенсии
|Строка
|-
|Count
|Количество назначенных выплат. Для НП – не заполняется
|Целое число
|}
Состав объектов «PaymentDetailsNP» и «PaymentDetailsSV»: информация о банковских реквизитах участника по Договору
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DateDecision
|Дата решения о единовременной выплате
|Дата
|-
|RefKeyDecision
|ГУИД решения о единовременной выплате
|Строка
|-
|Decision
|Представление решения о единовременной выплате
|Строка
|-
|RefKeyStatement
|ГУИД документа основания принятия решения
|Строка
|-
|Statement
|Представление документа основания принятия решения
|Строка
|-
|ТуреDocStatement
|Тип документа основания принятия решения
|Строка
|-
|Sum
|Размер единовременной выплаты
|Денежный
|}
Структура массива «PdsPay»: информация о переводе СПН в ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DateDecision
|Дата решения о переводе СПН в ПДС
|Дата
|-
|RefKeyDecision
|ГУИД решения о переводе СПН в ПДС
|Строка
|-
|Decision
|Представление решения о переводе СПН в ПДС
|Строка
|-
|RefKeyStatement
|ГУИД документа основания принятия решения
|Строка
|-
|Statement
|Представление документа основания принятия решения
|Строка
|-
|ТуреDocStatement
|Тип документа основания принятия решения
|Строка
|-
|Sum
|Размер суммы перевода
|Денежный
|}
Структура массива «OutPay»: информация о выкупных суммах
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DateDecision
|Дата решения о выплате выкупной суммы ПП
|Дата
|-
|RefKeyDecision
|ГУИД решения о выплате выкупной суммы ПП
|Строка
|-
|Decision
|Представление решения о выплате выкупной суммы ПП
|Строка
|-
|RefKeyStatement
|ГУИД документа основания принятия решения
|Строка
|-
|Statement
|Представление документа основания принятия решения
|Строка
|-
|ТуреDocStatement
|Тип документа основания принятия решения
|Строка
|-
|Sum
|Размер суммы выплаты
|Денежный
|}
Структура массива «Balance»: информация об остатках по договору
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|TypeRes
|Тип резерва, на котором сформирован остаток
|Строка
|-
|TypeResId
|Тип резерва, на котором сформирован остаток (идентификатор)
|Строка
|-
|TypeSum
|Тип суммы остатка
|Строка
|-
|TypeSumId
|Тип суммы остатка (идентификатор)
|Строка
|-
|Sum
|Сумма
|Денежный
|}
<h2>'''6.7 Сервисы по НПО. (NPO_OperationsChg_Request) Обмен изменениями в движениях по счету ПС и ПД (НПО)'''</h2>
Регистрация изменений ведется по всем ПС и ПД в разрезе документов(регистраторов) по таблице Резервы НПО и типам резерва: ИПС/СПС/ Резерв наследников ИПС/ Резерв наследников СПС.
<h2>'''6.7.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете НПО и используются при обмене данными'''</h2>
Объекты для учета регистрации изменений и последующей передаче через сервис. Данные передаются в разрезе учетных документов (регистратор), к которым привязано движение по счету.
Если документ удален/проведение отменено/помечен на удаление, то передаваться будет идентификатор документа и признак «удален».
В базе-приемник – необходимо будет удалить все движения по этому документу (по всем ПС/ПД)
'''1. Объекты контроля для регистрации изменений:'''
1.1. РН РезервыНПО
'''2. Извлекаемые данные из объектов контроля для передачи через сервис:'''
2.1. Регистратор (документ):
2.1.1. Идентификатор документа / guidDoc
2.1.2. ДокументУдален/ DeleteDoc
2.1.3. Параметры Регистратор (документ), если он проведен:
2.1.3.1. Дата документа / date
2.1.3.2. Номер документа /NumberDoc
2.1.3.3. Вид документа (как в 1с)
2.1.3.4. Представление документа (вид операции) / vidOp – описание заполнения приведено ниже
2.1.3.5. Движения:
2.1.3.5.1. Дата движения
2.1.3.5.2. ГИУД ПС /guidPS
2.1.3.5.3. Код ПС / accountNumber / KodPS
2.1.3.5.4. Вид движения (+Приход/-расход)
2.1.3.5.5. Тип резерва
2.1.3.5.6. Тип суммы/ typeSum
2.1.3.5.7. Сумма / sum
'''Таблица 1. Типы резервов НПО'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип резерва (TypeResId)'''
! style="background:#EAECF0"| '''Представление Типа резерва (TypeRes)'''
|-
|СПС
|СПС
|-
|ИПС
|ИПС
|-
|ПожизненныхВыплат
|Пожизненных выплат
|-
|Страховой
|Страховой
|-
|РезервНачисленийПенсийСПС
|Резерв начислений пенсий СПС
|-
|РезервНачисленийПенсийИПС
|Резерв начислений пенсий ИПС
|-
|РезервНачисленийПенсийПожизненныхВыплат
|Резерв начислений пенсий пожизненных выплат
|-
|РезервНачисленийВыкупныхСуммСПС
|Резерв начислений выкупных сумм СПС
|-
|РезервНачисленийВыкупныхСуммИПС
|Резерв начислений выкупных сумм ИПС
|-
|РезервНачисленийВыкупныхСуммПожизненныхВыплат
|Резерв начислений выкупных сумм пожизненных выплат
|-
|РезервНаследниковИПС
|Резерв наследников ИПС
|-
|РезервНаследниковСПС
|Резерв наследников СПС
|-
|РезервНачисленийНаследниковИПС
|Резерв начислений наследников ИПС
|-
|РезервНачисленийНаследниковСПС
|Резерв начислений наследников СПС
|-
|РПАР
|РПАР
|}
'''Таблица 2. Типы сумм НПО'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип сумм (TypeSumId)'''
! style="background:#EAECF0"| '''Представление Типа сумм НПО (TypeSum)'''
|-
|ИДНаРезерв
|ИД на резерв
|-
|Резерв
|Резерв
|-
|ИДФиз
|ИД на взносы физ.лиц
|-
|ИДТр
|ИД на взносы третьих лиц
|-
|ИДЮр
|ИД на взносы юр.лиц
|-
|ВзносыФиз
|Взносы физ.лиц
|-
|ВзносыТр
|Взносы третьих лиц
|-
|ВзносыЮр
|Взносы юр.лиц
|-
|ВзносыЮрЛицНеоблагаемые
|Взносы юр.лиц необлагаемые
|}
Табл. Значения VIDOP (строка) по документу регистратору
: {|class="wikitable"
! style="background:#EAECF0"| '''№ п/п'''
! style="background:#EAECF0"| '''Вид документа 1с (НПО)'''
! style="background:#EAECF0"| '''Представление для выгрузки (vidOp)'''
|-
|1.
|Для всех регистраторов
|Используется стандартное представление документа 1с.
  Пример:
  Поступление взносов АРБП-000001 от 12.02.2024 21:54:56
|}
<h2>'''6.7.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (НПО)'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: [host]/…/NPO_OperationsChg_Request
'''Описание JSON запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|'''NPO_OperationsChg_Request'''
|
|-
|Без параметров
|
|
|}
'''Описание JSON ответа:'''
Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД узла изменений
|GUID
|-
|Msg
|Номер пакета сообщения
|Число
|}
Структура массива «accounts»: массив структур с информацией о движении по ПС НПО и остаткам на ПС НПО
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД пенсионного счета ПДС
|GUID
|-
|Exist
|Признак найденного пенсионного счета НПО по ГУИД
|boolean
|-
|CodePS
|Код пенсионного счета ПС
|Строка
|-
|operations
|Массив с информацией о движении по ПС ПДС
|Массив объектов
|}
Структура массива «operations»: массив структур с информацией о движении по ПС ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKeyDoc
|ГУИД документа – регистратора движения по ПС НПО
|строка
|-
|DeleteDoc
|Значение =true, если Документ удален или отменены движения по документу
  Иначе =false.
|boolean
|-
|
|Если DeleteDoc= false, тогда формируется массив данных:
|
|-
|PresDoc
|Представление документа – регистратора движения по ПС НПО
|строка
|-
|DateDoc
|Дата документа – регистратора
|Дата
|-
|NumberDoc
|Номер документа – регистратора
|строка
|-
|TypeDoc
|Тип документа – регистратора
|строка
|-
|TypeMove
|Направление денежного потока (приход/расход)
|строка
|-
|TypeRes
|Тип резерва, на котором отражено движение
|строка
|-
|TypeResId
|Тип резерва, на котором отражено движение  (идентификатор)
|строка
|-
|TypeSum
|Тип суммы движения
|строка
|-
|TypeSumId
|Тип суммы движения (идентификатор)
|строка
|-
|Sum
|Сумма
|денежный
|}
<h2>'''6.8 Сервисы по ПДС. (PDS_OperationsChg_Request) Обмен изменениями в движениях по счету ПС и ПД (ПДС)'''</h2>
Регистрация изменений ведется по всем ПС и ПД в разрезе документов(регистраторов) по таблице Резервы ПДС и типам резерва: ИПС/ Резерв умерших ИПС.
<h2>'''6.8.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете ПДС и используются при обмене данными'''</h2>
Объекты для учета регистрации изменений и последующей передаче через сервис. Данные передаются в разрезе учетных документов (регистратор), к которым привязано движение по счету.
Если документ удален/проведение отменено/помечен на удаление, то передаваться будет идентификатор документа и признак «удален».
В базе-приемник – необходимо будет удалить все движения по этому документу (по всем ПС/ПД)
'''1. Объекты контроля для регистрации изменений:'''
1.1. РН пдс_РезервыПДС
'''2. Извлекаемые данные из объектов контроля для передачи через сервис:'''
2.1. Регистратор (документ):
2.1.1. Идентификатор документа / guidDoc
2.1.2. ДокументУдален/ DeleteDoc
2.1.3. Параметры Регистратор (документ), если он проведен:
2.1.3.1. Дата документа / date
2.1.3.2. Номер документа /NumberDoc
2.1.3.3. Вид документа (как в 1с - идентификатор)
2.1.3.4. Представление документа (вид операции) / vidOp – описание заполнения приведено ниже
2.1.3.5. Движения:
2.1.3.5.1. Дата движения
2.1.3.5.2. ГИУД ПС /guidPS
2.1.3.5.3. Код ПС / accountNumber / KodPS
2.1.3.5.4. Вид движения (+Приход/-расход) / (+1/-1)
2.1.3.5.5. Тип резерва
2.1.3.5.6. Тип суммы/ typeSum
2.1.3.5.7. Сумма / sum
'''Таблица 1. Типы резервов ПДС'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип резерва (TypeResId)'''
! style="background:#EAECF0"| '''Представление Типа резерва (TypeRes)'''
|-
|ИПС
|ИПС
|-
|РезервСрочнойВыплаты
|Резерв срочной выплаты
|-
|РезервПожизненнойВыплаты
|Резерв пожизненной выплаты
|-
|РезервЕдиновременнойВыплаты
|Резерв единовременной выплаты
|-
|РезервНачисленияСрочнойВыплаты
|Резерв начисления срочной выплаты
|-
|РезервНачисленияПожизненнойВыплаты
|Резерв начисления пожизненной выплаты
|-
|РезервНачисленияЕдиновременнойВыплаты
|Резерв начисления единовременной выплаты
|-
|РезервНачисленияВыкупныхСумм
|Резерв начисления выкупных сумм
|-
|РезервНачисленияПриПереводеВДругойПФ
|Резерв начисления при переводе в другой ПФ
|-
|РезервНачисленияОсобыеОбстоятельства
|Резерв начисления особые обстоятельства
|-
|РезервУмершихИПС
|Резерв умерших ИПС
|-
|РезервУмершихРСВ
|Резерв умерших РСВ
|-
|РезервНачисленияПравопреемникамИПС
|Резерв начисления правопреемникам ИПС
|-
|РезервНачисленияПравопреемникамРСВ
|Резерв начисления правопреемникам РСВ
|-
|Страховой
|Страховой
|}
'''Таблица 2. Типы сумм ПДС'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип суммы (TypeSumId)'''
! style="background:#EAECF0"| '''Представление Типа сумм (TypeSum)'''
|-
|ВзносыЮЛ
|Взносы ЮЛ
|-
|ИДВзносыЮЛ
|ИД на взносы ЮЛ
|-
|Сберегательный
|Сберегательный взнос
|-
|Единовременный
|Единовременный взнос
|-
|ДополнительныйСтимулирующий
|Дополнительный стимулирующий взнос
|-
|СберегательныйТЛ
|Сберегательный взнос третьих лиц
|-
|ИДСберегательный
|ИД на сберегательный взнос
|-
|ИДЕдиновременный
|ИД на единовременный взнос
|-
|ИДДополнительныйСтимулирующий
|ИД на дополнительный стимулирующий взнос
|-
|ИДСберегательныйТЛ
|ИД на сберегательный взнос третьих лиц
|}
'''Табл. Значения VIDOP (строка) по документу регистратору'''
: {|class="wikitable"
! style="background:#EAECF0"| '''№ п/п'''
! style="background:#EAECF0"| '''Вид документа 1с'''
! style="background:#EAECF0"| '''Представление для выгрузки (vidOp)'''
|-
|1.
|Для всех регистраторов
|Используется стандартное представление документа 1с.
  Пример:
  Поступление взносов ПДС АРБП-000001 от 12.02.2024 21:54:56
|}
<h2>'''6.8.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС)'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: '''[host]/…/PDS_OperationsChg_Request'''
'''Описание JSON запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|PDS_OperationsChg_Request
|
|-
|Без параметров
|
|
|}
'''Описание JSON ответа:'''
Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД узла изменений
|GUID
|-
|Msg
|Номер пакета сообщения
|Число
|}
Структура массива «accounts»: массив структур с информацией о движении по ПС ПДС и остаткам на ПС ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKeyPS
|ГУИД пенсионного счета ПДС
|GUID
|-
|Exist
|Признак найденного пенсионного счета ПДС по ГУИД
|boolean
|-
|CodePS
|Код пенсионного счета ПС
|Строка
|-
|operations
|Массив с информацией о движении по ПС ПДС
|Массив объектов
|}
Структура массива «operations»: массив структур с информацией о движении по ПС ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKeyDoc
|ГУИД документа – регистратора движения по ПС ПДС
|строка
|-
|DeleteDoc
|Значение =true, если Документ удален или отменены движения по документу
  Иначе =false.
|boolean
|-
|
|'''Если DeleteDoc= false, тогда формируется массив данных:'''
|
|-
|PresDoc
|Представление документа – регистратора движения по ПС ПДС
|строка
|-
|DateDoc
|Дата документа – регистратора
|Дата
|-
|NumberDoc
|Номер документа – регистратора
|строка
|-
|TypeDoc
|Тип документа – регистратора
|строка
|-
|TypeMove
|Направление денежного потока (приход/расход)
|строка
|-
|TypeRes
|Тип резерва, на котором отражено движение
|строка
|-
|TypeResId
|Тип резерва, на котором отражено движение  (идентификатор)
|строка
|-
|TypeSum
|Тип суммы движения
|строка
|-
|TypeSumId
|Тип суммы движения (идентификатор)
|строка
|-
|Sum
|Сумма
|денежный
|}
<h2>'''6.9 Сервисы по ОПС. (OPS_OperationsChg_Request) Обмен изменениями в движениях по Договору (ОПС)'''</h2>
Регистрация изменений ведется по всем Договорам в разрезе документов(регистраторов) по таблице Резервы ОПС и типам резерва: все, кроме «Резерв ОПС».
<h2>'''6.9.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными'''</h2>
Объекты для учета регистрации изменений и последующей передаче через сервис. Данные передаются в разрезе учетных документов (регистратор), к которым привязано движение по счету.
Если документ удален/проведение отменено/помечен на удаление, то передаваться будет идентификатор документа и признак «удален».
В базе-приемник – необходимо будет удалить все движения по этому документу (по всем Договорам)
'''3. Объекты контроля для регистрации изменений:'''
3.1. РН уп_РезервыОПС
'''4. Извлекаемые данные из объектов контроля для передачи через сервис:'''
4.1. Регистратор (документ):
4.1.1. Идентификатор документа / guidDoc
4.1.2. ДокументУдален/ DeleteDoc
4.1.3. Параметры Регистратор (документ), если он проведен:
4.1.3.1. Дата документа / date
4.1.3.2. Номер документа /NumberDoc
4.1.3.3. Вид документа (как в 1с - идентификатор)
4.1.3.4. Движения:
4.1.3.4.1. Дата движения
4.1.3.4.2. ГИУД ПС /guidPS
4.1.3.4.3. Код ПС / accountNumber / KodPS
4.1.3.4.4. Вид движения (+Приход/-расход) / (+1/-1)
4.1.3.4.5. Тип резерва
4.1.3.4.6. Тип суммы/ typeSum
4.1.3.4.7. Сумма / sum
'''Таблица 1. Типы резервов ОПС'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип резерва (TypeResId)'''
! style="background:#EAECF0"| '''Представление Типа резерва (TypeRes)'''
|-
|РезервПенсионныйНакоплений
|РПН
|-
|РезервСрочнойВыплаты
|РСВ
|-
|Выплатной
|Выплатной
|-
|РезервЕВ
|Резерв единовременной выплаты
|-
|РезервНачисленийНП
|Резерв начислений НП
|-
|РезервНачисленийСВ
|Резерв начислений СВ
|-
|РезервНачисленийЕВ
|Резерв начислений ЕВ
|-
|РезервНаследниковРПН
|Резерв умерших РПН
|-
|РезервНаследниковРСВ
|Резерв умерших РСВ
|-
|РезервНачисленийРасторжение
|Резерв начислений расторжение
|-
|РезервНачисленийНаследованиеРПН
|Резерв начислений наследование РПН
|-
|РезервНачисленийНаследованиеРСВ
|Резерв начислений наследование РСВ
|-
|РезервНачисленийНаследованиеРОПС
|Резерв начислений наследование РОПС
|-
|РезервНачисленийВозвратМСКРПН
|Резерв начислений возврат  МСК РПН
|-
|РезервНачисленийВозвратМСКРСВ
|Резерв начислений возврат  МСК РСВ
|-
|РезервНачисленийРазделениеСНИЛС
|Резерв начислений разделение СНИЛС
|}
'''Таблица 2. Типы сумм ОПС'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип суммы (TypeSumId)'''
! style="background:#EAECF0"| '''Представление Типа сумм (TypeSum)'''
|-
|ВзносыФиз
|Страховые взносы
|-
|ВзносыЮр
|Взносы работодателя
|-
|ГосПоддержка
|Взносы софинансирование
|-
|ДопВзносы
|Доп. страховые взносы
|-
|МатКапитал
|Материнский капитал
|-
|ИДФиз
|ИД на страховые взносы
|-
|ИДЮр
|ИД на взносы работодателя
|-
|ИДГосПоддержка
|ИД на софинансирование
|-
|ИДДопВзносы
|ИД на доп. страх. взносы
|-
|ИДМатКапитал
|ИД на материнский капитал
|}
<h2>'''6.9.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС)'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: '''[host]/…/OPS_OperationsChg_Request'''
'''Описание JSON запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|'''OPS_OperationsChg_Request'''
|
|-
|Без параметров
|
|
|}
'''Описание JSON ответа:'''
Структура ответа содержит объекты «package» и «documents».
Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД узла изменений
|GUID
|-
|Msg
|Номер пакета сообщения
|Число
|}
Структура массива «documents»: массив структур с информацией о документах
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKeyDoc
|ГУИД документа – регистратора
|строка
|-
|DeletionMark
|Значение =true, если Документ удален или отменены движения по документу
  Иначе =false.
|boolean
|-
|
|'''Если DeleteDoc= false, тогда формируется массив данных:'''
|
|-
|PresDoc
|Представление документа – регистратора
|строка
|-
|DateDoc
|Дата документа – регистратора
|Дата
|-
|NumberDoc
|Номер документа – регистратора
|строка
|-
|TypeDoc
|Тип документа – регистратора
|строка
|-
|Оperations
|Движения документа - регистратора
|Объект
|}
Структура объекта «operations»: массив структур с информацией о движении по Договорам ОПС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKeyPS
|ГУИД Договора ОПС
|GUID
|-
|CodePS
|Код Договора ОПС
|Строка
|-
|TypeMove
|Направление денежного потока (приход/расход)
|строка
|-
|TypeRes
|Тип резерва, на котором отражено движение
|строка
|-
|TypeResId
|Тип резерва, на котором отражено движение  (идентификатор)
|строка
|-
|TypeSum
|Тип суммы движения
|строка
|-
|TypeSumId
|Тип суммы движения (идентификатор)
|строка
|-
|Sum
|Сумма
|денежный
|}
<h2>'''6.10 Общие сервисы. (ClientsID_Request) Получение полного списка идентификаторов клиентов (без персональных данных)'''</h2>
Обмен без учета регистрации изменений.
В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.
В рамках сервиса не предусмотрены входящих параметры для отбора.
'''Сервис возвращает только идентификаторы (guid)''' по Контрагентам (ЮЛ/ФЛ), в т.ч. предусмотрен признак о наличии ПС в учете НПО/ПДС/ОПС. Далее по идентификатору (guid) можно у нижеописанных сервисов запросить информацию о ПС, остатке на ПС, Выписку по счету.
У контрагента может не быть ПС в учете НПО/ОПС/ПДС – например, если будут передаваться сведения (ссылки) на наследников. Загружать таких контрагентов во внеш.систему или нет остается на выбор разработчика принимающей стороны.
Выборка производится по справочнику Контрагенты, наличие ПС по НПО/ПДС/ОПС проверяется по Справочнику уп_ПенсионныеСчета, пдс_ПенсионныеСчета, уп_ДоговорыОПС соответственно.
<h2>'''6.10.1 Описание объектов и параметров, которые используются при обмене данными'''</h2>
'''1. Объекты-источники:'''
1.1. Справочник. Контрагенты (без пометки на удаление)
1.2. Справочник. уп_ПенсионныеСчета
1.3. Справочник. пдс_ПенсионныеСчетаПДС
1.4. Справочник. уп_ДоговорыОПС
'''2. Извлекаемые данные для передачи через сервис:'''
Идентификаторы контрагентов (guid) и признак о наличии ПС в учете НПО/ПДС/ОПС
2.1. Гуид контрагента /'''guidClient'''
2.2. Код контрагента
2.3. Дата последнего изменения персональных данных клиента, в Формате ДатаВремя
2.4. Признак пометки на удаление: истина, если помечен на удаление; ложь, если не помечен на удаление
2.5. ТипКонтрагента=Булево (1-ФЛ, 2-ЮЛ)
2.6. Представление контрагента (Наименование/ФИО)
2.7. СНИЛС, заполняется только для ФЛ (ТипКонтрагента = 1)
2.8. Участие в программах Фонда (наличие договора или счета)
2.8.1. Есть НПО- Истина, если является участником/вкладчиком НПО, иначе Ложь
2.8.2. Есть ПДС- Истина, если является участником/вкладчиком ПДС, иначе Ложь
2.8.3. Есть ОПС - Истина, если является участником ОПС, иначе Ложь
<h2>'''6.10.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: '''[host]/…/ClientsID_Request'''
'''Описание JSON запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|'''ClientsID_Request'''
|
|-
|Без параметров
|
|
|}
'''Описание JSON ответа:'''
Структура массива «clients»: массив объектов с идентификаторами клиентов
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД контрагента
|GUID
|-
|Name
|Представление контрагента (Наименование/ФИО)
|Строка
|-
|DateChg
|Дата последнего изменения персональных данных клиента
|ДатаВремя
|-
|DeletionMark
|Признак пометки на удаление
|Boolean
|-
|Code
|Код контрагента
|Строка
|-
|Type
|ТипКонтрагента (1 – Физическое лицо\2 – Юридическое лицо)
|Число
|-
|Snils
|СНИЛС контрагента - физического лица
|Строка
|-
|accounts
|Содержит признаки участия контрагента в деятельности фонда
|Объект
|}
Структура объекта «accounts» - признаки участия контрагента в деятельности фонда
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|OPS
|Признак участия в ОПС
|Boolean
|-
|NPO
|Признак участия в НПО (Вкладчик/Участник)
|Boolean
|-
|PDS
|Признак участия в ПДС
|Boolean
|}
<h2>'''6.11 Общие сервисы. (ClientsInfo_Request) Получение информации по клиентам ЮЛ/ФЛ (персональные данные)'''</h2>
Обмен без учета регистрации изменений.
В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.
В рамках сервиса в качестве входящих параметров передаются идентификаторы клиентов ФЛ/ЮЛ ('''guid контрагента'''), по которым сервис возвращает персональную информацию о клиенте (контрагенте). В рамках сервиса предусмотрен признак о наличии ПС в учете НПО/ПДС/ОПС (в рамках информационной системы).
Выборка производится по справочнику Контрагенты
В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 100 000 (для post запроса доступно не более 100 000, для get запроса максимум= 40).
В результате сервис по каждому запрошенному идентификатору клиента передает информацию только о самом клиенте/контрагенте (передача информации по пенсионным счетам и договорам предусмотрена в отдельных нижеописанных сервисах)
При вызове через POST запрос в тело запроса передается JSON с массивом UID клиентов.
Пример структуры JSON:
{
    "uids": [
        "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
        "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
        "87e21fff-cb82-11e3-be9d-74d02bc3313d"
    ]
}
<h2>'''6.11.1 Описание объектов и параметров, которые используются при обмене данными'''</h2>
Входящий параметр (коллекция):
1. ГУИД контрагента /guidClient
По полученному списку ГУИД контрагента (guidClient) производится отбор данных по справочнику Контрагенты и формируется ответ.
Наличие ПС по НПО/ПДС/ОПС проверяется по Справочнику уп_ПенсионныеСчета, пдс_ПенсионныеСчета, уп_ДоговорыОПС соответственно.
1. Объекты-источники:
1.1. Справочник. Контрагенты
1.2. Справочник.ФизЛица
1.3. РС. ФИОФизическихЛиц
1.4. РС. ФизическиеЛицаДокументов
1.5. Справочник. уп_ПенсионныеСчета
1.6. Справочник. пдс_ПенсионныеСчетаПДС
1.7. Справочник. уп_ДоговорыОПС
2. Информация, которая передается в качестве результата:
2.1. Клиент (Контрагент) /guidClient
2.2. FindClientID - Признак КлинтНайден по гуид - булево
(FindClientID) - Если клиент по гуид не обнаружен, то FindClientID =False
Если клиент по гуид обнаружен, то FindClientID =TRUE и возвращается набор параметров:
2.3. Параметры для ФЛ:
2.3.1. ТипКонтрагента=Булево (1-ФЛ, 2-ЮЛ, 0 — это ошибка в базе)
2.3.2. ГУИД контрагента /guidClient
2.3.3. Дата последнего изменения персональных данных клиента, в Формате ДатаВремя
2.3.4. КодКонтрагента / npoCode / IDClient
2.3.5. Контрагент-ПометкаНаУдаление
2.3.6. СНИЛС/ snils
2.3.7. ИНН/ inn
2.3.8. ФИО:
1.1.1.1.1. Фамилия/ surname
1.1.1.1.2. Имя/ name
1.1.1.1.3. Отчество/ patronymic
2.3.9. ФИО при рождении / birthPersonal
1.1.1.1.4. Фамилия/ surname
1.1.1.1.5. Имя/ name
1.1.1.1.6. Отчество/ patronymic
2.3.10. Пол/ sex
2.3.11. ДатаРождения/ birthDate
2.3.12. МестоРождения/ birthPlace
2.3.13. ДатаСмерти/ deathDate
2.3.14. Контактная информация (коллекция телефонов, адресов, email):
2.3.15. Номер по порядку
2.3.16. ТипКонтактнойИнформации – см. Табл.1 «Типы и виды контактной информации ФЛ»
2.3.17. ВидКонтактнойИнформации - – см. Табл.1 «Типы и виды контактной информации ФЛ»
2.3.18. Значение (Представление)/ singleString
2.3.19. Структура Адреса:
2.3.19.1. (заполняется только, если ТипКонтактнойИнформации= Адрес). Поля структуры адреса могут быть скорректированы.
2.3.19.2. Адрес в формате JSON.
2.3.19.3. Страна/country
2.3.19.4. Регион представление/ regionName
2.3.19.5. Город/ town
2.3.20. Документ, удостоверяющий личность (паспорт) – коллекция документов:
2.3.20.1. Код (код документа)/ code – виды кодов представлены в табл.2 «Коды документов»
2.3.20.2. Серия/ seria
2.3.20.3. Номер/ number
2.3.20.4. Дата (дата выдачи)/ date
2.3.20.5. Кем выдан/ org
2.3.20.6. Код кем выдан/ orgCode – только для паспорта РФ
2.3.21. Сведения о наличии правопреемников:
2.3.21.1. Есть назначенные ПП в НПО (Проверка через заявления  ЗаявлениеОНаличииПравопреемниковНПО) – Тип Булево
2.3.21.2. Есть назначенные ПП в ПДС(Проверка через заявления  ЗаявлениеОНаличииПравопреемниковПДС) – Тип Булево
2.3.21.3. Есть назначенные ПП в ОПС(Проверка через заявления  ЗаявлениеОНаличииПравопреемниковОПС) – Тип Булево
2.4. Параметры для ЮЛ:
2.4.1. ТипКонтрагента=Булево (1-ФЛ, 2-ЮЛ, 0 — это косяк в базе)
2.4.2. ГУИД контрагента / guidClient
2.4.3. КодКонтрагента /npoCode/ IDClient
2.4.4. Дата последнего изменения персональных данных клиента, в Формате ДатаВремя
2.4.5. ИНН/ inn
2.4.6. КПП
2.4.7. Наименование
2.4.8. Полное наименование
2.4.9. Контрагент-ПометкаНаУдаление
2.5. Информация о Наличии ПС в НПО/ПДС/ОПС:
2.5.1. Есть НПО- Истина, если является участником/вкладчиком НПО, иначе Ложь
2.5.2. Есть ПДС- Истина, если является участником/вкладчиком ПДС, иначе Ложь
2.5.3. Есть ОПС - Истина, если является участником ОПС, иначе Ложь
<h2>'''6.11.2 Описание полей запроса и ответа для получения информации по клиентам'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: '''[host]/…/ClientsInfo_Request'''
'''Описание GET или POST запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|'''clientsInfo_request'''
|
|-
|uid
|GUID контрагентов с разделителем «,» (запятая)
|Текст
|}
'''Описание JSON ответа:'''
'''Структура массива объектов «clients» - информация о контрагентах'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД контрагента
|GUID
|-
|Exist
|Признак найденного контрагента по ГУИД
|Boolean
|-
|client
|Объект с подробной информацией о контрагенте ЮЛ
|Объект
|}
Структура объекта «client» для Юридических лиц
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|Type
|Тип контрагента
  2 – Юридическое лицо
|Число
|-
|Code
|Код контрагента
|Строка
|-
|DeletionMark
|Признак пометки на удаление
|Boolean
|-
|DateChg
|Дата последнего изменения персональных данных клиента
|ДатаВремя
|-
|Inn
|ИНН контрагента
|Строка
|-
|Kpp
|КПП контрагента
|Строка
|-
|Name
|Наименование контрагента
|Строка
|-
|FullName
|Полное наименование контрагента
|Строка
|}
Структура объекта «client» для Физических лиц
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|Type
|Тип контрагента
  1 – Физическое лицо
|Число
|-
|Code
|Код контрагента
|Строка
|-
|DeletionMark
|Признак пометки на удаление
|Boolean
|-
|DateChg
|Дата последнего изменения персональных данных клиента
|ДатаВремя
|-
|Inn
|ИНН контрагента
|Строка
|-
|Snils
|СНИЛС контрагента
|Строка
|-
|Sex
|Пол контрагента
  «М» - мужской
  «Ж» - женский
|Строка[1]
|-
|BirthDate
|Дата рождения
|Дата
|-
|BirthDate
|Дата рождения
|Дата
|-
|BirthPlace
|Место рождения
|Строка
|-
|DeathDate
|Дата смерти
|Дата
|-
|Personal
|ФИО контрагента
|Объект
|-
|BirthPersonal
|ФИО при рождении
|Строка
|-
|NPO_ObligationsFulfilled
|Признак полного исполнения обязательств перед контрагентом.
  - True: обязательства исполнены полностью;
  - False: обязательства полностью не исполнены
|Boolean
|-
|NPO_ClientStatus
|Статус контрагента, определенного по состояниям пенсионных счетов НПО
|Строка
|-
|Documents
|Документы, удостоверяющие личность контрагента
|Массив объектов
|-
|Phones
|Телефоны контрагента
|Массив объектов
|-
|Emails
|Электронные адреса контрагента
|Массив объектов
|-
|Addresses
|Адреса контрагента
|Массив объектов
|-
|statements
|Участие контрагента в программах фонда
|Объект
|}
Таблица. Значения статусов контрагента по пенсионным счетам НПО
: {|class="wikitable"
! style="background:#EAECF0"| '''Значения статуса'''
|-
|Выплатной период
|-
|Начисления приостановлены
|-
|Накопительный период
|-
|Подготовка к закрытию
|-
|Закрыт
|-
|Ожидание взносов
|-
|Без определенного состояния
|}
Структура объекта «Personal»
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|Surname
|Имя
|Строка
|-
|Name
|Фамилия
|Строка
|-
|Patronymic
|Отчество
|Строка
|}
Структура объекта «Documents» - документы, удостоверяющие личность (ДУЛ) последние на дату (возможны разные виды документов, действующих на дату выгрузки)
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|Code
|Код документа, соответствует справочнику кодов ДУЛ в табл.2 «Коды документов»
|Число
|-
|Seria
|Серия ДУЛ
|Строка
|-
|Number
|Номер ДУЛ
|Строка
|-
|Date
|Дата выдачи документа
|Дата
|-
|Org
|Орган, выдавший ДУЛ
|Строка
|-
|OrgCode
|Код подразделения
|Строка
|-
|ND_PAS
|Дата недействительности паспорта
|Дата
|-
|DNEDVZN
|Дата выявления недействительного паспорта при обработке взносов
|Дата
|}
Структура объекта «Phones» - телефоны контрагента
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|Type
|Тип телефона (мобильный/домашний…)
|Строка
|-
|Value
|Номер телефона (формат: +Ц (ЦЦЦ) ЦЦЦЦЦЦЦ)
|Строка
|}
Структура объекта «Emails» - электронные адреса контрагента
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|Type
|Тип электронного адреса
|Строка
|-
|Value
|Электронный адрес
|Строка
|}
Структура объекта «Addresses» - адреса контрагента
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|Type
|Тип адреса (по прописке, регистрации….)
|Строка
|-
|TypeCode
|Код типа адреса
|Строка
|-
|Value
|Представление адреса
|Строка
|-
|AddressJSON
|Адрес по элементам
|Объект
|-
|Country
|Страна
|Строка
|-
|Region
|Регион
|Строка
|-
|Town
|Населенный пункт
|Строка
|}
Таблица. Значения Кодов типов адреса
: {|class="wikitable"
! style="background:#EAECF0"| '''Код'''
! style="background:#EAECF0"| '''Описание'''
|-
|AddressReg
|Адрес регистрации
|-
|AddressFact
|Адрес проживания
|-
|AddressInfo
|Адрес для информирования
|-
|AddressFrgn
|Адрес за пределами РФ
|-
|unknown
|неопределено (для адресов, для которых указан произвольный вид)
|}
Структура объекта «AddressJSON» - элементы адреса контрагента
(Внимание: Состав полей в структуре не является фиксированным и может отличаться в зависимости от типа адреса.)
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|version
|Версия структуры адреса
|Число
|-
|value
|Представление адреса
|Строка
|-
|comment
|Комментарий к адресу
|Строка
|-
|type
|Тип контактной информации
|Строка
|-
|addressType
|Тип заполнения структуры адреса
  - Административно-территориальное деление
  - Муниципальное деление
  - Адрес в свободной форме
|Строка
|-
|id
|Уникальный идентификатор адреса
|Строка
|-
|country
|Страна
|Строка
|-
|countryCode
|Код страны
|Строка
|-
|ZIPcode
|Почтовый индекс
|Строка
|-
|areaCode
|Код региона
|Строка
|-
|area
|Наименование региона
|Строка
|-
|areaType
|Тип региона
|Строка
|-
|areaValue
|Представление региона
|Строка
|-
|areaCode
|Код региона
|Строка
|-
|areaId
|Идентификатор региона
|Строка
|-
|city
|Наименование города
|Строка
|-
|cityType
|Тип города
|Строка
|-
|cityId
|Идентификатор города
|Строка
|-
|areaId
|Идентификатор региона
|Строка
|-
|district
|Наименование района
|Строка
|-
|districtType
|Тип района
|Строка
|-
|districtId
|Идентификатор района
|Строка
|-
|munDistrict
|Наименование муниципального района
|Строка
|-
|munDistrictType
|Тип муниципального района
|Строка
|-
|munDistrictId
|Идентификатор муниципального района
|Строка
|-
|cityDistrict
|Внутригородской район
|Строка
|-
|cityDistrictType
|Тип внутригородского района
|Строка
|-
|locality
|Наименование населенного пункта
|Строка
|-
|localityType
|Тип населенного пункта
|Строка
|-
|localityId
|Идентификатор населенного пункта
|Строка
|-
|territory
|Наименование территории
|Строка
|-
|territoryType
|Тип территории
|Строка
|-
|territoryId
|Идентификатор территории
|Строка
|-
|settlement
|Наименование поселения
|Строка
|-
|settlementType
|Тип поселения
|Строка
|-
|settlementId
|Идентификатор поселения
|Строка
|-
|street
|Наименование улицы
|Строка
|-
|streetType
|Тип улицы
|Строка
|-
|streetId
|Идентификатор улицы
|Строка
|-
|stead
|Номер земельного участка
|Строка
|-
|steadId
|Идентификатор земельного участка
|Строка
|-
|houseNumber
|Номер здания
|Строка
|-
|houseType
|Тип здания
|Строка
|-
|houseId
|Идентификатор здания
|Строка
|-
|buildings
|Массив с информацией о строениях, корпусах. Элементы массива – структура с полями «type», «number»
|Массив объектов
|-
|apartments
|Массив с информацией о квартирах, помещениях. Элементы массива – структура с полями «type», «number»
|Массив объектов
|-
|codeKLADR
|Код адреса по КЛАДР
|Строка
|-
|oktmoBudget
|ОКТМО бюджетополучателя
|Строка
|-
|oktmo
|ОКТМО адреса
|Строка
|-
|okato
|ОКАТО адреса
|Строка
|-
|ifnsFLCode
|Код ИФНС для физических лиц
|Строка
|-
|ifnsFLAreaCode
|Код ИФНС региона для физических лиц
|Строка
|-
|ifnsULAreaCode
|Код ИФНС региона для юридических лиц
|Строка
|-
|munLevels
|Массив уровней адреса в формате «Муниципальный»
|Массив объектов
|-
|admLevels
|Массив уровней адреса в формате «Административно-территориальный»
|Массив объектов
|}
Структура объекта «buildings»
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|type
|Тип здания (строение, корпус….)
|Строка
|-
|number
|Номер здания
|Строка
|}
Структура объекта «apartments»
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|type
|Тип помещения (квартира…)
|Строка
|-
|number
|Номер помещения
|Строка
|}
Структура объекта «statements»
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|OPS
|Наличие договора/счета ОПС
|Boolean
|-
|NPO
|Наличие договора/счета НПО
|Boolean
|-
|PDS
|Наличие договора/счета ПДС
|Boolean
|}
<h2>'''6.12 Сервисы по НПО. (NPO_PS_Request) Получить данные по ПС клиентов НПО'''</h2>
Обмен без учета регистрации изменений.
В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.
В рамках сервиса в качестве входящих параметров передаются идентификаторы клиентов (ФЛ/ЮЛ) у кого есть признак «Есть НПО», по которым сервис вернет информацию о его ПС.
В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 100 000. (для post запроса доступно не более 100 000, для get запроса максимум= 40).
В результате сервис по каждому запрошенному идентификатору клиента возвращает информацию о его ПС с параметрами договора НПО, а также о текущем остатке на каждом на ПС. Передача персональных данных ко клиенту не предусмотрена.
При вызове через POST запрос в тело запроса передается JSON с массивом UID клиентов.
Пример структуры JSON:
{
    " uids": [
        "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
        "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
        "87e21fff-cb82-11e3-be9d-74d02bc3313d"
    ]
}
<h2>'''6.12.1 Описание объектов и параметров, которые используются при обмене данными'''</h2>
Входящий параметр (коллекция):
1. ГУИД контрагента /guidClient
По полученному списку ГУИД контрагента (guidClient) производится отбор ПС НПО. Выборка производится по справочнику пенсионные счета НПО по полю участник и формируется ответ. Если будет передан guidClient, который не имеет ПС или договор, то сервис не вернет по такому клиенту информацию. Персональная информация по Контрагенту (Вкладчику/участнику) не передается (кроме представления контрагента – для визуального контроля/тестирования)
Данные по остаткам на ПС собираются по каждому ПС из РН Резервы НПО с отбором по типам резервов: ИПС/СПС/ Резерв наследников ИПС/ Резерв наследников СПС.
1. Объекты-источники:
1.1. Справочник. Контрагенты,
1.2. Справочник. уп_ПенсионныеДоговоры,
1.3. Справочник. уп_ПенсионныеСчета
1.4. РС. уп_СхемаСчета
1.5. РС. уп_СостоянияПС
1.6. РС. уп_ПричиныЗакрытияПС
1.7. РС. уп_РазмерПенсии
1.8. РС. уп_СостоянияДоговора
1.9. РС уп_ЛицевыеСчетаУчастников
1.10. РС уп_ПериодичностьВыплат
1.11. РН Резервы НПО
2. Информация, которая передается в качестве результата:
2.1. Клиент /guidClient
2.2. FindClientID - Признак КлинтНайден по гуид - булево
(FindClientID) - Если клиент по гуид не обнаружен, то FindClientID =False
Если клиент по гуид обнаружен, то FindClientID =TRUE и возвращается набор параметров:
2.3. Информация о ПД:
2.3.1. ГИУД ПД /guidPD
2.3.2. Код ПД / number
2.3.3. ПометкаНаУдаление
2.3.4. Код Вкладчика/
2.3.5. Гуид Вкладчика / guidVkl (может совпадать с guidClient)
2.3.6. Представление Вкладчика (Контрагент.Наименование)
2.3.7. ВкладчикЮЛ/ФЛ (ТипКонтрагента) =Булево (1-ФЛ, 2-ЮЛ, 0 — это косяк в базе)
2.3.8. Параметры договора:
2.3.8.1. Состояние ПД/ status
2.3.8.2. Причина закрытия ПД/
2.3.8.3. Дата заключения ПД/ dateSign
2.3.8.4. Дата начала действия/ dateOpen
2.3.8.5. Дата закрытия ПД (в т.ч. по выполнению обязательств) /
2.3.9. Параметры из шаблона договора:
2.3.9.1. Минимальный срок выплат по договору
2.3.9.2. Максимальный срок выплат
2.3.9.3. Максимальный процент выплаты
2.3.9.4. Право на увеличенную пенсию / Boolean
2.3.10. Информация о ПС:
2.3.10.1. ГИУД ПС /guidPS
2.3.10.2. Код ПС / accountNumber / KodPS
2.3.10.3. ПометкаНаУдаление
2.3.10.4. Код участника/ npoCode
2.3.10.5. Гуид Участника /guidClient
2.3.10.6. Представление Участника (Контрагент.Наименование)
2.3.10.7. Состояние ПС / state
2.3.10.8. Причина закрытия / stopReason
2.3.10.9. Схема/ scheme
2.3.10.10. ТипПС/ type /
2.3.10.11. Дата открытия ПС (накопит. период)/ dateNp
2.3.10.12. Дата закрытия ПС / DateClose
2.3.11. Пенсионные параметры (по назначенным пенсиям):
2.3.11.1. Тип  пенсии - Пож, срочная, до исчерпания
2.3.11.2. Размер пенсии
2.3.11.3. Периодичность выплаты
2.3.11.4. Дата назначения пенсии (дата начала выплат) / datePension
2.3.11.5. Срок выплат (количество выплат)
2.3.11.6. Дата Решения о назначении пенсии
2.3.11.7. Дата окончания выплат- из РС. Дата окончания выплат
2.3.11.8. Максимальный срок выплат
2.3.11.9. Максимальный процент выплаты
2.3.11.10. Право на увеличенную пенсию / Boolean
2.3.12. Платежные реквизиты (срез последних, заполняется только если в РС Лицевые счета поле Участник=ПС.Участник)
2.3.12.1. Форма выплаты
2.3.12.2. Получатель (Участник\Банк) /guidКонтрагента
2.3.12.3. Тип ЛС
2.3.12.4. Номер ЛС
2.3.12.5. Расчетный счет
2.3.12.6. БИК Банка
2.3.13. Текущий остаток на ПС
2.3.13.1. Тип резерва
2.3.13.2. Тип суммы/ typeSum
2.3.13.3. Сумма / sum
<h2>'''6.12.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам НПО'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: '''[host]/…/NPO_PS_Request'''
'''Описание GET или POST запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|'''npo_ps_request'''
|
|-
|uid
|GUID контрагентов с разделителем «,» (запятая)
|Текст
|}
'''Описание JSON ответа:'''
Структура массива объектов «clients» - массив содержит информацию по всем ПС НПО контрагента
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД контрагента
|GUID
|-
|Exist
|Признак найденного контрагента по ГУИД
|boolean
|-
|accounts
|массив ПС контрагента по НПО
|Массив объектов
|}
Структура массива объектов «accounts» - массив содержит расширенную информацию по ПС НПО контрагента
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД пенсионного счета
|GUID
|-
|Code
|Код пенсионного счета НПО
|Строка
|-
|DeletionMark
|Признак пометки на удаление пенсионного счета
|Boolean
|-
|RefKeyUCH
|ГУИД контрагента-участника
|GUID
|-
|CodeUCH
|Код участника
|Строка
|-
|NameUCH
|Полное наименование участника (ФИО)
|Строка
|-
|TypeUCH
|Тип контрагента- участника
  1 – Физическое лицо
  2 – Юридическое лицо
|Число
|-
|State
|Текущее состояние пенсионного счета
|Строка
|-
|StopReason
|Причина закрытия пенсионного счета
|Строка
|-
|Sheme
|Пенсионная схема по счету
|Строка
|-
|DateOpen
|Дата открытия счета (перевод в накопительный период)
|Дата
|-
|DateClose
|Дата закрытия счета
|Дата
|-
|Agreement
|Информация о договоре НПО, по которому открыт счет
|Объект
|-
|Pension
|Информация о назначенной пенсии
|Объект
|-
|PaymentDetails
|Информация о банковских реквизитах участника
|Объект
|-
|Balance
|Массив с информацией об остатке на ПС НПО
|Массив объектов
|}
Структура массива объектов «Agreement» - сведения о договоре НПО
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД договора НПО
|GUID
|-
|Code
|Код договора
|Строка
|-
|DeletionMark
|Признак пометки на удаление договора НПО
|Boolean
|-
|RefKeyVKL
|ГУИД контрагента-вкладчика по договору НПО
|GUID
|-
|CodeVKL
|Код контрагента-вкладчика по договору НПО
|Строка
|-
|NameVKL
|Наименование контрагента-вкладчика по договору НПО
|Строка
|-
|TypeVKL
|Тип вкладчика
  1 – Физическое лицо
  2 – Юридическое лицо
|Число
|-
|State
|Текущее состояние договора
|Строка
|-
|StopReason
|Причина закрытия/прекращения
|Строка
|-
|DateSign
|Дата заключения договора
|Дата
|-
|DateOpen
|Дата начала действия договора
|Дата
|-
|DateClose
|Дата прекращения договора
|Дата
|}
Таблица. Значения Текущего состояние договора НПО (State)
: {|class="wikitable"
! style="background:#EAECF0"| '''Значение'''
|-
|Открыт
|-
|Действует
|-
|Приостановлен
|-
|Подготовка к закрытию
|-
|Закрыт
|}
Таблица. Значения Причина закрытия/прекращения договора НПО (StopReason)
: {|class="wikitable"
! style="background:#EAECF0"| '''Значение'''
|-
|По смерти
|-
|Досрочное расторжение
|-
|Договор выполнен
|-
|Переход в другой НПФ
|-
|Перевод на другой счет
|-
|Закрыт по иным причинам
|}
<h2>'''6.13 Сервисы по ПДС. (PDS_PS_Request) Получить данные по ПС клиентов ПДС'''</h2>
Обмен без учета регистрации изменений.
В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.
В рамках сервиса в качестве входящих параметров передаются идентификаторы клиентов (ФЛ/ЮЛ) есть признак «Есть ПДС», по которым сервис вернет информацию о его ПС.
В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 100 000. (для post запроса доступно не более 100 000, для get запроса максимум= 40).
В результате сервис по каждому запрошенному идентификатору клиента возвращает информацию о его ПС с параметрами договора ПДС, а также о текущем остатке на ПС. Передача персональных данных ко клиенту не предусмотрена.
При вызове через POST запрос в тело запроса передается JSON с массивом UID клиентов.
Пример структуры JSON:
{
    " uids": [
        "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
        "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
        "87e21fff-cb82-11e3-be9d-74d02bc3313d"
    ]
}
<h2>'''6.13.1 Описание объектов и параметров, которые используются при обмене данными'''</h2>
Входящий параметр (коллекция):
1. ГУИД контрагента /guidClient
По полученному списку ГУИД контрагента (guidClient) производится отбор ПС. Выборка производится по справочнику пенсионные счета ПДС по полю участник и формируется ответ. Если будет передан guidClient, который не имеет ПС или договор, то сервис не вернет по такому клиенту информацию. Персональная информация по Контрагенту (Вкладчику/участнику) не передается (кроме представления контрагента – для визуального контроля/тестирования)
Данные по остаткам на ПС собираются по каждому ПС из РН Резервы ПДС с отбором по типам резервов: ИПС/ Резерв умерших ИПС
1. Объекты-источники:
1.1. Справочник. Контрагенты,
1.2. Справочник. пдс_ДоговорыПДС,
1.3. Справочник. пдс_ПенсионныеСчетаПДС
1.4. РС.пдс_ПараметрыДоговораПДС
1.5. РС.пдс_ПричиныЗакрытияДоговораПДС
1.6. РС. пдс_ПричиныЗакрытияПенсионныхСчетовПДС
1.7. РС. пдс_СостоянияДоговораПДС
1.8. РС. пдс_СостоянияПенсионныхСчетовПДС
1.9. РС. пдс_РазмерПенсииПДС
1.10. РС пдс_ЛицевыеСчетаУчастников
1.11. РС пдс_ПериодичностьВыплат
1.12. РН Резервы ПДС
2. Информация, которая передается в качестве результата:
2.1. Клиент  /guidClient
2.2. FindClientID - Признак КлинтНайден по гуид - булево
(FindClientID) - Если клиент по гуид не обнаружен, то FindClientID =False
Если клиент по гуид обнаружен, то FindClientID =TRUE и возвращается набор параметров:
2.3. Если ПС по ПДС найдены, то передается информация:
2.3.1. Информация о ПД (ПДС):
2.3.1.1. ГИУД ПД /guidPD
2.3.1.2. Код ПД / number
2.3.1.3. ПД-ПометкаНаУдаление
2.3.1.4. Код Вкладчика/ KodVkl
2.3.1.5. Гуид Вкладчика /guidVKL
2.3.1.6. Представление Вкладчика (Контрагент.Наименование)
2.3.1.7. ВкладчикЮЛ/ФЛ (ТипКонтрагента) =Булево (1-ФЛ, 2-ЮЛ, 0 — это косяк в базе)
2.3.1.8. Параметры договора:
2.3.1.8.1. Состояние ПД/ status
2.3.1.8.2. Причина закрытия ПД/
2.3.1.8.3. Дата договора ПД/ dateSign
2.3.1.8.4. Дата заключения договора ПД/ dateSignDog
2.3.1.8.5. Дата начала действия/ dateOpen
2.3.1.8.6. Дата закрытия ПД (в т.ч. по выполнению обязательств) /
2.3.1.8.7. ВидДоговораПДС
2.3.1.8.8. ТипДоговора (Личный/В пользу третьих лиц/В пользу выгодоприобретателей)
2.3.1.8.9. ДатаПервогоДоговораПДС
2.3.1.8.10. ИнвестиционнаяСтратегияПДС
2.3.1.9. Параметры из шаблона договора:
2.3.1.9.1. Представление Шаблона договора
2.3.2. Информация о ПС (ПДС):
2.3.2.1. ГИУД ПС /guidPS
2.3.2.2. Код ПС / accountNumber / KodPS
2.3.2.3. ПС-ПометкаНаУдаление
2.3.2.4. Код участника/ npoCode
2.3.2.5. ГИУД участника/ guidClient
2.3.2.6. Представление Участника (Контрагент.Наименование)
2.3.2.7. Состояние ПС / state
2.3.2.8. Причина закрытия / stopReason
2.3.2.9. Дата открытия ПС (накопит. период)/ dateNp
2.3.2.10. Дата закрытия ПС / dateStop
2.3.2.11. Пенсионные параметры:
2.3.2.11.1. Дата назначения пенсии (Дата начала = 22.01.2024) / datePension
2.3.2.11.2. Дата решения о назначении (01.03.2024)
2.3.2.11.3. Тип  пенсии - Пожизненная, срочная
2.3.2.11.4. Размер пенсии
2.3.2.11.5. Периодичность выплаты
2.3.2.11.6. Срок выплат
2.3.2.11.7. Дата окончания срочных выплат (из РС
2.3.2.12. Единовременные выплаты (Данные по каждому Решению ЕВ)
2.3.2.12.1. Дата решения
2.3.2.12.2. Основание – вид заявления
2.3.2.12.3. Сумма к выплате
2.3.2.13. Назначенные выкупные суммы (Данные по каждому Решению ВС)
2.3.2.13.1. Дата решения
2.3.2.13.2. Основание – вид заявления (+ тип заявления)
2.3.2.13.3. Тип заявления
2.3.2.13.4. Особые обстоятельства
2.3.2.13.5. Вид дорогостоящего лечения
2.3.2.13.6. Сумма к выплате
2.3.2.14. Назначенные выкупные суммы правопреемникам (Данные по каждому Решению ВС ПП)
2.3.2.14.1. Дата решения
2.3.2.14.2. Основание – вид заявления (+ тип заявления)
2.3.2.14.3. Сумма к выплате
2.3.2.15. Платежные реквизиты (срез последних, заполняется только если в РС Лицевые счета поле Участник=ПС.Участник)
2.3.2.15.1. Форма выплаты
2.3.2.15.2. Получатель (Участник\Банк) /guidКонтрагента
2.3.2.15.3. Тип ЛС
2.3.2.15.4. Номер ЛС
2.3.2.15.5. Расчетный счет
2.3.2.15.6. БИК Банка
2.3.2.16. Текущий остаток на ПС
2.3.2.16.1. Тип резерва
2.3.2.16.2. Тип суммы/ typeSum
2.3.2.16.3. Сумма / sum
<h2>'''6.13.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам ПДС'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: '''[host]/…/PDS_PS_Request'''
'''Описание GET или POST запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|'''pds_ps_request'''
|
|-
|uid
|GUID контрагентов с разделителем «,» (запятая)
|Текст
|}
'''Описание JSON ответа:'''
Структура массива «clients»: массив объектов с информацией о пенсионных счетах ПДС контрагента
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД контрагента
|GUID
|-
|Exist
|Признак нахождения контрагента по ГУИД
|boolean
|-
|accounts
|массив ПС ПДС
|Массив объектов
|}
Структура массива «accounts»: массив объектов с информацией отраженной на ПС ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД пенсионного счета ПДС
|GUID
|-
|Code
|Код пенсионного счета ПДС
|Строка
|-
|DeletionMark
|Признак пометки на удаление пенсионного счета ПДС
|boolean
|-
|RefKeyUCH
|ГУИД контрагента-участника
|Строка
|-
|CodeUCH
|Код участника
|Строка
|-
|NameUCH
|Полное наименование участника (ФИО)
|Строка
|-
|State
|Текуще состояние пенсионного счета
|Строка
|-
|StopReason
|Причина закрытия пенсионного счета
|Строка
|-
|DateNP
|Дата открытия счета (перевод в накопительный период)
|Дата
|-
|DateClose
|Дата закрытия счета
|Дата
|-
|Pension
|Информация о назначенной периодической выплате
|Объект
|-
|agreement
|Информация о договоре ПДС, по которому открыт счет
|Объект
|-
|PaymentDetails
|Информация о банковских реквизитах участника
|Объект
|-
|OnePay
|Массив решений о единовременной выплате по счету
|Массив Объектов
|-
|FinalPay
|Массив решений о выкупной сумме по счету
|Массив Объектов
|-
|'''OutPay'''
|'''Массив решений о выплате выкупных сумм ПП по счету'''
|'''Массив Объектов (УП) – функционал не реализован'''
|-
|Balance
|Массив с информацией об остатке на ПС ПДС
|Массив Объектов
|}
Состав объекта «Pension»: информация о назначенной периодической выплате
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DatePension
|Дата назначения пенсии
|Дата
|-
|DateDoc
|Дата решения о назначении
|Дата
|-
|Type
|Тип  пенсии - Пожизненная, срочная
|Строка
|-
|Sum
|Размер периодической выплаты
|Строка
|-
|Periodicity
|Периодичность выплаты. Для ПДС всегда 1
|Целое число
|-
|Count
|Количество назначенных выплат. Для пожизненной выплаты – не заполняется
|Целое число
|}
Состав объекта «agreement»: информация о договоре ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД договора ПДС
|Строка
|-
|Code
|Код договора ПДС
|Строка
|-
|DeletionMark
|Признак пометки на удаление договора ПДС
|Boolean
|-
|RefKeyVKL
|ГУИД контрагента-вкладчика по договору ПДС
|Строка
|-
|CodeVKL
|Код контрагента-вкладчика по договору ПДС
|Строка
|-
|NameVKL
|Наименование контрагента-вкладчика по договору ПДС
|Строка
|-
|TypeVKL
|Тип вкладчика
|Число
|-
|State
|Текущее состояние договора
|Строка
|-
|StopReason
|Причина закрытия
|Дата
|-
|DateSign
|Дата договора
|Дата
|-
|DateSignDog
|Дата заключения договора
|Дата
|-
|DateOpen
|Дата начала действия договора
|Дата
|-
|DateOpenFirst
|Дата заключения первого договора ПДС
|Дата
|-
|DateClose
|Дата прекращения договора
|Дата
|-
|Sheme
|Вид договора ПДС
|Строка
|-
|Type
|Тип договора ПДС
|Строка
|-
|Pattern
|Шаблон договора ПДС
|Строка
|}
Таблица. Значения Текущего состояние договора ПДС (State)
: {|class="wikitable"
! style="background:#EAECF0"| '''Значение'''
|-
|Открыт
|-
|Действует
|-
|Приостановлен
|-
|Подготовка к закрытию
|-
|Закрыт
|}
Таблица. Значения Причина закрытия/прекращения договора НПО (StopReason)
: {|class="wikitable"
! style="background:#EAECF0"| '''Значение'''
|-
|Заключен
|-
|Действует
|-
|Выплатной период
|-
|Закрыт
|}
Таблица. Значения Причина закрытия/прекращения договора ПДС (StopReason)
: {|class="wikitable"
! style="background:#EAECF0"| '''Значение'''
|-
|По смерти
|-
|Досрочное расторжение
|-
|Договор выполнен
|-
|Переход в другой НПФ
|}
Состав объекта «PaymentDetails»: информация о банковских реквизитах участника по счету
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|Type
|Форма выплаты
|Строка
|-
|RefKey
|ГУИД контрагента-получателя (участник/банк)
|Строка
|-
|AccountType
|Тип ЛС (лицевой счет/карточный счет)
|Строка
|-
|AccountNumber
|Номер ЛС
|Строка
|-
|BankAccount
|Расчетный счет
|Строка
|-
|BIK
|БИК Банка
|Строка
|}
Структура массива «OnePay»: информация о единовременных выплатах
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DateDecision
|Дата решения о единовременной выплате
|Дата
|-
|RefKeyDecision
|ГУИД решения о единовременной выплате
|Строка
|-
|Decision
|Представление решения о единовременной выплате
|Строка
|-
|RefKeyStatement
|ГУИД документа основания принятия решения
|Строка
|-
|Statement
|Представление документа основания принятия решения
|Строка
|-
|ТуреDocStatement
|Тип документа основания принятия решения
|Строка
|-
|Sum
|Размер единовременной выплаты
|Денежный
|}
Структура массива «FinalPay»: информация о выкупных суммах
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|Type
|Форма выплаты
|Строка
|-
|RefKey
|ГУИД контрагента-получателя (участник/банк)
|Строка
|-
|AccountType
|Тип ЛС (лицевой счет/карточный счет)
|Строка
|-
|AccountNumber
|Номер ЛС
|Строка
|-
|BankAccount
|Расчетный счет
|Строка
|-
|BIK
|БИК Банка
|Строка
|}
Структура массива «OnePay»: информация о единовременных выплатах
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DateDecision
|Дата решения о выплате выкупной суммы
|Дата
|-
|RefKeyDecision
|ГУИД решения о выплате выкупной суммы
|Строка
|-
|Decision
|Представление решения о выплате выкупной суммы
|Строка
|-
|RefKeyStatement
|ГУИД документа основания для принятия решения
|Строка
|-
|Statement
|Представление документа основания для принятия решения
|Строка
|-
|ТуреDocStatement
|Вид документа основания для принятия решения
|Строка
|-
|ТуреStatement
|Тип документа основания для принятия решения (тип заявления)
|Строка
|-
|SpecialSituation
|Вид особых обстоятельств
|Строка
|-
|TypeTherapy
|Вид дорогостоящего лечения
|Строка
|-
|Sum
|Размер выплаты
|Денежный
|}
'''Структура массива «OutPay»: информация о выкупных суммах'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|'''DateDecision'''
|'''Дата решения о выплате'''
|'''Дата'''
|-
|'''RefKeyDecision'''
|'''ГУИД решения о выплате выкупной суммы ПП'''
|'''Строка'''
|-
|'''Decision'''
|'''Представление решения о выплате выкупной суммы ПП'''
|'''Строка'''
|-
|'''Sum'''
|'''Сумма выплаты по решению'''
|'''Денежный'''
|}
'''Структура массива OutPay представлена в общем виде по шапке документа – предстоит доработка после обсуждения (включать/не включать расшифровку ТЧ по ПП)'''
Структура массива «Balance»: информация о выкупных суммах
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|TypeRes
|Тип резерва, на котором сформирован остаток
|строка
|-
|TypeResId
|Тип резерва, на котором сформирован остаток (идентификатор)
|Строка
|-
|TypeSum
|Тип суммы остатка
|Строка
|-
|TypeSumId
|Тип суммы остатка (идентификатор)
|Строка
|-
|Sum
|Сумма
|Денежный
|}
<h2>'''6.14 Сервисы по ОПС. (OPS_PS_Request) Получить данные по Договора клиентов ОПС'''</h2>
Обмен без учета регистрации изменений.
В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.
В рамках сервиса в качестве входящих параметров передаются идентификаторы клиентов (ФЛ/ЮЛ) есть признак «Есть ОПС», по которым сервис вернет информацию о его Договоре.
В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 100 000. (для post запроса доступно не более 100 000, для get запроса максимум= 40).
В результате сервис по каждому запрошенному идентификатору клиента возвращает информацию о его Договоре ОПС, а также о текущем остатке на Договоре. Передача персональных данных ко клиенту не предусмотрена.
При вызове через POST запрос в тело запроса передается JSON с массивом UID клиентов.
Пример структуры JSON:
{
    " uids": [
        "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
        "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
        "87e21fff-cb82-11e3-be9d-74d02bc3313d"
    ]
}
<h2>'''6.14.1 Описание объектов и параметров, которые используются при обмене данными'''</h2>
Входящий параметр (коллекция):
2. ГУИД контрагента /guidClient
По полученному списку ГУИД контрагента (guidClient) производится отбор Договоров. Выборка производится по справочнику Договоры ОПС по полю участник и формируется ответ. Если будет передан guidClient, который не имеет договор, то сервис не вернет по такому клиенту информацию. Персональная информация по Контрагенту (Участнику) не передается (кроме представления контрагента – для визуального контроля/тестирования)
Данные по остаткам на Договоре собираются по каждому Договору из РН Резервы ОПС с отбором по типам резервов: все, кроме «Резерв ОПС»
3. Объекты-источники:
3.1. Справочник. Контрагенты,
3.2. Справочник.уп_ДоговорыОПС,
3.3. РС.уп_СостоянияДоговораОПС
3.4. РС.уп_ПричиныЗакрытияДоговоровОПС
3.5. РС.уп_ПериодичностьВыплатОПС
3.6. РС.уп_РазмерПенсииОПС
3.7. РС.уп_ЛицевыеСчетаЗастрахованныхЛиц
3.8. РН.уп_РезервыОПС
4. Информация, которая передается в качестве результата:
4.1. Клиент  /guidClient
4.2. FindClientID - Признак КлинтНайден по гуид - булево
(FindClientID) - Если клиент по гуид не обнаружен, то FindClientID =False
Если клиент по гуид обнаружен, то FindClientID =TRUE и возвращается набор параметров:
4.3. Если ПС по ПДС найдены, то передается информация:
'''4.4. Договор (ОПС):'''
4.4.1. ГИУД ПД /
4.4.2. Код ПД /
4.4.3. ПД -ПометкаНаУдаление
4.4.4. Код участника/
4.4.5. ГИУД участника/
4.4.6. Состояние ПД /
4.4.7. Причина закрытия ПД /
4.4.8. Дата открытия ПД (накопит. период)/
4.4.9. Дата закрытия ПД /
4.4.10. Пенсионные параметры (По НП и СВ отдельно):
4.4.10.1. Дата назначения пенсии (Дата начала = 22.01.2024) /
4.4.10.2. Дата решения о назначении (01.03.2024)
4.4.10.3. Тип  пенсии = Пожизненная, срочная
4.4.10.4. Размер пенсии
4.4.10.5. Периодичность выплаты
4.4.10.6. Срок выплат
4.4.10.7. Дата окончания срочных выплат (из РС)
4.4.11. Единовременные выплаты (Данные по каждому Решению ЕВ):
4.4.11.1. Дата решения
4.4.11.2. Основание – вид заявления
4.4.11.3. Сумма к выплате
4.4.12. Переводы СПН в ПДС (Данные по каждому Решению):
4.4.12.1. Дата решения
4.4.12.2. Основание – вид заявления
4.4.12.3. Сумма
4.4.13. Назначенные выкупные суммы правопреемникам (Данные по каждому Решению ВС ПП):
4.4.13.1. Дата решения
4.4.13.2. Основание – вид заявления ()
4.4.13.3. Сумма к выплате
4.4.14. Платежные реквизиты (По НП и СВ отдельно)
4.4.14.1. Форма выплаты
4.4.14.2. Получатель (Участник\Банк) /
4.4.14.3. Тип ЛС
4.4.14.4. Номер ЛС
4.4.14.5. Расчетный счет
4.4.14.6. БИК Банка
4.4.14.7. Текущий остаток на ПС
4.4.14.7.1. Тип резерва
4.4.14.7.2. Тип суммы
4.4.14.7.3. Сумма
<h2>'''6.14.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам ПДС'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: '''[host]/…/OPS_PS_Request'''
'''Описание GET или POST запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|'''ops_ps_request'''
|
|-
|uid
|GUID контрагентов с разделителем «,» (запятая)
|Текст
|}
'''Описание JSON ответа:'''
Структура массива «clients»: массив объектов с информацией о пенсионных счетах ПДС контрагента
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД контрагента
|GUID
|-
|Exist
|Признак нахождения контрагента по ГУИД
|boolean
|-
|accounts
|массив Договоров ОПС
|Массив объектов
|}
Структура массива «accounts»: массив объектов с информацией, отраженной на Договоре ОПС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД пенсионного счета ПДС
|GUID
|-
|Code
|Код Договора ОПС
|Строка
|-
|CodeLS
|Код лицевого счета Договора ОПС
|Строка
|-
|DeletionMark
|Признак пометки на удаление пенсионного счета ПДС
|boolean
|-
|RefKeyUCH
|ГУИД контрагента-участника
|Строка
|-
|CodeUCH
|Код участника
|Строка
|-
|NameUCH
|Полное наименование участника (ФИО)
|Строка
|-
|TypeUCH
|Тип участника (1- Физическое лицо)
|Строка
|-
|State
|Текущее состояние Договора ОПС
|Строка
|-
|StopReason
|Причина закрытия Договора ОПС
|Строка
|-
|DateSign
|Дата заключения Договора ОПС
|Дата
|-
|DateOpen
|Дата открытия Договора ОПС
|Дата
|-
|DateClose
|Дата закрытия Договора ОПС
|Дата
|-
|InsurerPrev
|Информация о предыдущем Фонде
|Объект
|-
|InsurerNext
|Информация о следующем Фонде
|Объект
|-
|PensionNP
|Информация о назначенной накопительной пенсии
|Объект
|-
|PensionSV
|Информация о назначенной срочной выплате
|Объект
|-
|PaymentDetailsNP
|Информация о банковских реквизитах участника для накопительной пенсии
|Объект
|-
|PaymentDetailsSV
|Информация о банковских реквизитах участника для срочной выплаты
|Объект
|-
|OnePay
|Массив решений о единовременной выплате по договору
|Массив Объектов
|-
|PdsPay
|Массив решений о переводе СПН в ПДС
|Массив Объектов
|-
|OutPay
|Массив решений о выплате выкупных сумм ПП по Договору
|Массив Объектов
|-
|Balance
|Массив с информацией об остатке на ПС ПДС
|Массив Объектов
|}
Таблица. Значения Текущего состояние договора ОПС (State)
: {|class="wikitable"
! style="background:#EAECF0"| '''Значение'''
|-
|Заключен
|-
|Ожидание подтверждения ПФР
|-
|Ожидание поступления взносов
|-
|Накопительный период
|-
|Выплатной период
|-
|Приостановлен по отказу из ПФР
|-
|Подготовка к прекращению
|-
|Закрыт
|-
|Начисления приостановлены
|-
|Обязательства выполнены
|}
Таблица. Значения Причина закрытия договора ОПС (StopReason)
: {|class="wikitable"
! style="background:#EAECF0"| '''Значение'''
|-
|По смерти
|-
|Переход в другой ПФ
|-
|Переход в другой ПФ (досрочный)
|-
|Закрыт по отказу из ПФР
|-
|Аннулирование лицензии
|-
|Единовременная выплата
|-
|Не вступил в силу
|-
|По решению суда
|-
|Договор выполнен
|-
|Объединение СНИЛС
|-
|По иным причинам
|}
Состав объектов «InsurerPrev» и «InsurerNext»: информация о предыдущем и последующем страховщиках
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKey
|ГУИД страховщика
|GUID
|-
|Code
|Код страховщика
|Строка
|-
|Name
|Наименование страховщика
|Строка
|-
|INN
|ИНН страховщика
|Строка
|}
Состав объектов «PensionNP» и «PensionSV»: информация о назначенной периодической выплате
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DatePension
|Дата назначения пенсии
|Дата
|-
|DateDecision
|Дата решения о назначении пенсии
|Дата
|-
|Sum
|Размер пенсии
|Строка
|-
|Periodicity
|Периодичность выплаты пенсии
|Строка
|-
|Count
|Количество назначенных выплат. Для НП – не заполняется
|Целое число
|}
Состав объектов «PaymentDetailsNP» и «PaymentDetailsSV»: информация о банковских реквизитах участника по Договору
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|Type
|Форма выплаты
|Строка
|-
|RefKey
|ГУИД контрагента-получателя (участник/банк)
|Строка
|-
|AccountType
|Тип ЛС (лицевой счет/карточный счет)
|Строка
|-
|AccountNumber
|Номер ЛС
|Строка
|-
|BankAccount
|Расчетный счет
|Строка
|-
|BIK
|БИК Банка
|Строка
|}
Структура массива «OnePay»: информация о единовременных выплатах
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DateDecision
|Дата решения о единовременной выплате
|Дата
|-
|RefKeyDecision
|ГУИД решения о единовременной выплате
|Строка
|-
|Decision
|Представление решения о единовременной выплате
|Строка
|-
|RefKeyStatement
|ГУИД документа основания принятия решения
|Строка
|-
|Statement
|Представление документа основания принятия решения
|Строка
|-
|ТуреDocStatement
|Тип документа основания принятия решения
|Строка
|-
|Sum
|Размер единовременной выплаты
|Денежный
|}
Структура массива «PdsPay»: информация о переводе СПН в ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DateDecision
|Дата решения о переводе СПН в ПДС
|Дата
|-
|RefKeyDecision
|ГУИД решения о переводе СПН в ПДС
|Строка
|-
|Decision
|Представление решения о переводе СПН в ПДС
|Строка
|-
|RefKeyStatement
|ГУИД документа основания принятия решения
|Строка
|-
|Statement
|Представление документа основания принятия решения
|Строка
|-
|ТуреDocStatement
|Тип документа основания принятия решения
|Строка
|-
|Sum
|Размер суммы перевода
|Денежный
|}
Структура массива «OutPay»: информация о выкупных суммах
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DateDecision
|Дата решения о выплате выкупной суммы ПП
|Дата
|-
|RefKeyDecision
|ГУИД решения о выплате выкупной суммы ПП
|Строка
|-
|Decision
|Представление решения о выплате выкупной суммы ПП
|Строка
|-
|RefKeyStatement
|ГУИД документа основания принятия решения
|Строка
|-
|Statement
|Представление документа основания принятия решения
|Строка
|-
|ТуреDocStatement
|Тип документа основания принятия решения
|Строка
|-
|Sum
|Размер суммы выплаты
|Денежный
|}
Структура массива «Balance»: информация об остатках по договору
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DateDecision
|Дата решения о переводе СПН в ПДС
|Дата
|-
|RefKeyDecision
|ГУИД решения о переводе СПН в ПДС
|Строка
|-
|Decision
|Представление решения о переводе СПН в ПДС
|Строка
|-
|RefKeyStatement
|ГУИД документа основания принятия решения
|Строка
|-
|Statement
|Представление документа основания принятия решения
|Строка
|-
|ТуреDocStatement
|Тип документа основания принятия решения
|Строка
|-
|Sum
|Размер суммы перевода
|Денежный
|}
Структура массива «OutPay»: информация о выкупных суммах
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|TypeRes
|Тип резерва, на котором сформирован остаток
|строка
|-
|TypeResId
|Тип резерва, на котором сформирован остаток (идентификатор)
|Строка
|-
|TypeSum
|Тип суммы остатка
|Строка
|-
|TypeSumId
|Тип суммы остатка (идентификатор)
|Строка
|-
|Sum
|Сумма
|Денежный
|}
<h2>'''6.15 Сервисы по НПО. (NPO_Operations_Request) Получить данные выписки по ПС клиентов НПО'''</h2>
Обмен без учета регистрации изменений.
В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.
В рамках сервиса в качестве входящих параметров передаются идентификаторы ПС НПО, по которым сервис передает информацию о движениях по ПС.
В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 512. (для post запроса доступно не более 512, для get запроса максимум= 40).
В результате сервис по каждому запрошенному идентификатору ПС передает всю историю о движениях по ПС.
При вызове через POST запрос в тело запроса передается JSON с массивом UID счетов.
Пример структуры JSON:
{
    " uids": [
        "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
        "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
        "87e21fff-cb82-11e3-be9d-74d02bc3313d"
    ]
}
<h2>'''6.15.1 Описание объектов и параметров, которые используются при обмене данными'''</h2>
Входящий параметр (коллекция):
1. ГУИД ПС / guidPS
По полученному списку ГУИД ПС (guidPS) производится отбор ПС в РН Резервы НПО и формируется ответ.
Данные в РН Резервы НПО собираются с отбором по типам резервов: ИПС/СПС/ Резерв наследников ИПС/ Резерв наследников СПС
1. Объекты-источники:
1.1. Справочник. уп_ПенсионныеСчета
1.2. РН Резервы НПО
2. Информация, которая передается в качестве результата:
2.1. ПС / guidPS
2.2. FindPsID - Признак ПС Найден по гуид – булево. (FindPsID) - Если ПС по гуид не обнаружен, то FindPsID =False. Если ПС по гуид обнаружен, то FindPsID =TRUE и возвращается набор параметров:
2.3. Код ПС / accountNumber / KodPS
2.4. Движения:
2.4.1. Регистратор (документ):
2.4.2. Идентификатор документа / guidDoc
2.4.3. Дата документа / date
2.4.4. Номер документа /NumberDoc
2.4.5. Вид документа (как в 1с)
2.4.6. Представление документа (вид операции) / vidOp – описание заполнения приведено ниже
2.4.7. Дата движения
2.4.8. Вид движения (+Приход/-расход)
2.4.9. Тип резерва
2.4.10. Тип суммы/ typeSum
2.4.11. Сумма / sum
2.5. Таблица остатков по каждому ПС, которые передаются через этот сервис:
2.5.1. ГИУД ПС /guidPS
2.5.2. Код ПС / accountNumber / KodPS
2.5.3. Тип резерва
2.5.4. Тип суммы/ typeSum
2.5.5. Сумма / sum
'''Таблица 1. Типы резервов НПО'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|DateDecision
|Дата решения о переводе СПН в ПДС
|Дата
|-
|RefKeyDecision
|ГУИД решения о переводе СПН в ПДС
|Строка
|-
|Decision
|Представление решения о переводе СПН в ПДС
|Строка
|-
|RefKeyStatement
|ГУИД документа основания принятия решения
|Строка
|-
|Statement
|Представление документа основания принятия решения
|Строка
|-
|ТуреDocStatement
|Тип документа основания принятия решения
|Строка
|-
|Sum
|Размер суммы перевода
|Денежный
|}
Структура массива «OutPay»: информация о выкупных суммах
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип резерва (TypeResId)'''
! style="background:#EAECF0"| '''Представление Типа резерва (TypeRes)'''
|-
|СПС
|СПС
|-
|ИПС
|ИПС
|-
|ПожизненныхВыплат
|Пожизненных выплат
|-
|Страховой
|Страховой
|-
|РезервНачисленийПенсийСПС
|Резерв начислений пенсий СПС
|-
|РезервНачисленийПенсийИПС
|Резерв начислений пенсий ИПС
|-
|РезервНачисленийПенсийПожизненныхВыплат
|Резерв начислений пенсий пожизненных выплат
|-
|РезервНачисленийВыкупныхСуммСПС
|Резерв начислений выкупных сумм СПС
|-
|РезервНачисленийВыкупныхСуммИПС
|Резерв начислений выкупных сумм ИПС
|-
|РезервНачисленийВыкупныхСуммПожизненныхВыплат
|Резерв начислений выкупных сумм пожизненных выплат
|-
|РезервНаследниковИПС
|Резерв наследников ИПС
|-
|РезервНаследниковСПС
|Резерв наследников СПС
|-
|РезервНачисленийНаследниковИПС
|Резерв начислений наследников ИПС
|-
|РезервНачисленийНаследниковСПС
|Резерв начислений наследников СПС
|-
|РПАР
|РПАР
|}
Таблица 2. Типы сумм НПО
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип сумм (TypeSumId)'''
! style="background:#EAECF0"| '''Представление Типа сумм НПО (TypeSum)'''
|-
|ИДНаРезерв
|ИД на резерв
|-
|Резерв
|Резерв
|-
|ИДФиз
|ИД на взносы физ.лиц
|-
|ИДТр
|ИД на взносы третьих лиц
|-
|ИДЮр
|ИД на взносы юр.лиц
|-
|ВзносыФиз
|Взносы физ.лиц
|-
|ВзносыТр
|Взносы третьих лиц
|-
|ВзносыЮр
|Взносы юр.лиц
|-
|ВзносыЮрЛицНеоблагаемые
|Взносы юр.лиц необлагаемые
|}
<h2>'''6.15.2 Описание Запроса и ответа получения полной выписки по ПС клиентов НПО'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: '''[host]/…/ NPO_Operations_Request'''
'''Описание GET или POST запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|'''npo_operations_request'''
|
|-
|uid
|GUID пенсионных счетов с разделителем «,» (запятая)
|Текст
|}
'''Описание JSON ответа:'''
Структура массива «accounts»: массив структур с информацией о движении по ПС НПО и остаткам на ПС НПО
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKeyPS
|ГУИД пенсионного счета ПДС
|GUID
|-
|Exist
|Признак найденного пенсионного счета НПО по ГУИД
|boolean
|-
|CodePS
|Код пенсионного счета ПС
|Строка
|-
|operations
|Массив с информацией о движении по ПС ПДС
|Массив объектов
|-
|Balance
|Массив с информацией об остатке на ПС ПДС
|Массив объектов
|}
Структура массива «operations»: массив структур с информацией о движении по ПС ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKeyDoc
|ГУИД документа – регистратора движения по ПС НПО
|Строка
|-
|PresDoc
|Представление документа – регистратора движения по ПС НПО
|Строка
|-
|DateDoc
|Дата документа – регистратора
|Дата
|-
|NumberDoc
|Номер документа – регистратора
|Строка
|-
|TypeDoc
|Тип документа – регистратора
|Строка
|-
|TypeMove
|Направление денежного потока (приход/расход)
|Строка
|-
|TypeRes
|Тип резерва, на котором отражено движение
|Строка
|-
|TypeResId
|Тип резерва, на котором отражено движение  (идентификатор)
|Строка
|-
|TypeSum
|Тип суммы движения
|Строка
|-
|TypeSumId
|Тип суммы движения (идентификатор)
|Строка
|-
|Sum
|Сумма
|денежный
|}
Структура массива «Balance»: массив структур с информацией о суммах, составляющих остаток ПС ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|TypeRes
|Тип резерва, на котором сформирован остаток
|Строка
|-
|TypeResId
|Тип резерва, на котором сформирован остаток (идентификатор)
|Строка
|-
|TypeSum
|Тип суммы остатка
|Строка
|-
|TypeSumId
|Тип суммы остатка (идентификатор)
|Строка
|-
|Sum
|Сумма
|денежный
|}
<h2>'''6.16 Сервисы по ПДС. (PDS_Operations_Request) Получить данные выписки по ПС клиентов ПДС'''</h2>
Обмен без учета регистрации изменений.
В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.
В рамках сервиса в качестве входящих параметров передаются идентификаторы ПС ПДС, по которым сервис передает информацию о движениях по ПС.
В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 512. (Для post запроса доступно не более 512, для get запроса максимум= 40).
В результате сервис по каждому запрошенному идентификатору ПС передает всю историю о движениях по ПС.
При вызове через POST запрос в тело запроса передается JSON с массивом UID счетов.
Пример структуры JSON:
{
    " uids": [
        "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
        "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
        "87e21fff-cb82-11e3-be9d-74d02bc3313d"
    ]
}
<h2>'''6.16.1 Описание объектов и параметров, которые используются при обмене данными'''</h2>
Входящий параметр (коллекция):
1. ГУИД ПС / guidPS
По полученному списку ГУИД ПС (guidPS) по ПДС производится отбор ПС в РН Резервы ПДС и формируется ответ.
Данные в РН Резервы ПДС собираются с отбором по типам резервов: резервов: ИПС/ Резерв умерших ИПС
1. Объекты-источники:
1.1. Справочник. пдс_ПенсионныеСчетаПДС
1.2. РН Резервы ПДС
2. Информация, которая передается в качестве результата:
2.1. ПС / guidPS
2.2. FindPsID - Признак ПС Найден по гуид - булево
(FindPsID) - Если ПС по гуид не обнаружен, то FindPsID =False
Если ПС по гуид обнаружен, то FindPsID =TRUE и возвращается набор параметров:
2.3. Код ПС / accountNumber / KodPS
2.4. Движения:
2.4.1. Регистратор (документ):
2.4.2. Идентификатор документа / guidDoc
2.4.3. Дата документа / date
2.4.4. Номер документа /NumberDoc
2.4.5. Вид документа (как в 1с)
2.4.6. Представление документа (вид операции) / vidOp – описание заполнения приведено ниже
2.4.7. Дата движения
2.4.8. Вид движения (+Приход/-расход)
2.4.9. Тип резерва
2.4.10. Тип суммы/ typeSum
2.4.11. Сумма / sum
2.5. Таблица остатков по каждому ПС, которые передаются через этот сервис:
2.5.1. ГИУД ПС /guidPS
2.5.2. Код ПС / accountNumber / KodPS
2.5.3. Тип резерва
2.5.4. Тип суммы/ typeSum
2.5.5. Сумма / sum
'''Таблица 1. Типы резервов ПДС'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип резерва (TypeResId)'''
! style="background:#EAECF0"| '''Представление Типа резерва (TypeRes)'''
|-
|ИПС
|ИПС
|-
|РезервСрочнойВыплаты
|Резерв срочной выплаты
|-
|РезервПожизненнойВыплаты
|Резерв пожизненной выплаты
|-
|РезервЕдиновременнойВыплаты
|Резерв единовременной выплаты
|-
|РезервНачисленияСрочнойВыплаты
|Резерв начисления срочной выплаты
|-
|РезервНачисленияПожизненнойВыплаты
|Резерв начисления пожизненной выплаты
|-
|РезервНачисленияЕдиновременнойВыплаты
|Резерв начисления единовременной выплаты
|-
|РезервНачисленияВыкупныхСумм
|Резерв начисления выкупных сумм
|-
|РезервНачисленияПриПереводеВДругойПФ
|Резерв начисления при переводе в другой ПФ
|-
|РезервНачисленияОсобыеОбстоятельства
|Резерв начисления особые обстоятельства
|-
|РезервУмершихИПС
|Резерв умерших ИПС
|-
|РезервУмершихРСВ
|Резерв умерших РСВ
|-
|РезервНачисленияПравопреемникамИПС
|Резерв начисления правопреемникам ИПС
|-
|РезервНачисленияПравопреемникамРСВ
|Резерв начисления правопреемникам РСВ
|-
|Страховой
|Страховой
|}
'''Таблица 2. Типы сумм ПДС'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип суммы (TypeSumId)'''
! style="background:#EAECF0"| '''Представление Типа сумм (TypeSum)'''
|-
|ВзносыЮЛ
|Взносы ЮЛ
|-
|ИДВзносыЮЛ
|ИД на взносы ЮЛ
|-
|Сберегательный
|Сберегательный взнос
|-
|Единовременный
|Единовременный взнос
|-
|ДополнительныйСтимулирующий
|Дополнительный стимулирующий взнос
|-
|СберегательныйТЛ
|Сберегательный взнос третьих лиц
|-
|ИДСберегательный
|ИД на сберегательный взнос
|-
|ИДЕдиновременный
|ИД на единовременный взнос
|-
|ИДДополнительныйСтимулирующий
|ИД на дополнительный стимулирующий взнос
|-
|ИДСберегательныйТЛ
|ИД на сберегательный взнос третьих лиц
|}
<h2>'''6.16.2 Описание Запроса и ответа получения полной выписки по ПС клиентов ПДС'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: '''[host]/…/PDS_Operations_Request'''
'''Описание GET или POST запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|'''pds_operations_request'''
|
|-
|uid
|GUID контрагентов с разделителем «,» (запятая)
|Текст
|}
'''Описание JSON ответа:'''
Структура массива «accounts»: массив структур с информацией о движении по ПС ПДС и остаткам на ПС ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKeyPS
|ГУИД пенсионного счета ПДС
|GUID
|-
|Exist
|Признак найденного пенсионного счета ПДС по ГУИД
|boolean
|-
|CodePS
|Код пенсионного счета ПС
|Строка
|-
|operations
|Массив с информацией о движении по ПС ПДС
|Массив объектов
|-
|Balance
|Массив с информацией об остатке на ПС ПДС
|Массив объектов
|}
Структура массива «operations»: массив структур с информацией о движении по ПС ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKeyDoc
|ГУИД документа – регистратора движения по ПС ПДС
|строка
|-
|PresDoc
|Представление документа – регистратора движения по ПС ПДС
|строка
|-
|DateDoc
|Дата документа – регистратора
|Дата
|-
|NumberDoc
|Номер документа – регистратора
|строка
|-
|TypeDoc
|Тип документа – регистратора
|строка
|-
|TypeMove
|Направление денежного потока (приход/расход)
|строка
|-
|TypeRes
|Тип резерва, на котором отражено движение
|строка
|-
|TypeResId
|Тип резерва, на котором отражено движение  (идентификатор)
|строка
|-
|TypeSum
|Тип суммы движения
|строка
|-
|TypeSumId
|Тип суммы движения (идентификатор)
|строка
|-
|Sum
|Сумма
|денежный
|}
Структура массива «Balance»: массив структур с информацией о суммах, составляющих остаток ПС ПДС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|TypeRes
|Тип резерва, на котором сформирован остаток
|строка
|-
|TypeResId
|Тип резерва, на котором сформирован остаток (идентификатор)
|строка
|-
|TypeSum
|Тип суммы остатка
|строка
|-
|TypeSumId
|Тип суммы остатка (идентификатор)
|строка
|-
|Sum
|Сумма
|денежный
|}
<h2>'''6.17 Сервисы по ОПС. (OPS_Operations_Request) Получить данные выписки по Договорам клиентов ОПС'''</h2>
Обмен без учета регистрации изменений.
В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.
В рамках сервиса в качестве входящих параметров передаются идентификаторы Договоров ОПС, по которым сервис передает информацию о движениях.
В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 512. (Для post запроса доступно не более 512, для get запроса максимум= 40).
В результате сервис по каждому запрошенному идентификатору Договора передает всю историю о движениях.
При вызове через POST запрос в тело запроса передается JSON с массивом UID Договоров.
Пример структуры JSON:
{
    " uids": [
        "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
        "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
        "87e21fff-cb82-11e3-be9d-74d02bc3313d"
    ]
}
<h2>'''6.17.1 Описание объектов и параметров, которые используются при обмене данными'''</h2>
Входящий параметр (коллекция):
2. ГУИД ПС / guidPS
По полученному списку ГУИД Договоров (guidPS) по ОПС производится отбор Договоров в РН Резервы ОПС и формируется ответ.
Данные в РН Резервы ОПС собираются с отбором по типам резервов: резервов: все, кроме «Резерв ОПС»
3. Объекты-источники:
3.1. Справочник. уп_ДоговорыОПС
3.2. РН Резервы ОПС
4. Информация, которая передается в качестве результата:
4.1. Договор / guidPS
4.2. FindPsID - Признак Договор Найден по гуид - булево
(FindPsID) - Если Договор по гуид не обнаружен, то FindPsID =False
Если Договор по гуид обнаружен, то FindPsID =TRUE и возвращается набор параметров:
4.3. Код Договор / accountNumber / KodPS
4.4. Движения:
4.4.1. Регистратор (документ):
4.4.2. Идентификатор документа / guidDoc
4.4.3. Дата документа / date
4.4.4. Номер документа /NumberDoc
4.4.5. Вид документа (как в 1с)
4.4.6. Дата движения
4.4.7. Вид движения (+Приход/-расход)
4.4.8. Тип резерва
4.4.9. Тип суммы/ typeSum
4.4.10. Сумма / sum
4.5. Таблица остатков по каждому Договору, которые передаются через этот сервис:
4.5.1. ГИУД Договора /
4.5.2. Код Договора /
4.5.3. Тип резерва
4.5.4. Тип суммы/
4.5.5. Сумма /
'''Таблица 1. Типы резервов ОПС'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип резерва (TypeResId)'''
! style="background:#EAECF0"| '''Представление Типа резерва (TypeRes)'''
|-
|РезервПенсионныйНакоплений
|РПН
|-
|РезервСрочнойВыплаты
|РСВ
|-
|Выплатной
|Выплатной
|-
|РезервЕВ
|Резерв единовременной выплаты
|-
|РезервНачисленийНП
|Резерв начислений НП
|-
|РезервНачисленийСВ
|Резерв начислений СВ
|-
|РезервНачисленийЕВ
|Резерв начислений ЕВ
|-
|РезервНаследниковРПН
|Резерв умерших РПН
|-
|РезервНаследниковРСВ
|Резерв умерших РСВ
|-
|РезервНачисленийРасторжение
|Резерв начислений расторжение
|-
|РезервНачисленийНаследованиеРПН
|Резерв начислений наследование РПН
|-
|РезервНачисленийНаследованиеРСВ
|Резерв начислений наследование РСВ
|-
|РезервНачисленийНаследованиеРОПС
|Резерв начислений наследование РОПС
|-
|РезервНачисленийВозвратМСКРПН
|Резерв начислений возврат  МСК РПН
|-
|РезервНачисленийВозвратМСКРСВ
|Резерв начислений возврат  МСК РСВ
|-
|РезервНачисленийРазделениеСНИЛС
|Резерв начислений разделение СНИЛС
|}
'''Таблица 2. Типы сумм ОПС'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Тип суммы (TypeSumId)'''
! style="background:#EAECF0"| '''Представление Типа сумм (TypeSum)'''
|-
|ВзносыФиз
|Страховые взносы
|-
|ВзносыЮр
|Взносы работодателя
|-
|ГосПоддержка
|Взносы софинансирование
|-
|ДопВзносы
|Доп. страховые взносы
|-
|МатКапитал
|Материнский капитал
|-
|ИДФиз
|ИД на страховые взносы
|-
|ИДЮр
|ИД на взносы работодателя
|-
|ИДГосПоддержка
|ИД на софинансирование
|-
|ИДДопВзносы
|ИД на доп. страх. взносы
|-
|ИДМатКапитал
|ИД на материнский капитал
|}
<h2>'''6.17.2 Описание Запроса и ответа получения полной выписки по ПС клиентов ОПС'''</h2>
Параметры: ID узла обмена / ключ
Путь к сервису: '''[host]/…/OPS_Operations_Request'''
'''Описание GET или POST запрос:'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|ИмяМетода
|'''ops_operations_request'''
|
|-
|uid
|GUID договоров с разделителем «,» (запятая)
|Текст
|}
'''Описание JSON ответа:'''
Структура массива «accounts»: массив структур с информацией о движении и остаткам на Договорах ОПС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKeyPS
|ГУИД Договора ОПС
|GUID
|-
|Exist
|Признак найденного Договора ОПС по ГУИД
|boolean
|-
|CodePS
|Код Договора ОПС
|Строка
|-
|operations
|Массив с информацией о движении по Договору ОПС
|Массив объектов
|-
|Balance
|Массив с информацией об остатке на Договоре ОПС
|Массив объектов
|}
Структура массива «operations»: массив структур с информацией о движении по Договору ОПС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|RefKeyDoc
|ГУИД документа – регистратора
|строка
|-
|PresDoc
|Представление документа – регистратора
|строка
|-
|DateDoc
|Дата документа – регистратора
|Дата
|-
|NumberDoc
|Номер документа – регистратора
|строка
|-
|TypeDoc
|Тип документа – регистратора
|строка
|-
|TypeMove
|Направление денежного потока (приход/расход)
|строка
|-
|TypeRes
|Тип резерва, на котором отражено движение
|строка
|-
|TypeResId
|Тип резерва, на котором отражено движение  (идентификатор)
|строка
|-
|TypeSum
|Тип суммы движения
|строка
|-
|TypeSumId
|Тип суммы движения (идентификатор)
|строка
|-
|Sum
|Сумма
|денежный
|}
Структура массива «Balance»: массив структур с информацией о суммах, составляющих остаток на Договоре ОПС
: {|class="wikitable"
! style="background:#EAECF0"| '''Элемент'''
! style="background:#EAECF0"| '''Описание'''
! style="background:#EAECF0"| '''Тип данных'''
|-
|TypeRes
|Тип резерва, на котором сформирован остаток
|строка
|-
|TypeResId
|Тип резерва, на котором сформирован остаток (идентификатор)
|строка
|-
|TypeSum
|Тип суммы остатка
|строка
|-
|TypeSumId
|Тип суммы остатка (идентификатор)
|строка
|-
|Sum
|Сумма
|денежный
|}
<h2>'''7 Приложения'''</h2>
'''Таблица А. Коды ответов сервисов'''
: {|class="wikitable"
! style="background:#EAECF0"| '''Код ответа'''
! style="background:#EAECF0"| '''Описание'''
|-
|200
|Сервис отработал без ошибок. В теле ответа – json файл.
|-
|400
|Некорректно заданы параметры сервиса. В теле ответа – текстовое описание ошибки.
|-
|404
|В базе 1С не найдены данные. В теле ответа – текстовое описание ошибки.
|-
|405
|Некорректно задано имя метода сервиса. В теле ответа – текстовое описание ошибки.
|-
|500
|Ошибки выполнения на сервере. В теле ответа – текстовое описание ошибки.
|}


[[Категория:УНПФ| ]]
[[Категория:УНПФ| ]]

Текущая версия от 10:48, 31 июля 2025

Модуль обмена данными НПФ

Возврат к заглавной странице

Модуль обмена данными НПФ

Версия документа

  • 1.1 – 09.04.2024 Добавлено в: п 5.5.2, 5.11.2 – описание структуры реквизита OutPay (информация о решениях выплаты выкупной суммы правопреемникам)
  • 1.2 – 09.04.2024 Удалены лишние данные, скорректировано описание поля vidOp
  • 1.3 – 02.05.2024 Добавлен раздел Назначение модуля и скорректировано описание цели
  • 1.4 – 18.10.2024 Добавлено в: п 6.3.2, 6.9.2 – описание структуры реквизита AddressJSON (информация о структуре адреса в формате JSON)
  • 1.5 – 18.10.2024 Добавлены разделы для сервисов по Договорам ОПС (изменены: п.4, 5.1, 5.2. Добавлены: п.6.6, 6.9, 6.14, 6.17) Обновлены картинка с параметрами настройки
  • 1.6 – 06.11.2024 Обновлены описания таблиц «Типы резервов» и «Типы Сумм» для НПО, ПДС,ОПС. Добавлены поля «TypeResId» и «TypeSumId» в структуры данных по остаткам и движениям денежных средств для НПО,ПДС,ОПС
  • 1.7 – 21.02.2025 Обновлены описания полей структуры договора ПДС.

1 Назначение модуля

Модуль предназначен для предоставления необходимой информации для внешних систем (Например: СРМ, ЛК и т.п.) из подсистемы пенсионного учета УНПФ8 по НПО,ПДС и ОПС. Модуль работе в виде http-сервиса. Формат сообщений = json. Модуль доступен после покупки и активации соответствующей лицензии на сервере СЛК. Наименование модуля в УНПФ8 и в СЛК = «Обмен УНПФ».

2 Цели

Сервиса реализован в 1С (конфигурация УНПФ8) для предоставления данных внешним системам.

На стороне 1С ведется регистрация изменений данных по клиентам (ФЛ) и данных по пенсионным счетам и договорам, а также операций (документов) с ними связанных Для каждой внешний системы в 1С создается «узел обмена», в рамках которого производится учет регистрация изменений и обмен данными. Обмен данными производится в виде «сообщений», в рамках которых регистрируется успешная или неуспешная передача данных.

Предусмотрены отдельные сервисы для получения полных данных выборочно по конкретным клиентам вне рамок подсистемы регистрации изменений. Настройка реализована для вида учета по НПО, ПДС и ОПС.

В рамках сервиса предусмотрена только предоставление данных по запросу. Загрузка информации в 1С (УНПФ8) не предусмотрена, т.е. загрузка новых договоров, участников и т.п. в рамках данного сервиса не предусмотрена.

3 Принятые сокращения и общие параметры

  • Квитирование - подтверждение приёма-передачи структурной единицы информации
  • URL Пространства имен - Требуется для идентификации веб-сервиса, по сочетанию его имени и пространству имен. Значение присваиваем: ______
  • Пакеты XDTO (XML Data Transfer Objects) — это механизм, разработанный фирмой “1С” для обмена данными с другими программными системами посредством XML, позволяющий на уровне языка 1С оперировать не узлами XML, а прикладными понятиями “Сотрудник”, “Счет” и привычными встроенными типами (“ТаблицаЗначений”, “СправочникСсылка” и т.п.)
  • Узел обмена – внешняя система
  • ФЛ- физическое лицо
  • ЮЛ- Юридическое лицо
  • ПС- пенсионный счет
  • ПД – пенсионный договор
  • НПО- учет по договорам негосударственное пенсионное обеспечение
  • ПДС- учет по договорам долгосрочных сбережений (ПДС = Программа долгосрочных сбережений)
  • ОПС – учет по договорам обязательного пенсионного страхования
  • Спр – Справочник
  • РС – Регистр сведений
  • РН – Регистр накоплений
  • Док – Документ
  • БД – база данных
  • ДУЛ – документ удостоверения личности
  • ИД – инвестиционный доход
  • ИПД – индивидуальный пенсионный договор
  • ПР – пенсионные резервы
  • Р/С – расчетный счет
  • СПС – Солидарный пенсионный счет
  • СР – страховой резерв

4 Настройка сервиса обмена 1С: УНПФ

Для предоставления данных внешним системам необходимо осуществить настройку сервисов обмена на форме «Настройки сервиса обмена УНПФ», которая доступна в разделе «Общие настройки УНПФ»/«Сервис доступа к данным УНПФ8»

Данная настройка выполняется индивидуально для каждой внешней системы. Настройка доступна только пользователю с полными правами.

Параметр «Пользователь» определяет от имени какого пользователя будет производится подключение к 1с со стороны внешней системы. Такой пользователь и его пароль задается администратором системы 1с. У пользователя должны быть доступна роль «Доступ к сервису УНПФ».

Параметр «Организация» - используется для отбора данных, которые передаются через сервис.

Параметр «Имя модуля» - если не задан, то используется модуль поставщика с предопределенным именем «уп_ИнтеграцияСВнешнимиСистемами». Либо указывается имя общего модуля, который настроен под требования организации. В модуле прописывается порядок сбора информации и формирование ответа json.

Установка флага «Действует» предоставляет внешнему пользователю возможность получать данные из системы УНПФ. При подключении внешнего пользователя производится сверка есть ли для него данная настройка обмена и действует ли она. В рамках группы сервисов по регистрации изменений проверяется включена ли регистрация таких изменений (задан ли узел обмена и включен ли флаг «регистрировать изменения»). Если регистрация изменений не включена или не настроена, то будет ответ с кодом ошибки и с описанием ошибки (404,"Не указан в настройках источник данных").

Значение «Макс количество идентификаторов…» для GET-запросов по умолчанию равно 40, для POST-запросов 100 000.

На закладке «Планы обмена» настраиваются узлы обмена для каждого пользователя (внешняя система). В узлах обмена производится регистрация и накопление изменений с момента последнего успешного обмена. Рекомендуется имя для узлов задавать по следующей маске: «Имя внеш. системы (пользователь)»-«Вид регистрируемых данных».

Предусмотрены следующие виды регистрируемых данных (изменений): Контрагенты, ПС НПО, ПС ПДС, Договоры ОПС, Резервы НПО, Резервы ПДС, Резервы ОПС.

Флаг «Регистрировать изменений» - если флаг установлен, то производится регистрация изменений в заданном узле обмена. Флаг устанавливается/снимается по кнопке «Вкл»/ «Откл».

Параметр «№ Сообщения» - последний номер сообщения, который был передан в результате обмена.

5 Виды сервисов

1. В рамках проекта предусматривается разработка две группы сервисов для вида учета НПО/ПДС/ОПС:

  • Группа сервисов, в рамках которых ведется учет регистрации изменения передаваемых данных. Регистрационный учет ведется в рамках каждого узла обмена (внешняя система).
  • Группа сервисов, в рамках которой не ведется учет регистрации изменения передаваемых данных. Данные по такой группе передаются в полном объеме, но только по запрошенным guid клиентам/договорам.

Предусмотрена возможность получения полного списка клиентов.

2. Аутентификация сервисов в базе данных 1С производится: по логину и паролю 1С.

3. Каждому узлу обмена (внешнему клиенту) присваивается идентификатор (по умолчанию планируется использовать логин и пароль). При обмене данный параметр является обязательным.

4. В имени каждой функции сервиса и у каждого плана обмена 1с8 устанавливается префикс, который характеризуем систему обмена в рамках вида учета NPO(НПО), OPS(ОПС), PDS(ПДС).

5.1 Описание группы сервисов, в рамках которых ведется учет регистрации изменения передаваемых данных по НПО/ПДС/ОПС

Имена сервисов в документе содержат в имени дефис, для удобства визуального восприятия. По мере завершения работы над документом дефис будет замен на символ подчёркивания.

Все сообщения обмена через это набор сервисов производится в разрезе номеров сообщений в рамках каждого узла обмена (клиент). По результатам успешного обмена узел обмена обязан передать сообщение об успешном прохождении обмена по номеру сообщения (квитирование).

Данный учет необходим для реализации учета какой набор изменённых данных требуется передать узлу обмена с момента последнего обмена. И как следствие регистрация учета изменений ведется в рамках каждого узла отдельно (что позволит реализовать независимый учета обмена измененными данными между разными системами. Например, таким как ЛК и Синтакси).

Предусмотрены следующий набор сервисов (структура обмена будет описана в подразделах):

1. Общие сервисы (без привязки к НПО/ОПС/ПДС) 1.1. («StatusExchange») Информирование об успешном прохождении сообщений

  • Узел обмена должен будет присылать информацию/подтверждение об успешном обмене по сообщению (успешный прием сообщения)
  • Параметры входящего запроса: Коллекция с указанием идентификатора узла обмена , номера сообщения (НомерСообщения) и имя сервиса
  • Ответа не предусмотрено (либо стандартные коды ответов).

1.2. («ClientsChg_Request») Обмен изменениями по Клиентам:

  • Учет регистрации изменений ведется по всем контрагентам (ФЛ/ЮЛ).
  • Параметры входящего запроса: отсутствуют
  • Обмена в рамках номеров сообщений: да
  • Ответ: передается коллекция данных по ФЛ/ЮЛ, по которым зафиксированы изменения с момента последнего подтвержденного обмена. Сведения не привязаны к виду учета НПО/ОПС и т.п.

2. Сервисы по НПО:

2.1. («NPO_PSChg_Request») Обмен изменениями по ПС и ПД (НПО)

  • Параметры входящего запроса: отсутствуют
  • Обмена в рамках номеров сообщений: да
  • Ответ: передается коллекция характеристик по ПС и ПД, по которым зафиксированы изменения с момента последнего подтвержденного обмена

2.2. («NPO_OperationsChg_Request») Обмен изменениями по движениям (выписка по ПС) (НПО) -в рамках движений денежных средств по ПС:

  • Параметры входящего запроса: отсутствуют
  • Обмена в рамках номеров сообщений: да
  • Движений денежных средств привязаны к регистратору (документ). В случае отмены проведения или пометки удаления документа – движения в узле обмена придется чистить по регистратору. В рамках обмена будет передавать идентификатор регистратора, по которому требуется очистить движения.
  • Ответ: передается коллекция документов и движений по ним, по которым зафиксированы изменения с момента последнего подтвержденного обмена

3. Сервисы по ПДС:

3.1. («PDS_PSChg_Request») Обмен изменениями по ПС и ПД (ПДС)

  • Параметры входящего запроса: отсутствуют
  • Обмена в рамках номеров сообщений: да
  • Ответ: передается коллекция характеристик по ПС и ПД, по которым зафиксированы изменения с момента последнего подтвержденного обмена

3.2. («PDS_OperationsChg_Request») Обмен изменениями по движениям (выписка по ПС) (ПДС) -в рамках движений денежных средств по ПС:

  • Параметры входящего запроса: отсутствуют
  • Обмена в рамках номеров сообщений: да
  • Движений денежных средств привязаны к регистратору (документ). В случае отмены проведения или пометки удаления документа – движения в узле обмена придется чистить по регистратору. В рамках обмена будет передавать идентификатор регистратора, по которому требуется очистить движения.
  • Ответ: передается коллекция документов и движений по ним, по которым зафиксированы изменения с момента последнего подтвержденного обмена

4. Сервисы по ОПС:

4.1. («OPS_PSChg_Request») Обмен изменениями по Договорам (ОПС)

  • Параметры входящего запроса: отсутствуют
  • Обмена в рамках номеров сообщений: да
  • Ответ: передается коллекция характеристик по Договорам ОПС, по которым зафиксированы изменения с момента последнего подтвержденного обмена

4.2. («OPS_OperationsChg_Request») Обмен изменениями по движениям (выписка по Договору) (ОПС) -в рамках движений денежных средств по Договору:

  • Параметры входящего запроса: отсутствуют
  • Обмена в рамках номеров сообщений: да
  • Движений денежных средств привязаны к регистратору (документ). В случае отмены проведения или пометки удаления документа – движения в узле обмена придется чистить по регистратору. В рамках обмена будет передавать идентификатор регистратора, по которому требуется очистить движения.
  • Ответ: передается коллекция документов и движений по ним, по которым зафиксированы изменения с момента последнего подтвержденного обмена

5.2 Описание группы сервисов, в рамках которых не ведется учет регистрации изменения передаваемых данных

В рамках данной группы сервисов не предусмотрен контроль подтверждения успешного прохождения сообщений.

Вызывать сервис можно через как через GET, так и через POST. При вызове через POST в тело запроса передается JSON с массивом UID клиентов или счетов (в зависимости от сервиса).

Пример структуры JSON:

{ 

   " uids": [

       "7a2e005a-8efd-11e3-be8c-74d02bc3313d",

       "87e21ffa-cb82-11e3-be9d-74d02bc3313d",

       "87e21fff-cb82-11e3-be9d-74d02bc3313d"

   ]

}

Обращаем внимание, что через GET запрос используется параметр uid, а POST запросе используется параметр uids.

1. Общие сервисы (без привязки к НПО/ПДС):

1.1. (Функция «ClientsID_Request») Список идентификаторов клиентов:

  • Параметры входящего запроса: отсутствуют
  • Обмена в рамках номеров сообщений: нет
  • Ответ: возвращает идентификаторы (guid контрагента) всех клиентов (контрагентов ЮЛ/ФЛ), в т.ч. предусмотрен признак о наличии ПС в учете НПО/ПДС/ОПС.

1.2. (Функция «ClientsInfo_Request») Получение информации по клиентам:

  • Параметры входящего запроса: Коллекция «Идентификаторов Клиента» (guid контрагента). Количество идентификаторов клиентов в одном запросе ограничено. – параметр планируется вывести в настройки обмена.
  • Обмена в рамках номеров сообщений: нет
  • Ответ: возвращает информацию по клиенту (карточка контрагента ЮЛ/ФЛ), в т.ч. предусмотрен признак о наличии ПС в учете НПО/ПДС/ОПС.
  • Можно вызывать как через GET, так и через POST. При вызове через POST в тело запроса передается JSON с массивом UID клиентов или счетов (в зависимости от сервиса).

2. Сервисы по НПО:

2.1. (Функция «NPO_PS_Request») Получить данные по ПС клиентов НПО:

  • Параметры входящего запроса: Коллекция «Идентификаторов Клиента» (guid контрагента). Количество идентификаторов клиентов в одном запросе ограничено. – параметр планируется вывести в настройки обмена
  • Обмена в рамках номеров сообщений: нет
  • Ответ: возвращает данные по пенсионным счетам клиента (ФЛ и ЮЛ) в учете НПО и характеристики пенсионного договора, текущий остаток на ПС.

2.2. (Функция «NPO_Operations_Request») Получить полную выписку по счетам НПО:

  • Передаем полные данные по ФЛ/ЮЛ и полные данные по движениям + тек. остатки
  • Параметры входящего запроса: Коллекция «Идентификатор ПС» (ГУИД ПС (guidPS)). Количество идентификаторов в одном запросе будет ограничено – параметр планируется вывести в настройки обмена
  • Обмена в рамках номеров сообщений: нет
  • Ответ: передается история всех движений по запрошенным ПС в разрезе регистраторов (документов) в учете НПО.
  • Можно вызывать как через GET, так и через POST. При вызове через POST в тело запроса передается JSON с массивом UID клиентов или счетов (в зависимости от сервиса).

3. Сервисы по ПДС:

3.1. (Функция «PDS_PS_Request») Получить данные по ПС клиентов ПДС:

  • Параметры входящего запроса: Коллекция «Идентификаторов Клиента» (guid контрагента). Количество идентификаторов клиентов в одном запросе ограничено. – параметр планируется вывести в настройки обмена
  • Обмена в рамках номеров сообщений: нет
  • Ответ: возвращает данных по пенсионным счетам клиента в учете ПДС (ФЛ) и характеристики договора такого клиента, текущие остатки на ПС.
  • Можно вызывать как через GET, так и через POST. При вызове через POST в тело запроса передается JSON с массивом UID клиентов или счетов (в зависимости от сервиса).

3.2. (Функция «PDS_Operations_Request») Получить полную выписку по счетам ПДС:

  • Передаем полные данные по ФЛ и полные данные по движениям + тек. остатки
  • Параметры входящего запроса: Коллекция «Идентификаторов Клиента» (код контрагента). Количество идентификаторов клиентов в одном запросе будет ограничено. – параметр планируется вывести в настройки обмена
  • Обмена в рамках номеров сообщений: нет
  • Ответ: передается история всех движений по запрошенным ПС в разрезе регистраторов (документов) в учете ПДС.
  • Можно вызывать как через GET, так и через POST. При вызове через POST в тело запроса передается JSON с массивом UID клиентов или счетов (в зависимости от сервиса).

4. Сервисы по ОПС:

4.1. (Функция «OPS_PS_Request») Получить данные по Договорам клиентов ОПС:

  • Параметры входящего запроса: Коллекция «Идентификаторов Клиента» (guid контрагента). Количество идентификаторов клиентов в одном запросе ограничено. – параметр планируется вывести в настройки обмена
  • Обмена в рамках номеров сообщений: нет
  • Ответ: возвращает данных по Договорам клиента в учете ОПС (ФЛ) и характеристики договора такого клиента, текущие остатки на Договоре.
  • Можно вызывать как через GET, так и через POST. При вызове через POST в тело запроса передается JSON с массивом UID клиентов или счетов (в зависимости от сервиса).

4.2. (Функция «OPS_Operations_Request») Получить полную выписку по Договорам ОПС:

  • Передаем полные данные по ФЛ и полные данные по движениям + тек. остатки
  • Параметры входящего запроса: Коллекция «Идентификаторов Договоров» (ГУИД договора). Количество идентификаторов в одном запросе будет ограничено. – параметр планируется вывести в настройки обмена
  • Обмена в рамках номеров сообщений: нет
  • Ответ: передается история всех движений по запрошенным Договорам в разрезе регистраторов (документов) в учете ОПС.
  • Можно вызывать как через GET, так и через POST. При вызове через POST в тело запроса передается JSON с массивом UID клиентов или счетов (в зависимости от сервиса).

6 Описание сервисов НПО/ПДС/ОПС

Имена сервисов в документе содержат в имени дефис, для удобства визуального восприятия. По мере завершения работы над документом дефис будет замен на символ подчёркивания.

6.1 Авторизация

Механизм авторизации в БД реализован посредством проверки логина и пароля 1С. Возможно, потребуется реализация отдельных прав для такого пользователя.

http://[host]/hs/unpfAPI/v1/test - тест доступности сервиса

6.2 Общие сервисы. (StatusExchange) Подтверждение успешного обмена (НПО/ПДС/ОПС)

Номера сообщений используются в механизмах обмена данными для контроля доставки переданной информации. Т.к. история изменений будет передаваться с момента последнего успешного номера сообщения в рамках конкретного узла обмена.

Параметры этого обмена будут скорректированы по мере необходимости или по мере реализации.

6.2.1 Описание параметров, которые следует учесть в сообщении при обмене

Для подтверждения успешного прохождения обмена требуется передать информацию:

  • ГУИД узла обмена в 1с для данной внешней системы
  • номер последнего принятого сообщения.

6.2.2 Описание запроса и ответа для подтверждения успешного принятия сообщения из сервиса

Входящие параметры:

1. ГУИД узла обмена в 1с для данной внешней системы

2. Номер сообщения (в рамках сервиса обмена)

Путь к сервису: [host]/hs/unpfAPI/v1/StatusExchange/

Описание JSON запрос:

Элемент Описание Тип данных
ИмяМетода StatusExchange:
refkey ГУИД узла обмена "refkey": "3d0e8117-cfbc-11ee-9d25-184f325a1be6" GUID
msg Номер сообщения "msg": 1 Число

Описание HTTP ответа:

Cтрока ответа HTTP, содержит следующую информацию:

  • Код ответа;
  • Тело ответа.
Код ответа Тело ответа Описание
200 Сервис отработал без ошибок.
401 Для пользователя не указаны настройки обмена Для пользователя не заданы настройки интеграции.
400 Не указан REFKEY узла обмена В переданных параметрах запроса отсутствует идентификатор узла REFKEY
400 Не указан MSG узла обмена В переданных параметрах запроса отсутствует номер пакета обмена
404 Не найден узел обмена по RefKey= По переданному параметру запроса не найден узел обмена
500 ОписаниеОшибки() Описание возникшей на сервере ошибки

6.3 Общие сервисы. (ClientsChg_Request) Обмен изменениями по Клиентам

Учет регистрации изменений ведется во всем контрагентам ФЛ с флагом «хранить данные перс. учета» и по всем ЮЛ. В рамках данного сервиса передаются персональные данные по ЮЛ/ФЛ без отбора по НПО/ПДС/ОПС и т.п.

Наличие ПС по НПО/ПДС/ОПС проверяется по Справочнику уп_ПенсионныеСчета, пдс_ПенсионныеСчета, уп_ДоговорыОПС соответственно.

6.3.1 Описание параметров, которые подлежат регистрации по ФЛ/ЮЛ и используются при обмене данными

Объекты для учета регистрации изменений и последующей передаче через сервис

Регистрация ФЛ проводится только тех, у кого стоит флаг «Хранить данные перс.учета»

1. Объекты контроля для регистрации изменений:

1.1. Справочник. Контрагенты

1.2. Справочник.ФизЛица

1.3. РС. ФИОФизическихЛиц

1.4. РС. ФизическиеЛицаДокументов

2. Извлекаемые данные из объектов контроля для передачи через сервис:

2.1. ФЛ:

2.1.1. ТипКонтрагента (1-ФЛ, 2-ЮЛ, 0 — это ошибка в базе)

2.1.2. ГУИД контрагента /guidClient

2.1.3. Дата последнего изменения персональных данных клиента, в Формате ДатаВремя

2.1.4. КодКонтрагента / npoCode /

2.1.5. Контрагент-ПометкаНаУдаление

2.1.6. СНИЛС/ snils

2.1.7. ИНН/ inn

2.1.8. ФИО:

2.1.8.1. Фамилия/ surname

2.1.8.2. Имя/ name

2.1.8.3. Отчество/ patronymic

2.1.9. ФИО при рождении / birthPersonal

2.1.9.1. Фамилия/ surname

2.1.9.2. Имя/ name

2.1.9.3. Отчество/ patronymic

2.1.10. Пол/ sex

2.1.11. ДатаРождения/ birthDate

2.1.12. МестоРождения/ birthPlace

2.1.13. ДатаСмерти/ deathDate

2.2. Сведения о наличии правопреемников:

2.2.1. Есть назначенные ПП в НПО (Проверка через заявления ЗаявлениеОНаличииПравопреемниковНПО) – Тип Булево

2.2.2. Есть назначенные ПП в ПДС(Проверка через заявления ЗаявлениеОНаличииПравопреемниковПДС) – Тип Булево

2.2.3. Есть назначенные ПП в ОПС(Проверка через заявления ЗаявлениеОНаличииПравопреемниковОПС) – Тип Булево

2.3. Контактная информация (коллекция телефонов, адресов, email):

2.3.1. Номер по порядку

2.3.2. ТипКонтактнойИнформации – см. Табл.1 «Типы и виды контактной информации ФЛ»

2.3.3. ВидКонтактнойИнформации - – см. Табл.1 «Типы и виды контактной информации ФЛ»

2.3.4. Значение (Представление)/ singleString

2.3.4.1. Структура Адреса: (заполняется только, если ТипКонтактнойИнформации= Адрес). Поля структуры адреса могут быть скорректированы.

2.3.4.2. Адрес в формате JSON.

2.3.4.3. Страна/country

2.3.4.4. Регион представление/ regionName

2.3.4.5. Город/ town

2.4. Документ, удостоверяющий личность (паспорт) – коллекция документов:

2.4.1. Код (код документа)/ code – виды кодов представлены в табл.2 «Коды документов»

2.4.2. Серия/ seria

2.4.3. Номер/ number

2.4.4. Дата (дата выдачи)/ date

2.4.5. Кем выдан/ org

2.4.6. Код кем выдан/ orgCode – только для паспорта РФ

2.5. ЮЛ:

2.5.1. ТипКонтрагента=Булево (1-ФЛ, 2-ЮЛ, 0 — это косяк в базе)

2.5.2. ГУИД контрагента / guidClient

2.5.3. Дата последнего изменения персональных данных клиента, в Формате ДатаВремя

2.5.4. КодКонтрагента /npoCode/

2.5.5. ИНН/ inn

2.5.6. КПП

2.5.7. Наименование

2.5.8. Полное наименование

2.5.9. Контрагент-ПометкаНаУдаление

2.6. Сведения о наличии ПС:

2.6.1. Есть НПО- Истина, если является участником/вкладчиком НПО, иначе Ложь

2.6.2. Есть ПДС- Истина, если является участником/вкладчиком ПДС, иначе Ложь

2.6.3. Есть ОПС - Истина, если является участником ОПС, иначе Ложь

Табл.1 «Типы и виды контактной информации ФЛ»

ТипКонтактнойИнформации ВидКонтактнойИнформации Код
Телефон Мобильный телефон
Телефон Рабочий телефон
Телефон Домашний телефон
Адрес Адрес по прописке (регистрации) AddressReg
Адрес Адрес места проживания AddressFact
Адрес Адрес за пределами РФ AddressFrgn
Адрес Адрес для информирования AddressInfo
Адрес для адресов, для которых указан произвольный вид unknown
Адрес Email

Указаны предопределенные типы и виды контактной информации, но они могут быть расширены в рамках пользовательских настроек системы.

Табл.2 «Коды документов»

Код Наименование
01 Паспорт гражданина СССР
02 Загранпаспорт гражданина СССР
03 Свидетельство о рождении
04 Удостоверение личности офицера
05 Справка об освобождении
06 Паспорт Минморфлота
07 Военный билет солдата (матроса, сержанта, старшины)
08 Временное удостоверение, выданное взамен военного билета
09 Дипломатический паспорт гражданина РФ
09 Дипломатический паспорт гражданина РФ
09 Дипломатический паспорт гражданина РФ
09 Дипломатический паспорт гражданина РФ
09 Дипломатический паспорт гражданина РФ
09 Дипломатический паспорт гражданина РФ
09 Дипломатический паспорт гражданина РФ
10 Иностранный паспорт
11 Свидетельство о регистрации ходатайства иммигранта о признании его беженцем
12 Вид на жительство
13 Удостоверение беженца
14 Временное удостоверение личности гражданина РФ
15 Разрешение на временное проживание в Российской Федерации
18 Свидетельство о предоставлении временного убежища на территории Российской Федерации
21 Паспорт гражданина РФ
22 Загранпаспорт гражданина РФ
23 Свидетельство о рождении, выданное уполномоченным органом иностранного государства
24 Удостоверение личности военнослужащего Российской Федерации
26 Паспорт моряка
27 Военный билет офицера запаса
91 Иные документы, выдаваемые органами МВД

6.3.2 Описание Запроса и ответа на Обмен изменениями по Клиентам

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/ClientsChg_Request

Описание JSON запрос:

Элемент Описание Тип данных
ИмяМетода ClientsChg_Request
Без параметров

Описание JSON ответа:

Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения

Элемент Описание Тип данных
RefKey ГУИД узла изменений GUID
Msg Номер пакета сообщения Число

Структура массива объектов «clients» - информация о контрагентах

Элемент Описание Тип данных
RefKey ГУИД контрагента GUID
Exist Признак найденного контрагента по ГУИД Boolean
client Объект с подробной информацией о контрагенте ЮЛ Объект

Структура объекта «client» для Юридических лиц

Элемент Описание Тип данных
Type Тип контрагента 2 – Юридическое лицо Число
Code Код контрагента Строка
DeletionMark Признак пометки на удаление Boolean
DateChg Дата последнего изменения персональных данных клиента ДатаВремя
Inn ИНН контрагента Строка
Kpp КПП контрагента Строка
Name Наименование контрагента Строка
FullName Полное наименование контрагента Строка

Структура объекта «client» для Физических лиц

Элемент Описание Тип данных
Type Тип контрагента 1 – Физическое лицо Число
Code Код контрагента Строка
DeletionMark Признак пометки на удаление Boolean
Inn ИНН контрагента Строка
Inn ИНН контрагента Строка
Snils СНИЛС контрагента Строка
Sex Пол контрагента: «М» - мужской, «Ж» - женский Строка[1]
BirthDate Дата рождения Дата
BirthPlace Место рождения Строка
DeathDate Дата смерти Дата
Personal ФИО контрагента Объект
BirthPersonal ФИО при рождении Строка
Snils СНИЛС контрагента Строка
Documents Документы удостоверяющие личность контрагента Массив объектов
Phones Телефоны контрагента Массив объектов
Emails Электронные адреса контрагента Массив объектов
Addresses Адреса контрагента Массив объектов
statements Участие контрагента в программах фонда Объект

Таблица. Значения статусов контрагента по пенсионным счетам НПО

Значения статуса
Выплатной период
Начисления приостановлены
Накопительный период
Подготовка к закрытию
Закрыт
Ожидание взносов
Без определенного состояния

Структура объекта «Personal»

Элемент Описание Тип данных
Surname Имя Строка
Name Фамилия Строка
Patronymic Отчество Строка

Структура объекта «Documents» - документы, удостоверяющие личность (ДУЛ) последние на дату (возможны разные виды документов, действующих на дату выгрузки)

Элемент Описание Тип данных
Code Код документа, соответствует справочнику кодов ДУЛ в табл.2 «Коды документов» Число
Seria Серия ДУЛ Строка
Number Номер ДУЛ Строка
Date Дата выдачи документа Дата
Org Орган, выдавший ДУЛ Строка
OrgCode Код подразделения Строка

Структура объекта «Phones» - телефоны контрагента

Элемент Описание Тип данных
Type Тип телефона (мобильный/домашний…) Строка
Value Номер телефона (формат: +Ц (ЦЦЦ) ЦЦЦЦЦЦЦ) Строка

Структура объекта «Emails» - электронные адреса контрагента

Элемент Описание Тип данных
Type Тип электронного адреса Строка
Value Электронный адрес Строка

Структура объекта «Addresses» - адреса контрагента

Элемент Описание Тип данных
Type Тип адреса (по прописке, регистрации….) Строка
TypeCode Код типа адреса Строка
Value Представление адреса Строка
AddressJSON Адрес по элементам Объект
Country Страна Строка
Region Регион Строка
Town Населенный пункт Строка

Таблица. Значения Кодов типов адреса

Код Описание
AddressReg Адрес регистрации
AddressFact Адрес проживания
AddressInfo Адрес для информирования
AddressFrgn Адрес за пределами РФ
unknown неопределено (для адресов, для которых указан произвольный вид)

Структура объекта «AddressJSON» - элементы адреса контрагента

(Внимание: Состав полей в структуре не является фиксированным и может отличаться в зависимости от типа адреса.)
Элемент Описание Тип данных
version Версия структуры адреса Число
value Представление адреса Строка
comment Комментарий к адресу Строка
type Тип контактной информации Строка
addressType Тип заполнения структуры адреса - Административно-территориальное деление/Муниципальное деление/Адрес в свободной форме Строка
id Уникальный идентификатор адреса Строка
country Страна Строка
countryCode Код страны Строка
ZIPcode Почтовый индекс Строка
areaCode Код региона Строка
area Наименование региона Строка
areaType Тип региона Строка
areaValue Представление региона Строка
areaCode Код региона Строка
areaId Идентификатор региона Строка
city Наименование города Строка
cityType Тип города Строка
cityId Идентификатор города Строка
district Наименование района Строка
districtType Тип района Строка
districtId Идентификатор района Строка
munDistrict Наименование муниципального района Строка
munDistrictType Тип муниципального района Строка
munDistrictId Идентификатор муниципального района Строка
cityDistrict Внутригородской район Строка
cityDistrictType Тип внутригородского района Строка
locality Наименование населенного пункта Строка
localityType Тип населенного пункта Строка
localityId Идентификатор населенного пункта Строка
territory Наименование территории Строка
territoryType Тип территории Строка
territoryId Идентификатор территории Строка
settlement Наименование поселения Строка
settlementType Тип поселения Строка
settlementId Идентификатор поселения Строка
street Наименование улицы Строка
streetType Тип улицы Строка
streetId Идентификатор улицы Строка
stead Номер земельного участка Строка
steadId Идентификатор земельного участка Строка
houseNumber Номер здания Строка
houseType Тип здания Строка
houseId Идентификатор здания Строка
buildings Массив с информацией о строениях, корпусах. Элементы массива – структура с полями «type», «number». Массив объектов
apartments Массив с информацией о квартирах, помещениях. Элементы массива – структура с полями «type», «number». Массив объектов
codeKLADR Код адреса по КЛАДР Строка
oktmoBudget ОКТМО бюджетополучателя Строка
oktmo ОКТМО адреса Строка
okato ОКАТО адреса Строка
ifnsFLCode Код ИФНС для физических лиц Строка
ifnsULCode Код ИФНС для юридических лиц Строка
ifnsFLAreaCode Код ИФНС региона для физических лиц Строка
ifnsULAreaCode Код ИФНС региона для юридических лиц Строка
munLevels Массив уровней адреса в формате «Муниципальный» Массив объектов
admLevels Массив уровней адреса в формате «Административно-территориальный») Массив объектов

Структура объекта «buildings»

Элемент Описание Тип данных
type Тип здания (строение, корпус….) Строка
number Номер здания Строка

Структура объекта «apartments»

Элемент Описание Тип данных
type Тип помещения (квартира….) Строка
number Номер помещения Строка

Структура объекта «statements»

Элемент Описание Тип данных
OPS Наличие договора/счета ОПС Boolean
NPO Наличие договора/счета НПО Boolean
PDS Наличие договора/счета ПДС Boolean

6.4 Сервисы по НПО. (NPO_PSChg_Request) Обмен изменениями по ПС и ПД (НПО)

Регистрация изменений ведется по всем ПС и ПД (НПО).

6.4.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете НПО и используются при обмене данными

Объекты для учета регистрации изменений и последующей передаче через сервис

1. Объекты контроля для регистрации изменений:

1.1. Справочник. уп_ПенсионныеДоговоры,

1.2. Справочник. уп_ПенсионныеСчета

1.3. РС. уп_СхемаСчета

1.4. РС. уп_СостоянияПС

1.5. РС. уп_ПричиныЗакрытияПС

1.6. РС. уп_РазмерПенсии

1.7. РС. уп_СостоянияДоговора

1.8. РС уп_ЛицевыеСчетаУчастников

1.9. РС уп_ПериодичностьВыплат

2. Извлекаемые данные из объектов контроля для передачи через сервис:

2.1. ПД (НПО):

2.1.1. ГИУД ПД /guidPD

2.1.2. Код ПД / number

2.1.3. ПД-ПометкаНаУдаление

2.1.4. Код Вкладчика/ KodVkl

2.1.5. Гуид Вкладчика /guidVKL

2.1.6. Состояние ПД/ status

2.1.7. Причина закрытия ПД/

2.1.8. Дата заключения ПД/ dateSign

2.1.9. Дата начала действия/ dateOpen

2.1.10. Дата закрытия ПД (в т.ч. по выполнению обязательств) / DateClose

2.1.11. Параметры из шаблона договора:

2.1.11.1. Минимальный срок выплат по договору

2.1.11.2. Максимальный срок выплат

2.1.11.3. Максимальный процент выплаты

2.1.11.4. Право на увеличенную пенсию / Boolean

2.2. ПС (НПО):

2.2.1. ГИУД ПС /guidPS

2.2.2. Код ПС / accountNumber / KodPS

2.2.3. ПС-ПометкаНаУдаление

2.2.4. Код участника/ npoCode /

2.2.5. Гуид Участника/ guidUch

2.2.6. Состояние ПС / state

2.2.7. Причина закрытия / stopReason

2.2.8. Схема/ scheme

2.2.9. ТипПС/ type /

2.2.10. Дата открытия ПС (накопит. период)/ dateNp

2.2.11. Дата закрытия ПС / DateClose

2.2.12. Пенсионные параметры (по назначенным пенсиям):

2.2.12.1. Тип пенсии – Пож, срочная, до исчерпания

2.2.12.2. Размер пенсии (периодический)

2.2.12.3. Размер первой выплаты

2.2.12.4. Размер доплаты

2.2.12.5. Периодичность выплаты = Ежемес., ежеквартально, раз в пол года, раз в год

2.2.12.6. Дата назначения пенсии (дата начала выплат) / datePension

2.2.12.7. Срок выплат (количество выплат)

2.2.12.8. Дата Решения о назначении пенсии

2.2.12.9. Дата окончания выплат- из РС. Дата окончания выплат

2.2.12.10. Максимальный срок выплат

2.2.12.11. Максимальный процент выплаты

2.2.12.12. Право на увеличенную пенсию /Boolean

2.2.13. Платежные реквизиты (срез последних, заполняется только если в РС Лицевые счета поле Участник=ПС.Участник)

2.2.13.1. Форма выплаты = банк, почта, касса

2.2.13.2. Получатель (Участник\Банк) /guidКонтрагента

2.2.13.3. Тип ЛС = карточный, лицевой

2.2.13.4. Номер ЛС

2.2.13.5. Расчетный счет

2.2.13.6. БИК Банка

2.2.13.7. Доверенное лицо = guidКонтрагента

6.4.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (НПО)

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/NPO_PSChg_Request

Описание JSON запрос:

Элемент Описание Тип данных
ИмяМетода NPO_PSChg_Request
Без параметров

Описание JSON ответа:

Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения

Элемент Описание Тип данных
RefKey ГУИД узла изменений GUID
Msg Номер пакета сообщения Число

Структура массива объектов «clients» - массив содержит информацию по всем ПС НПО контрагента

Элемент Описание Тип данных
RefKey ГУИД контрагента GUID
Exist Признак найденного контрагента по ГУИД Boolean
accounts массив ПС контрагента по НПО Массив объектов

Структура массива объектов «accounts» - массив содержит расширенную информацию по ПС НПО контрагента

Элемент Описание Тип данных
RefKey ГУИД пенсионного счета GUID
Code Код пенсионного счета НПО Строка
DeletionMark Признак пометки на удаление пенсионного счета Boolean
RefKeyUCH ГУИД контрагента-участника GUID
CodeUCH Код участника Строка
NameUCH Полное наименование участника (ФИО) Строка
TypeUCH Тип контрагента- участника (1 – Физическое лицо; 2 – Юридическое лицо) Число
State Текущее состояние пенсионного счета Строка
StopReason Причина закрытия пенсионного счета Строка
Sheme Пенсионная схема по счету Строка
DateOpen Дата открытия счета (перевод в накопительный период) Дата
DeletionMark Признак пометки на удаление пенсионного счета Дата
DateClose Дата закрытия счета Boolean
Agreement Информация о договоре НПО, по которому открыт счет Объект
Pension Информация о назначенной пенсии Объект
PaymentDetails Информация о банковских реквизитах участника Объект
Balance Массив с информацией об остатке на ПС НПО Массив объектов

Структура массива объектов «Agreement» - сведения о договоре НПО

Элемент Описание Тип данных
RefKey ГУИД договора НПО GUID
Code Код договора Строка
DeletionMark Признак пометки на удаление договора НПО Boolean
RefKeyVKL ГУИД контрагента-вкладчика по договору НПО Строка
CodeVKL Код контрагента-вкладчика по договору НПО Строка
NameVKL Наименование контрагента-вкладчика по договору НПО Строка
TypeVKL Тип вкладчика (1 – Физическое лицо; 2 – Юридическое лицо) Число
State Текущее состояние договора Строка
StopReason Причина закрытия/прекращения Строка
DateSign Дата заключения договора Дата
DateOpen Дата начала действия договора Дата
DateClose Дата прекращения договора Дата

Таблица. Значения Текущего состояние договора НПО (State)

Значение
Открыт
Действует
Приостановлен
Подготовка к закрытию
Закрыт

Таблица. Значения Причина закрытия/прекращения договора НПО (StopReason)

Значение
По смерти
Досрочное расторжение
Договор выполнен
Переход в другой НПФ
Перевод на другой счет
Закрыт по иным причинам

Структура массива «Balance»: информация о выкупных суммах

Элемент Описание Тип данных
TypeRes Тип резерва, на котором сформирован остаток строка
TypeResId Тип резерва, на котором сформирован остаток (идентификатор) Строка
TypeSum Тип суммы остатка строка
TypeSumId Тип суммы остатка (идентификатор) Строка
Sum Сумма Денежный

6.5 Сервисы по ПДС. (PDS_PSChg_Request) Обмен изменениями по ПС и ПД (ПДС)

Регистрация изменений ведется по всем ПС и ПД (ПДС).

6.5.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете ПДС и используются при обмене данными

Объекты для учета регистрации изменений и последующей передаче через сервис

1. Объекты контроля для регистрации изменений:

1.1. Справочник. пдс_ДоговорыПДС,

1.2. Справочник. пдс_ПенсионныеСчетаПДС

1.3. РС.пдс_ПараметрыДоговораПДС

1.4. РС.пдс_ПричиныЗакрытияДоговораПДС

1.5. РС. пдс_ПричиныЗакрытияПенсионныхСчетовПДС

1.6. РС. пдс_СостоянияДоговораПДС

1.7. РС. пдс_СостоянияПенсионныхСчетовПДС

1.8. РС. пдс_РазмерПенсииПДС?

1.9. РС пдс_ЛицевыеСчетаУчастников

1.10. РС пдс_ПериодичностьВыплат

2. Извлекаемые данные из объектов контроля для передачи через сервис:

2.1. ПД (ПДС):

2.1.1. ГИУД ПД /guidPD

2.1.2. Код ПД / number

2.1.3. ПД-ПометкаНаУдаление

2.1.4. Код Вкладчика/ KodVkl

2.1.5. Гуид Вкладчика /guidVKL

2.1.6. Состояние ПД/ status

2.1.7. Причина закрытия ПД/

2.1.8. Дата договора ПД/ dateSign

2.1.9. Дата заключения договора ПД/ dateSignDog

2.1.10. Дата начала действия/ dateOpen

2.1.11. Дата закрытия ПД (в т.ч. по выполнению обязательств) /

2.1.12. ВидДоговораПДС

2.1.13. ТипДоговора (Личный/В пользу третьих лиц/В пользу выгодоприобретателей)

2.1.14. ДатаПервогоДоговораПДС

2.1.15. ИнвестиционнаяСтратегияПДС

2.2. ПС (ПДС):

2.2.1. ГИУД ПС /guidPS

2.2.2. Код ПС / accountNumber / KodPS

2.2.3. ПС-ПометкаНаУдаление

2.2.4. Код участника/ npoCode

2.2.5. ГИУД участника/ guidUch

2.2.6. Состояние ПС / state

2.2.7. Причина закрытия / stopReason

2.2.8. Дата открытия ПС (накопит. период)/ dateNp

2.2.9. Дата закрытия ПС / dateStop

2.2.10. Пенсионные параметры (периодические выплаты):

2.2.10.1. Дата назначения пенсии (Дата начала = 22.01.2024) / datePension

2.2.10.2. Дата решения о назначении (01.03.2024)

2.2.10.3. Тип пенсии = Пожизненная, срочная

2.2.10.4. Размер пенсии

2.2.10.5. Периодичность выплаты

2.2.10.6. Срок выплат

2.2.10.7. Дата окончания срочных выплат (из РС)

2.2.11. Единовременные выплаты (Данные по каждому Решению ЕВ):

2.2.11.1. Дата решения

2.2.11.2. Основание – вид заявления

2.2.11.3. Сумма к выплате

2.2.12. Назначенные выкупные суммы (Данные по каждому Решению ВС):

2.2.12.1. Дата решения

2.2.12.2. Основание – вид заявления (+ тип заявления)

2.2.12.3. Тип заявления

2.2.12.4. Особые обстоятельства

2.2.12.5. Вид дорогостоящего лечения

2.2.12.6. Сумма к выплате

2.2.13. Назначенные выкупные суммы правопреемникам (Данные по каждому Решению ВС ПП):

2.2.13.1. Дата решения

2.2.13.2. Основание – вид заявления (+ тип заявления)

2.2.13.3. Сумма к выплате

2.2.14. Платежные реквизиты (срез последних, заполняется только если в РС Лицевые счета поле Участник=ПС.Участник)

2.2.14.1. Форма выплаты

2.2.14.2. Получатель (Участник\Банк) /guidКонтрагента

2.2.14.3. Тип ЛС

2.2.14.4. Номер ЛС

2.2.14.5. Расчетный счет

2.2.14.6. БИК Банка

6.5.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС)

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/PDS_PSChg_Request

Описание JSON запрос:

Элемент Описание Тип данных
ИмяМетода PDS_PSChg_Request
Без параметров

Описание JSON ответа:

Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения

Элемент Описание Тип данных
RefKey ГУИД узла изменений GUID
Msg Номер пакета сообщения Число

Структура массива «clients»: массив объектов с информацией о пенсионных счетах ПДС контрагента

Элемент Описание Тип данных
RefKey ГУИД контрагента GUID
Exist Признак нахождения контрагента по ГУИД boolean
accounts массив ПС ПДС Массив объектов

Структура массива «accounts»: массив объектов с информацией отраженной на ПС ПДС

Элемент Описание Тип данных
RefKey ГУИД пенсионного счета ПДС GUID
Code Код пенсионного счета ПДС Строка
DeletionMark Признак пометки на удаление пенсионного счета ПДС boolean
RefKeyUCH ГУИД контрагента-участника Строка
CodeUCH Код участника Строка
NameUCH Полное наименование участника (ФИО) Строка
State Текуще состояние пенсионного счета Строка
StopReason Причина закрытия пенсионного счета Строка
DateNP Дата открытия счета (перевод в накопительный период) Дата
DateClose Дата закрытия счета Дата
Pension Информация о назначенной периодической выплате Объект
agreement Информация о договоре ПДС, по которому открыт счет Объект
PaymentDetails Информация о банковских реквизитах участника Объект
OnePay Массив решений о единовременной выплате по счету Массив Объектов
FinalPay Массив решений о выкупной сумме по счету Массив Объектов
OutPay Массив решений о выплате выкупных сумм ПП по счету Массив Объектов (УП) – функционал не реализован
Balance Массив с информацией об остатке на ПС ПДС Массив Объектов

Состав объекта «Pension»: информация о назначенной периодической выплате

Элемент Описание Тип данных
DatePension Дата назначения пенсии Дата
DateDoc Дата решения о назначении Дата
Type Тип пенсии - Пожизненная, срочная Строка
Sum Размер периодической выплаты Строка
Periodicity Периодичность выплаты. Для ПДС всегда 1 Целое число
Count Количество назначенных выплат. Для пожизненной выплаты – не заполняется Целое число

Состав объекта «agreement»: информация о договоре ПДС

Элемент Описание Тип данных
RefKey ГУИД договора ПДС Строка
Code Код договора ПДС Строка
DeletionMark Признак пометки на удаление договора ПДС boolean
RefKeyVKL ГУИД контрагента-вкладчика по договору ПДС Строка
CodeVKL Код контрагента-вкладчика по договору ПДС Строка
NameVKL Наименование контрагента-вкладчика по договору ПДС Строка
TypeVKL Тип вкладчика Число
State Текущее состояние договора Строка
StopReason Причина закрытия Дата
DateSign Дата договора Дата
DateSignDog Дата заключения договора Дата
DateOpen Дата начала действия договора Дата
DateOpenFirst Дата заключения первого договора ПДС Дата
DateClose Дата прекращения договора Дата
Sheme Вид договора ПДС Строка
Type Тип договора ПДС Строка
Pattern Шаблон договора ПДС Строка

Таблица. Значения Текущего состояние договора ПДС (State)

Значение
Заключен
Действует
Выплатной период
Закрыт

Таблица. Значения Причина закрытия/прекращения договора ПДС (StopReason)

Значение
По смерти
Досрочное расторжение
Договор выполнен
Переход в другой НПФ

Состав объекта «PaymentDetails»: информация о банковских реквизитах участника по счету

Элемент Описание Тип данных
Type Форма выплаты Строка
RefKey ГУИД контрагента-получателя (участник/банк) Строка
AccountType Тип ЛС (лицевой счет/карточный счет) Строка
AccountNumber Номер ЛС Строка
BankAccount Расчетный счет Строка
BIK БИК Банка Строка

Структура массива «OnePay»: информация о единовременных выплатах

Элемент Описание Тип данных
DateDecision Дата решения о единовременной выплате Дата
RefKeyDecision ГУИД решения о единовременной выплате Строка
Decision Представление решения о единовременной выплате Строка
RefKeyStatement ГУИД документа основания принятия решения Строка
Statement Представление документа основания принятия решения Строка
ТуреDocStatement Тип документа основания принятия решения Строка
Sum Размер единовременной выплаты Денежный

Структура массива «FinalPay»: информация о выкупных суммах

Элемент Описание Тип данных
DateDecision Дата решения о выплате выкупной суммы Дата
RefKeyDecision ГУИД решения о выплате выкупной суммы Строка
Decision Представление решения о выплате выкупной суммы Строка
RefKeyStatement ГУИД документа основания для принятия решения Строка
Statement Представление документа основания для принятия решения Строка
ТуреDocStatement Вид документа основания для принятия решения Строка
ТуреStatement Тип документа основания для принятия решения (тип заявления) Строка
SpecialSituation Вид особых обстоятельств Строка
TypeTherapy Вид дорогостоящего лечения Строка
Sum Размер выплаты Денежный

Структура массива «OutPay»: информация о выкупных суммах

Элемент Описание Тип данных
DateDecision Дата решения о выплате Дата
RefKeyDecision ГУИД решения о выплате выкупной суммы ПП Строка
Decision Представление решения о выплате выкупной суммы ПП Строка
Sum Сумма выплаты по решению Денежный

Структура массива OutPay представлена в общем виде по шапке документа – предстоит доработка после обсуждения (включать/не включать расшифровку ТЧ по ПП)

Структура массива «Balance»: информация об остатках по ПС

Элемент Описание Тип данных
TypeRes Тип резерва, на котором сформирован остаток строка
TypeResId Тип резерва, на котором сформирован остаток (идентификатор) строка
TypeSum Тип суммы остатка строка
TypeSumId Тип суммы остатка (идентификатор) строка
Sum Сумма Денежный

6.6 Сервисы по ОПС. (OPS_PSChg_Request) Обмен изменениями по Договорам (ОПС)

Регистрация изменений ведется по всем Договорам (ОПС).

6.6.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными

Объекты для учета регистрации изменений и последующей передаче через сервис

1. Объекты контроля для регистрации изменений:

1.1. Справочник.уп_ДоговорыОПС,

1.2. РС.уп_СостоянияДоговораОПС

1.3. РС.уп_ПричиныЗакрытияДоговоровОПС

1.4. РС.уп_ПериодичностьВыплатОПС

1.5. РС.уп_РазмерПенсииОПС

1.6. РС.уп_ЛицевыеСчетаЗастрахованныхЛиц

2. Извлекаемые данные из объектов контроля для передачи через сервис:

2.1. Договор (ОПС):

2.1.1. ГИУД ПД /

2.1.2. Код ПД /

2.1.3. ПД -ПометкаНаУдаление

2.1.4. Код участника/

2.1.5. ГИУД участника/

2.1.6. Состояние ПД /

2.1.7. Причина закрытия ПД /

2.1.8. Дата открытия ПД (накопит. период)/

2.1.9. Дата закрытия ПД /

2.1.10. Пенсионные параметры (По НП и СВ отдельно):

2.1.10.1. Дата назначения пенсии (Дата начала = 22.01.2024) /

2.1.10.2. Дата решения о назначении (01.03.2024)

2.1.10.3. Тип пенсии = Пожизненная, срочная

2.1.10.4. Размер пенсии

2.1.10.5. Периодичность выплаты

2.1.10.6. Срок выплат

2.1.10.7. Дата окончания срочных выплат (из РС)

2.1.11. Единовременные выплаты (Данные по каждому Решению ЕВ):

2.1.11.1. Дата решения

2.1.11.2. Основание – вид заявления

2.1.11.3. Сумма к выплате

2.1.12. Переводы СПН в ПДС (Данные по каждому Решению):

2.1.12.1. Дата решения

2.1.12.2. Основание – вид заявления

2.1.12.3. Сумма

2.1.13. Назначенные выкупные суммы правопреемникам (Данные по каждому Решению ВС ПП):

2.1.13.1. Дата решения

2.1.13.2. Основание – вид заявления ()

2.1.13.3. Сумма к выплате

2.1.14. Платежные реквизиты (По НП и СВ отдельно)

2.1.14.1. Форма выплаты

2.1.14.2. Получатель (Участник\Банк) /

2.1.14.3. Тип ЛС

2.1.14.4. Номер ЛС

2.1.14.5. Расчетный счет

2.1.14.6. БИК Банка

6.6.2 Описание Запроса и ответа на Обмен изменениями по Договорам (ОПС)

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/OPS_PSChg_Request

Описание JSON запрос:

Элемент Описание Тип данных
ИмяМетода OPS_PSChg_Request
Без параметров

Описание JSON ответа:

Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения

Элемент Описание Тип данных
RefKey ГУИД узла изменений GUID
Msg Номер пакета сообщения Число

Структура массива «clients»: массив объектов с информацией о пенсионных счетах ПДС контрагента

Элемент Описание Тип данных
RefKey ГУИД контрагента GUID
Exist Признак нахождения контрагента по ГУИД boolean
accounts массив Договоров ОПС Массив объектов

Структура массива «accounts»: массив объектов с информацией, отраженной на Договоре ОПС

Элемент Описание Тип данных
RefKey ГУИД пенсионного счета GUID
Code Код Договора ОПС Строка
CodeLS Код лицевого счета Договора ОПС Строка
DeletionMark Признак пометки на удаление пенсионного счета ПДС boolean
RefKeyUCH ГУИД контрагента-участника Строка
CodeUCH Код участника Строка
NameUCH Полное наименование участника (ФИО) Строка
TypeUCH Тип участника (1- Физическое лицо) Строка
State Текущее состояние Договора ОПС Строка
StopReason Причина закрытия Договора ОПС Строка
DateSign Дата заключения Договора ОПС Дата
DateOpen Дата открытия Договора ОПС Дата
DateClose Дата закрытия Договора ОПС Дата
InsurerPrev Информация о предыдущем Фонде Объект
InsurerNext Информация о следующем Фонде Объект
PensionNP Информация о назначенной накопительной пенсии Объект
PensionSV Информация о назначенной срочной выплате Объект
PaymentDetailsNP Информация о банковских реквизитах участника для накопительной пенсии Объект
PaymentDetailsSV Информация о банковских реквизитах участника для срочной выплаты Объект
OnePay Массив решений о единовременной выплате по договору Массив Объектов
PdsPay Массив решений о переводе СПН в ПДС Массив Объектов
OutPay Массив решений о выплате выкупных сумм ПП по Договору Массив Объектов
Balance Массив с информацией об остатке на ПС ПДС Массив Объектов

Таблица. Значения Текущего состояние договора ОПС (State)

Значение
Заключен
Ожидание подтверждения ПФР
Ожидание поступления взносов
Накопительный период
Выплатной период
Приостановлен по отказу из ПФР
Подготовка к прекращению
Закрыт
Начисления приостановлены
Обязательства выполнены

Таблица. Значения Причина закрытия договора ОПС (StopReason)

Значение
По смерти
Переход в другой ПФ
Переход в другой ПФ (досрочный)
Закрыт по отказу из ПФР
Аннулирование лицензии
Единовременная выплата
Не вступил в силу
По решению суда
Договор выполнен
Объединение СНИЛС
По иным причинам

Состав объектов «InsurerPrev» и «InsurerNext»: информация о предыдущем и последующем страховщиках

Элемент Описание Тип данных
RefKey ГУИД страховщика Строка
Code Код страховщика Строка
Name Наименование страховщика Строка
INN ИНН страховщика Строка

Состав объектов «PensionNP» и «PensionSV»: информация о назначенной периодической выплате

Элемент Описание Тип данных
DatePension Дата назначения пенсии Дата
DateDecision Дата решения о назначении пенсии Дата
Sum Размер пенсии Строка
Periodicity Периодичность выплаты пенсии Строка
Count Количество назначенных выплат. Для НП – не заполняется Целое число

Состав объектов «PaymentDetailsNP» и «PaymentDetailsSV»: информация о банковских реквизитах участника по Договору

Элемент Описание Тип данных
DateDecision Дата решения о единовременной выплате Дата
RefKeyDecision ГУИД решения о единовременной выплате Строка
Decision Представление решения о единовременной выплате Строка
RefKeyStatement ГУИД документа основания принятия решения Строка
Statement Представление документа основания принятия решения Строка
ТуреDocStatement Тип документа основания принятия решения Строка
Sum Размер единовременной выплаты Денежный

Структура массива «PdsPay»: информация о переводе СПН в ПДС

Элемент Описание Тип данных
DateDecision Дата решения о переводе СПН в ПДС Дата
RefKeyDecision ГУИД решения о переводе СПН в ПДС Строка
Decision Представление решения о переводе СПН в ПДС Строка
RefKeyStatement ГУИД документа основания принятия решения Строка
Statement Представление документа основания принятия решения Строка
ТуреDocStatement Тип документа основания принятия решения Строка
Sum Размер суммы перевода Денежный

Структура массива «OutPay»: информация о выкупных суммах

Элемент Описание Тип данных
DateDecision Дата решения о выплате выкупной суммы ПП Дата
RefKeyDecision ГУИД решения о выплате выкупной суммы ПП Строка
Decision Представление решения о выплате выкупной суммы ПП Строка
RefKeyStatement ГУИД документа основания принятия решения Строка
Statement Представление документа основания принятия решения Строка
ТуреDocStatement Тип документа основания принятия решения Строка
Sum Размер суммы выплаты Денежный

Структура массива «Balance»: информация об остатках по договору

Элемент Описание Тип данных
TypeRes Тип резерва, на котором сформирован остаток Строка
TypeResId Тип резерва, на котором сформирован остаток (идентификатор) Строка
TypeSum Тип суммы остатка Строка
TypeSumId Тип суммы остатка (идентификатор) Строка
Sum Сумма Денежный

6.7 Сервисы по НПО. (NPO_OperationsChg_Request) Обмен изменениями в движениях по счету ПС и ПД (НПО)

Регистрация изменений ведется по всем ПС и ПД в разрезе документов(регистраторов) по таблице Резервы НПО и типам резерва: ИПС/СПС/ Резерв наследников ИПС/ Резерв наследников СПС.

6.7.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете НПО и используются при обмене данными

Объекты для учета регистрации изменений и последующей передаче через сервис. Данные передаются в разрезе учетных документов (регистратор), к которым привязано движение по счету.

Если документ удален/проведение отменено/помечен на удаление, то передаваться будет идентификатор документа и признак «удален».

В базе-приемник – необходимо будет удалить все движения по этому документу (по всем ПС/ПД)

1. Объекты контроля для регистрации изменений:

1.1. РН РезервыНПО

2. Извлекаемые данные из объектов контроля для передачи через сервис:

2.1. Регистратор (документ):

2.1.1. Идентификатор документа / guidDoc

2.1.2. ДокументУдален/ DeleteDoc

2.1.3. Параметры Регистратор (документ), если он проведен:

2.1.3.1. Дата документа / date

2.1.3.2. Номер документа /NumberDoc

2.1.3.3. Вид документа (как в 1с)

2.1.3.4. Представление документа (вид операции) / vidOp – описание заполнения приведено ниже

2.1.3.5. Движения:

2.1.3.5.1. Дата движения

2.1.3.5.2. ГИУД ПС /guidPS

2.1.3.5.3. Код ПС / accountNumber / KodPS

2.1.3.5.4. Вид движения (+Приход/-расход)

2.1.3.5.5. Тип резерва

2.1.3.5.6. Тип суммы/ typeSum

2.1.3.5.7. Сумма / sum

Таблица 1. Типы резервов НПО

Тип резерва (TypeResId) Представление Типа резерва (TypeRes)
СПС СПС
ИПС ИПС
ПожизненныхВыплат Пожизненных выплат
Страховой Страховой
РезервНачисленийПенсийСПС Резерв начислений пенсий СПС
РезервНачисленийПенсийИПС Резерв начислений пенсий ИПС
РезервНачисленийПенсийПожизненныхВыплат Резерв начислений пенсий пожизненных выплат
РезервНачисленийВыкупныхСуммСПС Резерв начислений выкупных сумм СПС
РезервНачисленийВыкупныхСуммИПС Резерв начислений выкупных сумм ИПС
РезервНачисленийВыкупныхСуммПожизненныхВыплат Резерв начислений выкупных сумм пожизненных выплат
РезервНаследниковИПС Резерв наследников ИПС
РезервНаследниковСПС Резерв наследников СПС
РезервНачисленийНаследниковИПС Резерв начислений наследников ИПС
РезервНачисленийНаследниковСПС Резерв начислений наследников СПС
РПАР РПАР

Таблица 2. Типы сумм НПО

Тип сумм (TypeSumId) Представление Типа сумм НПО (TypeSum)
ИДНаРезерв ИД на резерв
Резерв Резерв
ИДФиз ИД на взносы физ.лиц
ИДТр ИД на взносы третьих лиц
ИДЮр ИД на взносы юр.лиц
ВзносыФиз Взносы физ.лиц
ВзносыТр Взносы третьих лиц
ВзносыЮр Взносы юр.лиц
ВзносыЮрЛицНеоблагаемые Взносы юр.лиц необлагаемые

Табл. Значения VIDOP (строка) по документу регистратору

№ п/п Вид документа 1с (НПО) Представление для выгрузки (vidOp)
1. Для всех регистраторов Используется стандартное представление документа 1с. 
 Пример:
 Поступление взносов АРБП-000001 от 12.02.2024 21:54:56

6.7.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (НПО)

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/NPO_OperationsChg_Request

Описание JSON запрос:


Элемент Описание Тип данных
ИмяМетода NPO_OperationsChg_Request
Без параметров

Описание JSON ответа:

Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения

Элемент Описание Тип данных
RefKey ГУИД узла изменений GUID
Msg Номер пакета сообщения Число

Структура массива «accounts»: массив структур с информацией о движении по ПС НПО и остаткам на ПС НПО

Элемент Описание Тип данных
RefKey ГУИД пенсионного счета ПДС GUID
Exist Признак найденного пенсионного счета НПО по ГУИД boolean
CodePS Код пенсионного счета ПС Строка
operations Массив с информацией о движении по ПС ПДС Массив объектов

Структура массива «operations»: массив структур с информацией о движении по ПС ПДС

Элемент Описание Тип данных
RefKeyDoc ГУИД документа – регистратора движения по ПС НПО строка
DeleteDoc Значение =true, если Документ удален или отменены движения по документу 
 Иначе =false.
boolean
Если DeleteDoc= false, тогда формируется массив данных:
PresDoc Представление документа – регистратора движения по ПС НПО строка
DateDoc Дата документа – регистратора Дата
NumberDoc Номер документа – регистратора строка
TypeDoc Тип документа – регистратора строка
TypeMove Направление денежного потока (приход/расход) строка
TypeRes Тип резерва, на котором отражено движение строка
TypeResId Тип резерва, на котором отражено движение (идентификатор) строка
TypeSum Тип суммы движения строка
TypeSumId Тип суммы движения (идентификатор) строка
Sum Сумма денежный

6.8 Сервисы по ПДС. (PDS_OperationsChg_Request) Обмен изменениями в движениях по счету ПС и ПД (ПДС)

Регистрация изменений ведется по всем ПС и ПД в разрезе документов(регистраторов) по таблице Резервы ПДС и типам резерва: ИПС/ Резерв умерших ИПС.

6.8.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете ПДС и используются при обмене данными

Объекты для учета регистрации изменений и последующей передаче через сервис. Данные передаются в разрезе учетных документов (регистратор), к которым привязано движение по счету.

Если документ удален/проведение отменено/помечен на удаление, то передаваться будет идентификатор документа и признак «удален».

В базе-приемник – необходимо будет удалить все движения по этому документу (по всем ПС/ПД)

1. Объекты контроля для регистрации изменений:

1.1. РН пдс_РезервыПДС

2. Извлекаемые данные из объектов контроля для передачи через сервис:

2.1. Регистратор (документ):

2.1.1. Идентификатор документа / guidDoc

2.1.2. ДокументУдален/ DeleteDoc

2.1.3. Параметры Регистратор (документ), если он проведен:

2.1.3.1. Дата документа / date

2.1.3.2. Номер документа /NumberDoc

2.1.3.3. Вид документа (как в 1с - идентификатор)

2.1.3.4. Представление документа (вид операции) / vidOp – описание заполнения приведено ниже

2.1.3.5. Движения:

2.1.3.5.1. Дата движения

2.1.3.5.2. ГИУД ПС /guidPS

2.1.3.5.3. Код ПС / accountNumber / KodPS

2.1.3.5.4. Вид движения (+Приход/-расход) / (+1/-1)

2.1.3.5.5. Тип резерва

2.1.3.5.6. Тип суммы/ typeSum

2.1.3.5.7. Сумма / sum

Таблица 1. Типы резервов ПДС

Тип резерва (TypeResId) Представление Типа резерва (TypeRes)
ИПС ИПС
РезервСрочнойВыплаты Резерв срочной выплаты
РезервПожизненнойВыплаты Резерв пожизненной выплаты
РезервЕдиновременнойВыплаты Резерв единовременной выплаты
РезервНачисленияСрочнойВыплаты Резерв начисления срочной выплаты
РезервНачисленияПожизненнойВыплаты Резерв начисления пожизненной выплаты
РезервНачисленияЕдиновременнойВыплаты Резерв начисления единовременной выплаты
РезервНачисленияВыкупныхСумм Резерв начисления выкупных сумм
РезервНачисленияПриПереводеВДругойПФ Резерв начисления при переводе в другой ПФ
РезервНачисленияОсобыеОбстоятельства Резерв начисления особые обстоятельства
РезервУмершихИПС Резерв умерших ИПС
РезервУмершихРСВ Резерв умерших РСВ
РезервНачисленияПравопреемникамИПС Резерв начисления правопреемникам ИПС
РезервНачисленияПравопреемникамРСВ Резерв начисления правопреемникам РСВ
Страховой Страховой

Таблица 2. Типы сумм ПДС

Тип суммы (TypeSumId) Представление Типа сумм (TypeSum)
ВзносыЮЛ Взносы ЮЛ
ИДВзносыЮЛ ИД на взносы ЮЛ
Сберегательный Сберегательный взнос
Единовременный Единовременный взнос
ДополнительныйСтимулирующий Дополнительный стимулирующий взнос
СберегательныйТЛ Сберегательный взнос третьих лиц
ИДСберегательный ИД на сберегательный взнос
ИДЕдиновременный ИД на единовременный взнос
ИДДополнительныйСтимулирующий ИД на дополнительный стимулирующий взнос
ИДСберегательныйТЛ ИД на сберегательный взнос третьих лиц

Табл. Значения VIDOP (строка) по документу регистратору

№ п/п Вид документа 1с Представление для выгрузки (vidOp)
1. Для всех регистраторов Используется стандартное представление документа 1с. 
 Пример:
 Поступление взносов ПДС АРБП-000001 от 12.02.2024 21:54:56

6.8.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС)

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/PDS_OperationsChg_Request

Описание JSON запрос:

Элемент Описание Тип данных
ИмяМетода PDS_OperationsChg_Request
Без параметров

Описание JSON ответа:

Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения

Элемент Описание Тип данных
RefKey ГУИД узла изменений GUID
Msg Номер пакета сообщения Число

Структура массива «accounts»: массив структур с информацией о движении по ПС ПДС и остаткам на ПС ПДС

Элемент Описание Тип данных
RefKeyPS ГУИД пенсионного счета ПДС GUID
Exist Признак найденного пенсионного счета ПДС по ГУИД boolean
CodePS Код пенсионного счета ПС Строка
operations Массив с информацией о движении по ПС ПДС Массив объектов

Структура массива «operations»: массив структур с информацией о движении по ПС ПДС

Элемент Описание Тип данных
RefKeyDoc ГУИД документа – регистратора движения по ПС ПДС строка
DeleteDoc Значение =true, если Документ удален или отменены движения по документу 
 Иначе =false.
boolean
Если DeleteDoc= false, тогда формируется массив данных:
PresDoc Представление документа – регистратора движения по ПС ПДС строка
DateDoc Дата документа – регистратора Дата
NumberDoc Номер документа – регистратора строка
TypeDoc Тип документа – регистратора строка
TypeMove Направление денежного потока (приход/расход) строка
TypeRes Тип резерва, на котором отражено движение строка
TypeResId Тип резерва, на котором отражено движение (идентификатор) строка
TypeSum Тип суммы движения строка
TypeSumId Тип суммы движения (идентификатор) строка
Sum Сумма денежный

6.9 Сервисы по ОПС. (OPS_OperationsChg_Request) Обмен изменениями в движениях по Договору (ОПС)

Регистрация изменений ведется по всем Договорам в разрезе документов(регистраторов) по таблице Резервы ОПС и типам резерва: все, кроме «Резерв ОПС».

6.9.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными

Объекты для учета регистрации изменений и последующей передаче через сервис. Данные передаются в разрезе учетных документов (регистратор), к которым привязано движение по счету.

Если документ удален/проведение отменено/помечен на удаление, то передаваться будет идентификатор документа и признак «удален».

В базе-приемник – необходимо будет удалить все движения по этому документу (по всем Договорам)

3. Объекты контроля для регистрации изменений:

3.1. РН уп_РезервыОПС

4. Извлекаемые данные из объектов контроля для передачи через сервис:

4.1. Регистратор (документ):

4.1.1. Идентификатор документа / guidDoc

4.1.2. ДокументУдален/ DeleteDoc

4.1.3. Параметры Регистратор (документ), если он проведен:

4.1.3.1. Дата документа / date

4.1.3.2. Номер документа /NumberDoc

4.1.3.3. Вид документа (как в 1с - идентификатор)

4.1.3.4. Движения:

4.1.3.4.1. Дата движения

4.1.3.4.2. ГИУД ПС /guidPS

4.1.3.4.3. Код ПС / accountNumber / KodPS

4.1.3.4.4. Вид движения (+Приход/-расход) / (+1/-1)

4.1.3.4.5. Тип резерва

4.1.3.4.6. Тип суммы/ typeSum

4.1.3.4.7. Сумма / sum

Таблица 1. Типы резервов ОПС

Тип резерва (TypeResId) Представление Типа резерва (TypeRes)
РезервПенсионныйНакоплений РПН
РезервСрочнойВыплаты РСВ
Выплатной Выплатной
РезервЕВ Резерв единовременной выплаты
РезервНачисленийНП Резерв начислений НП
РезервНачисленийСВ Резерв начислений СВ
РезервНачисленийЕВ Резерв начислений ЕВ
РезервНаследниковРПН Резерв умерших РПН
РезервНаследниковРСВ Резерв умерших РСВ
РезервНачисленийРасторжение Резерв начислений расторжение
РезервНачисленийНаследованиеРПН Резерв начислений наследование РПН
РезервНачисленийНаследованиеРСВ Резерв начислений наследование РСВ
РезервНачисленийНаследованиеРОПС Резерв начислений наследование РОПС
РезервНачисленийВозвратМСКРПН Резерв начислений возврат МСК РПН
РезервНачисленийВозвратМСКРСВ Резерв начислений возврат МСК РСВ
РезервНачисленийРазделениеСНИЛС Резерв начислений разделение СНИЛС

Таблица 2. Типы сумм ОПС

Тип суммы (TypeSumId) Представление Типа сумм (TypeSum)
ВзносыФиз Страховые взносы
ВзносыЮр Взносы работодателя
ГосПоддержка Взносы софинансирование
ДопВзносы Доп. страховые взносы
МатКапитал Материнский капитал
ИДФиз ИД на страховые взносы
ИДЮр ИД на взносы работодателя
ИДГосПоддержка ИД на софинансирование
ИДДопВзносы ИД на доп. страх. взносы
ИДМатКапитал ИД на материнский капитал

6.9.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС)

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/OPS_OperationsChg_Request

Описание JSON запрос:

Элемент Описание Тип данных
ИмяМетода OPS_OperationsChg_Request
Без параметров

Описание JSON ответа:

Структура ответа содержит объекты «package» и «documents».

Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения

Элемент Описание Тип данных
RefKey ГУИД узла изменений GUID
Msg Номер пакета сообщения Число

Структура массива «documents»: массив структур с информацией о документах

Элемент Описание Тип данных
RefKeyDoc ГУИД документа – регистратора строка
DeletionMark Значение =true, если Документ удален или отменены движения по документу 
 Иначе =false.
boolean
Если DeleteDoc= false, тогда формируется массив данных:
PresDoc Представление документа – регистратора строка
DateDoc Дата документа – регистратора Дата
NumberDoc Номер документа – регистратора строка
TypeDoc Тип документа – регистратора строка
Оperations Движения документа - регистратора Объект

Структура объекта «operations»: массив структур с информацией о движении по Договорам ОПС

Элемент Описание Тип данных
RefKeyPS ГУИД Договора ОПС GUID
CodePS Код Договора ОПС Строка
TypeMove Направление денежного потока (приход/расход) строка
TypeRes Тип резерва, на котором отражено движение строка
TypeResId Тип резерва, на котором отражено движение (идентификатор) строка
TypeSum Тип суммы движения строка
TypeSumId Тип суммы движения (идентификатор) строка
Sum Сумма денежный

6.10 Общие сервисы. (ClientsID_Request) Получение полного списка идентификаторов клиентов (без персональных данных)

Обмен без учета регистрации изменений.

В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.

В рамках сервиса не предусмотрены входящих параметры для отбора.

Сервис возвращает только идентификаторы (guid) по Контрагентам (ЮЛ/ФЛ), в т.ч. предусмотрен признак о наличии ПС в учете НПО/ПДС/ОПС. Далее по идентификатору (guid) можно у нижеописанных сервисов запросить информацию о ПС, остатке на ПС, Выписку по счету.

У контрагента может не быть ПС в учете НПО/ОПС/ПДС – например, если будут передаваться сведения (ссылки) на наследников. Загружать таких контрагентов во внеш.систему или нет остается на выбор разработчика принимающей стороны.

Выборка производится по справочнику Контрагенты, наличие ПС по НПО/ПДС/ОПС проверяется по Справочнику уп_ПенсионныеСчета, пдс_ПенсионныеСчета, уп_ДоговорыОПС соответственно.

6.10.1 Описание объектов и параметров, которые используются при обмене данными

1. Объекты-источники:

1.1. Справочник. Контрагенты (без пометки на удаление)

1.2. Справочник. уп_ПенсионныеСчета

1.3. Справочник. пдс_ПенсионныеСчетаПДС

1.4. Справочник. уп_ДоговорыОПС

2. Извлекаемые данные для передачи через сервис:

Идентификаторы контрагентов (guid) и признак о наличии ПС в учете НПО/ПДС/ОПС

2.1. Гуид контрагента /guidClient

2.2. Код контрагента

2.3. Дата последнего изменения персональных данных клиента, в Формате ДатаВремя

2.4. Признак пометки на удаление: истина, если помечен на удаление; ложь, если не помечен на удаление

2.5. ТипКонтрагента=Булево (1-ФЛ, 2-ЮЛ)

2.6. Представление контрагента (Наименование/ФИО)

2.7. СНИЛС, заполняется только для ФЛ (ТипКонтрагента = 1)

2.8. Участие в программах Фонда (наличие договора или счета)

2.8.1. Есть НПО- Истина, если является участником/вкладчиком НПО, иначе Ложь

2.8.2. Есть ПДС- Истина, если является участником/вкладчиком ПДС, иначе Ложь

2.8.3. Есть ОПС - Истина, если является участником ОПС, иначе Ложь

6.10.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/ClientsID_Request

Описание JSON запрос:

Элемент Описание Тип данных
ИмяМетода ClientsID_Request
Без параметров

Описание JSON ответа:

Структура массива «clients»: массив объектов с идентификаторами клиентов

Элемент Описание Тип данных
RefKey ГУИД контрагента GUID
Name Представление контрагента (Наименование/ФИО) Строка
DateChg Дата последнего изменения персональных данных клиента ДатаВремя
DeletionMark Признак пометки на удаление Boolean
Code Код контрагента Строка
Type ТипКонтрагента (1 – Физическое лицо\2 – Юридическое лицо) Число
Snils СНИЛС контрагента - физического лица Строка
accounts Содержит признаки участия контрагента в деятельности фонда Объект

Структура объекта «accounts» - признаки участия контрагента в деятельности фонда

Элемент Описание Тип данных
OPS Признак участия в ОПС Boolean
NPO Признак участия в НПО (Вкладчик/Участник) Boolean
PDS Признак участия в ПДС Boolean

6.11 Общие сервисы. (ClientsInfo_Request) Получение информации по клиентам ЮЛ/ФЛ (персональные данные)

Обмен без учета регистрации изменений.

В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.

В рамках сервиса в качестве входящих параметров передаются идентификаторы клиентов ФЛ/ЮЛ (guid контрагента), по которым сервис возвращает персональную информацию о клиенте (контрагенте). В рамках сервиса предусмотрен признак о наличии ПС в учете НПО/ПДС/ОПС (в рамках информационной системы).

Выборка производится по справочнику Контрагенты

В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 100 000 (для post запроса доступно не более 100 000, для get запроса максимум= 40).

В результате сервис по каждому запрошенному идентификатору клиента передает информацию только о самом клиенте/контрагенте (передача информации по пенсионным счетам и договорам предусмотрена в отдельных нижеописанных сервисах)

При вызове через POST запрос в тело запроса передается JSON с массивом UID клиентов.

Пример структуры JSON:

{ 

   "uids": [
       "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
       "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
       "87e21fff-cb82-11e3-be9d-74d02bc3313d"
   ]

}

6.11.1 Описание объектов и параметров, которые используются при обмене данными

Входящий параметр (коллекция):

1. ГУИД контрагента /guidClient

По полученному списку ГУИД контрагента (guidClient) производится отбор данных по справочнику Контрагенты и формируется ответ.

Наличие ПС по НПО/ПДС/ОПС проверяется по Справочнику уп_ПенсионныеСчета, пдс_ПенсионныеСчета, уп_ДоговорыОПС соответственно.

1. Объекты-источники:

1.1. Справочник. Контрагенты

1.2. Справочник.ФизЛица

1.3. РС. ФИОФизическихЛиц

1.4. РС. ФизическиеЛицаДокументов

1.5. Справочник. уп_ПенсионныеСчета

1.6. Справочник. пдс_ПенсионныеСчетаПДС

1.7. Справочник. уп_ДоговорыОПС

2. Информация, которая передается в качестве результата:

2.1. Клиент (Контрагент) /guidClient

2.2. FindClientID - Признак КлинтНайден по гуид - булево

(FindClientID) - Если клиент по гуид не обнаружен, то FindClientID =False

Если клиент по гуид обнаружен, то FindClientID =TRUE и возвращается набор параметров:

2.3. Параметры для ФЛ:

2.3.1. ТипКонтрагента=Булево (1-ФЛ, 2-ЮЛ, 0 — это ошибка в базе)

2.3.2. ГУИД контрагента /guidClient

2.3.3. Дата последнего изменения персональных данных клиента, в Формате ДатаВремя

2.3.4. КодКонтрагента / npoCode / IDClient

2.3.5. Контрагент-ПометкаНаУдаление

2.3.6. СНИЛС/ snils

2.3.7. ИНН/ inn

2.3.8. ФИО:

1.1.1.1.1. Фамилия/ surname

1.1.1.1.2. Имя/ name

1.1.1.1.3. Отчество/ patronymic

2.3.9. ФИО при рождении / birthPersonal

1.1.1.1.4. Фамилия/ surname

1.1.1.1.5. Имя/ name

1.1.1.1.6. Отчество/ patronymic

2.3.10. Пол/ sex

2.3.11. ДатаРождения/ birthDate

2.3.12. МестоРождения/ birthPlace

2.3.13. ДатаСмерти/ deathDate

2.3.14. Контактная информация (коллекция телефонов, адресов, email):

2.3.15. Номер по порядку

2.3.16. ТипКонтактнойИнформации – см. Табл.1 «Типы и виды контактной информации ФЛ»

2.3.17. ВидКонтактнойИнформации - – см. Табл.1 «Типы и виды контактной информации ФЛ»

2.3.18. Значение (Представление)/ singleString

2.3.19. Структура Адреса:

2.3.19.1. (заполняется только, если ТипКонтактнойИнформации= Адрес). Поля структуры адреса могут быть скорректированы.

2.3.19.2. Адрес в формате JSON.

2.3.19.3. Страна/country

2.3.19.4. Регион представление/ regionName

2.3.19.5. Город/ town

2.3.20. Документ, удостоверяющий личность (паспорт) – коллекция документов:

2.3.20.1. Код (код документа)/ code – виды кодов представлены в табл.2 «Коды документов»

2.3.20.2. Серия/ seria

2.3.20.3. Номер/ number

2.3.20.4. Дата (дата выдачи)/ date

2.3.20.5. Кем выдан/ org

2.3.20.6. Код кем выдан/ orgCode – только для паспорта РФ

2.3.21. Сведения о наличии правопреемников:

2.3.21.1. Есть назначенные ПП в НПО (Проверка через заявления ЗаявлениеОНаличииПравопреемниковНПО) – Тип Булево

2.3.21.2. Есть назначенные ПП в ПДС(Проверка через заявления ЗаявлениеОНаличииПравопреемниковПДС) – Тип Булево

2.3.21.3. Есть назначенные ПП в ОПС(Проверка через заявления ЗаявлениеОНаличииПравопреемниковОПС) – Тип Булево

2.4. Параметры для ЮЛ:

2.4.1. ТипКонтрагента=Булево (1-ФЛ, 2-ЮЛ, 0 — это косяк в базе)

2.4.2. ГУИД контрагента / guidClient

2.4.3. КодКонтрагента /npoCode/ IDClient

2.4.4. Дата последнего изменения персональных данных клиента, в Формате ДатаВремя

2.4.5. ИНН/ inn

2.4.6. КПП

2.4.7. Наименование

2.4.8. Полное наименование

2.4.9. Контрагент-ПометкаНаУдаление

2.5. Информация о Наличии ПС в НПО/ПДС/ОПС:

2.5.1. Есть НПО- Истина, если является участником/вкладчиком НПО, иначе Ложь

2.5.2. Есть ПДС- Истина, если является участником/вкладчиком ПДС, иначе Ложь

2.5.3. Есть ОПС - Истина, если является участником ОПС, иначе Ложь

6.11.2 Описание полей запроса и ответа для получения информации по клиентам

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/ClientsInfo_Request

Описание GET или POST запрос:

Элемент Описание Тип данных
ИмяМетода clientsInfo_request
uid GUID контрагентов с разделителем «,» (запятая) Текст

Описание JSON ответа:

Структура массива объектов «clients» - информация о контрагентах

Элемент Описание Тип данных
RefKey ГУИД контрагента GUID
Exist Признак найденного контрагента по ГУИД Boolean
client Объект с подробной информацией о контрагенте ЮЛ Объект

Структура объекта «client» для Юридических лиц

Элемент Описание Тип данных
Type Тип контрагента 
 2 – Юридическое лицо
Число
Code Код контрагента Строка
DeletionMark Признак пометки на удаление Boolean
DateChg Дата последнего изменения персональных данных клиента ДатаВремя
Inn ИНН контрагента Строка
Kpp КПП контрагента Строка
Name Наименование контрагента Строка
FullName Полное наименование контрагента Строка

Структура объекта «client» для Физических лиц

Элемент Описание Тип данных
Type Тип контрагента 
 1 – Физическое лицо
Число
Code Код контрагента Строка
DeletionMark Признак пометки на удаление Boolean
DateChg Дата последнего изменения персональных данных клиента ДатаВремя
Inn ИНН контрагента Строка
Snils СНИЛС контрагента Строка
Sex Пол контрагента 
 «М» - мужской
 «Ж» - женский
Строка[1]
BirthDate Дата рождения Дата
BirthDate Дата рождения Дата
BirthPlace Место рождения Строка
DeathDate Дата смерти Дата
Personal ФИО контрагента Объект
BirthPersonal ФИО при рождении Строка
NPO_ObligationsFulfilled Признак полного исполнения обязательств перед контрагентом. 
 - True: обязательства исполнены полностью;
 - False: обязательства полностью не исполнены
Boolean
NPO_ClientStatus Статус контрагента, определенного по состояниям пенсионных счетов НПО Строка
Documents Документы, удостоверяющие личность контрагента Массив объектов
Phones Телефоны контрагента Массив объектов
Emails Электронные адреса контрагента Массив объектов
Addresses Адреса контрагента Массив объектов
statements Участие контрагента в программах фонда Объект

Таблица. Значения статусов контрагента по пенсионным счетам НПО

Значения статуса
Выплатной период
Начисления приостановлены
Накопительный период
Подготовка к закрытию
Закрыт
Ожидание взносов
Без определенного состояния

Структура объекта «Personal»

Элемент Описание Тип данных
Surname Имя Строка
Name Фамилия Строка
Patronymic Отчество Строка

Структура объекта «Documents» - документы, удостоверяющие личность (ДУЛ) последние на дату (возможны разные виды документов, действующих на дату выгрузки)

Элемент Описание Тип данных
Code Код документа, соответствует справочнику кодов ДУЛ в табл.2 «Коды документов» Число
Seria Серия ДУЛ Строка
Number Номер ДУЛ Строка
Date Дата выдачи документа Дата
Org Орган, выдавший ДУЛ Строка
OrgCode Код подразделения Строка
ND_PAS Дата недействительности паспорта Дата
DNEDVZN Дата выявления недействительного паспорта при обработке взносов Дата

Структура объекта «Phones» - телефоны контрагента

Элемент Описание Тип данных
Type Тип телефона (мобильный/домашний…) Строка
Value Номер телефона (формат: +Ц (ЦЦЦ) ЦЦЦЦЦЦЦ) Строка

Структура объекта «Emails» - электронные адреса контрагента

Элемент Описание Тип данных
Type Тип электронного адреса Строка
Value Электронный адрес Строка

Структура объекта «Addresses» - адреса контрагента

Элемент Описание Тип данных
Type Тип адреса (по прописке, регистрации….) Строка
TypeCode Код типа адреса Строка
Value Представление адреса Строка
AddressJSON Адрес по элементам Объект
Country Страна Строка
Region Регион Строка
Town Населенный пункт Строка

Таблица. Значения Кодов типов адреса

Код Описание
AddressReg Адрес регистрации
AddressFact Адрес проживания
AddressInfo Адрес для информирования
AddressFrgn Адрес за пределами РФ
unknown неопределено (для адресов, для которых указан произвольный вид)

Структура объекта «AddressJSON» - элементы адреса контрагента

(Внимание: Состав полей в структуре не является фиксированным и может отличаться в зависимости от типа адреса.)

Элемент Описание Тип данных
version Версия структуры адреса Число
value Представление адреса Строка
comment Комментарий к адресу Строка
type Тип контактной информации Строка
addressType Тип заполнения структуры адреса 
 - Административно-территориальное деление
 - Муниципальное деление
 - Адрес в свободной форме
Строка
id Уникальный идентификатор адреса Строка
country Страна Строка
countryCode Код страны Строка
ZIPcode Почтовый индекс Строка
areaCode Код региона Строка
area Наименование региона Строка
areaType Тип региона Строка
areaValue Представление региона Строка
areaCode Код региона Строка
areaId Идентификатор региона Строка
city Наименование города Строка
cityType Тип города Строка
cityId Идентификатор города Строка
areaId Идентификатор региона Строка
district Наименование района Строка
districtType Тип района Строка
districtId Идентификатор района Строка
munDistrict Наименование муниципального района Строка
munDistrictType Тип муниципального района Строка
munDistrictId Идентификатор муниципального района Строка
cityDistrict Внутригородской район Строка
cityDistrictType Тип внутригородского района Строка
locality Наименование населенного пункта Строка
localityType Тип населенного пункта Строка
localityId Идентификатор населенного пункта Строка
territory Наименование территории Строка
territoryType Тип территории Строка
territoryId Идентификатор территории Строка
settlement Наименование поселения Строка
settlementType Тип поселения Строка
settlementId Идентификатор поселения Строка
street Наименование улицы Строка
streetType Тип улицы Строка
streetId Идентификатор улицы Строка
stead Номер земельного участка Строка
steadId Идентификатор земельного участка Строка
houseNumber Номер здания Строка
houseType Тип здания Строка
houseId Идентификатор здания Строка
buildings Массив с информацией о строениях, корпусах. Элементы массива – структура с полями «type», «number» Массив объектов
apartments Массив с информацией о квартирах, помещениях. Элементы массива – структура с полями «type», «number» Массив объектов
codeKLADR Код адреса по КЛАДР Строка
oktmoBudget ОКТМО бюджетополучателя Строка
oktmo ОКТМО адреса Строка
okato ОКАТО адреса Строка
ifnsFLCode Код ИФНС для физических лиц Строка
ifnsFLAreaCode Код ИФНС региона для физических лиц Строка
ifnsULAreaCode Код ИФНС региона для юридических лиц Строка
munLevels Массив уровней адреса в формате «Муниципальный» Массив объектов
admLevels Массив уровней адреса в формате «Административно-территориальный» Массив объектов

Структура объекта «buildings»

Элемент Описание Тип данных
type Тип здания (строение, корпус….) Строка
number Номер здания Строка

Структура объекта «apartments»

Элемент Описание Тип данных
type Тип помещения (квартира…) Строка
number Номер помещения Строка

Структура объекта «statements»

Элемент Описание Тип данных
OPS Наличие договора/счета ОПС Boolean
NPO Наличие договора/счета НПО Boolean
PDS Наличие договора/счета ПДС Boolean

6.12 Сервисы по НПО. (NPO_PS_Request) Получить данные по ПС клиентов НПО

Обмен без учета регистрации изменений.

В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.

В рамках сервиса в качестве входящих параметров передаются идентификаторы клиентов (ФЛ/ЮЛ) у кого есть признак «Есть НПО», по которым сервис вернет информацию о его ПС.

В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 100 000. (для post запроса доступно не более 100 000, для get запроса максимум= 40).

В результате сервис по каждому запрошенному идентификатору клиента возвращает информацию о его ПС с параметрами договора НПО, а также о текущем остатке на каждом на ПС. Передача персональных данных ко клиенту не предусмотрена.

При вызове через POST запрос в тело запроса передается JSON с массивом UID клиентов.

Пример структуры JSON:

{ 

   " uids": [
       "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
       "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
       "87e21fff-cb82-11e3-be9d-74d02bc3313d"
   ]

}

6.12.1 Описание объектов и параметров, которые используются при обмене данными

Входящий параметр (коллекция):

1. ГУИД контрагента /guidClient

По полученному списку ГУИД контрагента (guidClient) производится отбор ПС НПО. Выборка производится по справочнику пенсионные счета НПО по полю участник и формируется ответ. Если будет передан guidClient, который не имеет ПС или договор, то сервис не вернет по такому клиенту информацию. Персональная информация по Контрагенту (Вкладчику/участнику) не передается (кроме представления контрагента – для визуального контроля/тестирования)

Данные по остаткам на ПС собираются по каждому ПС из РН Резервы НПО с отбором по типам резервов: ИПС/СПС/ Резерв наследников ИПС/ Резерв наследников СПС.

1. Объекты-источники:

1.1. Справочник. Контрагенты,

1.2. Справочник. уп_ПенсионныеДоговоры,

1.3. Справочник. уп_ПенсионныеСчета

1.4. РС. уп_СхемаСчета

1.5. РС. уп_СостоянияПС

1.6. РС. уп_ПричиныЗакрытияПС

1.7. РС. уп_РазмерПенсии

1.8. РС. уп_СостоянияДоговора

1.9. РС уп_ЛицевыеСчетаУчастников

1.10. РС уп_ПериодичностьВыплат

1.11. РН Резервы НПО

2. Информация, которая передается в качестве результата:

2.1. Клиент /guidClient

2.2. FindClientID - Признак КлинтНайден по гуид - булево

(FindClientID) - Если клиент по гуид не обнаружен, то FindClientID =False

Если клиент по гуид обнаружен, то FindClientID =TRUE и возвращается набор параметров:

2.3. Информация о ПД:

2.3.1. ГИУД ПД /guidPD

2.3.2. Код ПД / number

2.3.3. ПометкаНаУдаление

2.3.4. Код Вкладчика/

2.3.5. Гуид Вкладчика / guidVkl (может совпадать с guidClient)

2.3.6. Представление Вкладчика (Контрагент.Наименование)

2.3.7. ВкладчикЮЛ/ФЛ (ТипКонтрагента) =Булево (1-ФЛ, 2-ЮЛ, 0 — это косяк в базе)

2.3.8. Параметры договора:

2.3.8.1. Состояние ПД/ status

2.3.8.2. Причина закрытия ПД/

2.3.8.3. Дата заключения ПД/ dateSign

2.3.8.4. Дата начала действия/ dateOpen

2.3.8.5. Дата закрытия ПД (в т.ч. по выполнению обязательств) /

2.3.9. Параметры из шаблона договора:

2.3.9.1. Минимальный срок выплат по договору

2.3.9.2. Максимальный срок выплат

2.3.9.3. Максимальный процент выплаты

2.3.9.4. Право на увеличенную пенсию / Boolean

2.3.10. Информация о ПС:

2.3.10.1. ГИУД ПС /guidPS

2.3.10.2. Код ПС / accountNumber / KodPS

2.3.10.3. ПометкаНаУдаление

2.3.10.4. Код участника/ npoCode

2.3.10.5. Гуид Участника /guidClient

2.3.10.6. Представление Участника (Контрагент.Наименование)

2.3.10.7. Состояние ПС / state

2.3.10.8. Причина закрытия / stopReason

2.3.10.9. Схема/ scheme

2.3.10.10. ТипПС/ type /

2.3.10.11. Дата открытия ПС (накопит. период)/ dateNp

2.3.10.12. Дата закрытия ПС / DateClose

2.3.11. Пенсионные параметры (по назначенным пенсиям):

2.3.11.1. Тип пенсии - Пож, срочная, до исчерпания

2.3.11.2. Размер пенсии

2.3.11.3. Периодичность выплаты

2.3.11.4. Дата назначения пенсии (дата начала выплат) / datePension

2.3.11.5. Срок выплат (количество выплат)

2.3.11.6. Дата Решения о назначении пенсии

2.3.11.7. Дата окончания выплат- из РС. Дата окончания выплат

2.3.11.8. Максимальный срок выплат

2.3.11.9. Максимальный процент выплаты

2.3.11.10. Право на увеличенную пенсию / Boolean

2.3.12. Платежные реквизиты (срез последних, заполняется только если в РС Лицевые счета поле Участник=ПС.Участник)

2.3.12.1. Форма выплаты

2.3.12.2. Получатель (Участник\Банк) /guidКонтрагента

2.3.12.3. Тип ЛС

2.3.12.4. Номер ЛС

2.3.12.5. Расчетный счет

2.3.12.6. БИК Банка

2.3.13. Текущий остаток на ПС

2.3.13.1. Тип резерва

2.3.13.2. Тип суммы/ typeSum

2.3.13.3. Сумма / sum

6.12.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам НПО

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/NPO_PS_Request

Описание GET или POST запрос:

Элемент Описание Тип данных
ИмяМетода npo_ps_request
uid GUID контрагентов с разделителем «,» (запятая) Текст

Описание JSON ответа:

Структура массива объектов «clients» - массив содержит информацию по всем ПС НПО контрагента

Элемент Описание Тип данных
RefKey ГУИД контрагента GUID
Exist Признак найденного контрагента по ГУИД boolean
accounts массив ПС контрагента по НПО Массив объектов

Структура массива объектов «accounts» - массив содержит расширенную информацию по ПС НПО контрагента

Элемент Описание Тип данных
RefKey ГУИД пенсионного счета GUID
Code Код пенсионного счета НПО Строка
DeletionMark Признак пометки на удаление пенсионного счета Boolean
RefKeyUCH ГУИД контрагента-участника GUID
CodeUCH Код участника Строка
NameUCH Полное наименование участника (ФИО) Строка
TypeUCH Тип контрагента- участника 
 1 – Физическое лицо
 2 – Юридическое лицо
Число
State Текущее состояние пенсионного счета Строка
StopReason Причина закрытия пенсионного счета Строка
Sheme Пенсионная схема по счету Строка
DateOpen Дата открытия счета (перевод в накопительный период) Дата
DateClose Дата закрытия счета Дата
Agreement Информация о договоре НПО, по которому открыт счет Объект
Pension Информация о назначенной пенсии Объект
PaymentDetails Информация о банковских реквизитах участника Объект
Balance Массив с информацией об остатке на ПС НПО Массив объектов

Структура массива объектов «Agreement» - сведения о договоре НПО

Элемент Описание Тип данных
RefKey ГУИД договора НПО GUID
Code Код договора Строка
DeletionMark Признак пометки на удаление договора НПО Boolean
RefKeyVKL ГУИД контрагента-вкладчика по договору НПО GUID
CodeVKL Код контрагента-вкладчика по договору НПО Строка
NameVKL Наименование контрагента-вкладчика по договору НПО Строка
TypeVKL Тип вкладчика 
 1 – Физическое лицо
 2 – Юридическое лицо
Число
State Текущее состояние договора Строка
StopReason Причина закрытия/прекращения Строка
DateSign Дата заключения договора Дата
DateOpen Дата начала действия договора Дата
DateClose Дата прекращения договора Дата

Таблица. Значения Текущего состояние договора НПО (State)

Значение
Открыт
Действует
Приостановлен
Подготовка к закрытию
Закрыт

Таблица. Значения Причина закрытия/прекращения договора НПО (StopReason)

Значение
По смерти
Досрочное расторжение
Договор выполнен
Переход в другой НПФ
Перевод на другой счет
Закрыт по иным причинам

6.13 Сервисы по ПДС. (PDS_PS_Request) Получить данные по ПС клиентов ПДС

Обмен без учета регистрации изменений.

В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.

В рамках сервиса в качестве входящих параметров передаются идентификаторы клиентов (ФЛ/ЮЛ) есть признак «Есть ПДС», по которым сервис вернет информацию о его ПС.

В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 100 000. (для post запроса доступно не более 100 000, для get запроса максимум= 40).

В результате сервис по каждому запрошенному идентификатору клиента возвращает информацию о его ПС с параметрами договора ПДС, а также о текущем остатке на ПС. Передача персональных данных ко клиенту не предусмотрена.

При вызове через POST запрос в тело запроса передается JSON с массивом UID клиентов.

Пример структуры JSON:

{ 

   " uids": [
       "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
       "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
       "87e21fff-cb82-11e3-be9d-74d02bc3313d"
   ]

}

6.13.1 Описание объектов и параметров, которые используются при обмене данными

Входящий параметр (коллекция):

1. ГУИД контрагента /guidClient

По полученному списку ГУИД контрагента (guidClient) производится отбор ПС. Выборка производится по справочнику пенсионные счета ПДС по полю участник и формируется ответ. Если будет передан guidClient, который не имеет ПС или договор, то сервис не вернет по такому клиенту информацию. Персональная информация по Контрагенту (Вкладчику/участнику) не передается (кроме представления контрагента – для визуального контроля/тестирования)

Данные по остаткам на ПС собираются по каждому ПС из РН Резервы ПДС с отбором по типам резервов: ИПС/ Резерв умерших ИПС

1. Объекты-источники:

1.1. Справочник. Контрагенты,

1.2. Справочник. пдс_ДоговорыПДС,

1.3. Справочник. пдс_ПенсионныеСчетаПДС

1.4. РС.пдс_ПараметрыДоговораПДС

1.5. РС.пдс_ПричиныЗакрытияДоговораПДС

1.6. РС. пдс_ПричиныЗакрытияПенсионныхСчетовПДС

1.7. РС. пдс_СостоянияДоговораПДС

1.8. РС. пдс_СостоянияПенсионныхСчетовПДС

1.9. РС. пдс_РазмерПенсииПДС

1.10. РС пдс_ЛицевыеСчетаУчастников

1.11. РС пдс_ПериодичностьВыплат

1.12. РН Резервы ПДС

2. Информация, которая передается в качестве результата:

2.1. Клиент /guidClient

2.2. FindClientID - Признак КлинтНайден по гуид - булево

(FindClientID) - Если клиент по гуид не обнаружен, то FindClientID =False

Если клиент по гуид обнаружен, то FindClientID =TRUE и возвращается набор параметров:

2.3. Если ПС по ПДС найдены, то передается информация:

2.3.1. Информация о ПД (ПДС):

2.3.1.1. ГИУД ПД /guidPD

2.3.1.2. Код ПД / number

2.3.1.3. ПД-ПометкаНаУдаление

2.3.1.4. Код Вкладчика/ KodVkl

2.3.1.5. Гуид Вкладчика /guidVKL

2.3.1.6. Представление Вкладчика (Контрагент.Наименование)

2.3.1.7. ВкладчикЮЛ/ФЛ (ТипКонтрагента) =Булево (1-ФЛ, 2-ЮЛ, 0 — это косяк в базе)

2.3.1.8. Параметры договора:

2.3.1.8.1. Состояние ПД/ status

2.3.1.8.2. Причина закрытия ПД/

2.3.1.8.3. Дата договора ПД/ dateSign

2.3.1.8.4. Дата заключения договора ПД/ dateSignDog

2.3.1.8.5. Дата начала действия/ dateOpen

2.3.1.8.6. Дата закрытия ПД (в т.ч. по выполнению обязательств) /

2.3.1.8.7. ВидДоговораПДС

2.3.1.8.8. ТипДоговора (Личный/В пользу третьих лиц/В пользу выгодоприобретателей)

2.3.1.8.9. ДатаПервогоДоговораПДС

2.3.1.8.10. ИнвестиционнаяСтратегияПДС

2.3.1.9. Параметры из шаблона договора:

2.3.1.9.1. Представление Шаблона договора

2.3.2. Информация о ПС (ПДС):

2.3.2.1. ГИУД ПС /guidPS

2.3.2.2. Код ПС / accountNumber / KodPS

2.3.2.3. ПС-ПометкаНаУдаление

2.3.2.4. Код участника/ npoCode

2.3.2.5. ГИУД участника/ guidClient

2.3.2.6. Представление Участника (Контрагент.Наименование)

2.3.2.7. Состояние ПС / state

2.3.2.8. Причина закрытия / stopReason

2.3.2.9. Дата открытия ПС (накопит. период)/ dateNp

2.3.2.10. Дата закрытия ПС / dateStop

2.3.2.11. Пенсионные параметры:

2.3.2.11.1. Дата назначения пенсии (Дата начала = 22.01.2024) / datePension

2.3.2.11.2. Дата решения о назначении (01.03.2024)

2.3.2.11.3. Тип пенсии - Пожизненная, срочная

2.3.2.11.4. Размер пенсии

2.3.2.11.5. Периодичность выплаты

2.3.2.11.6. Срок выплат

2.3.2.11.7. Дата окончания срочных выплат (из РС

2.3.2.12. Единовременные выплаты (Данные по каждому Решению ЕВ)

2.3.2.12.1. Дата решения

2.3.2.12.2. Основание – вид заявления

2.3.2.12.3. Сумма к выплате

2.3.2.13. Назначенные выкупные суммы (Данные по каждому Решению ВС)

2.3.2.13.1. Дата решения

2.3.2.13.2. Основание – вид заявления (+ тип заявления)

2.3.2.13.3. Тип заявления

2.3.2.13.4. Особые обстоятельства

2.3.2.13.5. Вид дорогостоящего лечения

2.3.2.13.6. Сумма к выплате

2.3.2.14. Назначенные выкупные суммы правопреемникам (Данные по каждому Решению ВС ПП)

2.3.2.14.1. Дата решения

2.3.2.14.2. Основание – вид заявления (+ тип заявления)

2.3.2.14.3. Сумма к выплате

2.3.2.15. Платежные реквизиты (срез последних, заполняется только если в РС Лицевые счета поле Участник=ПС.Участник)

2.3.2.15.1. Форма выплаты

2.3.2.15.2. Получатель (Участник\Банк) /guidКонтрагента

2.3.2.15.3. Тип ЛС

2.3.2.15.4. Номер ЛС

2.3.2.15.5. Расчетный счет

2.3.2.15.6. БИК Банка

2.3.2.16. Текущий остаток на ПС

2.3.2.16.1. Тип резерва

2.3.2.16.2. Тип суммы/ typeSum

2.3.2.16.3. Сумма / sum

6.13.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам ПДС

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/PDS_PS_Request

Описание GET или POST запрос:

Элемент Описание Тип данных
ИмяМетода pds_ps_request
uid GUID контрагентов с разделителем «,» (запятая) Текст

Описание JSON ответа:

Структура массива «clients»: массив объектов с информацией о пенсионных счетах ПДС контрагента

Элемент Описание Тип данных
RefKey ГУИД контрагента GUID
Exist Признак нахождения контрагента по ГУИД boolean
accounts массив ПС ПДС Массив объектов

Структура массива «accounts»: массив объектов с информацией отраженной на ПС ПДС

Элемент Описание Тип данных
RefKey ГУИД пенсионного счета ПДС GUID
Code Код пенсионного счета ПДС Строка
DeletionMark Признак пометки на удаление пенсионного счета ПДС boolean
RefKeyUCH ГУИД контрагента-участника Строка
CodeUCH Код участника Строка
NameUCH Полное наименование участника (ФИО) Строка
State Текуще состояние пенсионного счета Строка
StopReason Причина закрытия пенсионного счета Строка
DateNP Дата открытия счета (перевод в накопительный период) Дата
DateClose Дата закрытия счета Дата
Pension Информация о назначенной периодической выплате Объект
agreement Информация о договоре ПДС, по которому открыт счет Объект
PaymentDetails Информация о банковских реквизитах участника Объект
OnePay Массив решений о единовременной выплате по счету Массив Объектов
FinalPay Массив решений о выкупной сумме по счету Массив Объектов
OutPay Массив решений о выплате выкупных сумм ПП по счету Массив Объектов (УП) – функционал не реализован
Balance Массив с информацией об остатке на ПС ПДС Массив Объектов

Состав объекта «Pension»: информация о назначенной периодической выплате

Элемент Описание Тип данных
DatePension Дата назначения пенсии Дата
DateDoc Дата решения о назначении Дата
Type Тип пенсии - Пожизненная, срочная Строка
Sum Размер периодической выплаты Строка
Periodicity Периодичность выплаты. Для ПДС всегда 1 Целое число
Count Количество назначенных выплат. Для пожизненной выплаты – не заполняется Целое число

Состав объекта «agreement»: информация о договоре ПДС

Элемент Описание Тип данных
RefKey ГУИД договора ПДС Строка
Code Код договора ПДС Строка
DeletionMark Признак пометки на удаление договора ПДС Boolean
RefKeyVKL ГУИД контрагента-вкладчика по договору ПДС Строка
CodeVKL Код контрагента-вкладчика по договору ПДС Строка
NameVKL Наименование контрагента-вкладчика по договору ПДС Строка
TypeVKL Тип вкладчика Число
State Текущее состояние договора Строка
StopReason Причина закрытия Дата
DateSign Дата договора Дата
DateSignDog Дата заключения договора Дата
DateOpen Дата начала действия договора Дата
DateOpenFirst Дата заключения первого договора ПДС Дата
DateClose Дата прекращения договора Дата
Sheme Вид договора ПДС Строка
Type Тип договора ПДС Строка
Pattern Шаблон договора ПДС Строка

Таблица. Значения Текущего состояние договора ПДС (State)

Значение
Открыт
Действует
Приостановлен
Подготовка к закрытию
Закрыт

Таблица. Значения Причина закрытия/прекращения договора НПО (StopReason)

Значение
Заключен
Действует
Выплатной период
Закрыт

Таблица. Значения Причина закрытия/прекращения договора ПДС (StopReason)

Значение
По смерти
Досрочное расторжение
Договор выполнен
Переход в другой НПФ

Состав объекта «PaymentDetails»: информация о банковских реквизитах участника по счету

Элемент Описание Тип данных
Type Форма выплаты Строка
RefKey ГУИД контрагента-получателя (участник/банк) Строка
AccountType Тип ЛС (лицевой счет/карточный счет) Строка
AccountNumber Номер ЛС Строка
BankAccount Расчетный счет Строка
BIK БИК Банка Строка

Структура массива «OnePay»: информация о единовременных выплатах

Элемент Описание Тип данных
DateDecision Дата решения о единовременной выплате Дата
RefKeyDecision ГУИД решения о единовременной выплате Строка
Decision Представление решения о единовременной выплате Строка
RefKeyStatement ГУИД документа основания принятия решения Строка
Statement Представление документа основания принятия решения Строка
ТуреDocStatement Тип документа основания принятия решения Строка
Sum Размер единовременной выплаты Денежный

Структура массива «FinalPay»: информация о выкупных суммах

Элемент Описание Тип данных
Type Форма выплаты Строка
RefKey ГУИД контрагента-получателя (участник/банк) Строка
AccountType Тип ЛС (лицевой счет/карточный счет) Строка
AccountNumber Номер ЛС Строка
BankAccount Расчетный счет Строка
BIK БИК Банка Строка

Структура массива «OnePay»: информация о единовременных выплатах

Элемент Описание Тип данных
DateDecision Дата решения о выплате выкупной суммы Дата
RefKeyDecision ГУИД решения о выплате выкупной суммы Строка
Decision Представление решения о выплате выкупной суммы Строка
RefKeyStatement ГУИД документа основания для принятия решения Строка
Statement Представление документа основания для принятия решения Строка
ТуреDocStatement Вид документа основания для принятия решения Строка
ТуреStatement Тип документа основания для принятия решения (тип заявления) Строка
SpecialSituation Вид особых обстоятельств Строка
TypeTherapy Вид дорогостоящего лечения Строка
Sum Размер выплаты Денежный

Структура массива «OutPay»: информация о выкупных суммах

Элемент Описание Тип данных
DateDecision Дата решения о выплате Дата
RefKeyDecision ГУИД решения о выплате выкупной суммы ПП Строка
Decision Представление решения о выплате выкупной суммы ПП Строка
Sum Сумма выплаты по решению Денежный

Структура массива OutPay представлена в общем виде по шапке документа – предстоит доработка после обсуждения (включать/не включать расшифровку ТЧ по ПП)

Структура массива «Balance»: информация о выкупных суммах

Элемент Описание Тип данных
TypeRes Тип резерва, на котором сформирован остаток строка
TypeResId Тип резерва, на котором сформирован остаток (идентификатор) Строка
TypeSum Тип суммы остатка Строка
TypeSumId Тип суммы остатка (идентификатор) Строка
Sum Сумма Денежный

6.14 Сервисы по ОПС. (OPS_PS_Request) Получить данные по Договора клиентов ОПС

Обмен без учета регистрации изменений.

В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.

В рамках сервиса в качестве входящих параметров передаются идентификаторы клиентов (ФЛ/ЮЛ) есть признак «Есть ОПС», по которым сервис вернет информацию о его Договоре.

В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 100 000. (для post запроса доступно не более 100 000, для get запроса максимум= 40).

В результате сервис по каждому запрошенному идентификатору клиента возвращает информацию о его Договоре ОПС, а также о текущем остатке на Договоре. Передача персональных данных ко клиенту не предусмотрена.

При вызове через POST запрос в тело запроса передается JSON с массивом UID клиентов.

Пример структуры JSON:

{ 

   " uids": [
       "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
       "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
       "87e21fff-cb82-11e3-be9d-74d02bc3313d"
   ]

}

6.14.1 Описание объектов и параметров, которые используются при обмене данными

Входящий параметр (коллекция):

2. ГУИД контрагента /guidClient

По полученному списку ГУИД контрагента (guidClient) производится отбор Договоров. Выборка производится по справочнику Договоры ОПС по полю участник и формируется ответ. Если будет передан guidClient, который не имеет договор, то сервис не вернет по такому клиенту информацию. Персональная информация по Контрагенту (Участнику) не передается (кроме представления контрагента – для визуального контроля/тестирования)

Данные по остаткам на Договоре собираются по каждому Договору из РН Резервы ОПС с отбором по типам резервов: все, кроме «Резерв ОПС»

3. Объекты-источники:

3.1. Справочник. Контрагенты,

3.2. Справочник.уп_ДоговорыОПС,

3.3. РС.уп_СостоянияДоговораОПС

3.4. РС.уп_ПричиныЗакрытияДоговоровОПС

3.5. РС.уп_ПериодичностьВыплатОПС

3.6. РС.уп_РазмерПенсииОПС

3.7. РС.уп_ЛицевыеСчетаЗастрахованныхЛиц

3.8. РН.уп_РезервыОПС

4. Информация, которая передается в качестве результата:

4.1. Клиент /guidClient

4.2. FindClientID - Признак КлинтНайден по гуид - булево

(FindClientID) - Если клиент по гуид не обнаружен, то FindClientID =False

Если клиент по гуид обнаружен, то FindClientID =TRUE и возвращается набор параметров:

4.3. Если ПС по ПДС найдены, то передается информация:

4.4. Договор (ОПС):

4.4.1. ГИУД ПД /

4.4.2. Код ПД /

4.4.3. ПД -ПометкаНаУдаление

4.4.4. Код участника/

4.4.5. ГИУД участника/

4.4.6. Состояние ПД /

4.4.7. Причина закрытия ПД /

4.4.8. Дата открытия ПД (накопит. период)/

4.4.9. Дата закрытия ПД /

4.4.10. Пенсионные параметры (По НП и СВ отдельно):

4.4.10.1. Дата назначения пенсии (Дата начала = 22.01.2024) /

4.4.10.2. Дата решения о назначении (01.03.2024)

4.4.10.3. Тип пенсии = Пожизненная, срочная

4.4.10.4. Размер пенсии

4.4.10.5. Периодичность выплаты

4.4.10.6. Срок выплат

4.4.10.7. Дата окончания срочных выплат (из РС)

4.4.11. Единовременные выплаты (Данные по каждому Решению ЕВ):

4.4.11.1. Дата решения

4.4.11.2. Основание – вид заявления

4.4.11.3. Сумма к выплате

4.4.12. Переводы СПН в ПДС (Данные по каждому Решению):

4.4.12.1. Дата решения

4.4.12.2. Основание – вид заявления

4.4.12.3. Сумма

4.4.13. Назначенные выкупные суммы правопреемникам (Данные по каждому Решению ВС ПП):

4.4.13.1. Дата решения

4.4.13.2. Основание – вид заявления ()

4.4.13.3. Сумма к выплате

4.4.14. Платежные реквизиты (По НП и СВ отдельно)

4.4.14.1. Форма выплаты

4.4.14.2. Получатель (Участник\Банк) /

4.4.14.3. Тип ЛС

4.4.14.4. Номер ЛС

4.4.14.5. Расчетный счет

4.4.14.6. БИК Банка

4.4.14.7. Текущий остаток на ПС

4.4.14.7.1. Тип резерва

4.4.14.7.2. Тип суммы

4.4.14.7.3. Сумма

6.14.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам ПДС

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/OPS_PS_Request

Описание GET или POST запрос:

Элемент Описание Тип данных
ИмяМетода ops_ps_request
uid GUID контрагентов с разделителем «,» (запятая) Текст

Описание JSON ответа:

Структура массива «clients»: массив объектов с информацией о пенсионных счетах ПДС контрагента

Элемент Описание Тип данных
RefKey ГУИД контрагента GUID
Exist Признак нахождения контрагента по ГУИД boolean
accounts массив Договоров ОПС Массив объектов

Структура массива «accounts»: массив объектов с информацией, отраженной на Договоре ОПС

Элемент Описание Тип данных
RefKey ГУИД пенсионного счета ПДС GUID
Code Код Договора ОПС Строка
CodeLS Код лицевого счета Договора ОПС Строка
DeletionMark Признак пометки на удаление пенсионного счета ПДС boolean
RefKeyUCH ГУИД контрагента-участника Строка
CodeUCH Код участника Строка
NameUCH Полное наименование участника (ФИО) Строка
TypeUCH Тип участника (1- Физическое лицо) Строка
State Текущее состояние Договора ОПС Строка
StopReason Причина закрытия Договора ОПС Строка
DateSign Дата заключения Договора ОПС Дата
DateOpen Дата открытия Договора ОПС Дата
DateClose Дата закрытия Договора ОПС Дата
InsurerPrev Информация о предыдущем Фонде Объект
InsurerNext Информация о следующем Фонде Объект
PensionNP Информация о назначенной накопительной пенсии Объект
PensionSV Информация о назначенной срочной выплате Объект
PaymentDetailsNP Информация о банковских реквизитах участника для накопительной пенсии Объект
PaymentDetailsSV Информация о банковских реквизитах участника для срочной выплаты Объект
OnePay Массив решений о единовременной выплате по договору Массив Объектов
PdsPay Массив решений о переводе СПН в ПДС Массив Объектов
OutPay Массив решений о выплате выкупных сумм ПП по Договору Массив Объектов
Balance Массив с информацией об остатке на ПС ПДС Массив Объектов

Таблица. Значения Текущего состояние договора ОПС (State)

Значение
Заключен
Ожидание подтверждения ПФР
Ожидание поступления взносов
Накопительный период
Выплатной период
Приостановлен по отказу из ПФР
Подготовка к прекращению
Закрыт
Начисления приостановлены
Обязательства выполнены

Таблица. Значения Причина закрытия договора ОПС (StopReason)

Значение
По смерти
Переход в другой ПФ
Переход в другой ПФ (досрочный)
Закрыт по отказу из ПФР
Аннулирование лицензии
Единовременная выплата
Не вступил в силу
По решению суда
Договор выполнен
Объединение СНИЛС
По иным причинам

Состав объектов «InsurerPrev» и «InsurerNext»: информация о предыдущем и последующем страховщиках

Элемент Описание Тип данных
RefKey ГУИД страховщика GUID
Code Код страховщика Строка
Name Наименование страховщика Строка
INN ИНН страховщика Строка

Состав объектов «PensionNP» и «PensionSV»: информация о назначенной периодической выплате

Элемент Описание Тип данных
DatePension Дата назначения пенсии Дата
DateDecision Дата решения о назначении пенсии Дата
Sum Размер пенсии Строка
Periodicity Периодичность выплаты пенсии Строка
Count Количество назначенных выплат. Для НП – не заполняется Целое число

Состав объектов «PaymentDetailsNP» и «PaymentDetailsSV»: информация о банковских реквизитах участника по Договору

Элемент Описание Тип данных
Type Форма выплаты Строка
RefKey ГУИД контрагента-получателя (участник/банк) Строка
AccountType Тип ЛС (лицевой счет/карточный счет) Строка
AccountNumber Номер ЛС Строка
BankAccount Расчетный счет Строка
BIK БИК Банка Строка

Структура массива «OnePay»: информация о единовременных выплатах

Элемент Описание Тип данных
DateDecision Дата решения о единовременной выплате Дата
RefKeyDecision ГУИД решения о единовременной выплате Строка
Decision Представление решения о единовременной выплате Строка
RefKeyStatement ГУИД документа основания принятия решения Строка
Statement Представление документа основания принятия решения Строка
ТуреDocStatement Тип документа основания принятия решения Строка
Sum Размер единовременной выплаты Денежный

Структура массива «PdsPay»: информация о переводе СПН в ПДС

Элемент Описание Тип данных
DateDecision Дата решения о переводе СПН в ПДС Дата
RefKeyDecision ГУИД решения о переводе СПН в ПДС Строка
Decision Представление решения о переводе СПН в ПДС Строка
RefKeyStatement ГУИД документа основания принятия решения Строка
Statement Представление документа основания принятия решения Строка
ТуреDocStatement Тип документа основания принятия решения Строка
Sum Размер суммы перевода Денежный

Структура массива «OutPay»: информация о выкупных суммах

Элемент Описание Тип данных
DateDecision Дата решения о выплате выкупной суммы ПП Дата
RefKeyDecision ГУИД решения о выплате выкупной суммы ПП Строка
Decision Представление решения о выплате выкупной суммы ПП Строка
RefKeyStatement ГУИД документа основания принятия решения Строка
Statement Представление документа основания принятия решения Строка
ТуреDocStatement Тип документа основания принятия решения Строка
Sum Размер суммы выплаты Денежный

Структура массива «Balance»: информация об остатках по договору

Элемент Описание Тип данных
DateDecision Дата решения о переводе СПН в ПДС Дата
RefKeyDecision ГУИД решения о переводе СПН в ПДС Строка
Decision Представление решения о переводе СПН в ПДС Строка
RefKeyStatement ГУИД документа основания принятия решения Строка
Statement Представление документа основания принятия решения Строка
ТуреDocStatement Тип документа основания принятия решения Строка
Sum Размер суммы перевода Денежный

Структура массива «OutPay»: информация о выкупных суммах

Элемент Описание Тип данных
TypeRes Тип резерва, на котором сформирован остаток строка
TypeResId Тип резерва, на котором сформирован остаток (идентификатор) Строка
TypeSum Тип суммы остатка Строка
TypeSumId Тип суммы остатка (идентификатор) Строка
Sum Сумма Денежный

6.15 Сервисы по НПО. (NPO_Operations_Request) Получить данные выписки по ПС клиентов НПО

Обмен без учета регистрации изменений.

В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.

В рамках сервиса в качестве входящих параметров передаются идентификаторы ПС НПО, по которым сервис передает информацию о движениях по ПС.

В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 512. (для post запроса доступно не более 512, для get запроса максимум= 40).

В результате сервис по каждому запрошенному идентификатору ПС передает всю историю о движениях по ПС.

При вызове через POST запрос в тело запроса передается JSON с массивом UID счетов.

Пример структуры JSON:

{ 

   " uids": [
       "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
       "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
       "87e21fff-cb82-11e3-be9d-74d02bc3313d"
   ]

}

6.15.1 Описание объектов и параметров, которые используются при обмене данными

Входящий параметр (коллекция):

1. ГУИД ПС / guidPS

По полученному списку ГУИД ПС (guidPS) производится отбор ПС в РН Резервы НПО и формируется ответ.

Данные в РН Резервы НПО собираются с отбором по типам резервов: ИПС/СПС/ Резерв наследников ИПС/ Резерв наследников СПС

1. Объекты-источники:

1.1. Справочник. уп_ПенсионныеСчета

1.2. РН Резервы НПО

2. Информация, которая передается в качестве результата:

2.1. ПС / guidPS

2.2. FindPsID - Признак ПС Найден по гуид – булево. (FindPsID) - Если ПС по гуид не обнаружен, то FindPsID =False. Если ПС по гуид обнаружен, то FindPsID =TRUE и возвращается набор параметров:

2.3. Код ПС / accountNumber / KodPS

2.4. Движения:

2.4.1. Регистратор (документ):

2.4.2. Идентификатор документа / guidDoc

2.4.3. Дата документа / date

2.4.4. Номер документа /NumberDoc

2.4.5. Вид документа (как в 1с)

2.4.6. Представление документа (вид операции) / vidOp – описание заполнения приведено ниже

2.4.7. Дата движения

2.4.8. Вид движения (+Приход/-расход)

2.4.9. Тип резерва

2.4.10. Тип суммы/ typeSum

2.4.11. Сумма / sum

2.5. Таблица остатков по каждому ПС, которые передаются через этот сервис:

2.5.1. ГИУД ПС /guidPS

2.5.2. Код ПС / accountNumber / KodPS

2.5.3. Тип резерва

2.5.4. Тип суммы/ typeSum

2.5.5. Сумма / sum

Таблица 1. Типы резервов НПО

Элемент Описание Тип данных
DateDecision Дата решения о переводе СПН в ПДС Дата
RefKeyDecision ГУИД решения о переводе СПН в ПДС Строка
Decision Представление решения о переводе СПН в ПДС Строка
RefKeyStatement ГУИД документа основания принятия решения Строка
Statement Представление документа основания принятия решения Строка
ТуреDocStatement Тип документа основания принятия решения Строка
Sum Размер суммы перевода Денежный

Структура массива «OutPay»: информация о выкупных суммах

Тип резерва (TypeResId) Представление Типа резерва (TypeRes)
СПС СПС
ИПС ИПС
ПожизненныхВыплат Пожизненных выплат
Страховой Страховой
РезервНачисленийПенсийСПС Резерв начислений пенсий СПС
РезервНачисленийПенсийИПС Резерв начислений пенсий ИПС
РезервНачисленийПенсийПожизненныхВыплат Резерв начислений пенсий пожизненных выплат
РезервНачисленийВыкупныхСуммСПС Резерв начислений выкупных сумм СПС
РезервНачисленийВыкупныхСуммИПС Резерв начислений выкупных сумм ИПС
РезервНачисленийВыкупныхСуммПожизненныхВыплат Резерв начислений выкупных сумм пожизненных выплат
РезервНаследниковИПС Резерв наследников ИПС
РезервНаследниковСПС Резерв наследников СПС
РезервНачисленийНаследниковИПС Резерв начислений наследников ИПС
РезервНачисленийНаследниковСПС Резерв начислений наследников СПС
РПАР РПАР

Таблица 2. Типы сумм НПО

Тип сумм (TypeSumId) Представление Типа сумм НПО (TypeSum)
ИДНаРезерв ИД на резерв
Резерв Резерв
ИДФиз ИД на взносы физ.лиц
ИДТр ИД на взносы третьих лиц
ИДЮр ИД на взносы юр.лиц
ВзносыФиз Взносы физ.лиц
ВзносыТр Взносы третьих лиц
ВзносыЮр Взносы юр.лиц
ВзносыЮрЛицНеоблагаемые Взносы юр.лиц необлагаемые

6.15.2 Описание Запроса и ответа получения полной выписки по ПС клиентов НПО

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/ NPO_Operations_Request

Описание GET или POST запрос:

Элемент Описание Тип данных
ИмяМетода npo_operations_request
uid GUID пенсионных счетов с разделителем «,» (запятая) Текст

Описание JSON ответа:

Структура массива «accounts»: массив структур с информацией о движении по ПС НПО и остаткам на ПС НПО

Элемент Описание Тип данных
RefKeyPS ГУИД пенсионного счета ПДС GUID
Exist Признак найденного пенсионного счета НПО по ГУИД boolean
CodePS Код пенсионного счета ПС Строка
operations Массив с информацией о движении по ПС ПДС Массив объектов
Balance Массив с информацией об остатке на ПС ПДС Массив объектов

Структура массива «operations»: массив структур с информацией о движении по ПС ПДС

Элемент Описание Тип данных
RefKeyDoc ГУИД документа – регистратора движения по ПС НПО Строка
PresDoc Представление документа – регистратора движения по ПС НПО Строка
DateDoc Дата документа – регистратора Дата
NumberDoc Номер документа – регистратора Строка
TypeDoc Тип документа – регистратора Строка
TypeMove Направление денежного потока (приход/расход) Строка
TypeRes Тип резерва, на котором отражено движение Строка
TypeResId Тип резерва, на котором отражено движение (идентификатор) Строка
TypeSum Тип суммы движения Строка
TypeSumId Тип суммы движения (идентификатор) Строка
Sum Сумма денежный

Структура массива «Balance»: массив структур с информацией о суммах, составляющих остаток ПС ПДС

Элемент Описание Тип данных
TypeRes Тип резерва, на котором сформирован остаток Строка
TypeResId Тип резерва, на котором сформирован остаток (идентификатор) Строка
TypeSum Тип суммы остатка Строка
TypeSumId Тип суммы остатка (идентификатор) Строка
Sum Сумма денежный

6.16 Сервисы по ПДС. (PDS_Operations_Request) Получить данные выписки по ПС клиентов ПДС

Обмен без учета регистрации изменений.

В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.

В рамках сервиса в качестве входящих параметров передаются идентификаторы ПС ПДС, по которым сервис передает информацию о движениях по ПС.

В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 512. (Для post запроса доступно не более 512, для get запроса максимум= 40).

В результате сервис по каждому запрошенному идентификатору ПС передает всю историю о движениях по ПС.

При вызове через POST запрос в тело запроса передается JSON с массивом UID счетов.

Пример структуры JSON:

{ 

   " uids": [
       "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
       "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
       "87e21fff-cb82-11e3-be9d-74d02bc3313d"
   ]

}

6.16.1 Описание объектов и параметров, которые используются при обмене данными

Входящий параметр (коллекция):

1. ГУИД ПС / guidPS

По полученному списку ГУИД ПС (guidPS) по ПДС производится отбор ПС в РН Резервы ПДС и формируется ответ.

Данные в РН Резервы ПДС собираются с отбором по типам резервов: резервов: ИПС/ Резерв умерших ИПС

1. Объекты-источники:

1.1. Справочник. пдс_ПенсионныеСчетаПДС

1.2. РН Резервы ПДС

2. Информация, которая передается в качестве результата:

2.1. ПС / guidPS

2.2. FindPsID - Признак ПС Найден по гуид - булево

(FindPsID) - Если ПС по гуид не обнаружен, то FindPsID =False

Если ПС по гуид обнаружен, то FindPsID =TRUE и возвращается набор параметров:

2.3. Код ПС / accountNumber / KodPS

2.4. Движения:

2.4.1. Регистратор (документ):

2.4.2. Идентификатор документа / guidDoc

2.4.3. Дата документа / date

2.4.4. Номер документа /NumberDoc

2.4.5. Вид документа (как в 1с)

2.4.6. Представление документа (вид операции) / vidOp – описание заполнения приведено ниже

2.4.7. Дата движения

2.4.8. Вид движения (+Приход/-расход)

2.4.9. Тип резерва

2.4.10. Тип суммы/ typeSum

2.4.11. Сумма / sum

2.5. Таблица остатков по каждому ПС, которые передаются через этот сервис:

2.5.1. ГИУД ПС /guidPS

2.5.2. Код ПС / accountNumber / KodPS

2.5.3. Тип резерва

2.5.4. Тип суммы/ typeSum

2.5.5. Сумма / sum

Таблица 1. Типы резервов ПДС

Тип резерва (TypeResId) Представление Типа резерва (TypeRes)
ИПС ИПС
РезервСрочнойВыплаты Резерв срочной выплаты
РезервПожизненнойВыплаты Резерв пожизненной выплаты
РезервЕдиновременнойВыплаты Резерв единовременной выплаты
РезервНачисленияСрочнойВыплаты Резерв начисления срочной выплаты
РезервНачисленияПожизненнойВыплаты Резерв начисления пожизненной выплаты
РезервНачисленияЕдиновременнойВыплаты Резерв начисления единовременной выплаты
РезервНачисленияВыкупныхСумм Резерв начисления выкупных сумм
РезервНачисленияПриПереводеВДругойПФ Резерв начисления при переводе в другой ПФ
РезервНачисленияОсобыеОбстоятельства Резерв начисления особые обстоятельства
РезервУмершихИПС Резерв умерших ИПС
РезервУмершихРСВ Резерв умерших РСВ
РезервНачисленияПравопреемникамИПС Резерв начисления правопреемникам ИПС
РезервНачисленияПравопреемникамРСВ Резерв начисления правопреемникам РСВ
Страховой Страховой

Таблица 2. Типы сумм ПДС

Тип суммы (TypeSumId) Представление Типа сумм (TypeSum)
ВзносыЮЛ Взносы ЮЛ
ИДВзносыЮЛ ИД на взносы ЮЛ
Сберегательный Сберегательный взнос
Единовременный Единовременный взнос
ДополнительныйСтимулирующий Дополнительный стимулирующий взнос
СберегательныйТЛ Сберегательный взнос третьих лиц
ИДСберегательный ИД на сберегательный взнос
ИДЕдиновременный ИД на единовременный взнос
ИДДополнительныйСтимулирующий ИД на дополнительный стимулирующий взнос
ИДСберегательныйТЛ ИД на сберегательный взнос третьих лиц

6.16.2 Описание Запроса и ответа получения полной выписки по ПС клиентов ПДС

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/PDS_Operations_Request

Описание GET или POST запрос:

Элемент Описание Тип данных
ИмяМетода pds_operations_request
uid GUID контрагентов с разделителем «,» (запятая) Текст

Описание JSON ответа:

Структура массива «accounts»: массив структур с информацией о движении по ПС ПДС и остаткам на ПС ПДС

Элемент Описание Тип данных
RefKeyPS ГУИД пенсионного счета ПДС GUID
Exist Признак найденного пенсионного счета ПДС по ГУИД boolean
CodePS Код пенсионного счета ПС Строка
operations Массив с информацией о движении по ПС ПДС Массив объектов
Balance Массив с информацией об остатке на ПС ПДС Массив объектов

Структура массива «operations»: массив структур с информацией о движении по ПС ПДС

Элемент Описание Тип данных
RefKeyDoc ГУИД документа – регистратора движения по ПС ПДС строка
PresDoc Представление документа – регистратора движения по ПС ПДС строка
DateDoc Дата документа – регистратора Дата
NumberDoc Номер документа – регистратора строка
TypeDoc Тип документа – регистратора строка
TypeMove Направление денежного потока (приход/расход) строка
TypeRes Тип резерва, на котором отражено движение строка
TypeResId Тип резерва, на котором отражено движение (идентификатор) строка
TypeSum Тип суммы движения строка
TypeSumId Тип суммы движения (идентификатор) строка
Sum Сумма денежный

Структура массива «Balance»: массив структур с информацией о суммах, составляющих остаток ПС ПДС

Элемент Описание Тип данных
TypeRes Тип резерва, на котором сформирован остаток строка
TypeResId Тип резерва, на котором сформирован остаток (идентификатор) строка
TypeSum Тип суммы остатка строка
TypeSumId Тип суммы остатка (идентификатор) строка
Sum Сумма денежный

6.17 Сервисы по ОПС. (OPS_Operations_Request) Получить данные выписки по Договорам клиентов ОПС

Обмен без учета регистрации изменений.

В рамках данного сервиса не предусмотрен контроль подтверждения успешного прохождения сообщений.

В рамках сервиса в качестве входящих параметров передаются идентификаторы Договоров ОПС, по которым сервис передает информацию о движениях.

В рамках данного запроса предусмотрено ограничение по количеству входящих параметров. Параметр настраивается в информационной системе – источнике. По умолчанию количество параметров = 512. (Для post запроса доступно не более 512, для get запроса максимум= 40).

В результате сервис по каждому запрошенному идентификатору Договора передает всю историю о движениях.

При вызове через POST запрос в тело запроса передается JSON с массивом UID Договоров.

Пример структуры JSON:

{ 

   " uids": [
       "7a2e005a-8efd-11e3-be8c-74d02bc3313d",
       "87e21ffa-cb82-11e3-be9d-74d02bc3313d",
       "87e21fff-cb82-11e3-be9d-74d02bc3313d"
   ]

}

6.17.1 Описание объектов и параметров, которые используются при обмене данными

Входящий параметр (коллекция):

2. ГУИД ПС / guidPS

По полученному списку ГУИД Договоров (guidPS) по ОПС производится отбор Договоров в РН Резервы ОПС и формируется ответ.

Данные в РН Резервы ОПС собираются с отбором по типам резервов: резервов: все, кроме «Резерв ОПС»

3. Объекты-источники:

3.1. Справочник. уп_ДоговорыОПС

3.2. РН Резервы ОПС

4. Информация, которая передается в качестве результата:

4.1. Договор / guidPS

4.2. FindPsID - Признак Договор Найден по гуид - булево

(FindPsID) - Если Договор по гуид не обнаружен, то FindPsID =False

Если Договор по гуид обнаружен, то FindPsID =TRUE и возвращается набор параметров:

4.3. Код Договор / accountNumber / KodPS

4.4. Движения:

4.4.1. Регистратор (документ):

4.4.2. Идентификатор документа / guidDoc

4.4.3. Дата документа / date

4.4.4. Номер документа /NumberDoc

4.4.5. Вид документа (как в 1с)

4.4.6. Дата движения

4.4.7. Вид движения (+Приход/-расход)

4.4.8. Тип резерва

4.4.9. Тип суммы/ typeSum

4.4.10. Сумма / sum

4.5. Таблица остатков по каждому Договору, которые передаются через этот сервис:

4.5.1. ГИУД Договора /

4.5.2. Код Договора /

4.5.3. Тип резерва

4.5.4. Тип суммы/

4.5.5. Сумма /

Таблица 1. Типы резервов ОПС

Тип резерва (TypeResId) Представление Типа резерва (TypeRes)
РезервПенсионныйНакоплений РПН
РезервСрочнойВыплаты РСВ
Выплатной Выплатной
РезервЕВ Резерв единовременной выплаты
РезервНачисленийНП Резерв начислений НП
РезервНачисленийСВ Резерв начислений СВ
РезервНачисленийЕВ Резерв начислений ЕВ
РезервНаследниковРПН Резерв умерших РПН
РезервНаследниковРСВ Резерв умерших РСВ
РезервНачисленийРасторжение Резерв начислений расторжение
РезервНачисленийНаследованиеРПН Резерв начислений наследование РПН
РезервНачисленийНаследованиеРСВ Резерв начислений наследование РСВ
РезервНачисленийНаследованиеРОПС Резерв начислений наследование РОПС
РезервНачисленийВозвратМСКРПН Резерв начислений возврат МСК РПН
РезервНачисленийВозвратМСКРСВ Резерв начислений возврат МСК РСВ
РезервНачисленийРазделениеСНИЛС Резерв начислений разделение СНИЛС

Таблица 2. Типы сумм ОПС

Тип суммы (TypeSumId) Представление Типа сумм (TypeSum)
ВзносыФиз Страховые взносы
ВзносыЮр Взносы работодателя
ГосПоддержка Взносы софинансирование
ДопВзносы Доп. страховые взносы
МатКапитал Материнский капитал
ИДФиз ИД на страховые взносы
ИДЮр ИД на взносы работодателя
ИДГосПоддержка ИД на софинансирование
ИДДопВзносы ИД на доп. страх. взносы
ИДМатКапитал ИД на материнский капитал

6.17.2 Описание Запроса и ответа получения полной выписки по ПС клиентов ОПС

Параметры: ID узла обмена / ключ

Путь к сервису: [host]/…/OPS_Operations_Request

Описание GET или POST запрос:

Элемент Описание Тип данных
ИмяМетода ops_operations_request
uid GUID договоров с разделителем «,» (запятая) Текст

Описание JSON ответа:

Структура массива «accounts»: массив структур с информацией о движении и остаткам на Договорах ОПС

Элемент Описание Тип данных
RefKeyPS ГУИД Договора ОПС GUID
Exist Признак найденного Договора ОПС по ГУИД boolean
CodePS Код Договора ОПС Строка
operations Массив с информацией о движении по Договору ОПС Массив объектов
Balance Массив с информацией об остатке на Договоре ОПС Массив объектов

Структура массива «operations»: массив структур с информацией о движении по Договору ОПС

Элемент Описание Тип данных
RefKeyDoc ГУИД документа – регистратора строка
PresDoc Представление документа – регистратора строка
DateDoc Дата документа – регистратора Дата
NumberDoc Номер документа – регистратора строка
TypeDoc Тип документа – регистратора строка
TypeMove Направление денежного потока (приход/расход) строка
TypeRes Тип резерва, на котором отражено движение строка
TypeResId Тип резерва, на котором отражено движение (идентификатор) строка
TypeSum Тип суммы движения строка
TypeSumId Тип суммы движения (идентификатор) строка
Sum Сумма денежный

Структура массива «Balance»: массив структур с информацией о суммах, составляющих остаток на Договоре ОПС

Элемент Описание Тип данных
TypeRes Тип резерва, на котором сформирован остаток строка
TypeResId Тип резерва, на котором сформирован остаток (идентификатор) строка
TypeSum Тип суммы остатка строка
TypeSumId Тип суммы остатка (идентификатор) строка
Sum Сумма денежный

7 Приложения

Таблица А. Коды ответов сервисов

Код ответа Описание
200 Сервис отработал без ошибок. В теле ответа – json файл.
400 Некорректно заданы параметры сервиса. В теле ответа – текстовое описание ошибки.
404 В базе 1С не найдены данные. В теле ответа – текстовое описание ошибки.
405 Некорректно задано имя метода сервиса. В теле ответа – текстовое описание ошибки.
500 Ошибки выполнения на сервере. В теле ответа – текстовое описание ошибки.
Источник — http://clonewiki.orticongroup.ru/index.php?title=Подсистема_обмен_УНПФ&oldid=17994