Vai al contenuto principale
POST
Segnala che il paziente ha raccolto il campione. È l’equivalente per il kit domiciliare di Conferma prelievo di sangue, senza codice a barre, perché il codice del kit viene applicato al momento del confezionamento. Passi solo il timestamp della raccolta. Il timestamp ha rilevanza clinica: è l’orario di raccolta che comparirà sul referto di laboratorio. Invia il momento effettivo in cui il paziente ha raccolto il campione, non il momento in cui il tuo sistema l’ha elaborato. Inviare di nuovo lo stesso activated_at restituisce 200 con l’ordine attivato; un valore diverso restituisce 409. Vedi Idempotenza. L’attivazione porta l’ordine allo stato activated, uno stato finale. Un ordine attivato non può più essere annullato e la sua composizione e l’indirizzo di consegna vengono bloccati. L’attivazione è accettata finché l’ordine è pending o dispatched, purché abbia un lab_code: il paziente può avere in mano il kit prima che i nostri sistemi lo segnino come spedito, e l’orario reale di raccolta prevale sempre sui nostri registri. Un ordine senza lab_code restituisce 409: senza il codice, il campione non può essere associato al paziente in laboratorio. L’attivazione invia anche l’ordine di laboratorio per il pannello del kit con il lab_code dell’ordine, così il laboratorio attende il campione e i risultati possono essere associati appena vengono comunicati. Questo avviene in modo asincrono dopo la risposta: un problema del laboratorio non fa mai fallire la tua richiesta. Da questo momento in poi, Ottieni risultati mostra i marker come planned finché il laboratorio non li comunica. Un webhook home_kit_order.results.updated ti avvisa quando cambiano. Se il campione arriva in laboratorio prima che tu attivi il kit, lo attiva Aniva. activated_at è la mattina del primo evento di tracciamento del pacco di ritorno, oppure la mattina in cui il campione è arrivato in laboratorio se non c’è tracciamento. Una chiamata successiva con un activated_at diverso restituisce quindi 409. Richiede lo scope home_kit_orders_manage oppure lo scope più ristretto home_kit_orders_activate.

Richiesta

Parametri di percorso

string
obbligatorio
Identificativo univoco (UUID) dell’ordine di kit domiciliare da attivare.

Parametri del body

string
obbligatorio
Quando il paziente ha raccolto il campione, come istante UTC (ISO 8601 con suffisso Z, ad es. 2026-08-28T07:30:00Z). Non deve essere nel futuro né oltre 30 giorni nel passato.

Risposta

In caso di successo, l’API restituisce 200 OK con l’ordine di kit domiciliare aggiornato — status è activated e activated_at contiene il timestamp che hai inviato.

Risposte di errore