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

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

Версия 16:52, 10 апреля 2026

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

  • напрямую с ЕГИСЗ (в версиях до релиза 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-документов.

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

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

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

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

N3.Health

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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 может быть организован через прокси-сервер внутри сети медицинской организации. Такой подход позволяет централизованно управлять 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.