Запрос персональных данных при наличии согласия пользователя ЕСИА

smev3 link

smev manual

Атрибут Значение
Название esia-personal-data
Тип Адаптер для взаимодействия с ЕСИА
Наименование Запрос персональных данных при наличии согласия пользователя ЕСИА
Назначение Вид сведений предназначен для получения внешней ИС запрошенных персональных данных зарегистрированного пользователя ЕСИА
Область применения Межведомственное взаимодействие
Версия ВС 1.0.1
Версия МР 3.0
Версия СМЭВ СМЭВ3
flowchart LR; A[ИС организации] <--> B[Агредатор]; B <--> C[СМЭВ]; C <--> D[ЕСИА];

Описание бизнес-процесса взаимодействия: ИС организации хочет получить из ЕСИА персональные данные зарегистрированного пользователя ЕСИА.

ИС организации отправляет запрос через Агредатор, Агредатор в свою очередь отправляет запрос в СМЭВ к виду сведений, СМЭВ получает запрос и направляет его к ЕСИА.

После получения запроса, ЕСИА проверяет наличие согласия пользователя на передачу указанной информации в огранизацию-владельца ИС, через СМЭВ направляет в Агредатор набор запрашиваемых данных из УЗ пользователя ЕСИА, сведения об их достоверности, или может быть возвращен код и описание ошибки, Агредатор направляет данную информацию в ИС организации.

Если отправка запроса не произошла, то Агредатор получит от СМЭВ сообщение об ошибке и передаст его в ИС организации.

Переменные окружения

Название Описание
CA_CERT сертификат центра сертификации для подключения к rabbitmq
CLIENT_CERT сертификат, используемый для подключения к rabbitmq
CLIENT_KEY ключ, используемый для подключения к rabbitmq
MQ_HOST хост rabbitmq
MQ_PORT порт rabbitmq
SMEV_SERVICE название смэв сервиса, на который будут отправляться запросы
DATABASE_URL строка подключения к БД

Переменные для конфигурирования отправки метрик в Elasticsearch:

ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX

Принимаемые параметры

Параметр Описание Обязательное Пример
routing_code Код маршрутизации на cреду ЕСИА + значение из словаря RoutingCodes
snils СНИЛС пользователя +1 000-000-000 00
oid OID пользователя +1 1000376121
data_type Тип запрашиваемых персональных данных пользователя + значение из словаря DataTypes

1 - не допускается одновременное наличие или присутствие полей

Параметры ответа

Параметр Описание Обязательное Пример
error_info Информация об ошибке -1 Составной элемент ErrorInfo
personal_data Персональные данные пользователя ЕСИА -1 Составной элемент PersonalData
attachments Информация о полученных вложениях + Последовательность элементов AggredatorAttachment

1 - обязательно должен присутствовать один из элементов

Структура элементов AggredatorAttachment

Параметр Описание Обязательное Пример
uuid Идентификатор файла в файловом хранилище Агредатора + 7ca24dd0450bf0cc509f384f6198ff9ac12dd52f0ef1fc10d3af8c14c49876aa
checksum Контрольная сумма + e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
created_at Время загрузки файла + 2020-11-16T12:27:20.726+03:00
tags Последовательность строк-тегов файла + ["test"]
filename Имя загруженного файла + test.txt
smev_id Идентификатор вложения, используемый в СМЭВ конверте + attachment.txt

Структура элемента ErrorInfo

Параметр Описание Обязательное Пример
code Код ошибки + Значение из словаря ErrorCodes
message Описание ошибки + Описание из словаря ErrorCodes

возможно не полное соответствие значениям из словаря ErrorCodes

Структура элемента PersonalData

Параметр Описание Обязательное Пример
data_type Тип персональных данных пользователя + Значение из словаря DataTypes
data_entries Экземпляры персональных данных пользователя + Ненулевой список элементов PersonalDataEntry

Структура элемента PersonalDataEntry

