ФАДН ФЛ

Предоставление сведений из списка лиц, относящихся к коренным малочисленным народам Российской Федерации

Атрибут	Значение
Название	fadn-kmn
Наименование	Предоставление сведений из списка лиц, относящихся к коренным малочисленным народам Российской Федерации
Тип	Адаптер для СМЭВ3 сервиса
Область применения	Межведомственное взаимодействие
Версия СМЭВ	СМЭВ3
Версия ВС	1.0.3
Версия МР	3.5
Поставщик	Федеральное агентство по делам национальностей России
Потребители	По согласованию с Владельцем ВС

Описание бизнес-процесса взаимодействия:

Организация хочет получить сведения из списка лиц, относящихся к коренным малочисленным народам Российской Федерации.

ИС организации направляет запрос в Агредатор, Агредатор направляет запрос к виду сведений в СМЭВ, СМЭВ направляет запрос в ИС ФАДН.

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

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_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.

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

ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX

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

Параметр	Описание	Обязательное	Пример
id	Идентификатор запроса	-
env	Среда вызова	-	PROD
person	Запрашиваемое лицо	+	Составной элемент Person
parameters	Параметры	-	Массив (0..unbounded) составных элементов Parameter

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

Запрашиваемое лицо

Параметр	Описание	Обязательное	Пример
name	Имя	+	Иван
patronymic	Отчество	-	Иванович
surname	Фамилия	+	Иванов
birthday	День рождения	+	1985-12-25
sex	Пол (male или female)	+	male
residence_address	Адрес регистрации по месту жительства	-	Составной элемент Address
temporary_address	Адрес регистрации по месту пребывания	-	Составной элемент Address
text_address	Адрес в неструктурированном (в виде строки) виде	-
birth_place	Место рождения	+	г.Иваново Ивановской области
snils	СНИЛС	-
inn	ИНН	-
identification_document	Документ, удостоверяющий личность	-	Массив (0..10) составных элементов IdentificationDocument

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

Адрес регистрации

Параметр	Описание	Обязательное
postal_index	Почтовый индекс	+
region_code	Код субъекта Российской Федерации	+
district	Наименование района	-
city	Населенный пункт	+
street	Улица	+
house	Дом	+
housing	Корпус	-
appartment	Квартира	-

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

Документ, удостоверяющий личность

Параметр	Описание	Обязательное	Пример
document_type	Тип документа, удостоверяющего личность	+	ПАСПОРТ
series	Серия	+	1234
number	Номер	+	123456
issue_date	Дата выдачи	+	2007-12-15
issuer	Кем выдано	+	ОВД г.Иваново Ивановской области
issuer_code	Код подразделения	-

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

Код и значение передаваемого параметра

Параметр	Описание	Обязательное	Пример
name	Наименование параметра	+
value	Значение параметра	+

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

В данном разделе приведены параметры, необходимые для формирования ответа на полученный запрос.

Параметр	Описание	Обязательное	Пример
id	Идентификатор запроса	-
result_code	Код результата 0 - запрос успешно обработан; 1 - гражданин не найден в реестре коренных малочисленных народов; 2 - возникло исключение при обработке запроса (содержимое исключения будет в поле result_description)	+	0
result_description	Описание результата	-
name	Имя	+	Иван
patronymic	Отчество	-	Иванович
surname	Фамилия	+	Иванов
kmn_included_at	Когда включен в список КМН	-	2001-01-01
kmn_excluded_at	Когда исключен из списка КМН	-
native_nation	Наименование народности	-	Коряки
native_nation_code	Код наименование народности	-	14
is_tradional_life	Ведет традиционный образ жизни	-	true
parameters	Параметры	-	Массив (0..10) составных элементов Parameter

Примеры

Для проверки настройки сервиса можно в консоли отправки панели администрирования отправить запрос, соответствующий контрольному примеру, и получить соответствующий ответ.

{
  "person": {
    "name": "Иван",
    "patronymic": "Иванович",
    "surname": "Иванов",
    "birthday": "1985-12-25",
    "sex": "male",
    "birth_place": "г.Иваново Ивановской области",
    "identification_document": [
      {
        "document_type": "ПАСПОРТ",
        "series": "1234",
        "number": "123456",
        "issue_date": "2007-12-15",
        "issuer": "ОВД г.Иваново Ивановской области"
      }
    ]
  }
}

В случае корректной настройки должен прийти следующий ответ:

{
  "result_code": "0",
  "name": "Иван",
  "patronymic": "Иванович",
  "surname": "Иванов",
  "kmn_included_at": "2001-01-01",
  "native_nation": "Коряки",
  "native_nation_code": "14",
  "is_tradional_life": true
}