Přejít na hlavní obsah
POST
Nahlas, že pacient odebral vzorek. Jde o protějšek Potvrdit odběr krve pro domácí testovací sadu — bez čárového kódu, protože kód sady se přidává už při jejím balení. Předáš jen časové razítko odběru. Časové razítko je klinicky důležité: jde o čas odběru, který bude uvedený v laboratorní zprávě. Pošli skutečný okamžik, kdy pacient vzorek odebral, ne okamžik, kdy ho zpracoval tvůj systém. Opakované poslání stejného activated_at vrátí 200 s aktivovanou objednávkou; jiné vrátí 409. Viz Idempotence. Aktivace přesune objednávku do stavu activated — jde o konečný stav. Aktivovanou objednávku už nelze zrušit a její složení i doručovací adresa jsou uzamčené. Aktivace se přijímá, dokud je objednávka ve stavu pending nebo dispatched, pokud má lab_code — pacient může mít sadu v ruce ještě předtím, než náš záznam ukáže odeslání, a jeho skutečný čas odběru má vždy přednost před naší evidencí. Objednávka bez lab_code vrátí 409: bez kódu nelze vzorek v laboratoři přiřadit k pacientovi. Aktivace také zadá laboratorní objednávku pro panel této sady pod lab_code objednávky, takže laboratoř vzorek očekává a výsledky se k němu mohou připojit hned po nahlášení. Probíhá to asynchronně po odeslání odpovědi — problém v laboratoři nikdy nezpůsobí selhání tvého požadavku. Od té chvíle Získat výsledky zobrazuje markery jako planned, dokud je laboratoř nenahlásí. Webhook home_kit_order.results.updated ti dá vědět, když se změní. Pokud vzorek dorazí do laboratoře dřív, než sadu aktivuješ, aktivuje ji Aniva. activated_at je ráno v den první události sledování zpětné zásilky, nebo ráno v den, kdy vzorek dorazil do laboratoře, pokud sledování chybí. Pozdější volání s jiným activated_at pak vrátí 409. Vyžaduje scope home_kit_orders_manage nebo užší scope home_kit_orders_activate.

Požadavek

Parametry cesty

string
povinné
Jedinečný identifikátor (UUID) objednávky domácí testovací sady k aktivaci.

Parametry těla

string
povinné
Čas, kdy pacient odebral vzorek, jako časový údaj v UTC (ISO 8601 s příponou Z, např. 2026-08-28T07:30:00Z). Nesmí být v budoucnosti ani více než 30 dní v minulosti.

Odpověď

Při úspěchu API vrátí 200 OK s aktualizovanou objednávkou domácí testovací sady — status je activated a activated_at obsahuje časové razítko, které odešleš.

Chybové odpovědi