Получение метаописания ЭМД в РЭМД getMetadata

Метод getMetadata позволяет запросить метаописание ЭМД, зарегистрированного в РЭМД, по номеру записи в реестре. Доступ к записям разграничен, каждая ИС может получить метаописание ЭМД, зарегистрированных этой ИС. Также возможно получение метаописания ЭМД, зарегистрированных другими ИС, при наличии соответствующих разрешений. В ответе возвращается метаописание актуальной версии документа.

Базовый сценарий

Сценарий получения метаданных ЭМД, зарегистрированных в РЭМД. Возможно как получение метаописания собственных документов, так и документов, зарегистрированных другими системами, при наличии разрешения на документы этих систем.

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

POST: https://egisz-test.medflex.ru/api/remd/v1/demand-content/

Authorization: Token <Токен ЛПУ>

{
  "request_id": "59d8353a-0bc2-48bb-be02-7f7666367d0b",
  "lpu_uid": "ca10f0db-1280-4fd1-ac58-b135867ebe40",
  "emdr_id": "01.18.246.000000184"
}

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

Параметр	Описание
request_id	Идентификатор запроса. (Опционально)
lpu_uid	Идентификатор ЛПУ
emdr_id	Номер документа в реестре

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

При успешном запросе возвращается идентификатор сообщения:

{
    "request_id": "fa36a4c4-f175-4ee5-ae66-ceb757eb88d6"
}

Доставка результата

Запрос, направляемый в ЛПУ в случае успешного получения метаописания

POST: [base_url]/[getMetadata]

{
    "from_system_id": "84ccfa89-f736-4929-a44a-a3ca9bf55b91",
    "lpu_uid": "ca10f0db-1280-4fd1-ac58-b135867ebe40",
    "response_to_request_id": "fa36a4c4-f175-4ee5-ae66-ceb757eb88d6",
    "message_type": "getMetadata",
    "status": "success",
    "kind": 8,
    "description": "Протокол консультации с применением телемедицинских технологий",
    "system_name": "ТМК",
    "region": 1,
    "organization": "1.2.643.5.1.13.13.12.2.1.1",
    "document_number": "18074",
    "creation_date_time": "2018-06-01T00:00:00+03:00",
    "registration_date_time": "2018-06-01T18:23:41.109+03:00",
    "store_till_date": "2038-06-01+03:00",
    "patient": {
        "snils": "13637824376",
        "local_id": "emdr-rmis-17/122"
    },
    "signers": [
        {
            "role": "DOCTOR",
            "surname": "Львов",
            "name": "Максим",
            "patr_name": "Андреевич",
            "snils": "14874311883",
            "position": 34
        }
    ]
}

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

Параметр	Описание
from_system_id	Идентификатор системы: тестовая/промышленная
lpu_uid	Идентификатор ЛПУ
response_to_request_id	Идентификатор сообщения, на которое дается ответ
message_type	Тип запроса
status	Статус обработки. success – успешная обработка запроса. error – ошибка при обработке запроса.
kind	OID вида документа согласно справочнику «Регистрируемые электронные медицинские документы», OID 1.2.643.5.1.13.13.11.1520
description	Краткое описание документа. Ограничивается длиной в 1000 символов
system_name	Наименование ИС, зарегистрировавшей документ
region	Код региона организации, зарегистрировавшей документ
organization	OID МО, зарегистрировавшей документ согласно ФРМО. (справочник «Регистр медицинских организаций Российской Федерации. Версия 2», OID 1.2.643.5.1.13.13.11.1461)
document_number	Регистрационный номер документа внутри организации или подразделения
creation_date_time	Дата и время создания документа внутри организации или ее подразделения
registration_date_time	Дата и время создания записи в реестре
store_till_date	Актуальный срок хранения записи реестра
patient	Блок пациент
patient.snils	СНИЛС пациента. Ограничивается длиной в 11 символов
patient.local_id	Уникальный идентификатор пациента в ИС. Ограничивается длиной в 50 символов
signers	Список сведений о сотрудниках МО, подписавших документ
signers.role	Код роли по справочнику «Справочник ролей сотрудников при подписи электронных медицинских документов», OID 1.2.643.5.1.13.13.99.2.368
signers.surname	Фамилия сотрудника. Ограничивается длиной в 100 символов.
signers.name	Имя сотрудника. Ограничивается длиной в 100 символов.
signers.patr_name	Имя сотрудника (Опционально). Ограничивается длиной в 100 символов.
signers.snils	СНИЛС сотрудника Ограничивается длиной в 11 символов.
signers.position	Идентификатор должность по справочнику «ФРМР. Должности медицинского персонала», OID 1.2.643.5.1.13.13.99.2.181
signers.speciality	Идентификатор специальности по справочнику «Номенклатура специальностей специалистов со средним, высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения», (Опционально) OID 1.2.643.5.1.13.13.11.1066

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

Ожидаемый ответ от ЛПУ: (Код 200)

{
    "lpu_uid": "ca10f0db-1280-4fd1-ac58-b135867ebe40",
    "status": "success"
}

Запрос, направляемый в ЛПУ в случае выявления ошибок

POST: [base_url]/[error]

{
    "from_system_id": "84ccfa89-f736-4929-a44a-a3ca9bf55b91",
    "lpu_uid": "ca10f0db-1280-4fd1-ac58-b135867ebe40",
    "response_to_request_id": "7d4b38fc-30b0-4b98-baf1-560374762b60",
    "message_type": "searchRegistryItem",
    "status": "error",
    "errors": [
        {
            "code": "REGISTRY_ITEM_NOT_FOUND",
            "message": "Не удалось найти запись по идентификатору 01.18.246.000000184"
        }
    ]
}

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

Параметр	Описание
from_system_id	Идентификатор системы: тестовая/промышленная
lpu_uid	Идентификатор ЛПУ
response_to_request_id	Идентификатор сообщения, на которое дается ответ
message_type	Тип запроса
status	Статус обработки. success – успешная обработка запроса. error – ошибка при обработке запроса.
errors	Список ошибок
code	Код ошибки
message	Описание ошибки

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

Ожидаемый ответ от ЛПУ: (Код 200)

{
    "lpu_uid": "ca10f0db-1280-4fd1-ac58-b135867ebe40",
    "status": "success"
}