Page tree

МИНИСТЕРСТВО ЗДРАВООХРАНЕНИЯ

РЕГИОН

 


 

УТВЕРЖДАЮ

 

Указать должность

 

_________________ ФИО

 

«______»_________________  2021   г.

 

Наименование ИС

Компонент «Региональный реестр
электронных медицинских документов»

РЕГЛАМЕНТ ИНФОРМАЦИОННОГО ВЗАИМОДЕЙСТВИЯ

 

ЛИСТ УТВЕРЖДЕНИЯ

Р.РРЭМД.1.5.4-ЛУ

 

Листов 61

 

 

 

 




МИНИСТЕРСТВО ЗДРАВООХРАНЕНИЯ

РЕГИОН

УтверждЕН

 

Р.РРЭМД.1.5.4-ЛУ

 

 

 

 

Наименование ИС

Компонент «Региональный реестр
электронных медицинских документов (РРЭМД)»

РЕГЛАМЕНТ ИНФОРМАЦИОННОГО ВЗАИМОДЕЙСТВИЯ

 

Р.РРЭМД.1.5.4

 

Листов 61

 


Содержание

1 Общие положения

2 Список используемых сокращений

3 Участники информационного взаимодействия

4 Порядок регистрации поставщиков информации

5 Описание информационного взаимодействия при передаче информации

6 Порядок внесения изменений в Регламент

Приложение А Заявка на регистрацию в информационном взаимодействии

Приложение Б Сервис регионального хранилища ЭМД. Техническое описание

В.1 Назначение сервиса

В.2 Адреса сервиса

В.3 Запрос «Опубликовать ЭМД»

В.4 Запрос «Опубликовать региональный ЭМД»

В.5 Запрос «Найти ЭМД»

В.6 Запрос «Получить файл ЭМД запрашивающей РМИС/МИС из архива предоставляющей РМИС/МИС»

В.7 Запрос «Получить метаописание ЭМД в РЭМД»

В.8 Запрос «Получить подписанное содержимое ЭМД»

В.9 Описание действий для устранения ошибок

В.10 Используемые классификаторы

В.11 API сервиса

В.12 Методика тестирования сервиса

 

1          Общие положения

1.1               Настоящий «Регламент информационного взаимодействия сторон, осуществляющих создание электронных медицинских документов с использованием медицинских информационных систем на территории Регион (далее - Регламент) разработан в целях реализации требований следующих документов :

-        Федеральный закон от 21.11.2011  № 323-ФЗ «Об основах охраны здоровья граждан в Российской Федерации»;

-        Федеральный закон от 27.07.2006 № 149-ФЗ «Об информации, информационных технологиях и о защите информации»;

-        Положение о единой государственной информационной системе в сфере здравоохранения, утвержденной Постановлением Правительства Российской Федерации от 5   мая 2018   года №   555 «О единой государственной информационной системе в сфере здравоохранения.

1.2               Настоящий Регламент устанавливает общие правила взаимодействия сторон, осуществляющих создание, передачу, обработку и хранение электронных медицинских документов (ЭМД) с использованием медицинских информационных систем (МИС) на территории Регион (поставщики информации), а также с использованием информационной системы Наименование ИС , компонент «Региональный реестр электронных медицинских документов» (РРЭМД), лиц, осуществляющих техническую реализацию настоящего Регламента (разработчики), а также лиц, осуществляющих технический контроль за реализацией информационного взаимодействия и техническое сопровождение (служба технической поддержки).

1.3               Оператором Наименование ИС , осуществляющей сбор, обработку и хранение информации от поставщиков информации, и контроль своевременности предоставления информации, является указать оператора (далее – оператор).

1.4               Органом исполнительной власти, осуществляющим административный контроль исполнения настоящего Регламента, является указать орган власти .

1.5               В общем случае, поставщиками информации являются медицинские организации регион .

1.6               Присоединение к настоящему Регламенту осуществляется путем регистрации поставщика информации в порядке, определенном в разделе   4 настоящего Регламента.

1.6.1         С момента регистрации, поставщик информации считается присоединившимся к настоящему Регламенту.

1.6.2         Факт присоединения поставщика информации к Регламенту является полным принятием им условий настоящего Регламента и всех его приложений в редакции, действующей на момент направления заявления на регистрацию в адрес оператора. Поставщик информации, присоединившийся к Регламенту, принимает дальнейшие изменения (дополнения), вносимые в настоящий Регламент в соответствии с законодательством Российской Федерации.

1.6.3         После присоединения поставщика информации к Регламенту Оператор и поставщик информации, присоединившийся к настоящему Регламенту, считаются вступившими в соответствующие договорные отношения на неопределенный срок.

1.7               Консультирование поставщиков информации по вопросам предоставления информации в наименование ИС осуществляется посредством электронной почты.

1.8               Консультирование разработчиков МИС и специалистов службы технической поддержки МИС по вопросам технической реализации взаимодействия МИС и наименование ИС осуществляется посредством электронной почты.

2               Список используемых сокращений

API

application programming interface

Протокол взаимодействия с программным компонентом

UUID

статистически уникальный 128-битный идентификатор

( Universally Unique Identifier , стандарт RFC 4122)

JSON

формат для обмена данными JavaScript Object Notation (стандарт RFC 8259)

OID

глобально-уникальный номер, идентифицирующий объект

Redmine

информационная система оператора системы, используемая для технической поддержки участников пользователей ЦУ РС ЕГИСЗ

ДУЛ

документ, удостоверяющий личность

ЕНП

единый номер полиса обязательного медицинского страхования (16 -значный)

ЕПГУ

единый портал государственных и муниципальных услуг

ИЭМК

интегрированная электронная медицинская карта. Компонент ЦУ РС ЕГИСЗ

КСПД

корпоративная сеть передачи данных

МИАЦ

бюджетное учреждение регион «Медицинский информационно-аналитический центр»

МИС

медицинская информационная система

МО

медицинская организация

НСИ

нормативно-справочная информация

РРЭМД

компонент наименование ИС

СНИЛС

страховой номер индивидуального лицевого счёта

ТФОМС

Территориа льный фонд обязательного медицинского страхования регион

ФИО

фамилия, имя, отчество

ФРМО

федеральный реестр медицинских организаций

ФРЭМД

федеральный реестр электронных медицинских документов, созданный в соответствии с Постановлением Правительства РФ №   555 от 05.05.2018

Наименование ИС краткое

Наименование ИС полное

ЭМД

электронный медицинский документ

ЭП

электронная подпись

СКП

Сертификат ключа подписи

УКЭП

Усиленная квалифицированная электронная подпись

3          Участники информационного взаимодействия

3.1               Во взаимодействии принимают участие следующие поставщики информации:

3.1.1         Медицинские организации, в которых создаются электронные медицинские документы на территории регион , подключенные к подсистеме ФРЭМД.

3.2               Участниками информационного взаимодействия являются следующие органы и организации:

3.2.1         Оператор наименование ИС , осуществляющей сбор, обработку и хранение информации от поставщиков информации, и контроль своевременности предоставления информации.

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


4          Порядок регистрации поставщиков информации

4.1               Подключение к наименование ИС .

4.1.1         Перед регистрацией в РРЭМД, поставщики информации должны быть подключены наименование ИС .

4.1.2         Поставщики информации, не подключенные к подсистеме ФРЭМД, должны предварительно получить разрешение на подключение к наименование ИС . Подключение таких поставщиков осуществляется в порядке, изложенном в Правил ах взаимодействия иных информационных систем, предназначенных для сбора, хранения, обработки и предоставления информации, касающейся деятельности медицинских организаций и предоставляемых ими услуг, с информационными системами в сфере здравоохранения и медицинскими организациями (утв. Постановлением Правительства РФ от 12.04.2018 №   447).

4.2               Основанием для регистрации поставщика (потребителя) информации является заявка на регистрацию (далее – Заявка), направляемая в адрес Оператора по электронной почте.

4.3               Заявка составляется в соответствии с формой, определенной в приложении   Приложение А настоящего Регламента.

4.4               Обработка Заявки осуществляется службой технической поддержки в следующем порядке:

4.4.1         Направление автоматического ответного сообщения о факте получения Заявления поставщику информации, направившему Заявки, при получении Заявки.

4.4.2         Осуществление в течение 5 (пяти) рабочих дней мероприятий по регистрации параметров доступа поставщика информации, надлежащим образом заполнившего Заявку.

4.4.3         Формирование и направление поставщику информации в течение 1 (одного) рабочего дня со дня получения Заявки ответного сообщения о необходимости повторной подачи Заявки с указанием замечаний, которые необходимо устранить, в случае ненадлежащего заполнения Заявки поставщиком информации.

4.4.4         Под параметрами доступа поставщика информации понимается уникальный идентификатор поставщика информации, полученный в наименование ИС при регистрации.

4.5               Поставщик должен доработать МИС таким образом, чтобы обеспечивать взаимодействие с системой РРЭМД в соответствии с настоящим Регламентом. Тестирование взаимодействия осуществляется с использованием тестового стенда системы, согласно методике тестирования.

Готовность медицинской организации обеспечивать передачу данных по определенному виду документа в подсистему ФРЭМД подтверждается актом испытаний, проведенных в соответствии с программой-методикой испытаний.

5          Описание информационного взаимодействия при передаче информации

5.1               С момента присоединения к настоящему Регламенту поставщик информации начинает отправку информации в РРЭМД с использованием имеющейся у него МИС.

5.2               Требования к электронному медицинскому документу

5.2.1         Под электронным медицинским документом (ЭМД) понимается файл в формате PDF/A-1, соответствующий стандарту ISO 19005-1:2005, или XML-документ, оформленный согласно руководству по реализации СЭМД , созданный в МИС и подлежащий передаче в подсистему «Федеральный реестр электронных медицинских документов» (ФРЭМД).

5.2.2         Отправке в РРЭМД подлежат документы, перечисленные в актуальной версии справочника «Регистрируемые электронные медицинские документы» (OID 1.2.643.5.1.13.13.11.1520 ). Согласно данному федеральному справочнику, документ «Направление на медико-социальную экспертизу медицинской организацией (CDA)» в новой редакции (редакция   5) должен передаваться с 01.01.2022 с кодом 109 взамен кода 34.

5.2.3         Отправке в ВИМИС подлежат документы, перечисленные в актуальной версии справочников:

-           «ВИМИС. Типы структурированных медицинских сведений» ( OID 1.2.643.5.1.13.13.99.2.592 );

