Подсистема обмен УНПФ

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

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

Модуль обмена данными НПФ Версия документа 1 Назначение модуля 2 Цели 3 Принятые сокращения и общие параметры 4 Настройка сервиса обмена 1С: УНПФ 5 Виды сервисов 5.1 Описание группы сервисов, в рамках которых ведется учет регистрации изменения передаваемых данных по НПО/ПДС/ОПС 5.2 Описание группы сервисов, в рамках которых не ведется учет регистрации изменения передаваемых данных 6 Описание сервисов НПО/ПДС/ОПС 6.1 Авторизация 6.2 Общие сервисы. (StatusExchange) Подтверждение успешного обмена (НПО/ПДС/ОПС) 6.2.1 Описание параметров, которые следует учесть в сообщении при обмене 6.2.2 Описание запроса и ответа для подтверждения успешного принятия сообщения из сервиса 6.3 Общие сервисы. (ClientsChg_Request) Обмен изменениями по Клиентам 6.3.1 Описание параметров, которые подлежат регистрации по ФЛ/ЮЛ и используются при обмене данными 6.3.2 Описание Запроса и ответа на Обмен изменениями по Клиентам 6.4 Сервисы по НПО. (NPO_PSChg_Request) Обмен изменениями по ПС и ПД (НПО) 6.4.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете НПО и используются при обмене данными 6.4 Сервисы по НПО. (NPO_PSChg_Request) Обмен изменениями по ПС и ПД (НПО) 6.4.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (НПО) 6.5 Сервисы по ПДС. (PDS_PSChg_Request) Обмен изменениями по ПС и ПД (ПДС) 6.5.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете ПДС и используются при обмене данными 6.5.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС) 6.6 Сервисы по ОПС. (OPS_PSChg_Request) Обмен изменениями по Договорам (ОПС) 6.6.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными 6.7 Сервисы по НПО. (NPO_OperationsChg_Request) Обмен изменениями в движениях по счету ПС и ПД (НПО) 6.7.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете НПО и используются при обмене данными 6.7.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (НПО) 6.8 Сервисы по ПДС. (PDS_OperationsChg_Request) Обмен изменениями в движениях по счету ПС и ПД (ПДС) 6.8.1 Описание объектов, которые подлежат учёту изменений по ПС и ПД в учете ПДС и используются при обмене данными 6.8.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС) 6.9 Сервисы по ОПС. (OPS_OperationsChg_Request) Обмен изменениями в движениях по Договору (ОПС) 6.9.1 Описание объектов, которые подлежат учёту изменений по Договорам в учете ОПС и используются при обмене данными 6.9.2 Описание Запроса и ответа на Обмен изменениями по ПС/ПД (ПДС) 6.10 Общие сервисы. (ClientsID_Request) Получение полного списка идентификаторов клиентов (без персональных данных) 6.10.1 Описание объектов и параметров, которые используются при обмене данными 6.10.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам 6.11 Общие сервисы. (ClientsInfo_Request) Получение информации по клиентам ЮЛ/ФЛ (персональные данные) 6.11.1 Описание объектов и параметров, которые используются при обмене данными 6.11.2 Описание полей запроса и ответа для получения информации по клиентам 6.12 Сервисы по НПО. (NPO_PS_Request) Получить данные по ПС клиентов НПО 6.12.1 Описание объектов и параметров, которые используются при обмене данными 6.12.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам НПО 6.13 Сервисы по ПДС. (PDS_PS_Request) Получить данные по ПС клиентов ПДС 6.13.1 Описание объектов и параметров, которые используются при обмене данными 6.13.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам ПДС 6.14 Сервисы по ОПС. (OPS_PS_Request) Получить данные по Договора клиентов ОПС 6.14.1 Описание объектов и параметров, которые используются при обмене данными 6.14.2 Описание Запроса и ответа на Обмен идентификаторами по клиентам ПДС 6.15 Сервисы по НПО. (NPO_Operations_Request) Получить данные выписки по ПС клиентов НПО 6.15.1 Описание объектов и параметров, которые используются при обмене данными 6.15.2 Описание Запроса и ответа получения полной выписки по ПС клиентов НПО 6.16 Сервисы по ПДС. (PDS_Operations_Request) Получить данные выписки по ПС клиентов ПДС 6.16.1 Описание объектов и параметров, которые используются при обмене данными 6.16.2 Описание Запроса и ответа получения полной выписки по ПС клиентов ПДС 6.17 Сервисы по ОПС. (OPS_Operations_Request) Получить данные выписки по Договорам клиентов ОПС 6.17.1 Описание объектов и параметров, которые используются при обмене данными 6.17.2 Описание Запроса и ответа получения полной выписки по ПС клиентов ОПС 7 Приложения

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