СОДЕРЖАНИЕ
Аннотация
1 Общие положения
1.1 Определения, обозначения и сокращения
1.2 Назначение документа
1.3 Порядок подключения к АЭМД
2 Сценарии взаимодействия с ИС
2.1 Регистрация сведений об ЭМД
2.1.1 Участники
2.1.2 Критерий успешности выполнения
2.1.3 Предварительные условия
2.1.4 Базовый сценарий
2.2 Поиск записей в АЭМД
2.2.1 Участники
2.2.2 Критерий успешности выполнения
2.2.3 Предварительные условия
2.2.4 Базовый сценарий
2.3 Запрос регистрационных сведений об ЭМД в АЭМД
2.3.1 Участники
2.3.2 Критерий успешности выполнения
2.3.3 Предварительные условия
2.3.4 Базовый сценарий
2.4 Получение файла ЭМД запрашивающей ИС из АЭМД
2.4.1 Участники
2.4.2 Критерий успешности выполнения
2.4.3 Предварительные условия
2.4.4 Базовый сценарий
2.5 Получение метаописания ЭМД в АЭМД
2.5.1 Участники
2.5.2 Критерий успешности выполнения
2.5.3 Предварительные условия
2.5.4 Базовый сценарий
2.6 Отправка в ИС уведомления о регистрации ЭМД из другой ИС
2.6.1 Участники
2.6.2 Критерий успешности выполнения
2.6.3 Предварительные условия
2.6.4 Базовый сценарий
3 Описание веб-сервиса обмена сведениями об ЭМД
3.1 Описание транспортного заголовка АЭМД
3.2 Метод «registerDocument»
3.3 Метод «searchRegistryItem»
3.4 Метод «getRegistryItem»
3.5 Метод «demandContent»
3.6 Метод «getMetadata»
4 Описание веб-сервиса на стороне ИС
4.1 Метод «sendRegisterDocumentResult»
4.2 Метод «sendDocumentFile»
4.3 Метод «sendNotice»
6. Требования к формату файла документа в электронном виде
6.1 Формат файла документа PDF/A-1
6.2 Формат файла документа XML
6.3 Требования к электронной подписи
7. Список ссылочных документов
ИСТОРИЯ ИЗМЕНЕНИЯ ДОКУМЕНТА
Приложение А
Приложение Б
Метод «registerDocument»
Метод «searchRegistryItem»
Метод «getRegistryItem»
Метод «demandContent»
Метод «getMetadata»
Приложение В
Метод «sendRegisterDocumentResult»
Метод «sendDocumentFile»
Метод «sendNotice»
Аннотация
Настоящий документ представляет собой описание интеграционных профилей подсистемы «АЭМД» для интеграции с подсистемами Единой информационной системы в сфере здравоохранения, государственными информационными системами в сфере здравоохранения субъектов Российской Федерации и иными информационными системами.
Общие положения
Определения, обозначения и сокращения
Таблица 1 – Определения, обозначения и сокращения
Термин | Описание |
CAdES | CMS Advanced Electronic Signatures – стандарт электронной подписи, представляющий собой расширенную версию стандарта электронной подписи CMS (Cryptographic Message Syntax) |
OID | Уникальный идентификатор объекта Минздрава России |
Portable Document Format – платформонезависимый формат электронных документов, созданный фирмой Adobe Systems использованием ряда возможностей PostScript | |
PDF/A | Portable Document Format/A – стандарт ISO 19005-1:2005 для долгосрочного архивного хранения электронных документов и базируется на описании стандарта PDF версии 1.4 |
SOAP | Simple ObjectAccess Protocol — простой протокол доступа к объектам |
WSDL | Web Services Description Language – язык описания веб-сервисов |
XML | eXtensible Markup Language — расширяемый язык разметки |
ГИП | Компонент подсистемы РЭМД, отвечающий за учет сведений о пациентах с учетом их обезличивания в соответствии с требованиями Федерального закона от 21.11.2011 №323-ФЗ «Об основах охраны здоровья граждан в Российской Федерации» |
ДИТ МЗ РФ | Департамент цифрового развития и информационных технологий Министерства здравоохранения Российской Федерации |
ЕСИА | Единая система идентификации и аутентификации |
Запись реестра | Набор сведений об электронном медицинском документе |
ИПС | Интеграционная подсистема интеграции прикладных систем ЕГИСЗ |
ИС | Информационная система |
Метаописание документа | Набор данных, описывающих контекст, содержание и структуру документа, а также управление документом во времени |
МО | Медицинская организация |
МИС | Медицинская информационная система |
НПА | Нормативный правовой акт |
ОГРН | Основной государственный регистрационный номер |
ГИС | Государственная информационная система в сфере здравоохранения субъекта Российской Федерации |
РЭМД | Подсистема «Федеральный реестр электронных медицинских документов» ЕГИСЗ |
СКЗИ | Средство криптографической защиты информации |
СНИЛС | Страховой номер индивидуального лицевого счёта |
СТП | Служба технической поддержки |
ФРМО | Подсистема «Федеральный реестр медицинских организаций» ЕГИСЗ |
ФРМР | Подсистема «Федеральный регистр медицинских работников» ЕГИСЗ |
ЭМД | Медицинский документ в форме электронного документа |
ЭП | Электронная подпись |
ФЛК | Форматно-логический контроль |
Назначение документа
Настоящий документ предназначен для разработчиков государственных информационных систем в сфере здравоохранения субъекта Российской Федерации (далее – ГИС), медицинских информационных систем (далее МИС) и иных информационных систем, интегрируемых с подсистемой «АЭМД» (далее – АЭМД, подсистема), и описывает методологию разработки взаимодействия с подсистемой при передаче сведений о медицинской документации в форме электронных документов, по составу которой невозможно определить состояние здоровья гражданина, и сведения о медицинской организации, в которой такая документация создана и хранится.
Настоящая спецификация интеграционных профилей определяет основной набор сообщений для обмена сведениями об ЭМД.
Порядок подключения к АЭМД
Для подключения ИС в тестовой/промышленной среде АЭМД необходимо направить официальное письмо в адрес Государственного автономного учреждения здравоохранения «Республиканский медицинский информационно-аналитический центр» заявку на регистрацию ИС в АЭМД по форме, приведенной в Приложение Г, содержащую:
- сведения об организации, эксплуатирующей ИС;
- сведения о подключаемой ИС.
Заявка в обязательном порядке подается в двух форматах – docx и pdf, при этом заявка в формате pdf должна содержать подпись и расшифровку подписи уполномоченного лица.
Информационная система для которой требуется подключение к АЭМД должна полностью соответствовать требованиям Технических условий по подключению к Государственной информационной системе «Электронное здравоохранение Республики Татарстан».
Сценарии взаимодействия с ИС
Регистрация и обмен сведениями об ЭМД между АЭМД и ИС выполняется с использованием интеграционных сервисов и производится согласно следующим сценариям:
- регистрация сведений об ЭМД;
- поиск записей в АЭМД;
- запрос регистрационных сведений об ЭМД в АЭМД;
- получение файла ЭМД запрашивающей ИС из АЭМД;
- получение метаописания ЭМД в АЭМД;
- отправка в ИС уведомления о регистрации ЭМД из другой ИС.
Получение ЭМД, хранящихся в электронных архивах ИС, а также отправка уведомлений о регистрации ЭМД из других ИС, выполняется с использованием интеграционных сервисов, реализованных на стороне ИС, требования к которым описаны в разделе «Описание веб-сервиса на стороне ИС».
Регистрация сведений об ЭМД
Сценарий описывает процедуру регистрации сведений об ЭМД в подсистеме АЭМД. Инициатором взаимодействия выступает ИС. Описание используемого метода сервиса АЭМД представлено в разделе 3.2.
Участники
- АЭМД;
- ИС.
Критерий успешности выполнения
Сведения об ЭМД успешно зарегистрированы в АЭМД.
Предварительные условия
- В ИС сформирован ЭМД, подлежащий регистрации в АЭМД, а также его метаописание и контент.
- Данные о медицинской организации, в которой был создан документ, присутствуют в ФРМО.
- Данные о медицинском работнике, подписавшем ЭМД, присутствуют в ФРМР.
Базовый сценарий
Рисунок 1 – Диаграмма регистрации сведений об ЭМД
Таблица 2 – Базовый сценарий регистрации сведений об ЭМД
Базовые шаги сценария |
|
Альтернативные шаги сценария | 2а. При обнаружении ошибок в запросе на регистрацию сведений об ЭМД в ответном сообщении передается информация о найденных ошибках. Сценарий завершен. |
Примечания:
- При первичной проверке производится только валидация синтаксической корректности запроса. Данная проверка выполняется синхронно.
- При регистрации сведений производится полная проверка предоставленных сведений:
- проверка сертификатов электронных подписей, которыми был подписан ЭМД, с помощью сертифицированных СКЗИ;
- проверка наличия сведений о медицинской организации в ФРМО;
- проверка наличия сведений о медицинских работниках в ФРМР.
Результаты регистрации направляются в ИС асинхронно с помощью сервиса, описанного в разделе 4.1.
Поиск записей в АЭМД
Сценарий описывает процедуру поиска записей в АЭМД по отдельным атрибутам метаописания документа. Данный сценарий предполагается к использованию для проверки факта регистрации в АЭМД при обновлении сроков хранения электронного медицинского документа в ИС. Описание используемого метода сервиса АЭМД представлено в разделе 3.3.
Участники
- АЭМД;
- ИС.
Критерий успешности выполнения
Найдены записи реестра, удовлетворяющие поисковым критериям.
Предварительные условия
- Сведения об ЭМД, удовлетворяющие поисковым критериям, зарегистрированы в АЭМД;
Базовый сценарий
Рисунок 2 – Диаграмма поиска записей реестра
Таблица 3 – Базовый сценарий поиска записей реестра
Базовые шаги сценария |
|
Альтернативные шаги сценария | 2а. При отсутствии записей, удовлетворяющих параметрам запроса, в ответном сообщении возвращается пустой результат поиска, не содержащий найденных записей. Сценарий завершен. |
Примечания:
- При передаче нескольких параметров поиска критерии объединяются с помощью логического оператора «И». То есть, в результатах поиска будут представлены записи, которые удовлетворяют всем параметрам исходного запроса.
- Если поисковым критериям удовлетворяет большое количество записей, то результаты поиска разбиваются на страницы по 10000 записей, и в качестве результата передаются данные первой страницы. Для получения остальных результатов поиска ИС может выполнить повторный запрос, передав в качестве параметра поиска порядковый номер страницы с результатами.
Запрос регистрационных сведений об ЭМД в АЭМД
Сценарий описывает процедуру запроса регистрационных сведений об ЭМД в АЭМД. Описание используемого метода сервиса АЭМД представлено в разделе 3.4.
Участники
- АЭМД;
- ИС.
Критерий успешности выполнения
Сведения о регистрации ЭМД найдены в АЭМД и переданы в ИС.
Предварительные условия
- Необходимая запись зарегистрирована в АЭМД и срок ее хранения не истек.
Базовый сценарий
Рисунок 3 – Диаграмма запроса регистрационных сведений
Таблица 4 – Базовый сценарий запроса регистрационных сведений
Базовые шаги сценария |
|
Альтернативные шаги сценария | 2а. При отсутствии запрашиваемой записи (такой записи не существовало, либо запись зарегистрирована не через АЭМД) в ответном сообщении возвращается отрицательный статус выполнения запроса с сообщением об отсутствии запрашиваемой информации. Сценарий завершен. |
Получение файла ЭМД запрашивающей ИС из АЭМД
Сценарий описывает процедуру получения файла ЭМД из АЭМД по запросу от запрашивающей ИС. Для запроса файла ЭМД из АЭМД необходимо сначала получить номер ЭМД, присвоенный ему в реестре. Получить номер записи в реестре можно с помощью поиска записей в реестре. Описание процесса поиска ЭМД в реестре представлено в разделе 2.2, описание используемого метода сервиса АЭМД представлено в разделе 3.3.
При получении запроса от запрашивающей ИС АЭМД необходимо передать документ запрашивающей системе. Описание используемого метода сервиса АЭМД представлено в разделе 3.5. Описание метода сервиса запрашивающей ИС, используемого для предоставления ответа, представлено в разделе 4.2.
Участники
- АЭМД;
- Запрашивающая ИС;
Критерий успешности выполнения
Запрашивающей ИС получен ЭМД из АЭМД.
Предварительные условия
- ЭМД зарегистрирован в АЭМД.
Базовый сценарий
Рисунок 5 – Диаграмма получения файла ЭМД запрашивающей ИС из АЭМД
Таблица 5 – Базовый сценарий получения файла ЭМД запрашивающей ИС из архива предоставляющей ИС
Базовые шаги сценария |
|
Альтернативные шаги сценария | 4а. При отсутствии в электронном архиве ИС запрашиваемой записи в ответном сообщении возвращается отрицательный статус выполнения запроса с сообщением об отсутствии запрашиваемой информации. Сценарий завершен. |
Получение метаописания ЭМД в АЭМД
Сценарий описывает процедуру получения метаданных ЭМД, зарегистрированных в АЭМД. Возможно как получение метаописания собственных документов, так и документов, зарегистрированных другими системами. Описание используемого метода сервиса АЭМД представлено в разделе 3.6.
Участники
- АЭМД;
- ИС.
Критерий успешности выполнения
Сведения об ЭМД найдены в АЭМД и переданы в ИС.
Предварительные условия
- ЭМД зарегистрирован в АЭМД.
Базовый сценарий
Рисунок 6 – Диаграмма получения метаописания ЭМД в АЭМД
Таблица 6 – Базовый сценарий получения файла ЭМД запрашивающей ИС из архива предоставляющей ИС
Базовые шаги сценария |
|
Альтернативные шаги сценария | 3а. При отсутствии в регистре ЭМД с переданным номером, АЭМД возвращает сообщение отсутствии запрошенного документа в реестре. Сценарий завершен. |
Отправка в ИС уведомления о регистрации ЭМД из другой ИС
Сценарий описывает процедуру получения ИС уведомления о регистрации в РЭМД сведений об ЭМД из других ИС. Описание используемого метода сервиса ИС представлено в разделе 4.3.
Участники
- РЭМД;
- АЭМД;
- ИС.
Критерий успешности выполнения
Уведомление доставлено в ИС.
Предварительные условия
- В РЭМД поступил запрос на регистрацию сведений об ЭМД/В РЭМД поступил запрос на создание связи между документами.
- В РЭМД администратором настроено правило отправки уведомлений в ИС.
Базовый сценарий
Рисунок 7 – Диаграмма отправки в ИС уведомления о регистрации ЭМД из другой ИС
Таблица 7 – Базовый сценарий получения файла ЭМД запрашивающей ИС из архива предоставляющей ИС
Базовые шаги сценария |
|
Альтернативные шаги сценария | 5а. При отсутствии необходимости уведомление не отправляется. Сценарий завершен. |
Примечания:
- Необходимость отправки уведомлений настраивается администратором РЭМД по решению ДИТ МЗ РФ. Настройка производится по следующим параметрам:
- ИС-источник инициирующего запроса;
- ИС-получатель уведомлений;
- Вид документов, о которых необходимо уведомлять.
- Инициирующим событием отправки уведомления может быть одно из событий:
- регистрация документа – ИС-получатель принимает уведомления о регистрации документов определенного вида из определенных ИС-источников;
- создание связи – ИС-получатель принимает уведомления о создании связи между ее документом и документом определенного вида из определенных ИС-источников.
Описание веб-сервиса обмена сведениями об ЭМД
Сервис обмена сведениями об ЭМД предназначен для передачи информации об ЭМД между ИС и подсистемой АЭМД. Методы сервиса обеспечивают: - регистрацию сведений об ЭМД, созданных в ИС;
- поиск информации об ЭМД (записи реестра) в АЭМД;
- запрос регистрационных сведений об ЭМД в АЭМД;
- запрос файла ЭМД запрашивающей ИС из АЭМД;
- запрос метаописания ЭМД в АЭМД.
Для взаимодействия с АЭМД используется SOAP 12, структура сервиса описана с использованием WSDL. Адреса для тестовой и промышленный среды предоставляет МИАЦ региона по запросу.
Список методов сервиса и их назначение приведены в таблице ниже (Таблица 8).
Таблица 8 – Список методов сервиса
Метод | Назначение |
Код: registerDocument | Предназначен для регистрации сведений об ЭМД в АЭМД |
Код: searchRegistryItem | Предназначен для поиска записи реестра по метаописанию ЭМД |
Код: getRegistryItem | Предназначен для получения сведений о регистрации ЭМД |
Код: demandContent | Предназначен для получения файла ЭМД из АЭМД |
Код: getMetadata | Предназначен для получения метаописания ЭМД, зарегистрированного в АЭМД |
В АЭМД предусмотрена проверка уникальности идентификатора документа в рамках всей подсистемы. Поэтому зарегистрировать несколько документов под одним и тем же идентификатором невозможно.
Генерация идентификаторов должна производиться согласно стандарту UUID (Universally Unique Identifier, RFC 4122). UUID — статистически уникальный 128-битный идентификатор. UUID представляет собой 16-байтный (128-битный) номер. Формат строки: [a-fA-F0-9]{8}[a-fA-F0-9]{4}[a-fA-F0-9]{4}[a-fA-F0-9]{4}[a-fA-F0-9]{12}. Пример UUID: 550e8400-e29b-41d4-a716-446655440000. Рекомендации к генерации UUID также указаны в стандартах ITU-T Rec. X.667 и ISO/IEC 9834-8.
Для остальных передаваемых идентификаторов использование UUID является предпочтительным, но допускается использование идентификаторов других видов.
Описание транспортного заголовка АЭМД
Помимо самого тела запроса, каждое сообщение к сервису АЭМД должно содержать транспортный заголовок, сформированный по требованиям ИПС, описанным в разделе 3.4 документа «Методические материалы по подключению к Сервису ИПС» [2].
Также есть возможность передачи в сообщениях транспортного заголовка АЭМД. В транспортном заголовке АЭМД указывается идентификатор МО, от имени которой выполняется запрос к сервису АЭМД, а также код режима отладки.
Таким образом доступ к документам, предоставленный пациентом, учитывается при указании идентификатора МО в транспортном заголовке АЭМД при следующих сценариях:
- поиск записей регистра, зарегистрированных другими ИС (см. раздел 2.2);
- получение файла ЭМД запрашивающей ИС из АЭМД (см. раздел 2.4);
- получение метаописания ЭМД, зарегистрированного другой ИС (см. раздел 2.5).
Медицинская организация, указанная в транспортном заголовке АЭМД, должна быть подключена к ИС в АЭМД.
Если в транспортном заголовке АЭМД указан атрибут с кодом отладки, то допускается передача в запросе на регистрацию сведений об ЭМД (см. раздел 2.1) подписей, сформированных не квалифицированными сертификатами ЭП. В этом случае для всех сертификатов не производится построение цепочек сертификации до головного удостоверяющего центра. Таким образом допускается использование сертификатов, выданных не аккредитованными и тестовыми удостоверяющими центрами. Режим отладки допускается только в тестовой среде АЭМД.
Описание транспортного заголовка АЭМД представлено в таблице ниже (Таблица 9).
Таблица 9 – Описание транспортного заголовка АЭМД
Код параметра | Описание параметра | Обязательность | Тип | Комментарий | |
---|---|---|---|---|---|
Тип: emdrTransportHeader | |||||
medOrgOid | Медицинская организация | - | xs:string | Указывается OID МО согласно ФРМО. | |
trialMode | Режим отладки | - | tns:trialMode | Составной тип. | |
Тип: trialMode | |||||
option | Опция отладки | - | tns:trialOption | Код режима отладки.
|
Метод «registerDocument»
Метод «registerDocument» используется для регистрации сведений об ЭМД. ИС передает набор данных для регистрации, в ответном сообщении АЭМД возвращает извещение о результатах обработки запроса. Результаты регистрации передаются на адрес сервиса обратного вызова ИС, требования к которому описаны в разделе 4 «Описание веб-сервиса на стороне ИС».
Общие сведения о методе и описание входных и выходных данных метода приведено в таблицах ниже.
Таблица 10 – Общие сведения о методе
Код операции: | registerDocument |
Наименование операции: | Регистрация сведений об ЭМД |
Таблица 11 − Входные параметры метода registerDocument (registerDocumentRequest)
Код параметра | Описание параметра | Обязательность | Тип | Комментарий | ||
---|---|---|---|---|---|---|
messageId | Идентификатор запроса | + | xs:string | Будет передан в запросе к callback-сервису ИС | ||
localUid | Уникальный идентификатор документа | + | tns:uuid | Предоставляется в формате UUID. | ||
kind | Вид документа | + | xs:string | OID вида документа. ![]() ) | ||
system | Уникальный идентификатор ИС | + | xs:string | Присваивается ИС при регистрации в АЭМД и передается при информационном взаимодействии | ||
organization | Медицинская организация | + | xs:string | Указывается OID МО согласно ФРМО. | ||
department | Подразделение | + | tns:department | Составной тип. | ||
documentNumber | Номер документа | + | xs:string | Регистрационный номер документа внутри организации или подразделения | ||
creationDate | Дата создания документа | - | xs:date | Дата создания документа внутри организации или ее подразделения | ||
creationDateTime | Дата и время создания документа | + | xs:timestamp | Дата и время создания документа внутри организации или ее подразделения | ||
patient | Пациент | - | tns:patient | Составной тип. | ||
docContent | Контент документа | + | tns:docContent | Контент документа | ||
assistance | Дополнительные сведения об ЭМД | - | tns:assistance | Составной тип. | ||
orgSignature | Файл подписи МО | - | tns:binaryData | Составной тип. | ||
recipient | Сведения о выдаче документа | - | tns:documentRecipient | Составной тип. | ||
description | Описание документа | + | xs:string | Краткое произвольное описание документа. Порядок заполнения значения см. в разделе 6.6 текущего документа. | ||
personalSignature | Сведения о подписях | - | tns:personalSignature | Составной тип. | ||
pluggableAttributes | Дополнительные атрибуты | - | xs:base64Binary | Дополнительные атрибуты документа, передаются в виде XML в base64. Структура XML формируется согласно установленной XSD-схеме для передаваемого вида документа | ||
associations | Связи документа | - | tns:association | Составной тип. | ||
replace | Заменяемый документ | - | tns:documentIdentifier | Составной тип. | ||
Тип: department | ||||||
localId | Идентификатор подразделения | + | xs:string | OID подразделения организации согласно сведениям ФРМО. | ||
name | Наименование подразделения | + | xs:string | Наименование подразделения организации согласно сведениям ФРМО | ||
Тип: patient | ||||||
surname | Фамилия пациента | + | xs:string | |||
name | Имя пациента | + | xs:string | |||
patrName | Отчество пациента | - | xs:string | Передается при наличии | ||
birthDate | Дата рождения пациента | + | xs:date | |||
gender | Пол пациента | + | xs:string | Код пола по справочнику «Пол пациента», OID 1.2.643.5.1.13.13.11.1040 ( https://nsi.rosminzdrav.ru/#!/refbook/1.2.643.5.1.13.13.11.1040![]() ) | ||
localId | Идентификатор пациента | + | xs:string | Уникальный идентификатор пациента в ИС | ||
snils | СНИЛС | - | tns:snils | Простой тип. | ||
enp | ЕНП | - | tns:enp | Простой тип. | ||
otherId | ДУЛ | - | tns:patientOtherId | Составной тип. Сведения о документе, удостоверяющем личность, пациента | ||
Тип: docContent | ||||||
data | Контент документа | + | xs:base64Binary | Контент документа | ||
checksum | Контрольная сумма | + | xs:long | Контрольная сумма | ||
Тип: patientOtherId | ||||||
type | Тип документа | + | xs:string | Уникальный идентификатор вида ДУЛ по справочнику «Классификатор документов, удостоверяющих личность гражданина Российской Федерации», OID 1.2.643.5.1.13.2.1.1.498 ![]() ) | ||
number | Номер документа | + | xs:string | Номер документа | ||
Тип: assistance | ||||||
renderedServices | Оказанные услуги | - | tns:renderedServices | Составной тип. | ||
Тип: renderedServices | ||||||
renderedService | Оказанная услуга | + | tns: renderedService | Составной тип. | ||
Тип: renderedService | ||||||
code | Код услуги | + | xs:string | Код услуги по справочнику «Номенклатура медицинских услуг», OID 1.2.643.5.1.13.13.11.1070 ![]() ) | ||
renderedDate | Дата оказания | + | xs:date | Дата оказания услуги | ||
Тип: association | ||||||
target | Связанный документ | + | tns:notEmptyString | Номер связанной записи реестра (регистровый номер) | ||
type | Тип связи | + | tns:associationType | Указывается код типа связи согласно справочнику «РЭМД. Типы связей электронных медицинских документов», OID 1.2.643.5.1.13.13.99.2.122 ![]() ) | ||
Тип: binaryData | ||||||
data | Данные | + | xs:base64Binary | Данные в base64 | ||
checksum | Контрольная сумма | + | xs:long | Контрольная сумма файла, вычисленная по алгоритму CRC-32-IEEE 802.3 (в десятичном представлении). | ||
Тип: recipient | ||||||
kind | Тип адресата | + | tns:recipientKind | Указывается код типа получателя согласно справочнику «РЭМД. Типы получателей медицинских документов», OID 1.2.643.5.1.13.13.99.2.123 ![]() ) | ||
recipientKindPerson | Физическое лицо | - | tns:recipientKindPerson | Указывается, если получателем документа является физическое лицо | ||
recipientKindMedicalOrganization | Медицинская организация | - | tns:recipientKindMedicalOrganization | Указывается, если получателем является медицинская организация | ||
recipientKindOrganization | Немедицинская организация | - | tns:recipientKindOrganization | Указывается, если получателем является немедицинская организация | ||
Тип: recipientKindPerson | ||||||
snils | СНИЛС получателя | + | tns:snils | Простой тип. | ||
Тип: recipientKindMedicalOrganization | ||||||
organization | OID Медицинской организации | + | tns:organization | Указывается OID МО согласно ФРМО. Заполняется по справочнику «Регистр медицинских организаций Российской Федерации. Версия 2», OID 1.2.643.5.1.13.13.11.1461 | ||
Тип: recipientKindOrganization | ||||||
ogrn | ОГРН | + | tns:ogrn | ОГРН организации. | ||
kpp | КПП | + | tns:kpp | КПП организации. | ||
Тип: personalSignature | ||||||
signer | Подписавший сотрудник | + | tns:signer | Составной тип. | ||
signature | Файл подписи | + | tns:binaryData | Предоставляется в виде двоичных данных | ||
description | Описание подписи | - | xs:string | Краткое произвольное описание подписи | ||
Тип: signer | ||||||
localId | Идентификатор сотрудника | - | xs:string | Уникальный идентификатор сотрудника в ИС. | ||
role | Роль сотрудника при подписи | + | xs:string | Указывается код роли по справочнику 1.2.643.5.1.13.2.1.1.734 (Справочник ролей сотрудников при подписи электронных медицинских документов) | ||
surname | Фамилия сотрудника | + | xs:string | Ограничивается длиной в 100 символов | ||
name | Имя сотрудника | + | xs:string | Ограничивается длиной в 100 символов | ||
patrName | Отчество сотрудника | - | xs:string | Заполняется при наличии. | ||
birthDate | Дата рождения сотрудника | - | xs:date | |||
snils | СНИЛС сотрудника | + | tns:snils | Простой тип. | ||
position | Должность сотрудника | + | xs:string | Указывается должность по справочнику 1.2.643.5.1.13.13.99.2.181 (ФРМР. Должности медицинского персонала) | ||
speciality | Специальность сотрудника | - | xs:string | Указывается специальность по справочнику 1.2.643.5.1.13.13.11.1066 (Номенклатура специальностей специалистов со средним, высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения) | ||
Адрес электронной почты | - | xs:string | Ограничивается длиной в 100 символов | |||
phone | Телефон сотрудника | - | tns:phoneNumber | Передается без разделителей и кода страны. | ||
Тип: documentIdentifier | ||||||
root | Заменяемый документ | + | xs:string | Передается регистровый номер (без постфикса версии) документа, для которого создается новая версия | ||
version | Заменяемая версия документа | - | xs:int | Передается номер актуальной версии документа, для которого создается новая версия. |
Таблица 12 – Выходные параметры метода registerDocument (acknowledgment)
Код параметра | Описание параметра | Обязательность | Тип | Комментарий | |
---|---|---|---|---|---|
status | Статус | + | tns:responseStatus | Статус обработки операции:
| |
errors | Список ошибок | - | tns:errors | Составной тип. | |
Тип: errors | |||||
item | Элемент | + | tns:error | Составной тип. |
Метод «searchRegistryItem»
Метод «searchRegistryItem» используется для поиска записей в реестре сведений об ЭМД. ИС передает набор поисковых параметров, в ответном сообщении АЭМД возвращает список записей, удовлетворяющих критериям запроса. Для поиска может быть указано несколько параметров, в таком случае в результатах будут переданы записи, которые удовлетворяют всем критериям поиска. Доступ к записям разграничен, каждая ИС может производить поиск только тех записей, которые зарегистрированы этой ИС. Поиск производится по актуальным версиям документов.
Общие сведения о методе и описание входных и выходных данных метода приведено в таблицах ниже.
Таблица 13 – Общие сведения о методе
Код операции: | searchRegistryItem |
Наименование операции: | Поиск записи в реестре |
Таблица 14 − Входные параметры метода searchRegistryItem (searchRegistryItemRequest)
Код параметра | Описание параметра | Обязательность | Тип | Комментарий |
---|---|---|---|---|
organization | Медицинская организация | - | xs:string | Указывается OID МО согласно ФНСИ. |
localUid | Уникальный идентификатор документа | - | tns:uuid | Предоставляется в формате UUID. |
kind | Вид документа | - | xs:string | Указывается OID вида документа. |
documentNumber | Номер документа | - | xs:string | Регистрационный номер ЭМД внутри организации или подразделения |
creationDateBegin | Дата и время начала периода создания документа | - | xs:timestamptz | Дата и время начала периода регистрации ЭМД внутри организации или ее подразделения |
creationDateEnd | Дата и время окончания периода создания документа | - | xs:timestamptz | Дата и время окончания периода регистрации ЭМД внутри организации или ее подразделения |
registerDateBegin | Дата и время начала периода регистрации документа | - | xs:timestamptz | Дата и время начала периода регистрации ЭМД в РЭМД |
registerDateEnd | Дата и время окончания периода регистрации документа | - | xs:timestamptz | Дата и время окончания периода регистрации ЭМД в РЭМД |
patientId | Идентификатор пациента | - | xs:string | Уникальный идентификатор пациента в ИС |
patientSnils | СНИЛС пациента | - | tns:snils | Передается без разделителей. |
page | Страница | - | xs:int | Номер запрашиваемой страницы результатов. Нумерация производится с нуля |
Таблица 15 – Выходные параметры метода searchRegistryItem (searchRegistryItemResponse)
Код параметра | Описание параметра | Обязательность | Тип | Комментарий |
---|---|---|---|---|
status | Статус | + | tns:responseStatus | Статус обработки операции:
|
matches | Результаты поиска | - | tns:searchMatches | Список результатов при успешном поиске |
errors | Список ошибок | - | tns:errors | Ошибки в случае статуса ответа «error» |
item | Элемент списка записей реестра | - | tns:searchMatch | Составной тип. |
page | Страницы | + | tns:matchesPage | Составной тип |
Тип: searchMatch | ||||
emdrId | Номер в реестре | + | xs:string | Уникальный номер, присвоенный сведениям об ЭМД в реестре |
documentVersion | Номер версии | - | xs:int | Номер актуальной версии документа. |
localUid | Уникальный идентификатор документа | + | tns:uuid | Уникальный идентификатор документа, переданный ИС при регистрации. |
registrationDate | Дата регистрации | + | xs:dateTime | Дата создания записи в реестре. |
registrationDateTime | Дата регистрации | + | xs:dateTime | Дата и время создания записи в реестре |
storeTillDate | Срок хранения | + | xs:date | Срок хранения сведений, установленный в соответствии с политиками хранения данного вида ЭМД. |
Тип: matchesPage | ||||
itemsPerPage | Размер страницы записей | + | xs:int | Указывает на максимально возможное число записей на странице (а не актуальное) |
hasNext | Наличие следующей страницы | + | xs:boolean | Указывает на то, есть ли еще страницы |
Тип: errors | ||||
item | Элемент | + | tns:error | Составной тип. |
Тип: error | ||||
code | Код ошибки | + | xs:string | |
message | Описание ошибки | - | xs:string |
Метод «getRegistryItem»
Метод «getRegistryItem» позволяет запросить сведения о регистрации по номеру записи в реестре. Доступ к записям разграничен, каждая ИС может получить сведения о только записях, зарегистрированных этой ИС. В ответе возвращаются сведения по актуальной версии документа.
Общие сведения о методе и описание входных и выходных данных метода приведено в таблицах ниже.
Таблица 16 – Общие сведения о методе
Код операции: | getRegistryItem |
Наименование операции: | Запрос регистрационных сведений об ЭМД |
Таблица 17 − Входные параметры метода getRegistryItem (getRegistryItemRequest)
Код параметра | Описание параметра | Обязательность | Тип | Комментарий |
---|---|---|---|---|
emdrId | Номер в реестре | + | xs:string | Уникальный номер, присвоенный сведениям об ЭМД в реестре (без постфикса версии) |
Таблица 18 – Выходные параметры метода getRegistryItem (getRegistryItemResponse)
Код параметра | Описание параметра | Обязательность | Тип | Комментарий |
---|---|---|---|---|
status | Статус | + | tns:responseStatus | Статус обработки операции:
|
registryItem | Запись реестра | - | tns:registryItem | |
errors | Список ошибок | - | tns:errors | Ошибки в случае статуса ответа "error" |
Тип: registryItem | ||||
emdrId | Номер в реестре | + | xs:string | Уникальный номер, присвоенный сведениям об ЭМД в реестре |
registrationDate | Дата регистрации | + | xs:dateTime | Дата и время создания записи в реестр. |
registrationDateTime | Дата и время регистрации документа | + | xs:dateTime | Дата и время создания записи в реестр |
storeTillDate | Срок хранения | + | xs:date | Срок хранения сведений, установленный в соответствии с политиками хранения данного вида ЭМД. |
registrationWarnings | Список замечаний | - | tns: registrationWarnings | Список замечаний, выявленных на этапе проверки сведений об ЭМД при регистрации |
Тип: registrationWarnings | ||||
item | Элемент списка замечаний | - | tns:registrationWarning | |
Тип: registrationWarning | ||||
code | Код замечания | + | xs:string | |
message | Описание замечания | - | xs:string | |
Тип: errors | ||||
item | Элемент | + | tns:error | Составной тип. |
Тип: error | ||||
code | Код ошибки | + | xs:string | |
message | Описание ошибки | - | xs:string |
Метод «demandContent»
Метод «demandContent» используется для запроса файла ЭМД, зарегистрированного АЭМД. ИС передает номер документа в реестре, в ответном сообщении АЭМД возвращает ЭМД. Полученный файл передается на адрес сервиса обратного вызова ИС, требования к которому описаны в разделе Описание веб-сервиса на стороне ИС. В асинхронном ответе передается актуальная версия документа.
Общие сведения о методе и описание входных и выходных данных метода приведено в таблицах ниже.
Таблица 19 – Общие сведения о методе
Код операции: | demandContent |
Наименование операции: | Запрос файла ЭМД из АЭМД |
Таблица 20 − Входные параметры метода demandContent (demandContentRequest)
Код параметра | Описание параметра | Обязательность | Тип | Комментарий |
---|---|---|---|---|
messageId | Идентификатор запроса | + | xs:string | Будет передан в запросе к callback-сервису ИС |
emdrId | Идентификатор документа в регистре | + | tns:notEmptyString | Идентификатор запрашиваемого документа в АЭМД (без постфикса версии) |
grantingEmdrId | Основание доступа | - | tns:notEmptyString | Идентификатор документа, к которому ИС имеет доступ, связанного с запрашиваемым. |
Таблица 21 – Выходные параметры метода demandContent (acknowledgment)
Код параметра | Описание параметра | Обязательность | Тип | Комментарий | |
---|---|---|---|---|---|
status | Статус | + | tns:responseStatus | Статус обработки операции:
| |
errors | Список ошибок | - | tns:errors | Составной тип. | |
Тип: errors | |||||
item | Элемент | + | tns:error | Составной тип. |
Метод «getMetadata»
Метод «getMetadata» позволяет запросить метаописание ЭМД, зарегистрированного в АЭМД, по номеру записи в реестре. В ответе возвращается метаописание актуальной версии документа.
Общие сведения о методе и описание входных и выходных данных метода приведено в таблицах ниже.
Таблица 22 – Общие сведения о методе
Код операции: | getMetadata |
Наименование операции: | Запрос метаописания ЭМД |
Таблица 23 − Входные параметры метода getMetadata (getMetadataRequest)
Код параметра | Описание параметра | Обязательность | Тип | Комментарий |
---|---|---|---|---|
emdrId | Номер в реестре | + | xs:string | Уникальный номер, присвоенный сведениям об ЭМД в реестре (без постфикса версии) |
grantingEmdrId | Основание доступа | - | tns:notEmptyString | Идентификатор документа, к которому ИС имеет доступ, связанного с запрашиваемым. |
Таблица 24 – Выходные параметры метода getMetadata (getMetadataResponse)
Код параметра | Описание параметра | Обязательность | Тип | Комментарий |
---|---|---|---|---|
status | Статус ответа | + | tns:responseStatus | Статус ответа на запрос |
metadata | Метаописание ЭМД | - | tns:metadata | Составной тип. |
errors | Ошибки сервиса | - | tns:errors | Ошибки в случае статуса ответа "error" |
Тип: metadata | ||||
documentVersion | Номер версии | - | xs:int | Номер актуальной версии документа. |
kind | Вид документа | + | xs:string | OID вида документа согласно справочнику «Регистрируемые электронные медицинские документы», OID 1.2.643.5.1.13.13.11.1520 |
systemName | Наименование ИС | + | xs:string | Наименование ИС, зарегистрировавшей документ |
region | Код региона | + | xs:string | Код региона организации, зарегистрировавшей документ |
organization | Медицинская организация | + | xs:string | OID МО, зарегистрировавшей документ согласно ФРМО. (справочник «Регистр медицинских организаций Российской Федерации. Версия 2», OID 1.2.643.5.1.13.13.11.1461) |
department | Подразделение | + | tns:department | Составной тип. |
documentNumber | Номер документа | + | xs:string | Регистрационный номер документа внутри организации или подразделения |
creationDate | Дата создания документа | + | xs:date | Дата создания документа внутри организации или ее подразделения. |
creationDateTime | Дата и время создания документа | + | xs:dateTime | Дата и время создания документа внутри организации или ее подразделения |
storeTillDate | Срок хранения | - | xs:date | Актуальный срок хранения записи реестра |
registrationDate | Дата регистрации | + | xs:dateTime | Дата создания записи в реестре. |
registrationDateTime | Дата и время регистрации документа | + | xs:dateTime | Дата и время создания записи в реестре |
patientSnils | СНИЛС пациента | - | tns:snils | Простой тип. |
patientLocalId | Идентификатор пациента | - | xs:string | Уникальный идентификатор пациента в ИС. |
assistance | Дополнительные сведения об ЭМД | - | tns:assistance | Составной тип. |
description | Описание документа | + | xs:string | Краткое описание документа. |
signer | Подписавший сотрудник | + | tns:signer | Составной тип. |
contentType | Формат файла | + | tns:signer | Идентификатор формата файла по справочнику «РЭМД. Форматы файлов электронных медицинских документов», OID 1.2.643.5.1.13.13.99.2.40 |
pluggableAttributes | Дополнительные атрибуты | - | xs:base64Binary | Дополнительные атрибуты документа, передаются в виде XML в base64. Структура XML формируется согласно установленной XSD-схеме для передаваемого вида документа |
associations | Связи документа | - | tns:association | Составной тип. |
recipient | Сведения о выдаче документа | - | tns:documentRecipient | Составной тип. |
Тип: department | ||||
localId | Идентификатор подразделения | + | xs:string | OID подразделения организации согласно сведениям ФРМО. |
name | Наименование подразделения | + | xs:string | Наименование подразделения организации согласно сведениям ФРМО |
Тип: assistance | ||||
renderedServices | Оказанные услуги | - | tns:renderedServices | Составной тип. |
Тип: renderedServices | ||||
renderedService | Оказанная услуга | + | tns:renderedService | Составной тип. |
Тип: renderedService | ||||
code | Код услуги | + | xs:string | Код услуги по справочнику «Номенклатура медицинских услуг», OID 1.2.643.5.1.13.13.11.1070 |
renderedDate | Дата оказания | + | xs:date | Дата оказания услуги |
Тип: recipient | ||||
kind | Тип адресата | + | tns:recipientKind | Указывается код типа получателя согласно справочнику «РЭМД. Типы получателей медицинских документов», OID 1.2.643.5.1.13.13.99.2.123 ![]() ) |
recipientKindPerson | Физическое лицо | - | tns:recipientKindPerson | Указывается, если получателем документа является физическое лицо |
recipientKindMedicalOrganization | Медицинская организация | - | tns:recipientKindMedicalOrganization | Указывается, если получателем является медицинская организация |
recipientKindOrganization | Немедицинская организация | - | tns:recipientKindOrganization | Указывается, если получателем является немедицинская организация |
Тип: recipientKindPerson | ||||
snils | СНИЛС получателя | + | tns:snils | Простой тип. |
Тип: recipientKindMedicalOrganization | ||||
organization | OID Медицинской организации | + | tns:organization | Указывается OID МО согласно ФРМО. Заполняется по справочнику «Регистр медицинских организаций Российской Федерации. Версия 2», OID 1.2.643.5.1.13.13.11.1461 |
Тип: recipientKindOrganization | ||||
ogrn | ОГРН | + | tns:ogrn | ОГРН организации. |
kpp | КПП | + | tns:kpp | КПП организации. |
Тип: association | ||||
target | Связанный документ | + | tns:notEmptyString | Номер связанной записи реестра (регистровый номер) |
type | Тип связи | + | tns:associationType | Определяет тип связи с записью, указанной в target. ![]() ) |
Тип: signer | ||||
role | Роль сотрудника при подписи | + | xs:string | Код роли по справочнику «Справочник ролей сотрудников при подписи электронных медицинских документов», OID 1.2.643.5.1.13.2.1.1.734 |
surname | Фамилия сотрудника | + | xs:string | Ограничивается длиной в 100 символов |
name | Имя сотрудника | + | xs:string | Ограничивается длиной в 100 символов |
patrName | Отчество сотрудника | - | xs:string | Ограничивается длиной в 100 символов |
snils | СНИЛС сотрудника | + | tns:snils | Простой тип. |
position | Должность сотрудника | + | xs:string | Идентификатор должность по справочнику «ФРМР. Должности медицинского персонала», OID 1.2.643.5.1.13.13.99.2.181 |
speciality | Специальность сотрудника | - | xs:string | Идентификатор специальности по справочнику «Номенклатура специальностей специалистов со средним, высшим и послевузовским медицинским и фармацевтическим образованием в сфере здравоохранения», OID 1.2.643.5.1.13.13.11.1066 |
Описание веб-сервиса на стороне ИС
На стороне ИС должен быть разработан сервис, обеспечивающий взаимодействие ИС с сервис-клиентом АЭМД. Сервис должен включать методы, обеспечивающие:
- прием результатов регистрации сведений об ЭМД из АЭМД;
- прием ЭМД, полученного из АЭМД;
- прием уведомлений о регистрации сведений об ЭМД в АЭМД.
Общие сведения о сервисе представлены в таблице ниже.
Таблица 25 – Общие сведения о сервисе ИС
Наименование: | Сервис обратного вызова для асинхронной веб-службы «Обмен сведениями об ЭМД» |
Назначение: | Передача результатов регистрации сведений об ЭМД из АЭМД в ИС; передача ЭМД, полученного из АЭМД; получение уведомлений об регистрации ЭМД в АЭМД |
Список методов сервиса и их назначение приведены в таблице ниже.
Таблица 26 – Список методов сервиса ИС
Метод | Назначение |
Код: sendRegisterDocumentResult | Предназначен для получения ИС результатов регистрации сведений об ЭМД |
Код: sendDocumentFile | Предназначен для получения ИС ЭМД, запрошенного из АЭМД |
Код: sendNotice | Предназначен для получения ИС уведомлений о регистрации сведений об ЭМД из других ИС |
h2.Метод «sendRegisterDocumentResult»
Метод «sendRegisterDocumentResult» используется для асинхронной передачи результатов регистрации сведений об ЭМД.
Полученные из АЭМД сведения о регистрации ЭМД должны хранится в ИС на всем протяжении срока хранения электронного медицинского документа. При изменении срока хранения сведений об ЭМД через СТП ЕГИСЗ или изменении нормативных сроков хранения сведений ИС должна обновлять сроки хранения ЭМД в своем хранилище в соответствии со сроками хранения, установленными в РЭМД. Для получения актуальных сроков хранения сведений об ЭМД могут быть использованы сервисы поиска записей реестра и получения регистрационных сведений, реализованные на стороне АЭМД (см. разделы 3.3 и 3.4).
Описание входных и выходных данных метода приведено в таблицах ниже.
Таблица 27 – Общие сведения
Код операции: | sendRegisterDocumentResult |
Наименование операции: | Отправка результата регистрации сведений об ЭМД |
Назначение операции: | Предназначен для получения ИС результатов регистрации сведений об ЭМД |
Таблица 28 – Входные данные: registerDocumentResult
Код параметра | Описание параметра | Обязательность | Тип | Комментарий | |
---|---|---|---|---|---|
relatesToMessage | Идентификатор запроса | + | xs:string | Идентификатор запроса на регистрацию ЭМД, полученный АЭМД от ИС | |
status | Статус регистрации | + | tns:responseStatus | Статус регистрации:
| |
registryItem | Запись реестра | - | tns:registryItem | Составной тип. | |
errors | Список ошибок | - | tns:errors | Перечень выявленных ошибок в случае отказа в регистрации сведений | |
Тип: registryItem | |||||
emdrId | Номер в реестре | + | xs:string | Уникальный номер, присвоенный сведениям об ЭМД в реестре. | |
documentVersion | Номер версии | - | xs:int | Номер версии документа в регистре. | |
registrationDate | Дата регистрации | + | xs:dateTime | Дата и время создания записи в реестр. | |
registrationDateTime | Дата и время регистрации документа | + | xs:dateTime | Дата и время создания записи в реестр | |
storeTillDate | Срок хранения | + | xs:date | Срок хранения сведений, установленный в соответствии с политиками хранения данного вида ЭМД. | |
registrationWarnings | Список замечаний | - | tns:registrationWarnings | Список замечаний, выявленных на этапе проверки сведений об ЭМД при регистрации | |
Тип: registrationWarnings | |||||
item | Элемент списка замечаний | + | tns:registrationWarning | Составной тип. | |
Тип: registrationWarning | |||||
code | Код замечания | + | xs:string | ||
message | Описание замечания | - | xs:string | ||
Тип: errors | |||||
item | Элемент | + | tns:error | Составной тип. | |
Тип: error | |||||
code | Код ошибки | + | xs:string | ||
message | Описание ошибки | - | xs:string |
Таблица 29 – Выходные данные: callbackResponse
Код параметра | Описание параметра | Обязательность | Тип | Комментарий |
---|---|---|---|---|
status | Статус | + | tns:responseStatus | Статус обработки операции:
|
errors | Список ошибок | - | tns:errors | Составной тип. |
Тип: errors | ||||
item | Элемент | + | tns:error | Составной тип. |
Тип: error | ||||
code | Код ошибки | + | xs:string | |
message | Описание ошибки | - | xs:string |
Метод «sendDocumentFile»
Метод «sendDocumentFile» используется для асинхронной передачи ЭМД, запрошенного из АЭМД. Передается всегда актуальная версия документа.
Описание входных и выходных данных метода приведено в таблицах ниже.
Таблица 30 – Общие сведения
Код операции: | sendDocumentFile |
Наименование операции: | Отправка ЭМД |
Назначение операции: | Предназначен для отправки ЭМД, запрошенного из АЭМД |
Таблица 31 – Входные данные: sendDocumentFileRequest
Код параметра | Описание параметра | Обязательность | Тип | Комментарий | |
---|---|---|---|---|---|
relatesToMessage | Идентификатор исходного запроса | + | xs:string | Идентификатор исходного запроса ИС, на который предоставляется асинхронный ответ (messageId из запроса getRegistryDocumentFileRequest) | |
status | Статус регистрации | + | tns:responseStatus | Статус предоставления ЭМД:
| |
file | Файл ЭМД | - | tns:binaryData | Составной тип. | |
errors | Список ошибок | - | tns:errors | Составной тип. | |
Тип: errors | |||||
item | Элемент | + | tns:error | Составной тип. | |
Тип: error | |||||
code | Код ошибки | + | xs:string | ||
message | Описание ошибки | - | xs:string | ||
Тип: binaryData | |||||
data | Данные | + | xs:base64Binary | Данные в base64 | |
checksum | Контрольная сумма | + | xs:long | Контрольная сумма файла, вычисленная по алгоритму CRC-32-IEEE 802.3 (в десятичном представлении) |
Таблица 32 – Выходные данные: callbackResponse
Код параметра | Описание параметра | Обязательность | Тип | Комментарий |
---|---|---|---|---|
status | Статус | + | tns:responseStatus | Статус обработки операции:
|
errors | Список ошибок | - | tns:errors | Составной тип. |
Тип: errors | ||||
item | Элемент | + | tns:error | Составной тип. |
Тип: error | ||||
code | Код ошибки | + | xs:string | |
message | Описание ошибки | - | xs:string |
Метод «sendNotice»
Метод «sendNotice» используется для уведомления ИС о регистрации в РЭМД сведений об ЭМД из других ИС, а также о создании другими ИС связей с документами ИС.
Описание входных и выходных данных метода приведено в таблицах ниже.
Таблица 33 – Общие сведения
Код операции: | sendNotice |
Наименование операции: | Отправка уведомления |
Назначение операции: | Предназначен для отправки уведомлений в ИС |
Таблица 34 – Входные данные: sendNoticeRequest
Код параметра | Описание параметра | Обязательность | Тип | Комментарий | |
---|---|---|---|---|---|
initiatingOrg | Организация, которая выполнила действие | + | xs:string | OID организации, которая зарегистрировала документ или создала связь, по справочнику «Регистр медицинских организаций Российской Федерации. Версия 2», OID 1.2.643.5.1.13.13.11.1461 | |
document | Зарегистрированный документ | + | tns:document | Составной тип.
| |
isNewDoc | Признак регистрации нового документа | - | xs:boolean | Значения:
| |
association | Связанные документы | - | tns:association | Составной тип. | |
Тип: document | |||||
docKind | Вид документа | + | xs:string | OID вида документов согласно справочнику «Регистрируемые электронные медицинские документы», OID 1.2.643.5.1.13.13.11.1520 | |
emdrId | Регистровый номер документа | + | xs:string | Номер документа в реестре | |
version | Версия документа | - | xs:int | Версия зарегистрированного документа. Передается только при уведомлении о регистрации и только если версий ЭМД больше одной | |
Тип: association | |||||
target | Регистровый номер документа | + | xs:string | Номер документа в реестре | |
type | Тип связи | + | tns:associationType | Определяет тип связи с записью, указанной в target. ![]() ) |
Таблица 35 – Выходные данные: callbackResponse
Код параметра | Описание параметра | Обязательность | Тип | Комментарий |
---|---|---|---|---|
status | Статус | + | tns:responseStatus | Статус обработки операции:
|
errors | Список ошибок | - | tns:errors | Составной тип. |
Тип: errors | ||||
item | Элемент | + | tns:error | Составной тип. |
Тип: error | ||||
code | Код ошибки | + | xs:string | |
message | Описание ошибки | - | xs:string |
Требования к формату файла документа в электронном виде
Перечень допустимых форматов файлов документов в электронном виде, регистрируемых в РЭМД, представлен согласно актуальной версии справочника «РЭМД. Форматы файлов электронных медицинских документов», OID 1.2.643.5.1.13.13.99.2.40.
Формат файла документа должен быть допустимым для регистрируемого вида документа согласно актуальной версии справочника «Регистрируемые электронные медицинские документы», OID 1.2.643.5.1.13.13.11.1520.
Формат файла документа PDF/A-1
Файл документа в электронном виде может иметь формат PDF/A-1, соответствующий международному стандарту ISO 19005-1:2005 «Управление документацией. Формат файлов электронных документов для долгосрочного сохранения. Часть 1: Использование формата PDF 1.4 (PDF/A-1)» – Document management - Electronic document file format for long-term preservation - Part 1: Use of PDF 1.4 (PDF/A-1) [3].
Текстовая часть должна включаться в документ формата PDF/A-1 в виде текстовых данных. Вставка текста в документ в виде изображения не допускается.
Формат файла документа XML
Файл документа в электронном виде может иметь формат XML. Структура регистрируемых документов должна соответствовать международному стандарту ISO/HL7 27932:2009 «Обмен данными - Архитектура клинических документов HL7, выпуск 2» – Data Exchange - HL7 Clinical Document Architecture, Release 2 [4].
Требования к электронной подписи
В соответствии с Федеральным законом № 63-ФЗ от 06.04.2011 «Об электронной подписи», электронные подписи, формируемые в рамках создания документов в электронном виде, должны соответствовать требованиям к усиленной квалифицированной электронной подписи. При создании ЭП должен использоваться формат CAdES (CMS Advanced Electronic Signatures) [5].
Для отладки разработок в тестовой среде допускается формирование электронных подписей неквалифицированными сертификатами ЭП (см. раздел 3.1).
В соответствии с Приказом Министерства связи и массовых коммуникаций РФ и Федеральной службы охраны РФ от 27 мая 2015 г. № 186/258 «Об утверждении Требований к организационно-техническому взаимодействию государственных органов и государственных организаций посредством обмена документами в электронном виде», ЭП сотрудников и организаций, создаваемые при подписи электронных документов, должны формироваться в отдельных файлах (каждой ЭП должен соответствовать отдельный файл), т.е. должны быть использованы варианты открепленной (отсоединенной) ЭП.
Электронные подписи должны формироваться с использованием следующих алгоритмов цифровой подписи:
- ГОСТ Р 34.10-2001;
- ГОСТ Р 34.10-2012.
Согласно письму Федеральной службы безопасности Российской Федерации от 07.09.2018 №149/7/6-363 возможность использования схемы ЭП, соответствующей ГОСТ Р 34.10-2001 «Информационная технология. Криптографическая защита информации. Процессы формирования и проверки электронной цифровой подписи» (далее - ГОСТ-2001), для формирования ЭП допускается до 31.12.2019.
Список ссылочных документов
Актуальные версии документов находятся в разделе «Материалы» на портале оперативного взаимодействия участников ЕГИСЗ, доступном по ссылке http://portal.egisz.rosminzdrav.ru/materials.
- Описание выполняемых проверок при регистрации отдельных ЭМД формата CDA в РЭМД ЕГИСЗ:
http://portal.egisz.rosminzdrav.ru/materials/3499;
- Методические материалы по подключению к Сервису ИПС: http://portal.egisz.rosminzdrav.ru/materials/11;
- Document management - Electronic document file format for long-term preservation - Part 1: Use of PDF 1.4 (PDF/A-1) – «Управление документацией. Формат файлов электронных документов для долгосрочного сохранения. Часть 1: Использование формата PDF 1.4 (PDF/A-1)»: https://www.iso.org/standard/38920.html
- Data Exchange - HL7 Clinical Document Architecture, Release 2 – «Обмен данными - Архитектура клинических документов HL7, выпуск 2»: https://www.iso.org/standard/44429.html;
- CMS Advanced Electronic Signatures (CAdES) – Расширенные электронные подписи стандарта CMS: http://www.etsi.org/deliver/etsi_ts/101700_101799/101733/02.02.01_60/ts_101733v020201p.pdf;
- Материалы по подсистеме «Федеральный реестр электронных медицинских документов»:
https://portal.egisz.rosminzdrav.ru/materials/categories/853;
- РЭМД. Описание интеграционных профилей:
https://portal.egisz.rosminzdrav.ru/materials/1879
ИСТОРИЯ ИЗМЕНЕНИЯ ДОКУМЕНТА
Дата изменения | Место изменения | Описание изменения |
---|---|---|
ПРИМЕР WSDL-ОПИСАНИЯ СЕРВИСА ИС
(обязательное)
Пример описания электронного сервиса ИС приведен ниже:
<wsdl:definitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" xmlns:tns="http://egisz.rosminzdrav.ru/iehr/emdr/callback/" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:ns2="http://schemas.xmlsoap.org/soap/http" xmlns:ns1="http://egisz.rosminzdrav.ru" name="EmdrClientCallbackImplService" targetNamespace="http://egisz.rosminzdrav.ru/iehr/emdr/callback/"> |
<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="a2f3a5d9-2f78-4183-890c-6b619b71b3f6"><ac:parameter ac:name="">_Ref470097743</ac:parameter></ac:structured-macro><ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="ce3aa9f2-4917-408b-a967-0fffac06c934"><ac:parameter ac:name="">_Ref375306643</ac:parameter></ac:structured-macro><ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="f2c93211-696d-4858-b508-05c316fad7d3"><ac:parameter ac:name="">_Toc385509617</ac:parameter></ac:structured-macro><ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="bc4d70ef-f76e-451c-8aad-82ea803d2756"><ac:parameter ac:name="">_Toc467236282</ac:parameter></ac:structured-macro>
<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="91e50856-658b-4fac-8be2-e208e51acdc1"><ac:parameter ac:name="">_Toc111717685</ac:parameter></ac:structured-macro><ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="9cf323df-ff2e-4ecb-a7f1-e54031d1dc37"><ac:parameter ac:name="">_Ref503341485</ac:parameter></ac:structured-macro>
(обязательное)
Примеры вызова веб-сервиса обмена сведениями об ЭМД
Из примеров запросов и ответов исключены файлы подписей, а также их контрольные суммы, так как они занимают много места и отрицательно сказываются на восприятии. Пример файла документа и файла подписи к нему приведены в документе «Приложение к документу «Рекомендации к информационным системам в сфере здравоохранения по обеспечению информационного взаимодействия» [6].
Метод «registerDocument»
Запрос:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:egis="http://egisz.rosminzdrav.ru" xmlns:oas="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ser="http://egisz.rosminzdrav.ru/iehr/emdr/service/" xmlns:wsa="http://www.w3.org/2005/08/addressing"> ![]() </wsa:To> |
Пример успешного ответа:
<soap:Envelope xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> |
Пример ответа с ошибкой
ИПС |
Метод «searchRegistryItem»
Запрос:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:egis="http://egisz.rosminzdrav.ru" xmlns:oas="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ser="http://egisz.rosminzdrav.ru/iehr/emdr/service/" xmlns:wsa="http://www.w3.org/2005/08/addressing"> ![]() </wsa:To> |
Пример успешного ответа:
<soap:Envelope xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> |
Пример ответа с пустым результатом поиска:
<soap:Envelope xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> |
Пример ответа с ошибкой:
<soap:Envelope xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> |
Метод «getRegistryItem»
Запрос:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:egis="http://egisz.rosminzdrav.ru" xmlns:oas="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ser="http://egisz.rosminzdrav.ru/iehr/emdr/service/" xmlns:wsa="http://www.w3.org/2005/08/addressing"> ![]() </wsa:To> |
Пример успешного ответа:
<soap:Envelope xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> |
Пример ответа с отрицательным результатом выполнения:
<soap:Envelope xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> |
Метод «demandContent»
Запрос:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:egis="http://egisz.rosminzdrav.ru" xmlns:oas="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ser="http://egisz.rosminzdrav.ru/iehr/emdr/service/" xmlns:wsa="http://www.w3.org/2005/08/addressing"> ![]() </wsa:To>* |
Пример успешного ответа:
<soap:Envelope xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> |
Метод «getMetadata»
Запрос:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:egis="http://egisz.rosminzdrav.ru" xmlns:oas="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ser="http://egisz.rosminzdrav.ru/iehr/emdr/service/" xmlns:wsa="http://www.w3.org/2005/08/addressing"> ![]() </wsa:To> |
Пример успешного ответа:
<soap:Envelope xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> |
Пример ответа с ошибкой
<soap:Envelope xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> |
(обязательное)
Примеры вызова веб-сервиса ИС
Из примеров запросов и ответов исключены файлы ЭМД, а также их контрольные суммы, так как они занимают много места и отрицательно сказываются на восприятии. Пример файла приведен по адресу: https://portal.egisz.rosminzdrav.ru/materials/1879.
Метод «sendRegisterDocumentResult»
Запрос, направляемый в случае успешной регистрации ЭМД:
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope" xmlns:env="http://www.w3.org/2003/05/soap-envelope"> |
Запрос, направляемый в случае выявления ошибок:
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope" xmlns:env="http://www.w3.org/2003/05/soap-envelope"> |
Пример ответа сервиса ИС (callbackResponse):
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:env="http://www.w3.org/2003/05/soap-envelope"> |
Метод «sendDocumentFile»
Запрос, направляемый в случае успешного получения ЭМД:
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope" xmlns:env="http://www.w3.org/2003/05/soap-envelope"> |
Запрос, направляемый в случае ошибок при получении ЭМД:
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope" xmlns:env="http://www.w3.org/2003/05/soap-envelope"> |
Пример ответа сервиса ИС (callbackResponse):
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:env="http://www.w3.org/2003/05/soap-envelope"> |
Метод «sendNotice»
Запрос, направляемый в случае регистрации нового ЭМД:
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope" xmlns:env="http://www.w3.org/2003/05/soap-envelope"> |
Запрос, направляемый в случае создания связи с документом получателя:
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope" xmlns:env="http://www.w3.org/2003/05/soap-envelope"> |
Пример ответа сервиса ИС (callbackResponse):
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:env="http://www.w3.org/2003/05/soap-envelope"> |
ПРИЛОЖЕНИЕ Г
Заявка на подключение ИС к тестовой/промышленной Необходимо указать нужную среду АЭМД среде региональной подсистемы «Архив электронных медицинских документов»
Прошу зарегистрировать государственную информационную систему в сфере здравоохранения субъекта Российской Федерации (далее ГИС) / медицинскую информационную систему медицинской организации (далее МИС) / иную информационную систему Необходимо указать нужный тип ИС в тестовой/промышленной Необходимо указать нужную среду АЭМД среде региональной подсистемы «Архив электронных медицинских документов» с целью передачи сведений об электронных медицинских документах.
Таблица 1 – Сведения об организации Все пункты, кроме «Адрес официального сайта организации», обязательны для заполнения
Наименование организации, эксплуатирующей ИС | |
Адрес официального сайта организации | |
Место работы, должность, ФИО контактного лица (руководителя организации) | |
Адрес электронной почты контактного лица (руководителя организации) |
Таблица 2 – Сведении о ИС
Полное наименование ИС | |
Краткое наименование ИС | |
Субъект Российской Федерации | |
Адрес веб-сервиса ИС (callback) | |
Типы документов | Перечислить типы документов , указать их редакции |
Поставщик (разработчик) ПО | |
Адрес электронной почты службы технической поддержки или ответственного лица поставщика (разработчика) ПО |
Подтверждаем ознакомление и согласие со всеми положениями «Технических условий на подключение к ГИС ЭЗ РТ».
Подтверждаем выполнение предъявленных требований о защите информации в соответствии с действующим законодательством Российской Федерации.
Достоверность предоставленных данных гарантируем. Обо всех изменениях параметров подключения к обязуемся уведомлять ГАУЗ «РМИАЦ».
|
|