Перейти до основного вмісту
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. Потрібен scope home_kit_orders_manage або вужчий scope home_kit_orders_activate.

Запит

Параметри шляху

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

Параметри тіла запиту

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

Відповідь

У разі успіху API повертає 200 OK з оновленим замовленням набору для домашнього тесту — status має значення activated, а activated_at містить надіслану тобою часову мітку.

Відповіді з помилками