Перейти к основному содержанию
PATCH
Обновить данные записи, например запланированное время или локацию для анализа. Изменять можно только записи, для которых забор крови ещё не подтверждён.
Запись нельзя изменить после подтверждения забора крови или если она уже отменена. Попытка обновить такую запись возвращает 409 Conflict. Единственное исключение — поле results_ready_emails, которое можно изменять и после забора крови.
Требуется область доступа appointments_schedule или appointments_manage.

Запрос

Параметры пути

string
обязательно
Уникальный идентификатор (UUID) записи для обновления.

Параметры тела запроса

Все параметры тела запроса необязательны — передавай только те поля, которые хочешь изменить.
string
Новые дата и время записи в формате ISO 8601 (например, 2026-05-20T14:00:00Z или 2026-05-20T16:00:00+02:00). Обязательно с указанием часового пояса — Z или явное смещение вроде +02:00; значения без часового пояса отклоняются. Время должно быть в будущем.Должно точно совпадать с началом слота со свободными местами — см. Получить доступность. Переносимая запись не учитывается при расчёте мест в выбранном слоте, но перенос на слот, где у того же профиля уже есть другая запись, возвращает 409 с её appointment_id.Если целевая локация находится под управлением Aniva, новое время также должно быть не раньше чем через 12 часов — см. Минимальный срок предупреждения.
string
UUID новой локации для анализа. Локация должна существовать и быть активной. Используй Список локаций, чтобы найти доступные ID локаций.
string[]
Заменяет список до 5 адресов, на каждый из которых придёт одно письмо, когда все лабораторные результаты станут окончательными. Отправь [], чтобы отключить письма. Это поле остаётся доступным для редактирования после забора крови — оно отклоняется только для отменённой записи. После забора крови передавай его отдельно: если в теле запроса есть scheduled_at или location_id, запрос вернёт 409. Твоему ключу нужен доступ results_view к пациенту, иначе вернётся 403. См. Письма о готовности результатов.
string | null
Новый способ забора крови: capillary или venous, либо null, чтобы снова использовать default_draw_method локации. Этот способ должен быть в списке draw_methods локации, а забронированные анализы должны быть возможны с ним, иначе вернётся 400. При переносе записи в другую локацию там выполняется та же проверка: по её собственному draw_method, а если он не задан — по default_draw_method новой локации.

Ответ

При успехе API возвращает 200 OK с обновлённой записью и вложенным профилем.
string
обязательно
Уникальный идентификатор записи (UUID).
string
обязательно
UUID профиля, к которому относится эта запись.
string
UUID локации для сдачи анализов, где проходит забор крови.
string
Запланированные дата и время записи в UTC (ISO 8601 с суффиксом Z, например 2026-05-20T14:00:00Z). Может быть null.
string
обязательно
Текущий статус записи. Одно из значений: pending, confirmed, blood_drawn или cancelled. Детали готовности лабораторных результатов можно получить в Получить результаты, а подробный ход доставки — из каждого элемента встроенного массива shipments (см. ниже) с переходом в Получить отправку.
string
Причина в свободной форме, указанная при отмене записи (например, неявка, поздняя отмена, «Не удалось. Требуется повтор»). Имеет значение null, если status не равен cancelled.
string[]
обязательно
Адреса в нижнем регистре, на каждый из которых приходит одно письмо, когда все результаты лаборатории готовы. Пустой список, если отключено. См. Письма о готовности результатов.
string
обязательно
Способ забора крови: capillary (из пальца или плеча в микротейнеры) или venous (из вены в пробирки). Используется способ, заданный для записи, иначе default_draw_method её локации. После забора крови здесь указан фактически использованный способ.
string
обязательно
Временная метка создания записи в формате ISO 8601.
string
Временная метка последнего обновления в формате ISO 8601. Может быть null.
object
обязательно
Профиль пациента, связанный с этой записью.
AppointmentPanel[]
обязательно
Панели, прикреплённые к этой записи на данный момент. Отменённые прикрепления не включаются. Подробности о панели (название, биомаркеры) можно посмотреть через Список панелей.
AppointmentIndividualBiomarker[]
обязательно
Отдельные биомаркеры, прикреплённые к этой записи вне какой-либо панели (см. Добавить отдельные биомаркеры). Сверь каждый biomarker_id со Списком биомаркеров, чтобы получить данные для отображения.
AppointmentShipmentLink[]
обязательно
Отправления, связанные с этой записью, начиная с самой ранней привязки. Пустой массив, если связанных отправлений нет. Передай каждый id в Получить отправление, чтобы получить полные данные отправления.
string[]
обязательно
Лабораторные коды (штрихкоды пробирок), записанные для этой записи, в порядке сканирования. Список пуст, пока забор крови не подтверждён. При венозном заборе один код напечатан на каждой пробирке; при капиллярном — свой код на каждом микротейнере. Результаты и документы в Получить результаты ссылаются на эти коды через lab_code.

Ответы с ошибками