AMQP - PVK - Dialog Samtykker

Owned by sven.christiansen
Last updated: May 04, 2023
6 min read

Meldingene utveksler informasjon om innbyggers samtykker 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 utvekslingen er at PVK alltid skal være oppdatert med alle innbyggers samtykker (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:

  • Autonom melding med informasjon fra PVK til aktør om at innbygger har gitt et samtykke eller trukket et tidligere gitt samtykke.

  • Melding fra PVK til aktør om at innbygger har trukket et tidligere gitt samtykke og der registeret skal bekrefte når dette er fullført fra deres side. Alternativ flyt som benyttes f.eks. der det fysisk skal destrueres noe som kan ta tid f.eks. biomateriale.

  • Oppdatering av PVK fra aktør om at innbygger gjennom aktøren selv har gitt et samtykke eller trukket et tidligere gitt samtykke.

API-navn


PERSONVERN_INNBYGGER_SAMTYKKE

Funksjonelt område

Personvern

API-versjon og dato publisert

1.1 Aug 6, 2022

Dialogprosess: Personvern Innbygger Samtykke 1.1

Status

I DRIFT

API-dokumentasjon sist endret

Sep 13, 2022

Teknologi

AMQP

Prosess og flyt

Her er info om prosesser og flyt

Melding fra PVK til ekstern aktør om at innbygger har gitt et samtykke eller trukket et tidligere gitt samtykke. 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 gitt- eller trukket tidligere gitt samtykke. Formålet med meldingene er at PVK skal ha oppdatert status. Merk, at PVK vil også sende melding til aktør/abonnenter om endringen, selv om den initieres fra ekstern aktør.

Alternativ flyt når samtykke trekkes og det kreves bekreftelse fra aktør. Benyttes normalt kun der det fysisk skal destrueres biomateriale.

 

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

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

Meldingens innhold

 

Tjeneste

«Dialog samtykke», asynkron tjeneste

Bruksområde

Brukes for å informere om at innbygger har registert, eller fjernet et samtykke (se prosessflyt)

Hodemelding

Obligatorisk, og benyttes i henhold til beskrivelse i kapittel 3.

 Obligatorisk verdi i MsgHead/MsgInfo/Type er (kodeverk 8279:

<Type V="PERSONVERN_INNBYGGER_SAMTYKKE" DN="Personvern innstilling innbygger - samtykke"/>

 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/

Samtykke

Obligatoriske elementer i Samtykke:

  • PersonvernInnstillingDefinisjonReferanse

    • PersonvernInnstillingDefinisjonId

    • Part

    • PersonvernInnstillingNavn

  • OpprettetTidspunkt

  • Status

  • Versjonsnummer

  • SistEndretTidspunkt

Frivillige elementer i Samtykke:

  • SamtykkeMetadata

    • FasteMetadata

    • InnbyggerMetadata

 

Lovlige kodeverdier som kan brukes i Status:

  • SAM –  Samtykket

  • ISAM - Tidligere gitt samtykke er trukket

  • RSAM - Registrere eksternt avgitt samtykke

  • ASAM - Anmodning fra innbygger om å trekke samtykke. Benyttes når det skal benyttes alternativ flyt med eksplisitt bekreftelse fra register.

  

XML eksempel (det avgis samtykke til oppføring i et register):

<Document> <ContentDescription>Personvern innbygger</ContentDescription> <RefDoc> <IssueDate V="2018-01-16T11:09:38.4871148+01:00" /> <MsgType V="XML" DN="XML-instans" /> <Description>Personvern innbygger - samtykke</Description> <Content> <InnbyggersSamtykke xmlns="http://ehelse.no/xmlstds/samtykke/v1.1" xmlns:pvi="http://ehelse.no/xmlstds/PersonvernInnstilling/v1.1" p1:schemaLocation="http://ehelse.no/xmlstds/samtykke/v1.1 samtykke-v1.1.xsd"> <pvi:PersonvernInnstillingDefinisjonReferanse> <pvi:PersonvernInnstillingDefinisjonId>c351c83b-6202-4dec-9ad3-ade0db90a253</pvi:PersonvernInnstillingDefinisjonId> <!-- Bilateralt avtalt kodeverdi for aktuel part som samtykket gis til --> <pvi:Part>HUNT</pvi:Part> <pvi:PersonvernInnstillingNavn>Deltagelse i HUNT 4</pvi:PersonvernInnstillingNavn> </pvi:PersonvernInnstillingDefinisjonReferanse> <!-- Tidspunkt for når opprinnelig samtykke ble registrert --> <pvi:OpprettetTidspunkt>2018-01-16T11:09:38.4871148+01:00</pvi:OpprettetTidspunkt> <!-- Dersom en definisjon har metadata (strukturert del) skal disse være med i replikeringen. --> <pvi:Metadata> <SamtykkeMetadata> <SamtykkeFasteMetadata> <!-- Det tillates at samtykket gis for en bestemt tidsperiode gitt av definisjonen, dvs. lik for alle innbyggere --> <FastTidsbegrensning> <TidsbegrensetFra>2018-01-01</TidsbegrensetFra> <TidsbegrensetTil>2019-12-31</TidsbegrensetTil> </FastTidsbegrensning> <SamtykkeOmfangElement> <Omfang V="OF" DN="Oppføring" S="2.16.578.1.12.4.1.1.7608"/> </SamtykkeOmfangElement> <SamtykkeOmfangElement> <Omfang V="IO" DN="Innhenting av helseopplysninger" S="2.16.578.1.12.4.1.1.7608"/> <Presisering>Blodprøver</Presisering> </SamtykkeOmfangElement> </SamtykkeFasteMetadata> </SamtykkeMetadata> </pvi:Metadata> <!-- Kodesett for STATUS: 7609 --> <pvi:Status V="SAM" DN="Samtykket" S="2.16.578.1.12.4.1.1.7609" /> <pvi:Versjonsnummer>1</pvi:Versjonsnummer> <!-- Samme som opprettelses tidspunkt (når versjon=1) --> <pvi:SistEndretTidspunkt>2018-01-16T11:09:38.4871148+01:00</pvi:SistEndretTidspunkt> </InnbyggersSamtykke> </Content> </RefDoc> </Document>

 

Decument/

Pasient-relasjon

Obligatorisk informasjon: Pasientrelasjon skal være med når en annen person enn innbygger selv utfører handlingen på vegne av innbyggeren.

Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/690913297

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

 Metadata

 

Element

Beskrivelse

Omfang

Beskriver omfanget av samtykket. Eksempelvis «Samtykke til oppføring». Her benyttes kodeverk 7608. (Se under om hvilke verdier som er aktuelle for Samtykker)

Presisering

Valgfritt element som benyttes dersom «Omfang» trenger å detaljeres ytterligere. Her er det forutsatt at det avtales bilateralt kodeverdier mellom http://helsenorge.no og det enkelte register og at disse registreres som en del av definisjonen.

LogiskOmfang

Denne benyttes normalt ikke for samtykker. Samtykker skal være eksplisitte og det forutsettes at hvert omfang element beskriver det det gis samtykke til.

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

Kodeverk (V)

Visningsnavn

 (DN)

Beskrivelse

DT

Digital tilgang

Samtykke til at en tjeneste skal være tilgjengelig digitalt på nett.

OF

Oppføring

Samtykke til å være oppført i et register eller et forskningsprosjekt.

UO

Utlevering av helseopplysninger

 

Samtykke til at opplysninger kan utlevering til andre.

IO

Innhenting av helseopplysninger

Samtykke til at opplysninger kan innhentes for en tjeneste, register eller ordning.

 Status

Elementet status beskriver status for samtykket og benytter kodeverk 7609. Status elementet kan ha følgende verdier

Kodeverk (V)

Visningsnavn

 (DN)

Beskrivelse

RSAM

Registrere samtykke

Et eksternt system ber om at et samtykke som er gitt utenfor Helsenorge registreres i PVK.

SAM

Samtykket

Status for at et samtykke foreligger og er registrert i Personvernkomponenten. (Kan sendes autonomt eller være svar på en «RSAM». Se kapittel 10).

ASAM

Anmode om at samtykke trekkes

Benyttes dersom registeret har implementert en alternativ flyt der innbygger anmoder om at et samtykke trekkes. Når registeret har utført nødvendige oppgaver knyttet til at et samtykke er trukket, sendes en bekreftelse tilbake til Helsenorge med status «ISAM».