Поиск записи реестра по метаописанию ЭМД searchRegistryItem

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

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

POST: https://egisz-test.medflex.ru/api/remd/v1/search-registry-item/

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

{
    "request_id": "59d8353a-0bc2-48bb-be02-7f7666367d0b",
    "lpu_uid": "ca10f0db-1280-4fd1-ac58-b135867ebe40",
    "target_organization_oid": "1.2.643.5.1.13.13.12.2.1.27",
    "local_uid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "kind": "34",
    "document_number": "3643882",
    "patient_id": "56435",
    "patient_snils": "11223344595",
    "creation_date_begin": "2019-01-01T16:03:25.725+03:00",
    "creation_date_end": "2019-08-01T16:03:25.725+03:00",
    "register_date_begin": "2019-01-01T16:03:25.725+03:00",
    "register_date_end": "2019-08-01T16:03:25.725+03:00",
    "page": 0
}

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

Параметр	Описание
request_id	Идентификатор запроса. (Опционально)
lpu_uid	Идентификатор ЛПУ
target_organization_oid	Медицинская организация. Указывается OID МО согласно ФНСИ. Заполняется по справочнику «Регистр медицинских организаций Российской Федерации. Версия 2», OID 1.2.643.5.1.13.13.11.1461
local_uid	Уникальный идентификатор документа. Предоставляется в формате UUID. Например: 550e8400-e29b-41d4-a716-446655440000. Ограничивается длиной в 36 символов
kind	Вид документа. Указывается OID вида документа. Заполняется по справочнику «Регистрируемые электронные медицинские документы», OID 1.2.643.5.1.13.13.11.1520
document_number	Номер документа. Регистрационный номер ЭМД внутри организации или подразделения
patient_id	Идентификатор пациента. Уникальный идентификатор пациента в ИС
patient_snils	СНИЛС пациента. Передается без разделителей.
page	Страница. Номер запрашиваемой страницы результатов. Нумерация производится с нуля
creation_date_begin	Дата и время начала периода создания документа. Дата и время начала периода регистрации ЭМД внутри организации или ее подразделения
creation_date_end	Дата и время окончания периода создания документа. Дата и время окончания периода регистрации ЭМД внутри организации или ее подразделения
register_date_begin	Дата и время начала периода регистрации документа. Дата и время начала периода регистрации ЭМД в РЭМД
register_date_end	Дата и время окончания периода регистрации документа. Дата и время окончания периода регистрации ЭМД в РЭМД
page	Номер страницы. Нумерация с нуля

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

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

{
    "request_id": "d37d3997-3784-430d-8f98-4920bc6e9e6c"
}

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

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

POST: [base_url]/[searchRegistryItem]

{
    "from_system_id": "84ccfa89-f736-4929-a44a-a3ca9bf55b91",
    "lpu_uid": "c3af5343-6694-4ce4-bc9f-e9e55da92d91",
    "response_to_request_id": "d37d3997-3784-430d-8f98-4920bc6e9e6c",
    "message_type": "searchRegistryItem",
    "matches": [
        {
            "emdr_id": "01.19.195.000000913",
            "local_uid": "9157b900-991c-11e9-9131-005056b1747f",
            "registration_date_time": "2019-06-27T23:46:48.338+03:00",
            "store_till_date": "2039-06-26+03:00"
        },
        {
            "emdr_id": "01.19.195.000001094",
            "local_uid": "f6e19a6f-a14b-11e9-96c0-005056b13602",
            "registration_date_time": "2019-07-08T17:06:57.869+03:00",
            "store_till_date": "2039-06-26+03:00"
        }
    ],
    "page": {
        "items_per_page": 1000,
        "has_next": false
    }
}

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

Параметр	Описание
from_system_id	Идентификатор системы: тестовая/промышленная
lpu_uid	Идентификатор ЛПУ
response_to_request_id	Идентификатор сообщения, на которое дается ответ
message_type	Тип запроса
status	Статус обработки. success – успешная обработка запроса. error – ошибка при обработке запроса.
matches	Список результатов при успешном поиске
emdr_id	Уникальный номер, присвоенный сведениям об ЭМД в реестре
local_uid	Уникальный идентификатор документа, переданный ИС при регистрации. Предоставляется в формате UUID. Например: 550e8400-e29b-41d4-a716-446655440000
registration_date_time	Дата и время создания записи в реестр
store_till_date	Срок хранения сведений, установленный в соответствии с политиками хранения данного вида ЭМД. Пустое значение означает регистрацию ЭМД без ограничения срока хранения сведений

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

Ожидаемый ответ от ЛПУ: (Код 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": "ValidationError",
            "message": "ИС с идентификатором ИПС '17c74e63-dc38-438d-a27a-a1aa063ee7b1' не зарегистрирована в подсистеме РЭМД"
        }
    ]
}

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

Параметр	Описание
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"
}