Сервис терминологии

Реестр Справочников предназначен для централизованного хранения медицинской нормативно-справочной информации, необходимой для функционирования ЦИСЗ.

Структурированная медицинская информация, которая передается из иных информационных систем (ресурсов) в здравоохранении и хранится в ЦИСЗ, должна соответствовать содержимому регистров, справочников и классификаторов модуля Сервиса терминологии.

Для взаимодействия с реестром справочников клиентам доступны следующие методы:

• метод получения метаинформации справочника
• метод поиска метаинформации справочника, по заданным параметрам
• метод проверки наличия значения в справочнике($validate-code)
• метод получения списка значений/атрибутов справочника($expand)

Все методы по взаимодействию с реестром справочников доступны клиентам без аутентификации

Способы взаимодействия МИС-ИЭМК-НСИ

Медицинский работник вносит в МИС набор медицинских данных о пациенте, включая сведения о медицинском наблюдении за пациентом и оказанных услугах. На основе данной информации МИС формирует пакет медицинских данных в виде ресурса Bundle.

После формирования пакета медицинских данных о пациенте выполняется его передача в ЦИСЗ с помощью метода импорта пакета медицинской информации о пациенте. Пакет медицинских данных о пациенте передается в подсистему интегрированной электронной медицинской карты пациента (ИЭМК), где выполняется валидация на соответствие профилям ЦИСЗ, включая проверку на соответствие переданных из МИС значений справочников подсистеме нормативно-справочной информации (НСИ).

При успешной валидации информация сохраняется в подсистеме ИЭМК и используется другими подсистемами ЦИСЗ.

Если в процессе валидации были обнаружены ошибки при проверке соответствия переданных из МИС значений справочников подсистеме НСИ, то пакет медицинской информации о пациенте отклоняется и передача информации из МИС в ЦИСЗ считается неуспешной.

Подсистема НСИ хранит эталонные и актуальные справочники, необходимые для функционирования всех подсистем ЦИСЗ.МИСы могут получать необходимую справочную информацию из подсистемы НСИ.

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

Получить описание справочника можно с помощью HTTP команды GET и может быть выполнено двумя способами:

• по идентификатору: GET [TERM_BASE]/ValueSet/<id>?_format=<format>

• по url-адресу справочника: GET [TERM_BASE]/ValueSet/<url>?_format=<format>

Метод возвращает один экземпляр ресурса.

При попытке доступа к несуществующему ресурсу будет возвращен HTTP статус код - 404 (Not Found).

Синтаксис метода поиска справочников

Во всех поисковых взаимодействиях в этом руководстве используется HTTP GET команда со следующим синтаксисом:

GET [TERM_BASE]/ValueSet/_search?{parameter}=[value]&...

Простой пример запроса поиска в RESTful с использованием HTTP GET команды:

GET [TERM_BASE]/ValueSet/_search?_format=[format]&identifier=value&...

Поддерживаемые параметры поиска ресурса

Поиск по названию

Параметр поиска name определяется как параметр типа string.

Примеры поиска по name:

GET [TERM_BASE]/ValueSet/_search?name=Виды медицинской помощи&_format=json - возвращает справочник с названием Виды медицинской помощи

Поиск по автору ресурса

Параметр поиска publisher определяется как параметр типа string.

Примеры поиска по publisher:

GET [TERM_BASE]/ValueSet/_search?publisher=Министерство здравоохранения&_format=json - возвращает справочники, в которых автором указано «Министерство здравоохранения».

Поиск по статусу

Параметр поиска status определяется как параметр типа token.

Примеры поиска по status:

GET [TERM_BASE]/ValueSet/_search?status=active&_format=json - возвращает справочники со статусом active

Поиск по uri-идентификатор ресурса

Параметр поиска url определяется как параметр типа uri.

Примеры поиска по url:

GET [TERM_BASE]/ValueSet/_search?url=urn:oid:VSTypeOfHealthCare&_format=json - возвращает справочник с указанным URL

Поиск по публичному коду ресурса

Параметр поиска identifier определяется как параметр типа token.

Примеры поиска по identifier:

GET [TERM_BASE]/ValueSet/_search?identifier=VSTypeOfHealthCare&_format=json - возвращает справочник с указанным публичным кодом ресурса

Операция $validate-code

Операция $validate-code предназначена для проверки наличия значения в справочнике.

Операция возвращает результат (true/false), а также HTTP-code 200 (OK).

В случае, если переданное названия справочника (параметр system), отсутствует в системе, метод возвращает ресурс OperationOutcome описанием ошибки и HTTP-code 404 (NotFound).

Вызов метода выполняется с помощью HTTP POST команды:

POST [TERM_BASE]/ValueSet/$validate-code?_format=<format>

Входящие параметры метода:

Исходящие параметры метода:

Пример запроса на выполенние операции $validate-code:

{ "resourceType": "Parameters", "parameter": [ { "name": "system", "valueString": "ConditionOutcomeCodes" }, { "name": "code", "valueString": "remission" }, { "name": "version", "valueString": "2" } ] }

Скопировать

Пример ответа в случае успешной валидации:

{ "parameter": [ { "name": "result", "valueBoolean": true } ], "resourceType": "Parameters" }

Скопировать

Пример ответа в случае неуспешной валидации:

{ "parameter": [ { "name": "result", "valueBoolean": false } ], "resourceType": "Parameters" }

Скопировать

Пример ответа в случае, если переданное названия справочника (параметр system), отсутствует в системе:

{ "issue": [ { "code": "not-found", "severity": "error", "diagnostics": "No resource was found" } ], "resourceType": "OperationOutcome" }

Скопировать

Операция $expand

Операция $expand предназначена для получения состава справочника.

Операция возвращает все значения справочника, а также HTTP-code 200 (OK).

В случае, если переданное названия справочника (параметр system), отсутствует в системе, метод возвращает ресурс OperationOutcome описанием ошибки и HTTP-code 404 (NotFound).

Вызов метода выполняется с помощью HTTP POST команды:

POST [TERM_BASE]/ValueSet/$expand?_format=<format>

Входящие параметры метода:

Исходящие параметры метода:

Пример запроса на выполенние операции $expand:

{ "resourceType": "Parameters", "parameter": [ { "name": "system", "valueString": "ConditionOutcomeCodes" }, { "name": "version", "valueString": "2" }, { "name": "count", "valueString": "2" }, { "name": "offset", "valueString": "1" } ] }

Скопировать

Пример ответа:

{ "id": "31ad8839-bb3d-4f5d-9f36-93bc0eb36eff", "expansion": { "total": 7, "offset": 1, "contains": [ { "code": "complication", "display": "осложнение", "version": "2", "property": [ { "code": "Code", "valueString": "complication" }, { "code": "Display", "valueString": "осложнение" } ] }, { "code": "death", "display": "смерть", "version": "2", "property": [ { "code": "Code", "valueString": "death" }, { "code": "Display", "valueString": "смерть" } ] } ], "timestamp": "2025-03-26T11:45:01.674168+03:00" }, "resourceType": "ValueSet" }

Скопировать

Пример ответа в случае, если переданное названия справочника (параметр system), отсутствует в системе:

{ "issue": [ { "code": "not-found", "severity": "error", "diagnostics": "No resource was found" } ], "resourceType": "OperationOutcome" }

Скопировать