Параметр Описание Обязательное Пример
full_name Фамилия, имя, отчество пользователя ЕСИА -1 Составной элемент FullName
birth_date Дата рождения пользователя ЕСИА -1 Составной элемент BirthDate
snils СНИЛС пользователя ЕСИА -1 000-000-000 00
birth_place Место рождения пользователя ЕСИА -1 Составной элемент BirthPlace
mobile_phone Мобильный телефон пользователя ЕСИА -1 Составной элемент MobilePhone
gender Пол пользователя ЕСИА -1 Составной элемент Gender
inn ИНН пользователя ЕСИА -1 Составной элемент INN
citizenship Гражданство пользователя ЕСИА -1 Составной элемент Citizenship
email Адрес электронной почты пользователя ЕСИА -1 Составной элемент Email
registration_address Адрес регистрации пользователя ЕСИА -1 Составной элемент Address
home_address Адрес места жительства пользователя ЕСИА -1 Составной элемент Address
rf_passport Паспорт гражданина России -1 Составной элемент RFPassport
rf_brth_cert Свидетельство о рождении, выданное в России -1 Составной элемент RFBrthCert
married_cert Свидетельство о заключении брака -1 Составной элемент MarriedCert
divorce_cert Свидетельство о расторжении брака -1 Составной элемент DivorceCert
name_change_cert Свидетельство о перемени имени -1 Составной элемент NameChangeCert
fatherhood_cert Свидетельство об установлении отцовства -1 Составной элемент FatherhoodCert
death_cert Свидетельство о смерти -1 Составной элемент DeathCert
passport_history Паспортное досье (история выданных паспортов) -1 Составной элемент PassportHistory
fid_doc Документ иностранного гражданина -1 Составной элемент FidDoc
military_doc Военный билет -1 Составной элемент MilitaryDoc
medical_doc Полис ОМС -1 Составной элемент MedicalDoc
fid_brth_cert_doc Свидетельство о рождении, выданное в иностранном государстве -1 Составной элемент FidBrthCertDoc
old_brth_cert_doc Свидетельство о рождении, выданное в СССР -1 Составной элемент OldBrthCertDoc
frgn_passport_doc Заграничный паспорт гражданина РФ -1 Составной элемент FrgnPassportDoc
rf_driving_license_doc Водительское удостоверение -1 Составной элемент RfDrivingLicenseDoc
vehicle_doc Свидетельство о регистрации транспортных средств пользователя -1 Составной элемент VehicleDoc
ilspfr Сведения о состоянии индивидуального лицевого счета застрахованного лица -1 Составной элемент ILSPFR
income_reference Cправки о доходах и суммах налога физического лица (форма 2-НДФЛ) -1 Составной элемент IncomeReference
pension_reference Справка о назначенных пенсиях и социальных выплатах на дату -1 Составной элемент PensionReference
electronic_workbook Выписка о трудовой деятельности (электронная трудовая книижка) -1 Составной элемент ElectronicWorkbook
pre_retirement_age Сведения об отнесении гражданина к категории граждан предпенсионного возраста -1 Составной элемент PreRetirementAge
disabled_person Справка об инвалидности -1 Составной элемент DisabledPerson
payments_egisso Выписка из ЕГИССО -1 Составной элемент StatementData
family_assets_balance Сведения о выписке из регистра о выдаче сертификата материнского капитала -1 Составной элемент FamilyAssetsBalance
bssdata Выписка из ЕГРИП в отношении ИП, в которых ФЛ является руководителем -1 Составной элемент BssData
orgdata Выписка из ЕГРЮЛ в отношении ЮЛ, в которых ФЛ является руководителем -1 Составной элемент OrgData
proof_block Сведения о достоверности персональных данных пользователя - Составной элемент ProofBlock

1 - должен присутствовать один из элементов

