AMQP - PVK - Dialog Reservasjoner

Meldingene utveksler informasjon om innbyggers reservasjoner knyttet til et register/forskningsprosjekt/screeningprogram. Det kan utveksles informasjon både fra aktør og til PVK samt fra PVK til aktør.

Formålet med tvekslngen er at PVK alltid skal være oppdatert med alle innbyggers reservasjoner (dvs. være Master) samt at PVK gir aktører som har behov for det informasjon når innbygger ender innstilling via Helsenorge.

Det støttes tre prosessflyt:

Informasjon fra PVK til aktør om at innbygger har reservert seg eller fjernet en tidligere satt reservasjon
Oppdatering av PVK fra aktør om at innbygger gjennom aktøren selv har satt eller opphevet en tidligere satt reservasjon

API-navn	PERSONVERN_INNBYGGER_RESERVASJON
Funksjonelt område	Personvern
API-versjon og dato publisert	Versjon 2.1 Aug 6, 2020 Dialogprosess: Personvern Innbygger Reservasjon 2.1
Status	I DRIFT
API-dokumentasjon sist endret	Sep 14, 2022
Teknologi	AMQP

Prosess og flyt

Her er info om prosesser og flyt

Melding fra PVK til ekstern aktør om at innbygger har satt en reservasjon eller fjernet en tidligere satt reservasjon. Formålet er at aktøren kan ha en lokal kopi av ytelse hensyn (dvs. slippe å spørre PVK om status).

Melding fra ekstern aktør når innbygger har satt- eller fjernet tidligere satt reservasjon. Formålet med meldingene er at PVK skal ha oppdatert status. Merk, PVK sender replikeringsmelding om endringen til abonnentene.

Melding fra PVK til aktør eller fra Aktør til PVK

Her er strukturen på meldingene

