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