Интеграция с ЕГИСЗ (КУС) — различия между версиями

Материал из КинтВики
Перейти к: навигация, поиск
(Отправка документов)
(N3.Health)
 
(не показано 9 промежуточных версий этого же участника)
Строка 23: Строка 23:
  
 
Для подключения к сервису ЕГИСЗ укажите:
 
Для подключения к сервису ЕГИСЗ укажите:
# Адрес Сервиса — адрес сервиса ЕГИСЗ, на который будет осуществляться отправка файлов.
+
# Адрес сервиса — адрес сервиса ЕГИСЗ, на который будет осуществляться отправка файлов.
# Адрес Публикации http-сервиса — адрес опубликованного http-сервиса ЕГИСЗ, имеет вид http://site.com/sanatory/hs/KintEGISZ/EmdrCallback.
+
# Адрес публикации http-сервиса — адрес [[1С8:Публикация информационной базы 1С на веб-сервере#Публикация базы без авторизации|опубликованного http-сервиса]] конфигурации «Кинт: Управление санаторием» KintEGISZ для приема запросов от внешнего сервиса. Имеет вид: https://АДРЕС_СЕРВЕРА/ИМЯ_БАЗЫ/hs/KintEGISZ/ххх. Публикация выполняется с использованием ssl.
 
# Идентификатор ИС в ИПС — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в подсистеме интеграции прикладных систем (ИПС). Значение идентификатора имеет вид: fbd33aa5-5b3a-4586-b01a-9896ef4ce2fe.
 
# Идентификатор ИС в ИПС — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в подсистеме интеграции прикладных систем (ИПС). Значение идентификатора имеет вид: fbd33aa5-5b3a-4586-b01a-9896ef4ce2fe.
 
# Идентификатор ИС РЭМД — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в реестре электронных медицинских документов (РЭМД). Значение идентификатора имеет вид: emdr-rmis-11.
 
# Идентификатор ИС РЭМД — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в реестре электронных медицинских документов (РЭМД). Значение идентификатора имеет вид: emdr-rmis-11.
# Каталог GhostScript — путь к каталогу установленного ПО для шифрованию PDF-документов.
+
# Каталог GhostScript — путь к каталогу установленного ПО для шифрования PDF-документов.
# Режим отладки — включается при тестировании при первом запуске, отключает проверку сертификатов.
+
# Режим отладки — отключает проверку регистрации сертификатов электронной подписи в ЕГИСЗ. Используется для отправки запросов в тестовую среду РЭМД.
 +
Адрес сервиса ЕГИСЗ и идентификаторы ИС в ИПС и РЭМД предоставляется службой технической поддержки ЕГИСЗ по заявке на регистрацию и подключение информационной системы.
 +
 
 
После заполнения данных доступа нажмите кнопку '''''Записать и закрыть'''''.
 
После заполнения данных доступа нажмите кнопку '''''Записать и закрыть'''''.
  
Строка 45: Строка 47:
  
 
После заполнения данных доступа нажмите кнопку '''''Записать и закрыть'''''.
 
После заполнения данных доступа нажмите кнопку '''''Записать и закрыть'''''.
 
+
{{notice|Работа с N3.Health требует использования OpenVPN. Конфигурационные файлы для OpenVPN находятся в личном кабинете N3.Health в разделе OpenVPN.}}
Работа с N3.Health требует использования OpenVPN. Конфигурационные файлы для OpenVPN находятся в личном кабинете N3.Health в разделе OpenVPN.
 
  
 
=== Настройки соответствия выгрузки мед. документов ===
 
=== Настройки соответствия выгрузки мед. документов ===
Строка 64: Строка 65:
 
# Если справочник уже содержит данные — вручную сопоставьте его элементы с элементами справочника Минздрава: для этого в карточке каждого элемента заполните реквизит «Код Минздрава».
 
# Если справочник уже содержит данные — вручную сопоставьте его элементы с элементами справочника Минздрава: для этого в карточке каждого элемента заполните реквизит «Код Минздрава».
 
# Если справочник заполнен частично — сопоставьте его элементы с элементами справочника Минздрава и выполните выборочную загрузку недостающих элементов.
 
# Если справочник заполнен частично — сопоставьте его элементы с элементами справочника Минздрава и выполните выборочную загрузку недостающих элементов.
Если в справочнике уже есть элемент с указанным кодом Минздрава, повторно загрузить элемент с таким же кодом нельзя.
+
Если в справочнике уже есть элемент с указанным кодом Минздрава, повторная загрузка элемента с таким же кодом невозможна.
 
