Содержание: 
- Описание процесса взаимодействия по функционалу лидогенерации
- Получение общего списка клиник от МедФлекс
- Получение белого списка клиник от Лидогенератора
- Получение списка клиник, включивших интеграцию с Лидогенератором от МедФлекса
- Актуализация белого списка в МедФлекс
- Включение интеграции клиниками
- Разблокировка возможности онлайн-записи для Лидогенератора
- Отправка МедФлексом уведомления о статусе доступности / недоступности клиники для онлайн-записи
- Онлайн-запись пациента на приём к врачу
- Запросы в API
- Процесс тестирования
- Этапы реализации интеграции
Данная статья призвана помочь сервисам, предоставляющим генерацию лидов(далее лидогенерация) в интеграции с МедФлексом.
Важно! Если у вас остались вопросы или вы столкнули с проблемой не описанной в данной статье, свяжитесь с вашим личным менеджером
Функционал, необходимый для лидогенерации:
- Белый список клиник Лидогенератора
- Уведомления о доступности клиники для онлайн-записи
- Онлайн-запись пациента на приём к врачу
Описание процесса взаимодействия по функционалу лидогенерации 
Получение общего списка клиник от МедФлекс 
Лидогенератор получает от МедФлекс общий список ID клиник, в которых возможна онлайн-запись по лидогенерации (у клиники имеется интеграция онлайн-записи с МедФлекс и хотя бы 1 врач, сопоставленный с ПроДокторов)
- Метод МедФлекс – GET /models/lpu/all/
Получение белого списка клиник от Лидогенератора 
МедФлекс получает от Лидогенератора список ID клиник, по которым Лидогенератор готов делать онлайн-запись. При этом МедФлекс также уведомляет клиники из белого списка о том, что им доступна интеграция и функционал лидогенерации на площадке Лидогенератора.
- Метод Лидогенератора – GET /lpu_whitelist/
Ответ по методу всегда должен содержать актуальный список клиник со стороны Лидогенератора. Клиникам, не попавшим в этот список, будет недоступен функционал лидогенерации.
Получение списка клиник, включивших интеграцию с Лидогенератором от МедФлекса 
Успешный ответ содержит список клиник, удовлетворяющих обоим условиям:
- клиника включена в белый список Лидогенератора
- клиника включила интеграцию с Лидогенератором в личном кабинете МедФлекс
- Метод МедФлекс – GET /models/lpu/
Актуализация белого списка в МедФлекс 
МедФлекс 1 раз в час опрашивает метод с белым списком клиник, актуализирует данные на своей стороне и дает возможность включить лидогенерацию только тем клиникам, которые были возвращены методом белого списка клиник со стороны Лидогенератора.
Если клиника была исключена Лидогенератором из своего белого списка, МедФлекс отправит ей уведомление о недоступности функционала лидогенерации на площадке Лидогенератора. Повторное включение интеграции клиникой возможно только вручную в личном кабинете МедФлекс.
Включение интеграции клиниками 
Менеджер клиники, которой доступна интеграция с Лидогенератором, включает её в личном кабинете МедФлекс
Разблокировка возможности онлайн-записи для Лидогенератора 
Лидогенератору становится доступна онлайн-запись по лидогенерации сразу после включения интеграции клиникой в личном кабинете МедФлекс
Отправка МедФлексом уведомления о статусе доступности / недоступности клиники для онлайн-записи 
Отправка запроса на переключение клиники в статус «недоступна» происходит после выполнения какого-либо из условий:
- Автоматического обнаружения технических проблем с онлайн-записью
- Выявления недостаточности средств на счёте клиники для оплаты записи
- Расторжения договора с продуктами МедРокет
- Отключения интеграции с Лидогенератором в личном кабинете МедФлекс
- Закрытия клиники на ПроДокторов
Отправка запроса на переключение клиники в статус «доступна» происходит после того, как все указанные причины недоступности клиники были исправлены
Онлайн-запись пациента на приём к врачу 
Лидогенератор отправляет запрос на создание онлайн-записи к врачу со своей площадки. МедФлекс фиксирует сумму оплаты за данный лид по согласованному в договоре прайс-листу
Запросы в API 
Группы методов API МедФлекс для создания онлайн-записи 
Запрос со статусом доступности / недоступности клиники для онлайн-записи 
Веб-хук для получения уведомлений реализовывается на стороне Лидогенератора
Пример запроса от МедФлекс:
{
"id": int,
"status": int,
"reason": int,
"timestamp": str,
}
Описание:
id: ID клиники, полученный через /v1/models/lpu/all/
status: 0 - недоступна, 1 - доступна
reason: Передается только, если status == 0
Возможные ответы:
1 - Недоступна из-за проблем с онлайн записью.
2 - Недоступна из-за недостаточного количества средств
3 - Расторжение договора
4 - Клиника отключила интеграцию
5 - Клиника закрылась
timestamp: Время возникновения события. Формат: "2025-02-27T16:26:03.419752"
Процесс тестирования 
Тестирование проходит в 3 этапа:
- Тестирование на тестовых клиниках
- Тестирование на реальных клиниках с имитацией записи в МИС (без реальной записи в МИС)
- Пилотный запуск с реальной клиникой
На 1 и 2 этапе используется один токен для тестирования. При проведении пилота будет выдан новый токен.
Этапы реализации интеграции 
- Подписание договора между Лидогенератором и МедФлексом с фиксацией стоимости лидов по городам
- Отправка тестового токена Лидогенератору
- Разработка интеграции Лидогенератором с промежуточным тестированием на тестовых клиниках
- Тестирование полной цепочки взаимодействия на тестовых клиниках
- Тестирование на реальных клиниках с имитацией записи в МИС (без реальной записи в МИС)
- Отправка production-токена Лидогенератору
- Пилотный запуск с реальной клиникой