Структура элемента FullName
Параметр Описание Обязательное Пример
last_name Фамилия пользователя + Иванов
first_name Имя пользователя + Иван
middle_name Отчество пользователя - Иванович
Структура элемента BirthDate
Параметр Описание Обязательное Пример
birth_date Дата рождения пользователя + 10.04.1987
Структура элемента BirthPlace
Параметр Описание Обязательное Пример
birth_place Место рождения пользователя + Москва
Структура элемента MobilePhone
Параметр Описание Обязательное Пример
mobile_phone Номер мобильного телефона пользователя + +7(000)1234567
Структура элемента Gender
Параметр Описание Обязательное Пример
gender Пол пользователя + Значение из словаря Gender
Структура элемента INN
Параметр Описание Обязательное Пример
inn ИНН пользователя + 123456789012
Структура элемента Citizenship
Параметр Описание Обязательное Пример
citizenship Гражданство пользователя + RUS
Структура элемента Email
Параметр Описание Обязательное Пример
email Адрес электронной почты пользователя + test@example.com
Структура элемента Address
Параметр Описание Обязательное
address_str Адрес (одной строкой) -
country_id Страна -
zip_code Индекс -
region Регион -
area Район -
addition_area Дополнительная территория -
city Город -
district Округ -
street Улица -
additional_area_street Улица на дополнительной территории -
house Дом -
frame Корпус -
building Строение -
flat Квартира -
fias_code ФИАС-код -
Структура элемента RFPassport
Параметр Описание Обязательное Пример
base_doc Серия, номер, дата выдачи паспорта + Составной элемент BaseDoc
issued_by Кем выдан паспорт + УПРАВЛЕНИЕ ФЕДЕРАЛЬНОЙ МИГРАЦИОННОЙ СЛУЖБЫ РОССИИ ПО ГОР. МОСКВЕ
issued_id Код подразделения + 770-001
Структура элемента RFBrthCert
Параметр Описание Обязательное Пример
rf_brth_cert_type Свидетельство о рождении, выданное в России + Составной элемент EGRZAGS
Структура элемента MarriedCert
Параметр Описание Обязательное Пример
married_cert Свидетельство о заключении брака + Составной элемент EGRZAGS
act_record_found Признак наличия связанной с этим свидетельством записи АГС + true
act_record Запись АГС о регистрации брака - Составной элемент MarriedRecord
Структура элемента DivorceCert
Параметр Описание Обязательное Пример
divorce_cert Свидетельство о расторжении брака + Составной элемент EGRZAGS
act_record_found Признак наличия связанной с этим свидетельством записи АГС + false
act_record Запись АГС о расторжении брака - Составной элемент DivorceRecord
Структура элемента NameChangeCert
Параметр Описание Обязательное Пример
name_change_cert_type Свидетельство о перемене имени + Составной элемент EGRZAGS
Структура элемента FatherhoodCert
Параметр Описание Обязательное Пример
fatherhood_cert_type Свидетельство об установлении отцовства + Составной элемент EGRZAGS
Структура элемента DeathCert
Параметр Описание Обязательное Пример
death_cert_type Свидетельство о смерти + Составной элемент EGRZAGS
Структура элемента PassportHistory
Параметр Описание Обязательное Пример
passport_history_type Паспортное досье (история выданных паспортов) + Массив составных элементов PassportData
Структура элемента FidDoc
Параметр Описание Обязательное Пример
base_doc Серия, номер, дата выдачи документа + Составной элемент BaseDoc
Структура элемента MilitaryDoc
Параметр Описание Обязательное Пример
base_doc Серия, номер, дата выдачи документа + Составной элемент BaseDoc
issued_by Кем выдан военный билет +  
Структура элемента MedicalDoc
Параметр Описание Обязательное
number Номер полиса ОМС +
expiry_date Дата окончания срока действия полиса ОМС (указывается, если не бессрочный) -
region_name Наименование субъекта Российской Федерации территории страхования -
insurance_organization Наименование страховой медицинской организации (филиала) -
insurance_organization_code Реестровый номер страховой медицинской (филиала) -
medical_organization_oid OID медицинской организации -
medical_organization_address Адрес места нахождения медицинской организации (юридическое лицо) -
united_policy_number Единый номер полиса ОМС (ЕНП) -
start_date Дата начала действия полиса ОМС -
medical_organization Наименование медицинской организации (юридическое лицо) -
Структура элемента FidBrthCertDoc
Параметр Описание Обязательное Пример
base_doc Серия, номер, дата выдачи свидетельства + Составной элемент BaseDoc
issued_by Кем выдано свидетельство +  
Структура элемента OldBrthCertDoc
Параметр Описание Обязательное Пример
base_doc Серия, номер, дата выдачи свидетельства + Составной элемент BaseDoc
issued_by Кем выдано свидетельство +  
act_no Номер актовой записи -  
Структура элемента FrgnPassportDoc
Параметр Описание Обязательное Пример
base_doc Серия, номер, дата выдачи паспорта + Составной элемент BaseDoc
issued_by Кем выдан паспорт +  
latin_last_name Фамилия на латинском + Ivanov
latin_first_name Имя на латинском + Ivan
expiry_date Действителен до + 20.04.2023
Структура элемента RfDrivingLicenseDoc
Параметр Описание Обязательное Пример
base_doc Серия, номер, дата выдачи удостоверения + Составной элемент BaseDoc
issued_by Кем выдано удостоверение +  
expiry_date Действителен до +  
experience Водительский стаж (год выдачи первых прав) +  
categories Категории + Массив значений из словаря DrivingCategory
Структура элемента VehicleDoc
Параметр Описание Обязательное Пример
number_place Государственный регистрационный знак +  
series Серия СТС +  
number Номер СТС +  
vin VIN -  
brand Марка -  
model Модель -  
vehicle_category Категория ТС - Значения словаря DrivingCategory
production_year Год выпуска - 2005
engine_number Номер двигателя -  
body_number Номер кузова (прицепа) -  
chassis_number Номер шасси (рамы) -  
categories Категория - Значения словаря DrivingCategory
Структура элемента ILSPFR
Параметр Описание Обязательное Пример
request_number Системный номер запроса, на основании которого сформированы сведения +  
request_date Дата приема запроса, на основании которого сформированы сведения +  
spu_number Исходящий номер СПУ +  
formation_date Дата, на которую сформированы сведения +  
person_infromation Сведения о застрахованном лице + Составной элемент PersonInformation
pension_type Вариант пенсионного обеспечения в системе ОПС, выбранные застрахованным лицом 1967 года рождения и моложе. Возможные значения: 1 – направление страховых взносов на формирование только страховой пенсии; 2 – направление страховых взносов на формирование страховой и накопительной пенсии - 1
ipk Величина индивидуального пенсионного коэффициента (ИПК) (пенсионные баллы). В случае дробных чисел значение должно округляться до трех знаков после запятой + 19.542
experience Стаж застрахованного лица (учтенный для целей назначения пенсии) (лет, месяцев, дней) + Составной элемент Experience
early_pension_info Период работы, учитываемый для досрочного назначения страховой пенсии по старости - Массив составных элементов EarlyPensionInfo
regional_coefficient Районный коэффициент. В случае дробных чисел значение должно округляться до двух знаков после запятой - 1.40
ipk_info Сведения о величине индивидуального пенсионного коэффициента (ИПК) (пенсионные баллы), его составляющих и стаже (блок 1) + Cоставной элемент IpkInfo
pens_rights_till_2015 Сведения, на основании которых рассчитана величина ИПК за периоды до 2015 года (блок 2) - Cоставной элемент PensRightsTill2015
pfr_info Блок информации по средствам пенсионных накоплений застрахованного лица для случая, когда страховщик - ПФР (блок 3) - Cоставной элемент, который здесь не указан
npf_info Блок информации по средствам пенсионных накоплений застрахованного лица для случая, когда страховщик - НПФ (блок 4) - Cоставной элемент, который здесь не указан
pension Информация об установленных пенсионных выплатах застрахованному лицу. Заполняется в случае, если застрахованное лицо получает пенсию (блок 5) - Cоставной элемент, который здесь не указан
chief_person_information ФИО и должность руководителя территориального органа ПФР. Заполняется в случае получения формы в территориальном органе ПФР - Составной элемент ChiefPersonInformation
date Дата заполнения выписки + 20.05.2020
Структура элемента IncomeReference
Параметр Описание Обязательное Пример
inventory_filename Имя файла описи вложений +  
year Год, за который выдана справка + 2020
Структура элемента PensionReference
Параметр Описание Обязательное
xml_filename Имя файла справки о назначенных пенсиях и социальных выплатах в формате xml +
pdf_filename Имя файла справки о назначенных пенсиях и социальных выплатах в формате pdf +
Структура элемента ElectronicWorkbook
Параметр Описание Обязательное
xml_filename Ммя файла выписки о трудовой деятельности (электронная трудовая книжка) в формате xml +
pdf_filename Имя файла выписки о трудовой деятельности (электронная трудовая книжка) в формате pdf +
Структура элемента PreRetirementAge
Параметр Описание Обязательное
xml_filename Имя файла справки об отнесении гражданина к категории граждан предпенсионного возраста в формате xml +
pdf_filename Имя файла справки об отнесении гражданина к категории граждан предпенсионного возраста в формате pdf +
Структура элемента DisabledPerson
Параметр Описание Обязательное
xml_filename Имя файла справки об инвалидности в формате xml +
pdf_filename Имя файла справки об инвалидности в формате pdf +
Структура элемента StatementData
Параметр Описание Обязательное  
assignments Сведения о фактах назначения - Составной элемент AssignmentData
obligations Сведения о бюджетных обязательствах для указанного СНИЛС - Составной элемент ObligationData
assignees Сведения о фактах назначения - Составной элемент AssigneeData
incomes Сведения о доходах - Составной элемент IncomeData
Структура элемента FamilyAssetsBalance
Параметр Описание Обязательное Пример
is_sert Признак наличия прав на материнский капитал + true
primary_sum_balance Сумма баланса, если гражданин не использовал сертификат -  
rest_sum_balance Сумма остатка баланса материнского капитала, если гражданин использовал сертификат -  
date Дата формирования справки + 15.12.2020
Структура элемента BssData
Параметр Описание Обязательное
ogrn ОГРН +
filename Наименование файла с выпиской из ЕГРИП +
Структура элемента OrgData
Параметр Описание Обязательное
ogrn ОГРН +
filename Наименование файла с выпиской из ЕГРЮЛ +
Структура элемента EGRZAGS

