AMQP Timebokoversikt

Timebokoversikt lar helesaktører gjøre alle timebøker tilgjengelig for en innbygger, og støtter både personlige timebøker og ressurstimebøker.

Under utvikling og ikke tilgjengelig i produksjon.

Meldingstypen er valgbar i Adresseregisteret, men er ikke utviklet og verifisert.

API-navn	DIALOG_INNBYGGER_TIMEBOKOVERSIKT
Funksjonelt område	Timeavtaler
API-versjon og dato publisert	v1.0 Jun 20, 2024
Status	Utvikling
API-dokumentasjon sist endret	Jun 5, 2024
Teknologi	AMQP

Flyt og sekvensdiagram

Under er informasjon om flyten i bruk av denne funksjonaliteten. Prosessflyt for timebestilling generelt er vist her Bestille time i timebok | Prosessflyt for timebestilling

Sekvensdiagram for timebokoversikt er vist under.

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Forespørsel om Timebokoversikt

Tjeneste	Forespørsel om Timebokoversikt
Bruksområde	Forespørsel fra helsenorge.no for å hente alle timebøker som er tilgjengelig for en innbygger.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: `<Type V="DIALOG_INNBYGGER_TIMEBOKOVERSIKT" DN="Dialog med innbygger – Timebokoversikt" />` Obligatorisk verdi i MsgHead/MsgInfo/Ack er: `<Ack DN="Nei" V="N"/>`
Dialogmelding	Det er påkrevd med minst ett document under en hodenelding. Dialogmeldingen inneholder ingen meningsbærende informasjjon, men er inkludert. Dialogmelding/Foresporsel/TypeForesp Lovlige kodeverdier som kan brukes i TypeForesp: HTB Hent Timebok XML eksempel: `<Foresporsel> <TypeForesp V="HTB" DN="Hent Timebok" ="2.16.578.1.12.4.1.1.7601"/> </Foresporsel>` RollerRelatertNotat Ikke aktuelt å bruke for forespørselen i denne tjenesten.
Pasientrelasjon	Ikke aktuelt å bruke for forespørselen i denne tjenesten, ikke relevant å skille på hvem som ber om tilgjengelige timebøker.
Vedlegg	Ikke aktuelt å bruke for denne tjenesten

FHIR profil

Responsen med timebøker benytter denne FHIR profilen: https://norskhelsenett.github.io/FHIRCodeAndMore/ExampleIG/output/StructureDefinition-hn-basis-schedule.html

For å støtte ulike typer timebøker og gi en god oversikt over disse til innbygger er det noen viktige klassifiseringer som må gjøres

Hovedtyper av timebøker

Timebokoversikt støtter to hovedtyper timebøker

Personlige timebøker, typisk for en behandler. Disse skal angis med Actor=Practitioner
- Her vil Helsenorge vise navn på behandler
Ressurstimebøker. Timebøker der det ikke er en behandler men en ressurs som tilbyr timer. Et eksempel kan være en labtimebok. Disse skal angis med Actor=HealthcareService
- Her vil Helsenorge vise type timebok og navn på timeboken

Timeboktyper

For å angi type timebok er det innført et egendefinert kodeverk. De ulike timeboktypene brukes for å gi god forklaring i brukerflaten til innbygger om hva slags timer timeboken inneholder og det kan knyttes egne veiledere/kartlegginger til de før bestilling.

Lab
- For timebestilling til labtimer.
- Kun relevant for ressurstimebøker
- Kan gi spesifikk veileder og vises med egen visning
Vaksine
- For timebestilling til vaksinasjon.
- Kun relevant for ressurstimebøker
- Kan gi spesifikk veileder og vises med egen visning
Koronavaksine
- For timebestilling til koronavaksine.
- Kun relevant for ressurstimebøker, innført for pandemien og beholdt for bakoverkompatibilitet
- Kan gi spesifikk veileder og vises med egen visning
Koronatest
- For timebestilling til koronatest.
- Kun relevant for ressurstimebøker, innført for pandemien og beholdt for bakoverkompatibilitet
- Kan gi spesifikk veileder og vises med egen visning
Behandlertimebok
- For timebestilling hos en navngitt behandler. Helsenorge viser navn på behandler
- Benyttes kun for personlige timebøker
Annen
- Benyttes der andre timeboktyper ikke er dekkende. Ved behov for denne vil Helsenorge gjerne ha innspill for å vurdere om kodeverk bør utvides
- Helsenorge viser navn på timebok, men kan ikke gi ytterligere veileder

Svar på Timebokoversikt

Tjeneste	Svar på forespørsel om Timebokoversikt, synkron tjeneste
Bruksområde	Svar fra kommunikasjonspart med Timebøker som er tilgjengelige for en innbygger.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Dialogmelding	Ikke aktuelt å bruke, ingen informasjon i dialogmeldingen
FHIR Schedule	Obligatorisk informasjon dersom det fins timebøker tilgjengelig Schedule benyttes for informasjon om timebok. Detaljer for bruk av denne ressursen er angitt i FHIR Schedule Dersom det ikke er noen tilgjengelige timebøker for innbygger benyttes ikke elementet.

Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her: Meldingsutveksling med Helsenorge

Eksempelmeldinger

Eksempelmelding for forespørsel om timebokoversikt er vist under.

Eksempelmelding for svar på timebokoversikt er vist under.

Eksempelmelding inkludert hodemelding med respons for timebokoversikt: