Vai al contenuto principale
Questa guida ti accompagna nel flusso di lavoro principale: trovare una sede di analisi, creare un profilo paziente, prenotare un appuntamento e confermare un prelievo di sangue.

Prerequisiti

Ti serve una chiave API partner rilasciata da Aniva.
Se non hai ancora una chiave API, contatta Aniva per ottenerne una per il tuo account partner.

Passaggi

1

Elenca le sedi disponibili

Recupera l’elenco delle sedi di analisi per trovare un location_id per l’appuntamento che prenoterai.
Risposta di esempio
Annota l’id della sede che vuoi usare. Ti servirà nel passaggio 3.
2

Crea un profilo

Crea il profilo di un paziente inviando i suoi dati anagrafici. Il campo profile_group collega il profilo al tuo account partner — accetta l’UUID immutabile del gruppo oppure il suo slug leggibile.
Campi del corpo della richiesta** Facoltativo quando il tuo gruppo di profili consente al paziente di inserire entrambi i dati nella pagina di attivazione del kit. Vedi Profili.Risposta di esempio (201 Created)
Annota l’id dalla risposta. Lo userai come profile_id nel passaggio successivo.
3

Prenota un appuntamento

Crea un appuntamento usando il profile_id del passaggio 2 e il location_id del passaggio 1. Imposta scheduled_at sull’orario di inizio di uno slot restituito da Ottieni disponibilità per quella sede. L’API rifiuta qualsiasi orario che non rientra nella griglia degli slot.
Risposta di esempio (201 Created)
Annota l’id dell’appuntamento. Lo userai per confermare il prelievo di sangue.
4

Conferma il prelievo di sangue

Completato il prelievo di sangue, invia il codice di laboratorio (codice a barre della provetta) per confermare il prelievo e avviare la pipeline degli ordini di laboratorio. Se le provette di un prelievo riportano più codici, invia invece lab_codes — vedi Conferma prelievo di sangue.
Risposta di esempio (200 OK)
Dopo la conferma, viene avviata la pipeline degli ordini di laboratorio. Puoi recuperare l’appuntamento per verificare che il suo stato sia passato a "blood_drawn".

Prossimi passaggi