-           « Виды медицинской документации » ( OID 1.2.643.5.1.13.13.11.1522 );

-           «Регистрируемые электронные медицинские документы» ( OID 1.2.643.5.1.13.13.11.1520 ).

5.2.4         А также содержащие в метаданных запроса информацию о направлении оказания медицинской помощи (параметр $.vmcl), типе отправляемого в запросе документа (параметр $.vimisDocType), версии типа отправляемого в запросе документа (параметр $.vimisDocTypeVersion) и триггерной точки (параметр $.triggerPoint).

5.2.5         Руководства по реализациям  СЭМД размещены на портале оперативного взаимодействия участников ЕГИСЗ Министерства здравоохранения Российской Федерации: https://portal.egisz.rosminzdrav.ru/materials .

5.2.6         Приоритетным форматом для отправки информации в РЭМД является CDA HL7.

5.2.7         В случаях, когда в соответствии со справочником «Регистрируемые электронные медицинские документы» ( OID 1.2.643.5.1.13.13.11.1520 ) допустима реализация передачи электронных документов в формате PDF/A-1 , необходимо учитывать требования к составу данных, определенных для того же вида документа в формате HL7 СЭМД.

5.2.8         В запросе на регистрацию ЭМД в РЭМД может быть указан токен безопасности, присвоенный МО. Для его получения необходимо обратиться к подсистеме ЭП МО, далее полученный идентификатор указать в запросе в параметре « securityToken ». Для МО с указанным признаком закрытости в РЭМД, доступны документы, зарегистрированные из своего учреждения и всех МО с отсутствием признака закрытости, в случае если у МО отсутствует признак закрытости, ей доступны документы всех МО у которых так же отсутствует признак закрытости. Сервис определяет имеется ли данный признак у МО по присвоенному ей токену безопасности, указанному в запросе.   

С инструкцией и описанием по предоставлению токена безопасности можно ознакомиться в регламенте информационного обмена СУ НСИ.

5.2.9         Сведения о сотрудниках, участвующих в подписании ЭМД, должны соответствовать сведениям в ФРМР.

5.2.10     Сведения о структурных подразделениях, кабинетах и отделениях должны соответствовать данным ФРМО.

5.2.11     Обязательность наличия УКЭП работника МО и СНИЛС пациента определена справочниках «РЭМД. Виды регистрируемых электронных медицинских документов» ( OID 1.2.643.5.1.13.13.11.1520 ) и «РЭМД. Правила подписи электронных медицинских документов» ( OID 1.2.643.5.1.13.13.99.2.42 ).

5.2.12     Подписание документа УКЭП МО должно быть реализовано на стороне МИС при отправке документа в РЭМД автоматически. Сотрудник МО подписывает документ только своей УКЭП.

5.2.13     Ответственность за объем, полноту, достоверность и актуальность передаваемых электронных медицинских документов лежит на поставщике информации (главный врач МО, лечащий врач, указанный в электронном медицинском документе).

5.2.14     Сроки формирования и передачи электронных медицинских документов из МИС в РРЭМД должны соответствовать Постановлению правительства РФ от 5   мая 2018   года №   555 «О единой государственной информационной системе в сфере здравоохранения».

5.3               Средой передачи электронных медицинских документов является корпоративная сеть передачи данных Департамента здравоохранения регион (далее – КСПД). Оператор занимается обслуживанием, администрированием и подключением к сети КСПД. Процедура подключения и оказания технической поддержки по вопросам работы КСПД не входит в рамки настоящего Регламента.

5.4               Сервис регионального хранилища ЭМД.

5.4.1         Для регистрации, поиска и получения электронных медицинских документов используется сервис регионального хранилища ЭМД. Техническое описание сервиса, а также адреса сервиса в КСПД и тестовой среде приведены в приложении   Приложение Б к настоящему Регламенту.

5.4.2         При получении ЭМД сервис регионального хранилища производит проверку сведений об ЭМД и выполняет форматно-логический контроль переданных сведений. В форматно – логический контроль входят следующие проверки:

  • Если в поле справочника PATIENT_INFO указано значение «Обязательны с указанием СНИЛС», сервис осуществляет проверку наличия СНИЛС и его соответствие контрольной сумме в блоке со сведениями о пациенте, при отсутствии СНИЛС сервис выдает текст с ошибкой;
  • Если в поле справочника PATIENT_INFO указано значение «Обязательны», сервис при наличии СНИЛС в блоке со сведениями пациента осуществляет проверку его соответствия контрольной сумме, при его отсутствии переходит к дальнейшим проверкам запроса;
  • Проверка на основе правил подписания ЭМД согласно федеральному справочнику с OID 1.2.643.5.1.13.13.99.2.42 . Сервис осуществляет поиск соответствия содержимого в поле $.personalSignatures[n].signer.role.code с содержимым в поле CODE_ROLE справочника НСИ с OID 1.2.643.5.1.13.13.99.2.368 , при успешном нахождении соответствия сервис переходит к проверки наличия подписантов согласно справочнику с OID 1.2.643.5.1.13.13.99.2.42 . При отсутствии соответствующих данных в справочнике сервис отдает ответ с ошибкой;
  • Проверка передаваемых в запросе кодов триггерных точек в поле $. triggerPoint на соответствие справочнику «ВИМИС. Триггерные точки для передачи данных» с OID 1.2.643.5.1.13.13.99.2.591 ;
  • Проверка соответствия данных по медицинским работникам в ФРМО/ФРМР с данными, передаваемыми при регистрации ЭМД. Осуществляется проверка всех данных, передаваемых в блоке со сведениями о владельце подписи, при несоответствии СНИЛС, должности или уникального идентификатора сотрудника в МИС, сервис выдаст соответствующую ошибку. При несоответствии других параметров из данного блока или их отсутствия сервис выдаст предупреждение;

Если документ соответствует форматно – логическим правилам, то в МИС отправляется статус успешной обработки. Иначе возвращается список ошибок, и информация об ошибочном обращении с метаданными запроса временно сохраняется в РЭМД.

5.4.3         РЭМД позволяет проводить регистрацию новых версий документа, в том случае, если были произведены какие – либо изменения этого документа в МИС. Регистрация новой версии ЭМД производится аналогично регистрации документа с помощью метода сервиса РЭМД « registerDocument ».

При передаче сведений о новой версии ЭМД должны оставаться неизменными параметры информационной системы ( system ), вида документа ( kind ) и номер документа ( documentNumber ). В свою очередь в обязательном порядке должны быть изменены подписи документа (personalSignature\signature) и его локальный идентификатор ( localUid ).

Далее в запросе указывается группа атрибутов, которая указывает на актуальную зарегистрированную версию заменяемого документа ( replace ).

При регистрации новой версии ЭМД используется регистрационный номер в ФРЭМД, который присвоен ЭМД после регистрации первоначальной версии. Для новой версии ЭМД добавляется постфикс с порядковым номером версии.

5.4.4         РЭМД повторно отправляет запрос на регистрацию ЭМД во ФРЭМД, с помощью метода сервиса РЭМД «registerDocument», на документы, которые ранее не были зарегистрированы по причине системных ошибок в федеральном сервисе.

5.4.5         В сервисе регионального хранилища ЭМД предоставлена возможность выполнять запросы из МИС к хранилищу на поиск ЭМД, переданных в ЦУ РС ЕГИСЗ, и получение их содержимого.

5.4.6         МИС может получать уведомление о результатах обработки документа отправленного во ФРЭМД о следующих событиях:

¾       Документ успешно зарегистрирован во ФРЭМД;

¾       Документ не зарегистрирован во ФРЭМД (от сервиса ФРЭМД получена ошибка);

¾       Возникла ошибка при передаче запроса в сервис ФРЭМД;

¾       В РРЭМД появился связанный документ (сведения о результатах МСЭ).

На стороне МИС должен быть реализован ответный callback сервис, для получения данных уведомлений. Для получения уведомления МИС в теле запроса на публикацию документа (приложение В.3 Запрос «Опубликовать ЭМД») необходимо передать необязательный параметр «messageId» – идентификатор запроса, генерируемый на стороне МИС.

Так же для отправки уведомлений в РРЭМД должна быть настройка для адреса callback МИС и передаваемого параметра « system » в теле запроса на публикацию документа (приложение В.3 Запрос «Опубликовать ЭМД»). Для выполнения данной настройки необходима заявка от МИС с указанием адреса callback МИС и передаваемого параметра « system ».

После получения уведомления МИС необходимо отправить ответ о том, что уведомление успешно получено, либо о том, что при получении уведомления возникли проблемы.

Пример формата передачи уведомления:

{

   " id ":"4987 cbe 2- a 22 e -439 a -8 a 35-2857 c 884 e 8 e 3",

   "emdrId":"01.17.1.000000015",

   "errors":[

      {

         "code":"string",

         "message":"string"

      }

   ],

   "status":"success",

   "messageId":"09fa0dfc-a975-42ce-9739-d8afac7df2d0",

   "headerMessageId":"376b2dce-1f55-11ec-80cd-005056832c72",

   "organizationCode":"1.2.643.5.1.13.13.12.2.86.8924",

   "departmentCode":"1.2.643.5.1.13.13.12.2.86.8924.0.302652",   "storeTillDate":"2018-12-06",

   "documentVersion":3,

   "registrationDate":"2018-05-04T00:00:00.000+03:00",

   "registrationDateTime":"2018-05-04T11:26:49.947+03:00",

   "registrationWarnings":[

      {

         "code":"string",

         "message":"string"

      }

   ]

   "associations":[

      {

         "target": "string",

         " localUid ": " string ",

         " type ”: " string "

      }

   ]

 

}

 

Уведомление будет содержать идентификатор запроса, генерированный на стороне МИС и переданный в теле запроса на публикацию документа, в параметре « id ».

 

 

Пример формата ответа от МИС:

{

    "status": "success",

    "id": "4987cbe2-a22e-439a-8a35-2857c884e8e3",

    "errors": [

        {

            "code": "string",

            "message": "string"

        }

    ]

}

5.4.7         Уведомления о регистрации документа «Сведения о результатах проведенной медико-социальной экспертизы» приходят на ответный callback сервис МИС и содержат следующие сведения в метаданных:

id – messageId документа «Направление на медико-социальную экспертизу медицинской организацией» на МСЭ, переданный в POST запросе при регистрации ЭМД в РРЭМД;

