Подключение интеграторов самозаписи

Эта статья предназначена для клиник, которые подключаются к внешним сервисам самозаписи (СберЗдоровье, ПроДокторов, НаПоправку и др.), использующим API МИС Renovatio.

Инструкция включает:

• базовую настройку API
• перечень необходимых методов
• подготовку данных в самой МИС для корректной работы интеграции

Для настройки интеграций с сервисами, которые используют API МИС Renovatio необходимо в разделе «Интеграции → API-ключ» и набор методов.

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

Создание API-ключа

Для создания API-ключа 

1. Перейдите в модуль «Интеграции → API-ключи»
   
2. Нажмите кнопку «Новый ключ»
3. Укажите название — обязательный блок для заполнения и доступные методы и выберите необходимые методы доступа
   
   Например:
   
4. Нажмите кнопку «Сохранить»

Получение ID рекламного канала и ID источника записи

Чтобы найти ID рекламного канала:

1. Перейдите в модуль «Картотека → Рекламные каналы»
   
2. В поле ID указан ID рекламного канала 
   

Чтобы найти ID источника записи:

1. Перейдите в модуль «Настройки → Визиты»
   
2. Перейдите в раздел «Источники»
   
3. В блоке ID указан ID источника записи
   

Что нужно настроить в МИС для корректной работы с порталами

⚠️ Эти настройки обязательны. Без них интеграция может работать некорректно или не работать вовсе.

1. Услуги: актуализировать длительность

Первый вариант, через редактирование услуг

1. Перейдите в модуль «Услуги» 
   
2. Откройте карточку каждой услуги и укажите длительность (в минутах)

Второй вариант, через выгрузку прейскуранта: 

1. В модуле услуги перейдите в раздел «Выгрузка»
   
2. Сформируйте нужный запрос и выгрузите прейскурант нажав на кнопку «Загрузить»
3. В скаченном файле заполните колонку «Длительность»
   
4. Перейдите во вкладку «Импорт» и загрузите изменённый файл
   

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

2. Врачи: заполнить карточки

📌 Доступные клиники

1. Перейдите в модуль «Персонал → Сотрудники» 
   
2. Откройте карточку врача
3. В поле «Доступные клиники» выберите все филиалы, где врач принимает
   

📌 Услуги

1. Перейдите в модуль «Персонал → Сотрудники»
2. Откройте карточку врача
3. Перейдите в раздел «Услуги» 
   
4. Проставьте флаги «Оказывает» / «Не оказывает» для каждой услуги
   
5. Можно использовать дерево категорий, чтобы массово применить настройки по категориям
   
   

📌 Длительность первичного приёма

1. Перейдите в модуль «Персонал → Сотрудники»
2. Откройте карточку врача
3. Укажите среднее время первичного визита
   

3. График работы врача

1. Перейдите в модуль «Персонал → Сотрудники»
2. Откройте карточку врача
3. Перейдите в раздел «График работы»
   
4. Проверьте, что у врача сформирован график работы
5. В расписании должны быть доступные интервалы (слоты) на ближайшие:
   — 7 дней — для СберЗдоровья
   — 14 дней — для ПроДокторов
   — 30 дней — для НаПоправку (может отличаться в зависимости от портала)

⚠️ Важно: график на портале строится по слотам, нарезанным от начала приёма. Если в графике нет свободных промежутков по длительности первичного визита, слот не будет отображён.

Примечание

• Некоторые порталы используют параметр use_doctor_avg_time — он позволяет учитывать среднюю длительность визита, указанную в карточке врача
• Подключение новых рекламных каналов и источников самозаписи производится через стандартные интерфейсы МИС и не требует обращения в поддержку

Что дальше

После выполнения всех шагов:

• передайте порталу API-ключ, ID рекламного канала и ID источника
• при возникновении ошибок проверьте, выполнены ли все пункты выше
• направляйте коллег и клиентов на эту статью вместо неактуальных инструкций в файлах.

Это поможет:

• сократить число обращений в поддержку
• обеспечить корректную работу интеграции
• избежать дублирования и устаревших версий инструкций

Методы 

СберЗдоровье

Сайт отзывов о врачах и сервис самозаписи

• getClinics
• getProfessions
• getUsers
• getServiceCategories
• getServices
• getScheduleCategories
• getSchedule
• createAppointment
• cancelAppointment
• confirmAppointment

Продокторов

Сайт отзывов о врачах и сервис самозаписи.
Для подключения нужно: Создать апи ключ, указать набор методов:

• getClinics
• getProfessions
• getUsers
• getServiceCategories
• getServices
• getScheduleCategories
• getSchedule
• createAppointment
• cancelAppointment
• confirmAppointment

Мы передаем 

• АПИ ключ
• ID рекламного канала (создается свой)
• ID источника записи (создается свой)

Врачи иногда принимают пациентов не стандартное время в 30 минут, а меньше или больше. Чтобы упростить планирование, предлагается использовать параметр use_doctor_avg_time, который учитывает среднее время приема врача в методе getSchedul.

НаПоправку

Сайт отзывов о врачах и сервис самозаписи.
Для подключения нужно: Создать апи ключ, указать набор методов:

• getClinics
• getProfessions
• getUsers
• getServiceCategories
• getServices
• getScheduleCategories
• getSchedule
• createAppointment
• cancelAppointment
• confirmAppointment