Tjeneste	«Dialog reservasjon», asynkron tjeneste
Bruksområde	Brukes for å informere om at innbygger har reservert seg, eller opphevet tidligere satt reservasjon. Meldingen kan gå både fra PVK til aktør og fra aktør til PVK (se flytdiagrammer).
Hodemelding	Obligatorisk: Obligatorisk verdi i MsgHead/MsgInfo/Type er: <Type V="PERSONVERN_INNBYGGER_RESERVASJON" DN="Personvern innstilling innbygger - reservasjon"/> Obligatorisk verdi i MsgHead/MsgInfo/Ack er: <Ack DN="Ja" V="J"/> «MsgHead/MsgInfo/Patient» skal være med (eksempel under): <Patient> <FamilyName>Danser</FamilyName> <GivenName>Line</GivenName> <Ident> <Id>13116900216</Id> <TypeId V="FNR" DN="Fødselsnummer" S="2.16.578.1.12.4.1.1.8116" /> </Ident> </Patient>
Hodemelding/ Document/ Reservasjon	<Document> <!-- Merk! Endret fra "Dialog med" til "Personvern" --> <ContentDescription>Personvern innbygger</ContentDescription> <RefDoc> <IssueDate V="2018-12-16T11:09:38.4871148+01:00" /> <MsgType V="XML" DN="XML-instans" /> <Description>Personvern innbygger - reservasjon</Description> <Content> <InnbyggersReservasjon xmlns="http://ehelse.no/xmlstds/reservasjon/v2.1" xmlns:pvi="http://ehelse.no/xmlstds/PersonvernInnstilling/v1.1" p1:schemaLocation="http://ehelse.no/xmlstds/reservasjon/v2.1 reservasjon-v2.1.xsd"> <pvi:PersonvernInnstillingDefinisjonReferanse> <pvi:PersonvernInnstillingDefinisjonId>d59876b1-3ccf-4756-9d0a-50d39ba0b4bf</pvi:PersonvernInnstillingDefinisjonId> <!-- Bilateralt avtalt kodeverdi for aktuel part som samtykket gis til --> <pvi:Part>KPR</pvi:Part> <pvi:PersonvernInnstillingNavn>Reservasjon mot utlevering til andre formål</pvi:PersonvernInnstillingNavn> </pvi:PersonvernInnstillingDefinisjonReferanse> <!-- Tidspunkt for når denne personverninnstillingen første gang ble registrert --> <pvi:OpprettetTidspunkt>2018-12-16T11:09:38.4871148+01:00</pvi:OpprettetTidspunkt> <!-- Dersom en definisjon har metadata (strukturert del, eller definisjonen tillater innbygger metadata, skal disse være med i replikeringen. --> <pvi:Metadata> <ReservasjonMetadata> <ReservasjonFasteMetadata> <!-- Datamodellen åpner opp for at en reservasjon kan være tidsbegrenset, selv om vi pr. i dag ikke har noe UseCase for dette --> <FastTidsbegrensning> <TidsbegrensetFra>2018-01-01</TidsbegrensetFra> <TidsbegrensetTil>2019-12-31</TidsbegrensetTil> </FastTidsbegrensning> <ReservasjonOmfangElement> <Omfang V="UO" DN="Utlevering av helseopplysninger" S="2.16.578.1.12.4.1.1.7608"/> <Presisering>ANDRE_FORMÅL</Presisering> </ReservasjonOmfangElement> </ReservasjonFasteMetadata> </ReservasjonMetadata> <!-- Datatsrukturen tillater at innbygger kan sette en eller flere tidsperioder som reservasjone gjelder. Vi har ingen UseCase for dette på Reservasjon pr. nå --> </pvi:Metadata> <!-- Kodesett for STATUS: 7609 --> <pvi:Status V="RES" DN="Opprettet reservasjon" S="2.16.578.1.12.4.1.1.7609" /> <pvi:Versjonsnummer>1</pvi:Versjonsnummer> <!-- Samme tidspunkt som for opprettelse (når versjon=1) --> <pvi:SistEndretTidspunkt>2018-12-16T11:09:38.4871148+01:00</pvi:SistEndretTidspunkt> </InnbyggersReservasjon> </Content> </RefDoc> </Document>
Hodemelding/ Document/ Pasientrelasjon	Obligatorisk informasjon: Pasientrelasjon skal være med når en annen person enn innbygger selv utfører handlingen på vegne av innbyggeren.

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Generell info om meldingsutveksling med Helsenorge

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

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

ReservasjonMetadata

ReservasjonOmfangElement	Beskrivelse
Omfang	Beskriver omfanget av reservasjonen. Eksempelvis «Reservasjon mot utlevering». Her benyttes kodeverk 7608. (Se under om hvilke verdier som er aktuelle for Reservasjon)
Presisering	Valgfritt element som benyttes dersom «Omfang» trenger å detaljeres ytterligere. Her er det forutsatt at det avtales bilateralt kodeverdier mellom Helsenorge og det enkelte register og at disse registreres som en del av definisjonen.
LogiskOmfang	Denne kan være med. Dersom den ikke er med, gjelder reservasjonen for det angitte Omfang/Presisering. Dersom elementet har verdien «OVRIGE», gjelder reservasjonen for alle data/formål unntatt de som er angitt i Omfang/Presisering.

For å kunne beskrive omfanget av hva reservasjonen omfatter benyttes kodeverk 7608. Følgende kodeverdier i dette kodeverket er aktuelle for reservasjon:

Kodeverk (V)	Visningsnavn (DN)	Beskrivelse
DT	Digital tilgang	Reservere seg mot at en tjeneste skal være tilgjengelig digitalt på nett.
OF	Oppføring	Reservere seg mot å være oppført i et register eller en ordning.
UO	Utlevering av helseopplysninger	Reservere seg mot at opplysninger som er lagret utleveres til andre eller benyttes til annet formål.
IO	Innhenting av helseopplysninger	Reservere seg mot at det innhentes helseopplysninger om innbygger for en tjeneste, register eller ordning.

Status

Elementet status beskriver status for reservasjonen og benytter kodeverk 7609. Følgende verdier i dette kodeverket er aktuelle for Reservasjon.

Kodeverk (V)

Visningsnavn

(DN)

Beskrivelse

RES

Opprettet reservasjon

Status for at en reservasjon foreligger.

IRES

Fjernet reservasjon

Status for at en reservasjon ikke lenger foreligger.