Оглавление 
Описание
Данный документ является предварительным описанием интерфейса взаимодействия партнёров-сервисов сквозной аналитики для получения информации о записях пациентов и спецразмещениях на ПроДокторов.
Предполагается, что партнёр имеет прямую интеграцию с МИС клиники и получает информацию о пациенте, враче, дате и времени приёма, статусе приёма (создан / отменён / выполнен) напрямую из МИС. В следствие чего, предполагается, что партнёр на своей стороне определяет, какой из приёмов в МИС был создан через ПроДокторов по информации о дате и времени создания приёма и номеру телефона пациента.
Методы API
Во всех методах API используется пагинация.
Справочник ЛПУ
Необходим для сопоставления ЛПУ в базе продуктов МедРокет с базой партнёра.
Для взаимодействия будет предоставлен доступ к существующему методу GET /models/lpu/, либо создан аналогичный.
В ответе на запрос возвращается информация о доступных для интеграции филиалах (включили интеграцию с сервисом сквозной аналитики в личном кабинете МедФлекса). Ключевая информация:
- lpu_id - ID филиала клиники (ЛПУ). Используется в других сущностях: приёмы, спецразмещения.
- Название, адрес, город, координаты - информация для сопоставления с базой филиалов сервиса.
Ответ файлом get_lpus-response.json
Создание и обновление приёмов
GET /analytics/prodoctorov/appointments/
Будет возвращать обновления записей, которые произошли вчера:
- создание новых
- отмена
- перенос ранее созданных
Ответ файлом get_prodoctorov_appointments-response
Спецразмещения
GET /analytics/prodoctorov/special_placements/
Будет возвращать информацию о спецразмещениях, которые были вчера.
Ответ файлом get_prodoctorov_special_placements-response
Рекомендации по реализации
Информация о расходах (приёмы и спецразмещения) доступна только за последние календарные сутки (по МСК) и не меняется в течение текущих суток. Поэтому, всю информацию партнёру достаточно запрашивать один раз в сутки и сохранять на своей стороне. При этом, статус приёмов необходимо актуализировать каждые сутки - если приём отменён или перенесён, то эта информация будет в ответе по методу GET /analytics/prodoctorov/appointments/
Для регулярного сбора актуальной информации достаточно завести регулярно выполняющуюся задачу, которая ежедневно 1 раз в сутки будет делать следующие действия:
1) Собирать всю информацию об обновлении приёмов и актуализировать данные в своей базе:
- сохранять новые приёмы
- отмечать ранее сохраненные новые приёмы как отменённые и фиксировать возврат средств
- сверять запись в МИС клиники после переноса
2) Собирать всю информацию о спецразмещениях и сохранять в своей базе данных.