Vai al contenuto principale
POST
Registra il completamento di un prelievo di sangue e avvia la pipeline degli ordini di laboratorio. Invia i codici di laboratorio (codici a barre delle provette) del kit di prelievo di sangue per collegare i campioni fisici all’appuntamento. Un prelievo di sangue utilizza i propri codici in uno di questi due modi:
  • Un solo codice per l’intero prelievo — un prelievo venoso, in cui lo stesso codice a barre è stampato su ogni provetta. Invialo come lab_code.
  • Un codice per microprovetta — un prelievo capillare, in cui ogni microprovetta ha il proprio codice a barre. Inviali come lab_codes, una voce per codice con i panel_ids contenuti nella relativa microprovetta. Ogni codice diventa una richiesta di laboratorio separata — il codice a barre sulla provetta è il numero d’ordine del laboratorio. Una voce senza panel_ids funge da voce generica per tutti i pannelli non indicati altrove. Un prelievo venoso ne ha al massimo una.
Invia esattamente uno dei due. Ogni pannello collegato deve finire sotto un solo codice (la propria voce o la voce generica). In un prelievo venoso, i biomarcatori singoli richiedono la voce generica. In un prelievo capillare, indica ogni pannello sul codice della sua microprovetta. I biomarcatori singoli occupano lo spazio libero delle microprovette dei pannelli e richiedono nuove microprovette solo quando serve. Li distribuiamo in modo uniforme. Ogni microprovetta ne contiene al massimo 150 µl. Invia una voce senza panel_ids per ogni microprovetta dedicata che richiedono, e non di più. Un codice che resta senza alcun pannello e senza alcun biomarcatore viene rifiutato con 409 e reason: "panel_coverage". Ogni codice viene validato prima di scrivere qualsiasi dato; se un codice non può essere utilizzato o un pannello rimane scoperto, non viene registrato nulla e la risposta indica il problema. Richiede lo scope appointments_schedule, appointments_manage o appointments_operate.
Questa azione è irreversibile. Una volta confermato il prelievo di sangue, l’appuntamento viene bloccato — non sono più possibili modifiche, inclusa l’aggiunta di pannelli.

Richiesta

Parametri di percorso

string
obbligatorio
Identificatore univoco (UUID) dell’appuntamento da confermare.

Parametri del body

string
Codice di laboratorio numerico stampato sul kit di prelievo di sangue, quando un solo codice copre tutte le provette. Reciprocamente esclusivo con lab_codes.
object[]
Tutti i codici di laboratorio del prelievo di sangue, in ordine di scansione (almeno una voce). Reciprocamente esclusivo con lab_code. Un codice può comparire una sola volta; un pannello può essere indicato in una sola voce.

Risposta

In caso di successo, l’API restituisce 200 OK a conferma che la pipeline degli ordini di laboratorio è stata avviata.
boolean
true quando il prelievo di sangue è stato registrato e la pipeline dell’ordine di laboratorio è stata avviata.
string
Presente solo quando il prelievo è stato registrato in un giorno diverso da quello dell’appuntamento. Le chiavi ordinarie non possono farlo — ricevono un 409 con reason: "appointment_not_today". Riprogramma l’appuntamento al giorno del prelievo, poi conferma.
I codici registrati vengono restituiti come lab_codes in Ottieni appuntamento, e ogni risultato e documento in Ottieni risultati riporta il lab_code con cui è stato archiviato.

Risposte di errore