Salt la conținutul principal
POST
Raportează că pacientul și-a recoltat proba. Acesta este echivalentul pentru kitul de testare la domiciliu al Confirmă recoltarea de sânge — fără cod de bare, deoarece codul kitului este aplicat la ambalarea kitului. Trimiți doar marcajul temporal al recoltării. Marcajul temporal contează clinic: este momentul recoltării pe care îl va conține raportul de laborator. Trimite momentul real al recoltării de către pacient, nu momentul în care sistemul tău l-a procesat. Retrimiterea aceluiași activated_at returnează 200 cu comanda activată; unul diferit returnează 409. Vezi Idempotență. Activarea trece comanda în statusul activated — un status final. O comandă activată nu mai poate fi anulată, iar compoziția și adresa ei de livrare sunt blocate. Activarea este acceptată cât timp comanda este pending sau dispatched, cu condiția să aibă un lab_code — pacientul poate avea deja kitul înainte ca evidența noastră să arate expedierea, iar momentul real al recoltării are întotdeauna prioritate față de înregistrările noastre. O comandă fără lab_code returnează 409: fără cod, proba nu poate fi asociată pacientului la laborator. Activarea plasează și comanda de laborator pentru panelul kitului sub lab_code-ul comenzii, astfel încât proba este așteptată la laborator, iar rezultatele pot fi asociate imediat ce sunt raportate. Acest lucru se întâmplă asincron după răspuns — o problemă de laborator nu face niciodată cererea ta să eșueze. De aici înainte, Obține rezultatele afișează markerii ca planned până când laboratorul îi raportează. Un webhook home_kit_order.results.updated te anunță când aceștia se schimbă. Dacă proba ajunge la laborator înainte să activezi kitul, Aniva îl activează. activated_at este dimineața primului eveniment de urmărire al coletului de retur sau dimineața în care proba a ajuns la laborator, dacă nu există urmărire. Un apel ulterior cu un activated_at diferit returnează apoi 409. Necesită scope-ul home_kit_orders_manage sau scope-ul mai restrâns home_kit_orders_activate.

Cerere

Parametri de cale

string
obligatoriu
Identificatorul unic (UUID) al comenzii de kit de testare la domiciliu de activat.

Parametri de corp

string
obligatoriu
Când a recoltat pacientul proba, ca moment UTC (ISO 8601 cu sufix Z, de ex. 2026-08-28T07:30:00Z). Nu trebuie să fie în viitor sau cu mai mult de 30 de zile în urmă.

Răspuns

La succes, API-ul returnează 200 OK cu comanda de kit de testare la domiciliu actualizată — status este activated, iar activated_at conține marcajul temporal pe care l-ai trimis.

Răspunsuri de eroare