МЕТОДИЧЕСКИЕ РЕКОМЕНДАЦИИ ПО ИНТЕГРАЦИИ С REST API ЦИФРОВОГО ПРОФИЛЯ (Версия 1.60) - часть 4

 

  Главная      Книги - Разные     МЕТОДИЧЕСКИЕ РЕКОМЕНДАЦИИ ПО ИНТЕГРАЦИИ С REST API ЦИФРОВОГО ПРОФИЛЯ (Версия 1.60)

 

поиск по сайту            правообладателям  

 

   

 

    

 

содержание      ..     2      3      4     

 

 

 

 

МЕТОДИЧЕСКИЕ РЕКОМЕНДАЦИИ ПО ИНТЕГРАЦИИ С REST API ЦИФРОВОГО ПРОФИЛЯ (Версия 1.60) - часть 4

 

 

303
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
17.
recordInfo
Сведения
о
записи
обязательно
Блок,
состоящий
ЕГРЮЛ
из элемента (п.17.1)
17.1.
reason
Информация
о виде
обязательно
Блок,
состоящий
записи
из
следующих
элементов (пп.17.1.1
-17.1.2)
17.1.1.
recordCode
Код СПВЗ
обязательно
Строка
17.1.2.
recordName
Наименование
вида
обязательно
Строка
записи
17.2
recordId
ИД записи ЕГРЮЛ
обязательно
Строка
17.3
recordGRN
Номер ГРН
необязательно
Строка
17.4
recordDate
Дата записи
обязательно
Дата в формате:
ГГГГ-ММ-ДД
17.5
registrationAgency
Сведения
обязательно
Блок,
состоящий
о
регистрирующем
из
следующих
(налоговом)
органе,
элементов
внесшем
запись
(пп. 17.5.1 - 17.5.2)
в ЕГРЮЛ
17.5.1
registrationAgencyCode
Код НО
обязательно
Строка
17.5.2
registrationAgencyName
Наименование НО
обязательно
Строка
18.
certificateInfo
Сведения свидетельства
необязательно
Блок,
состоящий
из
следующих
элементов
(пп. 18.1 - 18.3)
18.1.
certificateDate
Дата выдачи
необязательно
Дата в формате:
свидетельства
ГГГГ-ММ-ДД
18.2.
certificateNumber
Номер свидетельства
необязательно
Строка
18.3.
certificateSeries
Серия сертификата
необязательно
Строка
19
registrationAgencyInfo
Сведения
обязательно
Блок,
состоящий
о регистрирующем органе
из
следующих
304
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
по месту нахождения
элементов
юридического лица
(пп. 19.1)
19.1
registrationAgency
Сведения
обязательно
Блок,
состоящий
о
регистрационном
из
следующих
номере
элементов
(пп. 19.1.1 - 19.1.3)
19.1.1
registrationAgencyCode
Код НО
обязательно
Строка
19.1.2
registrationAgencyName
Наименование РО
обязательно
Строка
19.1.3
registrationAgencyAddress
Адрес НО
необязательно
Строка
19.2
grnDate
ГРН и дата внесения
обязательно
Блок,
состоящий
в
ЕГРЮЛ
записи,
из
следующих
содержащей указанные
элементов
сведения
(пп. 19.2.1 - 19.2.2)
19.2.1
date
Дата внесения записи
обязательно
Дата в формате:
в ЕГРЮЛ
ГГГГ-ММ-ДД
19.2.2
number
Номер ГРН
необязательно
Строка
20.
addressInfo
Информация об адресе
обязательно
Блок,
состоящий
ЮЛ
из
элемента
(п. 20.1)
20.1.
addressInRussia
Адрес ЮЛ в РФ
обязательно
Блок,
состоящий
из
следующих
элементов
(пп. 20.1.1 - 20.1.4)
20.1.1.
house
Дом
необязательно
Строка
20.1.2.
building
Корпус
необязательно
Строка
20.1.3.
kladrCode
Код адресный КЛАДР
необязательно
Строка
20.1.4.
regionCode
Код региона
обязательно
Строка
20.1.5
region
Субъект РФ
обязательно
Блок,
состоящий
из
следующих
элементов
305
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
(пп.
20.1.5.1
-
20.1.5.2)
20.1.5.1
regionName
Тип элемента регион
обязательно
Строка
20.1.5.2
regionType
Наименование региона
обязательно
Строка
20.1.6
street
Улица (проспект,
необязательно
Блок,
состоящий
переулок и т.п.)
из
следующих
элементов
(пп.
20.1.6.1
-
20.1.6.2)
20.1.6.1
streetName
Наименование (элемент
обязательно
Строка
улица)
20.1.6.2
streetType
Тип адресного объекта
необязательно
Строка
улица
20.1.7
zipCode
Индекс
необязательно
Строка
20.1.8
locality
Населенный пункт (село
необязательно
Блок,
состоящий
и тп.)
из
следующих
элементов
(пп.
20.1.8.1
-
20.1.8.2)
20.1.8.1
localityName
Наименование (элемент
обязательно
Строка
населенный пункт)
20.1.8.2
localityType
Тип элемента населенный
необязательно
Строка
пункт
20.1.9
apartment
Номер квартиры
необязательно
Строка
20.1.10
settlement
Город (волость и тп.)
необязательно
Блок,
состоящий
из
следующих
элементов
(пп.
20.1.10.1
-
20.1.10.2)
20.1.10.1
settlementName
Наименование (элемент
обязательно
Строка
город)
306
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
20.1.10.2
settlementType
Тип элемента город
обязательно
Строка
(город, волость и тп.)
20.1.11
municipality
Район (улус и тп.)
необязательно
Блок,
состоящий
из
следующих
элементов
(пп.
20.1.11.1
-
20.1.11.2)
20.1.11.1
municipalityName
Наименование (элемент
обязательно
Строка
район)
20.1.11.2
municipalityType
Тип элементка район
обязательно
Строка
(район, улус и тп.)
20.1.12
grnDateCorrection
ГРН и дата внесения
необязательно
Блок,
состоящий
в
ЕГРЮЛ
записи
из
следующих
об
исправлении
элементов
технической
ошибки
(пп.
20.1.12.1
-
в указанных сведениях
20.1.12.2)
20.1.12.1
date
Дата внесения записи
обязательно
Дата в формате:
в ЕГРЮЛ
ГГГГ-ММ-ДД
20.1.12.2
number
ГРН записи ЕГРЮЛ
необязательно
Строка
20.1.13
grnDate
ГРН и дата внесения
необязательно
Блок,
состоящий
в ЕГРЮЛ записи
из
следующих
элементов
(пп.
24.1.13.1
-
21.1.13.2)
20.1.13.1
date
Дата внесения записи
обязательно
Дата в формате:
в ЕГРЮЛ
ГГГГ-ММ-ДД
20.1.13.2
number
ГРН записи ЕГРЮЛ
необязательно
Строка
20.2.
addressFIAS
Адрес ФИАС
необязательно
Блок,
состоящий
из
следующих
элементов
(пп. 20.2.1 - 20.2.4)
20.2.1
house
Здание/сооружение
необязательно
Блок,
состоящий
из
следующих
307
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
элементов
(пп.
20.2.1.1
-
20.2.1.2)
Максимум 3 блока
20.2.1.1
houseNum
Номер элемента
обязательно
Строка
20.2.1.2
houseType
Тип элемента
обязательно
Строка
20.2.2
idGAR
Уникальный
необязательно
Строка
идентификатор адресного
объекта в ГАР
20.2.3
region
Субъект
Российской
обязательно
Строка
Федерации (код)
20.2.4
grnDate
ГРН и дата внесения
обязательно
Блок,
состоящий
в
ЕГРЮЛ
записи,
из
элементов
содержащей указанные
(п. 20.2.4.1-20.2.4.2)
сведения
20.2.4.1
date
Дата внесения записи
обязательно
Дата в формате:
в ЕГРЮЛ
ГГГГ-ММ-ДД
20.2.4.2
number
ГРН записи ЕГРЮЛ
необязательно
Строка
20.2.5
roadNet
Элемент
улично-
необязательно
Блок,
состоящий
дорожной сети
из
следующих
элементов
(пп.
20.2.5.1
-
20.2.5.2)
20.2.5.1
roadNetName
Наименование элемента
обязательно
Строка
20.2.5.2
roadNetType
Тип элемента
обязательно
Строка
20.2.6
zipCode
Индекс
необязательно
Строка
20.2.7
building
Помещение в пределах
необязательно
Блок,
состоящий
здания, сооружения
из
следующих
элементов
(пп.
20.2.7.1
-
20.2.7.2)
20.2.7.1
buildingNum
Наименование элемента
обязательно
Строка
308
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
20.2.7.2
buildingType
Тип элемента
обязательно
Строка
20.2.8
district
Городское поселение
/
необязательно
Блок,
состоящий
сельское поселение
/
из
следующих
межселенная территория
элементов
в составе муниципального
(пп.
20.2.8.1
-
района / внутригородской
20.2.8.2)
район городского округа
20.2.8.1
districtName
Наименование элемента
обязательно
Строка
20.2.8.2
districtType
Вид (код) элемента
обязательно
Строка
20.2.9
apartment
Помещение в пределах
необязательно
Блок,
состоящий
квартиры
из
следующих
элементов
(пп.
20.2.9.1
-
20.2.9.2)
20.2.9.1
apartmentNum
Номер элемента
обязательно
Строка
20.2.9.2
apartmentType
Тип элемента
обязательно
Строка
20.2.10
regionName
Наименование субъекта
обязательно
Строка
Российской Федерации
20.2.11
settlement
Населенный пункт (город,
необязательно
Блок,
состоящий
деревня,
село
из
следующих
и прочее)
элементов
(пп.
20.2.11.1
-
20.2.11.2)
20.2.11.1
settlementName
Наименование элемента
обязательно
Строка
20.2.11.2
settlementType
Вид элемента
обязательно
Строка
20.2.12
municipality
Муниципальный район/
необязательно
Блок,
состоящий
городской
округ/
из
следующих
внутригородская
элементов
территория
города
(пп.
20.2.12.1
-
федерального значения/
20.2.12.2)
муниципальный округ
20.2.12.1
municipalityName
Наименование элемента
обязательно
Строка
309
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
20.2.12.2
municipalityType
Вид элемента
обязательно
Строка
20.2.13
planningStruct
Элемент планировочной
необязательно
Блок,
состоящий
структуры
из
следующих
элементов
(пп.
20.2.13.1
-
20.2.13.2)
20.2.13.1
planningStructName
Наименование элемента
обязательно
Строка
20.2.13.2
planningStructType
Тип элемента
обязательно
Строка
20.2.14
grnDateCorrection
ГРН и дата внесения
необязательно
Блок,
состоящий
в
ЕГРЮЛ
записи
из
следующих
об
исправлении
элементов
технической
ошибки
(пп.
20.2.14.1
-
в указанных сведениях
20.2.14.2)
20.2.14.1
date
Дата внесения записи
обязательно
Дата в формате:
в ЕГРЮЛ
ГГГГ-ММ-ДД
20.2.14.2
number
ГРН записи ЕГРЮЛ
необязательно
Строка
21.
capitalInfo
Сведения об уставном
необязательно
Блок,
состоящий
капитале
из
элементов
(п. 25.1)
21.1.
grnDate
Информация
о
дате
обязательно
Блок,
состоящий
последних
изменения
из
следующих
в разделе
элементов
(пп. 21.1.1-21.1.2)
21.1.1.
date
Дата записи
обязательно
Дата в формате:
ГГГГ-ММ-ДД
21.1.2.
number
Номер записи
необязательно
Строка
21.2
capitalSum
Сумма
уставного
обязательно
Строка
капитала
21.3
capitalTypeName
Наименование вида
обязательно
Строка
капитала
310
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
22.
founderInfo
Сведения об учредителе
необязательно
Блок,
состоящий
ЮЛ
из
элемента
(п. 22.1)
22.1.
personFounder
Сведения
о
ФЛ
необязательно
Блок,
состоящий
учредителе ЮЛ
из
элемента
(п. 22.1.1)
22.1.1.
personInfo
Сведения о ФЛ
обязательно
Блок,
состоящий
из
следующих
элементов
(пп.
22.1.1.1
-
22.1.1.3)
22.1.1.1.
lastName
Фамилия
необязательно
Строка
22.1.1.2.
firstName
Имя
необязательно
Строка
22.1.1.3.
middleName
Отчество
необязательно
Строка
23.
registrationInfo
Сведения об образовании
обязательно
Блок,
состоящий
ЮЛ
из
следующих
элементов
(пп. 23.1 - 23.3)
23.1.
ogrn
ОГРН
обязательно
Строка
23.2.
grnDate
Сведения о последних
обязательно
Блок,
состоящий
изменениях
записи
из
следующих
в
разделе
элементов
«registrationInfo»
(пп. 23.2.1 - 23.2.2)
23.2.1.
date
Дата записи
обязательно
Дата в формате:
ГГГГ-ММ-ДД
23.2.2.
number
Номер записи
обязательно
Строка
23.3.
ogrnDate
Дата ОГРН
обязательно
Строка
23.4
formationWay
Сведения о способе
обязательно
Блок, состоящий
образования ЮЛ
из следующих
элементов
(пп. 23.4.1 - 23.4.2)
311
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
23.4.1.
formationWayCode
Код способа образования
обязательно
Строка
ЮЛ
23.4.2.
formationWayName
Наименование способа
необязательно
Строка
образования ЮЛ
24.
taxAccountingInfo
Сведения об учете в НО
необязательно
Блок, состоящий
из следующих
элементов
(пп. 24.1 - 24.3)
24.1.
inn
ИНН
обязательно
Строка
24.2.
kpp
КПП
обязательно
Строка
24.3.
grnDate
Сведения о последних
обязательно
Блок,
состоящий
изменениях
записи
из
следующих
в
разделе
элементов
«taxAccountingInfo»
(пп. 24.3.1 - 24.3.2)
24.3.1.
date
Дата записи
обязательно
Дата в формате:
ГГГГ-ММ-ДД
24.3.2.
number
Номер записи
необязательно
Строка
24.4
taxAgency
Сведения о НО
обязательно
Блок,
состоящий
из
следующих
элементов
(пп. 24.4.1 - 24.4.2)
24.4.1.
taxAgencyCode
Код НО
обязательно
Строка
24.4.2.
taxAgencyName
Наименование НО
обязательно
Строка
24.5
registrationDate
Дата постановки на учет
обязательно
Дата в формате:
ГГГГ-ММ-ДД
25.
pensionRegistrationInfo
Сведения о регистрации
необязательно
Блок,
состоящий
в СФР
из
элемента
(п. 25.1)
25.1.
grnDate
Сведения о последних
обязательно
Блок,
состоящий
изменениях
записи
из
следующих
в
разделе
элементов
(пп.
«pensionRegistrationInfo»
25.1.1-25.1.2)
312
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
25.1.1.
date
Дата записи
обязательно
Дата в формате:
ГГГГ-ММ-ДД
25.1.2.
number
Номер записи
необязательно
Строка
25.2
pensionRegistration
Сведения о регистрации
необязательно
Блок,
состоящий
в СФР
из
элемента
(п. 25.2)
25.2.1.
pensionAgency
Сведения о СФР
обязательно
Блок,
состоящий
из
следующих
элементов
(пп.
25.2.1.1
-
25.2.1.2)
25.2.1.1.
pensionAgencyCode
Код СФР
обязательно
Строка
25.2.1.2.
pensionAgencyName
Наименование СФР
обязательно
Строка
25.2.2
pensionRegDate
Дата регистрации
обязательно
Дата в формате:
ГГГГ-ММ-ДД
25.2.3
pensionRegNumber
Регистрационный номер
обязательно
Строка
в СФР
26.
economicActivitiesTypeInfo
Сведения ОКВЭД
необязательно
Блок,
состоящий
из
следующих
элементов
(пп. 26.1 - 26.2)
26.1.
mainEconomicActivity
Сведения
ОКВЭД
необязательно
Блок,
состоящий
основные
из
следующих
элементов
(пп. 26.1.1 -26.1.2)
26.1.1.
economicActivityCode
Код ОКВЭД
обязательно
Строка
26.1.2.
economicActivityName
Наименование ОКВЭД
обязательно
Строка
26.2
additionalEconomicActivities
Дополнительные
виды
необязательно
Блок,
состоящий
деятельности
из
следующих
элементов
(пп. 26.2.1 - 26.2.2)
313
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
26.2.1
additionalEconomicActivity
Дополнительные
виды
необязательно
Блок,
состоящий
деятельности
из
следующих
элементов
(пп.
26.2.1.1
-
26.2.1.2)
26.2.1.1
economicActivityCode
Код ОКВЭД
обязательно
Строка
26.2.1.2.
economicActivityName
Наименование
обязательно
Строка
дополнительного
вида
деятельности
27
socialInsuranceRegistrationInf
Сведения о регистрации
необязательно
Блок,
состоящий
o
в ФСС
из
элемента
(п. 27.1-27.3)
27.1
socialInsuranceRegistration
Сведения о регистрации
необязательно
Блок,
состоящий
в ФСС
из
элемента
(п. 27.1.1)
27.1.1
socialInsuranceAgency
Сведения об организации
обязательно
Блок,
состоящий
ФСС
из
следующих
элементов
(пп.
27.1.1.2
-
27.1.1.2)
27.1.1.1.
socialInsuranceAgencyCode
Код ФСС
обязательно
Строка
27.1.1.2.
socialInsuranceAgencyName
Наименование ФСС
обязательно
Строка
27.1.2
socialInsuranceRegDate
Дата регистрации
обязательно
Дата в формате:
ГГГГ-ММ-ДД
27.1.3
socialInsuranceRegNumber
Регистрационный номер
обязательно
Строка
ФСС
27.2
grnDate
ГРН и дата внесения
обязательно
Блок,
состоящий
в
ЕГРЮЛ
записи,
из
следующих
содержащей указанные
элементов
сведения
(пп. 27.2.1-27.2.2)
27.2.1
date
Дата записи
обязательно
Дата в формате:
ГГГГ-ММ-ДД
314
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
27.2.2
number
Номер записи
необязательно
Строка
28
type
Тип документа
обязательно
Принимает
значение:
ORG_DATA
29
id
Уникальный
обязательно
Строка
идентификатор
документа
Актуализация данных в БД ЕСИА происходит автоматически после того,
как внешняя информационная система осуществила обновление сведений о ЮЛ в реестре
ЕГРЮЛ.
Пример ответа на запрос сведений о выписке ЕГРЮЛ:
[
{
"docId": "22ED0D32-F3F2-0693-E050-A8C0D3C81091",
"legalFormClassifier": "ОКОПФ",
"capitalInfo": {
"grnDate": {
"date": "2008-11-18",
"number": "2241548440274"
},
"capitalSum": "10000.0000",
"capitalTypeName": "УСТАВНЫЙ КАПИТАЛ"
},
"legalFormCode": "12345",
"departmentDoc": "ФНС России",
"type": "ORG_DATA",
"founderInfo": {
"personFounder": [
{
"personInfo": {
"lastName": "Юки",
"firstName": "Асуна",
"middleName": "Юи"
}
}
]
315
},
"taxAccountingInfo": {
"inn": "6444883888",
"kpp": "773001001",
"grnDate": {
"date": "2008-11-18",
"number": "2087764197948"
},
"taxAgency": {
"taxAgencyCode": "7730",
"taxAgencyName": "Межрайонная инспекция Федеральной налоговой
службы № 17 по Челябинской области: 125373, г. Челябинск, походный проезд, д.
3, стр. 2"
},
"registrationDate": "2008-11-18"
},
"receiptDocDate": "1631541726016",
"reportDate": "2015-04-16",
"recordInfo": [
{
"reason": {
"recordCode": "13300",
"recordName": "ВНЕСЕНИЕ В ЕДИНЫЙ ГОСУДАРСТВЕННЫЙ РЕЕСТР
ЮРИДИЧЕСКИХ ЛИЦ СВЕДЕНИЙ О РЕГИСТРАЦИИ ЮРИДИЧЕСКОГО ЛИЦА В КАЧЕСТВЕ
СТРАХОВАТЕЛЯ В ТЕРРИТОРИАЛЬНОМ ОРГАНЕ ПЕНСИОННОГО ФОНДА РОССИЙСКОЙ ФЕДЕРАЦИИ"
},
"recordId": "87746825004279",
"recordGRN": "2087764333402",
"recordDate": "2008-11-20",
"registrationAgency": {
"registrationAgencyCode": "7746",
"registrationAgencyName": "МЕЖРАЙОННАЯ ИНСПЕКЦИЯ
ФЕДЕРАЛЬНОЙ НАЛОГОВОЙ СЛУЖБЫ № 46 ПО Г. МОСКВЕ"
}
}
],
"ogrnDate": "2008-11-18",
"registrationAgencyInfo": {
"grnDate": {
"date": "2008-11-18",
"number": "2241548440274"
},
"registrationAgency": {
"registrationAgencyCode": "7733",
316
"registrationAgencyName": "МЕЖРАЙОННАЯ ИНСПЕКЦИЯ ФЕДЕРАЛЬНОЙ
НАЛОГОВОЙ СЛУЖБЫ № 46 ПО Г. МОСКВЕ",
"registrationAgencyAddress": "125373, Г.МОСКВА, ПОХОДНЫЙ
ПРОЕЗД, ДОМОВЛАДЕНИЕ 3, СТР.2"
}
},
"id": 14337,
"pensionRegistrationInfo": {
"grnDate": {
"date": "2008-11-20",
"number": "2087764333402"
},
"pensionRegistration": {
"pensionAgency": {
"pensionAgencyCode": "087806",
"pensionAgencyName": "Управление Пенсионного фонда
Российской Федерации в г. Магнитогорске Челябинской области: 3214567,
г.Магнитогорск, ул.Ленина, д. 69"
},
"pensionRegDate": "2008-11-19",
"pensionRegNumber": "087806035495"
}
},
"socialInsuranceRegistrationInfo": {
"grnDate": {
"date": "2008-11-20",
"number": "2087764310490"
},
"socialInsuranceRegistration": {
"socialInsuranceAgency": {
"socialInsuranceAgencyCode": "7728",
"socialInsuranceAgencyName": "Филиал №4 Государственного
учреждения - Челябинского регионального отделения Фонда социального
страхования Российской Федерации: 125373, г. Челябинск, походный проезд, д.3,
стр.2"
},
"socialInsuranceRegDate": "2008-11-19",
"socialInsuranceRegNumber": "772803546077281"
}
},
"ogrn": "1832026017888",
"addressInfo": {
"addressFIAS": {
"house": [
317
{
"houseNum": "1",
"houseType": "Дом"
},
{
"houseNum": "2",
"houseType": "Корпус"
},
{
"houseNum": "3/4",
"houseType": "Строение"
}
],
"idGAR": "1234567890",
"region": "10",
"grnDate": {
"date": "1957-08-13",
"number": "0000000000000"
},
"roadNet": {
"roadNetName": "Гудкова",
"roadNetType": "Улица"
},
"zipCode": "123456",
"building": {
"buildingNum": "1",
"buildingType": "Офисный Центр"
},
"district": {
"districtName": "Кратово",
"districtType": "Г.П."
},
"apartment": {
"apartmentNum": "18",
"apartmentType": "Квартира"
},
"regionName": "Московская область",
"settlement": {
"settlementName": "Жуковский",
"settlementType": "Город"
},
"municipality": {
318
"municipalityName": "Раменский",
"municipalityType": "М.Р-Н"
},
"planningStruct": {
"planningStructName": "Квадрат",
"planningStructType": "Структура"
},
"grnDateCorrection": {
"date": "1957-08-13",
"number": "0000000000000"
}
},
"addressInRussia": {
"house": "1",
"region": {
"regionName": "Московская",
"regionType": "Область"
},
"street": {
"streetName": "Победа",
"streetType": "Улица"
},
"grnDate": {
"date": "1957-08-13",
"number": "0000000000000"
},
"zipCode": "123456",
"building": "2",
"locality": {
"localityName": "Раменское",
"localityType": "Городское Поселение"
},
"apartment": "18",
"kladrCode": "00000000000",
"regionCode": "10",
"settlement": {
"settlementName": "Раменское",
"settlementType": "Город"
},
"municipality": {
"municipalityName": "Раменское",
"municipalityType": "Муниципальный Район"
319
},
"grnDateCorrection": {
"date": "1957-08-13",
"number": "0000000000000"
}
}
},
"validateDateDoc": "1631541726016",
"registrationInfo": {
"ogrn": "2241548440274",
"grnDate": {
"date": "2008-11-18",
"number": "2241548440274"
},
"ogrnDate": "2008-11-18",
"formationWay": {
"formationWayCode": "11",
"formationWayName": "ГОСУДАРСТВЕННАЯ РЕГИСТРАЦИЯ ЮРИДИЧЕСКОГО
ЛИЦА ПРИ СОЗДАНИИ"
}
},
"inn": "6444883888",
"nameInfo": {
"grnDate": {
"date": "2008-11-18",
"number": "2241548440274"
},
"fullName": "Общество с Ограниченной Ответственностью Ромашка",
"shortName": "ООО Ромашка"
},
"kpp": "014945758",
"chiefInfo": [
{
"grnDate": {
"date": "2008-11-18",
"number": "2241548440274"
},
"personInfo": {
"inn": "589907361698",
"lastName": "Юки",
"firstName": "Асуна",
"middleName": "Юи"
320
},
"personPosition": {
"grnDate": {
"date": "2008-11-18"
},
"positionName": "Руководитель",
"positionType": "02",
"positionTypeName": "Руководитель"
}
}
],
"relevance": "actual",
"legalFormName": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ",
"economicActivitiesTypeInfo": {
"mainEconomicActivity": {
"economicActivityCode": "17.30",
"economicActivityName": "Отделка тканей и текстильных
изделий"
},
"additionalEconomicActivities": [
{
"additionalEconomicActivity": {
"economicActivityCode": "18.22",
"economicActivityName": "Производство верхней одежды"
}
}
]
},
"status": "verified_by_request"
}
]
Возможные коды ошибок:
Код HTTP 400:
ESIA-058012 = Данный пользователь не является руководителем ЮЛ
Код HTTP 401:
ESIA-005013 = Токен отсутствует
Код HTTP 403:
ESIA-005029 = Токен неверный или срок действия токена истек
Код HTTP 404:
321
Документ не найден
5.2.25 Сведения о доходах физического лица и о выплатах страховых взносов,
произведенных в пользу физического лица
Модель документа «Сведения о доходах физического лица и о выплатах страховых
взносов, произведенных в пользу физического лица» приведена в таблице 38.
Таблица 38 - Сведения о доходах физического лица и о выплатах страховых
взносов, произведенных в пользу физического лица
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
1.
oid
Идентификатор пользователя
обязательно
Строка
2.
id
Уникальный
идентификатор
обязательно
Строка
документа
3.
status
Статус достоверности
обязательно
Принимает значения:
в
случае
«verified_by_request»
получения
выписки
4.
relevance
Релевантность документа
обязательно
Принимает значения:
actual
5.
type
Тип документа
обязательно
Принимает
значение:
PAYOUT_INCOME
6.
departmentDoc
Ведомство,
к
которому
обязательно
Принимает
значение:
относится документ
!ФНС России»
7.
version
Версия документа
обязательно
Принимает значение: «1»
8.
createdOn
Дата
и
время
создания
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
9.
updatedOn
Дата и время обновления
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
322
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
10.
receiptDocDate
Дата и время получения
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
11.
validateDateDoc
Дата и время валидации
обязательно
Задается
документа
в
формате
в
случае
как
количество
TIMESTAMP
получения
миллисекунд, прошедших
выписки
с
00:00:00 UTC 1 января
1970 года
12.
content
Объект, содержащий сведения
обязательно
Объект
о доходах физического лица
в случае
и о выплатах страховых взносов,
получения
произведенных
в пользу
выписки
физического лица
13.
xmlFile
Объект, содержащий сведения
обязательно
Содержится в объекте
о доходах физического лица
в случае
«content»
и о выплатах страховых взносов,
получения
произведенных
в пользу
выписки
физического лица, в формате
XML и файл подписи к XML-
файлу, в формате p7s
14.
pdfFile
Объект, содержащий сведения
обязательно
Содержится в объекте
о доходах физического лица
в случае
«content»
и о выплатах страховых взносов,
получения
произведенных
в пользу
выписки
физического лица, в формате
PDF и файл подписи к PDF-
файлу, в формате p7s
15.
file
Строка,
содержащая
обязательно
Содержится в объектах
закодированный в формате
в случае
«xmlFile» и «pdfFile»
BASE64 файл с данными
получения
в формате XML или PDF
выписки
16.
sig
Строка,
содержащая
обязательно
Содержится в объектах
закодированный в формате
в случае
«xmlFile» и «pdfFile»
323
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
BASE64 файл подписи к XML-
получения
или PDF-файлу, в формате p7s
выписки
17.
error
Информация
об
ошибке,
необязательно
Строка
предыдущие сведения
не затираются и отображаются
(при наличии).
Если в ответе имеется указанное
поле,
полученные
данные
принято
считать
не актуальными
18.
errorUpdatedOn
Дата
последнего
ответа
необязательно
Целое число
с ошибкой (метка времени
в unixtimestamp).
Если в ответе имеется указанное
поле,
полученные
данные
принято
считать
не актуальными
Пример ответа на запрос сведений о доходах физического лица и о выплатах
страховых взносов, произведенных в пользу физического лица:
{
"oid": "1077496446",
"id": "55e6bf44-4732-4708-9699-e8c6de09c7b2",
"version": 1,
"createdOn": 1688017480764,
"updatedOn": 1688017480764,
"receiptDocDate": 1688017480764,
"validateDateDoc": 1688017480688,
"relevance": "actual",
"status": "verified_by_request",
"departmentDoc": "Федеральная налоговая служба",
"content": {
"xmlFile": {
"file": "PD94bWwgd...",
"sig": "MIIK/AYJKoZIhv..."
},
"pdfFile": {
"file": "JVBERi0xL...",
"sig": "MIIK/AYJKoZIhv..."
}
324
},
"type": "PAYOUT_INCOME"
}
Пример ответа при отправке запроса сведений о доходах физического лица
и о выплатах страховых взносов, произведенных в пользу физического лица:
{
"oid":"1077139512",
"requestId":"2555967"
}
Список возможных ошибок приведен в таблице 39.
Таблица 39 - Список возможных ошибок
Описание
№
Код ошибки
Комментарий
ошибки
1.
MksRequestErrorEnum.fns.payout.income.no.permissions
Отсутствие
Требуется получить
согласия
согласие
у пользователя
2.
MksRequestErrorEnum.fns.payout.income.status.doc.failed
Ошибка в ответе
Запросить сведения
от СМЭВ
позже
или
обратиться
в поддержку
3.
CommonExceptionEnum.internalError
При
Запросить сведения
непредвиденной
позже
ошибке
или
обратиться
в поддержку
4.
MksRequestErrorEnum.fns.payout.income.doc.failed.no.data
При "КодОбр=4"
По пользователю нет
и "КодОтк"=01
данных. Запросить
сведения позже
5.
MksRequestErrorEnum.fns.payout.income.doc.error
При "КодОбр=4"
Запросить сведения
и иных "КодОтк"
позже
или
обратиться
в поддержку
Пример ответа на запрос сведений о доходах физического лица и о выплатах
страховых взносов, произведенных в пользу физического лица с ошибкой:
{
"oid": "10780130100",
"id": "6c600fbc-dc62-498a-8b19-0e019d070a87",
"version": 1,
325
"createdOn": 1614244889557,
"updatedOn": 1614244889557,
"receiptDocDate": 1614244889557,
"relevance": "actual",
"departmentDoc": "ФНС России",
"error": "CommonExceptionEnum.internalError",
"errorUpdatedOn": 1614244889550,
"type": "PAYOUT_INCOME",
"content": {
{ "xmlFile": { "file": "tfgxfg", "sig": "tfgxfg" } },
{ "pdfFile": { "file": "tfgxfg", "sig": "tfgxfg" } }
}
5.2.26 Сведения о недвижимости пользователя, получаемые из базы данных
Росреестра
Модель документа «Данные о недвижимости, находящейся в собственности
пользователя» приведена в таблице 40.
326
Таблица 40 - Данные о недвижимости пользователя, полученные из базы данных
Росреестра
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
1.
oid
Идентификатор пользователя
обязательно
Строка
2.
id
Уникальный
идентификатор
обязательно
Строка
документа
3.
status
Статус достоверности
обязательно
Принимает значения:
«verified_by_request»
4.
relevance
Релевантность документа
обязательно
Принимает значения:
«actual»
5.
type
Тип документа
обязательно
Принимает
значение:
REG_REALESTATE
6.
departmentDoc
Ведомство,
к
которому
обязательно
Принимает значение:
относится документ
«Росреестр»
7.
version
Версия документа
обязательно
Принимает значение: «1»
8.
createdOn
Дата
и
время
создания
необязательно
Задается
документа
как
количество
в формате TIMESTAMP
миллисекунд,
прошедших с
00:00:00
UTC 1 января 1970 года
9.
updatedOn
Дата и время обновления
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд,
прошедших с
00:00:00
UTC 1 января 1970 года
10.
receiptDocDate
Дата и время получения
необязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд,
прошедших с
00:00:00
UTC 1 января 1970 года
11.
validateDateDoc
Дата и время валидации
необязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд,
327
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
прошедших с
00:00:00
UTC 1 января 1970 года
13.
error
Информация
об
ошибке,
необязательно
Строка
предыдущие
сведения
не затираются и отображаются
(при наличии).
Если в ответе имеется указанное
поле,
полученные
данные
принято
считать
не актуальными
14.
errorUpdatedOn
Дата
последнего
ответа
необязательно
Целое число
с ошибкой (метка времени
в unixtimestamp).
Если в ответе имеется указанное
поле,
полученные
данные
принято
считать
не актуальными
15
data
Массив данных об объектах
обязательно
Массив
элементов,
недвижимости, принадлежащих
в
случае
содержащих поля 15.1 -
пользователю
корректного
15.4
получения
данных
из Росреестра -
но
может
не содержать
элементов
15.1
id
Внутренний
идентификатор
обязательно
Строка
объекта недвижимости
15.2
propertyTypeValue
Вид объекта недвижимости
обязательно
Строка
15.3
cadNumber
Кадастровый номер объекта
обязательно
Строка
недвижимости
15.4
readableAddress
Полный адрес или описание
обязательно
Строка
расположения
объекта
недвижимости
328
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
15.5
fileLink
Ссылка на файл выписки по ОН
необязательно
Строка
Применяется
только
в методе 5.1.5 - 5.1.6
16
fileLinks
Массив ссылок на файлы
необязательно
Массив строк
выписок по ОН
Применяется
только
в методах 5.1.10 - 5.1.11
Ответ на запрос данных может быть двояким: в случае, если данные пользователя
в базе данных ЦП актуальны (актуальность определяется по полю 9. updatedOn),
возвращается ответ по существу в виде описанной в таблице 32 структуры данных,
в противном случае возвращается структура с полем requestId, обозначающая, что идет
обновление данных и для получения данных по существу через некоторое время должен
быть отправлен повторный запрос.
Пример ответа по существу на запрос данных о недвижимости в собственности
пользователя:
{
"oid": "1077429644",
"id": "3aede387-2dc6-3444-9b25-ffcede8ba150",
"createdOn": 1642672691234,
"updatedOn": 1642672691234,
"receiptDocDate": 1642672691234,
"validateDateDoc": 1642672691234,
"relevance": "actual",
"status": "verified_by_request",
“departmentDoc”: “Росреестр”,
“version”: 1,
“type”: “REG_REALESTATE”,
"data": [
{
“id”: “804de599-1ec9-4340-b043-0e7115ad3f69”,
“propertyTypeValue”: “Помещение”,
“cadNumber”: “59:01:3911814:3703”,
“readableAddress”: “Российская Федерация, Пермский край, г.о.
Пермский, г Пермь, ул Пирожкова, д. 269, кв. 85”,
“fileLink”:
“https://api.gosuslugi.ru/api/public/v1/pso/1077376541/doc/REG_REALESTATE/804
DE599-1EC9-4340-B043-0E7115AD3F69/file”
},
{
“id”: “74887d03-8b01-4f4d-a28d-b40ee5d020ba”,
“propertyTypeValue”: “Земельный участок”,
“cadNumber”: “44:17:060101:41”,
329
“readableAddress”: “Российская Федерация, Хабаровский край, Ванинский
р-н, г Советская Гавань, ул Всего доброго, д. 2”,
“fileLink”:
“https://api.gosuslugi.ru/api/public/v1/pso/1077376541/doc/REG_REALESTATE/748
87D03-8B01-4F4D-A28D-B40EE5D020BA/file”
}
]
}
Пример ответа на запрос данных о недвижимости, находящейся в собственности
пользователя в случае, если требуется обновление данных:
{
"oid": "1077429644",
"requestId": "2559644"
}
Список возможных ошибок приведен в таблице 41.
Таблица 41 - Список возможных ошибок
№
Код ошибки
Описание ошибки
Комментарий
1.
MksRequestErrorEnum.reg.realestate.no.permissions
Отсутствие согласия
Требуется получить
согласие
у пользователя
2.
MksRequestErrorEnum.reg.realestate.info.request.failed
Ошибка в ответе
Запросить сведения
от запроса данных
позже
или
обратиться
в поддержку
3.
CommonExceptionEnum.internalError
При непредвиденной
Запросить сведения
ошибке
позже
или
обратиться
в поддержку
Пример ответа на запрос сведений о принадлежащей пользователю недвижимости
по данным Росреестра с ошибкой:
{
"oid": "1077429644",
"id": "3aede387-2dc6-3444-9b25-ffcede8ba150",
"createdOn": 1642672691234,
"updatedOn": 1642672691234,
"receiptDocDate": 1642672691234,
"validateDateDoc": ,
"relevance": "actual",
"status": "verified_by_request",
“departmentDoc”: “Росреестр”,
“version”: 1,
330
“type”: “REG_REALESTATE”,
"error": "CommonExceptionEnum.internalError",
"errorUpdatedOn": 1642672691234,
}
5.2.27 Цифровой документ об образовании пользователя
Модель документа «Цифровой документ об образовании пользователя версии
1.0.1» приведена в таблице 42.
Таблица 42 - Данные цифрового документа об образовании пользователя версии
1.0.1
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
1.
snils
СНИЛС пользователя
обязательно
Строка
2.
oid
Идентификатор
обязательно
Строка
пользователя
3.
type
Тип документа
обязательно
Принимает
значение:
DIGITAL_EDUC_DOC
6.
departmentDoc
Ведомство, к которому
обязательно
Принимает значение:
относится документ
«Рособрнадзор»
7.
status
Статус достоверности
обязательно
Принимает значения:
«verified_by_request»
8.
eduDocuments
Цифровой
документ
обязательно
Массив
элементов,
об образовании
содержащий поля 8.1 - 8.24
8.1.
id
Идентификатор записи
обязательно
Строка
8.2.
version
Версия записи
обязательно
Целое число
8.3.
createdOn
Дата и время создания
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.4.
updatedOn
Дата и время обновления
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
331
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
с
00:00:00 UTC 1 января
1970 года
8.5.
receiptDocDate
Дата и время получения
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.6.
digitalDocId
Уникальный
обязательно
Строка
идентификатор документа
8.7.
docName
Наименование документа
обязательно
Строка
8.8.
docNumber
Номер бланка документа
необязательно
Строка
8.9.
rDocNumber
Реестровый
номер
обязательно
Строка
документа
8.10.
issueDate
Дата выдачи документа
обязательно
Задается
в формате TIMESTAMP
как
количество
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.11.
status
Статус документа
обязательно
Строка.
Возможные
значения:
оригинал/дубликат
8.12.
surname
Фамилия
обладателя
обязательно
Строка
документа
8.13.
name
Имя обладателя документа
обязательно
Строка
8.14.
patronymic
Отчество
обладателя
необязательно
Строка
документа
8.15.
birthDate
Дата рождения обладателя
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.16.
startYear
Год начала обучения
обязательно
Строка
332
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
8.17.
finishYear
Год окончания
обязательно
Строка
8.18.
orgName
Наименование организации
обязательно
Строка
8.19.
levelEdu
Уровень образования
обязательно
Строка
8.20.
orgHead
Фамилия
и
инициалы
обязательно
Строка
руководителя
образовательной
организации
8.21.
decreeDate
Дата приказа о выдаче
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.22.
decreeNumber
Номер приказа о выдаче
обязательно
Строка
документа
8.23.
location
Место
нахождения
обязательно
Строка
образовательной
организации, город
8.24.
appendix
Приложение к документу
обязательно
Массив
элементов,
содержащий поля 8.24.1 -
8.24.12
8.24.1.
appName
Наименование приложения
обязательно
Строка
8.24.2.
appNumber
Номер бланка приложения
необязательно
Строка
8.24.3.
rNumber
Реестровый
номер
обязательно
Строка
документа
8.24.4.
issueDate
Дата выдачи приложения
обязательно
Задается
в формате TIMESTAMP
как
количество
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.24.5.
surname
Фамилия
обладателя
обязательно
Строка
приложения
333
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
8.24.6.
name
Имя
обладателя
обязательно
Строка
приложения
8.24.7.
patronymic
Отчество
обладателя
необязательно
Строка
приложения
8.24.8.
pstatus
Статус приложения
обязательно
Строка.
Возможные
значения:
оригинал/дубликат
8.24.9.
orgHead
Фамилия
и
инициалы
обязательно
Строка
руководителя
образовательной
организации
8.24.10.
decreeDate
Дата приказа о выдаче
обязательно
Задается
приложения в формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.24.11.
decreeNumber
Номер приказа о выдаче
обязательно
Строка
приложения
8.24.12.
assessmentsList
Список
оценок
обязательно
Массив
элементов,
по предметам
содержащий поля 8.24.12.1
- 8.24.12.2
8.24.12.1.
subjectName
Название предмета
обязательно
Строка
8.24.12.2.
subjectAssessment
Отметка
обязательно
Строка
8.24.13.
extraSubjectsList
Список
дополнительных
необязательно
Массив
элементов,
предметов
содержащий поле 8.24.13.1
8.24.13.1.
subjectName
Дополнительный предмет
обязательно
Строка
8.24.14.
xmlFile
Ссылка для скачивания
обязательно
Строка
документа
8.24.14.1.
link
Параметры
обязательно
Строка
для формирования ссылки
334
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
8.24.14.1.1.
objectId
Идентификатор
объекта
обязательно
Строка
в объектном хранилище
ЕСИА
8.24.14.1.2.
objectTypeId
Идентификатор директории
обязательно
Строка
в объектном хранилище
ЕСИА
8.24.14.1.3.
mnemonic
Мнемоника
файла,
обязательно
Строка
сохраненного в объектном
хранилище ЕСИА
Пример ответа на запрос данных о цифровом документе об образовании
пользователя:
{
"snils": "767-751-063 44",
"oid": "1077386021",
"type": "DIGITAL_EDUC_DOC",
"departmentDoc": "Рособрнадзор",
"status": "verified_by_request",
"eduDocuments": [
{
"id": "98e76eca-58a2-4b40-88a9-a28b6d069bcd",
"version": 5,
"createdOn": 1649235291302,
"updatedOn": 1649239813474,
"receiptDocDate": 1649235291302,
"digitalDocId": 12345678,
"docName": "Аттестат о среднем общем образовании",
"docNumber": "12345678901234",
"issueDate": 1624136400000,
"status": "Оригинал",
"surname": "Петров",
"name": "Петр",
"patronymic": "Петрович",
"birthDate": 1066593600000,
"startYear": "2012",
"finishYear": "2021",
"orgName": "Школа номер 1020 города Москва",
"levelEdu": "среднее общее образование",
"orgHead": "Мягков С.Т.",
"decreeDate": 1624050000000,
"decreeNumber": "134678903",
"location": "Москва",
"appendix": {
"appName": "Приложение к аттестату о среднем общем
образовании",
"appNumber": "3456929",
"issueDate": 1624136400000,
"surname": "Петров",
"name": "Петр",
"patronymic": "Петрович",
"pstatus": "Оригинал",
335
"orgHead": "Мягков С.Т.",
"decreeDate": 1624050000000,
"decreeNumber": "134678903",
"assessmentList": [
{
"subjectName": "Алгебра",
"subjectAssessment": "5"
},
{
"subjectName": "Геометрия",
"subjectAssessment": "5"
},
{
"subjectName": "Физика",
"subjectAssessment": "5"
},
{
"subjectName": "Химия",
"subjectAssessment": "5"
},
{
"subjectName": "Информатика",
"subjectAssessment": "5"
},
{
"subjectName": "Русский язык",
"subjectAssessment": "4"
},
{
"subjectName": "Обществознание",
"subjectAssessment": "4"
},
{
"subjectName": "История",
"subjectAssessment": "5"
}
],
"extraSubjectList": [
{
"subjectName": "Алгебра"
},
{
"subjectName": "Геометрия"
},
{
"subjectName": "Физика"
},
{
"subjectName": "Химия"
},
{
"subjectName": "Информатика"
}
],
"rnumber": "12345678901234567890"
},
"xmlFile": {
"link": {
"objectId": 12345678,
"objectTypeId": 40,
"mnemonic": "DIGITAL_EDUC_DOC.xml"
}
},
"rdocNumber": "12345678901234567890"
336
}
]
}
Модель документа «Цифровой документ об образовании пользователя версии
2.0.6» приведена в таблицах 43, 44.
Таблица 43 - Данные цифровых документов об образовании пользователя 2.0.6
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
1.
snils
СНИЛС пользователя
обязательно
Строка
3.
type
Тип документа
обязательно
Принимает
значение:
DIGITAL_EDUC_DOC
6.
departmentDoc
Ведомство, к которому
обязательно
Принимает значение:
относится документ
«Рособрнадзор»
7.
status
Статус достоверности
обязательно
Принимает значения:
«verified_by_request»
8.
eduDocuments
Цифровой
документ
обязательно
Массив
элементов,
об образовании
содержащий поля 8.1 - 8.24
8.1.
id
Идентификатор записи
обязательно
Строка
8.2.
version
Версия записи
обязательно
Целое число
8.3.
createdOn
Дата и время создания
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.4.
updatedOn
Дата и время обновления
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.5.
receiptDocDate
Дата и время получения
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.6.
docName
Наименование документа
обязательно
Строка
337
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
8.7.
docNumber
Номер бланка документа
необязательно
Строка
8.8.
rDocNumber
Реестровый
номер
обязательно
Строка
документа
8.9.
issueDate
Дата выдачи документа
обязательно
Задается
в формате TIMESTAMP
как
количество
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.10.
status
Статус документа
обязательно
Строка.
Возможные
значения:
оригинал/дубликат
8.11.
surname
Фамилия
обладателя
обязательно
Строка
документа
8.12.
name
Имя обладателя документа
обязательно
Строка
8.13.
patronymic
Отчество
обладателя
необязательно
Строка
документа
8.14.
birthDate
Дата рождения обладателя
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
8.15.
specCode
Код специальности
необязательно
массив
8.16.
specName
Наименование
необязательно
массив
специальности
8.17
qualification
Квалификация
необязательно
массив
8.18.
finishYear
Год окончания
обязательно
Строка
8.19.
orgName
Наименование организации
обязательно
Строка
8.20
location
Место
нахождения
обязательно
Строка
образовательной
организации, город
8.21.
levelEdu
Уровень образования
обязательно
Строка
338
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
8.22.
signerPos
Должность
подписанта
обязательно
Строка
документа об образовании
и/или
квалификации
и приложения к нему
8.23.
signer
Фамилия
и
инициалы
обязательно
Строка
подписанта
документа
об
образовании
и/или
квалификации
и приложения к нему
8.24.
appendix
Приложение к документу
обязательно
Массив
элементов,
содержащий поля 8.24.1 -
8.24.7
8.24.1.
appName
Наименование приложения
обязательно
Строка
8.24.2.
rAssessmentNumber
Реестровый
номер
обязательно
Строка
документа
8.24.3.
assessmentNum
Номер приложения (номер
необязательно
Строка
бланка)
8.24.4.
prevDoc
Предыдущий
документ
необязательно
Строка
об
образовании
или
об
образовании
и о квалификации
8.24.5.
yearCount
Срок освоения программы
необязательно
Строка
8.24.6.
assessmentsList
Список
оценок
обязательно
Массив
элементов,
по предметам
содержащий поля 8.24.6.1
- 8.24.6.4
8.24.6.1.
subjectName
Название предмета
обязательно
Строка
8.24.6.2.
universalMeasure
Зачетные
единицы
необязательно
Строка
по предмету
8.24.6.3.
timeMeasure
Количество
часов
необязательно
Строка
по предмету
8.24.6.4.
subjectAssessment
Отметка
необязательно
Строка
339
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
8.24.7.
extraSubjectsList
Список
дополнительных
необязательно
Массив
элементов,
предметов
содержащий поля 8.24.7.1
- 8.24.7.4
8.24.7.1.
subjectName
Название предмета
обязательно
Строка
8.24.7.2.
universalMeasure
Зачетные
единицы
необязательно
Строка
по предмету
8.24.7.3.
timeMeasure
Количество
часов
необязательно
Строка
по предмету
8.24.7.4.
subjectAssessment
Отметка
необязательно
Строка
9.
xmlFile
Ссылка для скачивания
обязательно
Строка
документа
9.1.
link
Параметры
обязательно
Строка
для формирования ссылки
9.1.1.
objectId
Идентификатор
объекта
обязательно
Строка
в объектном хранилище
ЕСИА
9.1.2.
objectTypeId
Идентификатор директории
обязательно
Строка
в объектном хранилище
ЕСИА
9.1.3.
mnemonic
Мнемоника
файла,
обязательно
Строка
сохраненного в объектном
хранилище ЕСИА
Пример ответа на
запрос данных о цифровых документах об образовании
пользователя версии 2.0.6:
{
"snils": "767-751-063 44",
"type": "DIGITAL_EDUC_DOC_V2",
"departmentDoc": "Рособрнадзор",
"status": "verified_by_request",
"eduDocuments": [
{
"id": "d586ab21-53c7-4d78-92e5-2721f0edd2dd",
"version": 1,
"createdOn": "2022-11-23T10:27:47.146",
340
"updatedOn": "2022-11-23T10:27:47.146",
"receiptDocDate": "2022-11-23T10:27:47.146",
"docName": "Аттестат о среднем общем образовании с отличием",
"docNumber": null,
"issueDate": 1656536400000,
"status": "Действительный",
"surname": "Щетинин",
"name": "Григорий",
"patronymic": "Александрович",
"birthDate": 820443600000,
"finishYear": "2022",
"orgName": "444 школа",
"levelEdu": "среднее общее образование",
"location": "город Москва",
"appendix": {
"appName": "Приложение к аттестату о среднем общем
образовании с отличием",
"assessmentsList": [
{
"subjectName": "Русский язык",
"subjectAssessment": "4 (хорошо)"
},
{
"subjectName": "Алгебра",
"subjectAssessment": "5 (отлично)"
},
{
"subjectName": "Геометрия",
"subjectAssessment": "5 (отлично)"
},
{
"subjectName": "История",
"subjectAssessment": "5 (отлично)"
}
],
"extraSubjectsList": [
{
"subjectName": "Индивидуальный проект"
}
],
"rAssessmentNumber": "07700000000001"
},
"xmlFile": {
"link": {
"objectId": 1669188466968,
"objectTypeId": 40,
341
"mnemonic": "digital_educ_doc_6b3b5d59-b9f4-4d4a-b916-
b4ccc9509728.xml"
}
},
"signerPos": "Директор",
"signer": "Иванов И.И.",
"specCode": [],
"specName": [],
"qualification": [],
"rDocNumber": "07700000000001"
},
{
"id": "d0940eff-524c-477e-bc43-e8ace2f67cb1",
"version": 1,
"createdOn": "2022-11-23T10:35:12.077",
"updatedOn": "2022-11-23T10:35:12.077",
"receiptDocDate": "2022-11-23T10:35:12.077",
"docName": "Диплом бакалавра с отличием",
"docNumber": null,
"issueDate": 1656536400000,
"status": "Действительный",
"surname": "Щетинин",
"name": "Григорий",
"patronymic": "Александрович",
"birthDate": 820443600000,
"finishYear": "2022",
"orgName": "Федеральное государственное бюджетное образовательное
учреждение высшего образования «Московский государственный технический
университет имени Н.Э.Баумана (национальный исследовательский
университет)»:",
"levelEdu": "бакалавриат",
"location": "город Москва",
"appendix": {
"appName": "Приложение к диплому бакалавра с отличием",
"prevDoc": "Аттестат о среднем (полном) общем образовании,
2012 год",
"yearCount": "4 года",
"assessmentsList": [
{
"subjectName": "Иностранный язык",
"universalMeasure": "12 з.е.",
"timeMeasure": "х",
"subjectAssessment": "отлично"
},
{
342
"subjectName": "Физическая культура (элективная
дисциплина)",
"universalMeasure": "х",
"timeMeasure": "х",
"subjectAssessment": "отлично"
},
{
"subjectName": "Практики",
"universalMeasure": "10 з.е.",
"timeMeasure": "х",
"subjectAssessment": "х"
},
{
"subjectName": "Учебная\\nв том числе:",
"universalMeasure": "6 з.е.",
"timeMeasure": "х",
"subjectAssessment": "х"
},
{
"subjectName": "Учебная практика по
программирования",
"universalMeasure": "6 з.е.",
"timeMeasure": "х",
"subjectAssessment": "отлично"
},
{
"subjectName": "Производственная\\nв том числе:",
"universalMeasure": "4 з.е.",
"timeMeasure": "х",
"subjectAssessment": "х"
},
{
"subjectName": "Технологическая",
"universalMeasure": "2 з.е.",
"timeMeasure": "х",
"subjectAssessment": "отлично"
},
{
"subjectName": "Компьютерные сети",
"universalMeasure": "х",
"timeMeasure": "х",
"subjectAssessment": "отлично"
},
{
"subjectName": "Операционные системы",
"universalMeasure": "х",
343
"timeMeasure": "х",
"subjectAssessment": "отлично"
}
],
"extraSubjectsList": [
{
"subjectName": "Форма обучения: очная"
},
{
"subjectName": "Образовательная организация
переименована в 2016 году"
},
{
"subjectName": "Старое полное официальное название
образовательной организации - Федеральное государственное бюджетное
образовательное учреждение высшего профессионального образования \"Московский
государственный технический университет имени Н.Э.Баумана\""
}
],
"rAssessmentNumber": "07700000000000"
},
"xmlFile": {
"link": {
"objectId": 1669188911943,
"objectTypeId": 40,
"mnemonic": "digital_educ_doc_231a3e58-5439-48b8-8186-
093de8bf88ad.xml"
}
},
"signerPos": "Первый проректор",
"signer": "Иванов И.И.",
"specCode": [
"09.03.01",
"09.03.04"
],
"specName": [
"Информатика и вычислительная техника",
"Программная инженерия"
],
"qualification": [
"бакалавр",
"почти_инженер"
],
"rDocNumber": "07700000000000"
}
]
}
344
Таблица 44 - Данные цифрового документа об образовании пользователя 2.0.6
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
1.
id
Идентификатор записи
обязательно
Строка
2.
version
Версия записи
обязательно
Целое число
3.
createdOn
Дата и время создания
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
4.
updatedOn
Дата и время обновления
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
5.
receiptDocDate
Дата и время получения
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
6.
snils
СНИЛС пользователя
обязательно
Строка
7.
type
Тип документа
обязательно
Принимает
значение:
DIGITAL_EDUC_DOC
8.
departmentDoc
Ведомство, к которому
обязательно
Принимает значение:
относится документ
«Рособрнадзор»
9.
status
Статус достоверности
обязательно
Принимает значения:
«verified_by_request»
10.
eduDocument
Цифровой
документ
обязательно
Объект, содержащий поля
об образовании
10.1 - 10.19
10.1.
docName
Наименование документа
обязательно
Строка
10.2.
docNumber
Номер бланка документа
необязательно
Строка
10.3.
rDocNumber
Реестровый
номер
обязательно
Строка
документа
345
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
10.4.
issueDate
Дата выдачи документа
обязательно
Задается
в формате TIMESTAMP
как
количество
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
10.5.
status
Статус документа
обязательно
Строка.
Возможные
значения:
оригинал/дубликат
10.6.
surname
Фамилия
обладателя
обязательно
Строка
документа
10.7.
name
Имя обладателя документа
обязательно
Строка
10.8.
patronymic
Отчество
обладателя
необязательно
Строка
документа
10.9.
birthDate
Дата рождения обладателя
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
10.10.
specCode
Код специальности
необязательно
массив
10.11.
specName
Наименование
необязательно
массив
специальности
10.12.
qualification
Квалификация
необязательно
массив
10.13.
finishYear
Год окончания
обязательно
Строка
10.14.
orgName
Наименование организации
обязательно
Строка
10.15.
location
Место
нахождения
обязательно
Строка
образовательной
организации, город
10.16.
levelEdu
Уровень образования
обязательно
Строка
10.17.
signerPos
Должность
подписанта
обязательно
Строка
документа об образовании
и/или
квалификации
и приложения к нему
346
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
10.18.
signer
Фамилия
и
инициалы
обязательно
Строка
подписанта
документа
об
образовании
и/или
квалификации
и приложения к нему
10.19.
appendix
Приложение к документу
обязательно
Массив
элементов,
содержащий поля 10.19.1.-
10.19.7.
10.19.1.
appName
Наименование приложения
обязательно
Строка
10.19.2.
rAssessmentNumber
Реестровый
номер
обязательно
Строка
документа
10.19.3.
assessmentNum
Номер приложения (номер
необязательно
Строка
бланка)
10.19.4.
prevDoc
Предыдущий
документ
необязательно
Строка
об
образовании
или
об
образовании
и о квалификации
10.19.5.
yearCount
Срок освоения программы
необязательно
Строка
10.19.6.
assessmentsList
Список
оценок
обязательно
Массив
элементов,
по предметам
содержащий
поля
10.19.6.1. - 10.19.6.4.
10.19.6.1.
subjectName
Название предмета
обязательно
Строка
10.19.6.2.
universalMeasure
Зачетные
единицы
необязательно
Строка
по предмету
10.19.6.3.
timeMeasure
Количество
часов
необязательно
Строка
по предмету
10.19.6.4.
subjectAssessment
Отметка
необязательно
Строка
10.19.7.
extraSubjectsList
Список
дополнительных
необязательно
Массив
элементов,
предметов
содержащий
поля
10.19.7.1.- 10.19.7.4.
10.19.7.1.
subjectName
Название предмета
обязательно
Строка
347
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
10.19.7.2.
universalMeasure
Зачетные
единицы
необязательно
Строка
по предмету
10.19.7.3.
timeMeasure
Количество
часов
необязательно
Строка
по предмету
10.19.7.4.
subjectAssessment
Отметка
необязательно
Строка
11.
xmlFile
Ссылка для скачивания
обязательно
Строка
документа
11.1.
link
Параметры
обязательно
Объект,
содержащий
для формирования ссылки
строки 11.1.1. - 11.1.3.
11.1.1.
objectId
Идентификатор
объекта
обязательно
Строка
в объектном хранилище
ЕСИА
11.1.2.
objectTypeId
Идентификатор директории
обязательно
Строка
в объектном хранилище
ЕСИА
11.1.3.
mnemonic
Мнемоника
файла,
обязательно
Строка
сохраненного в объектном
хранилище ЕСИА
Пример ответа на
запрос данных о цифровом документе об образовании
пользователя версии 2.0.6:
{
"id": "d0940eff-524c-477e-bc43-e8ace2f67cb1",
"version": 1,
"createdOn": "2022-11-23T10:35:12.077",
"updatedOn": "2022-11-23T10:35:12.077",
"receiptDocDate": "2022-11-23T10:35:12.077",
"status": "verified_by_request",
"departmentDoc": "Рособрнадзор",
"eduDocument": {
"docName": "Диплом бакалавра с отличием",
"issueDate": "30.06.2022",
"status": "Действительный",
"surname": "Щетинин",
"name": "Григорий",
"patronymic": "Александрович",
"birthDate": "01.01.1996",
"specCode": [
"09.03.01"
],
"specName": [
"Информатика и вычислительная техника"
348
],
"qualification": [
"бакалавр"
],
"finishYear": "2022",
"orgName": "Федеральное государственное бюджетное образовательное
учреждение высшего образования «Московский государственный технический
университет имени Н.Э.Баумана (национальный исследовательский
университет)»:",
"location": "город Москва",
"levelEdu": "бакалавриат",
"signerPos": "Первый проректор",
"signer": "Иванов И.И.",
"appendix": {
"appName": "Приложение к диплому бакалавра с отличием",
"prevDoc": "Аттестат о среднем (полном) общем образовании, 2012
год",
"yearCount": "4 года",
"assessmentsList": [
{
"subjectName": "Иностранный язык",
"universalMeasure": "12 з.е.",
"timeMeasure": "х",
"subjectAssessment": "отлично"
},
{
"subjectName": "ИНО в инженерном менеджменте",
"universalMeasure": "4 з.е.",
"timeMeasure": "х",
"subjectAssessment": "зачтено"
},
{
"subjectName": "Основы межличностных коммуникаций",
"universalMeasure": "4 з.е.",
"timeMeasure": "х",
"subjectAssessment": "зачтено"
},
{
"subjectName": "История",
"universalMeasure": "3 з.е.",
"timeMeasure": "х",
"subjectAssessment": "зачтено"
},
{
"subjectName": "Операционные системы",
"universalMeasure": "х",
"timeMeasure": "х",
"subjectAssessment": "отлично"
}
],
"extraSubjectsList": [
{
"subjectName": "Форма обучения: очная"
},
{
"subjectName": "Образовательная организация переименована
в 2016 году"
},
{
349
"subjectName": "Старое полное официальное название
образовательной организации - Федеральное государственное бюджетное
образовательное учреждение высшего профессионального образования \"Московский
государственный технический университет имени Н.Э.Баумана\""
}
],
"rAssessmentNumber": "07700000000000"
},
"rDocNumber": "07700000000000"
},
"snils": "767-751-063 44",
"type": "DIGITAL_EDUC_DOC_V2",
"xmlFile": {
"link": {
"objectId": 1669188911943,
"objectTypeId": 40,
"mnemonic": "digital_educ_doc_231a3e58-5439-48b8-8186-
093de8bf88ad.xml"
}
}
}
5.2.28 Сведения о статусе самозанятого
Модель документа «Сведения о статусе самозанятого» приведена в таблице 45.
Таблица 45 - Сведения о статусе самозанятого
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
1.
oid
Идентификатор пользователя
обязательно
Строка
2.
id
Уникальный
идентификатор
обязательно
Строка
документа
3.
status
Статус достоверности
обязательно
Принимает значения:
verified_by_validate;
verified_by_request;
verified_by_push;
unverified
4.
relevance
Релевантность документа
обязательно
Принимает значения:
actual;
expired;
invalid
5.
type
Тип документа
обязательно
Принимает
значение
SELF_EMPLOYED
6.
departmentDoc
Ведомство,
к
которому
обязательно
Принимает
значение
относится документ
«ФНС»
350
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
7.
version
Версия документа
обязательно
Натуральное число
в
случае
отсутствия
ошибки
8.
receiptDocDate
Дата и время получения
обязательно
Задается как количество
документа
в
формате
в
случае
миллисекунд, прошедших
TIMESTAMP
отсутствия
с
00:00:00 UTC 1 января
ошибки
1970 года
9.
isRegistred
Статус самозанятости
обязательно
Логический тип данных:
в
случае
true
(является
отсутствия
самозанятым);
ошибки
false
(не
является
самозанятым)
10.
regHistory
История постановок и снятий
обязательно
Массив объектов с датами
с учета в качестве самозанятого
в
случае
постановки и снятия с учета
отсутствия
(структура объекта описана
ошибки
в 10.1-10.2)
10.1.
registrationDate
Дата постановки на учет
обязательно
Дата
в
формате:
в качестве самозанятого
ДД.ММ.ГГГГ
10.2.
unregistrationDate
Дата снятия с учета в качестве
необязательно
Дата
в
формате:
самозанятого
ДД.ММ.ГГГГ
11.
nameDoc
Наименование документа
необязательно
Строка
Принимает
значение
«Сведения
о самозанятости»
12.
createdOn
Дата
и
время
создания
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
13.
updatedOn
Дата и время обновления
обязательно
Задается
документа
в
формате
как
количество
TIMESTAMP
миллисекунд, прошедших
351
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
с
00:00:00 UTC 1 января
1970 года
14.
files
Массив
со
справками
необязательно
Массив
объектов
о
назначенных
пенсиях
(структура объекта описана
и социальных выплатах в виде
в 14.1-14.3)
файлов,
закодированных
в base64
14.1.
file
Справка о назначенных пенсиях
необязательно
Строка
и социальных выплатах (XML
или
PDF),
закодированная
в формате BASE64
14.2.
name
Наименование файла
необязательно
Строка
Принимает
значение
SELF_EMPLOYED.xml
14.3.
metadata
Формат файла
необязательно
Строка
Принимает
значение
application/xml
Пример ответа на запрос сведений о статусе самозанятого:
{
"oid": "2079711968",
"id": "59765a75-b076-4726-a900-d172cedd9606",
"version": 1,
"createdOn": 1670332514754,
"updatedOn": 1670332514754,
"receiptDocDate": 1670332514754,
"relevance": "actual",
"status": "verified_by_request",
"departmentDoc": "ФНС",
"files": [
{
"file":
"PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9InllcyI/Pjxu
czU6R2V0TWVzc2FnZVJlc3BvbnNlIHhtbG5zPSJ1cm46Ly94LWFydGVmYWN0cy1nbml2Yy1ydS9ha
XMzL2trdC9BdXRoU2VydmljZS90eXBlcy8xLjAiIHhtbG5zOm5zNT0idXJuOi8veC1hcnRlZmFjdH
MtZ25pdmMtcnUvaW5wbGF0L3NlcnZpbi9PcGVuQXBpQXN5bmNNZXNzYWdlQ29uc3VtZXJTZXJ2aWN
lL3R5cGVzLzEuMCIgeG1sbnM6bnMyPSJ1cm46Ly94LWFydGVmYWN0cy1nbml2Yy1ydS9haXMzL1NN
Wi9TbXpQYXJ0bmVyc0ludGVncmF0aW9uU2VydmljZS90eXBlcy8xLjAiIHhtbG5zOm5zND0idXJuO
i8veC1hcnRlZmFjdHMtZ25pdmMtcnUvaW5wbGF0L3NlcnZpbi9PcGVuQXBpTWVzc2FnZUNvbnN1bW
VyU2VydmljZS90eXBlcy8xLjAiIHhtbG5zOm5zMz0idXJuOi8veC1hcnRlZmFjdHMtZ25pdmMtcnU
352
vYWlzMy9TTVovU216UGFydG5lcnNWYWxpZGF0aW9uU2VydmljZS90eXBlcy8xLjAiPjxuczU6UHJv
Y2Vzc2luZ1N0YXR1cz5DT01QTEVURUQ8L25zNTpQcm9jZXNzaW5nU3RhdHVzPjxuczU6TWVzc2FnZ
T48bnMyOkdldFRheHBheWVyUmVnaXN0cmF0aW9uU3RhdHVzUmVzcG9uc2UgeG1sbnM9InVybjovL3
gtYXJ0ZWZhY3RzLWduaXZjLXJ1L2FpczMvU01aL1NtelBhcnRuZXJzSW50ZWdyYXRpb25TZXJ2aWN
lL3R5cGVzLzEuMCIgeG1sbnM6Uz0iaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvc29hcC9lbnZl
bG9wZS8iIHhtbG5zOm5zMj0idXJuOi8veC1hcnRlZmFjdHMtZ25pdmMtcnUvYWlzMy9TTVovU216U
GFydG5lcnNWYWxpZGF0aW9uU2VydmljZS90eXBlcy8xLjAiIHhtbG5zOnNvYXA9Imh0dHA6Ly9zY2
hlbWFzLnhtbHNvYXAub3JnL3NvYXAvZW52ZWxvcGUvIj48bnMyOklzUmVnaXN0cmVkPmZhbHNlPC9
uczI6SXNSZWdpc3RyZWQ+PC9uczI6R2V0VGF4cGF5ZXJSZWdpc3RyYXRpb25TdGF0dXNSZXNwb25z
ZT48L25zNTpNZXNzYWdlPjwvbnM1OkdldE1lc3NhZ2VSZXNwb25zZT4=",
"name": "SELF_EMPLOYED.xml",
"metadata": "application/xml"
}
],
"isRegistred": false,
"regHistory": [],
"nameDoc": "Сведения о самозанятости",
"type": "SELF_EMPLOYED"
}
5.2.29 Сведения о водительском удостоверении, полученном из ГИБДД
Модель документа «Сведения о выданных водительских удостоверениях граждан»
приведена в таблице 46.
Таблица 46 - Сведения о выданных водительских удостоверениях граждан
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
1.
oid
Идентификатор пользователя
обязательно
Строка
2.
Id
Уникальный
идентификатор
обязательно
Строка
документа
3.
status
Статус достоверности
обязательно
Принимает значения:
verified_by_validate;
verified_by_request;
verified_by_push;
unverified
4.
relevance
Релевантность документа
обязательно
Принимает значения:
actual;
expired;
invalid
353
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
5.
type
Тип документа
обязательно
Принимает
значение:
GIBDD_DRIVER_LICENS
E
6.
departmentDoc
Ведомство, к которому относится
обязательно
Принимает
значение
документ
«Управление ГИБДД ГУ
МВД России»
7.
version
Версия документа
обязательно
Принимает значение: «1»
8.
createdOn
Дата и время создания документа
обязательно
Задается как количество
в формате TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
9.
updatedOn
Дата и время обновления документа
обязательно
Задается как количество
в формате TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
10.
receiptDocDate
Дата и время получения документа
обязательно
Задается как количество
в формате TIMESTAMP
миллисекунд, прошедших
с
00:00:00 UTC 1 января
1970 года
11.
validateDateDoc
Дата и время валидации документа
обязательно
Задается как количество
в формате TIMESTAMP
в
случае
миллисекунд, прошедших
получения
с
00:00:00 UTC 1 января
сведений
1970 года
12.
nameDoc
Наименование документа
обязательно
Строка
в
случае
получения
сведений
13.
content
Сведения
о
водительском
обязательно
Строка,
содержащая
удостоверении
в
XML,
в
случае
закодированый в формате
закодированные в формате BASE64
получения
BASE64 файл
сведений
14.
error
Информация
об
ошибке,
необязательно
Строка
предыдущие
сведения
354
Требования
№
Код поля
Описание поля
Комментарий
к заполнению
не затираются и отображаются
(при наличии).
Если в ответе имеется указанное
поле, полученные данные принято
считать не актуальными
15.
errorUpdatedOn
Дата
последнего
ответа
необязательно
Целое число
с
ошибкой
(метка
времени
в unixtimestamp).
Если в ответе имеется указанное
поле, полученные данные принято
считать не актуальными
Актуализация данных возможна через тридцать дней после получения
или обновления пользователем личного кабинета или внешней информационной системой,
данных из ГИБДД, при запросе.
Актуализация данных при получении ошибки (таблица 47) возможна через 1 час
после получения или обновления пользователем личного кабинета или внешней
информационной системой, данных из ГИБДД, при запросе.
Пример ответа на запрос сведений о водительском удостоверении:
{
"oid": "1077496446",
"id": "1a5c3369-da72-4f91-a9f7-66582a1427ed",
"version": 1,
"createdOn": 1662460922607,
"updatedOn": 1662460922607,
"receiptDocDate": 1662460922607,
"validateDateDoc": 1662460922469,
"relevance": "actual",
"status": "verified_by_request",
"departmentDoc": "Управление ГИБДД ГУ МВД России",
"nameDoc": "Сведения о выданных водительских удостоверениях граждан",
"content": "PD94b...URMPg0K",
"type": "GIBDD_DRIVER_LICENSE"
}
Пример ответа при отправке запроса на получение сведений о водительском
удостоверении:
355
{
"oid":"1077139512",
"requestId":"2555967"
}
Таблица 47 - Список возможных ошибок
№
Код ошибки
Описание ошибки
Комментарий
1.
GibddError.exception.MksRequestErrorEnum.mvd.gibdd.driver.lic
Отсутствие
Требуется
ense.no.permissions
согласия
получить
согласие
у пользователя
2.
GibddError.exception.MksRequestErrorEnum.mvd.gibdd.driver.lic
Ошибка в ответе
Запросить
ense.request.failed
от СМЭВ
сведения позже
или обратиться
в поддержку
3.
GibddError.exception.CommonExceptionEnum.internalError
При
Запросить
непредвиденной
сведения позже
ошибке
или обратиться
в поддержку
4.
GibddError.exception.MksRequestErrorEnum.mvd.gibdd.driver.lic
При
отсутствии
Запросить
ense.status.no.data
сведений в ГИБДД
сведения
повторно
или обратиться
в ГИБДД
Пример ответа при получении ошибки в процессе получения сведений
о водительском удостоверении:
{
"oid": "1077483928",
"id": "d81a8ac3-ef00-4b0f-b4c4-0da7274fe9d7",
"version": 1,
"createdOn": 1667388685695,
"updatedOn": 1667388685695,
"receiptDocDate": 1667388685695,
"relevance": "invalid",
"status":"unverified",
"departmentDoc": "Управление ГИБДД ГУ МВД России",
"nameDoc":"Сведения о выданных водительских удостоверениях граждан",
"error": "GibddError.exception.MksRequestErrorEnum.mvd.gibdd.driver.licen
se.request.failed",
356
"errorUpdatedOn": 1667388685682,
"type": "GIBDD_DRIVER_LICENSE"
}
Пример ответа при получении ошибки в процессе обновления сведений
о водительском удостоверении:
{
"oid":"1077483928",
"id":"ed6d95d7-c945-4ac8-a2c7-95be6003c6fb",
"version":1,
"createdOn":1667388155737,
"updatedOn":1667388155737,
"receiptDocDate":1667388155737,
"relevance":"invalid",
"status":"unverified",
"departmentDoc":"Управление ГИБДД ГУ МВД России",
"nameDoc":"Сведения о выданных водительских удостоверениях граждан",
"error":"GibddError.exception.CommonExceptionEnum.internalError",
"errorUpdatedOn":1667388155704,
"content": "PD9...TD4NCg==”,
"type":"GIBDD_DRIVER_LICENSE"
}
Вид сведения:
https://lkuv.gosuslugi.ru/paip-portal/#/inquiries/card/7c8ba99a-ab9f-11ec-95db-47077e193af7
5.3 Тестирование REST API ЦП
В интеграционной среде ЕСИА и ЦП (https://esia-portal1.test.gosuslugi.ru/ )
для упрощения интеграции реализована возможность получения предопределенных,
тестовых ответов, «заглушек». Функциональность реализована для части типов сведений
ЦП в следующих методах REST API ЦП:
получение сведений всех документов, указанного типа;
получение сведений документа в исходном виде.
5.3.1 Получение тестовых сведений всех документов, определенного типа
GET /digital/api/public/{version}/pso/{oid}/doc/{doc_type}
Функциональность «заглушек» реализована для следующих типов документов
(doc_type):
357
ILS_PFR (сведения о состоянии индивидуального страхового счета
застрахованного лица);
PASSPORT_HISTORY (история выданных гражданину РФ паспортов);
INCOME_REFERENCE (справки о доходах и суммах налога физического лица,
форма 2-НДФЛ);
PENSION_REFERENCE (справки о назначенных пенсиях и социальных
выплатах на дату);
ELECTRONIC_WORKBOOK (сведения о трудовой деятельности, выписка
из электронной трудовой книжки);
PAYMENTS_EGISSO (сведения о назначенных и реализованных мерах
социальной защиты);
DISABLED_PERSON (сведения об инвалидности гражданина);
FAMILY_ASSETS (сведения о выписке из регистра сертификатов
материнского (семейного) капитала);
PRE_RETIREMENT_AGE (сведения об отнесении гражданина к категории
граждан предпенсионного возраста);
MDCL_PLCY (сведения о полисе ОМС и прикреплении к медицинской
организации);
ORG_DATA (сведения из выписки ЕГРЮЛ);
BSS_DATA (сведения из выписки ЕГРИП);
REG_REALESTATE (данные о недвижимости в собственности пользователя);
SELF_EMPLOYED (сведения о статусе самозанятого).
Для того, чтобы при вызове метода возвращались тестовые данные, необходимо
дополнительно указывать в запросе параметр test={id}, где id - порядковый номер
тестового ответа для конкретного сведения.
Например, для ИЛС СФР запрос будет выглядеть следующим образом:
GET https://esia-
portal1.test.gosuslugi.ru/digital/api/public/v1/pso/1077128025/doc/ILS_PFR?test=1
Возвращаемый тестовый пример:
содержит тестовый oid пользователя, отличный от oid в запросе;
содержит тестовый id сведения;
содержит тестовые данные, отличные от данных тестового пользователя, oid
которого указан в запросе;
358
не записывается в хранилище Цифрового профиля для пользователя, oid
которого указан в запросе;
содержит тестовый файл подписи документа.
5.3.1.1 Сведения о состоянии индивидуального страхового счета
застрахованного лица (ILS_PFR)
Для сведения ILS_PFR доступны 6 тестовых ответов:
?test=1 - Выписка по гражданину без накопительной пенсии;
?test=2 - Выписка по гражданину, который выбрал НПФ в качестве места
хранения пенсионных накоплений;
?test=3 - Выписка по гражданину, который выбрал государственный СФР
в качестве места хранения пенсионных накоплений;
?test=4 - Выписка по гражданину-пенсионеру, получающему накопительную
пенсию;
?test=5 - Выписка по гражданину-пенсионеру, получающему срочную пенсию;
?test=6 - Выписка по гражданину-пенсионеру, получившему срочную выплату.
5.3.1.2 История выданных гражданину РФ паспортов (PASSPORT_HISTORY)
Для сведения PASSPORT_HISTORY доступен 1 тестовый ответ: ?test=1.
Содержит в себе три вида паспорта с различными причинами недействительности.
5.3.1.3 Справки о доходах и суммах налога физического лица, форма 2-НДФЛ
(INCOME_REFERENCE)
Для сведения INCOME_REFERENCE доступен 1 тестовый ответ - Справка
по гражданину, который работал в ЮЛ и у ФЛ: ?test=1.
5.3.1.4 Справки о назначенных пенсиях и социальных выплатах на дату
(PENSION_REFERENCE)
Для сведения PENSION_REFERENCE доступно 2 ответа:
?test=1
- Положительный результат (т.е. гражданину назначена пенсия
и социальная выплата - гражданин является пенсионером);
?test=2 - Отрицательный результат (т.е. гражданину не назначена пенсия
и социальная выплата - гражданин не достиг соответствующего возраста).
359
5.3.1.5 Сведения о трудовой деятельности, выписка из электронной трудовой
книжки (ELECTRONIC_WORKBOOK)
Для сведения ELECTRONIC_WORKBOOK доступен 1 тестовый ответ - ЭТК
по гражданину с записями в электронной трудовой книжке за последние два года: ?test=1.
5.3.1.6 Сведения о назначенных и реализованных мерах социальной защиты
(PAYMENTS_EGISSO)
Для сведения PAYMENTS_EGISSO доступен 1 тестовый ответ:
?test=1
- Есть ответ от ведомства (т.е. по гражданину есть сведения
о назначенных и реализованных мерах социальной защиты (поддержки).
5.3.1.7 Сведения об инвалидности гражданина (DISABLED_PERSON)
Для сведения DISABLED_PERSON доступно 2 тестовых ответа:
?test=1 - Отрицательный результат (т.е. гражданин не относится к категории
инвалиды);
?test=2 - Положительный результат (т.е. гражданин относится к категории
инвалиды и по нему пришли данные).
Для сведения FAMILY_ASSETS доступно 3 тестовых ответа:
?test=1
- Отрицательный результат (т.е. гражданин делал запрос
на материнский капитал, но одобрение не было дано);
?test=2
- Положительный результат (т.е. гражданин имеет одобренный
материнский капитал и им не пользовался);
?test=3
- Положительный результат (т.е. гражданин имеет одобренный
материнский капитал и часть суммы капитала использована).
5.3.1.8 Сведения об отнесении гражданина к категории граждан
предпенсионного возраста (PRE_RETIREMENT_AGE)
Для сведения PRE_RETIREMENT_AGE доступно 2 тестовых ответа:
?test=1 - Отрицательный результат (т.е. гражданин не относится к категории
граждан предпенсионного возраста);
?test=2 - Положительный результат (т.е. гражданин относится к категории
граждан предпенсионного возраста).
360
5.3.1.9 Сведения о полисе ОМС и прикреплении к медицинской организации
(MDCL_PLCY)
Для сведения MDCL_PLCY доступен 1 тестовый ответ:
?test=1 - сведения о медицинском полисе гражданина.
5.3.1.10 Сведения из выписки ЕГРЮЛ (ORG_DATA)
Для сведения ORG_DATA доступно 2 тестовых ответа:
?test=1 - Отрицательный результат (т.е. гражданин не является руководителем
ЮЛ);
?test=2 - Положительный результат (массив из всех найденных документов
«Выписка из ЕГРЮЛ»).
5.3.1.11 Сведения из выписки ЕГРИП (BSS_DATA)
Для сведения BSS_DATA доступно 2 тестовых ответа:
?test=1 - Отрицательный результат (т.е. гражданин не является ИП);
?test=2 - Положительный результат (массив из всех найденных документов
«Выписка из ЕГРИП»).
5.3.1.12 Данные о недвижимости в собственности пользователя
(REG_REALESTATE)
Для типа документа REG_REALESTATE доступны 2 тестовых ответа:
?test=1 - сведения о недвижимости пользователя с двумя объектами;
?test=2 - сведения об отсутствии недвижимости у пользователя.
5.3.1.13 Сведения о статусе самозанятого (SELF_EMPLOYED)
Для типа документа SELF_EMPLOYED доступны 2 тестовых ответа:
?test=1
- сведения статуса самозанятости пользователя, являющегося
самозанятым;
?test=2
- сведения статуса самозанятости пользователя, не являющегося
самозанятым.
5.3.2 Получение тестовых сведений документа в исходном виде
GET /digital/api/public/{version}/pso/{oid}/doc/{doc_type}/raw
361
Функциональность «заглушек» реализована для следующих типов документов:
Выписка о транспортном средстве по владельцу, полученная из витрины
ГИБДД (VEHICLE_INFO);
Сведения о доходах физического лица и выплатах страховых взносов,
произведенных в пользу физического лица (PAYOUT_INCOME);
Сведени о водительском удостоверении, полученном из ГИБДД
(GIBDD_DRIVER_LICENSE).
Для того, чтобы при вызове метода возвращались тестовые данные, необходимо
дополнительно указывать в запросе параметр test={id}, где id - порядковый номер
тестового ответа для конкретного сведения.
Например, для VEHICLE_INFO запрос будет выглядеть следующим образом:
GET
https://esia-
portal1.test.gosuslugi.ru/digital/api/public/v1/pso/1000475789/doc/VEHICLE_INFO/raw?test=1
Возвращаемый тестовый пример:
содержит тестовый oid пользователя, отличный от oid в запросе;
содержит тестовый id сведения;
содержит тестовые данные, отличные от данных тестового пользователя, oid
которого указан в запросе;
не записывается в хранилище Цифрового профиля для пользователя, oid
которого указан в запросе;
содержит тестовый файл подписи документа.
5.3.2.1 Выписка о транспортном средстве (VEHICLE_INFO)
Для сведения VEHICLE_INFO доступен 1 тестовый ответ: ?test=1.
Содержит в себе выписку о транспортном средстве по владельцу, полученную
из витрины ГИБДД, в исходном виде.
5.3.2.2 Сведения о доходах физического лица и выплатах страховых взносов,
произведенных в пользу физического лица (PAYOUT_INCOME)
Например, для PAYOUT_INCOME запрос будет выглядеть следующим образом:
GET https://esia-
portal1.test.gosuslugi.ru/digital/api/public/v1/pso/1000475789/doc/PAYOUT_INCOME/raw?tes
t=1
362
Возвращаемый тестовый пример:
содержит тестовый oid пользователя, отличный от oid в запросе;
содержит тестовый id сведения;
содержит тестовые данные, отличные от данных тестового пользователя, oid
которого указан в запросе;
не записывается в хранилище Цифрового профиля для пользователя, oid
которого указан в запросе;
содержит тестовый файл подписи документа.
Для сведения PAYOUT_INCOME доступен 1 тестовый ответ: ?test=1.
Содержит в себе сведения о доходах физического лица и выплатах страховых
взносов, произведенных в пользу физического лица в исходном виде.
5.3.2.3 Сведения о водительском удостоверении, полученном из ГИБДД
(GIBDD_DRIVER_LICENSE)
Для документа GIBDD_DRIVER_LICENSE запрос будет выглядеть следующим
образом:
GET https://esia-
portal1.test.gosuslugi.ru/digital/api/public/v1/pso/1077483928/doc/GIBDD_DRIVER_LICENSE
/raw?test=1
Возвращаемый тестовый пример:
содержит тестовый oid пользователя, отличный от oid в запросе;
содержит тестовый id сведения;
содержит тестовые данные, отличные от данных тестового пользователя, oid
которого указан в запросе;
не записывается в хранилище Цифрового профиля для пользователя, oid
которого указан в запросе.
Для сведения GIBDD_DRIVER_LICENSE доступен 1 тестовый ответ: ?test=1.
Содержит в себе сведения о водительском удостоверении, полученные из ГИБДД,
в исходном виде.
5.3.3 Получение тестового списка ссылок на файлы, полученные
от ведомства, детализирующие документы данного типа у гражданина
GET /digital/api/public/{version}/pso/{oid}/doc/{doc_type}/extraction
Функциональность «заглушек» реализована для следующих типов документов:
363
Данные о недвижимости пользователя (REG_REALESTATE), доступны два
тестовых объекта:
?test=1 - ссылки на выписки двух объектов недвижимости;
?test=2
- пустой массив ссылок, моделирующий ситуацию,
когда пользователь объектов недвижимости не имеет.
5.3.4 Получение
тестового
файла,
полученного
от
ведомства,
детализирующего данный документ
GET /digital/api/public/{version}/pso/{oid}/doc/{doc_type}/{doc_id}/file
Функциональность «заглушек» реализована для следующих типов документов:
Данные о недвижимости пользователя (REG_REALESTATE), доступны два
тестовых объекта:
?test=1 - выписка тестового объекта «Здание», содержащая сигнатуру
электронной подписи;
?test=2 - выписка для случая «Объект не найден», содержащая сигнатуру
электронной подписи.
5.3.5 Получение тестового архива с файлами, полученными от ведомства,
детализирующими документ данного типа
GET /digital/api/public/{version}/pso/{oid}/doc/{doc_type}/file
Функциональность «заглушек» реализована для следующих типов документов:
Данные о недвижимости пользователя (REG_REALESTATE), доступен один
тестовый объект:
?test=1 - архив формата ZIP, содержащий одну тестовую выписку формата
XML.

 

 

 

 

 

 

 

содержание      ..     2      3      4