Vai al contenuto principale
Usa questa guida per confermare che un prelievo di sangue è stato effettuato. La conferma registra i codici di laboratorio (codici a barre delle provette) del kit fisico e avvia la pipeline dell’ordine di laboratorio; l’avanzamento dei risultati si legge poi da Ottieni risultati.
La conferma è irreversibile. Una volta confermato un prelievo di sangue, non puoi più modificare l’appuntamento, nemmeno per aggiungere pannelli. Assicurati che tutti i pannelli siano associati e tutti i dettagli siano corretti prima di procedere.
1

Assicurati che i pannelli siano aggiunti

Prima di confermare, verifica che tutti i pannelli di esami necessari siano stati aggiunti all’appuntamento. Non puoi aggiungere pannelli dopo la conferma.Consulta la guida Prenota un appuntamento per le istruzioni su come associare i pannelli.Conferma quanto segue prima di continuare:
  • Tutti i pannelli richiesti sono associati all’appuntamento.
  • profile_id e location_id nell’appuntamento sono corretti.
  • Il paziente ha completato il prelievo di sangue e il codice a barre di ogni provetta è a portata di mano.
2

Conferma il prelievo di sangue

Invia una richiesta POST a /api/v1/appointments/{id}/confirm con i codici di laboratorio del kit fisico per il prelievo di sangue. Un prelievo venoso ha un unico codice stampato su ogni provetta: invialo come lab_code. Un prelievo in farmacia ha un codice per ogni microprovetta: inviali come lab_codes, una voce per codice con i panel_ids contenuti nella sua microprovetta (presi da panels dell’appuntamento); ogni codice diventa una richiesta di laboratorio a sé stante. I singoli biomarcatori in farmacia occupano prima lo spazio libero delle microprovette dei pannelli. Invia una voce senza panel_ids per ogni microprovetta di cui hanno bisogno a parte.
Ogni codice deve essere la stringa numerica stampata sulla provetta fisica consegnata al paziente. Non sostituirlo con un altro identificativo: un codice errato farà fallire l’ordine di laboratorio. Ogni codice viene validato prima di scrivere qualsiasi dato; se uno viene rifiutato, non viene registrato nulla.
Una richiesta riuscita restituisce 200 OK:
3

Verifica lo stato dell'appuntamento

Dopo la conferma, recupera l’appuntamento per verificare che il suo stato sia passato a blood_drawn.
Quando l’appuntamento mostra status: "blood_drawn", la pipeline dell’ordine di laboratorio è stata avviata. Da questo momento lo stato dell’appuntamento resta blood_drawn; l’avanzamento più dettagliato delle fasi successive è esposto tramite endpoint dedicati: segui ogni voce dell’array inline shipments su Ottieni spedizione per gli eventi del corriere in transito / consegnato e usa Ottieni risultati per il completamento dei risultati di laboratorio (status: "in_progress" → "completed").

Cosa succede dopo

Dopo la conferma, entra in azione la pipeline dell’ordine di laboratorio di Aniva:
  1. Ogni codice di laboratorio viene abbinato alle rispettive provette fisiche in laboratorio: la richiesta di ogni pannello riporta il codice delle proprie provette.
  2. I pannelli associati all’appuntamento determinano quali esami vengono eseguiti.
  3. Quando i risultati sono pronti, vengono associati al profilo del paziente e compaiono in Ottieni risultati: il campo status di primo livello della risposta passa da in_progress a completed una volta che ogni invio è chiuso e uno ha restituito i risultati.
Non serve nessun’altra azione da parte della tua integrazione dopo la conferma.

Gestione degli errori