Регистрация документа в РЭМД 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": "Не удалось записать результат регистрации"
}