Главная Книги - Разные Методические рекомендации по интеграции с REST API Цифрового профиля (Версия 1.25)
поиск по сайту правообладателям
|
|
содержание .. 1 2 3
"salary":4547.6
},
{
"entNumber":"050-025-000004",
"entNam":"ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"КАЛУЖСКИЙ ТУРБИННЫЙ ЗАВОД\"
",
"year":2001,
"salary":22021.77
}
],
"experienceTill2002":[
{
"entNumber":"050-025-000004",
"entNam":"ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"КАЛУЖСКИЙ ТУРБИННЫЙ ЗАВОД\"
",
"beg":"28.08.2000",
"end":"31.12.2001",
"servLenYearsBefore2002":1,
"servLenMonthBefore2002":4,
"servLenDaysBefore2002":4
}
]
},
"pensRights20022014":{
"calculationInfo":[
{
"entNumber":"050-025-000004",
"entNam":"ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"КАЛУЖСКИЙ ТУРБИННЫЙ ЗАВОД\"
",
"detailPeriods":[
{
"beg":"01.01.2002",
"end":"10.01.2012",
"sumSv":197650.6,
"servLenYears":10,
"servLenMonths":0,
"servLenDays":10
}
]
}
],
"sum":211169.54
},
"date":"16.03.2021",
"type":"ILS_PFR",
"snils":"634-982-020 10",
"ipk":0.0,
"pension":{
"insurancePension":{
"startDate":"01.01.2007",
"type":"по старости",
"sum":5580.05
180
},
"lumpPayment":{
}
}
}
]
7.2.15 Справка о доходах и суммах налога физического лица
Модель документа «Справка о доходах и суммах налога физического лица» приведена в
следующей таблице:
Таблица 15 - Справка о доходах и суммах налога физического лица
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
1.
oid
Идентификатор
обязательно
Строка
пользователя
2.
id
Уникальный
обязательно
Строка
идентификатор
документа
3.
status
Статус достоверности
обязательно
Принимает значения:
verified_by_validate
verified_by_request
verified_by_push
unverified
4.
relevance
Релевантность
обязательно
Принимает значения:
документа
actual
expired
invalid
5.
type
Тип документа
обязательно
Для справки о доходах
и
суммах
налога
физического
лица
принимает
значение
INCOME_REFERENCE
6.
departmentDoc
Ведомство, к которому
не обязательно
Строка
относится документ
7.
receiptDocDate
Дата и время получения
не обязательно
Задается
как
документа в формате
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
181
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
8.
validateDateDoc
Дата и время валидации
не обязательно
Задается
как
документа в формате
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
9.
createdOn
Дата и время создания
обязательно
Задается
как
документа
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
10.
updatedOn
Дата
и
время
обязательно
Задается
как
обновления документа
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
11.
year
Отчетный налоговый
не обязательно
Год в формате ГГГГ
период
12.
data
Содержит данные о
не обязательно
Массив, состоящий из
справках о доходах и
следующих элементов
суммах
налога
(п. 12.1 - 12.6.6):
физического
лица,
данные сгруппированы
по работодателям
12.1.
orgInfo
Содержит сведения о
не обязательно
Объект, состоящий из
налоговом агенте
-
следующих элементов
юридическом лице
(п. 12.1.1 - 12.1.3)
12.1.1.
fullName
наименование
не обязательно
Строка
юридического лица
12.1.2.
inn
ИНН
юридического
не обязательно
Строка
лица
12.1.3.
kpp
КПП
юридического
не обязательно
Строка
лица
12.2.
personInfo
Сведения о налоговом
не обязательно
Объект, состоящий из
агенте
- физическом
следующих элементов
лице
(п. 12.2.1 - 12.2.4)
12.2.1.
inn
ИНН физического лица
не обязательно
Строка
12.2.2.
lastName
Фамилия физического
не обязательно
Строка
лица
182
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
12.2.3.
firstName
Имя физического лица
не обязательно
Строка
12.2.4.
middleName
Отчество физического
не обязательно
Строка
лица
12.3.
rate
Ставка налога
не обязательно
Строка
12.4.
income
Сумма дохода
не обязательно
Строка
12.5.
tax
Сумма налога
не обязательно
Строка
12.6.
files
Содержит справки о
не обязательно
Массив, состоящий из
доходах
и
суммах
следующих элементов
налога
физического
(п. 12.6.1 - 12.6.6)
лица в виде файлов,
закодированных
в
base64
12.6.1.
createdOn
Дата и время создания
не обязательно
Задается
как
файла
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
12.6.2.
updatedOn
Дата
и
время
не обязательно
Задается
как
обновления файла
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
12.6.3.
file
Справка о доходах и
не обязательно
Строка
суммах
налога
физического лица (xml
или
pdf),
закодированная
в
формате base64
12.6.4.
name
Наименование файла
не обязательно
Строка
12.6.5.
metadata
Формат файла
не обязательно
Строка.
Может
принимать следующие
значения:
application/xml
application/pdf
12.6.6.
sign
Файл p7s подписи к
не обязательно
Строка
файлу, переданному в
параметре
file,
183
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
закодированный
в
base64
13.
error
Отсутствие сведений о
не обязательно
Принимает
значение
налогах и доходах
«ndflNotFound».
Возвращается вместо
параметров 6 и 12 в
случае, если ФНС не
располагает
сведениями о доходах и
налогах физического
лица за указанный год.
Пример ответа на запрос справки о доходах и суммах налога физического лица, у которого за
2019 год имелась справка 2-НДФЛ, за 2018 год сведение отсутствует у пользователя (т.е. в ФНС
не запрашивалось), а за 2017 год ФНС не располагало сведениями о доходах и налогах
пользователя:
[
{
"oid": "1077115523",
"id": "69b29ec3-38f6-4132-b1e4-ba5dfd00e1d4",
"version": 1,
"createdOn": 1590473174594,
"updatedOn": 1590473174594,
"departmentDoc": "ФНС России",
"receiptDocDate": 1590473174594,
"validateDateDoc": 1590473174578,
"relevance": "actual",
"status": "verified_by_request",
"year": "2019",
"data": [
{
"orgInfo": {
"fullName": "РОМАШКА",
"inn": "7777021812",
"kpp": "777701001"
},
"rate": "13",
"income": "639489.06",
"tax": "83134",
"files": [
{
"createdOn": 1590473174594,
"updatedOn": 1590473174594,
184
"file": "PNCk0LDQudC...NC50Ls+", // полную строку см. в папке «Примеры документов
по типу сведений»
"name": "epgu_2ndfl_20200428_a70844e3-892a-11ea-9715-001a4a1662e8_2.xml",
"metadata": "application/xml",
"sign": "MIIK/AYJK
bJbSp2xfLC7c="// полную строку см. в папке «Примеры
документов по типу сведений»
},
{
"createdOn": 1590473174594,
"updatedOn": 1590473174594,
"file": "JVBERi0
DAwMCBu",
"name": "epgu_2ndfl_20200428_a70844e3-892a-11ea-9715-001a4a1662e8_2.pdf",
"metadata": "application/pdf",
"sign": "MIIK/AYJKo
ZPRkBAVQ="// полную строку см. в папке «Примеры документов
по типу сведений»
}
]
},
{
"orgInfo": {
"fullName": "МОТЫЛЕК",
"inn": "7888359300",
"kpp": "788801001"
},
"rate": "13",
"income": "308923.08",
"tax": "40160",
"files": [
{
"createdOn": 1590473174594,
"updatedOn": 1590473174594,
"file": "PNCk0
TQsNC50Ls+",// полную строку см. в папке «Примеры документов по
типу сведений»
"name": "epgu_2ndfl_20200428_a70844e3-892a-11ea-9715-001a4a1662e8.xml",
"metadata": "application/xml",
"sign": "MIIK/AYJK
bJbSp2xfLC7c="// полную строку см. в папке «Примеры
документов по типу сведений»
},
{
"createdOn": 1590473174594,
"updatedOn": 1590473174594,
"file": "JVBERi0x
rFtWm3WM="// полную строку см. в папке «Примеры документов по
типу сведений»
}
]
}
],
"type": "INCOME_REFERENCE"
},
{
"oid": "1077115523",
"year": "2018",
185
"requestId": 2007021
},
{
"oid": "1077115523",
"id": "69b29ec3-38f6-4132-b1e4-ba5dfd00e1d9",
"version": 1,
"createdOn": 1590473174594,
"updatedOn": 1590473174594,
"receiptDocDate": 1590473174594,
"validateDateDoc": 1590473174578,
"relevance": "actual",
"status": "verified_by_request",
"year": "2017",
"error": "ndflNotFound",
"type": "INCOME_REFERENCE"
}
]
Возможные коды ошибок:
Код HTTP 404:
ESIA-020131= Учетная запись не найдена, либо не предоставлен верифицированный номер
ИНН.
7.2.16 Справка о назначенных пенсиях и социальных выплатах на
дату
Модель документа «Справка о назначенных пенсиях и социальных выплатах на дату» приведена
в следующей таблице:
Таблица 16 - Справка о назначенных пенсиях и социальных выплатах на дату
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
1.
oid
Идентификатор
обязательно
Строка
пользователя
2.
id
Уникальный
обязательно
Строка
идентификатор
документа
3.
status
Статус достоверности
обязательно
Принимает значения:
verified_by_validate
verified_by_request
verified_by_push
unverified
4.
relevance
Релевантность
обязательно
Принимает значения:
документа
actual
expired
186
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
invalid
5.
type
Тип документа
обязательно
Для справки о доходах
и
суммах
налога
физического
лица
принимает
значение
PENSION_REFERENC
E
6.
departmentDoc
Ведомство, к которому
не обязательно
Строка.
принимает
относится документ
значение "ПФР"
7.
receiptDocDate
Дата и время получения
не обязательно
Задается
как
документа в формате
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
8.
validateDateDoc
Дата и время валидации
не обязательно
Задается
как
документа в формате
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
9.
createdOn
Дата и время создания
обязательно
Задается
как
документа
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
10.
updatedOn
Дата
и
время
обязательно
Задается
как
обновления документа
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
11.
files
Массив со справками о
не обязательно
Массив, состоящий из
назначенных пенсиях и
следующих элементов
социальных выплатах в
(п. 11.1. - 11.3)
виде
файлов,
закодированных
в
base64
11.1.
file
Справка о назначенных
не обязательно
Строка
пенсиях и социальных
выплатах (xml или pdf),
187
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
закодированная
в
формате base64
11.2.
name
Наименование файла
не обязательно
Строка
11.3.
metadata
Формат файла
не обязательно
Строка.
Может
принимать следующие
значения:
application/xml
application/pdf
12.
version
Версия документа
обязательно
Целое число
13.
legalForce
Возможность
не обязательно
Логический
тип
проверить подлинность
данных: true - признак
данных, полученных из
положительный, false -
ГИС
(документы
признак отрицательный
подписанные
ЭП
ведомства)
14.
lastName
Фамилия
обязательно
Строка
15.
firstName
Имя
обязательно
Строка
16.
middleName
Отчество
не обязательно
Строка
17.
birthPlace
Место рождения
обязательно
Строка
18.
gender
Половая
обязательно
Принимает значения:
принадлежность
M - мужской пол
F - женский пол
19.
birthDate
Дата рождения
обязательно
Дата
в
формате:
ДД.ММ.ГГГГ
20.
divName
Полное наименование
не обязательно
Строка
территориального
органа
ПФР
в
соответствии
с
учредительными
документами
21.
docDetails
Блок
сведений
о
обязательно
Объект, состоящий из
реквизитах справки
следующих элементов
(п. 21.1. - 21.2)
21.1.
dateDocDetails
дата выдачи справки
обязательно
Строка
21.2
numDocDetails
номер справки
обязательно
Строка
22.
infoDate
Дата,
на
которую
обязательно
Строка
указываются сведения
188
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
об
установленных
выплатах
23.
insPension
Страховая пенсия по
не обязательно
Массив, состоящий из
старости,
по
следующих элементов
инвалидности,
по
(п. 23.1. - 23.4)
случаю
потери
кормильца
23.1.
typePension
Вид страховой пенсии
не обязательно
Целое число
23.2.
periodPension
Дата первоначального
не обязательно
Объект, состоящий из
установления пенсии и
следующих элементов
дата,
по
которую
(п. 23.2.1. - 23.2.2.)
назначена пенсия
23.2.1.
fromPeriodPension
Дата первоначального
не обязательно
Строка
установления пенсии
23.2.2.
toPeriodPension
Дата,
по
которую
не обязательно
Строка
назначена пенсия
23.3.
basicPension
Страховая пенсия по
не обязательно
Массив, состоящий из
статье 15 Федерального
следующих элементов
закона «О страховых
(п. 23.3.1. - 23.3.2.)
пенсиях»
23.3.1.
sumBasPen
Размер
страховой
не обязательно
Число
пенсии
23.3.2.
strBasPen
Сведения об учтенных в
не обязательно
Объект, состоящий из
размере
страховой
следующих элементов
пенсии суммах
(п. 23.3.2.1. - 23.3.2.2.)
23.3.2.1.
typeStrBasPen
Тип учтенной суммы
не обязательно
Целое число
23.3.2.2.
sumStrBasPen
Сумма, учтенная в
не обязательно
Число
размере
страховой
пенсии
23.4
wrkPension
Страховая пенсия по
не обязательно
Массив, состоящий из
статье
26.1 ФЗ «О
следующих элементов
страховых пенсиях»
(п. 23.4.1. - 23.4.2.)
23.4.1.
sumWrkPen
Сумма
страховой
не обязательно
Число
пенсии, в соответствии
со статьей 26.1 ФЗ «О
страховых пенсиях»
189
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
23.4.2.
strWrkPen
Учтенные в размере
не обязательно
Объект, состоящий из
страховой
пенсии
следующих элементов
суммы, в соответствии
(п. 23.4.2.1. - 23.4.2.2.)
со статьей 26.1 ФЗ «О
страховых пенсиях»
23.4.2.1.
typeStrWrkPen
Тип учтенной суммы
не обязательно
Целое число
23.4.2.2.
sumStrWrkPen
Сумма, учтенная в
не обязательно
Число
размере
страховой
пенсии
24.
fixToPension
Сведения
о
не обязательно
Массив, состоящий из
фиксированной
следующих элементов
выплате к страховой
(п. 24.1. - 24.2.)
пенсии
24.1.
fixToBasPen
Сведения
о
не обязательно
Объект, состоящий из
фиксированной
следующих элементов
выплате к страховой
(п. 24.1.1. - 24.1.3.)
пенсии в соответствии
со статьей 16 ФЗ «О
страховых пенсиях»
24.1.1.
typeFixToBasPen
Вид страховой пенсии,
не обязательно
Целое число
по
которому
установлена
фиксированная выплата
24.1.2.
sumFixToBasPen
Размер фиксированной
не обязательно
Число
выплаты
24.1.3.
sumTtlFixToBasPen
Суммарный
размер
не обязательно
Число
фиксированной
выплаты к страховой
пенсии
с
учетом
повышения(ий)
24.2.
fixToWrkPen
Сведения
о
не обязательно
Объект, состоящий из
фиксированной
следующих элементов
выплате к страховой
(п. 24.2.1. - 24.2.3.)
пенсии в соответствии
со статьей 26.1 ФЗ «О
страховых пенсиях»
24.2.1.
typeFixToWrkPen
Вид страховой пенсии,
не обязательно
Целое число
по
которому
190
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
установлена
фиксированная выплата
24.2.2.
sumFixToWrkPen
Размер фиксированной
не обязательно
Число
выплаты
24.2.3.
sumTtlFixToWrkPen
Суммарный
размер
не обязательно
Число
фиксированной
выплаты к страховой
пенсии
с
учетом
повышения(ий)
25.
otherToPen
Иные
выплаты,
не обязательно
Массив, состоящий из
установленные
следующих элементов
гражданину
(п. 25.1. - 25.4.)
25.1.
typeOtherToPen
Наименование
иной
не обязательно
Целое число
выплаты
25.2.
regOtherToPen
Частота
получения
не обязательно
Объект, состоящий из
иной выплаты. (Частота
следующих элементов
получения
выплат
(п. 25.2.1. - 25.2.2.)
может быть ИЛИ в виде
периода ИЛИ в виде
единоразовой выплаты)
25.2.1.
periodOtherToPen
Дата начала и дата
не обязательно
Объект, состоящий из
окончания периода, на
следующих элементов
который установлена
(п. 25.2.1.1. - 25.2.1.2.)
выплата
25.2.1.1.
fromPeriodOtherToPe
Дата начала выплаты
не обязательно
Строка
n
25.2.1.2.
toPeriodOtherToPen
Дата,
по
которую
не обязательно
Строка
назначена выплата
25.2.2.
onceOtherToPen
При указании размера
не обязательно
Логический
тип
выплат,
носящих
данных:
1
-
единовременных
единовременная
выплат, указывается -
выплата,
0
- не
«единовременно»
единовременная
выплата
25.3.
sumOtherToPen
Сумма установленного
не обязательно
Число
размера иных выплат
191
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
25.4.
nsuToPen
Набор
социальных
не обязательно
Объект, состоящий из
услуг
следующих элементов
(п. 25.4.1. - 25.4.5.)
25.4.1.
sumNsuToPen
Сумма полного набора
не обязательно
Число
социальных услуг
25.4.2.
drugNsuToPen
Сумма
социальной
не обязательно
Число
услуги по обеспечению
лекарственными
препаратами
25.4.3.
sanNsuToPen
Сумма
социальной
не обязательно
Число
услуги
по
предоставлению
санаторно-курортного
лечения
25.4.4.
jdNsuToPen
Сумма
социальной
не обязательно
Число
услуги по бесплатному
проезду
на
ж/д
транспорте
25.4.5.
sumRejNsuToPen
Сумма
ежемесячной
не обязательно
Число
денежной выплаты с
учетом волеизъявления
гражданина об отказе
(предоставлении) НСУ
26.
wrkExperience
Периоды работы и иной
не обязательно
Объект, состоящий из
деятельности,
следующих элементов
включенных
в
(п. 26.1.)
страховую пенсию
26.1.
insExperience
Продолжительность
не обязательно
Объект, состоящий из
страхового
стажа,
следующих элементов
учтенного
при
(п. 26.1.1. - 26.1.3.)
установлении
страховой пенсии
26.1.1.
totalInsExp
Общая
не обязательно
Объект, состоящий из
продолжительность
следующих элементов
страхового
стажа,
(п. 26.1.1.1. - 26.1.1.3.)
учтенного
при
установлении
страховой пенсии
192
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
26.1.1.1.
yearsInsExperience
Количество
лет
не обязательно
Целое число
страхового
стажа,
учтенного
при
установлении
страховой пенсии
26.1.1.2.
monthsInsExperience
Количество
месяцев
не обязательно
Целое число
страхового
стажа,
учтенного
при
установлении
страховой пенсии
26.1.1.3.
daysInsExperience
Количество
дней
не обязательно
Целое число
страхового
стажа,
учтенного
при
установлении
страховой пенсии
26.1.2.
farNorth
Общая
не обязательно
Объект, состоящий из
продолжительность
следующих элементов
периодов работы в
(п. 26.1.2.1. - 26.1.2.3.)
районах
Крайнего
Севера, учтенных при
установлении
страховой пенсии
26.1.2.1.
yearsFarNorth
Количество лет работы
не обязательно
Целое число
в районах Крайнего
Севера, учтенных при
установлении
страховой пенсии
26.1.2.2.
monthsFarNorth
Количество
месяцев
не обязательно
Целое число
работы
в
районах
Крайнего
Севера,
учтенных
при
установлении
страховой пенсии
26.1.2.3.
daysFarNorth
Количество
дней
не обязательно
Целое число
работы
в
районах
Крайнего
Севера,
учтенных
при
193
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
установлении
страховой пенсии
26.1.3.
equalFarNorth
Общая
не обязательно
Объект, состоящий из
продолжительность
следующих элементов
периодов работы в
(п. 26.1.3.1. - 26.1.3.3.)
местностях,
приравненных
к
районам
Крайнего
Севера, учтенных при
установлении
страховой пенсии
26.1.3.1.
yearsEqualFarNorth
Количество лет работы
не обязательно
Целое число
в
местностях,
приравненных
к
районам
Крайнего
Севера, учтенных при
установлении
страховой пенсии
26.1.3.2.
monthsEqualFarNorth
Количество
месяцев
не обязательно
Целое число
работы в местностях,
приравненных
к
районам
Крайнего
Севера, учтенных при
установлении
страховой пенсии
26.1.3.3.
daysEqualFarNorth
Количество
дней
не обязательно
Целое число
работы в местностях,
приравненных
к
районам
Крайнего
Севера, учтенных при
установлении
страховой пенсии
27.
holdPension
Информация
об
не обязательно
Массив, состоящий из
удержаниях,
следующих элементов
производимых
из
(п. 27.1. - 27.4.)
пенсии
и
иных
социальных выплат
194
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
27.1.
typeHoldPens
Вид пенсии и (или)
не обязательно
Целое число
иной
социальной
выплаты, из которой
производится
удержание
27.2.
sumHoldPens
Сумма, удержанная из
не обязательно
Число
выплаты,
на
дату
заполнения справки
27.3.
volHoldPens
Объем
удержания,
не обязательно
Объект, состоящий из
указывается либо
%
следующих элементов
удержания,
либо
(п. 27.3.1. - 27.3.2.)
отметка "удержание в
твердом размере"
27.3.1.
percHoldPens
Процент удержания
не обязательно
Целое число
27.3.2.
fixHoldPens
Удержание в твердом
не обязательно
Логический
тип
размере
данных:
1
- есть
удержание в твердом
размере,
0
- нет
удержания в твердом
размере
27.4.
basisHoldPens
Исполнительный
не обязательно
Строка
документ
или
соответствующее
решение
территориального
органа
Пенсионного
фонда
Российской
Федерации,
на
основании
которого
производится
удержание
Пример ответа на запрос справки о назначенных пенсиях и социальных выплатах:
195
{
"oid": "1077118428",
"id": "e794001d-834c-4d84-b80a-5aefa058c7eb",
"version": 3,
"createdOn": 1594314989576,
"updatedOn": 1594315339491,
"receiptDocDate": 1594315339438,
"validateDateDoc": 1594315339438,
"relevance": "actual",
"status": "verified_by_request",
"legalForce": true,
"lastName": "Шевцова",
"firstName": "Дарья",
"middleName": "Васильевна",
"birthPlace": "11",
"gender": "F",
"birthDate": "20.03.1989",
"departmentDoc": "Пенсионный фонд России",
"files": [
{
"file": "JVBERi
x1jgLF1bG",// полную строку см. в папке «Примеры документов по типу
сведений»
"name": "PENSION_REFERENCE_PDF.pdf",
"metadata": "application/pdf"
},
{
"file": "PD94bWw
J3QvtC80LX",// полную строку см. в папке «Примеры документов по типу
сведений»
"name": "PENSION_REFERENCE_XML.xml",
"metadata": "application/xml"
}
],
"divName": "МИЦ ПФР",
"docDetails": {
"dateDocDetails": "13.05.2020",
"numDocDetails": "22-05-20-0000941620"
},
"infoDate": "10.05.2020",
"insPension": {
"typePension": 1,
"periodPension": {
"fromPeriodPension": "23.12.2018",
"toPeriodPension": "бессрочно"
},
"basicPension": {
"sumBasPen": 10343.55,
"strBasPen": [
{
"typeStrBasPen": 1,
"sumStrBasPen": 362.24
},
{
196
"typeStrBasPen": 2,
"sumStrBasPen": 0
}
]
},
"wrkPension": {
"sumWrkPen": 9063.4,
"strWrkPen": [
{
"typeStrWrkPen": 1,
"sumStrWrkPen": 317.4
},
{
"typeStrWrkPen": 2,
"sumStrWrkPen": 0
}
]
}
},
"fixToPension": {
"fixToBasPen": {
"typeFixToBasPen": 1,
"sumFixToBasPen": 5686.25
},
"fixToWrkPen": {
"typeFixToWrkPen": 1,
"sumFixToWrkPen": 4982.9
}
},
"otherToPen": [
{
"typeOtherToPen": 1,
"sumOtherToPen": 10343.55,
"regOtherToPen": {
"periodOtherToPen": {
"fromPeriodOtherToPen": "23.12.2018",
"toPeriodOtherToPen": "бессрочно"
}
},
"nsuToPen": {
"drugNsuToPen": 10343.55,
"sanNsuToPen": 10343.55,
"jdNsuToPen": 10343.55,
"sumRejNsuToPen": 10343.55
}
}
],
"wrkExperience": {
"insExperience": {
"totalInsExp": {
"yearsInsExperience": 35,
"monthsInsExperience": 2,
197
"daysInsExperience": 13
},
"farNorth": {
"yearsFarNorth": 0,
"monthsFarNorth": 11,
"daysFarNorth": 0
},
"equalFarNorth": {
"yearsEqualFarNorth": 0,
"monthsEqualFarNorth": 11,
"daysEqualFarNorth": 0
}
}
},
"holdPension": [
{
"typeHoldPens": 2,
"basisHoldPens": "Федеральный закон от 28.12.2013 № 400-ФЗ «О страховых пенсиях»",
"sumHoldPens": 10341.55,
"volHoldPens": {
"percHoldPens": 20.0
}
}
],
"type": "PENSION_REFERENCE"
}
7.2.17 Сведения о трудовой деятельности застрахованного лица в
системе обязательного пенсионного страхования
Модель документа «Сведения о трудовой деятельности застрахованного лица в системе
обязательного пенсионного страхования» приведена в следующей таблице:
Таблица 17 - Сведения о трудовой деятельности застрахованного лица в системе обязательного
пенсионного страхования
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
1.
oid
Идентификатор
обязательно
Строка
пользователя
2.
id
Уникальный
обязательно
Строка
идентификатор
документа
3.
status
Статус достоверности
обязательно
Принимает значения:
verified_by_validate
verified_by_request
verified_by_push
198
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
unverified
4.
relevance
Релевантность
обязательно
Принимает значения:
документа
actual
expired
invalid
5.
type
Тип документа
обязательно
Для справки о доходах
и
суммах
налога
физического
лица
принимает
значение
ELECTRONIC_WORK
BOOK
6.
departmentDoc
Ведомство, к которому
не обязательно
Строка.
принимает
относится документ
значение "ПФР"
7.
version
Версия документа
обязательно
Принимает
значение
"1"
8.
receiptDocDate
Дата и время получения
не обязательно
Задается
как
документа в формате
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
9.
validateDateDoc
Дата и время валидации
не обязательно
Задается
как
документа в формате
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
10.
createdOn
Дата и время создания
обязательно
Задается
как
документа
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
11.
updatedOn
Дата
и
время
обязательно
Задается
как
обновления документа
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970 года
12.
statement
Блок
сведений
о
не обязательно
Объект, состоящий из
заявлении
следующих элементов
(п. 12.1. - 12.2)
199
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
12.1.
continuationDate
Дата подачи заявления
не обязательно
Дата
в
формате:
о продолжении ведения
ДД.ММ.ГГГГ
работодателем
трудовой книжки в
соответствии со статьей
66 ТК РФ
12.2.
provisionDate
Дата подачи заявления
не обязательно
Дата
в
формате:
о
предоставлении
ДД.ММ.ГГГГ
работнику
работодателем
сведений о трудовой
деятельности
в
соответствии со статьей
66(1) ТК РФ
13.
events
Массив, содержащий
не обязательно
Объект, состоящий из
сведения
о
следующих элементов
мероприятии кадрового
(п. 13.1. - 13.3)
учета
13.1.
organization
Блок
сведений
о
обязательно
Объект, состоящий из
страхователе,
следующих элементов
предоставившем
(п. 13.1.1. - 13.1.4)
сведения о трудовой
деятельности
на
зарегистрированное
лицо
13.1.1.
orgName
Наименование
обязательно
Строка
организации
13.1.2.
regNumber
Регистрационный
обязательно
Строка
номер в ПФР
13.1.3.
inn
ИНН работодателя
обязательно
Строка
13.1.4.
kpp
КПП работодателя
не обязательно
Строка
13.2.
uuid
UUID мероприятия
обязательно
Строка
13.3.
date
Дата
проведения
обязательно
Дата
в
формате:
мероприятия
ДД.ММ.ГГГГ
13.4.
type
Вид мероприятия
обязательно
Возможные значения:
1 - Прием;
2 - Перевод;
3 - Переименование;
200
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
4
-
Установление
(присвоение);
5 - Увольнение;
6
- Запрет занимать
должность
(вид
деятельности)
13.5.
information
Иные
сведения
о
не обязательно
Строка
мероприятии
13.6.
position
Должность
не обязательно
Строка
13.7.
isPartTimeJob
Признак работы по
не обязательно
Возможные значения:
совместительству
1
- да, является
совместителем;
0
- нет, не является
совместителем.
Отсутствие элемента
соответствует «нет».
13.8.
division
Подразделение
не обязательно
Строка
13.9.
jobType
Конкретный
вид
не обязательно
Строка
поручаемой работы
13.10.
functionType
Код
выполняемой
не обязательно
Строка
функции
13.11.
item
Номер
статьи
не обязательно
Строка
Трудового кодекса
13.12.
paragraph
Пункт
статьи
не обязательно
Строка
Трудового кодекса
13.13.
dismissalBasis
Нормативная
база
не обязательно
Объект, состоящий из
увольнения
следующих элементов
(п. 13.2.12.1 - 13.2.12.6)
13.13.1.
type
Тип
основания
не обязательно
Строка,
может
увольнения
содержать одно из
значений:
- ТК РФ
- ИНОЕ
13.13.2.
normativeDocument
Наименование
не обязательно
Строка
нормативного
документа
13.13.3.
basisItem
Номер
статьи
не обязательно
Строка
Федерального закона
201
№
Код поля
Описание поля
Требования
к
Комментарий
заполнению
13.13.4.
basisPart
Номер части статьи
не обязательно
Строка
Федерального закона
13.13.5.
basisParagraph
Номер
пункта
из
не обязательно
Строка
нормативного
документа
13.13.6.
basisSubparagraph
Номер подпункта из
не обязательно
Строка
нормативного
документа
13.14.
dismissalReason
Причина увольнения
не обязательно
Строка
13.15.
dateBegin
Дата начала
не обязательно
Дата
в
формате:
ДД.ММ.ГГГГ
13.16.
dateEnd
Дата окончания
не обязательно
Дата
в
формате:
ДД.ММ.ГГГГ
13.17.
reason
Сведения о документе-
обязательно
Объект, состоящий из
основании
для
следующих элементов
мероприятия. Может
(п. 13.2.16.1 - 13.2.16.4)
быть один или два
блока
13.17.1.
document
Наименование
обязательно
Строка
документа-основания.
13.17.2.
date
Дата документа "ОТ"
обязательно
Дата
в
формате:
ДД.ММ.ГГГГ
13.17.3.
number
Номер документа
обязательно
13.17.4.
series
Серия документа
не обязательно
14.
cancelDate
Дата
отмены
не обязательно
Дата
в
формате:
мероприятия
ДД.ММ.ГГГГ
15.
xmlFile
Сведения о трудовой
не обязательно
Строка
деятельности
(xml),
закодированная
в
формает base64
15.1.
file
файл в формате base64
не обязательно
Строка
16.
pdfFile
Сведения о трудовой
не обязательно
Строка
деятельности
(pdf),
закодированная
в
формает base64
16.1.
file
файл в формате base64
не обязательно
Строка
Пример ответа на запрос выписки о трудовой деятельности застрахованного лица:
202
{
"oid":"1077121111",
"id":"27724248-802c-44ee-81a4-a32b269b7ad8",
"version":1,
"createdOn":1595506946801,
"updatedOn":1595506946801,
"receiptDocDate":1595506946801,
"validateDateDoc":1594935252974,
"relevance":"actual",
"status":"verified_by_request",
"departmentDoc":"Пенсионный фонд России",
"statement":{
"continuationDate":"12.11.2019",
"provisionDate":"12.11.2019"
},
"events":[
{
"organization":{
"orgName":"ООО \"ЫВАЫВА\"",
"regNumber":"087-701-070356",
"inn":"1111111111",
"kpp":"222222222"
},
"uuid":"e17а29e4-2660-4ed5-b2e5-28127e95497e",
"date":"12.11.2019",
"type":1,
"position":"вфывфывфы фывфывфвфы",
"isPartTimeJob":false,
"division":"ываыавыа",
"reason":[
{
"document":"Приказ",
"date":"12.11.2019",
"number":"00"
}
]
},
{
"organization":{
"orgName":"ООО \"ВФВФЫВФ\"",
"regNumber":"087-701-070356",
"inn":"1111111111",
"kpp":"222222222"
},
"uuid":"40a75a25-769b-4620-920d-e4f75e271847",
"date":"24.03.2020",
"type":5,
"isPartTimeJob":false,
"dismissalBasis":{
"normativeDocument":"Трудовой кодекс Российской Федерации",
"basisItem":"77",
203
"basisPart":"1",
"basisParagraph":"3"
},
"dismissalReason":"Расторжение трудового договора по инициативе работника, Трудовой кодекс
Российской Федерации ст.77 ч.1 п.3",
"reason":[
{
"document":"Приказ",
"date":"24.03.2020",
"number":"000"
}
]
},
{
"organization":{
"orgName":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ВАПВАПВАПВА\"",
"regNumber":"088-012-065022",
"inn":"9999999999",
"kpp":"999999999"
},
"uuid":"f830ba95-46aa-4b48-a30a-61ac914e6418",
"date":"02.07.2020",
"type":1,
"position":"ФВФЫВФ ФВФЫВЫА ЫВАЫВ ЫВАЫВА",
"isPartTimeJob":false,
"division":"Мобильная группа",
"reason":[
{
"document":"Приказ",
"date":"02.07.2020",
"number":"О_000/00-О"
}
]
},
{
"organization":{
"orgName":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ЫАЫВЫАЫВАЫВА\"",
"regNumber":"088-012-065022",
"inn":"9999999999",
"kpp":"999999999"
},
"uuid":"71452f84-b44a-403d-a0b2-963d4aaea28e",
"date":"06.07.2020",
"type":5,
"isPartTimeJob":false,
"dismissalBasis":{
"normativeDocument":"Трудовой кодекс Российской Федерации",
"basisItem":"77",
"basisPart":"1",
"basisParagraph":"3"
},
"dismissalReason":"Расторжение трудового договора по инициативе работника",
204
"reason":[
{
"document":"Приказ",
"date":"06.07.2020",
"number":"А_111/10-А"
}
]
}
],
"xmlFile":{
"file":"PD94bW
TGpRdUlJ" // полную строку см. в папке «Примеры документов по типу сведений»
},
"pdfFile":{
"file":"QvNC1
KzBMelJn" // полную строку см. в папке «Примеры документов по типу сведений»
},
"type":"ELECTRONIC_WORKBOOK"
}
205
7.2.18 Сведения о назначенных и реализованных мерах социальной
защиты (поддержки)
Модель документа «Сведения о назначенных и реализованных мерах социальной защиты
(поддержки)» приведена в следующей таблице:
Таблица 18 - Сведения из Единой государственной информационной системы социального
обеспечения (ЕГИССО) о назначенных и реализованных мерах социальной защиты
(поддержки)
№
Код поля
Описание поля
Требования к заполнению
Комментарий
Oid
Идентификатор
обязательно
Строка
1.
пользователя
Id
Уникальный
обязательно
Строка
2.
идентификатор
документа
Status
Статус достоверности
обязательно
Принимает значения:
3.
verified_by_validate
verified_by_request
verified_by_push
unverified
Relevance
Релевантность
обязательно
Принимает значения:
4.
документа
actual
expired
invalid
Type
Тип документа
обязательно
Принимает значение
5.
PAYMENTS_EGISSO
departmentDoc
Ведомство, к которому
обязательно
Принимает значение
6.
относится документ
"ПФР"
Version
Версия документа
обязательно в случае
Принимает значение
7.
отсутствия ошибки
"1"
receiptDocDate
Дата и время получения
обязательно в случае
Задается как
8.
документа в формате
отсутствия ошибки
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
validateDateDoc
Дата и время валидации
обязательно в случае
Задается как
9.
документа в формате
отсутствия ошибки
количество
timestamp
миллисекунд,
прошедших с 00:00:00
206
№
Код поля
Описание поля
Требования к заполнению
Комментарий
UTC 1 января 1970
года
createdOn
Дата и время создания
обязательно в случае
Задается как
10.
документа в формате
отсутствия ошибки
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
updatedOn
Дата и время
обязательно в случае
Задается как
11.
обновления документа в
отсутствия ошибки
количество
формате timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
statementData
Блок сведений выписки
обязательно в случае
Объект, состоящий из
12.
о мерах социальной
отсутствия ошибки
следующих элементов
поддержки (защиты)
(п. 12.1 - 12.5)
Snils
СНИЛС
обязательно
Целое число
12.1.
assignments
Сведения о фактах
обязательно, если приходит
Массив, состоящий из
12.2.
назначения
параметр уровнем выше
следующих элементов
(п. 12.2.1 - 12.2.18)
familyName
Фамилия получателя
обязательно, если приходит
Строка
12.2.1.
параметр уровнем выше
firstName
Имя получателя
обязательно, если приходит
Строка
12.2.2.
параметр уровнем выше
birthDate
Дата рождения
обязательно, если приходит
Строка
12.2.3.
получателя
параметр уровнем выше
kmszCode
Код по КМСЗ
обязательно, если приходит
Строка
12.2.4.
параметр уровнем выше
onmszTitle
Наименование ОНМСЗ,
обязательно, если приходит
Строка
12.2.5.
осуществившего
параметр уровнем выше
назначение МСЗ
onmszCode
Код ОНМСЗ,
обязательно, если приходит
Строка
12.2.6.
осуществившего
параметр уровнем выше
назначение МСЗ
lmszTitle
Наименование
обязательно, если приходит
Строка
12.2.7.
назначенной МСЗ
параметр уровнем выше
207
№
Код поля
Описание поля
Требования к заполнению
Комментарий
categoryTitle
Наименование
обязательно, если приходит
Строка
12.2.8.
присвоенной локальной
параметр уровнем выше
категории
decisionDate
Дата принятия решения
обязательно, если приходит
Строка
12.2.9.
о назначении
параметр уровнем выше
dateStart
Дата начала действия
обязательно, если приходит
Строка
12.2.10.
назначения
параметр уровнем выше
Comment
Примечание
не обязательно
Строка
12.2.11.
Form
Содержание назначения
обязательно, если приходит
Строка
12.2.12.
параметр уровнем выше
periodicity
Код периодичности
обязательно, если приходит
Строка
12.2.13.
предоставления
параметр уровнем выше
Amount
Сумма назначения
обязательно, если приходит
Целое число
12.2.14.
параметр уровнем выше
measureUnit
Код единицы измерения
обязательно, если приходит
Строка
12.2.15.
размера назначения
параметр уровнем выше
needCriterion
Признак использования
обязательно, если приходит
Логический тип
12.2.16.
критериев нуждаемости
параметр уровнем выше
данных: 1 - признак
положительный, 0 -
признак
отрицательный
npaList
Список нормативно-
не обязательно
Массив, состоящий из
12.2.17.
правовых актов
следующих элементов
назначенной меры
(п. 12.2.17.1 -
12.2.17.3)
npaDate
Дата принятия
обязательно, если приходит
Строка
12.2.17.1.
нормативно-правового
параметр уровнем выше
акта
npaNumber
Номер нормативно-
обязательно, если приходит
Строка
12.2.17.2.
правового акта
параметр уровнем выше
npaName
Наименование
обязательно, если приходит
Строка
12.2.17.3.
нормативно-правового
параметр уровнем выше
акта
rightsDocuments
Документы, дающие
не обязательно
Массив, состоящий из
12.2.18.
право на реализацию
следующих элементов
меры
(п. 12.12.18.1 -
12.2.18.7)
issueDate
Дата выдачи документа
обязательно, если приходит
Строка
12.2.18.1.
параметр уровнем выше
208
№
Код поля
Описание поля
Требования к заполнению
Комментарий
startDate
Дата начала действия
обязательно, если приходит
Строка
12.2.18.2.
документа
параметр уровнем выше
finishDate
Дата окончания
не обязательно
Строка
12.2.18.3.
действия документа
Series
Серия документа
не обязательно
Строка
12.2.18.4.
Number
Номер документа
не обязательно
Строка
12.2.18.5.
Title
Наименование
обязательно, если приходит
Строка
12.2.18.6.
документа
параметр уровнем выше
Authority
Организация, выдавшая
обязательно, если приходит
Строка
12.2.18.7.
документ
параметр уровнем выше
Obligations
Сведения о бюджетных
не обязательно
Массив, состоящий из
12.3.
обязательстваx для
следующих элементов
указанного СНИЛС
(п. 12.3.1 - 12.3.10)
kmszCode
Код по КМСЗ
обязательно, если приходит
Строка
12.3.1.
параметр уровнем выше
onmszTitle
Наименование ОНМСЗ,
обязательно, если приходит
Строка
12.3.2.
осуществившего
параметр уровнем выше
назначение МСЗ
lmszTitle
Наименование
обязательно, если приходит
Строка
12.3.3.
назначенной МСЗ
параметр уровнем выше
categoryTitle
Наименование
обязательно, если приходит
Строка
12.3.4.
категории получателя
параметр уровнем выше
МСЗ
periodicity
Код периодичности
обязательно, если приходит
Строка
12.3.5.
предоставления
параметр уровнем выше
Amount
Сумма назначения
обязательно, если приходит
Десятичное число
12.3.6.
параметр уровнем выше
decisionDate
Дата принятия решения
обязательно, если приходит
Строка
12.3.7.
о назначении
параметр уровнем выше
dateStart
Дата начала действия
обязательно, если приходит
Строка
12.3.8.
назначения
параметр уровнем выше
dateFinish
Дата окончания
не обязательно
Строка
12.3.9.
действия назначения
Payments
Обязательства по
не обязательно
Массив, состоящий из
12.3.10.
месяцам
следующих элементов
(п. 12.3.10.1 -
12.3.10.3)
Year
Год
обязательно, если приходит
Год в формате: xxxx
12.3.10.1.
параметр уровнем выше
(где x - символы
209
№
Код поля
Описание поля
Требования к заполнению
Комментарий
десятичных цифр
0…9)
Month
Месяц (Январь = 1)
обязательно, если приходит
Целое число от 1 до 12
12.3.10.2.
параметр уровнем выше
Amount
Сумма обязательств в
обязательно, если приходит
Десятичное число
12.3.10.3.
указанный месяц
параметр уровнем выше
Assignees
Сведения о выплатах,
не обязательно
Массив, состоящий из
12.4.
полученных в качестве
следующих элементов
правопреемника
(п. 12.4.1 - 12.4.4)
Snils
СНИЛС умершего (без
обязательно, если приходит
Строка
12.4.1.
контрольной суммы)
параметр уровнем выше
decisionNumber
Номер решения
обязательно, если приходит
Строка
12.4.2.
параметр уровнем выше
decisionDate
Дата решения о выплате
обязательно, если приходит
Строка
12.4.3.
параметр уровнем выше
assignAmount
Сумма выплаты
обязательно, если приходит
Десятичное число
12.4.4.
параметр уровнем выше
Incomes
Сведения о доходах по
не обязательно
Массив, состоящий из
12.5.
месяцам
следующих элементов
(п. 12.5.1 - 12.5.5)
Year
Год
обязательно, если приходит
Год в формате: xxxx
12.5.1.
параметр уровнем выше
(где x - символы
десятичных цифр
0…9)
Month
Месяц (Январь = 1)
обязательно, если приходит
Целое число от 1 до 12
12.5.2.
параметр уровнем выше
Amount
Итоговая сумма выплат
обязательно, если приходит
Десятичное число
12.5.3.
и иных вознаграждений
параметр уровнем выше
за Период
insureDeposit
Из них сумма выплат и
обязательно, если приходит
Десятичное число
12.5.4.
иных вознаграждений,
параметр уровнем выше
на которые были
начислены страховые
взносы
organization
Наименование
обязательно, если приходит
Строка
12.5.5.
организации
параметр уровнем выше
nameDoc
Наименование
не обязательно
Строка
13.
документа
210
№
Код поля
Описание поля
Требования к заполнению
Комментарий
pdfFile
Выписка из ЕГИССО в
не обязательно
Строка
14.
формате PDF,
закодированная в
BASE64
Error
Информация об ошибке,
не обязательно
Строка
15.
отображается
определенное
количество
дней
в
случае, если произошла
ошибка при получении
данных,
при
этом
предыдущие сведения
не
затираются
и
отображаются.
Если в ответе имеется
указанное
поле,
полученные
данные
принято считать не
актуальными.
errorUpdatedOn
Дата последнего ответа
не обязательно
Целое число
16.
с
ошибкой
(метка
времени
в
unixtimestamp).
Если в ответе имеется
указанное
поле,
полученные
данные
принято считать не
актуальными.
Пример ответа на запрос выписки о назначенных и реализованных мерах социальной защиты
(поддержки):
211
{
"oid": "10031415",
"id": "91899952b06c4cc89746d38b2c8c72f3",
"receiptDocDate": "1574237502",
"validateDateDoc": "1574237613",
"type": "PAYMENTS_EGISSO",
"status": "verified_by_validate",
"relevance": "actual",
"departmentDoc": "Пенсионный фонд России",
"version": "1",
"createdOn": "1576067088085",
"updatedOn": "1576067088085",
"statementData": {
"snils": 7704407589,
"assignments": [
{
"familyName": "Иванов",
"firstName": "Иван",
"birthDate": "43525",
"kmszCode": "0444.07000029.01.0010.01.030701",
"onmszTitle": "управление социальной защиты населения по Егорьевскому району",
"onmszCode": "0036.000006",
"lmszTitle": "Ежемесячная денежная выплата при рождении 3 ребенка или последующих детей до
достижения ребенком возраста 3-х лет",
"categoryTitle": "Женщины, родившие (усыновившие) третьего, либо последующего ребенка",
"decisionDate": "43542",
"dateStarе": "43909",
"comment": "примечание",
"form": "содержание назначения",
"periodicity": "01",
"amount": 1000,
"measureUnit": "01",
"needCriterion": false,
"npaList": [
{
"npaDate": "11.06.2014",
"npaNumber": "80",
"npaName": "Об утверждении Положения о назначении и выплате ежемесячной денежной выплаты
при рождении третьего"
}
],
"rightsDocuments": [
{
"issueDate": "19.03.2019",
"startDate": "19.04.2020",
"finishDate": "19.04.2020",
"series": "А",
"number": "12",
"title": "Название документа",
"authority": "Организация выдавшая документ"
}
]
212
}
],
"Obligations": [
{
"kmszCode": "0101.01000001.01.0100.03.010101",
"onmszTitle": "Наименование ОНМСЗ, осуществившего назначение МСЗ",
"lmszTitle": "Льгота 1",
"categoryTitle": "Льгота на проезд",
"periodicity": "1",
"amount": 500,
"decisionDate": "20.02.2019",
"dateStart": "20.03.2020",
"dateFinish": "20.03.2023",
"payments": [
{
"year": 2020,
"month": 1,
"amount": 500
}
]
}
],
"Assignees": [
{
"snils": "463783878",
"decisionNumber": "12",
"decisionDate": "20.03.2020",
"assignAmount": 2000000
}
],
"Incomes": [
{
"year": 2020,
"month": 2,
"amount": "200000.0,",
"insureDeposit": "100000.0,",
"organization": "ООО Профиль"
}
]
},
"nameDoc": "Выписка из ЕГИССО",
"pdfFile": "UEsDBBQ
stAAAAAA=="
// полную строку см. в папке «Примеры документов по типу
сведений»
}
Пример ответа при отправке запроса в ПФР на получение выписки о назначенных и
реализованных мерах социальной защиты (поддержки):
213
{
"oid":"1077139485",
"requestId":"2555860"
}
Список возможных ошибок:
Таблица 19 Перечень возможных ошибок
Код ошибки для поля “error”
Описание ошибки
Комментарий
MksRequestErrorEnum.pfr.payments.egisso.no.permissions
Отсутствие согласия
Требуется
получить
согласие у пользователя
no_data
В ведомстве отстуствуют
данные по пользователю
MksRequestErrorEnum.pfr.payments.egisso.request.failed
При ошибке запроса
Запросить
сведения
сведений в СМЭВ
позже или обратиться в
поддержку
Пример ответа при получении ошибки в процессе запроса выписки о назначенных и
реализованных мерах социальной защиты (поддержки):
{
"oid": "1077131562",
"id": "6b02c96a-d896-4ead-88fd-adab8841afc0",
"version": 1,
"createdOn": 1615822141002,
"updatedOn": 1615822141002,
"receiptDocDate": 1615822141002,
"relevance": "actual",
"departmentDoc": "Пенсионный фонд России",
"error": "MksRequestErrorEnum.pfr.payments.egisso.request.failed",
"errorUpdatedOn": 1615822140985,
"type": "PAYMENTS_EGISSO"
}
Пример ответа при получении ошибки в процессе обновления выписки о назначенных и
реализованных мерах социальной защиты (поддержки):
214
{
"oid":"1077139485",
"id":"a8cdc89b-5f63-4445-b785-c586fd771e99",
"version":1,
"createdOn":1629204819957,
"updatedOn":1629204819957,
"receiptDocDate":1629204819957,
"validateDateDoc":1629204455810,
"relevance":"actual",
"status":"verified_by_request",
"departmentDoc":"Пенсионный фонд России",
"statementData":{
"snils":"11737784886",
"assignments":[
{
"familyName":"Иванов",
"firstName":"Иван",
"birthDate":"01.03.2019",
"kmszCode":"02",
"onmszTitle":"управление социальной защиты населения по Егорьевскому району",
"onmszCode":"0036.000006",
"lmszTitle":"Ежемесячная денежная выплата при рождении 3 ребенка или последующих детей до
достижения ребенком возраста 3-х лет",
"categoryTitle":"Женщины, родившие (усыновившие) третьего, либо последующего ребенка",
"decisionDate":"18.03.2019",
"dateStart":"19.03.2019",
"form":"01",
"periodicity":"01",
"amount":2000.0,
"measureUnit":"01",
"needCriterion":false,
"npaList":[
{
"npaDate":"11.06.2014",
"npaNumber":"80",
"npaName":"Об утверждении Положения о назначении и выплате ежемесячной денежной
выплаты при рождении третьего"
}
]
},
{
"familyName":"Иванов",
"firstName":"Иван",
"birthDate":"04.03.2019",
"onmszTitle":"управление социальной защиты населения по Локтевскому району",
"onmszCode":"0036.000002",
"lmszTitle":"Компенсация расходов оплаты по услуге техобслуживание ГО",
"categoryTitle":"Труженник тыла(раб.в тылу 22.06.41 - 09.05.45 не менее 6мес.)",
"decisionDate":"18.03.2019",
"dateStart":"20.03.2019",
"form":"01",
"periodicity":"05",
215
"amount":100.0,
"measureUnit":"01",
"needCriterion":false,
"npaList":[
{
"npaDate":"03.12.2004",
"npaNumber":"61-ЗС",
"npaName":"О мерах социальной поддержки отдельных категорий ветеранов"
}
]
}
],
"obligations":[
{
"onmszTitle":"Наименование ОСЗ, осуществившего назначение МСЗ",
"lmszTitle":"Льгота 1",
"categoryTitle":"Льгота на проезд",
"periodicity":"01",
"amount":500.0,
"decisionDate":"20.02.2019",
"dateStart":"20.03.2020",
"dateFinish":"20.03.2023",
"payments":[
{
"year":2020,
"month":1,
"amount":500.0
}
]
}
]
},
"nameDoc":"Выписка из ЕГИССО",
"error":"MksRequestErrorEnum.pfr.payments.egisso.request.failed",
"errorUpdatedOn":1629204820056,
"type":"PAYMENTS_EGISSO"
}
216
7.2.19 Сведения об инвалидности гражданина
Модель документа «Сведения об инвалидности гражданина» приведена в следующей таблице:
Таблица 20 - Сведения об инвалидности гражданина
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
oid
Идентификатор
обязательно
Строка
1.
пользователя
id
Уникальный
обязательно
Строка
2.
идентификатор
документа
status
Статус достоверности
обязательно
Принимает значения:
3.
verified_by_validate
verified_by_request
verified_by_push
unverified
relevance
Релевантность
обязательно
Принимает значения:
4.
документа
actual
expired
invalid
type
Тип документа
обязательно
Принимает значение
5.
DISABLED_PERSON
departmentDoc
Ведомство, к
обязательно
Принимает значение
6.
которому относится
"ПФР"
документ
version
Версия документа
обязательно в случае
Принимает значение
7.
отсутствия ошибки
"1"
receiptDocDate
Дата и время
обязательно в случае
Задается как
8.
получения документа
отсутствия ошибки
количество
в формате timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
validateDateDoc
Дата и время
обязательно в случае
Задается как
9.
валидации документа
отсутствия ошибки
количество
в формате timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
217
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
createdOn
Дата и время
обязательно
Задается как
10.
создания документа в
количество
формате timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
updatedOn
Дата и время
обязательно
Задается как
11.
обновления
количество
документа в формате
миллисекунд,
timestamp
прошедших с 00:00:00
UTC 1 января 1970
года
xmlFile
Выписка сведений об
обязательно в случае
Строка, содержащая
12.
инвалиде в xml,
отсутствия ошибки
закодированый в
закодированная в
формате base64 файл
формате base64
nameDoc
Наименование
обязательно в случае
Строка
13.
документа
отсутствия ошибки
extractionFRI
Блок сведений
обязательно в случае
Объект, состоящий из
14.
выписки из ФГИС
отсутствия ошибки
следующих элементов
ФРИ
(п. 14.1 - 14.5)
extractionID
Идентификатор
обязательно
Строка
14.1.
выписки
typeExtraction
Тип выписки
обязательно
Строка
14.2.
createdAt
Время формирования
обязательно
Целое число
14.3.
(метка времени в
unixtimestamp)
consumer
Потребитель
обязательно
Строка
14.4.
personData
Актуальные сведения
обязательно
Объект, состоящий из
14.5.
об инвалидности,
следующих элементов
блок содержит
(п. 14.5.1 - 14.5.8)
данные об
инвалидности
гражданина,
полученные в
результате обработки
и сверки данных от
поставщиков
218
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
сведений (в частности
ПФР и МСЭ)
snils
СНИЛС
обязательно
Строка
14.5.1.
lastName
Фамилия
обязательно
Строка
14.5.2.
firstName
Имя
обязательно
Строка
14.5.3.
middleName
Отчество
не обязательно
Строка
14.5.4.
birthday
Дата рождения (метка
обязательно
Целое число
14.5.5.
времени в
unixtimestamp)
gender
Пол
обязательно
Строка
14.5.6.
regDate
Дата регистрации
обязательно
Целое число
14.5.7.
(метка времени в
unixtimestamp)
disabledPerson
Актуальные сведения
обязательно
Объект, состоящий из
14.5.8.
об инвалидности
следующих элементов
(п. 14.5.8.1 - 14.5.8.15)
dateFrom
Дата с (метка времени
обязательно
Целое число
14.5.8.1.
в unixtimestamp)
dateTo
Дата по (метка
обязательно
Целое число
14.5.8.2.
времени в
unixtimestamp)
numberActMSE
Номер акта МСЭ
обязательно
Строка
14.5.8.3.
dateActMSE
Дата акта МСЭ
обязательно
Целое число
14.5.8.4.
(метка времени в
unixtimestamp)
serCertificateMSE
Серия справки МСЭ
обязательно
Строка
14.5.8.5.
numCertificateMSE
Номер справки МСЭ
обязательно
Строка
14.5.8.6.
dateCertificateMSE
Дата справки МСЭ
обязательно
Целое число
14.5.8.7.
(метка времени в
unixtimestamp)
primaryDisablement
Признак первичной
обязательно
Логический тип
14.5.8.8.
инвалидности
данных: 1 - признак
положительный, 0 -
признак
отрицательный
dateOfFirstCheck
Дата первичного
обязательно
Целое число
14.5.8.9.
освидетельствования
219
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
(метка времени в
unixtimestamp)
dateOfNextCheck
Дата очередного
обязательно
Целое число
14.5.8.10.
освидетельствования
(метка времени в
unixtimestamp)
disabledGroup
Группа инвалидности
обязательно
Целое число
14.5.8.11.
child
Ребенок
обязательно
Логический тип
14.5.8.12.
данных: 1 - признак
положительный, 0 -
признак
отрицательный
disabledOnVision
Инвалид по зрению
обязательно
Логический тип
14.5.8.13.
данных: 1 - признак
положительный, 0 -
признак
отрицательный
disabilityReasonCode
Код причины
обязательно
Целое число
14.5.8.14.
инвалидности
disabilityReasonName
Наименование
обязательно
Строка
14.5.8.15.
причины
инвалидности
Пример ответа на запрос выписки сведений об инвалидности гражданина:
220
{
"oid": "10031415",
"id": "91899952b06c4cc89746d38b2c8c72f3",
"receiptDocDate": "1574237502",
"validateDateDoc": "1574237613",
"type": " DISABLED_PERSON",
"status": "verified_by_validate",
"relevance": "actual",
"departmentDoc": " Пенсионный фонд России",
"version": "1",
"createdOn": "1576067088085",
"updatedOn": "1576067088085",
"xmlFile": {
"file": "PNCS
0LA+" // полную строку см. в папке «Примеры документов по типу сведений»
},
"nameDoc": "Выписка из ФГИС ФРИ",
"extractionFRI": {
"extractionID": "59a07dd7-fa1f-4bfb-9872-fefa9465cde8",
"typeExtraction": "FLEXIBLE",
"createdAt": 1594303555000,
"consumer": "PFR.PFR",
"personData": {
"snils": "000-000-485 29",
"lastName": "Петров",
"firstName": "Леонид",
"middleName": "Иванович",
"birthday": 491886000000,
"gender": "М",
"regDate": 1482750190000,
"disabledPerson": {
"dateFrom": 1569877200000,
"dateTo": 1569877200000,
"numberActMSE": "2101.11.42/2019",
"dateActMSE": 1567717200000,
"serCertificateMSE": "МСЭ-2018",
"numCertificateMSE": "1801294",
"dateCertificateMSE": 1569877200000,
"primaryDisablement": false,
"dateOfFirstCheck": 1473886800000,
"dateOfNextCheck": 1703970000000,
"disabledGroup": 3,
"child": false,
"disabledOnVision": false,
"disabilityReasonCode": 2,
"disabilityReasonName": "Общее заболевание"
}
}
}
}
221
7.2.20 Сведения о выписке из регистра сертификатов материнского
(семейного) капитала
Модель документа «Сведения о выписке из регистра сертификатов материнского (семейного)
капитала» приведена в следующей таблице:
Таблица 21 - Сведения о выписке из регистра сертификатов материнского (семейного) капитала
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
oid
Идентификатор
обязательно
Строка
1.
пользователя
id
Уникальный
обязательно
Строка
2.
идентификатор документа
status
Статус достоверности
обязательно
Принимает значения:
3.
verified_by_validate
verified_by_request
verified_by_push
unverified
relevance
Релевантность документа
обязательно
Принимает значения:
4.
actual
expired
invalid
type
Тип документа
обязательно
Принимает значение
5.
FAMILY_ASSETS
departmentDoc
Ведомство, к которому
обязательно
Принимает значение
6.
относится документ
"ПФР"
version
Версия документа
обязательно в случае
Принимает значение
7.
отсутствия ошибки
"1"
receiptDocDate
Дата и время получения
обязательно в случае
Задается как
8.
документа в формате
отсутствия ошибки
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
validateDateDoc
Дата и время валидации
обязательно в случае
Задается как
9.
документа в формате
отсутствия ошибки
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
222
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
createdOn
Дата и время создания
обязательно
Задается как
10.
документа в формате
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
updatedOn
Дата и время обновления
обязательно
Задается как
11.
документа в формате
количество
timestamp
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
familyAssetsBalanceIn
Блок сведений о состоянии
обязательно в случае
Объект, состоящий из
12.
fo
и остатке материнского
отсутствия ошибки
следующих элементов
капитала
(п. 12.1 - 12.6)
cert
в случае, если заполнено
обязательно
Логический тип
12.1.
одно из следующих полей
данных: true - признак
Размер МСК или Остаток
положительный, false -
ЛС, то значение true, иначе
признак
false
отрицательный
primarySumBalance
Размер МСК - сумма
обязательно
Десятичное число
12.2.
баланса, если гражданин
не использовал сертификат
restSumBalance
Сумма остатка баланса
обязательно
Десятичное число
12.3.
материнского капитала,
если гражданин
использовал сертификат
date
Дата формирования
обязательно
Целое число
12.4.
справки (метка времени в
unixtimestamp)
xmlFile
Файл выписки по
обязательно
Объект, состоящий из
12.5.
материнскому капиталу
следующих элементов
(п. 12.5.1 - 12.5.2)
file
Выписка по материнскому
обязательно
Строка
12.5.1.
капиталу в xml,
закодированная в формате
base64
metadata
Формат файла
обязательно
Строка
12.5.2.
223
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
pdfFile
Файл выписки по
обязательно
Объект, состоящий из
12.6.
материнскому капиталу
следующих элементов
(п. 12.6.1 - 12.6.2)
file
Выписка по материнскому
обязательно
Строка
12.6.1.
капиталу в pdf,
закодированная в формате
base64
metadata
Формат файла
обязательно
Строка
12.6.2.
Пример ответа на запрос выписки из регистра сертификатов материнского (семейного) капитала:
{
"oid": "10031415",
"id": "91899952b06c4cc89746d38b2c8c72f3",
"type": "FAMILY_ASSETS",
"receiptDocDate": "1574237502",
"validateDateDoc": "1574237613",
"status": "verified_by_validate",
"relevance": "actual",
"version": "1",
"createdOn": "1576067088085",
"updatedOn": "1576067088085",
"departmentDoc": "Пенсионный фонд России",
"familyAssetsBalanceInfo": {
"cert": true,
"primarySumBalance": null,
"restSumBalance": 333,
"date": 1569877200000,
"xmlFile": {
"file": "PNCS
C60LA+", // полную строку см. в папке «Примеры документов по типу сведений»
"metadata": "application/xml"
},
"pdfFile": {
"file": "UEsDBBQABgAIAAAA
tAAAAAA==", // полную строку см. в папке «Примеры документов по
типу сведений»
"metadata": "application/pdf"
}
}
}
224
7.2.21 Сведения об отнесении гражданина к категории граждан
предпенсионного возраста
Модель документа «Сведения об отнесении гражданина к категории граждан предпенсионного
возраста» приведена в следующей таблице:
Таблица 22 - Сведения об отнесении гражданина к категории граждан предпенсионного
возраста
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
oid
Идентификатор пользователя
обязательно
Строка
1.
id
Уникальный идентификатор
обязательно
Строка
2.
документа
status
Статус достоверности
обязательно
Принимает значения:
3.
verified_by_validate
verified_by_request
verified_by_push
unverified
relevance
Релевантность документа
обязательно
Принимает значения:
4.
actual
expired
invalid
type
Тип документа
обязательно
Принимает значение
5.
PRE_RETIREMENT_A
GE
departmentDoc
Ведомство, к которому относится
обязательно
Принимает значение
6.
документ
"ПФР"
version
Версия документа
обязательно в
Принимает значение
7.
случае отсутствия
"1"
ошибки
receiptDocDate
Дата и время получения документа
обязательно в
Задается как
8.
в формате timestamp
случае отсутствия
количество
ошибки
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
validateDateDo
Дата и время валидации документа
обязательно в
Задается как
9.
c
в формате timestamp
случае отсутствия
количество
ошибки
миллисекунд,
прошедших с 00:00:00
225
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
UTC 1 января 1970
года
createdOn
Дата и время создания документа в
обязательно
Задается как
10.
формате timestamp
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
updatedOn
Дата и время обновления
обязательно
Задается как
11.
документа в формате timestamp
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
preRetirementA
Блок сведений об отнесении
обязательно в
Массив, состоящий из
12.
geInfo
гражданина к категории граждан
случае отсутствия
следующих элементов
предпенсионного возраста
ошибки
(п. 12.1 - 12.7)
typeOrg
Орган, для предоставления в
обязательно
Строка, возможные
12.1.
который выдаются сведения.
значения: 1, 2, 3, 4
preRetirementA
Отметка о том, что гражданин
обязательно
Логический тип
12.2.
ge
относится к категории граждан
данных: true - признак
предпенсионного возраста.
положительный, false -
признак
отрицательный
date
Дата документа
обязательно
Строка
12.3.
dateFrom
Дата, c которой гражданин
не обязательно
Строка
12.4.
относится к категории граждан
предпенсионного возраста
normDoc
Нормативная база
не обязательно
Объект, состоящий из
12.5.
следующих элементов
(п. 12.5.1 - 12.5.5)
nameDoc
Наименование нормативного
не обязательно
Строка
12.5.1.
документа
section
Статья
не обязательно
Строка
12.5.2.
part
Часть
не обязательно
Строка
12.5.3.
paragraph
Пункт
не обязательно
Строка
12.5.4.
subparagraph
Подпункт
не обязательно
Строка
12.5.5.
226
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
xmlFile
Файл справки об об отнесении
обязательно
Объект, состоящий из
12.6.
гражданина к категории граждан
следующих элементов
предпенсионного возраста в
(п. 12.6.1 )
формате xml
file
Справка в формате xml,
обязательно
Строка
12.6.1.
закодированная в формате base64
pdfFile
Файл справки об об отнесении
обязательно
Объект, состоящий из
12.7.
гражданина к категории граждан
следующих элементов
предпенсионного возраста
(п. 12.7.1 )
file
Справка в формате pdf,
обязательно
Строка
12.7.1.
закодированная в формате base64
error
Информация об ошибке,
не обязательно
Строка
13.
отображается определенное
количество дней в случае, если
произошла ошибка при получении
данных, при этом предыдущие
сведения не затираются и
отображаются.
Если в ответе имеется указанное
поле, полученные данные принято
считать не актуальными.
errorUpdatedOn
Дата последнего ответа с ошибкой
не обязательно
Целое число
14.
(метка времени в unixtimestamp).
Если в ответе имеется указанное
поле, полученные данные принято
считать не актуальными.
Пример ответа на запрос сведений об отнесении гражданина к
категории граждан
предпенсионного возраста:
227
{
"oid": "10031415",
"id": "91899952b06c4cc89746d38b2c8c72f3",
"type": " PRE_RETIREMENT_AGE",
"receiptDocDate": "1574237502",
"validateDateDoc": "1574237613",
"status": "verified_by_validate",
"relevance": "actual",
"departmentDoc": "Пенсионный фонд России",
"version": "1",
"createdOn": "1576067088085",
"updatedOn": "1576067088085",
"preRetirementAgeInfo": [
{
"typeOrg": "3",
"preRetirementAge": false,
"date": "09.07.2020",
"dateFrom": "13.08.1957",
"normDoc": {
"nameDoc": "документ",
"section": "14",
"part": "1",
"paragraph": "1",
"subparagraph": "1"
},
"xmlFile": {
"file": "PNCS0YvQv9C40YHQutCwPg0
0LjRgdC60LA+" //полную строку см. в папке «Примеры
документов по типу сведений»
},
"pdfFile": {
"file": "UEsDBBQABgAIAA
QIAAEstAAAAAA==" //полную строку см. в папке «Примеры документов по
типу сведений»
}
}
],
"error": "MksRequestErrorEnum.pfr.pre.retirement.age.status.doc.failed",
"errorUpdatedOn": 1611064950715
}
228
Пример ответа при отправке запроса в ПФР для получения сведений об отнесении гражданина к
категории граждан предпенсионного возраста:
{
"oid": "1078121661",
"requestId": "2550913"
}
Пример ответа при получении ошибки в процессе запроса сведений об отнесении гражданина к
категории граждан предпенсионного возраста:
{
"oid":"1077139512",
"id":"973e98b3-a9de-47f8-acb2-b2f3e71ed19a",
"version":1,
"createdOn":1628603361116,
"updatedOn":1628603361116,
"receiptDocDate":1628603361116,
"relevance":"actual",
"departmentDoc":"Пенсионный фонд России",
"error":"MksRequestErrorEnum.pfr.pre.retirement.age.status.doc.failed",
"errorUpdatedOn":1628603361216,
"type":"PRE_RETIREMENT_AGE"
}
Пример ответа при получении ошибки в процессе обновления сведений о состоянии
индивидуального страхового счета застрахованного лица:
229
{
"oid":"1077139485",
"id":"a6a61c71-16ab-4292-8598-ef21ccaa93cd",
"version":1,
"createdOn":1628688873126,
"updatedOn":1628688873126,
"receiptDocDate":1628688873126,
"validateDateDoc":1008570647000,
"relevance":"actual",
"status":"verified_by_request",
"departmentDoc":"Пенсионный фонд России",
"preRetirementAgeInfo":[
{
"typeOrg":"1",
"preRetirementAge":true,
"date":"09.07.2020",
"dateFrom":"13.08.1957",
"normDoc":{
"nameDoc":"документ",
"section":"14",
"part":"1",
"paragraph":"1",
"subparagraph":"1"
},
"xmlFile":{
"link":{
"objectId":2521551,
"objectTypeId":40,
"mnemonic":"pre_rerement_age.xml"
}
},
"pdfFile":{
"link":{
"objectId":2521551,
"objectTypeId":40,
"mnemonic":"inclusion.pdf"
}
}
},
{
"typeOrg":"2",
"preRetirementAge":true,
"date":"09.07.2020",
"dateFrom":"13.08.1957",
"normDoc":{
"nameDoc":"документ",
"section":"14",
"part":"1",
"paragraph":"1",
"subparagraph":"1"
},
"xmlFile":{
230
"link":{
"objectId":2521551,
"objectTypeId":40,
"mnemonic":"pre_rerement_age.xml"
}
},
"pdfFile":{
"link":{
"objectId":2521551,
"objectTypeId":40,
"mnemonic":"inclusion.pdf"
}
}
},
{
"typeOrg":"3",
"preRetirementAge":true,
"date":"09.07.2020",
"dateFrom":"13.08.1957",
"normDoc":{
"nameDoc":"документ",
"section":"14",
"part":"1",
"paragraph":"1",
"subparagraph":"1"
},
"xmlFile":{
"link":{
"objectId":2521551,
"objectTypeId":40,
"mnemonic":"pre_rerement_age.xml"
}
},
"pdfFile":{
"link":{
"objectId":2521551,
"objectTypeId":40,
"mnemonic":"inclusion.pdf"
}
}
}
],
"error":"MksRequestErrorEnum.pfr.pre.retirement.age.status.doc.failed",
"errorUpdatedOn":1628688873228,
"type":"PRE_RETIREMENT_AGE"
}
7.2.22 Сведения о полисе ОМС и прикреплении к медицинской
231
организации
Модель документа «Сведения о полисе ОМС и прикреплении к медицинской организации»
приведена в следующей таблице:
Таблица 23 - Сведения о полисе ОМС и прикреплении к медицинской организации
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
oid
Идентификатор пользователя
обязательно
Строка
1.
id
Уникальный идентификатор
обязательно
Строка
2.
документа
status
Статус достоверности
обязательно
Принимает значения:
3.
verified_by_validate
verified_by_request
verified_by_push
unverified
relevance
Релевантность документа
обязательно
Принимает значения:
4.
actual
expired
invalid
type
Тип документа
обязательно
Принимает значение
5.
MDCL_PLCY
departmentDoc
Ведомство, к которому
не обязательно
Принимает значение
6.
относится документ
"Министерство
здравоохранения
Российской
Федерации"
version
Версия документа
обязательно в случае
Принимает значение
7.
отсутствия ошибки
"1"
receiptDocDate
Дата и время получения
обязательно в случае
Задается как
8.
документа в формате timestamp
отсутствия ошибки
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
validateDateDoc
Дата и время валидации
обязательно в случае
Задается как
9.
документа в формате timestamp
отсутствия ошибки
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
232
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
number
Номер полиса ОМС
Обязательно в
Строка
10.
случает, если не
придет поле
unitedNumber
expiryDate
Дата окончания действия
не обязательно
Строка
11.
документа
issueDate
Дата выпуска полиса ОМС
обязательно
Строка
12.
unitedNumber
Сведения о ЕНП (едином
не обязательно
Строка
13.
номере полиса) ОМС
medicalOrg
Наименование медицинской
обязательно
Строка
14.
организации (юридическое
лицо)
issuePlace
Наименование субъекта
обязательно
Строка
15.
Российской Федерации
территории страхования
issuedBy
Наименование страховой
обязательно
Строка
16.
медицинской организации
(филиала)
issueId
Реестровый номер страховой
обязательно
Строка
17.
медицинской организации
(филиала)
Пример ответа на запрос сведений о полисе ОМС и прикреплении к медицинской организации:
233
[
{
"oid": "10031415",
"id": "91899952b06c4cc89746d38b2c8c72f3",
"type": " MDCL_PLCY",
"receiptDocDate": "1574237502",
"validateDateDoc": "1574237613",
"status": "verified_by_validate",
"relevance": "actual",
"departmentDoc": "Министерство здравоохранения Российской Федерации",
"number": "123456789",
"expiryDate": "18.12.2021",
"issueDate": "19.08.2019",
"unitedNumber": "1234567890123456",
"medicalOrg": "Городская поликлиника №333 Департамента здравоохранения города Москвы",
"issuePlace": "Ростовская область",
"issuedBy": "Ростовскя область ООО \\\"СМК РЕСО-МЕД\\\"",
"issueId": "22001"
}
]
234
7.2.23 Выписка о транспортном средстве по владельцу
Модель документа «Выписка о транспортном средстве по владельцу» приведена в следующей
таблице:
Таблица 243 - Выписка о транспортном средстве по владельцу
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
oid
Идентификатор пользователя
обязательно
Строка
1.
id
Уникальный идентификатор
обязательно
Строка
2.
документа
status
Статус достоверности
Обязательно в случае
Принимает значения:
3.
отсутствия ошибки
verified_by_validate
verified_by_request
verified_by_push
unverified
relevance
Релевантность документа
обязательно
Принимает значения:
4.
actual
expired
invalid
type
Тип документа
обязательно
Принимает значение
5.
VEHICLE_INFO
departmentDoc
Ведомство, к которому
обязательно
Принимает значение "
6.
относится документ
Управление ГИБДД
ГУ МВД России"
version
Версия документа
обязательно
Принимает значение
7.
"1"
createdOn
Дата
и
время
создания
обязательно
Задается
как
8.
документа в формате timestamp
количество
миллисекунд,
прошедших с 00:00:00
UTC
1 января
1970
года
updatedOn
Дата и время обновления
обязательно
Задается
как
9.
документа в формате timestamp
количество
миллисекунд,
прошедших с 00:00:00
UTC
1 января
1970
года
235
№
Код поля
Описание поля
Требования к
Комментарий
заполнению
receiptDocDate
Дата и время получения
обязательно
Задается как
10.
документа в формате timestamp
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
validateDateDoc
Дата и время валидации
Обязательно в случае
Задается как
11.
документа в формате timestamp
отсутствия ошибки
количество
миллисекунд,
прошедших с 00:00:00
UTC 1 января 1970
года
nameDoc
Наименование документа
Обязательно в случае
Строка
12.
отсутствия ошибки
content
Выписка о транспортном
Обязательно в случае
Строка, содержащая
13.
средстве по владельцу в xml,
отсутствия ошибки
закодированый в
закодированная в формате
формате base64 файл
base64
error
Информация
об
ошибке,
не обязательно
Строка
14.
предыдущие
сведения
не
затираются и отображаются
(при
наличии).
Если в ответе имеется указанное
поле,
полученные
данные
принято
считать
не
актуальными.
errorUpdatedOn
Дата последнего ответа с
не обязательно
Целое число
15.
ошибкой (метка времени в
unixtimestamp).
Если в ответе имеется указанное
поле,
полученные
данные
принято
считать
не
актуальными.
Пример ответа на запрос сведений о выписке о транспортном средстве по владельцу:
236
{
"oid": "1077130925",
"id": "1ab0a427-48e9-47f7-ad10-6b58ff3d75e0",
"version": 1,
"createdOn": 1616081460770,
"updatedOn": 1616081460770,
"receiptDocDate": 1616081460770,
"validateDateDoc": 1616081460601,
"relevance": "actual",
"status": "verified_by_request",
"departmentDoc": "Управление ГИБДД ГУ МВД России",
"nameDoc": "Выписка о ТС по владельцу",
"content": "PD94b…..JzPg==",
"type": "VEHICLE_INFO"
}
Пример ответа при отправке запроса на получение выписки о транспортном средстве по
владельцу:
{
"oid":"1077139512",
"requestId":"2555967"
}
Список возможных ошибок:
Код ошибки
Описание ошибки
Комментарий
MksRequestErrorEnum.mvd.vehicle.info.no.permissions
Отсутствие согласия
Требуется
получить
согласие у пользователя
MksRequestErrorEnum.mvd.vehicle.info.request.failed
Ошибка в ответе от СМЭВ
Запросить сведения позже
или
обратиться
в
поддержку
CommonExceptionEnum.internalError
При
непредвиденной
Запросить сведения позже
ошибке
или
обратиться
в
поддержку
Пример ответа при получении ошибки в процессе запроса выписки о транспортном средстве по
владельцу:
237
{
"oid": "1077132658",
"id": "49418299-0ef2-4d11-bffd-0de760403170",
"version": 1,
"createdOn": 1626427346138,
"updatedOn": 1626427346138,
"receiptDocDate": 1626427346138,
"relevance": "actual",
"departmentDoc": "Управление ГИБДД ГУ МВД России",
"error": "MksRequestErrorEnum.mvd.vehicle.info.no.permissions",
"errorUpdatedOn": 1626427346219,
"type": "VEHICLE_INFO"
}
Пример ответа при получении ошибки в процессе обновления выписки о транспортном
средстве по владельцу:
{
"oid":"1077139485",
"id":"6bb2e101-c684-4887-ba84-4ed04b36db9f",
"version":1,
"createdOn":1629265326872,
"updatedOn":1629265326872,
"receiptDocDate":1629265326872,
"validateDateDoc":1629264806047,
"relevance":"actual",
"status":"verified_by_request",
"departmentDoc":"Управление ГИБДД ГУ МВД России",
"nameDoc":"Выписка о ТС по владельцу",
"error":"MksRequestErrorEnum.mvd.vehicle.info.request.failed",
"errorUpdatedOn":1629265326963,
"content": "PD94bWwgd…”,
"type":"VEHICLE_INFO"
}
Вид
сведения:
238
7.3 Тестирование REST API Цифрового профиля
возможность тестирования REST API Цифрового профиля для некоторых сведений с помощью
заглушек.
Для такого тестирования на данный момент доступны следующие методы:
1) GET /digital/api/public/{version}/pso/{oid}/doc/{doc_type}
В качестве {doc_type} (тип сведения) можно указывать:
ILS_PFR - Сведения о состоянии индивидуального страхового счета застрахованного
лица
PASSPORT_HISTORY - История выданных гражданину РФ паспортов
INCOME_REFERENCE - Справки о доходах и суммах налога физического лица
(форма 2-НДФЛ)
PENSION_REFERENCE - Справки о назначенных пенсиях и социальных выплатах на
дату
ELECTRONIC_WORKBOOK - Сведения о трудовой деятельности (выписка из
электронной трудовой книжки)
PAYMENTS_EGISSO - Сведения о назначенных и реализованных мерах социальной
защиты (поддержки)
DISABLED_PERSON - Сведения об инвалидности гражданина
FAMILY_ASSETS - Сведения о выписке из регистра сертификатов материнского
(семейного) капитала
PRE_RETIREMENT_AGE - Сведения об отнесении гражданина к категории граждан
предпенсионного возраста
MDCL_PLCY - Сведения о полисе ОМС и прикреплении к медицинской организации
Для того, чтобы при вызове метода возвращались тестовые данные, необходимо
дополнительно указывать в запросе параметр test={id}, где id - порядковый номер тестового
ответа для конкретного сведения. Например, для ИЛС ПФР запрос будет выглядеть следующим
образом:
Возвращаемый тестовый пример:
содержит тестовый oid пользователя, отличный от oid в запросе;
содержит тестовый id сведения;
239
содержит тестовые данные, отличные от данных тестового пользователя, oid которого
указан в запросе;
не записывается в хранилище Цифрового профиля для пользователя, oid которого
указан в запросе;
содержит тестовый файл подписи документа.
Для сведения ILS_PFR доступны 6 тестовых ответов:
?test=1 - Выписка по гражданину без накопительной пенсии
?test=2 - Выписка по гражданину, который выбрал НПФ в качестве места хранения
пенсионных накоплений
?test=3 - Выписка по гражданину, который выбрал государственный ПФ в качестве
места хранения пенсионных накоплений
?test=4 - Выписка по гражданину-пенсионеру, получающему накопительную пенсию
?test=5 - Выписка по гражданину-пенсионеру, получающему срочную пенсию
?test=6 - Выписка по гражданину-пенсионеру, получившему срочную выплату
Для сведения PASSPORT_HISTORY доступен 1 тестовый ответ: ?test=1
Содержит в себе три вида паспорта с различными причинами недействительности.
Для сведения INCOME_REFERENCE доступен 1 тестовый ответ - Справка по
гражданину, который работал в ЮЛ и у ФЛ: ?test=1
Для сведения PENSION_REFERENCE доступно 2 ответа:
?test=1 - Положительный результат (т.е. гражданину назначена пенсия и социальная
выплата - гражданин является пенсионером)
?test=2 - Отрицательный результат (т.е. гражданину не назначена пенсия и социальная
выплата - гражданин не достиг соответствующего возраста)
Для сведения ELECTRONIC_WORKBOOK доступен 1 тестовый ответ - ЭТК по
гражданину с записями в электронной трудовой книжке за последние два года: ?test=1
Для сведения PAYMENTS_EGISSO доступен 1 тестовый ответ:
?test=1 - Есть ответ от ведомства (т.е. по гражданину есть сведения о назначенных и
реализованных мерах социальной защиты (поддержки))
240
Для сведения DISABLED_PERSON доступно 2 тестовых ответа:
?test=1 - Отрицательный результат (т.е. гражданин не относится к категории
инвалиды)
?test=2 - Положительный результат (т.е. гражданин относится к категории инвалиды
и по нему пришли данные)
Для сведения FAMILY_ASSETS доступно 3 тестовых ответа:
?test=1 - Отрицательный результат (т.е. гражданин делал запрос на материнский
капитал, но одобрение не было дано)
?test=2 - Положительный результат (т.е. гражданин имеет одобренный материнский
капитал и им не пользовался)
?test=3 - Положительный результат (т.е. гражданин имеет одобренный материнский
капитал и часть суммы капитала использована)
Для сведения PRE_RETIREMENT_AGE доступно 2 тестовых ответа:
?test=1 - Отрицательный результат (т.е. гражданин не относится к категории граждан
предпенсионного возраста)
?test=2 - Положительный результат (т.е. гражданин относится к категории граждан
предпенсионного возраста)
Для сведения MDCL_PLCY доступен 1 тестовый ответ:
?test=1 - сведения о медицинском полисе гражданина
2) GET /digital/api/public/{version}/pso/{oid}/doc/{doc_type}/raw
В качестве {doc_type} (тип сведения) можно указывать:
VEHICLE_INFO - Выписка о транспортном средстве по владельцу, полученная из
витрины ГИБДД
Для того, чтобы при вызове метода возвращались тестовые данные, необходимо
дополнительно указывать в запросе параметр test={id}, где id - порядковый номер тестового
ответа для конкретного сведения. Например, для VEHICLE_INFO запрос будет выглядеть
следующим образом:
241
GET https://esia-
portal1.test.gosuslugi.ru/digital/api/public/v1/pso/1000475789/doc/VEHICLE_INFO/raw?test=1
Возвращаемый тестовый пример:
содержит тестовый oid пользователя, отличный от oid в запросе;
содержит тестовый id сведения;
содержит тестовые данные, отличные от данных тестового пользователя, oid которого
указан в запросе;
не записывается в хранилище Цифрового профиля для пользователя, oid которого
указан в запросе;
содержит тестовый файл подписи документа.
Для сведения VEHICLE_INFO доступен 1 тестовый ответ: ?test=1
Содержит в себе выписку о транспортном средстве по владельцу, полученную из витрины
ГИБДД, в исходном виде.
242
8 СПЕЦИФИКАЦИЯ СЕРВИСОВ REST-API
ЦИФРОВОГО ПРОФИЛЯ И ПЛАФОРМЫ СОГЛАСИЙ
8.1 Инструментальное средство описания и документирования
REST сервисов (Swagger)
Разработка, сопровождение и развитие сервисов REST API Цифрового профиля и платформы
согласий выполняется с использованием Swagger - спецификации OpenApi и инструмента для
определения REST API в форматах и визуальном представлении, дружественных пользователю.
Представленное инструментальное средство позволяет выполнять следующие базовые функции:
создавать и редактировать описания сервисов REST API;
выполнять просмотр описаний сервисов REST API в наглядном, удобном для
пользователя виде;
сохранять описания сервисов REST API в файлы в форматах YAML и JSON.
Доступ к свободно распространяемой Web версии Swagger (OpenApi 3.0.0) возможен по ссылке
записи пользователя для начала работы с данным инструментальным средством. Подробное
руководство по использованию SwaggerHub и OpenApi доступно по ссылке
8.2 Спецификация сервисов REST API Цифрового профиля и
Платформы согласий
Описание (спецификация) сервисов REST API Цифрового профиля и Платформы
согласий выполнено с использованием инструмента Swagger (OpenApi 3.0.0) в едином рабочем
пространстве, хранение указанной спецификации выполняется формате YAML.
Методы REST API, описанные в приводимой ниже спецификации, условно разделены на
следующие группы:
методы доступа к документам Цифрового профиля гражданина;
методы сервиса авторизации ЕСИА (OAuth2.0), поддерживающие режим запроса
согласий;
методы для реализации приёма уведомлений информационными системами
организаций-потребителей.
243
Листинг спецификации сервисов REST API Цифрового профиля и Платформы согласий
в формате YAML приложен в zip-архиве «API SPECIFICATION».
244
|