Подсистема обмен УНПФ: различия между версиями
Нет описания правки |
Нет описания правки |
||
| Строка 60: | Строка 60: | ||
*[[#6.10 Общие сервисы. (ClientsID_Request) Получение полного списка идентификаторов клиентов (без персональных данных)|<span style="color:#000000"><small>6.10 Общие сервисы. (ClientsID_Request) Получение полного списка идентификаторов клиентов (без персональных данных)</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.1 Описание объектов и параметров, которые используются при обмене данными|<span style="color:#000000"><small>6.10.1 Описание объектов и параметров, которые используются при обмене данными</small></span>]] | ||
*[[#6.10.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам|<span style="color:#000000"><small>6.10.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам</small></span>]] | |||
</div> | </div> | ||
|style="vertical-align:top;| | |style="vertical-align:top;| | ||
| Строка 3685: | Строка 3686: | ||
<h2>'''6.10.1 Описание объектов и параметров, которые используются при обмене данными'''</h2> | <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> | |||
[[Категория:УНПФ| ]] | [[Категория:УНПФ| ]] | ||
Версия от 13:35, 28 июля 2025
| |||
|
| ||
|
Версия документа
1 Назначение модуляМодуль предназначен для предоставления необходимой информации для внешних систем (Например: СРМ, ЛК и т.п.) из подсистемы пенсионного учета УНПФ8 по НПО,ПДС и ОПС. Модуль работе в виде http-сервиса. Формат сообщений = json. Модуль доступен после покупки и активации соответствующей лицензии на сервере СЛК. Наименование модуля в УНПФ8 и в СЛК = «Обмен УНПФ». 2 ЦелиСервиса реализован в 1С (конфигурация УНПФ8) для предоставления данных внешним системам. На стороне 1С ведется регистрация изменений данных по клиентам (ФЛ) и данных по пенсионным счетам и договорам, а также операций (документов) с ними связанных Для каждой внешний системы в 1С создается «узел обмена», в рамках которого производится учет регистрация изменений и обмен данными. Обмен данными производится в виде «сообщений», в рамках которых регистрируется успешная или неуспешная передача данных. Предусмотрены отдельные сервисы для получения полных данных выборочно по конкретным клиентам вне рамок подсистемы регистрации изменений. Настройка реализована для вида учета по НПО, ПДС и ОПС. В рамках сервиса предусмотрена только предоставление данных по запросу. Загрузка информации в 1С (УНПФ8) не предусмотрена, т.е. загрузка новых договоров, участников и т.п. в рамках данного сервиса не предусмотрена. 3 Принятые сокращения и общие параметры
4 Настройка сервиса обмена 1С: УНПФДля предоставления данных внешним системам необходимо осуществить настройку сервисов обмена на форме «Настройки сервиса обмена УНПФ», которая доступна в разделе «Общие настройки УНПФ»/«Сервис доступа к данным УНПФ8» Данная настройка выполняется индивидуально для каждой внешней системы. Настройка доступна только пользователю с полными правами. Параметр «Пользователь» определяет от имени какого пользователя будет производится подключение к 1с со стороны внешней системы. Такой пользователь и его пароль задается администратором системы 1с. У пользователя должны быть доступна роль «Доступ к сервису УНПФ». Параметр «Организация» - используется для отбора данных, которые передаются через сервис. Параметр «Имя модуля» - если не задан, то используется модуль поставщика с предопределенным именем «уп_ИнтеграцияСВнешнимиСистемами». Либо указывается имя общего модуля, который настроен под требования организации. В модуле прописывается порядок сбора информации и формирование ответа json. Установка флага «Действует» предоставляет внешнему пользователю возможность получать данные из системы УНПФ. При подключении внешнего пользователя производится сверка есть ли для него данная настройка обмена и действует ли она. В рамках группы сервисов по регистрации изменений проверяется включена ли регистрация таких изменений (задан ли узел обмена и включен ли флаг «регистрировать изменения»). Если регистрация изменений не включена или не настроена, то будет ответ с кодом ошибки и с описанием ошибки (404,"Не указан в настройках источник данных"). Значение «Макс количество идентификаторов…» для GET-запросов по умолчанию равно 40, для POST-запросов 100 000. На закладке «Планы обмена» настраиваются узлы обмена для каждого пользователя (внешняя система). В узлах обмена производится регистрация и накопление изменений с момента последнего успешного обмена. Рекомендуется имя для узлов задавать по следующей маске: «Имя внеш. системы (пользователь)»-«Вид регистрируемых данных». Предусмотрены следующие виды регистрируемых данных (изменений): Контрагенты, ПС НПО, ПС ПДС, Договоры ОПС, Резервы НПО, Резервы ПДС, Резервы ОПС. Флаг «Регистрировать изменений» - если флаг установлен, то производится регистрация изменений в заданном узле обмена. Флаг устанавливается/снимается по кнопке «Вкл»/ «Откл». Параметр «№ Сообщения» - последний номер сообщения, который был передан в результате обмена. 5 Виды сервисов1. В рамках проекта предусматривается разработка две группы сервисов для вида учета НПО/ПДС/ОПС:
Предусмотрена возможность получения полного списка клиентов. 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») Список идентификаторов клиентов:
1.2. (Функция «ClientsInfo_Request») Получение информации по клиентам:
2. Сервисы по НПО: 2.1. (Функция «NPO_PS_Request») Получить данные по ПС клиентов НПО:
2.2. (Функция «NPO_Operations_Request») Получить полную выписку по счетам НПО:
3. Сервисы по ПДС: 3.1. (Функция «PDS_PS_Request») Получить данные по ПС клиентов ПДС:
3.2. (Функция «PDS_Operations_Request») Получить полную выписку по счетам ПДС:
4. Сервисы по ОПС: 4.1. (Функция «OPS_PS_Request») Получить данные по Договорам клиентов ОПС:
4.2. (Функция «OPS_Operations_Request») Получить полную выписку по Договорам ОПС:
6 Описание сервисов НПО/ПДС/ОПСИмена сервисов в документе содержат в имени дефис, для удобства визуального восприятия. По мере завершения работы над документом дефис будет замен на символ подчёркивания. 6.1 АвторизацияМеханизм авторизации в БД реализован посредством проверки логина и пароля 1С. Возможно, потребуется реализация отдельных прав для такого пользователя. http://[host]/hs/unpfAPI/v1/test - тест доступности сервиса 6.2 Общие сервисы. (StatusExchange) Подтверждение успешного обмена (НПО/ПДС/ОПС)Номера сообщений используются в механизмах обмена данными для контроля доставки переданной информации. Т.к. история изменений будет передаваться с момента последнего успешного номера сообщения в рамках конкретного узла обмена. Параметры этого обмена будут скорректированы по мере необходимости или по мере реализации. 6.2.1 Описание параметров, которые следует учесть в сообщении при обменеДля подтверждения успешного прохождения обмена требуется передать информацию:
Входящие параметры: 1. ГУИД узла обмена в 1с для данной внешней системы 2. Номер сообщения (в рамках сервиса обмена) Путь к сервису: [host]/hs/unpfAPI/v1/StatusExchange/ Описание JSON запрос:
Описание HTTP ответа: Cтрока ответа HTTP, содержит следующую информацию:
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 «Типы и виды контактной информации ФЛ»
Указаны предопределенные типы и виды контактной информации, но они могут быть расширены в рамках пользовательских настроек системы. Табл.2 «Коды документов»
6.3.2 Описание Запроса и ответа на Обмен изменениями по КлиентамПараметры: ID узла обмена / ключ Путь к сервису: [host]/…/ClientsChg_Request Описание JSON запрос:
Описание JSON ответа: Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения
Структура массива объектов «clients» - информация о контрагентах
Структура объекта «client» для Юридических лиц
Структура объекта «client» для Физических лиц
Таблица. Значения статусов контрагента по пенсионным счетам НПО
Структура объекта «Personal»
Структура объекта «Documents» - документы, удостоверяющие личность (ДУЛ) последние на дату (возможны разные виды документов, действующих на дату выгрузки)
Структура объекта «Phones» - телефоны контрагента
Структура объекта «Emails» - электронные адреса контрагента
Структура объекта «Addresses» - адреса контрагента
Таблица. Значения Кодов типов адреса
Структура объекта «AddressJSON» - элементы адреса контрагента
Структура объекта «buildings»
Структура объекта «apartments»
Структура объекта «statements»
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 запрос:
Описание JSON ответа: Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения
Структура массива объектов «clients» - массив содержит информацию по всем ПС НПО контрагента
Структура массива объектов «accounts» - массив содержит расширенную информацию по ПС НПО контрагента
Структура массива объектов «Agreement» - сведения о договоре НПО
Таблица. Значения Текущего состояние договора НПО (State)
Таблица. Значения Причина закрытия/прекращения договора НПО (StopReason)
Структура массива «Balance»: информация о выкупных суммах
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 запрос:
Описание JSON ответа: Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения
Структура массива «clients»: массив объектов с информацией о пенсионных счетах ПДС контрагента
Структура массива «accounts»: массив объектов с информацией отраженной на ПС ПДС
Состав объекта «Pension»: информация о назначенной периодической выплате
Состав объекта «agreement»: информация о договоре ПДС
Таблица. Значения Текущего состояние договора ПДС (State)
Таблица. Значения Причина закрытия/прекращения договора ПДС (StopReason)
Состав объекта «PaymentDetails»: информация о банковских реквизитах участника по счету
Структура массива «OnePay»: информация о единовременных выплатах
Структура массива «FinalPay»: информация о выкупных суммах
Структура массива «OutPay»: информация о выкупных суммах
Структура массива OutPay представлена в общем виде по шапке документа – предстоит доработка после обсуждения (включать/не включать расшифровку ТЧ по ПП) Структура массива «Balance»: информация об остатках по ПС
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 запрос:
Описание JSON ответа: Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения
Структура массива «clients»: массив объектов с информацией о пенсионных счетах ПДС контрагента
Структура массива «accounts»: массив объектов с информацией, отраженной на Договоре ОПС
Таблица. Значения Текущего состояние договора ОПС (State)
Таблица. Значения Причина закрытия договора ОПС (StopReason)
Состав объектов «InsurerPrev» и «InsurerNext»: информация о предыдущем и последующем страховщиках
Состав объектов «PensionNP» и «PensionSV»: информация о назначенной периодической выплате
Состав объектов «PaymentDetailsNP» и «PaymentDetailsSV»: информация о банковских реквизитах участника по Договору
Структура массива «PdsPay»: информация о переводе СПН в ПДС
Структура массива «OutPay»: информация о выкупных суммах
Структура массива «Balance»: информация об остатках по договору
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. Типы резервов НПО
Таблица 2. Типы сумм НПО
Табл. Значения VIDOP (строка) по документу регистратору
6.7.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (НПО)Параметры: ID узла обмена / ключ Путь к сервису: [host]/…/NPO_OperationsChg_Request Описание JSON запрос:
Описание JSON ответа: Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения
Структура массива «accounts»: массив структур с информацией о движении по ПС НПО и остаткам на ПС НПО
Структура массива «operations»: массив структур с информацией о движении по ПС ПДС
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. Типы резервов ПДС
Таблица 2. Типы сумм ПДС
Табл. Значения VIDOP (строка) по документу регистратору
6.8.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС)Параметры: ID узла обмена / ключ Путь к сервису: [host]/…/PDS_OperationsChg_Request Описание JSON запрос:
Описание JSON ответа: Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения
Структура массива «accounts»: массив структур с информацией о движении по ПС ПДС и остаткам на ПС ПДС
Структура массива «operations»: массив структур с информацией о движении по ПС ПДС
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. Типы резервов ОПС
Таблица 2. Типы сумм ОПС
6.9.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС)Параметры: ID узла обмена / ключ Путь к сервису: [host]/…/OPS_OperationsChg_Request Описание JSON запрос:
Описание JSON ответа: Структура ответа содержит объекты «package» и «documents». Структура объекта «package» - содержит GUID узла, зарегистрировавшего изменения и номер пакета сообщения
Структура массива «documents»: массив структур с информацией о документах
Структура объекта «operations»: массив структур с информацией о движении по Договорам ОПС
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 Описание Запроса и ответа на Обмен идентификаторами по клиентам |


