Содержание 
- Сценарий 1. Отмена администратором клиники
- Сценарий 2. Отмена по API МедФлекс
- Сценарий 3. Прочие источники отмены
(В разработке)
Данная статья описывает все возможные сценарии работы обновлённого процесса отмены записей и отвечает на типовые вопросы сервисов-партнёров. Статья будет дополняться и актуализироваться по мере разработки.
Важно! Статья написана относительно внесенных доработок от 18.06.25 и актуальна на период разработки новых методов отмены. Если вы нашли ошибку или непредвиденное поведение в сценариях, пожалуйста, обратитесь к персональному менеджеру за более актуальной информацией.
На данный момент существуют следующие сценарии отмены.
- Отмена в МИС (администратором клиники)
- Отмена через API МедФлекс
В данной статье подробно описаны сценарии, реализованные в новом функционале отмены записей. Все остальные варианты отмены будут поэтапно перенесены на новый механизм в соответствии с планом обновлений данной документации.
Сценарий 1. Отмена администратором клиники
В данном сценарии отмена производится персоналом в МИС (администратором клиники).
В результате отмены в МИС происходит
- Информирование подключенных сервисов с использованием триггерного API функционалом вебхука.
Сценарий 2. Отмена по API МедФлекс (используется метод Patch /appointments/appointments/{uuid}/)
В данном сценарии происходит отмена записи с помощью указанного метода. Это может применяться для записей, сделанных по «открытому токену», а также для записей, созданных сервисами-партнёрами, использующими триггерный API, включая все записи, полученные из МИС.
Важно! Клубные записи и записи на онлайн-консультацию не могут быть отменены сервисами-партнёрами.
Алгоритм отмены следующий:
- Шаг 1. МедФлекс проверяет статус записи в МИС.
- Если запись уже отменена (например, по Сценарию 1), возвращается ответ 200 с текстом: «Запись уже была отменена».
- Шаг 2. МедФлекс проверяет возможность отмены записи в данной МИС.
- Если отмена невозможна, возвращается ответ 400 с текстом: «Отмена недоступна».
- Шаг 3. МедФлекс проверяет возможность отмены конкретной записи.
- Некоторые записи в МИС не подлежат отмене. При попытке их отменить возвращается ответ 400 с текстом: «Отмена недоступна».
- Примечание: Другие записи в этой же клинике могут быть отменены.
- Шаг 4. МедФлекс пытается отменить запись.
- Если МИС возвращает ошибку, возвращается ответ 400 с текстом: «Не удалось отменить запись».
- Шаг 5. Если МИС подтверждает отмену записи:
- API возвращает ответ 200 с текстом: «Успешная отмена»;
- Партнёру отправляется уведомление по электронной почте.
Важно! Если запись была отменена через API, но другим сервисом (например, запись создана по открытому токену с медицинского сайта-агрегатора и затем отменена), то партнёр, подключённый к вебхуку "ХХХХ", также получит уведомление об отмене записи.
Сценарий 3. Прочие источники отмены
Важно! Метод /direct_appointment/doctor/cancel работает по старому механизму с отправкой электронного письма в клинику.
К прочим сценариям относятся:
- Отмена через ПроДокторов
- Отмена через приложение МедТочка
- Отмена через страховую компанию
- Отмена со стороны МедФлекса
Данные сценарии пока не получили изменений в механизм своей работы, ведется разработка.
Важно! Сервис не получает вебхуков, но получит уведомление в течении 12 часов после отмены.