3. Предварительная настройка

Перед началом работы настройте подключение к сервису записи к врачу N3.Health выполните следующие пункты:

1. Установите и настройте OpenVPN

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

На момент написания руководства есть следующие полезные ссылки:

· Инструкция по настройке OpenVPN (https://api.n3health.ru/wp-content/uploads/2024/04/OpenVPN.docx).

· Рекомендуемая версия OpenVPN — 2.6.10 (https://build.openvpn.net/downloads/releases/OpenVPN-2.6.10-I003-x86.msi).

Для подключения используйте выданные ключи OpenVPN. Срок действия ключей — один год. Новые ключи предоставляются по заявке.

2. Опубликуйте базу на веб-сервере

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

Полный адрес HTTP-сервиса имеет следующий формат:

http(s)://<адрес_сервера>/<имя_базы>/hs/netps

Здесь /hs/netps — типовой путь HTTP-сервисов СЗПВ.

При указании эндпоинта для подключения через OpenVPN используйте только путь и, при необходимости, порт — без протокола и IP-адреса.

3. Получите параметры подключения

Для подключения к сервису получите следующие параметры:

· API сервиса. На момент подготовки руководства: https://api.n3health.ru/szap/

· GUID. Авторизационный токен

· idLPU. Идентификатор медицинской организации, к которой будут направляться обращения

· URL сервиса СЗПВ. На момент подготовки руководства: https://b2b-demo.n3health.ru/FerDtm/services/worker/

Если вы их не получили или потеряли, обратитесь в техническую поддержку N3.Health.

4. Укажите режим работы СЗПВ

При настройке интеграции выберите гибридный режим следующим образом:

Активный режим — для всех функций, кроме передачи слотов. Периодичность запроса справочных данных указывается клиникой, но стандартно является 1 запрос в час. Запросы, связанные с заявками обрабатываются и отсылаются по факту создания и изменения заявок и не участвуют в периодичных запросах.

Пассивный режим — для slots и slotshistory. Эти данные отправляет МИС для Милы, периодичность отправки таких запросов описана в разделе «Панель управления».

Если у вас другой режим обмена, то обратитесь в техподдержку N3.Health.

5. Настройте адрес обращения к МИС

Эндпоинт СЗПВ, указываемый для обращения к МИС через OpenVPN, не должен содержать протокол и IP-адрес хоста. IP-адрес определяется автоматически на сервере OpenVPN. Адрес должен начинаться с символа / либо с двоеточия и номера порта.

Корректные варианты	Некорректные варианты
/Base_Name/hs/netps/	https://212.19.14.184/Base_Name/hs/netps/
:64545/Base_Name/hs/netps/	https://212.19.14.184:64545/Base_Name/hs/netps/

Примечание. Чтобы сервер OpenVPN назначил IP-адрес новому клиенту, подключитесь с выданным ключом OpenVPN и выполните один запрос к серверу СЗПВ.