Базовый тип для описания сведений из ЕГР ЗАГС (свидетельств о рождении, смерти, заключении брака, расторжении брака, перемени имени, установлении отцовства)

Параметр Описание Обязательное Пример
base_doc Серия, номер, дата свидетельства + Составной элемент BaseDoc
issued_by Полное наименование органа ЗАГС, которым произведена государственная регистрация акта гражданского состояния +  
act_no Номер записи акта гражданского состояния +  
act_date Дата составления записи акта гражданского состояния - 25.10.2010
Структура элемента PassportData
Параметр Описание Обязательное Пример
base_doc Серия, номер, дата выдачи паспорта + Составной элемент BaseDoc
issued_by Кем выдан паспорт -  
issued_id Код подразделения -  
passport_type Тип паспорта + Значение из словаря PassportType
passport_status Статус паспорта + Значение из словаря PassportStatus
invalidity_reason Причина недействительности - Значение из словаря InvalidityReason
Структура элемента BaseDoc
Параметр Описание Обязательное Пример
series Серия документа - 1111
number Номер документа + 123456
issued Дата выдачи документа 10.08.2009  
Структура элемента PersonInformation
Параметр Описание Обязательное
last_name Фамилия застрахованного лица +
first_name Имя застрахованного лица +
middle_name Отчество застрахованного лица -
birth_date Дата рождения застрахованного лица +
snils Страховой номер индивидуального лицевого счета застрахованного лица +
Структура элемента Experience
Параметр Описание Обязательное  
serv_len_years Количество лет + 12
serv_len_months Количество месяцев + 10
serv_len_days Количество дней + 14
Структура элемента EarlyPensionInfo
Параметр Описание Обязательное  
reason Основание для досрочного назначения страховой пенсии по старости +  
experience Продолжительность периода работы (лет, месяцев, дней) - Составной элемент Experience
Структура элемента ChiefPersonInformation
Параметр Описание Обязательное
surname Фамилия должностного лица +
name Имя должностного лица +
patronymic Отчество должностного лица -
position Должность лица +
Структура элемента ProofBlock
Параметр Описание Обязательное  
status Статус достоверности персональных данных пользователя - Значение словаря ProofStatus
legal_force Возможность проверить подлинность данных, полученных из ГИС (документы, подписанные ЭП ведомства) - true
receipt_doc_date Дата и время получения документа в формате timestamp - 1476445500000
validate_date_doc Дата и время валидации документа в формате timestamp - 1476445500000
Структура элемента MarriedRecord
Параметр Описание Обязательное Пример
proof_block Сведения о достоверности персональных данных пользователя - Составной элемент ProofBlock
act_no Номер записи акта о заключении брака +  
version_no Номер версии записи +  
version_date Дата версии записи + 2020-01-20
act_incomplete_date Дата регистрации записи по представленным документам -1 Составной элемент ActIncompleteDate
act_date Дата составления записи акта о заключении брака -1 2020-04-04
registry_office Сведения об органе ЗАГС, которым произведена государственная регистрация заключения брака + Составной элемент RegistryOffice
record_status Сведения о состоянии и статусе записи акта о заключении брака + Составной элемент RecordStatus
certs Сведения о выданном свидетельстве о заключении брака - Последовательность элементов Cert
marriage_info Передаваемые сведения о государственной регистрации заключения брака + Составной элемент MarriageInfo
record_correction Сведения о внесенных исправлениях и изменениях в запись акта о заключении брака - Последовательность элементов ZagsChangesInRecord
record_recovery Сведения о восстановлении записи акта о заключении брака - Составной элемент ZagsChangesInRecord
record_cancelling Сведения об аннулировании записи акта о заключении брака - Составной элемент ZagsChangesInRecord

