Vai al contenuto principale
PATCH
Aggiorna i dettagli dell’appuntamento, come l’orario programmato o la sede dell’esame. È possibile modificare solo gli appuntamenti per cui il prelievo di sangue non è ancora stato confermato.
Gli appuntamenti non possono essere modificati dopo la conferma del prelievo di sangue o se sono già stati annullati. Tentare di aggiornare un appuntamento di questo tipo restituisce 409 Conflict. L’unica eccezione è results_ready_emails, che puoi ancora modificare dopo il prelievo di sangue.
Richiede lo scope appointments_schedule o appointments_manage.

Richiesta

Parametri di percorso

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

Parametri del body

Tutti i parametri del body sono facoltativi — includi solo i campi che vuoi modificare.
string
Nuova data e ora dell’appuntamento in formato ISO 8601 (ad es., 2026-05-20T14:00:00Z o 2026-05-20T16:00:00+02:00). Deve includere un indicatore di fuso orario — Z oppure un offset esplicito come +02:00; le date senza fuso orario vengono rifiutate. Deve essere nel futuro.Deve corrispondere esattamente all’inizio di uno slot con capacità residua — consulta Ottieni disponibilità. L’appuntamento riprogrammato non viene mai conteggiato nel proprio slot di destinazione, ma spostarlo in uno slot in cui lo stesso profilo ha già un altro appuntamento restituisce 409 con l’appointment_id di quell’appuntamento.Se la sede di destinazione è gestita da Aniva, il nuovo orario deve essere anche ad almeno 12 ore di distanza — consulta Preavviso minimo.
string
UUID della nuova sede dell’esame. La sede deve esistere ed essere attiva. Usa Elenca sedi per trovare gli ID delle sedi disponibili.
string[]
Sostituisce l’elenco di massimo 5 indirizzi che ricevono ciascuno un’email quando tutti i risultati di laboratorio sono definitivi. Invia [] per disattivare le email. Questo campo resta modificabile dopo il prelievo di sangue; solo un appuntamento annullato lo rifiuta. Dopo il prelievo di sangue, invialo da solo: con scheduled_at o location_id nello stesso body, la richiesta restituisce 409. La tua chiave necessita dell’accesso results_view al paziente, altrimenti 403. Consulta Email per risultati pronti.
string | null
Nuovo metodo di prelievo: capillary o venous, oppure null per usare nuovamente il default_draw_method della sede. La sede deve elencare il metodo in draw_methods e gli esami prenotati devono essere compatibili, altrimenti 400. Quando sposti un appuntamento in un’altra sede, lo stesso controllo viene eseguito lì: sul proprio draw_method, oppure sul default_draw_method della nuova sede.

Risposta

In caso di successo, l’API restituisce 200 OK con l’appuntamento aggiornato e il relativo profilo incorporato.
string
obbligatorio
Identificatore univoco dell’appuntamento (UUID).
string
obbligatorio
UUID del profilo a cui appartiene questo appuntamento.
string
UUID della sede del test in cui avviene il prelievo di sangue.
string
Data e ora programmate dell’appuntamento come istante UTC (ISO 8601 con suffisso Z, ad es. 2026-05-20T14:00:00Z). Può essere null.
string
obbligatorio
Stato attuale dell’appuntamento. Uno tra pending, confirmed, blood_drawn o cancelled. Il dettaglio di completamento dei risultati di laboratorio si ricava da Ottieni risultati; l’avanzamento più dettagliato delle spedizioni da ciascuna voce nell’array inline shipments (vedi sotto), da consultare su Ottieni spedizione.
string
Motivo in testo libero registrato al momento dell’annullamento dell’appuntamento (es. mancata presentazione, annullamento tardivo, ‘Non riuscito. Ripetizione necessaria’). null a meno che status non sia cancelled.
string[]
obbligatorio
Indirizzi che ricevono ciascuno un’email quando tutti i risultati di laboratorio sono definitivi, in minuscolo. Vuoto se disattivato. Vedi Email di risultati pronti.
string
obbligatorio
Come viene effettuato il prelievo di sangue: capillary (dal polpastrello o dalla parte superiore del braccio, in microprovette) o venous (dalla vena, in provette). È il metodo impostato dall’appuntamento, altrimenti il default_draw_method della sua sede. Dopo il prelievo di sangue, è il metodo utilizzato.
string
obbligatorio
Timestamp ISO 8601 della creazione dell’appuntamento.
string
Timestamp ISO 8601 dell’ultimo aggiornamento. Può essere null.
object
obbligatorio
Il profilo del paziente associato a questo appuntamento.
AppointmentPanel[]
obbligatorio
Pannelli attualmente associati a questo appuntamento. Esclude le associazioni annullate. Consulta i dettagli del pannello (nome, biomarcatori) tramite Elenco pannelli.
AppointmentIndividualBiomarker[]
obbligatorio
Biomarcatori singoli collegati a questo appuntamento al di fuori dei pannelli (vedi Aggiungi biomarcatori personalizzati). Confronta ogni biomarker_id con Elenca biomarcatori per i dati di visualizzazione.
AppointmentShipmentLink[]
obbligatorio
Spedizioni collegate a questo appuntamento, a partire dal collegamento meno recente. Array vuoto quando non ci sono spedizioni collegate. Confronta ciascun id con Ottieni spedizione per il payload completo della spedizione.
string[]
obbligatorio
Codici di laboratorio (codici a barre delle provette) registrati per questo appuntamento, in ordine di scansione. Vuoto finché il prelievo di sangue non viene confermato. Un prelievo venoso ha un unico codice stampato su ogni provetta; un prelievo capillare ha un codice per ogni microprovetta. Risultati e documenti in Ottieni risultati fanno riferimento a questi codici tramite lab_code.

Risposte di errore