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

Материал из КинтВики
Перейти к: навигация, поиск
м
(→‎Подготовка инфраструктуры и настройка сетевого доступа к сервису N3.Health)
 
(не показаны 94 промежуточные версии 6 участников)
Строка 1: Строка 1:
−
<noinclude>[[Категория:История болезни (КУС)]]</noinclude>
+
<noinclude>[[Категория:История болезни (КУС)]]
−
В программе «Кинт: Управление санаторием» можно настроить возможность отправлять некоторые медицинские документы из карты пациента в систему ЕГИСЗ (Единую государственную информационную систему здравоохранения).
+
[[Категория:Интеграция с внешними сервисами (КУС)|Е]]</noinclude>
 +
{| align="right"
 +
| __TOC__
 +
|}
 +
Программа «Кинт: Управление санаторием» позволяет настроить отправку медицинских документов из карты пациента в Единую государственную информационную систему здравоохранения (ЕГИСЗ). Интеграция может выполняться:
 +
* напрямую с ЕГИСЗ (в версиях до релиза 25.08 требуется установка расширения);
 +
* через оператора N3.Health.
  
−
# Сделайте настройку интеграции с ЕГИСЗ (в [[Параметры работы системы (КУС)#Интеграция с ЕГИСЗ|интерфейсе «Администратор системы» на закладке '''Параметры учета''' в разделе '''Медицинские услуги''']]): укажите параметры подключения программы «Кинт: Управление санаторием» к ЕГИСЗ и документы, которые вы хотите в эту систему отправлять.
+
== Настройка интеграции ==
 +
Настройки интеграции выполняются в интерфейсе «Администратор системы» на закладке '''Медицина''' в разделе «Интеграция с ЕГИСЗ».
 +
 
 +
В окне настроек интеграции представлен перечень пунктов, по каждому из которых открывается отдельное окно для внесения необходимых параметров.
 +
: [[Файл:Адм. системы Настройки ЕГИСЗ.png|720px]]
 +
 
 +
=== Доступ к сервису ===
 +
Включите опцию «Использовать интеграцию с ЕГИСЗ» и выберите оператора: ЕГИСЗ или N3.Health.
 +
 
 +
В зависимости от выбранного оператора открывается соответствующая форма с набором полей для настройки доступа.
 +
 
 +
==== ЕГИСЗ ====
 +
: [[Файл:Доступ к сервису ЕГИСЗ.png|720px]]
 +
 
 +
Для подключения к сервису ЕГИСЗ укажите:
 +
# Адрес сервиса — адрес сервиса ЕГИСЗ, на который будет осуществляться отправка файлов.
 +
# Адрес публикации http-сервиса — адрес [[1С8:Публикация информационной базы 1С на веб-сервере#Публикация базы без авторизации|опубликованного http-сервиса]] конфигурации «Кинт: Управление санаторием» KintEGISZ для приема запросов от внешнего сервиса. Имеет вид: https://site.com/sanatory/hs/KintEGISZ/EmdrCallback. Публикация выполняется с использованием ssl.
 +
# Идентификатор ИС в ИПС — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в подсистеме интеграции прикладных систем (ИПС). Значение идентификатора имеет вид: fbd33aa5-5b3a-4586-b01a-9896ef4ce2fe.
 +
# Идентификатор ИС РЭМД — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в реестре электронных медицинских документов (РЭМД). Значение идентификатора имеет вид: emdr-rmis-11.
 +
# Каталог GhostScript — путь к каталогу установленного ПО для шифрования PDF-документов.
 +
Адрес сервиса ЕГИСЗ и идентификаторы ИС в ИПС и РЭМД предоставляется службой технической поддержки ЕГИСЗ по заявке на регистрацию и подключение информационной системы.
 +
 
 +
В поле «Сертификат организации» отображается актуальный электронный сертификат организации.
 +
 
 +
Активация опции «Отключить проверку сертификатов» отключает проверку регистрации сертификатов электронной подписи в ЕГИСЗ. Используется для отправки запросов в тестовую среду РЭМД.
 +
 
 +
