Hopp til hovedinnhold
PATCH
Oppdater timedetaljer som avtalt tidspunkt eller prøvested. Bare timer der blodprøvetakingen ennå ikke er bekreftet, kan endres.
Timer kan ikke endres etter at blodprøvetakingen er bekreftet eller hvis de allerede er avbestilt. Forsøk på å oppdatere en slik time returnerer 409 Conflict. Det eneste unntaket er results_ready_emails, som du fortsatt kan endre etter blodprøvetakingen.
Krever tilgangsomfanget appointments_schedule eller appointments_manage.

Forespørsel

Stiparametere

string
påkrevd
Unik identifikator (UUID) for timen som skal oppdateres.

Body-parametere

Alle body-parametere er valgfrie – ta bare med feltene du vil endre.
string
Ny dato og nytt klokkeslett for timen i ISO 8601-format (f.eks. 2026-05-20T14:00:00Z eller 2026-05-20T16:00:00+02:00). Må inneholde en tidssoneangivelse – enten Z eller en eksplisitt forskyvning som +02:00; tidspunkter uten tidssone avvises. Må ligge i fremtiden.Må være en eksakt start på en tidsluke med gjenværende kapasitet – se Hent tilgjengelighet. Timen som flyttes teller aldri mot sin egen måltidsluke, men å flytte til en tidsluke der den samme profilen allerede har en annen time, returnerer 409 med den timens appointment_id.Hvis målstedet drives av Aniva, må det nye tidspunktet også være minst 12 timer frem i tid – se Minste varslingstid.
string
UUID for det nye prøvestedet. Stedet må eksistere og være aktivt. Bruk Vis steder for å finne tilgjengelige steds-ID-er.
string[]
Erstatter listen med opptil 5 adresser som hver får én e-post når alle labresultatene er endelige. Send [] for å slå av e-postene. Dette feltet kan fortsatt redigeres etter blodprøvetakingen; bare en avbestilt time avviser det. Etter blodprøvetakingen må du sende det alene: med scheduled_at eller location_id i samme body returnerer forespørselen 409. Nøkkelen din trenger results_view-tilgang til pasienten, ellers 403. Se E-poster når resultater er klare.
string | null
Ny prøvetakingsmetode: capillary eller venous, eller null for å bruke stedets default_draw_method igjen. Stedet må ha metoden i draw_methods, og de bestilte prøvene må være mulige med den, ellers 400. Når du flytter en time til et annet sted, kjøres den samme sjekken der: på timens egen draw_method, ellers på det nye stedets default_draw_method.

Respons

Ved suksess returnerer API-et 200 OK med den oppdaterte timen og den innebygde profilen.
string
påkrevd
Unik timeidentifikator (UUID).
string
påkrevd
UUID for profilen denne timen tilhører.
string
UUID for teststedet der blodprøvetakingen finner sted.
string
Avtalt tidspunkt for timen som et UTC-tidspunkt (ISO 8601 med Z-suffiks, f.eks. 2026-05-20T14:00:00Z). Kan være null.
string
påkrevd
Gjeldende status for timen. En av pending, confirmed, blood_drawn eller cancelled. Detaljert status for laboratorieresultater henter du fra Hent resultater, og mer detaljert fremdrift for forsendelser fra hvert element i den innebygde shipments-listen (se nedenfor) videre til Hent forsendelse.
string
Fritekstårsak som ble registrert da timen ble avbestilt (f.eks. manglende oppmøte, sen avbestilling, «Mislyktes. Må gjentas»). null med mindre status er cancelled.
string[]
påkrevd
Adresser som hver får én e-post når alle labresultater er endelige, i små bokstaver. Tom når den er slått av. Se E-poster om klare resultater.
string
påkrevd
Hvordan blodprøven tas: capillary (fingertupp eller overarm, i mikrorør) eller venous (fra vene, i prøverør). Det er metoden som er satt på timen, ellers default_draw_method for stedet. Etter blodprøvetakingen er det metoden som ble brukt.
string
påkrevd
ISO 8601-tidsstempel for når timen ble opprettet.
string
ISO 8601-tidsstempel for siste oppdatering. Kan være null.
object
påkrevd
Pasientprofilen som er knyttet til denne timen.
AppointmentPanel[]
påkrevd
Paneler som for øyeblikket er knyttet til denne timen. Utelater kansellerte tilknytninger. Slå opp paneldetaljer (navn, biomarkører) via Vis paneler.
AppointmentIndividualBiomarker[]
påkrevd
Enkeltbiomarkører knyttet til denne timen utenfor et panel (se Legg til egendefinerte biomarkører). Kryssreferer hver biomarker_id mot Vis biomarkører for visningsdata.
AppointmentShipmentLink[]
påkrevd
Forsendelser koblet til denne timen, med eldste kobling først. Tom liste når ingen forsendelser er koblet til. Slå opp hver id med Hent forsendelse for fullstendige forsendelsesdata.
string[]
påkrevd
Labkoder (strekkoder på prøverør) som er registrert for denne timen, i skannerekkefølge. Tom til blodprøvetakingen er bekreftet. En venøs blodprøvetaking har én kode trykket på hvert prøverør; en kapillær blodprøvetaking har én kode per mikrorør. Resultater og dokumenter i Hent resultater refererer til disse kodene via lab_code.

Feilresponser