Передача сведений из МИС в ИЭМК о результате оказания медицинской помощи

Процесс «Передача сведений из МИС в ИЭМК о результате оказания медицинской помощи» предназначен для передачи СЭМД пациента из МИС в ИЭМК.

Архив медицинских документов включает в себя хранилища медицинских документов, объединённые с помощью регистра документов:

хранилище документов (document repository) предназначено для прозрачного, безопасного, надёжного и постоянного хранения СЭМД, содержащих сведения об оказанной медицинской помощи, медицинских экспертизах, медицинских осмотрах и медицинских освидетельствованиях, обезличенных в порядке, установленном уполномоченным федеральным органом исполнительной власти по согласованию с федеральным органом исполнительной власти, осуществляющим функции по контролю и надзору в сфере средств массовой коммуникации, а также обеспечивает обработку запросов на сохранение новых СЭМД;
регистр документов (document registry) предназначен для хранения информации об этих документах.

Клинический документ может содержать любой тип медицинской информации: простой текст, форматированный текст, медицинские изображения (например, соответствующие стандарту DICOM), а также структурированную медицинскую информацию, кодированную с помощью контролируемых словарей. Для регистрации клинических документов в ИЭМК используется их представление в формате HL7 CDA R2.

Транзакцию «Предоставить и зарегистрировать набор документов» инициирует действующее лицо Источник документов. Каждый документ набора передаётся Хранилищу документов в формате xml, закодированном в base64, дополненным метаданными этого документа, и подвергается декодированию. Действующее лицо Хранилище документов отвечает за долгосрочное хранение этих документов и за их регистрацию с помощью транзакции «Зарегистрировать набор документов», в процессе которой метаданные, полученные от источника документов, направляются действующему лицу Регистр документов.

Возможные виды передаваемых документов

В подсистеме ИЭМК доступна регистрация следующие ЭМД:

ЭМД	Вид МД	Описание по справочнику 1.2.643.5.1.13.13.11.1520
4	8	Медицинская справка о допуске к управлению транспортными средствами (CDA) Редакция 1
13	13	Медицинское свидетельство о смерти (CDA) Редакция 2
15	6	Протокол инструментального исследования (CDA) Редакция 1
16	5	Протокол консультации (CDA) Редакция 2
17	7	Протокол лабораторного исследования (CDA) Редакция 2
33	33	Медицинское свидетельство о рождении (CDA) Редакция 3
41	1	Эпикриз в стационаре выписной (CDA) Редакция 3
42	2	Эпикриз по законченному случаю амбулаторный (CDA) Редакция 3
43	3	Направление на госпитализацию, восстановительное лечение, обследование, консультацию (CDA) Редакция 2
44	10	Выписной эпикриз из родильного дома (CDA) Редакция 2
45	11	Протокол гемотрансфузии (CDA) Редакция 2
46	12	Протокол прижизненного патологоанатомического исследования (CDA) Редакция 1

Пример запроса

Описание параметров приведено в таблице ниже.

POST: https://egisz-test.medflex.ru/api/iemk/v1/documents/register_set/

Authorization: Token <Токен>

{
    "organization": {
        "oid": "1.2.643.5.1.13.13.12.0.0.00000",
        "name": "ООО \"Моя клиника\""
    },
    "patient": {
        "local_id": "3e3bb21c-b3dd-11de-8172-001583078ee5"
    },
    "container": {
        "id": "a7f84b58-81ac-4467-9c98-6782678bee58",
        "title": "Заявка 00000000743 от 18.02.2025 9:18:53",
        "author": {
            "snils": "61343718371",
            "surname": "Зигангиров",
            "name": "Артур",
            "patr_name": null,
            "position": 334
        },
        "documents": [
            {
                "author": {
                    "snils": "61343718371",
                    "surname": "Зигангиров",
                    "name": "Артур",
                    "patr_name": null,
                    "position": 109
                },
                "local_document_uid": "e5bafde8-f5a8-48ab-9fe9-9feba339b5b7",
                "kind": 4,
                "title": "ИЭМК Тестовый шаблон",
                "creation_date_time": "2025-07-11T15:48.000+03:00",
                "personal": {
                    "snils": "61343718371",
                    "surname": "Зигангиров",
                    "name": "Артур",
                    "patr_name": null
                },
                "data": "PENsaW5pY2FsRG9jdW1lbnQvPgo=",
                "association_type": "append"
            }
        ]
    }
}

Параметр	Описание
`request_id`	Желаемый идентификатор запроса в `uuid` формате
`organization`	Информация о МО
`organization.oid`	OID МО по справочнику 1.2.643.5.1.13.13.11.1461

`patient`	Блок пациента
`patient.local_id`	Идентификатор пациента в МИС

`container`	Блок контейнера документов
`container.id`	Идентификатор контейнера документов в МИС
`container.title`	Описание контейнера
`container.description`	Комментарий к контейнеру документов
`container.author`	Блок автора контейнера документов