1 - обязательно присутствует только один из элементов

Структура элемента DivorceRecord
Параметр Описание Обязательное Пример
proof_block Сведения о достоверности персональных данных пользователя - Составной элемент ProofBlock
act_no Номер записи акта о расторжении брака +  
version_no Номер версии записи +  
version_date Дата версии записи + 2020-01-04
act_incomplete_date Дата регистрации записи по представленным документам (неполная дата) -1 Составной элемент ActIncompleteDate
act_date Дата составления записи акта о расторжении брака -1 2020-10-20
registry_office Сведения об органе ЗАГС, которым произведена государсвенная регистрация расторжения брака + Составной элемент RegistryOffice
record_status Сведения о состоянии и статусе записи акта о расторжении брака + Составной элемент RecordStatus
certs Сведения о выданном Свидетельстве о расторжении брака - Последовательность элементов Cert
divorce_info Передаваемые сведения о государственной регистрации расторжения брака + Составной элемент DivorceInfo
record_correction Сведения о внесенных исправлениях и изменениях в запись акта о расторжении брака - Последовательность элементов ZagsChangesInRecord
record_recovery Сведения о восстановлении записи акта о расторжении брака - Составной элемент ZagsChangesInRecord
record_cancelling Сведения об аннулировании записи акта о расторжении брака - Составной элемент ZagsChangesInRecord

1 - обязательно должен присутствовать только один из элементов

Структура элемента ActIncompleteDate
Параметр Описание Обязательное Пример
day Сведения о дне в соответствии с представленными документами - 10
month Сведения о месяце в соответствии с представленными документами - 04
year Сведения о годе в соответствии с представленными документами + 2009
Структура элемента RegistryOffice
Параметр Описание Обязательное
name Полное наименование органа ЗАГС, которым произведена государственная регистрация акта гражданского состояния -
code Код органа ЗАГС -
Структура элемента RecordStatus
Параметр Описание Обязательное
start_date Дата начала действия состояния и статуса записи акта гражданского состояния -
status_code Код состояния и статуса записи акта гражданского состояния по справочнику СОСТАГС -
status_name Наименование состояния и статуса записи акта гражданского состояния по справочнику СОСТАГС -
Структура элемента Cert
Параметр Описание Обязательное Пример
cert_type Тип выданного свидетельства +  
series Серия свидетельства -  
number Номер свидетельства -  
issue_date Дата выдачи свидетельства (календарная дата) -1  
issue_incomplete_date Дата выдачи свидетельства по представленным документам (неполная дата) -1  
civil_registry_office Сведения об органе ЗАГС, которым было выдано свидетельство о заключении(расторжении) брака - Cоставной элемент RegistryOffice

1 - может присутствовать только один из элементов

Структура элемента MarriageInfo
Параметр Описание Обязательное Пример
marriage_incomplete_date Дата заключения брака (неполная дата) -1 Составной элемент ActIncompleteDate
marriage_date Дата заключения брака -1 2020-01-04
husband Супруг - Составной элемент Partner
wife Супруга - Составной элемент Partner

1 - должен присутствовать только один из элементов

Структура элемента DivorceInfo
Параметр Описание Обязательное Пример
divorce_incomplete_date Дата расторжения брака (неполная дата) -1 Составной элемент ActIncompleteDate
divorce_date Дата расторжения брака -1 2020-08-12
ex_husband Бывший супруг + Составной элемент Partner
ex_wife Бывшая супруга + Составной элемент Partner

1 - должен присутствовать только один из элементов

