Регистрация документа в РЭМД registerDocument, getDocumentFile

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

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

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

POST: https://egisz-test.medflex.ru/api/remd/v1/register-document/

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

{
  "request_id": "59d8353a-0bc2-48bb-be02-7f7666367d0b",
  "lpu_uid": "ca10f0db-1280-4fd1-ac58-b135867ebe40",
  "local_document_uid": "8a4e9496-88e6-234a-ae69-73505221c008",
  "document_number": "1231454566747766",
  "kind": 34,
  "department": {
    "local_oid": "1.2.643.5.1.13.13.12.2.1.1.0.14",
    "name": "Амбулаторное отделение"
  },
  "patient": {
    "local_id": "3e3bb21c-b3dd-11de-8172-001583078ee5",
    "surname": "Заболотный",
    "name": "Юрий",
    "patr_name": "Павлович",
    "birth_date": "1991-11-21",
    "snils": "96155474337",
    "gender": 1,
    "phone": "9274536276",
    "document": {
      "type": 14,
      "number": "9210445765"
    }
  },
  "personals": [
    {
      "local_id": "f7488b71-5072-11ee-8102-96d03872bb29",
      "surname": "Конюков",
      "name": "Константин",
      "patr_name": "Владимирович",
      "birth_date": "1991-12-31",
      "snils": "15593620486",
      "lpu_uid": "14cefaf8-508b-11ee-8102-96d03872bb29",
      "role": "DOCTOR",
      "position": 106,
      "speciality": 30,
      "phone": "9274536276",
      "email": "mymail@exmple.com",
      "sign": "MIIGhQYJKoZIhvcNAQcCoIIGdjCCBnI ... evJMIY=",
      "description": null
    }
  ],
  "author": {
    "snils": "15593620486"
  },
  "creation_date_time": "2023-09-22T09:26:07.000000+03:00",
  "data": "77u/PD94bWwtc3R5bG ... WxEb2N1bWVudD4NCg==",
  "organization_sign": "MIIGhQYJKo ... gMaleevJMIY="
}

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

Параметр	Описание
request_id	Идентификатор запроса. Если указан, документ прикрепляется к указанному request_id. Может быть использован для повторной регистрации незарегистрированного документа. (Опционально)
lpu_uid	Идентификатор ЛПУ
local_document_uid	Локальный идентификатор документа в МИС
document_number	Локальный идентификатор документа в МИС
kind	OID вида документов по справочнику 1.2.643.5.1.13.13.11.1520
department	Блок ФРМО. Справочник структурных подразделений 1.2.643.5.1.13.13.99.2.114
department.local_oid	OID подразделения
department.name	Наименование подразделения
patient	Блок пациент
patient.local_id	Идентификатор пациента в МИС
patient.surname	Фамилия
patient.name	Имя
patient.patr_name	Отчество (Опционально)
patient.birth_date	Дата рождения
patient.snils	СНИЛС (Опционально)
patient.gender	Пол по справочнику 1.2.643.5.1.13.13.11.1040
patient.phone	Мобильный номер телефона пациента. Передается без разделителей и кода страны. Если номер телефона заполнен, то после успешной регистрации, документ будет передан в МедТочку. Пример: 9242551020 (Опционально)
patient.document	Блок Документ удостоверяющий личность (Опционально)
patient.document. type	Идентификатор типа ДУЛ по справочнику 1.2.643.5.1.13.13.99.2.320
patient.document. number	Номер документа
personals	Список врачей
personals.local_id	Идентификатор врача в МИС
personals.surname	Фамилия
personals.name	Имя
personals.patr_name	Отчество (Опционально)
personals.birth_date	Дата рождения
personals.snils	СНИЛС (Опционально)
personals.role	Код роли по справочнику 1.2.643.5.1.13.13.99.2.368
personals.position	Код должности в организации по справочнику 1.2.643.5.1.13.13.99.2.181
personals.speciality	Код специальности по справочнику (Опционально) 1.2.643.5.1.13.13.11.1066
personals.phone	Номер телефона (Опционально)
personals.email	e-mail (Опционально)
personals.sign	Подпись врача в формате base64
personals.description	Краткое произвольное описание документа. (Опционально) По умолчанию заполнится из справочника по значению kind
creation_date_time	Дата и время создания документа. Локальное время с указанием часового пояса
data	Содержимое CDA или pdf документа в формате base64. Кодировка utf-8
organization_sign	Подпись организации в формате base64

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

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

{
    "request_id": "7d4b38fc-30b0-4b98-baf1-560374762b60"
}

Доставка результата регистрации документа. Метод registerDocumentResult

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

POST: [base_url]/[registerDocumentResult]

{
    "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": "registerDocumentResult",
    "status": "success",
    "registry_item": {
        "emdr_id": "01.20.293.000000403",
        "registration_date_time": "2020-02-06T15:26:27.644+03:00",
        "store_till_date": "2045-02-01+03:00"
    }
}

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

Параметр	Описание
from_system_id	Идентификатор системы: тестовая/промышленная
lpu_uid	Идентификатор ЛПУ
response_to_request_id	Идентификатор сообщения, на которое дается ответ
message_type	Тип запроса
status	Статус обработки. success – успешная обработка запроса. error – ошибка при обработке запроса.
emdr_id	Уникальный номер, присвоенный сведениям об ЭМД в реестре
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": "registerDocumentResult",
    "status": "error",
    "errors": [
        {
            "code": "NOT_UNIQUE_PROVIDED_ID",
            "message": "Документ с идентификатором '8a4e9496-88e6-234a-ae69-73505221c008' уже зарегистрирован"
        }
    ]
}

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

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

Основные ошибки описаны в справочнике 1.2.643.5.1.13.13.99.2.305 - РЭМД. Классификатор кодов сообщений

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

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

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

Ожидаемый ответ от ЛПУ(Ошибка): (Код 400+)

{
    "lpu_uid": "ca10f0db-1280-4fd1-ac58-b135867ebe40",
    "error": "Не удалось записать результат регистрации"
}