emdrId – реестровый номер ФРЭМД документа «Направление на медико-социальную экспертизу медицинской организацией»;

associations – блок с метаданными документа «Сведения о результатах проведенной медико-социальной экспертизы»:

  • target – реестровый номер ФРЭМД документа «Сведения о результатах проведенной медико-социальной экспертизы»;
  • localUid – локальный идентификатор документа «Сведения о результатах проведенной медико-социальной экспертизы» в РРЭМД.

Получить документ «Сведения о результатах проведенной медико-социальной экспертизы» можно запросом « Получить подписанное содержимое ЭМД», используя localUid из блока «associations» уведомления о регистрации документа.

5.4.8         В случае нерегламентированного поведения сервиса регионального хранилища необходимо направить заявку в службу технической поддержки оператора и в Redmine оператора по проекту «Компонент РЭМД». Веб-адрес: https://redmine.miacugra.ru/projects/mpmt .

Заявка должна содержать данные, представленные ниже ( Таблица 1 ).

Таблица 1 – Содержание заявки

Название системы (т.е. РРЭМД)

 

Дата и примерное время возникновения проблемы

 

Описание проблемы:

- Действия пользователя/системы, предшествовавшие нерегламентированному поведению системы (приложить скриншоты экрана, исходные запросы и ответы)

- Фактический и ожидаемый результат

- Сведения о повторяемости проблемы

- LocalUid запроса, по которому возникла ошибка

 

Площадка (тестовая, продуктивная)

 

ФИО и контактные данные ответственного специалиста, с которым можно связаться для уточнения деталей при необходимости

 

5.5               Передача документов из РРЭМД в ФРЭМД.

5.5.1         наименование ИС обрабатывает полученные электронные медицинские документы, передаёт метаданные документов в ФРЭМД.

5.5.2         наименование ИС успешно принятым электронным медицинским документам в ФРЭМД присваивается реестровый номер ФРЭМД.

5.5.3         В наименование ИС электронным медицинским документам не принятым сервисом ФРЭМД по причине ошибок в содержимом документа или иным причинам, недоступным для исправления средствами наименование ИС З, прикрепляется список соответствующих ошибок.

5.5.4         Электронные медицинские документы, непринятые сервисом ФРЭМД по техническим причинам, доступным для исправлений средствами наименование ИС , исправляются и повторно отправляются в ФРЭМД.

5.5.5         Электронные медицинские документы, непринятые сервисом ФРЭМД по причине отсутствия связи или проблем на стороне ФРЭМД, ставятся в очередь на отправку и отправляются после устранения указанных причин.

5.5.6         При поступлении запросов со стороны ФРЭМД (например, по запросу пациента с портала Госуслуг), содержимое документа передаётся из РРЭМД.

6          Порядок внесения изменений в Регламент

6.1               Обсуждение всех доработок по новой версии регламента ведется в переписке по электронной почте.

6.2               Изменения в формат обмена/интеграции должны вноситься по предварительному согласованию с разработчиками МИС и наименование ИС , а также специалистами Оператора.

6.3               В соответствии с изменениями должна быть составлена и утверждена новая версия регламента, доступная для ознакомления всех участников регламента и опубликованная на сайте оператора сайт оператора и путь расположения .

6.4               Оператор обеспечивает информирование МО - поставщиков информации о утверждении кто утверждает новой версии регламента, путём отправки официального письма в адрес руководителей МО.


Приложение А                  
Заявка на регистрацию в информационном взаимодействии

Таблица 2 – Заявка на регистрацию в информационном обмене

OID МО в ФРМО

 

Наименование МО полное

 

Наименование МО краткое

 

Адрес МО

 

Ip -адрес сервиса интеграции в сети КСПД

 

ФИО лица, ответственного за исполнение Регламента в МО

 

Телефон ответственного лица

 

E - mail ответственного лица

 


Приложение Б                   
Сервис регионального хранилища ЭМД. Техническое описание

В.1                      Назначение сервиса

Сервис используется для отправки и получения электронных медицинских документов (ЭМД) в наименование ИС . Сведения о подписанных ЭМД, а также ЭП к ним, передаются в ФРЭМД. Опубликованное содержимое ЭМД доступно пациентам с помощью ЕПГУ.

Тип сервиса: REST, синхронный.

В.2                      Адреса сервиса

Назначение

Адрес {context}

Стенд демонстрационный, Интернет

https://medved-webservices-release.hostco.ru/emds/rest/v1/documents

Стенд продуктивный (общий), КСПД

http://10.80.0.101/emds/rest/api/v1/documents

 

В.3                      Запрос «Опубликовать ЭМД»

Запрос

POST{context}/documents? securityToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxLjIuNjQzLjUuMS4xMy4xMy4xMi4yLjg2Ljg5MDIiLCJpYXQiOjE1NjY4NjQwMDAsImV4cCI6MTU3NzgzNjc5OSwibWNvZGUiOiIyMTEyNiJ9.Mo2yoJ9q2QundwZjv9A_ppPgdFUbb6FlgWUjVa3XGFE

 

В теле запроса требуется отправить JSON типа ClinicalDocument (см. п.   В.11 )

1)     Пример тела запроса (строки формата base64 в примере сокращены):

{

   "localUid": "6ae669ff-80b7-4ef7-a669-ff80b70ef709",

   " kind ": {

      " code ": "34",

      " codeSystem ": "1.2.643.5.1.13.13.11.1520",

      " codeSystemName ": "Реестр электронных медицинских документов",

      " codeSystemVersion ":"8.12",

      " displayName ": "Направление на медико-социальную экспертизу медицинской организацией (CDA)"

   },

   "system": "mis-19124",

   "organization": {

      "code": "1.2.643.5.1.13.13.12.2.86.8954"

   },

   "documentNumber": "19124_12524",

   "creationDateTime": "2019-05-07T11:26:49.947+03:00",

   "recipient": {

      "kind": {

         "code": "PATIENT",

         "codeSystem": "1.2.643.5.1.13.13.99.2.123",

         "codeSystemName": null,

         "codeSystemVersion": null,

         "displayName": null

       },

       "snils": "77625810031"        

   },

   "patient": {

      "surname": "МИШКО",

      "name": "АНАСТАСИЯ",

      "patrName": "МИХАЙЛОВНА",

      "birthDate": "1984-02-07",

      "gender": {

         "code": "2"

      },

      "localId": "1cc76e8d-60d2-4a98-8369-7550547f0946",

      " snils ": "10065279723"

   },

   " description ": "Направление на МСЭ",

   " docContent ": {

      " data ": " JVBERi 0 xLjQNJeLjz 9 MNCjEgMCBvYmoNPDwvTGFuZyj +…",

      " checksum ": 1146562825,

" idcase ": "1 cc 76 e 8 d -60 d 2-4 a 98-8369-7550547 f 0946"

   },

   "reasonForAbsenceIdcase": {

      "code": null,

"codeSystem": null,

      "codeSystemVersion": null

   },

   "orgSignature": {

      "data": "MIIOJgYJKoZIhvcNAQcCoIIOFzCCDhMCAQExDDAKBgYqhQMCAgk…",

      "checksum": 3097071702

   },

   "personalSignatures": [

      {

         "signer": {

            "localId": "1",

            "role": {

               "code": "CHAIRMAN"

            },

            "surname": "СОРОКИН",

            "name": "СЕРГЕЙ",

            "patrName": "БОРИСОВИЧ",

            "birthDate": "1970-09-03",

            "snils": "13537703761",

            "position": {

               "code": "7",

               "codeSystem": "1.2.643.5.1.13.13.99.2.181",

               "codeSystemVersion": "4.1"

            },

            "speciality": {

               "code": "118",

               "codeSystem": " 1.2.643.5.1.13.13.11.1066 ",

               "codeSystemVersion": "1.4"

            },

            "email": "mail@gmail.com",

            "phone": "9274413322",

  "department": {

"localId": {

"code": "1.2.643.5.1.13.13.12.2.86.8954.0.201943"

}

},

  "office": {

"code": "1.2.643.5.1.13.13.12.2.86.8954.0.201943.43971"

}

         },

         "signature": {

            "data": "MIIOJgYJKoZIhvcNAQcCoIIOFzCCDhMCAQExDDAKBgYqhQMCAgk…",

            "checksum": 3097071702

         },

         "description": "Заведующий"

      }

   ]

}

Ответ

HTTP status :

Status

Описание

Содержимое

200 или 201

Объект успешно добавлен

 

400

Ошибка входящих параметров

В ответе возвращается массив JSON типа Error (см. п.   В.10 ) с описанием ошибок

500

Внутренняя ошибка сервера

 

 

2)                 Пример тела запроса при регистрации новой версии документа, ранее зарегистрированного в ФРЭМД (строки формата base64 в примере сокращены):

{

   "localUid": "364a421b-0e4c-4ad5-ac9b-ced8a2fade4c",

   " kind ": {

      " code ": "34",

      " codeSystem ": "1.2.643.5.1.13.13.11.1520",

      " codeSystemName ": "Реестр электронных медицинских документов",

      " codeSystemVersion ":"8.12",

      " displayName ": "Направление на медико-социальную экспертизу медицинской организацией (CDA)"

   },

   "system": "emdr-rmis-62",

   "organization": {

      "code": "1.2.643.5.1.13.13.12.2.86.9006"

   },

   "documentNumber": "emdr_doc_12",

   "creationDateTime": "2019-05-07T11:26:49.947+03:00",

   "patient": {

      "surname": "Кулишов",

      "name": " Виктор ",

      "patrName": " Степанович ",

      "birthDate": "1968-02-07",

      "gender": {

         "code": "2"

      },

      "localId": "L18DXZ9JDWERRDHO",

      "snils": "13579129587"

   },

   "description": " Протокол консультации ",

   "docContent": {

      "data": "JVBERi0xLjQNJeLjz9MNCjEgMCBvYmoNPDwvTGFuZyj+…",

      "checksum": 1146562825,

"idcase": null  

   },

   "reasonForAbsenceIdcase": {

      "code": "2"

"codeSystem": "1.2.643.5.1.13.13.99.2.286",

      "codeSystemVersion": "1.1"

   },

   "recipient": {

    "kind": {

        "code": "PATIENT",

         "codeSystem": "1.2.643.5.1.13.13.99.2.123",

        "codeSystemName": null,

        "codeSystemVersion": null,

        "displayName": null

    },

    "snils": "96155474337"        

} ,

   "personalSignatures": [

      {

         "signer": {

            "localId": "1",

            "role": {

               "code": "CHAIRMAN"

            },

            "surname": "СОРОКИН",

            "name": "СЕРГЕЙ",

            "patrName": "БОРИСОВИЧ",

            "birthDate": "1970-09-03",

            "snils": "13537703761",

            "position": {

               "code": "7",

               "codeSystem": "1.2.643.5.1.13.13.99.2.181",

               "codeSystemVersion": "4.1"

            },

            "speciality": {

               "code": "118",

               "codeSystem": " 1.2.643.5.1.13.13.11.1066 ",

               "codeSystemVersion": "1.4"

            },

            "email": "mail@gmail.com",

            "phone": "9274413322",

  "department": {

"localId": {

"code": "1.2.643.5.1.13.13.12.2.86.8954.0.201943"

}

},

  "office": {

"code": "1.2.643.5.1.13.13.12.2.86.8954.0.201943.43971"

}

         },

         "signature": {

            "data": "MIIOJgYJKoZIhvcNAQcCoIIOFzCCDhMCAQExDDAKBgYqhQMCAgk…",

            "checksum": 3097071702

         },

         "description": "Заведующий"

      }

   ]

}


 

