Spring til hovedindhold
PATCH
Opdater detaljer for en tid, såsom det planlagte tidspunkt eller teststedet. Kun tider, hvor blodprøvetagningen endnu ikke er blevet bekræftet, kan ændres.
Tider kan ikke ændres, efter blodprøvetagningen er blevet bekræftet, eller hvis de allerede er aflyst. Forsøg på at opdatere en sådan tid returnerer 409 Conflict. Den eneste undtagelse er results_ready_emails, som du stadig kan ændre efter blodprøvetagningen.
Kræver scope appointments_schedule eller appointments_manage.

Forespørgsel

Stiparametre

string
påkrævet
Unik identifikator (UUID) for den tid, der skal opdateres.

Body-parametre

Alle body-parametre er valgfri — inkluder kun de felter, du vil ændre.
string
Ny dato og klokkeslæt for tiden i ISO 8601-format (f.eks. 2026-05-20T14:00:00Z eller 2026-05-20T16:00:00+02:00). Skal indeholde en tidszoneangivelse — enten Z eller en eksplicit forskydning som +02:00; tidspunkter uden tidszone afvises. Skal ligge i fremtiden.Skal være den nøjagtige start på et tidsrum med ledig kapacitet — se Hent ledige tider. Den tid, der flyttes, tæller aldrig med i kapaciteten for det ønskede tidsrum, men hvis den flyttes til et tidsrum, hvor den samme profil allerede har en anden tid, returneres 409 med den tids appointment_id.Hvis det nye sted drives af Aniva, skal det nye tidspunkt også ligge mindst 12 timer fremme — se Minimumsvarsel.
string
UUID for det nye teststed. Stedet skal eksistere og være aktivt. Brug Vis steder til at finde tilgængelige sted-ID’er.
string[]
Erstatter listen med op til 5 adresser, som hver får én e-mail, når alle laboratorieresultater er endelige. Send [] for at slå e-mails fra. Dette felt kan stadig redigeres efter blodprøvetagningen; kun en aflyst tid afviser det. Efter blodprøvetagningen skal det sendes alene: med scheduled_at eller location_id i samme body returnerer anmodningen 409. Din nøgle skal have results_view-adgang til patienten, ellers 403. Se E-mails, når resultaterne er klar.
string | null
Ny metode til blodprøvetagning: capillary eller venous, eller null for at bruge stedets default_draw_method igen. Stedet skal have metoden i sin draw_methods, og de bookede prøver skal kunne udføres med den, ellers 400. Når du flytter en tid til et andet sted, kører det samme tjek dér: på dens egen draw_method, ellers på det nye steds default_draw_method.

Svar

Ved succes returnerer API’et 200 OK med den opdaterede tid og dens indlejrede profil.
string
påkrævet
Unikt id for tiden (UUID).
string
påkrævet
UUID for den profil, denne tid tilhører.
string
UUID for det teststed, hvor blodprøvetagningen finder sted.
string
Planlagt dato og klokkeslæt for tiden som et UTC-tidspunkt (ISO 8601 med Z-suffiks, f.eks. 2026-05-20T14:00:00Z). Kan være null.
string
påkrævet
Aktuel status for tiden. En af pending, confirmed, blood_drawn eller cancelled. Fremdriften i laboratorieresultaterne udledes fra Hent resultater; mere detaljeret forsendelsesfremdrift fra hvert element i det indlejrede shipments-array (se nedenfor) videre til Hent forsendelse.
string
Fritekstårsag registreret ved aflysning af tiden (f.eks. udeblivelse, sen aflysning, ‘Failed. Repeat required’). null, medmindre status er cancelled.
string[]
påkrævet
Adresser med små bogstaver, som hver modtager én e-mail, når alle laboratorieresultater er endelige. Tom, når funktionen er slået fra. Se E-mails når resultater er klar.
string
påkrævet
Hvordan blodet tages: capillary (fingerspids eller overarm i mikrorør) eller venous (fra venen i prøveglas). Det er den metode, tiden angiver, ellers default_draw_method for dens lokation. Efter blodprøvetagningen er det den metode, der blev brugt.
string
påkrævet
ISO 8601-tidsstempel for, hvornår tiden blev oprettet.
string
ISO 8601-tidsstempel for den seneste opdatering. Kan være null.
object
påkrævet
Den patientprofil, der er knyttet til denne tid.
AppointmentPanel[]
påkrævet
Paneler, der i øjeblikket er tilknyttet denne tid. Inkluderer ikke annullerede tilknytninger. Slå paneldetaljer (navn, biomarkører) op via Vis paneler.
AppointmentIndividualBiomarker[]
påkrævet
À la carte-biomarkører knyttet til denne tid uden for et panel (se Tilføj valgfrie biomarkører). Krydsreferer hvert biomarker_id med Vis biomarkører for visningsdata.
AppointmentShipmentLink[]
påkrævet
Forsendelser knyttet til denne tid, ældste tilknytning først. Tomt array, når ingen forsendelser er tilknyttet. Slå hvert id op med Hent forsendelse for hele forsendelsens payload.
string[]
påkrævet
Laboratoriekoder (stregkoder på prøveglas) registreret for denne tid i scanningsrækkefølge. Tom, indtil blodprøvetagningen er bekræftet. En venøs blodprøvetagning har én kode trykt på hvert prøveglas; en kapillær blodprøvetagning har én kode pr. mikrorør. Resultater og dokumenter i Hent resultater henviser til disse koder via lab_code.

Fejlsvar