Модуль доставки обратных сообщений (далее, Модуль) представляет собой сервис доставки асинхронных сообщений от Модуля приема документов из МИС следующих типов:
Модуль доставки обратных сообщений направляет сообщение в МИС. Получив сообщение, МИС должна направить в Модуль ответ о принятии сообщения (см. Структура ответа МИС о получении сообщения). Если МИС не направит ответ, сообщение будет считаться не доставленным, и будет инициирована повторная отправка сообщения. Количество раз повторной отправки является настраиваемым параметром, и по умолчанию оно ограничено 5 попытками.
В качестве протокола взаимодействия между Модулем принимающей системой используется REST. Сообщения в МИС направляются в формате JSON, ответные сообщения от МИС также принимаются в JSON-формате.
Сообщения направляются в МИС запросом методом POST:
POST [base]/[MessageType]
где:
Принимающая сторона получает сообщения следующих типов:
Тип сообщения | MessageType |
---|---|
Статус генерации CDA-описания ЭМД | CDAStatus |
Результаты выгрузки СЭМД | SEMDStatus |
Результаты регистрации ЭМД в РЭМД | REMDStatus |
Регистрация РЭМД ЕГИСЗ документа, сформированного Бюро МСЭ в ответ на Направление на МСЭ (по тексту "Обратный талон") |
MseResult |
Получение из РЭМД ЕГИСЗ документа , сформированного Бюро МСЭ в ответ на Направление на МСЭ |
MseResultData |
Статус выгрузки СЭМД/СЭМД-бета в ВИМИС | VimisResult |
Структура сообщений указанных типов приведена в разделе Структура сообщений, направляемых в МИС
Для взаимодействия с Модулем доставки обратных сообщений в МИС, н а стороне принимающей системы необходимо реализовать Сервис обратного вызова МИС-МО. Он должен принимать сообщения от Модуля и отправлять в него обратный ответ об успешном получении сообщения в формате JSON.
Важно
Для каждой площадки МИС-МО должен быть заведен уникальный адрес сервиса обратного вызова
Для получения сообщений о статусе генерации CDA-описания ЭМД, а также сообщений о результатах выгрузки СЭМД, при отправке/обновлении JSON-описания ЭМД в Модуль приема документов от МИС методами, указанными в документе API Модуля приема документов от МИС, необходимо в заголовке запроса в параметре "Reply-To" указать адрес сервиса обратного вызова площадки МИС-МО .
Reply-To: http://rc-test/back/
Для получения сообщений о регистрации ЭМД, регистрации и получении Обратного талона из РЭМД, в сервисе ИЭМК должен быть зарегистрирован адрес сервиса обратного вызова площадки (МИС-МО). Регистрация адресов площадок находится в зоне ответственности МИАЦ региона.
Сообщение, информирующее МИС о статусе генерации CDA-описания ЭМД, содержит следующие параметры:
Параметр | Тип | Кратность | Описание |
---|---|---|---|
IdMedDocumentMis | string | 1..1 | Идентификатор документа в МИС |
IdMedDocument | int | 1..1 | Идентификатор документа в Модуле приема документов от МИС |
MedDocumentType | int | 1..1 | Тип ЭМД по справочнику 1.2.643.5.1.13.13.99.2.41 |
Lpu | string | 1..1 | Идентификатор МО-отправителя ЭМД |
MessageId | uuid | 1..1 | Идентификатор сообщения |
Status | string | 1..1 |
Статус:
|
Message | string | 1..1 | Текстовый ответ при формировании CDA-описания ЭМД |
CDA | base64 | 0..1 | Тело CDA-описания ЭМД |
{ "IdMedDocumentMis": "idDocumentMis_2125630", "IdMedDocument": 1053, "MedDocumentType": 33, "Lpu": "20dfadd0-c709-43b0-a130-5a16301b0217", "MessageId": "f46d3bba-d1af-4d4a-9e69-71952d5cefe7", "Status": "Success", "Message": "CDA успешно сформирован", "CDA": [место для данных в формате base64] }
Сообщение, информирующее МИС о результатах выгрузки СЭМД в ИЭМК ЕГИСЗ содержит следующие параметры:
Параметр | Тип | Кратность | Описание |
---|---|---|---|
IdMedDocumentMis | string | 1..1 | Идентификатор документа в МИС |
IdMedDocument | int | 1..1 | Идентификатор документа в Модуле приема документов от МИС |
MedDocumentType | int | 1..1 | Тип ЭМД по справочнику 1.2.643.5.1.13.13.99.2.41 |
Lpu | string | 1..1 | Идентификатор МО-отправителя ЭМД |
MessageId | uuid | 1..1 | Идентификатор сообщения |
Status | string | 1..1 |
Статус
|
Message | string | 1..1 | Информационное сообщение о результатах выгрузки СЭМД в Федеральный сервис ИЭМК ЕГИСЗ |
{ "IdMedDocumentMis": "idDocumentMis_2125630", "IdMedDocument": 1053, "MedDocumentType": 33, "Lpu": "20dfadd0-c709-43b0-a130-5a16301b0217", "MessageId": "b097fea5-e6f6-4417-9829-53ab6a562719", "Status": "Success", "Message": "СЭМД успешно загружен в ФИЭМК" }
Сообщение, информирующее МИС о результатах регистрации ЭМД в РЭМД, содержит следующие параметры:
Параметр | Тип | Кратность | Описание |
---|---|---|---|
IdSourceMis | string | 1..1 | Идентификатор документа в МИС |
MedDocumentType | int | 1..1 | Тип ЭМД по справочнику 1.2.643.5.1.13.13.99.2.41 |
Lpu | string | 1..1 | Идентификатор МО-отправителя ЭМД |
MessageId | uuid | 1..1 | Идентификатор сообщения |
Status | string | 1..1 |
Статус
|
Message | string | 1..1 | Информационное сообщение о результатах выгрузки ЭМД в РЭМД ЕГИСЗ |
IdFedRequest | uuid | 1..1 | Идентификатор запроса на регистрацию ЭМД в РЭМД ЕГИСЗ |
RemdRegNumber | string | 0..1 | Уникальный идентификатор зарегистрированного ЭМД в РЭМД ЕГИСЗ |
{ "IdSourceMis": "idDocumentMis_2125630", "MedDocumentType": 33, "Lpu": "20dfadd0-c709-43b0-a130-5a16301b0217", "MessageId": "b097fea5-e6f6-4417-9829-53ab6a562719", "Status": "Success", "Message": "ЭМД успешно загружен в РЭМД", "IdFedRequest": "8ed37cdf-8ed0-427e-9a94-14f40bbea18a", "RemdRegNumber": "215573" }
Сообщение, информирующее МИС о регистрации в РЭМД ЕГИСЗ документа, сформированного Бюро МСЭ в ответ на Направление на МСЭ, содержит параметры:
Параметр | Тип | Кратность | Описание |
---|---|---|---|
Lpu | string | 1..1 | Идентификатор МО-отправителя ЭМД |
MessageId | uuid | 1..1 | Идентификатор сообщения |
IdMSEMis | string | 1..1 | Идентификатор документа "Направление на медико-социальную экспертизу" в МИС, для которого сформирован ответный документ от Бюро МСЭ |
IdResultMSE | string | 1..1 | Идентификатор ответного от Бюро МСЭ документа, в РЭМД ЕГИСЗ |
MedDocumentType | int | 1..1 | Тип ЭМД по справочнику 1.2.643.5.1.13.13.99.2.41 (значение remd_code по справочнику 1.2.643.2.69.1.1.1.195) |
Message | string | 1..1 | Информационное сообщение о результатах регистрации в РЭМД ЕГИСЗ документа, сформированного Бюро МСЭ в ответ на Направление на МСЭ |
Status | string | 1..1 |
Статус
|
{ "Lpu": "20dfadd0-c709-43b0-a130-5a16301b0217", "MessageId": "b097fea5-e6f6-4417-9829-53ab6a562719", "IdMSEMis": "ReferralMSE:558", "IdResultMSE": "01.20.2735.000025073", "MedDocumentType": 102, "Message": "Получены данные о регистрации ЭМД", "Status": "Success" }
Сообщение формируется на следующие виды полученных ЭМД для МСЭ 5-й и 6-й редакции:
Документ | emd_type |
MedDocumentType=fed_emd_type=remd_code= docKind в присылаемом от РЭМД ЭМД |
---|---|---|
Справка о возврате направления на медико-социальную экспертизу (Редакция 1) | 123 | 108 |
Сведения о результатах проведенной медико-социальной экспертизы (CDA) Редакция 2 | 35 | 35 |
Справка об отказе в направлении на медико-социальную экспертизу (Редакция 1) | 117 | 102 |
Сообщение, информирующее МИС о получении из РЭМД ЕГИСЗ документа, сформированного Бюро МСЭ в ответ на Направление на МСЭ, содержит параметры:
Параметр | Тип | Кратность | Описание |
---|---|---|---|
Lpu | text | 1..1 | Идентификатор МО-отправителя документа "Направление на медико-социальную экспертизу" |
MessageId | uuid | 1..1 | Идентификатор сообщения |
IdMSEMis | text | 1..1 | Идентификатор документа "Направление на медико-социальную экспертизу" в МИС, для которого зарегистрирован обратный талон |
IdResultMSE | text | 1..1 | Идентификатор документа, сформированного Бюро МСЭ в ответ на Направление на МСЭ, в РЭМД ЕГИСЗ |
MedDocumentType | int | 1..1 | Тип ЭМД по справочнику 1.2.643.5.1.13.13.99.2.41 (значение remd_code по справочнику 1.2.643.2.69.1.1.1.195) |
Data | 0..1 | Файл документа, сформированного Бюро МСЭ в ответ на Направление на МСЭ | |
Message | text | 1..1 | Информационное сообщение |
Status | string | 1..1 |
Статус
|
{ "Lpu": "20dfadd0-c709-43b0-a130-5a16301b0217", "MessageId": "b097fea5-e6f6-4417-9829-53ab6a562719", "IdMSEMis": "ReferralMSE:558", "IdResultMSE": "01.20.2735.000025073", "MedDocumentType": 108, "Data": [место для данных в формате base64] "Message": "ЭМД получен от РЭМД", "Status": "Success" }
Сообщение, информирующее МИС о статусе сборке и/или выгрузке СЭМД/СЭМД-бета в ВИМИС
Параметр | Тип | Кратность | Описание |
---|---|---|---|
MessageId | uuid | 1..1 | Идентификатор Сallback -а |
Message | text | 1..1 | Информационное сообщение о результатах выгрузки |
Status | string | 1..1 |
Статус
|
Lpu | text | 1..1 | Идентификатор МО-отправителя ЭМД |
DocType |
int | 1..1 | Номер СЭМД/СЭМД-бета |
IdSourse |
string |
1..1 |
Идентификатор источника, по которому формируется СЭМД/СЭМД-бета |
IdRecipientSystem | string | 1..1 | Идентификатор системы получателя ВИМИС (ОНКО/АКиНЕО и т.д) |
StatusСode | int | 1..1 | Код статуса |
IdCaseMis |
string |
1..1 |
Идентификатор случая в передающей МИС |
IdDocumentMis |
string |
1..1 |
Идентификатор документа в системе-источнике (МИС) |
{ "MessageId": "24a8515f-d0b3-4778-8af2-d0f4ff976215", "Message": "Валидация документа прошла успешно", "Status": "Success", "Lpu": "bb155d55-a036-404c-aa25-f7e55bab3d57", "DocType": 5, "IdSource": "12393", "IdRecipientSystem": "Онкология", "StatusCode": 4 "IdCaseMis": "3462895" "IdDocumentMis": "2354219" }
В Таблице приведена структура и описание параметров подтверждения получения информационного сообщения, направляемого от МИС в Модуль доставки обратных сообщений в МИС. Набор параметров является общим и не зависит от типа полученного информационного сообщения.
Параметр | Тип | Кратность | Описание |
---|---|---|---|
MessageId | uuid | 1..1 | Идентификатор сообщения, получение которого подтверждает МИС |
Message | string | 1..1 | Текстовый ответ |
Status | string | 1..1 |
Статус
|
{ "MessageId": "b097fea5-e6f6-4417-9829-53ab6a562719", "Message": "Сообщение принято успешно", "Status": "Success" }