В.4                      Запрос «Опубликовать ЭДМ ВИМИС»

Запрос

POST { context }/ documents ? securityToken = eyJhbGciOiJIUzI 1 NiIsInR 5 cCI 6 IkpXVCJ 9. eyJzdWIiOiIxLjIuNjQzLjUuMS 4 xMy 4 xMy 4 xMi 4 yLjg 2 Ljg 5 MDIiLCJpYXQiOjE 1 NjY 4 NjQwMDAsImV 4 cCI 6 MTU 3 NzgzNjc 5 OSwibWNvZGUiOiIyMTEyNiJ 9. Mo 2 yoJ 9 q 2 QundwZjv 9 A _ ppPgdFUbb 6 FlgWUjVa 3 XGFE

 

В теле запроса требуется отправить JSON типа ClinicalDocument (см. п.   В.11 )

Пример тела запроса (строки формата base64 в примере сокращены):

{

    "localUid": "e491eb0a-8826-4b4a-ab12-d897ad4b3c6e",

    "messageId": "1755f5b2-e44b-4018-9422-a2f45ac2097e",   

    "kind": {

        "code": "5",

        "codeSystem": "1.2.643.5.1.13.13.99.2.592",

        "codeSystemName": "ВИМИС. Типы структурированных медицинских сведений",

        "codeSystemVersion": "2.4",

        "displayName": "Осмотр (консультация) пациента"

    },

    "vmcl": "4",

    "triggerPoint": {

        "code": "1",

        "codeSystem": "1.2.643.5.1.13.13.99.2.591",

        "codeSystemName": " ВИМИС . Триггерные точки для передачи данных",

        "codeSystemVersion": "1.6",

        "displayName": "Выявление осмотра (консультации) пациента"

    },

    "vimisDocType": "5",

    "vimisDocTypeVersion": "2",

    "system": "emdr-rmis-12",

    "organization": {

        "code": "1.2.643.5.1.13.13.12.2.14.904",

        "codeSystem": null,

        "codeSystemName": null,

        "codeSystemVersion": null,

        "displayName": " ГБУ РС ( Я ) \" Нерюнгринская районная больница \""

    },

    "department": {

        "name": "Детская городская поликлиника",

        "localId": {

            "code": "1.2.643.5.1.13.13.12.2.14.938.0.43189",

            "codeSystem": null,

            "codeSystemName": null,

            "codeSystemVersion": null,

            "displayName": null

        }

    },

    "documentNumber": "10667956",

    "creationDateTime": "2021-10-07T11:26:49.947+03:00",

    "patient": {

        "surname": " МИШКО ",

        "name": " АНАСТАСИЯ ",

        "patrName": " МИХАЙЛОВНА ",

        "birthDate": "1984-02-07",

        "gender": {

            "code": "2",

            "codeSystem": null,

            "codeSystemName": null,

            "codeSystemVersion": null,

            "displayName": " Женский "

        },

        "localId": "1cc76e8d-60d2-4a98-8369-7550547f0946",

        "snils": "10065279723"

    },

    "description": "Осмотр (консультация) пациента",

    "docContent": {

        "data": "JVBERi0xLjQNJeLjz9MNCjEgMCBvYmoNPDwvTGFuZyj+…",

        "checksum": 1146562825

    },

    "orgSignature": {

        "data": "MIIOJgYJKoZIhvcNAQcCoIIOFzCCDhMCAQExDDAKBgYqhQMCAgk…",

        "checksum": 3097071702

    },

    "personalSignatures": [

        {

            "signer": {

                "localId": "1",

                "role": {

                    "code": "CHAIRMAN",

                    "codeSystem": null,

                    "codeSystemName": null,

                    "codeSystemVersion": null,

                    "displayName": null

                },

                "surname": " СОРОКИН ",

                "name": " СЕРГЕЙ ",

                "patrName": " БОРИСОВИЧ ",

                "birthDate": "1970-09-03",

                "snils": "13537703761",

                "position": {

                    "code": "7",

                    "codeSystem": "1.2.643.5.1.13.13.99.2.181",

                    "codeSystemName": null,

                    "codeSystemVersion": "4.1",

                    "displayName": null

                },

                "speciality": {

                    "code": "118",

                    "codeSystem": "1.2.643.5.1.13.13.99.2.170",

                    "codeSystemName": null,

                    "codeSystemVersion": "1.4",

                    "displayName": null

                },

                "email": "mail@gmail.com",

                "phone": "9274413322",

                "office": {

                    "code": "1.2.643.5.1.13.13.12.2.14.938.0.43189.225192",

                    "codeSystem": null,

                    "codeSystemName": null,

                    "codeSystemVersion": null,

                    "displayName": null

                }

            },

            "signature": {

                "data": "MIIOJgYJKoZIhvcNAQcCoIIOFzCCDhMCAQExDDAKBgYqhQMCAgk…",

                "checksum": 3097071702

            },

            "description": " Заведующий "

        }

    ]

}

Ответ

HTTP status :

Status

Описание

Содержимое

200 или 201

Объект успешно добавлен

 

400

Ошибка входящих параметров

В ответе возвращается массив JSON типа Error (см. п.   В.10 ) с описанием ошибок

500

Внутренняя ошибка сервера

 

 

 

В.5                      Запрос «Найти ЭМД»

Запрос

GET {context}/documents

 

Параметры:

Параметр

Назначение

X-medOrgOid

Организация, от имени которой выполняется запрос.

Указывается для поиска документов в ФРЭМД, опубликованных другими РМИС

creationDate

Дата создания документа внутри организации или ее подразделения

creationDateTime

Дата и время создания документа внутри организации или ее подразделения

creationDateBegin

Дата и время начала периода создания документа внутри организации или ее подразделения

creationDateEnd

Дата и время окончания периода создания документа внутри организации или ее подразделения

registerDateBegin

Дата и время начала периода регистрации документа в ФРЭМД

registerDateEnd

Дата и время окончания периода регистрации документа в ФРЭМД

documentNumber

Регистрационный номер документа внутри организации или подразделения

emdrId

Реестровый номер документа в ФРЭМД

Kind

Код вида документа

localUid

Уникальный идентификатор документа в РЭМД в формате UUID

organization

Код мед. организации, подписью которой подписан документ

patientLocalId

Идентификатор пациента в МИС

patientSnils

СНИЛС пациента

pageNumber

Номер страницы с результатами поиска (0 - первая страница)

pageSize

Количество записей на странице с результатами (1 - одна запись на странице)

searchInFremd

Признак необходимости поиска в ФРЭМД

securityToken

Токен безопасности МО

 

Пример запроса :

GET https://medved-webservices.hostco.ru/emds/rest/v1 / documents?creationDate=2016-01-09&patientSnils=13579129578&pageNumber=0&pageSize=10

 

Сведения , приходящие из ФРЭМД , такие как « emdrId », «storeTillDate», «registrationDate», «registrationWarnings», «errors», обновляются после получения асинхронного ответа . Время получения ответа из ФРЭМД не регламентировано .

 

HTTP статусы :

Status

Описание

Содержимое

200

Успешная операция

В ответе возвращается JSON в формате Page«ClinicalDocumentMetadata» (см. п.   В.11 )

400

Ошибка входящих параметров

В ответе возвращается массив JSON типа Error с описанием ошибок

404

Документы по заданным параметрам не найдены

В ответе возвращается массив JSON типа Error с описанием ошибок

500

Внутренняя ошибка сервера

 

Пример успешного ответа по зарегистрированному ЭМД в ФРЭМД:

