#Обзор интеграции

Smartica записывает разговор врача с пациентом, формирует стенограмму и возвращает заполненные поля протокола в медицинскую информационную систему (МИС).

Этот раздел предназначен для разработчиков МИС и IT-команд клиник. Если API-интеграция не нужна, используйте ручное копирование результата в МИС.

#Результат интеграции

Врач запускает Smartica из карточки приёма и не вводит логин повторно. После обработки МИС получает:

значения полей своего протокола;
полную стенограмму приёма;
тот же encounter_id, который был передан при запуске.

Передавать отдельные идентификаторы пациента, ФИО или номер карты не требуется. Не добавляйте их в API без согласованной необходимости: поля протокола и стенограмма уже могут содержать медицинские данные.

#Сквозной поток

Врач открывает приём в МИС и нажимает «Smartica».
Бэкенд МИС запрашивает у Smartica одноразовый launch_url.
Браузер врача открывает полученный URL без изменений.
Smartica запрашивает у МИС контекст приёма и список полей протокола через GET.
Врач записывает разговор; Smartica создаёт стенограмму и заполняет поля.
Smartica асинхронно отправляет результат в тот же приём через PUT.

Подробное поведение, включая повторный запуск того же приёма: Запуск из МИС.

#Кто что реализует

Сторона	Ответственность
Ваша МИС	Кнопка запуска, серверный запрос SSO, `GET` контекста приёма, идемпотентный `PUT` результата
Smartica	SSO и Launch URL, интерфейс записи, транскрипция, заполнение полей, отправка результата
Smartica + команда МИС	Настройка окружений, адресов, авторизации, тестового приёма и приёмочный прогон

#Важно: подключение не является self-service

{platform} в примерах — slug клиники в Smartica, выданный при подключении. Одна клиника = одно подключение; филиал получает отдельный slug и отдельный SSO-ключ. Простая подстановка произвольного значения не включает интеграцию.

До разработки запросите в Smartica:

зарегистрированный platform (slug клиники);
точный SSO endpoint и базовый URL окружения;
SSO_KEY;
подтверждённые URL и схему авторизации для вызовов Smartica → МИС.

Smartica должна зарегистрировать и активировать подключение. Процесс описан в онбординге партнёра.

#Действующий контракт

Для нового подключения зафиксируйте один контракт и не меняйте его между тестовым и рабочим окружениями:

Направление	Вызов	Назначение
МИС → Smartica	`POST` SSO endpoint	Получить одноразовый `launch_url`
Smartica → МИС	`GET /…/encounters/{id}`	Получить шаблон и поля приёма
Smartica → МИС	`PUT /…/encounters/{id}`	Сохранить поля и стенограмму

Пути на стороне МИС настраиваются при подключении. В документации используется рекомендуемый пример /api/smartica/encounters/{id}.

#Порядок чтения

#Подключение

Напишите на support@smartica.ai или через форму поддержки. Укажите название МИС, клинику, окружения и контакт разработчика.