Hoppa till huvudinnehåll
PATCH
Uppdatera bokningsuppgifter som bokad tid eller provtagningsplats. Bara bokningar vars blodprovstagning ännu inte har bekräftats kan ändras.
Bokningar kan inte ändras efter att blodprovstagningen har bekräftats eller om de redan har avbokats. Försök att uppdatera en sådan bokning returnerar 409 Conflict. Det enda undantaget är results_ready_emails, som du fortfarande kan ändra efter blodprovstagningen.
Kräver scopet appointments_schedule eller appointments_manage.

Förfrågan

Sökvägsparametrar

string
obligatorisk
Unik identifierare (UUID) för bokningen som ska uppdateras.

Body-parametrar

Alla body-parametrar är valfria – ta bara med de fält du vill ändra.
string
Nytt datum och tid för bokningen i ISO 8601-format (t.ex. 2026-05-20T14:00:00Z eller 2026-05-20T16:00:00+02:00). Måste innehålla en tidszonsangivelse – antingen Z eller en explicit tidsförskjutning som +02:00; naiva tidsangivelser avvisas. Måste ligga i framtiden.Måste vara en exakt starttid för en tidslucka med ledig kapacitet – se Hämta tillgänglighet. Bokningen som ombokas räknas aldrig mot sin egen nya tidslucka, men om den flyttas till en tidslucka där samma profil redan har en annan bokning returneras 409 med den bokningens appointment_id.Om den nya platsen drivs av Aniva måste den nya tiden också ligga minst 12 timmar framåt i tiden – se Minsta framförhållning.
string
UUID för den nya provtagningsplatsen. Platsen måste finnas och vara aktiv. Använd Lista platser för att hitta tillgängliga plats-ID:n.
string[]
Ersätter listan med upp till 5 adresser som var och en får ett mejl när alla labbresultat är slutgiltiga. Skicka [] för att stänga av mejlen. Det här fältet förblir redigerbart efter blodprovstagningen; bara en avbokad bokning avvisar det. Efter blodprovstagningen skickar du det ensamt: med scheduled_at eller location_id i samma body returnerar anropet 409. Din nyckel behöver results_view-åtkomst till patienten, annars returneras 403. Se Mejl när resultat är klara.
string | null
Ny provtagningsmetod: capillary eller venous, eller null för att använda platsens default_draw_method igen. Platsen måste lista metoden i draw_methods, och de bokade proven måste gå att ta med den, annars returneras 400. När du flyttar en bokning till en annan plats körs samma kontroll där: på bokningens egen draw_method, annars på den nya platsens default_draw_method.

Svar

Om anropet lyckas returnerar API:et 200 OK med den uppdaterade bokningen och dess inbäddade profil.
string
obligatorisk
Unik identifierare för bokningen (UUID).
string
obligatorisk
UUID för den profil som bokningen tillhör.
string
UUID för provtagningsstället där blodprovstagningen sker.
string
Bokat datum och tid som en UTC-tidpunkt (ISO 8601 med Z-suffix, t.ex. 2026-05-20T14:00:00Z). Kan vara null.
string
obligatorisk
Aktuell bokningsstatus. Något av pending, confirmed, blood_drawn eller cancelled. Detaljerad status för färdigställda labbresultat får du från Hämta resultat; mer detaljerad försändelsestatus från varje post i shipments-arrayen nedan vidare till Hämta försändelse.
string
Orsak i fritext som registrerades när bokningen avbokades (t.ex. uteblivet besök, sen avbokning, ‘Misslyckades. Behöver göras om’). null om inte status är cancelled.
string[]
obligatorisk
Adresser som var och en får ett mejl när alla labbresultat är slutgiltiga, i gemener. Tom när funktionen är avstängd. Se Mejl när resultat är klara.
string
obligatorisk
Hur blodet tas: capillary (fingertopp eller överarm, i mikrorör) eller venous (från ven, i provrör). Det är metoden som bokningen anger, annars default_draw_method för dess provtagningsställe. Efter blodprovstagningen är det den metod som användes.
string
obligatorisk
ISO 8601-tidsstämpel för när bokningen skapades.
string
ISO 8601-tidsstämpel för den senaste uppdateringen. Kan vara null.
object
obligatorisk
Patientprofilen som är kopplad till den här bokningen.
AppointmentPanel[]
obligatorisk
Paneler som för närvarande är kopplade till den här bokningen. Exkluderar avbrutna kopplingar. Slå upp paneldetaljer (namn, biomarkörer) via Lista paneler.
AppointmentIndividualBiomarker[]
obligatorisk
Enskilda biomarkörer som är kopplade till den här bokningen utanför någon panel (se Lägg till anpassade biomarkörer). Korsreferera varje biomarker_id mot Lista biomarkörer för visningsdata.
AppointmentShipmentLink[]
obligatorisk
Försändelser kopplade till den här bokningen, äldsta kopplingen först. Tom array när inga försändelser är kopplade. Korsreferera varje id mot Hämta försändelse för fullständig försändelsedata.
string[]
obligatorisk
Labbkoder (rörens streckkoder) som registrerats för den här bokningen, i skanningsordning. Tom tills blodprovstagningen är bekräftad. En venös blodprovstagning har en kod tryckt på varje provrör; en kapillär blodprovstagning har en kod per mikrorör. Resultat och dokument i Hämta resultat refererar till dessa koder via lab_code.

Felsvar