{

    "status": "success",

    "errors": null,

    "first": true,

    "last": true,

    "number": 0,

    "numberOfElements": 10,

    "size": 10,

    "content": [{

        "localUid": "0713d028-4510-455e-ae5c-d9a478d29d33",

        "kind": {

            "code": "6",

            "codeSystem": "1.2.643.5.1.13.13.11.1520",

            "codeSystemName": null,

            "codeSystemVersion": null,

            "displayName": null

        },

        "system": " emdr-rmis-62",

        "organization": {

            "code": "1.2.643.5.1.13.13.12.2.86.8954",

            "codeSystem": null,

            "codeSystemName": null,

            " codeSystemVersion ": null ,

            "displayName": "БУ «Сургутская клиническая травматологическая больница»"

        },

        "department": {

            "localId": {

                "code": "1.2.643.5.1.13.13.12.2.86.8954.0.160179",

                "codeSystem": null,

                "codeSystemName": null,

                "codeSystemVersion": null,

                "displayName": null

            },

            "name": "Отделение травматологии и ортопедии №1"

        },

        "documentNumber": "emdr_doc_12",

        "creationDate": "2020-10-16",

        "creationDateTime": "2020-10-16T11:26:49.947+05:00",

        "recipient": {

            "kind": {

                "code": "PATIENT",

                "codeSystem": "1.2.643.5.1.13.13.99.2.123",

                "codeSystemName": null,

                "codeSystemVersion": null,

                "displayName": null

             },

            "snils": "96155474337"        

         },

        "patient": {

            "surname": " Кулишов ",

            "name": " Виктор ",

            "patrName": " Степанович ",

            "birthDate": "1968-02-07",

            "gender": {

                "code": "1",

                "codeSystem": "1.2.643.5.1.13.13.11.1040",

                "codeSystemName": null,

                "codeSystemVersion": "2.1",

                "displayName": " Мужской "

            },

            "localId": "L18DXZ9JDWERRDHO",

            "snils": "13579129587",

            "enp": "1216546556465417",

            "otherId": null

        },

        "assistance": null,

        "medicalCase": null,

        "caseResult": null,

        "recipient": null,

        "description": " Протокол консультации ",

        "replace": null,

        "reasonForAbsenceIdcase": {

            "code": null,

            "codeSystem": null,

            "codeSystemName": null,

            "codeSystemVersion": null,

            "displayName": null

        },

        "emdrId": "86.20.404.0214336089",

        "documentVersion": null,

        "registrationDate": "2020-10-16T00:00:00.000+03:00",

        "registrationDateTime": "2020-10-16T16:26:49.947+05:00",

        "storeTillDate": "2044-11-29",

        "status": "success",

        "id": null,

  "idcase": "1cc76e8d-60d2-4a98-8369-7550547f0946"

        "messageId": "821de0a9-1ea7-4fa7-89ee-d4775516493c",

        "registrationWarnings": null,

        "errors": null,

        "personalSignatures": [{

            "signer": {

                "localId": "1",

                "role": {

                    "code": "CHAIRMAN"

                },

                "surname": " СОРОКИН ",

                "name": " СЕРГЕЙ ",

                "patrName": " БОРИСОВИЧ ",

                "birthDate": "1970-09-03",

                "snils": "13537703761",

                "position": {

                    "code": "7",

                    "codeSystem": null,

                   "codeSystemName": null,

                   "codeSystemVersion": null,

                   "displayName": null

                },

               "speciality": {

                    "code": "118",

                    "codeSystem": null,

                    "codeSystemName": null,

                    "codeSystemVersion": null,

                    "displayName": null

                },

                "email": "mail@gmail.com",

                "phone": "9274413322",

                "department": {

                    "localId": {

                        "code": "1.2.643.5.1.13.13.12.2.86.8954.0.201943",

                        "codeSystem": null,

                        "codeSystemName": null,

                        "codeSystemVersion": null,

                        "displayName": null

                    },

                    "name": null

                }

            },

            "office": {

                "code": "1.2.643.5.1.13.13.12.2.86.8954.0.201943.43971",

                "codeSystem": null,

                "codeSystemName": null,

                "codeSystemVersion": null,

                "displayName": null

            },

            "description": " Заведующий ",

            "signature": {

                "data": null,

                "checksum": 1518900519

            }

        }],

        "regRegistrationDateTime": "2020-10-16T15:26:49.947+00:00"

    }]

}

Пример ответа с ошибкой по документу :

{

"status": "success",

"errors": null,

"first": true,

"last": true,

"number": 0,

"numberOfElements": 1,

"size": 5,

"content": [{

"localUid": "56a806cf-857d-45d9-9241-b19493d31220",

"kind": {

"code": "6",

"codeSystem": "1.2.643.5.1.13.13.11.1520",

"codeSystemName": null,

"codeSystemVersion": null,

"displayName": null

},

"system": "emdr-rmis-62",

"organization": {

"code": "1.2.643.5.1.13.13.12.2.86.8954",

"codeSystem": null,

"codeSystemName": null,

" codeSystemVersion ": null ,

"displayName": "БУ «Сургутская клиническая травматологическая больница»"

},

"department": {

"localId": {

"code": "1.2.643.5.1.13.13.12.2.86.8954.0.160179",

"codeSystem": null,

"codeSystemName": null,

"codeSystemVersion": null,

"displayName": null

},

"name": "Отделение травматологии и ортопедии №1"

},

"documentNumber": "emdr_doc_12",

"creationDate": "2020-12-20",

"creationDateTime": "2020-12-20T13:34:55.894+05:00",

"patient": {

"surname": " Кулишев ",

"name": " Виктор ",

"patrName": " Степанович ",

"birthDate": "1968-02-07",

"gender": {

"code": "1",

"codeSystem": null,

"codeSystemName": null,

"codeSystemVersion": null,

"displayName": " Мужской "

},

"localId": "L18DXZ9JDWERRDHO",

"snils": "13579129587",

"enp": "4729856438593026",

"otherId": null

},

"assistance": null,

"medicalCase": null,

"caseResult": null,

"recipient": null,

"description": " Протокол консультации ",

"replace": null,

"reasonForAbsenceIdcase": {

"code": null,

"codeSystem": null,

"codeSystemName": null,

"codeSystemVersion": null,

"displayName": null

},

"emdrId": null,

"documentVersion": null,

"registrationDate": null,

"registrationDateTime": null,

"storeTillDate": null,

"status": "error",

"id": null,

"messageId": "cd4267d8-e7d0-4b33-a394-8e3335fed2f1",

"errors": [{

"code": "DOC_DATE_MISMATCH_CERT_NOT_BEFORE",

"message": "Сертификат сотрудника не действителен на дату создания документа. ЭП сотрудника с индексом [0]"

}],

"personalSignatures": [{

"signer": {

"localId": "1",

"role": {

"code": "CHAIRMAN"

},

"surname": " СОРОКИН ",

"name": " СЕРГЕЙ ",

"patrName": " БОРИСОВИЧ ",

"birthDate": "1970-09-03",

"snils": "13537703761",

"position": {

"code": "7",

"codeSystem": null,

"codeSystemName": null,

"codeSystemVersion": null,

"displayName": null

},

"speciality": {

"code": "118",

"codeSystem": null,

"codeSystemName": null,

"codeSystemVersion": null,

"displayName": null

},

"email": "mail@gmail.com",

"phone": "9274413322",

"department": {

"localId": {

"code": "1.2.643.5.1.13.13.12.2.86.8954.0.201943",

"codeSystem": null,

"codeSystemName": null,

"codeSystemVersion": null,

"displayName": null

},

"name": null

}

},

"office": {

"code": "1.2.643.5.1.13.13.12.2.86.8954.0.201943.43971",

"codeSystem": null,

"codeSystemName": null,

"codeSystemVersion": null,

"displayName": null

},

"description": " Заведующий ",

"signature": {

"data": null,

"checksum": 2598857738

}

}],

"regRegistrationDate Time ": "2020-12-20T20:26:49.947+00:00"

}]

}

 

В случае получения ответа с ошибкой следует руководствоваться информацией блока "{ content , errors }" , после устранения ошибки повторить отправку исправленного документа с новым localUid.

Описание некоторых ошибок и действия по их устранению приведены в Приложении В.9 настоящего Регламента.

В.6                      Запрос «Получить файл ЭМД запрашивающей РМИС/МИС из архива предоставляющей РМИС/МИС»

Данный метод предназначен для запроса файла ЭМД, зарегистрированного в сторонней ИС через ФРЭМД.

РМИС/МИС посредством данного запроса может получить файл ЭМД из архива другой РМИС/МИС.

GET {context}/documents /{ messageId }/{emdrId}/demand-content ?{ securityToken }

Параметры

Параметр

Назначение

emdrId

Реестровый номер документа в ФРЭМД.

Для получения данного номера необходимо осуществить запрос данных методом GET { context }/ documents из пункта В.4 указав при это признак необходимости поиска данных в ФРЭМД -  searchInFremd = ‘true’. В полученном ответе необходимый идентификатор содержится в элементе – emdrId.

grantingEmdrId

Идентификатор документа, к которому ИС имеет доступ, связанного с запрашиваемым.

Указывается в том случае, когда нет явного разрешения на получение документа, но есть разрешение на связанный

messageId

Идентификатор запроса

securityToken

Токен безопасности МО

SendAdress

Адрес для отправки тела ЭМД методом « POST / documents / document - file ». Данный параметр передается в header запроса.

 

Пример запроса:

http://t-ovis-emdap-0.hostco.ru:8083/emds/reg/rest/api/v1 /documents/0dee65b3-a693-40d8-bd13-9d357f223d61/31.20.2727.000024345/demand-content?securityToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxLjIuNjQzLjUuMS4xMy4xMy4xMi4yLjg2Ljg5MDIiLCJpYXQiOjE1NjY4NjQwMDAsImV4cCI6MTU3NzgzNjc5OSwibWNvZGUiOiIyMTEyNiJ9.Mo2yoJ9q2QundwZjv9A_ppPgdFUbb6FlgWUjVa3XGFE

HTTP статусы:

Status

Описание

Содержимое

20 2

Успешная операция

В ответе возвращается JSON содержащий в себе статус обработки операции и идентификатор запроса

400

Нет разрешения на получения файла

 

500

Внутренняя ошибка сервера

 

Пример успешного ответа:

{

  "status": "success",

  "result": null,

  "errors": null,

  "page": null,

  "id": "0ea000b0-dba3-4a60-8e5a-21240a67ec5f",

  "messageId": null

}

 

Передача ЭМД, запрошенного РМИС\МИС из электронного архива предоставляющей РМИС\МИС

POST /documents ​​ /document-file

Пример запроса :

 

{

"relatesToMessage ":" c9fda61a-624c-11e8-9a30-005056b1747f "  

"file":{

      "data":"JVBERi0xLjQNJeLjz9MNCjEgMCBvYmoNPDwvTGFuZyj+/w…"

      "checksum":1146562825

   },

   "errors":null,

   "status":"success"

}

В.7                      Запрос «Получить метаописание ЭМД в РЭМД»

Запрос

GET {context}/ documents/metadata ?{emdrId}&{grantingEmdrId}&{securityToken}

Параметры :

Параметр

Назначение

X-medOrgOid

Организация, от имени которой выполняется запрос.

Указывается для поиска документов в ФРЭМД, опубликованных другими РМИС

emdrId

Реестровый номер документа в ФРЭМД

grantingEmdrId

Идентификатор документа, к которому ИС имеет доступ, связанного с запрашиваемым.

Указывается в том случае, когда нет явного разрешения на получение документа, но есть разрешение на связанный

securityToken

Токен безопасности МО

 

Пример запроса:

http://t-ovis-emdap-0.hostco.ru:8083/emds/reg/rest/api/v1 /documents/ metadata ?emdrId=31.19.287.000003263&grantingEmdrId=31.19.287.000002650&securityToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxLjIuNjQzLjUuMS4xMy4xMy4xMi4yLjg2Ljg5MDIiLCJpYXQiOjE1NjY4NjQwMDAsImV4cCI6MTU3NzgzNjc5OSwibWNvZGUiOiIyMTEyNiJ9.Mo2yoJ9q2QundwZjv9A_ppPgdFUbb6FlgWUjVa3XGFE