Структура элемента Partner
Параметр Описание Обязательное Пример
snils СНИЛС - 123-456-789 10
last_name_before Фамилия до заключения брака -  
last_name_after Фамилия после заключения брака -  
first_name Имя -  
middle_name Отчество -  
citizenship Сведения о гражданстве - Составной элемент CitizenshipData
birth_incomplete_date Дата рождения по представленным документам -1 Составной элемент ActIncompleteDate
birth_date Дата рождения (календарная дата) -1 2020-04-01
birth_place Место рождения - Составной элемент BirthPlaceType
home_address Адрес места жительства - Составной элемент HomeAddressType
id_doc Сведения о документе, удостоверяющем личность - Составной элемент IdDoc

1 - может присутствовать только один из элементов

Структура элемента CitizenshipData
Параметр Описание Обязательное
oksm ОКСМ -
country_name Наименование страны -
Структура элемента BirthPlaceType
Параметр Описание Обязательное
place_sign Признак принадлежности адреса к территории РФ или к территории за пределами РФ -
place_str Место (текстом) -
country_code Код страны -
country_name Полное наименование страны -
region_code Регион -
region_name Наименование субъекта Российской Федерации -
municipality Наименование района -
settlement Наименование города -
locality Наименование населенного пункта -
oktmo ОКТМО -
Структура элемента HomeAddressType
Параметр Описание Обязательное Пример
address_in_russia Адрес места жительства на территории Российской Федерации -1 Составной элемент AddressInRussia
address_outside_russia Адрес места жительства за пределами Российской Федерации 1 Составной элемент AddressOutsideRussia
non_classified_address Не классифицируемый адрес места жительства 1  

1 - обязательно присутствует только один из элементов

Структура элемента AddressInRussia
Параметр Описание Обязательное Пример
address_fias Адрес места жительства на территории Российской Федерации, введенный по ФИАС - Составной элемент AddressFias
address_str Адрес места жительства физического лица, который будет указан в печатной форме Свидетельства и актовой записи, для которого не указан аналог из ФИАС    
Структура элемента AddressFias
Параметр Описание Обязательное
address_fias_str Адрес места жительства на территории Российской Федерации, указанный в печатной форме Свидетельства и актовой записи -
oktmo ОКТМО -
fias_code Уникальный идентификационный номер -
zip_code Почтовый индекс -
region_code Код субъекта Российской Федерации -
region_name Наименование субъекта Российской Федерации -
municipality Район -
settlement Город -
locality Населенный пункт -
street Улица -
house Дом -
frame Корпус -
flat Квартира -
Структура элемента AddressOutsideRussia
Параметр Описание Обязательное
oksm Код страны. Принимает значение цифрового кода в соответствии с Общероссийским классификатором стран мира ОК 025-2001 (ОКСМ) -
country_name Полное наименование страны. Принимает значение в соответствии с Общероссийским классификатором стран мира ОК 025-2001 (ОКСМ) -
foreign_address Адрес места жительства физического лица, проживающего за пределами Российской Федерации, который будет указан в печатной форме Свидетельства и актовой записи -
Структура элемента IdDoc
Параметр Описание Обязательное Пример
doc_code Код вида документа, удостоверяющего личность. Принимает значение в соответствии со справочником «Виды документов, удостоверяющих личность налогоплательщика» (СПДУЛ) -  
doc_name Серия и номер документа, удостоверяющего личность. Принимает значение в соответствии со справочником «Виды документов, удостоверяющих личность налогоплательщика» (СПДУЛ) -  
doc_ser_num Серия и номер документа, удостоверяющего личность -  
doc_date Дата выдачи документа, удостоверяющего личность (календарная дата) -1 2020-04-25
doc_incomplete_date Дата выдачи документа, удостоверяющего личность (неполная дата) -1 Составной элемент ActIncompleteDate
issued_by Наименование органа, выдавшего документ, удостоверяющий личность -  
issue_id Код подразделения органа, выдавшего документ, удостоверяющий личность -  

1 - может присутствовать только один из элементов

Структура элемента ZagsChangesInRecord
Параметр Описание Обязательное Пример
record_type_code Код вида записей по справочнику СВЗАГС, внесенных в запись акта гражданского состояния, при исправлении и изменении, при внесении отметки о восстановлении или об аннулировании записи гражданского состояния -  
record_type_name Наименование вида записей по справочнику СВЗАГС -  
correction_date Дата внесения исправления и изменения в запись акта гражданского состояния или дата внесения отметки о восстановлении или об аннулировании записи акта гражданского состояния - 2020-05-25
correction_content Содержание вынесенного исправления или изменения -  
correction_doc Сведения о документе, на основании которого внесены исправления и изменения в запись акта гражданского состояния - Составной элемент CorrectionDoc
Структура элемента CorrectionDoc
Параметр Описание Обязательное Пример
record_requisites Сведения о реквизитах записи акта гражданского состояния -1 Составной элемент RecordRequisites
another_doc_requisites Сведения о реквизитах иного документа -1 Составной элемент AnotherDocRequisites

1 - обязательно присутствует только один из элементов

