Приложение 2

Приложение 2
к приказу Федерального фонда
обязательного медицинского
страхования
от 5 марта 2020 г. N 49

Приложение В
Информационное взаимодействие с Подсистемой ведения нормативно-справочной информации государственной информационной системы обязательного медицинского страхования

В.1 Общие сведения

Для взаимодействия с внешними информационными системами Подсистема ведения НСИ государственной информационной системы обязательного медицинского страхования предоставляет интеграционный сервис, работающий с архитектурой REST.

Версия REST-сервиса размещена по адресу: http://nsi.ffoms.ru/nsi-int/

Сервис предоставляет следующие методы:

- получение структуры справочника по коду и версии;

- получение списка версий справочника по коду;

- получение наполнения справочника по коду и версии;

- получение перечня справочников, входящих в состав федерального пакета НСИ;

- получение файла федерального пакета НСИ по идентификатору.

В.2 Получение структуры справочника по коду и версии (/structure)

Метод возвращает структуру версии справочника. В случае если не указана версия справочника, то возвращается структура из актуальной версии.

В.2.1 Описание

Таблица В.1 - Описание входных параметров метода

Код параметра	Описание параметра	Обязательность	Тип	Комментарии
Входные параметры
identifier	Иденти ф икатор справочника	Да	string
version	Версия справочника	Нет	string	По умолчанию текущая

В.2.2 Примеры вызова

См. пункт В.2.2 в редакторе Adobe Reader

В.3 Получение списка версий справочника по коду (/versions)

Метод возвращает список версий справочника.

В.3.1 Описание

Таблица В.2 - Описание входных параметров метода

Код параметра	Описание параметра	Обязательность	Тип	Комментарии
Входные параметры
identifier	Идентификатор справочника	Да	string
page	Номер страницы	Нет	integer	Значение по умолчанию 1
size	Количество элементов на странице	Нет	integer	Значение по умолчанию 200

В.3.2 Примеры вызова

См. пункт В.3.2 в редакторе Adobe Reader

В.4 Получение наполнения справочника по коду и версии (/data)

Метод возвращает данные справочника. В случае, если не указана версия справочника, то возвращаются данные из актуальной версии.

В.4.1 Описание

Таблица В.3 - Описание входных параметров метода

Код параметра	Описание параметра	Обязательность	Тип	Комментарии
Входные параметры
identifier	Идентификатор справочника	Да	string
version	Версия справочника	Нет	string	По умолчанию текущая
page	Номер страницы	Нет	integer	Значение по умолчанию 1
size	Количество элементов на странице	Нет	integer	Значение по умолчанию 200
columns	Наименования столбцов, которые необходимо отобразить в результирующем наборе. По умолчанию - все	Нет	array [string]
sorting	Наименование столбца, задающий порядок сортировки отображаемых данных	Нет	string
sortingDirection	Выбор направления сортировки	Нет	string	Выбор направления сортировки: ASC - по возрастанию, DESC - по убыванию
filters	Массив строк, задающий одно или множество одновременных условий отбора данных	Нет	array [string]	Каждая строка представляет собой значения нижеприведенных полей через разделитель "|" FIELD - наименование поля справочника VALUE - значение поля TYPE - тип поиска. TYPE может принимать следующие значения: EXACT - точное совпадение, LIKE! - вхождение значения. По умолчанию EXACT

В.4.2 Примеры вызова

См. пункт В.4.2 в редакторе Adobe Reader

В.5 Получение перечня справочников, входящих в состав федерального пакета НСИ (/fedPackDictionary Versions)

Метод возвращает перечень справочников с версиями, входящих в составы федеральных пакетов НСИ ФОМС по датам формирования федерального пакета. В случае если не указаны даты формирования федерального пакета, то возвращаются данные из последнего сформированного федерального пакета.

В.5.1 Описание

Таблица В.4 - Описание входных параметров метода

Код параметра	Описание параметра	Обязательность	Тип	Комментарии
Входные параметры
from	Дата начала периода формирования федерального пакета	Нет	date-time	Формат "DD.MM.YYYY"
to	Дата окончания периода формирования федерального пакета	Нет	date-time	Формат "DD.MM.YYYY"
page	Номер страницы	Нет	integer	Значение по умолчанию 1
size	Количество элементов на странице	Нет	integer	Значение по умолчанию 20

В.5.2 Примеры вызова

См. пункт В.5.2 в редакторе Adobe Reader

В.6 Получение файла федерального пакета НСИ по идентификатору (getfedPack/ {fedPacldd})

Метод получения ссылки на скачивание федерального пакета по идентификатору.

В.6.1 Описание

Таблица В.5 - Описание входных параметров метода

Код параметра	Описание параметра	Обязатель ность	Тип	Комментарии
Входные параметры
fedPackld	Идентификатор федерального пакета	Да	long

В.6.2 Примеры вызова

Пример запроса	Пример ответа
https://nsi.ffoms.ru/nsi-int/api/fedPack/96	-

Важно! Данные о версиях справочников, входящих в актуальный федеральный пакет НСИ ФОМС и наполнение этих версий, входящих в файл федерального пакета НСИ ФОМС, обновляются по расписанию, которое задает администратор Подсистемы ведения НСИ (не менее 1 раза в сутки). При этом может возникнуть ситуация, что последняя опубликованная текущим днем версия справочника еще не попала в федеральный пакет НСИ ФОМС. Рекомендуется для получения актуальных версий справочника использовать метод В.4 Получение наполнения справочника по коду и версии (/data)).