HTTP статусы :

Status

Описание

Содержимое

200

Успешная операция

В ответе возвращается JSON с метаописанием документа в РЭМД

400

Документ с идентификатором { emdrid } не найден

 

500

Внутренняя ошибка сервера

 

Пример успешного ответа:

{

  "status": "success",

  "errors": null,

  "metadata": {

    "creationDate": "2019-10-05",

    "creationDateTime": "2019-10-05T09:26:49.947+03:00",

    "storeTillDate": "2044-10-05",

    "registrationDate": "2020-04-27T00:00:00.000+03:00",

    "registrationDateTime": "2020-04-27T14:50:21.131+03:00",

    "documentVersion": null,

    "kind": {

      "code": "6",

      "codeSystem": "1.2.643.5.1.13.13.11.1520",

      "codeSystemName": null,

      "codeSystemVersion": null,

      "displayName": null

    },

    "region": "86",

    "organization": {

      "code": " 1.2.643.5.1.13.13.12.2.86.8954",

      "codeSystem": null,

      "codeSystemName": null,

      "codeSystemVersion": null,

      "displayName": null

    },

    "department": null,

    "documentNumber": "emdr_doc_8",

    "patientSnils": "13579129587",

    "patientLocalId": "2af1f9cb-0c4b-46de-8a05-ea6fb2b097b3",

    "assistance": null,

    "description": " Протокол консультации ",

    "signer": [

      {

        "localId": null,

        "role": {

          "code": "DOCTOR",

          "codeSystem": null,

          "codeSystemName": null,

          "codeSystemVersion": null,

          "displayName": null

        },

        "surname": " Колташева ",

        "name": " Александра ",

        "patrName": " Сергеевна ",

        "birthDate": null,

        "snils": "16067057157",

        "position": {

          "code": "7",

          "codeSystem": null,

          "codeSystemName": null,

          "codeSystemVersion": null,

          "displayName": null

        },

        "speciality": {

          "code": "1",

          "codeSystem": null,

          "codeSystemName": null,

          "codeSystemVersion": null,

          "displayName": null

        },

        "email": null,

        "phone": null,

        "department": {

            "localId": {

                "code": "1.2.643.5.1.13.13.12.2.86.8954.0.160179",

                "codeSystem": null,

                "codeSystemName": null,

                "codeSystemVersion": null,

                " displayName ": null

            },

            " name ": "Отделение травматологии и ортопедии №1"

        },

        "office": null

      }

    ],

    "contentType": "1",

    "pluggableAttributes": null,

    "associations": [],

    "recipient": null

 

  }

}

В.8                      Запрос «Получить подписанное содержимое ЭМД»

Запрос

GET {context}/documents/{id}/signed-content?{ securityToken }

{ id }   — Уникальный идентификатор документа ( UUID ) в РРЭМД.

Пример запроса:

GET https://medved-webservices.hostco.ru/emds/rest/v1 / documents/09a06d38-6c06-4223-9aa3-10d0779a58ae/signed-content? securityToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxLjIuNjQzLjUuMS4xMy4xMy4xMi4yLjg2Ljg5MDIiLCJpYXQiOjE1NjY4NjQwMDAsImV4cCI6MTU3NzgzNjc5OSwibWNvZGUiOiIyMTEyNiJ9.Mo2yoJ9q2QundwZjv9A_ppPgdFUbb6FlgWUjVa3XGFE

Ответ

HTTP статусы :

Status

Описание

Содержимое

200

Успешная операция

В ответе возвращается JSON в формате SignedContent (см. п.   В.11 ) с содержимым документа и (если имеются) подписями к нему

404

Документ с идентификатором {id} не найден

 

500

Внутренняя ошибка сервера

 

Пример успешного ответа (строки формата base64 в примере сокращены):

{

   " docContent ": {

      " data ": " JVBERi 0 xLjQNJeLjz 9 MNCjEgMCBvYmoNPDwvTGFuZyj +…",

      " checksum ": 1146562825

   },

   " orgSignature ": {

      " data ": " MIIOJgYJKoZIhvcNAQcCoIIOFzCCDhMCAQExDDAKBgYqhQMCAgk …",

      " checksum ": 4269510922

   },

   " personalSignatures ": [

      {

         " signer ": {

            "localId": "2",

            "role": {"code": " DOCTOR "},

            "surname": " КОЛТАШЕВА ",

            "name": " АЛЕКСАНДРА ",

            "patrName": " СЕРГЕЕВНА ",

            "birthDate": "1987-10-26",

            "snils": "16067057157",

            "position": {"code": "7"},

            "speciality": {"code": "1"},

            "email": "mail2@gmail.com",

            "phone": "9274413322",

"department": {

"localId": {

"code": "1.2.643.5.1.13.13.12.2.86.8954.0.363445",

"codeSystem": null,

"codeSystemName": null,

"codeSystemVersion": null,

"displayName": null

},

" name ": "Офтальмологический кабинет"

}

},

" office ": {

" code ": "1.2.643.5.1.13.13.12.2.86.10450.0.363445.362295",

"codeSystem": null,

"codeSystemName": null,

"codeSystemVersion": null,

"displayName": null 

         },

         "signature": {

            "data": "JVBERi0xLjQNJeLjz9MNCjEgMCBvYmoNPDwvTGFuZyj+/…",

            "checksum": 2992475455

         },

         "description": "Зав. отделением"

      }]}


В.9                      Описание действий для устранения ошибок [1]

№ п/п

Ошибка

Причина и действия для устранения ошибки

 

На входе в РРЭМД

  1.  

Поле ''Регистрационный номер документа ({0})'' должно быть заполнено.

Не заполнено обязательное поле documentNumber.

  1.  

Документ с идентификатором '%' уже зарегистрирован.

В РЭМД не допускается создание документов с одинаковыми localUid . Необходимо убедиться, что документ ранее не отправлялся.

  1.  

Значение атрибута ''{0}'' должно быть заполнено.

Необходимо заполнить данными указанный в тексте ошибки обязательный для передачи ЭМД атрибут.

  1.  

Дата создания документа {%} не должна превышать текущую дату.

Необходимо проверить и исправить указанную в поле crea tionDate дату. Она не должна превышать дату отправки документа.

  1.  

Дата создания документа {%} не входит в разрешенный период {%} мес. до текущей даты.

Необходимо проверить и исправить указанную в поле crea tionDate дату.
Она не должна выходить за рамки периода указанного в тексте ошибки.

  1.  

Дата создания документа должна быть заполнена.

Не заполнено обязательное поле crea tionDate .

  1.  

Структурное подразделение, в котором числится сотрудник, подписавший документ, должно быть заполнено.

Не заполнено обязательное поле department в данных о сотруднике подписавшем документ.

  1.  

EMDS-0030 - Invalid content was found starting with element 'author'.

Закодированное содержимое документа не соответствует схеме xsd данного типа документа.

  1.  

Ошибка кодирования: Элемент ''{0}''. Символы строки не соответствуют кодировке Base64 : ''{1}''.

В указанном в тексте ошибки элементе содержимое не закодировано в 64 – разрядный код ( Base 64).

  1.  

Формат документа не соответствует PDF/A.

Закодированное содержимое документа не соответствует формату PDF/A соответствующему стандарту ISO 19005-1:2005.

  1.  

Отсутствует содержимое документа.

В запросе не прикреплено содержимое ЭМД в поле docContent.

  1.  

"EMDS-0061", "message": "Актуальная версия справочника с oid 1.2.643.5.1.13.13.11.1461 для проверки медицинской организации не найдена на дату создания документа 2020-05-01".

Необходимо проверить дату документа и удостовериться, что в справочнике 1.2.643.5.1.13.13.11.1461 имеется актуальная версия на дату документа.

  1.  

"EMDS-0061", - "Медицинская организация 1.2.643.5.1.13.13.12.2.31.2901 не зарегистрирована на дату создания документа 2020-05-01".

МО по справочнику 1.2.643.5.1.13.13.12.2.31.2901 не является действующей на дату создания документа.

  1.  

"EMDS-0061", - "message": "Ошибка при проверке корректности региона. Код региона из настроек ' 86 ' не соответствует коду региона МО, создавшей документ '31'"

Код региона из настроек не соответствует коду региона присланного документа по справочнику 1.2.643.5.1.13.13.11.1461.

  1.  

"EMDS-0061", - "message": "Медицинская организация 1.2.643.5.1.13.13.12.2.31.2901 не зарегистрирована на дату создания документа 2020-05-01 "

В справочнике 1.2.643.5.1.13.13.11.1461 закончился срок действия кода МО, либо МО отсутствует в справочнике.

  1.  

"EMDS-0022","message": "В соответствии со справочниками 1.2.643.5.1.13.13.99.2.42 и 1.2.643.5.1.13.13.99.2.368  для документов вида {0}  нет подписантов с ролью {1} на дату создания документа».

 

Необходимо проверить, что роль подписанта $.personalSignatures[n].signer.role.code является действующей по передаваемому виду документа на дату создания документа в соответствии со справочниками 1.2.643.5.1.13.13.99.2.42 и 1.2.643.5.1.13.13.99.2.368.

  1.  

Обязательны с указанием СНИЛС”. Отправка запроса без СНИЛС. - Ошибка "СНИЛС пациента в составе сведений о пациенте обязателен для данного вида документов.

Необходимо проверить по справочнику 1.2.643.5.1.13.13.11.1520 наличие заполненного СНИЛС у пациента по виду документа, для некоторых видов документа СНИЛС является обязательным.

  1.  

Неверный СНИЛС = '%%' (ошибка в вычислении контрольной суммы)

В поле $ patient . snils некорректно указан СНИС пациента.

  1.  

{

         " item ": "%%",

         " error ":          {

            " code ": null ,

            " message ": "Запрос не прошел проверку. Некорректное значение поля"

         }

      }

В item указано наименование поле из блока со сведениями о подписанте, в котором переданные данные не соответствуют данным содержащимся в ФРМР/ФРМО.

  1.  

Не найден токен безопасности медицинской организации

В параметре « securityToken » указан некорректный/несуществующий токен МО. Необходимо проверить корректность содержимого в данном параметре и повторно отправить запрос.

  1.  

