Перейти к основному содержанию
POST
Сообщи, что пациент собрал образец. Это аналог Подтвердить забор крови для набора для домашнего теста — без штрихкода, потому что код наносится на набор при упаковке. Ты передаёшь только время сбора. Эта отметка времени имеет клиническое значение: именно это время сбора будет указано в лабораторном отчёте. Отправляй фактический момент сбора образца пациентом, а не момент обработки в твоей системе. Повторная отправка того же activated_at возвращает 200 с активированным заказом; другое значение возвращает 409. См. Идемпотентность. Активация переводит заказ в статус activated — конечный статус. Активированный заказ больше нельзя отменить, а его состав и адрес доставки фиксируются. Активация принимается, пока заказ имеет статус pending или dispatched, если у него есть lab_code — набор может оказаться у пациента раньше, чем в нашей системе появится отметка об отправке, и реальное время сбора всегда имеет приоритет над нашим учётом. Заказ без lab_code возвращает 409: без кода образец невозможно сопоставить с пациентом в лаборатории. Активация также оформляет лабораторный заказ для панели набора под кодом lab_code заказа, чтобы лаборатория ожидала образец и результаты могли прикрепиться сразу после их передачи. Это происходит асинхронно после ответа — сбой на стороне лаборатории никогда не приводит к ошибке твоего запроса. С этого момента Получить результаты показывает маркеры со статусом planned, пока лаборатория не передаст их. Вебхук home_kit_order.results.updated сообщит тебе об их изменении. Если образец поступает в лабораторию до того, как ты активируешь набор, его активирует Aniva. В качестве activated_at берётся утро первого события отслеживания обратной посылки или утро поступления образца в лабораторию, если отслеживания нет. Последующий вызов с другим activated_at в этом случае вернёт 409. Требуется разрешение home_kit_orders_manage или более узкое разрешение home_kit_orders_activate.

Запрос

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

string
обязательно
Уникальный идентификатор (UUID) заказа набора для домашнего теста, который нужно активировать.

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

string
обязательно
Время сбора образца пациентом в UTC (ISO 8601 с суффиксом Z, например 2026-08-28T07:30:00Z). Не может быть в будущем или более чем на 30 дней в прошлом.

Ответ

При успехе API возвращает 200 OK с обновлённым заказом набора для домашнего теста — status имеет значение activated, а activated_at содержит переданную тобой метку времени.

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