Hopp til hovedinnhold
POST
Bestill en time for blodprøvetaking for en pasientprofil på en bestemt testlokasjon. Når timen er opprettet, får den statusen confirmed som standard (noen lokasjoner kan i stedet ha pending som standard — dette stilles inn per lokasjon). Bruk Legg til paneler for å legge til blodprøvepaneler før du bekrefter blodprøvetakingen.
En profil kan ha høyst én time per lokasjon og tidspunkt. Hvis du oppretter en time for en tidsluke profilen allerede har, returneres 409 med eksisterende appointment_id i stedet for en ny time — slik at en ny eller utilsiktet gjentatt forespørsel aldri kan opprette en dobbeltbestilling. Se Dupliserte timer.
Send en valgfri Idempotency-Key-header for å gjøre denne opprettelsen trygg å prøve på nytt — hvis samme nøkkel sendes igjen, returneres det opprinnelige svaret i stedet for å opprette en til. Se Idempotens. Krever scopet appointments_schedule.

Forespørsel

Body-parametere

string
påkrevd
UUID for pasientprofilen det skal opprettes time for.
string
påkrevd
UUID for testlokasjonen der blodprøvetakingen skal finne sted. Bruk List opp lokasjoner for å finne tilgjengelige lokasjons-ID-er.
string
påkrevd
Dato og klokkeslett for timen i ISO 8601-format (f.eks. 2026-05-15T10:30:00Z eller 2026-05-15T12:30:00+02:00). Må inkludere tidssoneangivelse — enten Z eller en eksplisitt tidsforskyvning som +02:00; tidspunkter uten tidssone avvises. Må ligge i fremtiden.Må være en nøyaktig starttid for en tidsluke i lokasjonens timeplan, og tidsluken må fortsatt ha kapasitet — les Hent tilgjengelighet først. Tidspunkter utenfor timeplanen returnerer 400, og en tidsluke som er full returnerer 409. På lokasjoner som drives av Aniva, må tidspunktet også være minst 12 timer frem i tid — se Minimumsfrist.
string[]
Opptil 5 adresser som hver får én e-post når alle laboratorieresultatene er endelige. E-posten lenker til resultatsiden i Anivas adminpanel. Nøkkelen din må ha results_view-tilgang til pasienten, ellers returneres 403. Utelat feltet for å bruke standardadressene som er angitt for pasientens gruppe. En tom liste slår e-postene av. Se E-poster om klare resultater.
string
Hvordan blodprøvetakingen utføres: capillary eller venous. Utelat feltet for å bruke lokasjonens default_draw_method. Lokasjonen må ha metoden i draw_methods, ellers returneres 400.

Respons

Når kallet lykkes, returnerer API-et 201 Created med den nye timen.
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
Planlagt tidspunkt for timen i UTC (ISO 8601 med Z-suffiks, f.eks. 2026-05-15T10:30: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.
object
påkrevd
Pasientprofilen som er knyttet til denne timen.
AppointmentPanel[]
påkrevd
Paneler som for øyeblikket er knyttet til denne timen. Tom for nyopprettede timer — legg til via Legg til paneler. Slå opp detaljer om paneler (navn, biomarkører) via List opp paneler.
AppointmentIndividualBiomarker[]
påkrevd
Enkeltstående biomarkører som er knyttet til denne timen utenom paneler. Tom for nyopprettede timer — legg til via Legg til individuelle biomarkører. Slå opp hver biomarker_id mot List opp biomarkører for visningsdata.
AppointmentShipmentLink[]
påkrevd
Forsendelser som er knyttet til denne timen, med eldste kobling først. Tom for nyopprettede timer — knytt til via Opprett forsendelse (med appointment_id) eller Knytt timer til forsendelse.
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.

Minimumsfrist

Timer på lokasjoner som drives av Aniva, må bestilles minst 12 timer i forveien; bestilling innenfor dette vinduet returnerer 400. Hent tilgjengelighet holder allerede tilbake disse tidslukene, så alt du leser fra den timeplanen, kan bestilles. Lokasjoner du driver selv har ingen minimumsfrist — bestilling samme dag og drop-in er uendret.

Dupliserte timer

En profil kan ha høyst én ikke-avbestilt time per lokasjon og tidspunkt — én person kan ikke gjennomføre blodprøvetaking to ganger på samme sted og tidspunkt, uansett hvor mange stoler lokasjonen har. Hvis du oppretter en time for en tidsluke profilen allerede har, returneres 409 med en appointment_id som angir timen som allerede finnes:
Håndter dette ved å behandle forespørselen som allerede utført: hent timen med Hent time, flytt den med Oppdater time, eller fjern den med Avbestill time. Ikke prøv opprettelsen på nytt — den vil fortsette å returnere 409. Dette gjør gjentatte opprettelser trygge: en forespørsel du sender på nytt etter et tidsavbrudd, eller et skjema som sendes inn to ganger, kan ikke opprette to timer for samme pasient på samme tidspunkt.
appointment_id er bare med på 409 ved duplikat. Ved 409 på grunn av kapasitet — tidsluken er full fordi andre pasienter har den — returneres kun error, og riktig løsning da er å velge en annen tidsluke fra Hent tilgjengelighet.

Feilresponser