Не найдена запись с идентификатором [%%]

Запись с указанным идентификатором отсутствует в системе.

  1.  

Данные пациента в запросе [%%] не соответствуют данным в РИП. Данные в запросе: [%%]. Данные в РИП: [%%]

В запросе указаны некорректные сведения о пациенте, необходимо их заменить и повторно отправить запрос на публикацию документа.

  1.  

Пациент с идентификатором '%%' отсутствует в системе РИП.

Перед отправкой запроса на публикацию ЭМД, необходимо зарегистрировать пациента в подсистеме РИП (отправив запрос к подсистеме).

  1.  

Указанное значение триггерной точки '%%' не найдено в справочнике 1.2.643.5.1.13.13.99.2.591.

В справочнике с OID 1.2.643.5.1.13.13.99.2.591 переданное значение в параметре $.triggerPoin t . code отсутствует. Необходимо указать в запросе код триггерной точки, имеющийся в актуальной версии справочника.

  1.  

Для триггерной точки '%%' и vmcl '%%' не предусмотрена отправка документа с кодом типа '%%'.

В протоколе информационного взаимодействия ВИМИС в разделе “Условия определения триггерных точек” прописано для каких кодов триггерных точек предполагается отправка определенных ЭМД. Необходимо при отправке запросов для документов, предназначенных для отправки в ВИМИС следовать данным указаниям.

 

На входе в ФРЭМД

  1.            

null, cvc-type.3.1.3: The value '' of element '%' is not valid. cvc-minLength-valid: Value '' with length = '0' is not facet-valid with respect to minLength '1' for type 'notEmptyString'.

Не заполнено обязательное поле, которое указанно в ошибке ( element '%').

  1.            

null, cvc-type.3.1.3: The value '%' of element '%' is not valid. cvc-length-valid: Value '% with length = '%' is not facet-valid with respect to length '16' for type '%'.

Длина указанного элемента ( element '%') не соответствует требованиям. ЕНП должен содержать 16 символов. Проверить корректность ввода данного поля.

  1.            

null, cvc-type.3.1.3: The value '%' of element '%' is not valid. cvc-pattern-valid: Value '%' is not facet-valid with respect to pattern '[0-9]+' for type '%'.

Значение не соответствует формату. Поле ( element '%') должно содержать только цифры.

  1.            

null, cvc-type.3.1.3: The value '%' of element '%' is not valid. cvc-enumeration-valid: Value '%' is not facet-valid with respect to enumeration '[%%]'. It must be a value from the enumeration.

Формат поля ( element '%') неверный. Проверить соответствие вводимых данных ожидаемым ( respect to enumeration '[%%]'). Также проверить версию справочника, если она указана.

  1.            

null, Документ с messageId = '%' уже существует в системе

В РЭМД не допускается создание документов с одинаковыми messageId. Необходимо убедиться, что документ ранее не отправлялся.

  1.            

ValidationError, Контрольная сумма файла ЭП МО не верна

Проверить соответствие подписей и контрольных сумм к ним.

  1.            

ValidationError, Медицинская организация с кодом [%] не найдена

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

  1.            

ValidationError, Организация [%] не привязана к РМИС [%]

Написать заявку на регистрацию МО в РМИС (см. раздел 4 )

  1.            

В ФРМР не найден сотрудник со СНИЛС [%]

Проверить корректность ввода СНИЛС. Если сотрудник отсутствует в ФРМР, добавить сотрудника в ФРМР.

  1.         

Указанная должность сотрудника не соответствует занимаемой им должности в организации [%] на дату создания документа [%] по данным ФРМР. Сотрудник с индексом [%]

Проверить корректность информации о сотруднике, введенной в запросе, данным в ФРМР

  1.         

Указанные данные сотрудника [%] не соответствуют данным ФРМР [%]. Сотрудник с индексом [%]

Проверить корректность информации о сотруднике, введенной в запросе, данным в ФРМР

  1.         

Дата создания документа не может быть больше даты регистрации

Проверить корректность указанных дат

  1.         

Документ с идентификатором '%' уже зарегистрирован

Ошибка возникла по техническим причинам, сведения о документе обновятся автоматически.

  1.         

На дату создания документа для указанного вида не предусмотрено подписание сотрудником с ролью [%] и должностью с кодом [%]

Проверить выполнение требований к подписи документа сотрудниками. Справочник «РЭМД. Правила подписи электронных медицинских документов» ( OID 1.2.643.5.1.13.13.99.2.42 ).

  1.         

На дату создания документа для указанного вида требуется как минимум 1 подпись роли [%]

Проверить выполнение требований к подписи документа сотрудниками. Справочник «РЭМД. Правила подписи электронных медицинских документов» ( OID 1.2.643.5.1.13.13.99.2.42 ).

  1.         

Наличие ЭП организации или сотрудника обязательно

Отсутствует подпись МО или сотрудника.

Справочник «РЭМД. Правила подписи электронных медицинских документов» ( OID 1.2.643.5.1.13.13.99.2.42 ).

  1.         

Набор содержит отличающиеся хеш-суммы по одинаковым алгоритмам

Проверить соответствие всех подписей документу.

Можно выполнить проверку на сайте https://www.gosuslugi.ru/pgu/eds/

Раздел проверки «— электронного документа. ЭП — отсоединенная, в формате PKCS#7»

  1.         

Не удалось построить цепочку сертификатов до Головного УЦ(сертификат организации выдан не аккредитованным УЦ или один из сертификатов цепочки не действителен)

Проверить подлинность сертификатов, а также соответствие подписей документу. Можно выполнить проверку на сайте https://www.gosuslugi.ru/pgu/eds/

Раздел проверки «— электронного документа. ЭП — отсоединенная, в формате PKCS#7»

  1.         

В сертификате отсутствует атрибут \%\""

Проверить корректность сертификата всех подписей документа. Можно на сайте https://www.gosuslugi.ru/pgu/eds/

  1.         

Несоответствие данных подписанта в запросе и в сертификате. % в метаданных и % в сертификате

Проверить соответствие введенных данных в запросе и данных подписей

  1.         

Ошибка декодирования ЭП MO: В подписи отсутствует атрибут [%].

Проверить соответствие введенных данных и прикрепленных подписей. Проверить подлинность сертификатов.

  1.         

Сертификат МО не действителен на дату создания документа

Проверить подлинность сертификата МО и срок действия

  1.         

Срок действия сертификата организации истек или еще не наступил

Проверить подлинность сертификата МО и срок действия

  1.         

Сертификат сотрудника не действителен на дату создания документа. ЭП сотрудника с индексом [%]

Проверить подлинность сертификатов сотрудников и срок действия

  1.         

Срок действия сертификата сотрудника истек или еще не наступил. Индекс сотрудника [%]

Проверить подлинность сертификатов сотрудников и срок действия

  1.         

ЭП МО не верна: %

Проверить подлинность сертификата МО и срок действия

  1.         

ЭП МО обязательна для данного вида документа

Проверить наличие подписи МО в запросе

  1.         

ЭП сотрудника не верна. Индекс [%]: %

Проверить подлинность сертификатов и срок действия


В.10                 Используемые классификаторы

В целях плавного перехода от одной версии справочника к другой, предоставлена возможность, чтобы в течение переходного периода разные поставщики информации кодировали данные с использованием справочников с разными версиями. Для точного определения версии справочника, используемой при передаче данных, поставщик должен указать идентификатор справочника и его версию. Если идентификатор справочника и его версия не указаны, то считается, что данные, переданные в РРЭМД, закодированы с использованием справочника по умолчанию. В качестве идентификатора справочника по умолчанию используется его OID .

Перечень справочников, используемых при передаче данных

Название классификатора

OID справочника (идентификатор по умолчанию)

 

 

Медицинские организации

1.2.643.5.1.13.13.11.1461

Подразделения медицинских организаций

1.2.643.5.1.13.13.99.2.114

Должности медицинского персонала

1.2.643.5.1.13.13.99.2.181

Номенклатура специальностей в сфере здравоохранения

1.2.643.5.1.13.13.11.1066

Типы ДУЛ

1.2.643.5.1.13.13.99.2.320

Пол пациента

1.2.643.5.1.13.13.11.1040

Виды медицинских документов

1.2.643.5.1.13.13.11.1520

Отделения и кабинеты медицинских организаций

1.2.643.5.1.13.13.99.2.115

Справочник ролей сотрудников при подписи электронных медицинских документов

1.2.643.5.1.13.13.99.2.368

РЭМД. Правила подписи электронных медицинских документов

1.2.643.5.1.13.13.99.2.42

РЭМД. Типы получателей медицинских документов

1.2.643.5.1.13.13.99.2.123

ВИМИС. Триггерные точки для передачи данных

1.2.643.5.1.13.13.99.2.591

ВИМИС. Типы структурированных медицинских сведений

1.2.643.5.1.13.13.99.2.592

Виды медицинской документации

1.2.643.5.1.13.13.11.1522

 

Все используемые при взаимодействии классификаторы доступны через веб-сервис региональной НСИ. Описание и адрес сервиса региональной НСИ представлены в отдельном Регламенте.


В.11                 API сервиса

Описание Rest API сервиса в формате OpenAPI:

Для удобства просмотра документа можно использовать swagger editor https://swagger.io/tools/swagger-editor/

Пояснения

Значения множественности отметки:

  • 1..1 – поле обязательно для заполнения;
  • 1..n – поле обязательно для заполнения. Может иметь несколько значений;
  • 0..1 – поле обязательно для заполнения, если имеются данные. Может иметь только одно значение. В некоторых случаях может передаваться пустое поле. Например, patrName – может быть пустым при отсутствии отчества у пациента или сотрудника;
  • 0..n – поле обязательно для заполнения, если имеются данные. Может иметь несколько значений. В некоторых случаях может передаваться пустое поле. Например, associations[] – может быть пустым при отсутствии связанных с регистрируемым документов, также может иметь несколько значений.

Объект

Свойства

Тип

Множественность

Описание

Association

 

 

 

 

 

target

string

0..1

Идентификатор ФРЭМД связанной записи регистра

 

localUid

string

0..1

Локальный идентификатор связанной записи регистра

 

type

string

1..1

Тип связи с документом. Один из вариантов:

RELATES_TO

INCLUDED_IN

INCLUDES

BinaryData

 

 

 

Данные в base64 и относящаяся к ним контрольная сумма

 

data

byte

1..1

Данные в base64

 

checksum