: [[Файл:ЕГИСЗ Справочники по минздраву.png|720px]]
 
: [[Файл:ЕГИСЗ Справочники по минздраву.png|720px]]
 
Если справочники не заполнены или не содержат элементов с указанным кодом Минздрава, они будут подсвечиваться красным цветом.
 
Если справочники не заполнены или не содержат элементов с указанным кодом Минздрава, они будут подсвечиваться красным цветом.
Строка 89: Строка 90:
  
 
При наличии ошибок настройки отображается статус «Есть ошибки». Объекты, по которым выявлены ошибки (например, отсутствие или некорректное указание обязательных данных), подсвечиваются красным цветом и могут быть раскрыты для просмотра подробной информации по параметрам.
 
При наличии ошибок настройки отображается статус «Есть ошибки». Объекты, по которым выявлены ошибки (например, отсутствие или некорректное указание обязательных данных), подсвечиваются красным цветом и могут быть раскрыты для просмотра подробной информации по параметрам.
 +
 +
При активации опции «Отображать только ошибки» в чек-листе отображаются только те параметры, по которым необходимо внести исправления.
 
:[[Файл:Отправка данных в ЕГИСЗ (есть ошибки).png|800px]]
 
:[[Файл:Отправка данных в ЕГИСЗ (есть ошибки).png|800px]]
  
 
== Использование расширения (до релиза 25.08) ==
 
== Использование расширения (до релиза 25.08) ==
  
В версиях программы до релиза 25.08 для интеграции с ЕГИСЗ требовалась установка расширения.
+
В версиях программы «Кинт: Управление санаторием» до релиза 25.08 для интеграции с ЕГИСЗ требовалось [[Инструкция по установке расширений|установить в конфигурацию расширение]] «Интеграция с ЕГИСЗ» и осуществить [[1С8:Публикация информационной базы 1С на веб-сервере|публикацию]] HTTP-сервиса расширения (с отключением аутентификации при входе).
 +
<!--Обновление информационной базы с установленным расширением ЕГИСЗ до версии 25.08 выполняется в следующем порядке:
 +
# Обновите расширение до версии «25.08.xx контрольный».
 +
# Выполните обновление информационной базы.
 +
# Отключите активность расширения, если это не произошло автоматически.-->
 +
 
 +
== Использование средства шифрования PDF ==
 +
Использование средства для подготовки PDF-документов (GhostScript) требуется только при прямой интеграции с ЕГИСЗ. Оператор N3.Health не поддерживает отправку файлов в формате PDF/A-1, поэтому при интеграции с N3.Health настройки GhostScript не используются.
 +
 
 +
# Установите [https://www.ghostscript.com/releases/gsdnld.html средство шифрования PDF]
 +
# Установите цветовые профили для GhostScript:
 +
## Скачайте AdobeRGB1998.icc по ссылке https://www.adobe.com/support/downloads/iccprofiles/icc_eula_win_end.html, рекомендуется версия не выше 9.26.
 +
## Скопируйте файл AdobeRGB1998.icc в каталог, например, в папку lib программы GhostScript.
 +
## Внесите изменения в файл PDFA_def.ps, находящийся в папке lib программы GhostScript:
 +
##* Строку /ICCProfile (srgb.icc) % Customise заменить на путь к файлу AdobeRGB1998.icc, например, /ICCProfile (C:/Program Files/gs/gs9.23/lib/AdobeRGB1998.icc) % Customize;
 +
##* Строку /OutputConditionIdentifier (sRGB) % Customize заменить на /OutputConditionIdentifier.
  
<!--В программе «Кинт: Управление санаторием» можно настроить возможность отправлять некоторые медицинские документы из карты пациента в систему ЕГИСЗ (Единую государственную информационную систему здравоохранения).
 
  
# Установите расширение «Интеграция с ЕГИСЗ» в конфигурацию (для этого используйте [[Инструкция по установке расширений|инструкцию]]).
+
<!--# Установка расширения «Интеграция с ЕГИСЗ» выполнялась в соответствии с [[Инструкция по установке расширений|инструкцией]]).
 
# Осуществите [[1С8:Публикация информационной базы 1С на веб-сервере|публикацию]] HTTP-сервиса расширения.
 
# Осуществите [[1С8:Публикация информационной базы 1С на веб-сервере|публикацию]] HTTP-сервиса расширения.
 
