Vai al contenuto principale
DELETE
Annulla un appuntamento impostando il suo stato su cancelled. Possono essere annullati solo gli appuntamenti per cui il prelievo di sangue non è ancora stato confermato. Annullare un appuntamento già cancelled restituisce 200 con quell’appuntamento e non scrive nulla — non viene registrato un secondo annullamento. La risposta include Idempotent-Replayed: true così puoi distinguere una ripetizione dalla chiamata che ha eseguito l’operazione. Una ripetizione con un cancellation_reason diverso restituisce invece 409: il motivo registrato non viene mai sovrascritto. Vedi Idempotenza.
Gli appuntamenti non possono essere annullati dopo la conferma del prelievo di sangue — l’operazione restituisce 409 Conflict.
Richiede lo scope appointments_schedule o appointments_manage.

Richiesta

Parametri di percorso

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

Parametri del body

Il body è facoltativo — non inviare alcun body per annullare senza registrare un motivo.
string
Motivo dell’annullamento in testo libero, fino a 500 caratteri (es. Patient no-show). Salvato sull’appuntamento e restituito come cancellation_reason in questa lettura e in quelle successive.

Risposta

In caso di successo, l’API restituisce 200 OK con l’appuntamento annullato 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, es. 2026-05-15T10:30:00Z). Può essere null.
string
obbligatorio
Stato dell’appuntamento. Sarà cancelled dopo un annullamento riuscito.
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 collegati a questo appuntamento prima dell’annullamento. Consulta i dettagli dei pannelli (nome, biomarcatori) tramite Elenca 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 prima dell’annullamento. Ogni id rimanda a Ottieni 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