`author.snils`	СНИЛС. В формате XXXXXXXXXXX
`author.surname`	Фамилия сотрудника
`author.name`	Имя сотрудника
`author.patr_name`	Отчество сотрудника
`author.position`	Идентификатор должности сотрудника по справочнику 1.2.643.5.1.13.13.11.1002

`documents`	Список набора СЭМД передаваемых в ИЭМК
`document. local_document_uid`	Локальный идентификатор документа в МИС
`document.kind`	OID вида документов по справочнику 1.2.643.5.1.13.13.11.1520. Допускается ограниченный набор видов документов: 41, 42, 43, 16, 15, 17, 4, 44, 45, 46, 13, 33
`document.title`
`document.description`	Комментарий к документу
`document.language`	Код языка документа. По умолчанию `ru-RU`
`document. creation_date_time`	Дата и время создания документа. Локальное время с указанием часового пояса
`document. begin_date_time`	Дата и время начала обращения. Локальное время с указанием часового пояса
`document.end_date_time`	Дата и время окончания обращения. Локальное время с указанием часового пояса
`document.diagnosis`	Код болезни по МКБ-10

`document.author`	Блок автора документа. Может отличаться от автора контейнера документов
`author.snils`	СНИЛС. В формате XXXXXXXXXXX
`author.surname`	Фамилия сотрудника
`author.name`	Имя сотрудника
`author.patr_name`	Отчество сотрудника
`author.position`	Идентификатор должности сотрудника по справочнику 1.2.643.5.1.13.13.11.1002

`document.personal`	Блок информации по лицу, подписавшему документ
`personal.snils`	СНИЛС. В формате XXXXXXXXXXX
`personal.surname`	Фамилия сотрудника
`personal.name`	Имя сотрудника
`personal.patr_name`	Отчество сотрудника

`personal.data`	Содержимое CDA документа в формате base64
`personal. association_type`	Тип связи: `append` - добавление нового документа, `replace` - замена уже существующего документа

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

В качестве ответа возвращается идентификатор запроса. Результаты передачи документа в ИЭМК будут отправлены отдельным асинхронным запросом от МедФлекс в ЛПУ (метод registerDocumentResult).

{
    "request_id": "33b03e6e-7319-46e5-b986-22d8559717ee"
}

Получение результатов регистрации

Результаты регистрации документов направляются в клинику асинхронно на адрес

Пример запроса, направляемого в случае успешной регистрации

POST: [base_url]/[registerDocumentResult]

{
    "request_id": "33b03e6e-7319-46e5-b986-22d8559717ee",
    "oid": "1.2.643.5.1.13.13.12.0.0.00000",
    "status": "success"
}

Пример запроса, направляемого в случае выявления ошибок

POST: [base_url]/[registerDocumentResult]

{
    "request_id": "33b03e6e-7319-46e5-b986-22d8559717ee",
    "oid": "1.2.643.5.1.13.13.12.0.0.00000",
    "status": "error",
    "errors": [
        {
            "code": "XDSDuplicateUniqueIdInRegistry",
            "message": "[CRE-154]: A unique ID [2565dd48-043e-493e-841c-df66e2109385] received for a document entry was not unique within the registry"
        },
        {
            "code": "XDSDuplicateUniqueIdInRegistry",
            "message": "[CRE-153]: A unique ID [1bdc5b63-22d1-4010-852b-b4e07c86cf42] received for a submission set or folder was not unique within the registry"
        }
    ]
}

Описание параметров

Параметр	Описание
`request_id`	Идентификатор запроса, который был присвоен при передаче документов на регистрацию
`oid`	OID МО по справочнику 1.2.643.5.1.13.13.11.1461
`status`	Результат регистрации набора документов: `success` - успешно `error` - ошибка
`errors`	Список ошибок
`error.code`	Код ошибки
`error.message`	Описание ошибки

Ожидаемый ответ

Ожидаемый ответ от ЛПУ на запрос доставки результатов регистрации:

{
    "result": "success"
}

Код ответа: 200

В случае получения в ответ кода ошибки 400 и выше, МедФлекс через время выполнит попытку повторной доставки результата.

Получение результатов регистрации через API

Клиент может самостоятельно получить результаты регистрации документов в любой момент времени через api.
Результат выполнения запроса будет идентичен callback запросу registerDocumentResult.

Пример запроса:

GET: https://egisz.dev.prodoctorov.mis/api/iemk/v1/documents/{request_id}/

Где, request_id - идентификатор запроса, который был получен при передаче документов в ИЭМК.

Результат выполнения запроса:

{
    "request_id": "33b03e6e-7319-46e5-b986-22d8559717ee",
    "oid": "1.2.643.5.1.13.13.12.0.0.00000",
    "status": "error",
    "errors": [
        {
            "code": "XDSDuplicateUniqueIdInRegistry",
            "message": "[CRE-154]: A unique ID [2565dd48-043e-493e-841c-df66e2109385] received for a document entry was not unique within the registry"
        },
        {
            "code": "XDSDuplicateUniqueIdInRegistry",
            "message": "[CRE-153]: A unique ID [1bdc5b63-22d1-4010-852b-b4e07c86cf42] received for a submission set or folder was not unique within the registry"
        }
    ]
}