Модуль доставки обратных сообщений в МИС

Назначение

Модуль доставки обратных сообщений (далее, Модуль) представляет собой сервис доставки асинхронных сообщений от Модуля приема документов из МИС следующих типов:

• сообщение о статусе генерации CDA по JSON-описанию документа;
• сообщение о результатах регистрации ЭМД в федеральных сервисах ИЭМК и РЭМД ЕГИСЗ;
• сообщение о регистрации в РЭМД ЕГИСЗ документа, сформированного Бюро МСЭ в ответ на Направление на МСЭ;
• сообщение о получении из РЭМД ЕГИСЗ документа, сформированного Бюро МСЭ в ответ на Направление на МСЭ;
• сообщение об асинхронном / синхронном ответе ВИМИС

Порядок взаимодействия с Модулем

Модуль доставки обратных сообщений направляет сообщение в МИС.  Получив сообщение, МИС должна направить в Модуль ответ о принятии сообщения (см. Структура ответа МИС о получении сообщения). Если МИС не направит ответ, сообщение будет считаться не доставленным, и будет инициирована повторная отправка сообщения. Количество раз повторной отправки является настраиваемым параметром, и по умолчанию оно ограничено 5 попытками.  

В качестве протокола взаимодействия между Модулем принимающей системой используется REST. Сообщения в МИС направляются в формате JSON, ответные сообщения от МИС также принимаются в JSON-формате. 

Сообщения направляются в МИС запросом методом POST:

POST  [base]/[MessageType]

где:

• [base] - адрес Сервиса обратного вызова в МИС;
• [MessageType] -  тип информационного сообщения (типы сообщений приведены в столбце MessageType в таблице раздела Типы сообщений )

Типы сообщений

Принимающая сторона получает сообщения следующих типов:

Структура сообщений указанных типов приведена в разделе Структура сообщений, направляемых в МИС

Сервис обратного вызова площадки МИС-МО

Для взаимодействия с Модулем доставки обратных сообщений в МИС, н а стороне принимающей системы необходимо реализовать Сервис обратного вызова МИС-МО.  Он должен принимать сообщения от Модуля и отправлять в него обратный ответ об успешном получении сообщения в формате JSON. 

Получение сообщений о статусе генерации CDA-описания ЭМД и результатах выгрузки СЭМД

Для получения сообщений о статусе генерации CDA-описания ЭМД, а также сообщений о результатах выгрузки СЭМД, при отправке/обновлении JSON-описания ЭМД  в Модуль приема документов от МИС методами, указанными в документе API Модуля приема документов от МИС, необходимо в заголовке запроса в параметре "Reply-To" указать адрес сервиса обратного вызова площадки МИС-МО . 

Reply-To: http://rc-test/back/

Получение сообщений о регистрации ЭМД и Обратного талона в РЭМД, а также о получении Обратного талона из РЭМД

Для получения сообщений о регистрации ЭМД, регистрации и получении Обратного талона из РЭМД, в сервисе ИЭМК должен быть зарегистрирован адрес сервиса обратного вызова площадки (МИС-МО). Регистрация адресов площадок находится в зоне ответственности МИАЦ региона.

Структура сообщений, направляемых в МИС

Информирование МИС о статусе генерации CDA-описания ЭМД

Сообщение, информирующее МИС о статусе генерации 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": "idDocumentMis_2125630",
	"IdMedDocument": 1053,
	"MedDocumentType": 33,
	"Lpu": "20dfadd0-c709-43b0-a130-5a16301b0217",
	"MessageId": "b097fea5-e6f6-4417-9829-53ab6a562719",
	"Status": "Success",
	"Message": "СЭМД успешно загружен в ФИЭМК"
}

Информирование МИС о результатах регистрации ЭМД в РЭМД

Сообщение, информирующее МИС  о результатах регистрации ЭМД в РЭМД, содержит следующие параметры:

{
	"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": "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-й редакции:

Информирование МИС о получении из РЭМД ЕГИСЗ документа, сформированного Бюро МСЭ в ответ на Направление на МСЭ

Сообщение, информирующее МИС о получении из РЭМД ЕГИСЗ документа, сформированного Бюро МСЭ в ответ на Направление на МСЭ, содержит параметры:

{
	"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": "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": "b097fea5-e6f6-4417-9829-53ab6a562719",	
	"Message": "Сообщение принято успешно",	
	"Status": "Success"
}