# В созданном файле публикации необходимо отключить аутентификацию при входе. Для отключения запроса пароля нужно в файле публикации Default.vrd прописать логин/пароль по умолчанию, пример: <source lang="xml"> ib="Srvr=&quot;SERVER&quot;;Ref=&quot;BASE&quot;;Usr=&quot;LOGIN&quot;;Pwd=&quot;PASSWORD&quot;;enable=&quot;false&quot;;"</source>
 
# В созданном файле публикации необходимо отключить аутентификацию при входе. Для отключения запроса пароля нужно в файле публикации Default.vrd прописать логин/пароль по умолчанию, пример: <source lang="xml"> ib="Srvr=&quot;SERVER&quot;;Ref=&quot;BASE&quot;;Usr=&quot;LOGIN&quot;;Pwd=&quot;PASSWORD&quot;;enable=&quot;false&quot;;"</source>

Текущая версия на 16:58, 28 ноября 2025

Программа «Кинт: Управление санаторием» позволяет настроить отправку медицинских документов из карты пациента в Единую государственную информационную систему здравоохранения (ЕГИСЗ). Интеграция может выполняться:

  • напрямую с ЕГИСЗ (в версиях до релиза 25.08 требуется установка расширения);
  • через оператора N3.Health.

Настройка интеграции

Настройки интеграции выполняются в интерфейсе «Администратор системы» на закладке Медицина в разделе «Интеграция с ЕГИСЗ».

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

Адм. системы Настройки ЕГИСЗ.png

Доступ к сервису

Включите опцию «Использовать интеграцию с ЕГИСЗ» и выберите оператора: ЕГИСЗ или N3.Health.

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

ЕГИСЗ

Доступ к сервису ЕГИСЗ.png

Для подключения к сервису ЕГИСЗ укажите:

  1. Адрес сервиса — адрес сервиса ЕГИСЗ, на который будет осуществляться отправка файлов.
  2. Адрес публикации http-сервиса — адрес опубликованного http-сервиса конфигурации «Кинт: Управление санаторием» KintEGISZ для приема запросов от внешнего сервиса. Имеет вид: https://АДРЕС_СЕРВЕРА/ИМЯ_БАЗЫ/hs/KintEGISZ/ххх. Публикация выполняется с использованием ssl.
  3. Идентификатор ИС в ИПС — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в подсистеме интеграции прикладных систем (ИПС). Значение идентификатора имеет вид: fbd33aa5-5b3a-4586-b01a-9896ef4ce2fe.
  4. Идентификатор ИС РЭМД — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в реестре электронных медицинских документов (РЭМД). Значение идентификатора имеет вид: emdr-rmis-11.
  5. Каталог GhostScript — путь к каталогу установленного ПО для шифрования PDF-документов.
  6. Режим отладки — отключает проверку регистрации сертификатов электронной подписи в ЕГИСЗ. Используется для отправки запросов в тестовую среду РЭМД.

Адрес сервиса ЕГИСЗ и идентификаторы ИС в ИПС и РЭМД предоставляется службой технической поддержки ЕГИСЗ по заявке на регистрацию и подключение информационной системы.

После заполнения данных доступа нажмите кнопку Записать и закрыть.

N3.Health

Доступ к сервису N3.png

Для подключения используйте данные из личного кабинета сервиса N3.Health в разделе «ИЭМК».

N3 Данные из лк.png

Данные для авторизации:

  1. GUID (авторизационный токен).
  2. idLPU (Идентификатор медицинской организации).

Адреса сервисов:

  1. Адрес API сервиса работы с ИЭМК
  2. Адрес API сервиса работы с пациентами(Pix)

После заполнения данных доступа нажмите кнопку Записать и закрыть.

Работа с N3.Health требует использования OpenVPN. Конфигурационные файлы для OpenVPN находятся в личном кабинете N3.Health в разделе OpenVPN.

Настройки соответствия выгрузки мед. документов

  • Добавьте типы медицинских документов из списка подготовленных в формате CDA или PDF/A-1 (формат определяется Минздравом), которые необходимо выгружать в ЕГИСЗ.
  • Установите соответствие между OID документа и типом медицинской записи. Исключение составляют документы, для которых тип медицинской записи не используется, например, документы, формируемые не по одной конкретной медицинской записи, а агрегирующие сведения из медицинских записей разных типов (например, «Эпикриз выписной»).
  • Для документов в формате PDF/A-1 необходимо указать печатную форму.