После заполнения данных доступа нажмите кнопку '''''Записать и закрыть'''''.
 +
 
 +
==== N3.Health ====
 +
Перед настройкой рекомендуется ознакомиться с [[#Особенности работы с N3.Health|особенностями работы с сервисом N3.Health]].
 +
: [[Файл:Доступ к сервису N3.png|720px]]
 +
 
 +
'''Электронная медицинская карта (ИЭМК)'''
 +
 
 +
В разделе заполняются данные для доступа к сервису N3.Health:
 +
* Авторизационный токен (GUID)
 +
* Идентификатор МО idLPU (idLPU)
 +
* Адрес API сервиса работы с ИЭМК
 +
* Адрес API сервиса работы с пациентами(Pix)
 +
 
 +
Данные для заполнения доступны в личном кабинете сервиса [https://lk.n3health.ru/ N3.Health] в разделе «ИЭМК».
 +
{{notice|Важно: данные в разделе потребуется заполнить дважды: на этапе отладки и тестирования вносятся данные из демонстрационного контура (тестовой среды); после получения доступа к промышленному контуру (рабочей среде) эти настройки требуется заменить на данные из промышленного контура.}}
 +
 +
'''Получение СНИЛС и ОМС (Сервис обогащения СНИЛС)'''
 +
 
 +
В разделе можно подключить сервис, который автоматически получает данные СНИЛС и ОМС физического лица из N3.Health и дополняет карточку физического лица этими сведениями. Сервис работает только в промышленном контуре.
 +
 
 +
Для настройки:
 +
# Включите опцию «Использовать» для работы с сервисом.
 +
# Включите опцию «Автоматически получать данные», чтобы после сохранения карточки физического лица автоматически отправлялся запрос в сервис на получение данных СНИЛС и ОМС.
 +
#: При отключенной опции запрос можно отправить вручную с помощью соответствующей кнопки в карточке физического лица.
 +
# В поле «Авторизационный токен (GUID)» укажите данные параметра из личного кабинета сервиса (раздел «Сервис обогащения СНИЛС»).
 +
# Заполните поле «Адрес API сервиса» (если не заполнилось автоматически).
 +
 
 +
Принцип работы: запрос отправляется автоматически при сохранении карточки физического лица или вручную по кнопке. Данные СНИЛС и ОМС появляются в карточке физического лица примерно через 10 минут и подгружаются независимо от того, открыта карточка или закрыта. Статусы получения можно отслеживать в журнале получения СНИЛС и ОМС. Список обязательных полей, которые необходимо заполнить в карточке физического лица: фамилия имя, отчество (при наличии), дата рождения, пол, серия, номер, орган и дата выдачи основного удостоверения личности.
 +
 
 +
'''Электронный сертификат'''
 +
 
 +
В поле «Сертификат организации» отображается актуальный электронный сертификат организации.
 +
 
 +
Активация опции «Не подписывать сертификатом организации» позволяет использовать для подписания запросов только сертификат врача. Поле «Сертификат организации» в этом случае скрывается с формы.
 +
 
 +
=== Настройки соответствия выгрузки мед. документов ===
 +
* Добавьте типы медицинских документов из списка подготовленных в формате CDA или PDF/A-1 (формат определяется Минздравом), которые необходимо выгружать в ЕГИСЗ.
 +
* Установите соответствие между OID документа и типом медицинской записи. Исключение составляют документы, для которых тип медицинской записи не используется, например, документы, формируемые не по одной конкретной медицинской записи, а агрегирующие сведения из медицинских записей разных типов (например, «Эпикриз выписной»).
 +
* Для документов в формате PDF/A-1 необходимо указать печатную форму.
 +
Формат PDF/A-1 используется только при прямой интеграции с ЕГИСЗ, N3.Health не поддерживает передачу файлов формата PDF/A-1.
 +
: [[Файл:ЕГИСЗ Соответствие медицинских документов.png|720px]]
 +
 
 +
=== Настройка мед. показателей ===
 +
Настройте соответствие медицинских показателей, используемых в программе при заполнении медицинских записей, полям подготовленных CDA-документов. Значения будут заполняться из документа «Медицинская запись» или по последним данным пациента (если отправляемый документ агрегирует сведения из медицинских записей разных типов).
 +
: [[Файл:ЕГИСЗ Соответствие медпоказателей и полей CDA.png|720px]]
 +
 
 +
=== Настройка справочников по минздраву ===
 +
Синхронизируйте внутренние справочники программы с официальными классификаторами Минздрава:
 +
# Если справочник пустой — заполните его, выполнив загрузку данных из справочника Минздрава.
 +
# Если справочник уже содержит данные — вручную сопоставьте его элементы с элементами справочника Минздрава: для этого в карточке каждого элемента заполните реквизит «Код Минздрава».
 +
# Если справочник заполнен частично — сопоставьте его элементы с элементами справочника Минздрава и выполните выборочную загрузку недостающих элементов.
 +
Если в справочнике уже есть элемент с указанным кодом Минздрава, повторная загрузка элемента с таким же кодом невозможна.
 +
: [[Файл:ЕГИСЗ Справочники по минздраву.png|720px]]
 +
Если справочники не заполнены или не содержат элементов с указанным кодом Минздрава, они будут подсвечиваться красным цветом.
 +
 
 +
Если в настройках соответствия выгрузки мед. документов указаны типы медзаписей, у которых не заполнен код Минздрава, появится сообщение об ошибке с возможностью открыть список типов медзаписей, требующих указания кода.
 +
 
 +
Если код Минздрава не указан в специальности или должности сотрудников, оказывающих услуги, связанные с типами медзаписей из настроек соответствия выгрузки мед. документов, появится сообщение об ошибке с возможностью открыть список таких сотрудников.
 +
 
 +
=== Сертификаты электронной подписи ===
 +
Добавьте [[Справочник "Сертификаты электронной подписи" (КУС)|сертификаты]] для подписания отправляемых документов.
 +
: [[Файл:Сертификаты электронной подписи.png|800px]]
 +
 
 +
=== Протоколы отправки мед. документов ===
 +
Все результаты отправки документов в ЕГИСЗ фиксируются в журнале «Протоколы регистрации документов в ЕГИСЗ».
 +
: [[Файл:Протоколы регистрации.png|800px]]
 +
 
 +
== Отправка документов ==
 +
В карте пациента нажмите кнопку '''''ЕГИСЗ''''' — '''''Отправить мед.документ''''' и выберите тип документа для отправки.
 +
 
 +
Если документ сформирован без ошибок, отобразится статус «Документ готов к отправке», перечень объектов в чек-листе подсветится зеленым цветом.
 +
 
 +
Нажмите кнопку '''''Подписать и отправить'''''.
 +
: [[Файл:Отправка данных в ЕГИСЗ.png|800px]]
 +
 
 +
При наличии ошибок настройки отображается статус «Есть ошибки». Объекты, по которым выявлены ошибки (например, отсутствие или некорректное указание обязательных данных), подсвечиваются красным цветом и могут быть раскрыты для просмотра подробной информации по параметрам.
 +
 
 +
При активации опции «Отображать только ошибки» в чек-листе отображаются только те параметры, по которым необходимо внести исправления.
 +
:[[Файл:Отправка данных в ЕГИСЗ (есть ошибки).png|800px]]
 +
 
 +
После отправки медицинского документа по кнопке '''''ЕГИСЗ''''' в карте пациента можно проверить статус его отправки, а также открыть протокол регистрации документа в ЕГИСЗ. При прямой интеграции (не через  N3.Health) по кнопке также доступны команды:
 +
* '''Запросить сведения о регистрации мед. документа''';
 +
* '''Запросить файл мед. документа''';
 +
* '''Запросить описание медицинского документа'''.
 +
 
 +
== Особенности работы с N3.Health ==
 +
 
 +
При интеграции с сервисом N3.Health необходимо учитывать следующие особенности настройки и эксплуатации.
 +
 
 +
=== Этапы подключения к сервису ===
 +
 
 +
# Регистрация в сервисе N3.Health и получение доступа к тестовой среде.
 +
# Получение из личного кабинета параметров доступа к тестовому контуру: GUID, idLPU, адреса API.
 +
#: [[Файл:N3 Данные из лк.png|700px]]
 +
# Настройка доступа в программе «Кинт: Управление санаторием» с использованием данных тестового контура.
 +
# Настройка защищенного соединения — установка OpenVPN (конфигурационные файлы для OpenVPN доступны в личном кабинете N3.Health в разделе «OpenVPN»).
 +
# Тестирование отправки медицинских документов в ЕГИСЗ.
 +
# Переход на промышленную среду:
 +
## получение доступа к промышленному контуру;
 +
## замена параметров доступа в «Кинт: Управление санаторием»;
 +
## переход на использование защищенного соединения ViPNet (при содействии службы технической поддержки сервиса N3.Health).
 +
 
 +
=== Подготовка инфраструктуры и настройка сетевого доступа к сервису N3.Health ===
 +
 
 +
Доступ к сервису N3.Health может быть организован через прокси-сервер внутри сети медицинской организации. Такой подход позволяет централизованно управлять VPN-подключением и не требует установки VPN непосредственно на сервер с 1С.
 +
 
 +
==== Порядок действий для тестовой среды (OpenVPN) ====
 +
 
 +
# Выделите сервер
 +
#: Подготовьте отдельную машину (физический или виртуальный сервер) под прокси.
 +
# Установите OpenVPN
 +
#: Скачайте дистрибутив OpenVPN (версию рекомендует N3.Health) и установите его на выделенном прокси-сервере.
 +
# Настройте VPN-туннель
 +
#: Импортируйте конфигурацию туннеля, полученную в личном кабинете N3.Health.
 +
#: Убедитесь, что соединение установлено (например, появился сетевой интерфейс tun0 или в логах OpenVPN отсутствуют ошибки).
 +
# Настройте прокси-сервер
 +
#: На том же сервере настройте прокси-сервер, который будет перенаправлять трафик в VPN-туннель.
 +
#: Прокси должен принимать запросы от сервера с «Кинт: Управление санаторием» (или от других серверов в сети) и направлять их в адрес API N3.Health через OpenVPN.
 +
# Настройте «Кинт: Управление санаторием» для работы через прокси
 +
#: В интерфейсе «Администратор системы» в разделе «Настройка прокси-сервера» укажите [[Интерфейс "Администратор системы" (КУС)#Настройка прокси-сервера|параметры прокси-сервера]]:
 +
#:* Адрес прокси: IP-адрес вашего прокси-сервера (внутри локальной сети).
 +
#:* Порт прокси, заданный вами при настройке прокси.
 +
#:* При необходимости — логин и пароль для аутентификации на прокси.
 +
# Проверьте доступность сервиса
 +
#: Убедитесь, что сервер с программой через настроенный прокси успешно обращается к API N3.Health.
 +
#: Для проверки можно выполнить тестовый запрос или отправить пробный документ из программы в тестовой среде.
 +
 
 +
==== Порядок действий для промышленной среды (ViPNet Client) ====
 +
# Подготовьте сервера
 +
#: Используйте тот же или другой подготовленный прокси-сервер.
 +
# Установите ViPNet Client
 +
# Настройте  подключение
 +
#: Импортируйте конфигурацию для подключения к промышленному контуру N3.Health через ViPNet.
 +
# Проверьте связь
 +
#: Убедитесь, что с сервера, где запущена служба «Агент сервера 1С:Предприятия 8.3», есть сетевая связность с API N3.Health через ViPNet.
 +
#  Выполните настройки в «Кинт: Управление санаторием»:
 +
#: В интерфейсе «Администратор системы» в разделе «Настройка прокси-сервера» укажите параметры локального прокси, который направляет трафик в ViPNet.
 +
 
 +
== Использование расширения (до релиза 25.08) ==
 +
 
 +
В версиях программы «Кинт: Управление санаторием» до релиза 25.08 для интеграции с ЕГИСЗ требовалось [[Инструкция по установке расширений|установить в конфигурацию расширение]] «Интеграция с ЕГИСЗ» и осуществить [[1С8:Публикация информационной базы 1С на веб-сервере|публикацию]] HTTP-сервиса расширения (с отключением аутентификации при входе). С релиза 25.08 дальнейшее использование расширения не требуется.
 +
 
 +
Порядок обновления информационной базы с установленным расширением ЕГИСЗ до версии 25.08 (выполняется пользователем с правами администратора системы):
 +
# Выполните обновление основной конфигурации в конфигураторе на 25.08, не открывая предприятие после установки обновления в конфигураторе.
 +
# Обновите расширение ЕГИСЗ на 25.08, закройте конфигуратор и запустите 1С:Предприятие.
 +
# Обновление конфигурации 1С:Предприятие пройдет до конца, флаг активности у расширения снимется.
 +
 
 +
== Использование средства шифрования 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-сервиса расширения.
 +
# В созданном файле публикации необходимо отключить аутентификацию при входе. Для отключения запроса пароля нужно в файле публикации 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>
 +
# Установите [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
 +
# Сделайте настройку интеграции с ЕГИСЗ (в [[Параметры работы системы (КУС)#Интеграция с ЕГИСЗ|интерфейсе «Администратор системы» по кнопке '''Перейти''' пункт '''Настройки интеграции с ЕГИСЗ''']]). Также открыть настройку можно через вкладку '''Медицина''' — '''Настройки интеграции с ЕГИСЗ'''
 +
# На форме укажите следующие параметры подключения программы «Кинт: Управление санаторием» к ЕГИСЗ и документы, которые вы хотите в эту систему отправлять:
 +
## Адрес Сервиса ЕГИСЗ — адрес сервиса ЕГИСЗ на который будет осуществляться отправка файлом.
 +
## Адрес Публикации Базы — Адрес опубликованного http-сервиса ЕГИСЗ, имеет вид http://site.com/sanatory/hs/KintEGISZ/EmdrCallback.
 +
## Идентификатор ИС в ИПС — Идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в подсистеме интеграции прикладных систем (ИПС). Значение идентификатора имеет вид: fbd33aa5-5b3a-4586-b01a-9896ef4ce2fe.
 +
## Идентификатор ИС РЭМД — Идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в реестре электронных медицинских документов (РЭМД). Значение идентификатора имеет вид: emdr-rmis-11.
 +
## Каталог GhostScript — путь к каталогу установленного ПО по шифрованию PDF документов.
 +
## Заполните таблицу кодов OID медицинских записей из справочника документов ЕГИСЗ https://nsi.rosminzdrav.ru/dictionaries/1.2.643.5.1.13.13.11.1520/passport/12.2. Например, «77 (Эпикриз в стационаре выписной)» может выгружать только в формате XML.
 
# В [[Карта пациента (КУС)#Форма карты пациента|карте пациента]] нажмите кнопку '''''Отправить в ЕГИСЗ'''''.
 
# В [[Карта пациента (КУС)#Форма карты пациента|карте пациента]] нажмите кнопку '''''Отправить в ЕГИСЗ'''''.
−
#: Если настроена отправка только одного документа, при нажатии на эту кнопку откроется его печатная форма, которую можно отправить. Если настроена отправка нескольких документов — откроется окно со списком документов, указанных в [[Параметры работы системы (КУС)#Интеграция с ЕГИСЗ|настройке интеграции с ЕГИСЗ]], выберите документ, который нужно отправить. Откроется его печатная форма, которую можно отправить с помощью кнопки '''''Подписать и отправить'''''.
+
#: Если настроена отправка только одного документа, при нажатии на эту кнопку откроется его печатная форма, которую можно отправить. Если настроена отправка нескольких документов — откроется окно со списком документов, указанных в [[Параметры работы системы (КУС)#Интеграция с ЕГИСЗ|настройке интеграции с ЕГИСЗ]], выберите документ, который нужно отправить. Откроется его печатная форма, которую можно отправить с помощью кнопки '''''Подписать и отправить'''''.
−
# При отправке документа в ЕГИСЗ в программе «Кинт: Управление санаторием» формируется сообщение — электронное письмо, в приложении к которому находится печатная форма отправленного документа. Все сообщения обмена данными с ЕГИСЗ хранятся в журнале «Сообщения обмена с ЕГИСЗ», который доступен в разделе МЕДИЦИНА — '''Медицинские записи'''.
+
# При отправке документа в ЕГИСЗ в программе «Кинт: Управление санаторием» формируется сообщение — электронное письмо, в приложении к которому находится печатная форма отправленного документа. Все сообщения обмена данными с ЕГИСЗ хранятся в журнале «Сообщения обмена с ЕГИСЗ», который доступен в разделе МЕДИЦИНА — '''Медицинские записи'''.-->

Текущая версия на 15:35, 15 апреля 2026

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

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

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

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

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

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

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

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

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

ЕГИСЗ

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

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

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

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

В поле «Сертификат организации» отображается актуальный электронный сертификат организации.

Активация опции «Отключить проверку сертификатов» отключает проверку регистрации сертификатов электронной подписи в ЕГИСЗ. Используется для отправки запросов в тестовую среду РЭМД.

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

N3.Health

Перед настройкой рекомендуется ознакомиться с особенностями работы с сервисом N3.Health.

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

Электронная медицинская карта (ИЭМК)

В разделе заполняются данные для доступа к сервису N3.Health:

  • Авторизационный токен (GUID)
  • Идентификатор МО idLPU (idLPU)
  • Адрес API сервиса работы с ИЭМК
  • Адрес API сервиса работы с пациентами(Pix)

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

Важно: данные в разделе потребуется заполнить дважды: на этапе отладки и тестирования вносятся данные из демонстрационного контура (тестовой среды); после получения доступа к промышленному контуру (рабочей среде) эти настройки требуется заменить на данные из промышленного контура.

Получение СНИЛС и ОМС (Сервис обогащения СНИЛС)

В разделе можно подключить сервис, который автоматически получает данные СНИЛС и ОМС физического лица из N3.Health и дополняет карточку физического лица этими сведениями. Сервис работает только в промышленном контуре.

Для настройки:

  1. Включите опцию «Использовать» для работы с сервисом.
  2. Включите опцию «Автоматически получать данные», чтобы после сохранения карточки физического лица автоматически отправлялся запрос в сервис на получение данных СНИЛС и ОМС.
    При отключенной опции запрос можно отправить вручную с помощью соответствующей кнопки в карточке физического лица.
  3. В поле «Авторизационный токен (GUID)» укажите данные параметра из личного кабинета сервиса (раздел «Сервис обогащения СНИЛС»).
  4. Заполните поле «Адрес API сервиса» (если не заполнилось автоматически).

Принцип работы: запрос отправляется автоматически при сохранении карточки физического лица или вручную по кнопке. Данные СНИЛС и ОМС появляются в карточке физического лица примерно через 10 минут и подгружаются независимо от того, открыта карточка или закрыта. Статусы получения можно отслеживать в журнале получения СНИЛС и ОМС. Список обязательных полей, которые необходимо заполнить в карточке физического лица: фамилия имя, отчество (при наличии), дата рождения, пол, серия, номер, орган и дата выдачи основного удостоверения личности.

Электронный сертификат

В поле «Сертификат организации» отображается актуальный электронный сертификат организации.

Активация опции «Не подписывать сертификатом организации» позволяет использовать для подписания запросов только сертификат врача. Поле «Сертификат организации» в этом случае скрывается с формы.

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

  • Добавьте типы медицинских документов из списка подготовленных в формате 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

После отправки медицинского документа по кнопке ЕГИСЗ в карте пациента можно проверить статус его отправки, а также открыть протокол регистрации документа в ЕГИСЗ. При прямой интеграции (не через N3.Health) по кнопке также доступны команды:

  • Запросить сведения о регистрации мед. документа;
  • Запросить файл мед. документа;
  • Запросить описание медицинского документа.

Особенности работы с N3.Health

При интеграции с сервисом N3.Health необходимо учитывать следующие особенности настройки и эксплуатации.

Этапы подключения к сервису

  1. Регистрация в сервисе N3.Health и получение доступа к тестовой среде.
  2. Получение из личного кабинета параметров доступа к тестовому контуру: GUID, idLPU, адреса API.
    N3 Данные из лк.png
  3. Настройка доступа в программе «Кинт: Управление санаторием» с использованием данных тестового контура.
  4. Настройка защищенного соединения — установка OpenVPN (конфигурационные файлы для OpenVPN доступны в личном кабинете N3.Health в разделе «OpenVPN»).
  5. Тестирование отправки медицинских документов в ЕГИСЗ.
  6. Переход на промышленную среду:
    1. получение доступа к промышленному контуру;
    2. замена параметров доступа в «Кинт: Управление санаторием»;
    3. переход на использование защищенного соединения ViPNet (при содействии службы технической поддержки сервиса N3.Health).

Подготовка инфраструктуры и настройка сетевого доступа к сервису N3.Health

Доступ к сервису N3.Health может быть организован через прокси-сервер внутри сети медицинской организации. Такой подход позволяет централизованно управлять VPN-подключением и не требует установки VPN непосредственно на сервер с 1С.

Порядок действий для тестовой среды (OpenVPN)

  1. Выделите сервер
    Подготовьте отдельную машину (физический или виртуальный сервер) под прокси.
  2. Установите OpenVPN
    Скачайте дистрибутив OpenVPN (версию рекомендует N3.Health) и установите его на выделенном прокси-сервере.
  3. Настройте VPN-туннель
    Импортируйте конфигурацию туннеля, полученную в личном кабинете N3.Health.
    Убедитесь, что соединение установлено (например, появился сетевой интерфейс tun0 или в логах OpenVPN отсутствуют ошибки).
  4. Настройте прокси-сервер
    На том же сервере настройте прокси-сервер, который будет перенаправлять трафик в VPN-туннель.
    Прокси должен принимать запросы от сервера с «Кинт: Управление санаторием» (или от других серверов в сети) и направлять их в адрес API N3.Health через OpenVPN.
  5. Настройте «Кинт: Управление санаторием» для работы через прокси
    В интерфейсе «Администратор системы» в разделе «Настройка прокси-сервера» укажите параметры прокси-сервера:
    • Адрес прокси: IP-адрес вашего прокси-сервера (внутри локальной сети).
    • Порт прокси, заданный вами при настройке прокси.
    • При необходимости — логин и пароль для аутентификации на прокси.
  6. Проверьте доступность сервиса
    Убедитесь, что сервер с программой через настроенный прокси успешно обращается к API N3.Health.
    Для проверки можно выполнить тестовый запрос или отправить пробный документ из программы в тестовой среде.

Порядок действий для промышленной среды (ViPNet Client)

  1. Подготовьте сервера
    Используйте тот же или другой подготовленный прокси-сервер.
  2. Установите ViPNet Client
  3. Настройте подключение
    Импортируйте конфигурацию для подключения к промышленному контуру N3.Health через ViPNet.
  4. Проверьте связь
    Убедитесь, что с сервера, где запущена служба «Агент сервера 1С:Предприятия 8.3», есть сетевая связность с API N3.Health через ViPNet.
  5. Выполните настройки в «Кинт: Управление санаторием»:
    В интерфейсе «Администратор системы» в разделе «Настройка прокси-сервера» укажите параметры локального прокси, который направляет трафик в ViPNet.

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

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

Порядок обновления информационной базы с установленным расширением ЕГИСЗ до версии 25.08 (выполняется пользователем с правами администратора системы):

  1. Выполните обновление основной конфигурации в конфигураторе на 25.08, не открывая предприятие после установки обновления в конфигураторе.
  2. Обновите расширение ЕГИСЗ на 25.08, закройте конфигуратор и запустите 1С:Предприятие.
  3. Обновление конфигурации 1С:Предприятие пройдет до конца, флаг активности у расширения снимется.

Использование средства шифрования 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.


Источник — «http://wiki.kint.ru/index.php?title=Интеграция_с_ЕГИСЗ_(КУС)&oldid=103232»