Структура элемента RecordRequisites
Параметр Описание Обязательное Пример
act_type Тип записи акта гражданского состояния -  
act_type_name Наименование типа акта гражданского состояния -  
act_no Номер записи акта гражданского состояния -  
act_date Дата составления записи акта гражданского состояния -  
civil_registry_office Сведения об органе ЗАГС, которым произведена государственная регистрация гражданского состояния - Составной элемент RegistryOffice
Структура элемента AnotherDocRequisites
Параметр Описание Обязательное Пример
doc_code Код вида документа. Принимает значение в соответствии со Справочником видов документов, используемых при государственной регистрации актов гражданского состояния и при совершении иных юридически значимых действий (СДРАГС) -  
doc_name Наименование документа -  
doc_ser_num Серия и номер документа -  
doc_date Дата документа (календарная дата) -1 2020-04-20
doc_incomplete_date Дата документа (неполная дата) -1 Составная дата ActIncompleteDate
org_name Наименование органа, выдавшего документ -2  
individual_entrepreneur_full_name Фамилия, имя, отчество индивидуального предпринимателя -2 Составной элемент FullName
person_full_name Фамилия, имя, отчество физического лица -2 Составной элемент FullName

1, 2 - может присутствовать только один из элементов

Структура элемента IpkInfo
Параметр Описание Обязательное Пример
ipk_before_2015 Сведения о величине индивидуального пенсионного коэффициента (ИПК)(пенсионные баллы), его составляющих и стаже до 2015 года - Составной элемент IpkBefore2015
ipk_since_2015 Сведения о величине индивидуального пенсионного коэффициента (ИПК)(пенсионные баллы), его составляющих и стаже с 1 января 2015 года - Составной элемент IpkSince2015
ipk_current_year Сведения о величине индивидуального пенсионного коэффициента (ИПК) (пенсионные баллы), его составляющих и стаже за текущий год поквартально - Составной элемент IpkCurrentYear
Структура элемента IpkBefore2015
Параметр Описание Обязательное Пример
ipk Величина индивидуального пенсионного коэффициента (ИПК) до 2015 года +  
experience Продолжительность периодов работы, иных периодов (лет, месяцев, дней) + Составной элемент Experience
Структура элемента IpkSince2015
Параметр Описание Обязательное Пример
for_a_year Сведения о величине индивидуального пенсионного коэффициента (ИПК) (пенсионные баллы), его составляющих и стаже с 1 января 2015 года за конкретный год + Последовательность элементов YearIpk
Структура элемента YearIpk
Параметр Описание Обязательное Пример
year Конкретный год + 2016
employers Сведения по работодателям. Указывается информация в разрезе работодателей с агрегацией ИПК за год - Составной элемент IpkEmployer
other_periods Сведения об ином периоде работы - Последовательность элементов IpkOtherPeriod
Структура элемента IpkEmployer
Параметр Описание Обязательное Пример
ipk Величина ИПК с 1 января 2015 года по всем работодателям за год. В случае дробных чисел значение должно округляться до трех знаков после запятой +  
by_employer Сведения о составляющих ИПК, стаже по конкретному работодателю + Последовательность элементов IpkByEmployer
Структура элемента IpkByEmployer
Параметр Описание Обязательное Пример
employer Данные работодателя + Составной элемент Employer
time_period Период работы + Составной элемент TimePeriod
quarter Номер квартала, за который учтена сумма по данному страхователю - Последовательность номеров кварталов
payments_sum Сумма выплат и иных вознаграждений, начисленных в пользу застрахованного лица (руб., коп.) + 42
acc_payment Сумма начисленных страховых взносов на страховую пенсию, на основании которой рассчитана величина индивидуального коэффициента (руб., коп.) + 42
experience Продолжительность периодов работы (лет, месяцев, дней) - Составной элемент Experience
early_pension_info Сведения о периоде работы, учитываемом в этом периоде для досрочного назначения страховой пенсии по старости - Последовательность элементов EarlyPensionInfo
Структура элемента Employer
Параметр Описание Обязательное
ent_number Регистрационный номер работодателя, присваиваемый ПФР -
ent_nam Наименование работодателя -
Структура элемента TimePeriod
Параметр Описание Обязательное Пример
beg Дата начала периода (дата "с") + 01.09.2016
end Дата окончания периода (дата "по") + 01.10.2016
Структура элемента IpkOtherPeriod
Параметр Описание Обязательное Пример
period_name Наименование иного периода +  
time_period Период работы + Составной элемент TimePeriod
ipk Величина ИПК с 1 января 2015 по иному периоду работы. В случае дробных чисел значение должно округляться до трех знаков после запятой +  
experience Продолжительность иного периода (лет, месяцев, дней) + Составной элемент Experience
Структура элемента IpkCurrentYear
Параметр Описание Обязательное Пример
current_year Текущий год + 2020
current_year_pens_factor Величина индивидуального пенсионного коэффициента (ИПК) +  
quarter_periods Сведения за квартал + Последовательность элементов IpkQuarter
Структура элемента IpkQuarter
Параметр Описание Обязательное Пример
quarter Квартал - 4
detail_employer Данные за квартал по работодателям + Последовательность элементов IpkDetailEmployer
Структура элемента IpkDetailEmployer
Параметр Описание Обязательное Пример
employer Данные работодателя + Составной элемент Employer
payments_sum Сумма выплат и иных вознаграждений, начисленных в пользу застрахованного лица (руб., коп.) +  
acc_payment Сумма начисленных страховых взносов на страховую пенсию, на основании которой рассчитана величина индивидуального пенсионного коэффициента (руб., коп.) + 42
Структура элемента AssignmentData
Параметр Описание Обязательное Пример
assignment Данные о назначении - Последовательность элементов Assignment
Структура элемента Assignment
Параметр Описание Обязательное Пример
reason_persons Сведения о лицах, являющихся основанием для назначения меры - Составной элемент ReasonPersons
onmsz_title Наименование ОНМСЗ, осуществившего назначение МСЗ +  
kmsz_code Код по КМСЗ +  
category_title Наименование присвоенной локальной категории +  
onmsz_code Код ОНМСЗ, осуществившего назначение МСЗ +  
lmsz_title Наименование назначенной МСЗ +  
decision_date Дата принятия решения о назначении + 2020-04-04
date_start Дата начала действия назначения + 2020-06-01
date_finish Дата окончания действия назначения -  
form Форма предоставления +  
periodicity Код периодичности предоставления +  
amount Размер назначения +  
measure_unit Код единицы измерения размера назначения +  
comment Комментарий -  
description Содержание назначения -  
need_criterion Признак использования критериев нуждаемости + true
Структура элемента ReasonPersons
Параметр Описание Обязательное Пример
reason_person Сведения о лице, являющееся основанием для назначения меры + Последовательность элементов ReasonPerson
Структура элемента ReasonPerson
Параметр Описание Обязательное Пример
reason_snils СНИЛС лица - основания +  
physical_person_qualified_name_model_group Фамилия, имя, отчество лица - основания +  
birth_date Дата рождения лица - основания + 2010-04-04
Структура элемента ObligationData
Параметр Описание Обязательное Пример
obligation Сведения о бюджетных обязательствах для указанного СНИЛС - Последовательность элементов Obligation
Структура элемента Obligation
Параметр Описание Обязательное Пример
kmsz_code Код по КМСЗ +  
onmsz_title Наименование ОСЗ, осуществившего назначение МСЗ +  
lmsz_title Наименование назначенной ЛМСЗ +  
category_title Наименование присвоенной локальной категории +  
decision_date Дата принятия решения о назначении + 2020-10-21
date_start Дата начала действия назначения + 2020-11-01
date_finish Дата окончания действия назначения - 2020-11-01
periodicity Код периодичности представления +  
amount Обязательство по назначенной выплате +  
payments Обязательства по месяцам - Последовательность элементов ObligationPayment
Структура элемента ObligationPayment
Параметр Описание Обязательное Пример
year Год + 2020
month Месяц (Январь = 1) + 2
amount Сумма обязательств в указанный месяц +  
Структура элемента AssigneeData
Параметр Описание Обязательное Пример
assignee Сведения о фактах назначения - Последовательность элементов Assignee
Структура элемента Assignee
Параметр Описание Обязательное Пример
snils СНИЛС умершего лица +  
decision_number Номер решения +  
decision_date Дата решения о выплате + 2020-01-17
assign_amount Сумма выплаты +  
Структура элемента IncomeData
Параметр Описание Обязательное Пример
month_income Сведения о доходах - Последовательность элементов Income
Структура элемента Income
Параметр Описание Обязательное Пример
year Год + 2020
month Месяц (Январь = 1) + 2
organization Наименование организации +  
amount Сумма выплат и иных вознаграждений за месяц +  
insure_deposit Из них сумма выплат и иных вознаграждений, на который были начислены страховый взносы +  

