Интеграция с ЕГИСЗ (КУС) — различия между версиями
(→Протоколы отправки мед. документов) |
(→N3.Health) |
||
| (не показаны 32 промежуточные версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
| − | <noinclude>[[Категория: История болезни (КУС)]] | + | <noinclude>[[Категория:История болезни (КУС)]] |
| − | [[Категория: Интеграция с внешними сервисами (КУС)|Е]]</noinclude> | + | [[Категория:Интеграция с внешними сервисами (КУС)|Е]]</noinclude> |
{| align="right" | {| align="right" | ||
| __TOC__ | | __TOC__ | ||
| Строка 8: | Строка 8: | ||
* через оператора N3.Health. | * через оператора N3.Health. | ||
| − | == Настройка интеграции | + | == Настройка интеграции == |
Настройки интеграции выполняются в интерфейсе «Администратор системы» на закладке '''Медицина''' в разделе «Интеграция с ЕГИСЗ». | Настройки интеграции выполняются в интерфейсе «Администратор системы» на закладке '''Медицина''' в разделе «Интеграция с ЕГИСЗ». | ||
В окне настроек интеграции представлен перечень пунктов, по каждому из которых открывается отдельное окно для внесения необходимых параметров. | В окне настроек интеграции представлен перечень пунктов, по каждому из которых открывается отдельное окно для внесения необходимых параметров. | ||
| − | :[[Файл:Адм. системы Настройки ЕГИСЗ.png|720px]] | + | : [[Файл:Адм. системы Настройки ЕГИСЗ.png|720px]] |
=== Доступ к сервису === | === Доступ к сервису === | ||
| − | + | Включите опцию «Использовать интеграцию с ЕГИСЗ» и выберите оператора: ЕГИСЗ или N3.Health. | |
| − | Включите опцию | ||
В зависимости от выбранного оператора открывается соответствующая форма с набором полей для настройки доступа. | В зависимости от выбранного оператора открывается соответствующая форма с набором полей для настройки доступа. | ||
==== ЕГИСЗ ==== | ==== ЕГИСЗ ==== | ||
| − | :[[Файл: Доступ к сервису ЕГИСЗ.png|720px]] | + | : [[Файл:Доступ к сервису ЕГИСЗ.png|720px]] |
Для подключения к сервису ЕГИСЗ укажите: | Для подключения к сервису ЕГИСЗ укажите: | ||
| − | # Адрес | + | # Адрес сервиса — адрес сервиса ЕГИСЗ, на который будет осуществляться отправка файлов. |
| − | # Адрес | + | # Адрес публикации http-сервиса — адрес [[1С8:Публикация информационной базы 1С на веб-сервере#Публикация базы без авторизации|опубликованного http-сервиса]] конфигурации «Кинт: Управление санаторием» KintEGISZ для приема запросов от внешнего сервиса. Имеет вид: https://АДРЕС_СЕРВЕРА/ИМЯ_БАЗЫ/hs/KintEGISZ/ххх. Публикация выполняется с использованием ssl. |
| − | # Идентификатор ИС в | + | # Идентификатор ИС в ИПС — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в подсистеме интеграции прикладных систем (ИПС). Значение идентификатора имеет вид: fbd33aa5-5b3a-4586-b01a-9896ef4ce2fe. |
| − | # Идентификатор ИС | + | # Идентификатор ИС РЭМД — идентификатор опубликованной информационной базы «Кинт: Управление санаторием» в реестре электронных медицинских документов (РЭМД). Значение идентификатора имеет вид: emdr-rmis-11. |
| − | # Каталог | + | # Каталог GhostScript — путь к каталогу установленного ПО для шифрования PDF-документов. |
| − | + | Адрес сервиса ЕГИСЗ и идентификаторы ИС в ИПС и РЭМД предоставляется службой технической поддержки ЕГИСЗ по заявке на регистрацию и подключение информационной системы. | |
| + | |||
| + | В поле «Сертификат организации» отображается актуальный электронный сертификат организации. | ||
| + | |||
| + | Активация опции «Отключить проверку сертификатов» отключает проверку регистрации сертификатов электронной подписи в ЕГИСЗ. Используется для отправки запросов в тестовую среду РЭМД. | ||
| + | |||
После заполнения данных доступа нажмите кнопку '''''Записать и закрыть'''''. | После заполнения данных доступа нажмите кнопку '''''Записать и закрыть'''''. | ||
==== N3.Health ==== | ==== N3.Health ==== | ||
| − | :[[Файл:Доступ к сервису N3.png|720px]] | + | Перед настройкой рекомендуется ознакомиться с [[#Особенности работы с 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 (формат определяется Минздравом), которые необходимо выгружать в ЕГИСЗ. | * Добавьте типы медицинских документов из списка подготовленных в формате CDA или PDF/A-1 (формат определяется Минздравом), которые необходимо выгружать в ЕГИСЗ. | ||
* Установите соответствие между OID документа и типом медицинской записи. Исключение составляют документы, для которых тип медицинской записи не используется, например, документы, формируемые не по одной конкретной медицинской записи, а агрегирующие сведения из медицинских записей разных типов (например, «Эпикриз выписной»). | * Установите соответствие между OID документа и типом медицинской записи. Исключение составляют документы, для которых тип медицинской записи не используется, например, документы, формируемые не по одной конкретной медицинской записи, а агрегирующие сведения из медицинских записей разных типов (например, «Эпикриз выписной»). | ||
| − | * Для документов в формате PDF/A-1 необходимо указать печатную форму. | + | * Для документов в формате PDF/A-1 необходимо указать печатную форму. |
Формат PDF/A-1 используется только при прямой интеграции с ЕГИСЗ, N3.Health не поддерживает передачу файлов формата PDF/A-1. | Формат PDF/A-1 используется только при прямой интеграции с ЕГИСЗ, N3.Health не поддерживает передачу файлов формата PDF/A-1. | ||
| − | :[[Файл:ЕГИСЗ Соответствие медицинских документов.png|720px]] | + | : [[Файл:ЕГИСЗ Соответствие медицинских документов.png|720px]] |
=== Настройка мед. показателей === | === Настройка мед. показателей === | ||
Настройте соответствие медицинских показателей, используемых в программе при заполнении медицинских записей, полям подготовленных CDA-документов. Значения будут заполняться из документа «Медицинская запись» или по последним данным пациента (если отправляемый документ агрегирует сведения из медицинских записей разных типов). | Настройте соответствие медицинских показателей, используемых в программе при заполнении медицинских записей, полям подготовленных CDA-документов. Значения будут заполняться из документа «Медицинская запись» или по последним данным пациента (если отправляемый документ агрегирует сведения из медицинских записей разных типов). | ||
| − | :[[Файл:ЕГИСЗ Соответствие медпоказателей и полей CDA.png|720px]] | + | : [[Файл:ЕГИСЗ Соответствие медпоказателей и полей CDA.png|720px]] |
=== Настройка справочников по минздраву === | === Настройка справочников по минздраву === | ||
Синхронизируйте внутренние справочники программы с официальными классификаторами Минздрава: | Синхронизируйте внутренние справочники программы с официальными классификаторами Минздрава: | ||
| − | # Если справочник | + | # Если справочник пустой — заполните его, выполнив загрузку данных из справочника Минздрава. |
| − | # Если справочник уже содержит | + | # Если справочник уже содержит данные — вручную сопоставьте его элементы с элементами справочника Минздрава: для этого в карточке каждого элемента заполните реквизит «Код Минздрава». |
| − | # Если справочник заполнен | + | # Если справочник заполнен частично — сопоставьте его элементы с элементами справочника Минздрава и выполните выборочную загрузку недостающих элементов. |
| − | Если в справочнике уже есть элемент с указанным кодом Минздрава, | + | Если в справочнике уже есть элемент с указанным кодом Минздрава, повторная загрузка элемента с таким же кодом невозможна. |
| − | :[[Файл:ЕГИСЗ Справочники по минздраву.png|720px]] | + | : [[Файл:ЕГИСЗ Справочники по минздраву.png|720px]] |
Если справочники не заполнены или не содержат элементов с указанным кодом Минздрава, они будут подсвечиваться красным цветом. | Если справочники не заполнены или не содержат элементов с указанным кодом Минздрава, они будут подсвечиваться красным цветом. | ||
| Строка 75: | Строка 96: | ||
=== Сертификаты электронной подписи === | === Сертификаты электронной подписи === | ||
Добавьте сертификаты для подписания отправляемых документов. | Добавьте сертификаты для подписания отправляемых документов. | ||
| − | :[[Файл:Сертификаты электронной подписи.png|800px]] | + | : [[Файл:Сертификаты электронной подписи.png|800px]] |
=== Протоколы отправки мед. документов === | === Протоколы отправки мед. документов === | ||
Все результаты отправки документов в ЕГИСЗ фиксируются в журнале «Протоколы регистрации документов в ЕГИСЗ». | Все результаты отправки документов в ЕГИСЗ фиксируются в журнале «Протоколы регистрации документов в ЕГИСЗ». | ||
| − | :[[Файл:Протоколы регистрации.png|800px]] | + | : [[Файл:Протоколы регистрации.png|800px]] |
| + | |||
| + | == Отправка документов == | ||
| + | В карте пациента нажмите кнопку '''''ЕГИСЗ''''' — '''''Отправить мед.документ''''' и выберите тип документа для отправки. | ||
| + | |||
| + | Если документ сформирован без ошибок, отобразится статус «Документ готов к отправке», перечень объектов в чек-листе подсветится зеленым цветом. | ||
| + | |||
| + | Нажмите кнопку '''''Подписать и отправить'''''. | ||
| + | : [[Файл:Отправка данных в ЕГИСЗ.png|800px]] | ||
| + | |||
| + | При наличии ошибок настройки отображается статус «Есть ошибки». Объекты, по которым выявлены ошибки (например, отсутствие или некорректное указание обязательных данных), подсвечиваются красным цветом и могут быть раскрыты для просмотра подробной информации по параметрам. | ||
| + | |||
| + | При активации опции «Отображать только ошибки» в чек-листе отображаются только те параметры, по которым необходимо внести исправления. | ||
| + | :[[Файл:Отправка данных в ЕГИСЗ (есть ошибки).png|800px]] | ||
| + | |||
| + | == Особенности работы с N3.Health == | ||
| + | |||
| + | При интеграции с сервисом N3.Health необходимо учитывать следующие особенности настройки и эксплуатации. | ||
| + | |||
| + | === Этапы подключения к сервису === | ||
| + | |||
| + | # Регистрация в сервисе N3.Health и получение доступа к тестовой среде. | ||
| + | # Получение из личного кабинета параметров доступа к тестовому контуру: GUID, idLPU, адреса API. | ||
| + | #: [[Файл:N3 Данные из лк.png|700px]] | ||
| + | # Настройка доступа в программе «Кинт: Управление санаторием» с использованием данных тестового контура. | ||
| + | # Настройка защищенного соединения — установка 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 для интеграции с ЕГИСЗ требовалось [[Инструкция по установке расширений|установить в конфигурацию расширение]] «Интеграция с ЕГИСЗ» и осуществить [[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="SERVER";Ref="BASE";Usr="LOGIN";Pwd="PASSWORD";enable="false";"</source> | # В созданном файле публикации необходимо отключить аутентификацию при входе. Для отключения запроса пароля нужно в файле публикации Default.vrd прописать логин/пароль по умолчанию, пример: <source lang="xml"> ib="Srvr="SERVER";Ref="BASE";Usr="LOGIN";Pwd="PASSWORD";enable="false";"</source> | ||
# Установите [https://www.ghostscript.com/releases/gsdnld.html средство шифрования PDF] | # Установите [https://www.ghostscript.com/releases/gsdnld.html средство шифрования PDF] | ||
# Установите цветовые профили для GhostScript: | # Установите цветовые профили для GhostScript: | ||
| − | #*Скачайте AdobeRGB1998.icc по ссылке https://www.adobe.com/support/downloads/iccprofiles/icc_eula_win_end.html, рекомендуется версия не выше 9.26. | + | #* Скачайте AdobeRGB1998.icc по ссылке https://www.adobe.com/support/downloads/iccprofiles/icc_eula_win_end.html, рекомендуется версия не выше 9.26. |
#* Скопируйте файл AdobeRGB1998.icc в каталог, например, в папку lib программы GhostScript. | #* Скопируйте файл AdobeRGB1998.icc в каталог, например, в папку lib программы GhostScript. | ||
#* Внесите изменения в файл PDFA_def.ps, находящийся в папке lib программы GhostScript: | #* Внесите изменения в файл PDFA_def.ps, находящийся в папке lib программы GhostScript: | ||
| Строка 96: | Строка 190: | ||
# Сделайте настройку интеграции с ЕГИСЗ (в [[Параметры работы системы (КУС)#Интеграция с ЕГИСЗ|интерфейсе «Администратор системы» по кнопке '''Перейти''' пункт '''Настройки интеграции с ЕГИСЗ''']]). Также открыть настройку можно через вкладку '''Медицина''' — '''Настройки интеграции с ЕГИСЗ''' | # Сделайте настройку интеграции с ЕГИСЗ (в [[Параметры работы системы (КУС)#Интеграция с ЕГИСЗ|интерфейсе «Администратор системы» по кнопке '''Перейти''' пункт '''Настройки интеграции с ЕГИСЗ''']]). Также открыть настройку можно через вкладку '''Медицина''' — '''Настройки интеграции с ЕГИСЗ''' | ||
# На форме укажите следующие параметры подключения программы «Кинт: Управление санаторием» к ЕГИСЗ и документы, которые вы хотите в эту систему отправлять: | # На форме укажите следующие параметры подключения программы «Кинт: Управление санаторием» к ЕГИСЗ и документы, которые вы хотите в эту систему отправлять: | ||
| − | ## Адрес Сервиса | + | ## Адрес Сервиса ЕГИСЗ — адрес сервиса ЕГИСЗ на который будет осуществляться отправка файлом. |
| − | ## Адрес Публикации | + | ## Адрес Публикации Базы — Адрес опубликованного 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. Например, | + | ## Заполните таблицу кодов OID медицинских записей из справочника документов ЕГИСЗ https://nsi.rosminzdrav.ru/dictionaries/1.2.643.5.1.13.13.11.1520/passport/12.2. Например, «77 (Эпикриз в стационаре выписной)» может выгружать только в формате XML. |
# В [[Карта пациента (КУС)#Форма карты пациента|карте пациента]] нажмите кнопку '''''Отправить в ЕГИСЗ'''''. | # В [[Карта пациента (КУС)#Форма карты пациента|карте пациента]] нажмите кнопку '''''Отправить в ЕГИСЗ'''''. | ||
#: Если настроена отправка только одного документа, при нажатии на эту кнопку откроется его печатная форма, которую можно отправить. Если настроена отправка нескольких документов — откроется окно со списком документов, указанных в [[Параметры работы системы (КУС)#Интеграция с ЕГИСЗ|настройке интеграции с ЕГИСЗ]], выберите документ, который нужно отправить. Откроется его печатная форма, которую можно отправить с помощью кнопки '''''Подписать и отправить'''''. | #: Если настроена отправка только одного документа, при нажатии на эту кнопку откроется его печатная форма, которую можно отправить. Если настроена отправка нескольких документов — откроется окно со списком документов, указанных в [[Параметры работы системы (КУС)#Интеграция с ЕГИСЗ|настройке интеграции с ЕГИСЗ]], выберите документ, который нужно отправить. Откроется его печатная форма, которую можно отправить с помощью кнопки '''''Подписать и отправить'''''. | ||
# При отправке документа в ЕГИСЗ в программе «Кинт: Управление санаторием» формируется сообщение — электронное письмо, в приложении к которому находится печатная форма отправленного документа. Все сообщения обмена данными с ЕГИСЗ хранятся в журнале «Сообщения обмена с ЕГИСЗ», который доступен в разделе МЕДИЦИНА — '''Медицинские записи'''.--> | # При отправке документа в ЕГИСЗ в программе «Кинт: Управление санаторием» формируется сообщение — электронное письмо, в приложении к которому находится печатная форма отправленного документа. Все сообщения обмена данными с ЕГИСЗ хранятся в журнале «Сообщения обмена с ЕГИСЗ», который доступен в разделе МЕДИЦИНА — '''Медицинские записи'''.--> | ||
Текущая версия на 09:43, 13 апреля 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
Перед настройкой рекомендуется ознакомиться с особенностями работы с сервисом N3.Health.
Электронная медицинская карта (ИЭМК)
В разделе заполняются данные для доступа к сервису N3.Health:
- Авторизационный токен (GUID)
- Идентификатор МО idLPU (idLPU)
- Адрес API сервиса работы с ИЭМК
- Адрес API сервиса работы с пациентами(Pix)
Данные для заполнения доступны в личном кабинете сервиса N3.Health в разделе «ИЭМК».
|
Важно: данные в разделе потребуется заполнить дважды: на этапе отладки и тестирования вносятся данные из демонстрационного контура (тестовой среды); после получения доступа к промышленному контуру (рабочей среде) эти настройки требуется заменить на данные из промышленного контура. |
Получение СНИЛС и ОМС (Сервис обогащения СНИЛС)
В разделе можно подключить сервис, который автоматически получает данные СНИЛС и ОМС физического лица из N3.Health и дополняет карточку физического лица этими сведениями. Сервис работает только в промышленном контуре.
Для настройки:
- Включите опцию «Использовать» для работы с сервисом.
- Включите опцию «Автоматически получать данные», чтобы после сохранения карточки физического лица автоматически отправлялся запрос в сервис на получение данных СНИЛС и ОМС.
- При отключенной опции запрос можно отправить вручную с помощью соответствующей кнопки в карточке физического лица.
- В поле «Авторизационный токен (GUID)» укажите данные параметра из личного кабинета сервиса (раздел «Сервис обогащения СНИЛС»).
- Заполните поле «Адрес API сервиса» (если не заполнилось автоматически).
Принцип работы: запрос отправляется автоматически при сохранении карточки физического лица или вручную по кнопке. Данные СНИЛС и ОМС появляются в карточке физического лица примерно через 10 минут. Статусы получения можно отслеживать в журнале получения СНИЛС и ОМС. Список обязательных полей, которые необходимо заполнить в карточке физического лица: фамилия имя, отчество (при наличии), дата рождения, пол, серия, номер, орган и дата выдачи основного удостоверения личности.
Электронный сертификат
В поле «Сертификат организации» отображается актуальный электронный сертификат организации.
Активация опции «Не подписывать сертификатом организации» позволяет использовать для подписания запросов только сертификат врача. Поле «Сертификат организации» в этом случае скрывается с формы.
Настройки соответствия выгрузки мед. документов
- Добавьте типы медицинских документов из списка подготовленных в формате CDA или PDF/A-1 (формат определяется Минздравом), которые необходимо выгружать в ЕГИСЗ.
- Установите соответствие между OID документа и типом медицинской записи. Исключение составляют документы, для которых тип медицинской записи не используется, например, документы, формируемые не по одной конкретной медицинской записи, а агрегирующие сведения из медицинских записей разных типов (например, «Эпикриз выписной»).
- Для документов в формате PDF/A-1 необходимо указать печатную форму.
Формат PDF/A-1 используется только при прямой интеграции с ЕГИСЗ, N3.Health не поддерживает передачу файлов формата PDF/A-1.
Настройка мед. показателей
Настройте соответствие медицинских показателей, используемых в программе при заполнении медицинских записей, полям подготовленных CDA-документов. Значения будут заполняться из документа «Медицинская запись» или по последним данным пациента (если отправляемый документ агрегирует сведения из медицинских записей разных типов).
Настройка справочников по минздраву
Синхронизируйте внутренние справочники программы с официальными классификаторами Минздрава:
- Если справочник пустой — заполните его, выполнив загрузку данных из справочника Минздрава.
- Если справочник уже содержит данные — вручную сопоставьте его элементы с элементами справочника Минздрава: для этого в карточке каждого элемента заполните реквизит «Код Минздрава».
- Если справочник заполнен частично — сопоставьте его элементы с элементами справочника Минздрава и выполните выборочную загрузку недостающих элементов.
Если в справочнике уже есть элемент с указанным кодом Минздрава, повторная загрузка элемента с таким же кодом невозможна.
Если справочники не заполнены или не содержат элементов с указанным кодом Минздрава, они будут подсвечиваться красным цветом.
Если в настройках соответствия выгрузки мед. документов указаны типы медзаписей, у которых не заполнен код Минздрава, появится сообщение об ошибке с возможностью открыть список типов медзаписей, требующих указания кода.
Если код Минздрава не указан в специальности или должности сотрудников, оказывающих услуги, связанные с типами медзаписей из настроек соответствия выгрузки мед. документов, появится сообщение об ошибке с возможностью открыть список таких сотрудников.
Сертификаты электронной подписи
Добавьте сертификаты для подписания отправляемых документов.
Протоколы отправки мед. документов
Все результаты отправки документов в ЕГИСЗ фиксируются в журнале «Протоколы регистрации документов в ЕГИСЗ».
Отправка документов
В карте пациента нажмите кнопку ЕГИСЗ — Отправить мед.документ и выберите тип документа для отправки.
Если документ сформирован без ошибок, отобразится статус «Документ готов к отправке», перечень объектов в чек-листе подсветится зеленым цветом.
Нажмите кнопку Подписать и отправить.
При наличии ошибок настройки отображается статус «Есть ошибки». Объекты, по которым выявлены ошибки (например, отсутствие или некорректное указание обязательных данных), подсвечиваются красным цветом и могут быть раскрыты для просмотра подробной информации по параметрам.
При активации опции «Отображать только ошибки» в чек-листе отображаются только те параметры, по которым необходимо внести исправления.
.png)
Особенности работы с 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.
