#Готовый протокол

Этот запрос выполняет ваша МИС, когда доставка — pull. smartica.ai сам протокол не присылает.

Запрос один и тот же для Launch Pull и для Import. Отличается только то, как вы узнаёте, что протокол готов.

Launch Pull. Список фильтруется status=ready и user_email врача. Пошагово в статье Запуск из МИС, протокол забираете вы (Launch Pull).
Import. Сначала привязка. Затем этот запрос, когда у записи status равен ready. Пошагово в статье Запись вне МИС (Import).

#Запрос

GET /api/v1/integrations/{platform}/encounters/{smartica_encounter_id}
Authorization: Bearer <API-ключ клиники>
Accept: application/json

В адресе стоит UUID, который вернул smartica.ai. Не подставляйте ID приёма вашей МИС.

#Ответ

Ответ 200:

{
  "smartica_encounter_id": "7f3a9c2e-4b1e-4a8d-9c3f-2e1a8b4d6f0c",
  "encounter_id": "12345",
  "status": "ready",
  "revision": 1,
  "filled_at": "2026-05-26T14:44:02+00:00",
  "exported_at": null,
  "fields": [
    { "id": "complaints", "value": "Жалобы на давящую боль за грудиной..." },
    { "id": "diagnosis_primary", "value": "Гипертоническая болезнь I ст." }
  ],
  "skipped": [],
  "transcript": "Полная стенограмма разговора врача и пациента...",
  "recorded_at": "2026-05-26T14:30:11+00:00",
  "duration_sec": 742,
  "title": "Приём 26 мая, 14:30"
}

Пока status не равен ready, массив fields пуст. Забирать ещё нечего.

Запомните revision из ответа. Номер нужен для подтверждения.

Launch Pull. Подтверждение описано в шаге 7.
Import. Подтверждение описано в разделе Режим pull: подтвердить получение.

#Какие поля приходят

В fields приходят только поля, для которых в разговоре нашлось содержание. smartica.ai отбрасывает пустые значения и заглушки вроде «не указано». Поле с пустым value в массив не попадает.

Рядом лежит skipped. В каждом элементе есть id поля и причина, почему значения нет. Если врач говорил о поле, но ответ не подошёл, в text лежит его формулировка. Поля из skipped не записывайте и не очищайте. text можно показать врачу как подсказку.

Типы значений описаны в статье Типы полей бланка.

Поля, которых нет в fields, не трогайте. Если очистить такие поля при получении результата, вы сотрёте то, что врач уже заполнил руками. Если значение поля пришло пустым, считайте поле неполученным. Не пишите пустое поле в протокол.

Пустой fields при status: ready тоже допустим. В разговоре не нашлось материала для бланка. Так бывает, когда запись слишком короткая. Стенограмму всё равно сохраните. Если пустой протокол повторяется, причина почти всегда в label. По названиям полей непонятно, что в поле класть.

status в этом ответе — состояние забора. ready значит, что протокол можно сохранять. Это не saved из ответа вашего PUT и не accepted из ответа ack.