Формат PDF/A-1 используется только при прямой интеграции с ЕГИСЗ, N3.Health не поддерживает передачу файлов формата PDF/A-1.

ЕГИСЗ Соответствие медицинских документов.png

Настройка мед. показателей

Настройте соответствие медицинских показателей, используемых в программе при заполнении медицинских записей, полям подготовленных CDA-документов. Значения будут заполняться из документа «Медицинская запись» или по последним данным пациента (если отправляемый документ агрегирует сведения из медицинских записей разных типов).

ЕГИСЗ Соответствие медпоказателей и полей CDA.png

Настройка справочников по минздраву

Синхронизируйте внутренние справочники программы с официальными классификаторами Минздрава:

  1. Если справочник пустой — заполните его, выполнив загрузку данных из справочника Минздрава.
  2. Если справочник уже содержит данные — вручную сопоставьте его элементы с элементами справочника Минздрава: для этого в карточке каждого элемента заполните реквизит «Код Минздрава».
  3. Если справочник заполнен частично — сопоставьте его элементы с элементами справочника Минздрава и выполните выборочную загрузку недостающих элементов.

Если в справочнике уже есть элемент с указанным кодом Минздрава, повторная загрузка элемента с таким же кодом невозможна.

ЕГИСЗ Справочники по минздраву.png

Если справочники не заполнены или не содержат элементов с указанным кодом Минздрава, они будут подсвечиваться красным цветом.

Если в настройках соответствия выгрузки мед. документов указаны типы медзаписей, у которых не заполнен код Минздрава, появится сообщение об ошибке с возможностью открыть список типов медзаписей, требующих указания кода.

Если код Минздрава не указан в специальности или должности сотрудников, оказывающих услуги, связанные с типами медзаписей из настроек соответствия выгрузки мед. документов, появится сообщение об ошибке с возможностью открыть список таких сотрудников.

Сертификаты электронной подписи

Добавьте сертификаты для подписания отправляемых документов.

Сертификаты электронной подписи.png

Протоколы отправки мед. документов

Все результаты отправки документов в ЕГИСЗ фиксируются в журнале «Протоколы регистрации документов в ЕГИСЗ».

Протоколы регистрации.png

Отправка документов

В карте пациента нажмите кнопку ЕГИСЗ — Отправить мед.документ и выберите тип документа для отправки.

Если документ сформирован без ошибок, отобразится статус «Документ готов к отправке», перечень объектов в чек-листе подсветится зеленым цветом.

Нажмите кнопку Подписать и отправить.

Отправка данных в ЕГИСЗ.png

При наличии ошибок настройки отображается статус «Есть ошибки». Объекты, по которым выявлены ошибки (например, отсутствие или некорректное указание обязательных данных), подсвечиваются красным цветом и могут быть раскрыты для просмотра подробной информации по параметрам.

При активации опции «Отображать только ошибки» в чек-листе отображаются только те параметры, по которым необходимо внести исправления.

Отправка данных в ЕГИСЗ (есть ошибки).png

Использование расширения (до релиза 25.08)

В версиях программы «Кинт: Управление санаторием» до релиза 25.08 для интеграции с ЕГИСЗ требовалось установить в конфигурацию расширение «Интеграция с ЕГИСЗ» и осуществить публикацию HTTP-сервиса расширения (с отключением аутентификации при входе).

Использование средства шифрования PDF

Использование средства для подготовки PDF-документов (GhostScript) требуется только при прямой интеграции с ЕГИСЗ. Оператор N3.Health не поддерживает отправку файлов в формате PDF/A-1, поэтому при интеграции с N3.Health настройки GhostScript не используются.

  1. Установите средство шифрования PDF
  2. Установите цветовые профили для GhostScript:
    1. Скачайте AdobeRGB1998.icc по ссылке https://www.adobe.com/support/downloads/iccprofiles/icc_eula_win_end.html, рекомендуется версия не выше 9.26.
    2. Скопируйте файл AdobeRGB1998.icc в каталог, например, в папку lib программы GhostScript.
    3. Внесите изменения в файл PDFA_def.ps, находящийся в папке lib программы GhostScript:
      • Строку /ICCProfile (srgb.icc) % Customise заменить на путь к файлу AdobeRGB1998.icc, например, /ICCProfile (C:/Program Files/gs/gs9.23/lib/AdobeRGB1998.icc) % Customize;
      • Строку /OutputConditionIdentifier (sRGB) % Customize заменить на /OutputConditionIdentifier.