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

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

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

1 группа участника
5057 правок
Нет описания правки
Нет описания правки
Строка 3410: Строка 3410:
<h2>'''6.9.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными'''</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. Типы резервов ОПС'''




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

Версия от 06:43, 25 июля 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. Типы резервов ОПС

Источник — http://clonewiki.orticongroup.ru/index.php?title=Подсистема_обмен_УНПФ&oldid=17949