Примеры

В тестовой среде СМЭВ 3 доступен один тестовый сценарий, который на любой валидный запрос отвечает одним и тем же ответом. Запрос:

{
  "routing_code": "DEV",
  "oid": "1000376121",
  "data_type": "fullName"
}

Ответ:

{
  "personal_data": {
    "data_type": "fullName",
    "data_entries": [
      {
        "full_name": {
          "last_name": "Иванов",
          "first_name": "Иван",
          "middle_name": "Иванович"
        },
        "proof_block": {
          "status": "verified_by_validate"
        }
      }
    ]
  }
}

Набор HTTP запросов

Файл набора HTTP запросов - это файл, созданный в приложении Postman, который содержит набор HTTP запросов, ответов и сопутствующей информации, связанной с тестированием API.

Коллекция в Postman обычно включает в себя следующую информацию:

  1. HTTP запросы: GET, POST, PUT, DELETE и другие типы запросов.
  2. Параметры запросов: параметры пути, параметры запроса, тело запроса, заголовки запроса и другие параметры.
  3. Ожидаемые ответы: коды ответов, тела ответов и заголовки ответов.
  4. Тесты: наборы скриптов, которые используются для проверки правильности ответов на запросы.
  5. Переменные: значения переменных, которые могут использоваться в разных запросах, чтобы избежать повторений.

Загрузить файл с набором HTTP запросов