Интеграция с ЕГИСЗ (КУС)

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

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

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

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

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

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

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

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

ЕГИСЗ

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

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

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

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

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

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

N3.Health

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

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

В разделе заполняются данные для доступа к сервису 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Регистрация в сервисе N3.Health и получение доступа к тестовой среде.
2. Получение из личного кабинета параметров доступа к тестовому контуру: GUID, idLPU, адреса API.

   

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

Настройка доступа к сервису N3.Health через прокси-сервер

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

Порядок действий:

1. Выделите отдельную машину под прокси-сервер

   Подготовьте физический или виртуальный сервер, который будет выполнять роль прокси.

   Операционная система может быть любой, поддерживающей работу OpenVPN и прокси-сервера (например, Windows Server).

2. Установите клиент OpenVPN на прокси-сервер

   Скачайте дистрибутив OpenVPN (версию рекомендует N3.Health) и установите его на выделенном прокси-сервере.

3. Настройте VPN-туннель

   Импортируйте конфигурацию туннеля, полученную в личном кабинете N3.Health.

   Убедитесь, что соединение установлено (например, появился сетевой интерфейс tun0 или в логах OpenVPN отсутствуют ошибки).

4. Настройте прокси-сервер

   На том же сервере настройте прокси-сервер, который будет перенаправлять трафик в VPN-туннель.

   Прокси должен принимать запросы от сервера с «Кинт: Управление санаторием» (или от других серверов в сети) и направлять их в адрес API N3.Health через OpenVPN.

5. Настройте «Кинт: Управление санаторием» для работы через прокси

   В конфигурации «Кинт: Управление санаторием» укажите параметры прокси-сервера:

   • Адрес прокси: IP-адрес вашего прокси-сервера (внутри локальной сети).
   • Порт прокси, заданный вами при настройке прокси.
   • При необходимости — логин и пароль для аутентификации на прокси.

6. Проверьте доступность сервиса

   Убедитесь, что сервер с программой через настроенный прокси успешно обращается к API N3.Health.

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

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