Saltar al contingut principal
PATCH
Actualitza els detalls d’una cita, com ara l’hora programada o la ubicació de l’anàlisi. Només es poden modificar les cites que encara no tenen confirmada l’extracció de sang.
Les cites no es poden modificar després de confirmar l’extracció de sang ni si ja estan cancel·lades. Intentar actualitzar una cita així retorna 409 Conflict. L’única excepció és results_ready_emails, que encara pots canviar després de l’extracció de sang.
Requereix l’àmbit appointments_schedule o appointments_manage.

Sol·licitud

Paràmetres de ruta

string
requerit
Identificador únic (UUID) de la cita que vols actualitzar.

Paràmetres del cos

Tots els paràmetres del cos són opcionals — inclou només els camps que vulguis canviar.
string
Nova data i hora de la cita en format ISO 8601 (p. ex., 2026-05-20T14:00:00Z o 2026-05-20T16:00:00+02:00). Ha d’incloure un indicador de fus horari — o bé Z o un desplaçament explícit com +02:00; les dates i hores sense fus horari es rebutgen. Ha de ser en el futur.Ha de ser l’inici exacte d’una franja amb capacitat disponible — consulta Obtén la disponibilitat. La cita que es reprograma no compta mai contra la seva pròpia franja de destinació, però moure-la a una franja on el mateix perfil ja té una altra cita retorna 409 amb l’appointment_id d’aquella cita.Si la ubicació de destinació està gestionada per Aniva, la nova hora també ha de ser amb almenys 12 hores d’antelació — consulta Avís mínim.
string
UUID de la nova ubicació de l’anàlisi. La ubicació ha d’existir i estar activa. Utilitza Llista les ubicacions per trobar els ID de les ubicacions disponibles.
string[]
Substitueix la llista de fins a 5 adreces que reben un correu electrònic cadascuna quan tots els resultats del laboratori són definitius. Envia [] per desactivar els correus. Aquest camp continua sent editable després de l’extracció de sang; només una cita cancel·lada el rebutja. Després de l’extracció de sang, envia’l sol: amb scheduled_at o location_id al mateix cos, la sol·licitud retorna 409. La teva clau necessita accés results_view al pacient; si no, retorna 403. Consulta Correus de resultats disponibles.
string | null
Nou mètode d’extracció: capillary o venous, o null per tornar a utilitzar el default_draw_method de la ubicació. La ubicació ha d’incloure el mètode a draw_methods, i les anàlisis reservades han de ser possibles amb aquest mètode; si no, retorna 400. Quan mous una cita a una altra ubicació, s’hi executa la mateixa comprovació: sobre el seu propi draw_method o, si no, sobre el default_draw_method de la nova ubicació.

Resposta

Si té èxit, l’API retorna 200 OK amb la cita actualitzada i el seu perfil integrat.
string
requerit
Identificador únic de la cita (UUID).
string
requerit
UUID del perfil al qual pertany aquesta cita.
string
UUID de la ubicació de proves on es fa l’extracció de sang.
string
Data i hora programades de la cita com a instant UTC (ISO 8601 amb el sufix Z, p. ex., 2026-05-20T14:00:00Z). Pot ser null.
string
requerit
Estat actual de la cita. Pot ser pending, confirmed, blood_drawn o cancelled. El detall de compleció dels resultats de laboratori s’obté mitjançant Obtén els resultats; el progrés detallat de l’enviament, a partir de cada entrada de la matriu shipments inclosa aquí (més avall) seguida a Obtén l’enviament.
string
Motiu en text lliure registrat en cancel·lar la cita (p. ex., absència, cancel·lació tardana, «Error. Cal repetir»). null llevat que status sigui cancelled.
string[]
requerit
Adreces que reben un correu electrònic cadascuna quan tots els resultats del laboratori són definitius, en minúscules. Buit quan està desactivat. Consulta Correus electrònics de resultats a punt.
string
requerit
Com es fa l’extracció de sang: capillary (de la punta del dit o de la part superior del braç, en microtubs) o venous (de la vena, en tubs). És el mètode definit a la cita o, si no n’hi ha, el default_draw_method de la seva ubicació. Després de l’extracció de sang, és el mètode que s’ha fet servir.
string
requerit
Marca de temps ISO 8601 de quan es va crear la cita.
string
Marca de temps ISO 8601 de l’última actualització. Pot ser null.
object
requerit
El perfil del pacient associat a aquesta cita.
AppointmentPanel[]
requerit
Panells associats actualment a aquesta cita. Exclou les associacions cancel·lades. Consulta els detalls del panell (nom, biomarcadors) mitjançant Llista els panells.
AppointmentIndividualBiomarker[]
requerit
Biomarcadors a la carta associats a aquesta cita fora de qualsevol panell (consulta Afegeix biomarcadors personalitzats). Contrasta cada biomarker_id amb Llista els biomarcadors per obtenir les dades de visualització.
AppointmentShipmentLink[]
requerit
Enviaments vinculats a aquesta cita, ordenats pel vincle més antic primer. Matriu buida quan no hi ha cap enviament vinculat. Consulta cada id a Obtén l’enviament per obtenir el contingut complet de l’enviament.
string[]
requerit
Codis de laboratori (codis de barres dels tubs) registrats per a aquesta cita, per ordre d’escaneig. Buit fins que es confirmi l’extracció de sang. Una extracció venosa porta un sol codi imprès a cada tub; una extracció capil·lar porta un codi per microtub. Els resultats i documents a Obtén els resultats fan referència a aquests codis mitjançant lab_code.

Respostes d’error