integer

1..1

Контрольная сумма для передаваемых данных, вычисленная по алгоритму CRC32 (в десятичном представлении)

ClinicalDocument

 

 

 

 

 

Все свойства из

ClinicalDocumentMisMetadata

и

SignedContent

, а также следующие свойства:

 

1..1

 

 

pluggableAttributes

(не используется)

0..1

Дополнительные атрибуты

 

associations[]

Association

0..n

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

 

hasToBeSentToEmdfr

boolean

0..1

Признак необходимости выгрузки метаданных документа в ФРЭМД

ClinicalDocumentMetadata

 

 

 

Свойства ЭМД

 

Все свойства из

ClinicalDocumentMisMetadata

и

ClinicalDocumentEmdrMetadata

 

1..1

 

ClinicalDocumentEmdrMetadata

 

 

 

Свойства ЭМД согласно ФРЭМД

 

emdrId

string

0..1

Номер в ФРЭМД

 

registrationDate

string

0..1

Дата регистрации в ФРЭМД

 

storeTillDate

string

0..1

Срок хранения

 

documentVersion

integer

0..1

Номер версии

 

registrationWarnings

RegistrationWarning

0.. n

Список замечаний

 

status

string

0..1

Статус выгрузки в ФРЭМД. Один из вариантов:

success

error

 

errors

Error

0.. n

ошибки обработки ЭМД в ФРЭМД

ClinicalDocumentMisMetadata

 

 

 

Свойства ЭМД согласно МИС

 

localUid

string

1..1

Уникальный идентификатор документа в РМИС в формате UUID

 

kind

CodedData

1..1

Вид документа, значение OID из справочника 1.2.643.5.1.13.13.11.1520 или из регионального справочника remd 0001

 

messageId

string

0..1

Идентификатор запроса. Обязателен для получения уведомлений в МИС.

 

vmcl

number

0..1

Направление оказания мед. помощи. Для документов, предназначенных для отправки в ВИМИС данное поле обязательно.

 

triggerPoint

CodedData

0..1

Триггерная точка для передачи данных из справочника 1.2.643.5.1.13.13.99.2.591. Для документов, предназначенных для отправки в ВИМИС данное поле обязательно.

 

vimisDocType

number

0..1

Тип отправляемого в запросе документа. Для документов, предназначенных для отправки в ВИМИС данное поле обязательно.

 

vimisDocTypeVersion

number

0..1

Версия типа отправляемого в запросе документа. Для документов, предназначенных для отправки в ВИМИС данное поле обязательно.

 

system

string

0..1

Уникальный идентификатор МИС.

Если в мед. организации используется одна единственная МИС, то идентификатор формируется по шаблону:

mis -{ mcode }

, где { mcode }   OID МО из справочника 1.2.643.5.1.13.13.11.1461 .

 

Иначе следует согласовать идентификатор МИС с оператором РРЭМД.

Если одна и та же МИС обслуживает несколько медорганизаций, то допустимо использовать один и тот же идентификатор МИС для всех документов передаваемых из этой МИС

 

organization

CodedData

1..1

Медицинская организация – OID МО из справочника 1.2.643.5.1.13.13.11.1461.

 

department

Department

1..1

OID структурного подразделения, в котором зарегистрирован ЭМД из справочника 1.2.643.5.1.13.13.99.2.114

 

documentNumber

string

1..1

Номер документа в МИС

 

creationDate

string

0 ..1

Дата создания документа

 

creationDateTime

string

1..1

Дата и время создания документа

 

Patient

Patient

1..1

Пациент

 

Assistance

(не используется)

0..1

Дополнительные сведения об ЭМД

 

medicalCase

(не используется)

0..1

Сведения о лечении

 

caseResult

(не используется)

0..1

Результат лечения

 

recipient

documentRecipient

0..1

Сведения о получателе документа. Заполняется при выдаче бумажной копии.

 

description

string

1..1

Краткое произвольное описание документа

 

replace

DocumentIdentifier

0..1

Заменяемый документ

CodedData

 

 

 

Запись справочника

 

code

string

1 ..1

Идентификатор записи в справочнике

 

codeSystem

string

1..1

Идентификатор справочника

Если указывается codeSystemVersion, то заполнение codeSystem обязательно

 

codeSystemName

string

0..1

Название справочника

 

codeSystemVersion

string

0..1

Версия справочника

Если версия не указана, то используется версия справочника по умолчанию. См. См классификаторы НСИ, используемые в РРЭМД.

Если указывается codeSystem, то заполнение codeSystemVersion обязательно

 

displayName

string

0..1

Текстовое содержимое записи

Department

 

 

 

Структурное подразделение из справочника 1.2.643.5.1.13.13.99.2.114

 

localId

CodedData

1 ..1

OID структурного подразделения

 

name

string

1..1

Наименование

DocumentIdentifier

 

 

 

Заменяемый документ

 

root

string

0..1

Идентификатор ФРЭМД заменяемой записи регистра

 

version

integer

0..1

Заменяемая версия документа (если явно не указано, то заменяемая версия - 1)

documentRecipient

 

 

 

 

 

kind

CodedData

1 ..1

Код типа получателя согласно справочнику «РЭМД. Типы получателей медицинских документов», OID 1.2.643.5.1.13.13.99.2.123

 

recipientKindPerson

recipientKindPerson

0..1

Получатель документа физическое лицо

 

recipientKindMedicalOrganization

recipientKindMedicalOrganization

0..1

Получатель документа медицинская организация

 

recipientKindOrganization

recipientKindOrganization

0..1

Получатель документа не медицинская организация

recipientKindPerson

 

 

 

 

 

snils

string

1..1

СНИЛС получателя, без дефисов и пробелов, (текст, 11 символов).

recipientKindMedicalOrganization

 

 

 

 

 

organization

CodedData

1..1

Медицинская организация – OID МО из справочника 1.2.643.5.1.13.13.11.1461.

recipientKindOrganization

 

 

 

 

 

ogrn

string

1..1

ОГРН организации

 

kpp

string

1..1

КПП организации

Error

 

 

 

Описание ошибки

 

code

string

0..1

Код ошибки

 

message

string

0..1

Описание

Page«ClinicalDocumentMetadata»

 

 

 

 

 

first

boolean

0..1

является ли страница первой

 

last

boolean

0..1

является ли страница последней

 

number

integer

0..1

Номер страницы с результатами поиска (0 - первая страница)

 

numberOfElements

integer

0..1

Количество записей на странице с результатами

 

size

integer

0..1

Размерность страницы

 

content

ClinicalDocumentMetadata

0..n

Метаданные найденных документов

Patient

 

 

 

Сведения о пациенте

 

surname

string

1..1

Фамилия пациента

 

name

string

1..1

Имя пациента

 

patrName

string

0..1

Отчество пациента

 

birthDate

string

1..1

Дата рождения пациента

 

gender

CodedData

1..1

Пол пациента, код из справочника 1.2.643.5.1.13.13.11.1040

 

localId

string

1 ..1

Идентификатор пациента

 

snils

string

0..1

СНИЛС пациента, без дефисов и пробелов, (текст, 11 символов). Поле обязательное при публикации документов из регионального справочника типа справок – remd 0001.

 

enp

string

0..1

ЕНП

 

otherId

PatientOtherId

0..1

ДУЛ

PatientOtherId

 

 

 

 

 

type

CodedData

1..1

Тип ДУЛ, Уникальный идентификатор из справочника 1.2.643.5.1.13.13.99.2.320

 

number

string

1..1

Номер документа

PersonalSignature

 

 

 

ЭП физического лица и сведения о владельце

 

signer

Signer

1..1

Сведения о владельце подписи

 

signature

BinaryData

1..1

ЭП и относящаяся к ней контрольная сумма

 

description

string

0..1

Краткое произвольное описание подписи

 

Id

string

0..1

Вспомогательный идентификатор подписи (для различения между собой подписей, относящихся к одному и тому же документу)

RegistrationWarning

 

 

 

 

 

Code

string

0..1

Код замечания

 

Message

string

0..1

Детализация

Signer

 

 

 

Сведения о владельце подписи

 

localId

string

0..1

Уникальный идентификатор сотрудника в МИС

 

Role

CodedData

1..1

Роль подписанта, значение CODE _ ROLE из справочника 1.2.643.5.1.13.13.99.2.368

 

surname

string

0..1

Фамилия сотрудника

 

Name

string

0..1

Имя сотрудника

 

patrName

string

0..1

Отчество сотрудника

 

birthDate

string

0..1

Дата рождения сотрудника в формате YYYY-MM-DD

 

Snils

string

1..1

СНИЛС подписанта, без дефисов и пробелов, (текст, 11 символов)

 

Position

CodedData

1..1

Должность подписанта, код (поле в справочнике ‘ table_field_id’ ) из справочника 1.2.643.5.1.13.13.99.2.181

 

speciality

CodedData

0..1

Специальность подписанта, код (поле в справочнике ‘ table_field_ ID ) из справочника 1.2.643.5.1.13.13.11.1066

 

Email

string

0..1

Адрес электронной почты

 

Phone

string

0..1

Телефон сотрудника

 

department

Department

0 ..1

OID структурного подразделения, в котором числится сотрудник из справочника 1.2.643.5.1.13.13.99.2.114

 

Office

CodedData

0..1

OID Кабинета/отделения , в котором числится сотрудник из справочника 1.2.643.5.1.13.13.99.2.115

SignedContent

 

 

 

 

 

docContent

BinaryData

0..1

Содержимое электронного документа

 

orgSignature

BinaryData

0..1

ЭП МО, которой подписан документ

 

personalSignatures

PersonalSignature

0..n

ЭП сотрудников, которыми подписан документ

 


В.12                 Методика тестирования сервиса

а)              Удостовериться в сетевой доступности сервиса, взаимодействие с которым тестируется.

б)              Отправить медицинский документ согласно п.   В.3 . Получить ответ об успешной регистрации ( HTTP Status 200 или 201).

в)              Отправить запрос на получение содержимого документа согласно п.   В.6 . Получить ответ с содержимым документа ( HTTP Status 200).


История версий документа

Дата

Версия

Описание изменений

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 


Составили

Наименование организации

Должность исполнителя

Фамилия, имя, отчество

ГК «ХОСТ»

Менеджер проекта

Килина А. С.

ГК «ХОСТ»

Аналитик

Колтыш С. И.

 


[1] Символ «%» означает любую последовательность символов