Интеграция с ЕГИСЗ (КУС) — различия между версиями
(→N3.Health) |
(→Отправка документов) |
||
| Строка 104: | Строка 104: | ||
При активации опции «Отображать только ошибки» в чек-листе отображаются только те параметры, по которым необходимо внести исправления. | При активации опции «Отображать только ошибки» в чек-листе отображаются только те параметры, по которым необходимо внести исправления. | ||
:[[Файл:Отправка данных в ЕГИСЗ (есть ошибки).png|800px]] | :[[Файл:Отправка данных в ЕГИСЗ (есть ошибки).png|800px]] | ||
| + | |||
| + | == Особенности работы с N3.Health == | ||
| + | |||
| + | При интеграции с сервисом N3.Health необходимо учитывать следующие особенности настройки и эксплуатации. | ||
| + | |||
| + | === Этапы подключения к сервису === | ||
| + | |||
| + | # Регистрация в сервисе N3.Health и получение доступа к тестовой среде. | ||
| + | # Получение из личного кабинета параметров доступа к тестовому контуру: GUID, idLPU, адреса API. | ||
| + | # Настройка доступа в программе «Кинт: Управление санаторием» с использованием данных тестового контура. | ||
| + | # Настройка защищенного соединения — установка OpenVPN (конфигурационные файлы для OpenVPN доступны в личном кабинете N3.Health в разделе «OpenVPN»). | ||
| + | # Тестирование отправки медицинских документов в ЕГИСЗ. | ||
| + | # Переход на промышленную среду: | ||
| + | ## получение доступа к промышленному контуру; | ||
| + | ## замена параметров доступа в программе; | ||
| + | ## переход на использование защищенного соединения ViPNet. | ||
| + | |||
| + | === Настройка доступа к сервису N3.Health через прокси-сервер === | ||
| + | |||
| + | Доступ к сервису N3.Health может быть организован через прокси-сервер внутри сети медицинской организации. Такой подход позволяет централизованно управлять VPN-подключением и не требует установки OpenVPN непосредственно на сервер с 1С. | ||
| + | |||
| + | Порядок действий: | ||
| + | |||
| + | # Выделите отдельную машину под прокси-сервер | ||
| + | #: Подготовьте физический или виртуальный сервер, который будет выполнять роль прокси. Операционная система может быть любой, поддерживающей работу OpenVPN и прокси-сервера (например, Windows Server). | ||
| + | # Установите клиент OpenVPN на прокси-сервер | ||
| + | #: Скачайте дистрибутив OpenVPN (версию рекомендует N3.Health) и установите его на выделенном прокси-сервере. | ||
| + | # Настройте VPN-туннель | ||
| + | #: Импортируйте конфигурацию туннеля, полученную в личном кабинете N3.Health. Убедитесь, что соединение установлено (например, появился сетевой интерфейс tun0 или в логах OpenVPN отсутствуют ошибки). | ||
| + | # Настройте прокси-сервер | ||
| + | #: На том же сервере настройте прокси-сервер, который будет перенаправлять трафик в VPN-туннель. Прокси должен принимать запросы от сервера с «Кинт: Управление санаторием» (или от других серверов в сети) и направлять их в адрес API N3.Health через OpenVPN. | ||
| + | # Настройте «Кинт: Управление санаторием» для работы через прокси | ||
| + | #: В конфигурации «Кинт: Управление санаторием» укажите параметры прокси-сервера: | ||
| + | #:* Адрес прокси: IP-адрес вашего прокси-сервера (внутри локальной сети). | ||
| + | #:* Порт прокси, заданный вами при настройке прокси. | ||
| + | #:* При необходимости — логин и пароль для аутентификации на прокси. | ||
| + | # Проверьте доступность сервиса | ||
| + | #: Убедитесь, что сервер с программой через настроенный прокси успешно обращается к API N3.Health. Для проверки можно выполнить тестовый запрос или отправить пробный документ из программы в тестовой среде. | ||
== Использование расширения (до релиза 25.08) == | == Использование расширения (до релиза 25.08) == | ||
Версия 15:50, 10 апреля 2026
Программа «Кинт: Управление санаторием» позволяет настроить отправку медицинских документов из карты пациента в Единую государственную информационную систему здравоохранения (ЕГИСЗ). Интеграция может выполняться:
- напрямую с ЕГИСЗ (в версиях до релиза 25.08 требуется установка расширения);
- через оператора N3.Health.
Настройка интеграции
Настройки интеграции выполняются в интерфейсе «Администратор системы» на закладке Медицина в разделе «Интеграция с ЕГИСЗ».
В окне настроек интеграции представлен перечень пунктов, по каждому из которых открывается отдельное окно для внесения необходимых параметров.
Доступ к сервису
Включите опцию «Использовать интеграцию с ЕГИСЗ» и выберите оператора: ЕГИСЗ или N3.Health.
В зависимости от выбранного оператора открывается соответствующая форма с набором полей для настройки доступа.
ЕГИСЗ
Для подключения к сервису ЕГИСЗ укажите:
- Адрес сервиса — адрес сервиса ЕГИСЗ, на который будет осуществляться отправка файлов.
- Адрес публикации http-сервиса — адрес опубликованного http-сервиса конфигурации «Кинт: Управление санаторием» KintEGISZ для приема запросов от внешнего сервиса. Имеет вид: https://АДРЕС_СЕРВЕРА/ИМЯ_БАЗЫ/hs/KintEGISZ/ххх. Публикация выполняется с использованием ssl.
- Идентификатор ИС в ИПС — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в подсистеме интеграции прикладных систем (ИПС). Значение идентификатора имеет вид: fbd33aa5-5b3a-4586-b01a-9896ef4ce2fe.
- Идентификатор ИС РЭМД — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в реестре электронных медицинских документов (РЭМД). Значение идентификатора имеет вид: emdr-rmis-11.
- Каталог GhostScript — путь к каталогу установленного ПО для шифрования PDF-документов.
Адрес сервиса ЕГИСЗ и идентификаторы ИС в ИПС и РЭМД предоставляется службой технической поддержки ЕГИСЗ по заявке на регистрацию и подключение информационной системы.
В поле «Сертификат организации» отображается актуальный электронный сертификат организации.
Активация опции «Отключить проверку сертификатов» отключает проверку регистрации сертификатов электронной подписи в ЕГИСЗ. Используется для отправки запросов в тестовую среду РЭМД.
После заполнения данных доступа нажмите кнопку Записать и закрыть.
N3.Health
Для настройки доступа к сервису заполните данные в разделе «Электронная медицинская карта (ИЭМК)»:
- Авторизационный токен (GUID)
- Идентификатор МО idLPU (idLPU)
- Адрес API сервиса работы с ИЭМК
- Адрес API сервиса работы с пациентами(Pix)
Данные для заполнения доступны в личном кабинете сервиса N3.Health в разделе «ИЭМК».
|
Важно: данные в этом разделе потребуется заполнить дважды: на этапе отладки и тестирования вносятся данные из демонстрационного контура (тестовой среды); после получения доступа к промышленному контуру (рабочей среде) эти настройки требуется заменить на данные из промышленного стенда. |
В поле «Сертификат организации» отображается актуальный электронный сертификат организации.
Активация опции «Не подписывать сертификатом организации» позволяет использовать для подписания запросов только сертификат врача. Поле «Сертификат организации» в этом случае скрывается с формы.
В разделе «Получение СНИЛС и ОМС (Сервис обогащения СНИЛС)» подключается сервис получения данных о СНИЛС и ОМС физического лица из сервиса N3.Health.
Для настройки:
- Включите флаг «Использовать», чтобы активировать использование сервиса.
- Установите флаг «Автоматически получать данные», чтобы после создания физлица автоматически формировался запрос в сервис на получение данных СНИЛС и ОМС.
- В поле «Авторизационный токен (GUID)» укажите данные из личного кабинета сервиса.
- Заполните поле «Адрес API сервиса».
Настройки соответствия выгрузки мед. документов
- Добавьте типы медицинских документов из списка подготовленных в формате CDA или PDF/A-1 (формат определяется Минздравом), которые необходимо выгружать в ЕГИСЗ.
- Установите соответствие между OID документа и типом медицинской записи. Исключение составляют документы, для которых тип медицинской записи не используется, например, документы, формируемые не по одной конкретной медицинской записи, а агрегирующие сведения из медицинских записей разных типов (например, «Эпикриз выписной»).
- Для документов в формате PDF/A-1 необходимо указать печатную форму.
Формат PDF/A-1 используется только при прямой интеграции с ЕГИСЗ, N3.Health не поддерживает передачу файлов формата PDF/A-1.
Настройка мед. показателей
Настройте соответствие медицинских показателей, используемых в программе при заполнении медицинских записей, полям подготовленных CDA-документов. Значения будут заполняться из документа «Медицинская запись» или по последним данным пациента (если отправляемый документ агрегирует сведения из медицинских записей разных типов).
Настройка справочников по минздраву
Синхронизируйте внутренние справочники программы с официальными классификаторами Минздрава:
- Если справочник пустой — заполните его, выполнив загрузку данных из справочника Минздрава.
- Если справочник уже содержит данные — вручную сопоставьте его элементы с элементами справочника Минздрава: для этого в карточке каждого элемента заполните реквизит «Код Минздрава».
- Если справочник заполнен частично — сопоставьте его элементы с элементами справочника Минздрава и выполните выборочную загрузку недостающих элементов.
Если в справочнике уже есть элемент с указанным кодом Минздрава, повторная загрузка элемента с таким же кодом невозможна.
Если справочники не заполнены или не содержат элементов с указанным кодом Минздрава, они будут подсвечиваться красным цветом.
Если в настройках соответствия выгрузки мед. документов указаны типы медзаписей, у которых не заполнен код Минздрава, появится сообщение об ошибке с возможностью открыть список типов медзаписей, требующих указания кода.
Если код Минздрава не указан в специальности или должности сотрудников, оказывающих услуги, связанные с типами медзаписей из настроек соответствия выгрузки мед. документов, появится сообщение об ошибке с возможностью открыть список таких сотрудников.
Сертификаты электронной подписи
Добавьте сертификаты для подписания отправляемых документов.
Протоколы отправки мед. документов
Все результаты отправки документов в ЕГИСЗ фиксируются в журнале «Протоколы регистрации документов в ЕГИСЗ».
Отправка документов
В карте пациента нажмите кнопку ЕГИСЗ — Отправить мед.документ и выберите тип документа для отправки.
Если документ сформирован без ошибок, отобразится статус «Документ готов к отправке», перечень объектов в чек-листе подсветится зеленым цветом.
Нажмите кнопку Подписать и отправить.
При наличии ошибок настройки отображается статус «Есть ошибки». Объекты, по которым выявлены ошибки (например, отсутствие или некорректное указание обязательных данных), подсвечиваются красным цветом и могут быть раскрыты для просмотра подробной информации по параметрам.
При активации опции «Отображать только ошибки» в чек-листе отображаются только те параметры, по которым необходимо внести исправления.
Особенности работы с N3.Health
При интеграции с сервисом N3.Health необходимо учитывать следующие особенности настройки и эксплуатации.
Этапы подключения к сервису
- Регистрация в сервисе N3.Health и получение доступа к тестовой среде.
- Получение из личного кабинета параметров доступа к тестовому контуру: GUID, idLPU, адреса API.
- Настройка доступа в программе «Кинт: Управление санаторием» с использованием данных тестового контура.
- Настройка защищенного соединения — установка OpenVPN (конфигурационные файлы для OpenVPN доступны в личном кабинете N3.Health в разделе «OpenVPN»).
- Тестирование отправки медицинских документов в ЕГИСЗ.
- Переход на промышленную среду:
- получение доступа к промышленному контуру;
- замена параметров доступа в программе;
- переход на использование защищенного соединения ViPNet.
Настройка доступа к сервису N3.Health через прокси-сервер
Доступ к сервису N3.Health может быть организован через прокси-сервер внутри сети медицинской организации. Такой подход позволяет централизованно управлять VPN-подключением и не требует установки OpenVPN непосредственно на сервер с 1С.
Порядок действий:
- Выделите отдельную машину под прокси-сервер
- Подготовьте физический или виртуальный сервер, который будет выполнять роль прокси. Операционная система может быть любой, поддерживающей работу OpenVPN и прокси-сервера (например, Windows Server).
- Установите клиент OpenVPN на прокси-сервер
- Скачайте дистрибутив OpenVPN (версию рекомендует N3.Health) и установите его на выделенном прокси-сервере.
- Настройте VPN-туннель
- Импортируйте конфигурацию туннеля, полученную в личном кабинете N3.Health. Убедитесь, что соединение установлено (например, появился сетевой интерфейс tun0 или в логах OpenVPN отсутствуют ошибки).
- Настройте прокси-сервер
- На том же сервере настройте прокси-сервер, который будет перенаправлять трафик в VPN-туннель. Прокси должен принимать запросы от сервера с «Кинт: Управление санаторием» (или от других серверов в сети) и направлять их в адрес API N3.Health через OpenVPN.
- Настройте «Кинт: Управление санаторием» для работы через прокси
- В конфигурации «Кинт: Управление санаторием» укажите параметры прокси-сервера:
- Адрес прокси: IP-адрес вашего прокси-сервера (внутри локальной сети).
- Порт прокси, заданный вами при настройке прокси.
- При необходимости — логин и пароль для аутентификации на прокси.
- В конфигурации «Кинт: Управление санаторием» укажите параметры прокси-сервера:
- Проверьте доступность сервиса
- Убедитесь, что сервер с программой через настроенный прокси успешно обращается к API N3.Health. Для проверки можно выполнить тестовый запрос или отправить пробный документ из программы в тестовой среде.
Использование расширения (до релиза 25.08)
В версиях программы «Кинт: Управление санаторием» до релиза 25.08 для интеграции с ЕГИСЗ требовалось установить в конфигурацию расширение «Интеграция с ЕГИСЗ» и осуществить публикацию HTTP-сервиса расширения (с отключением аутентификации при входе).
Использование средства шифрования PDF
Использование средства для подготовки PDF-документов (GhostScript) требуется только при прямой интеграции с ЕГИСЗ. Оператор N3.Health не поддерживает отправку файлов в формате PDF/A-1, поэтому при интеграции с N3.Health настройки GhostScript не используются.
- Установите средство шифрования 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.