Versions Compared

Old Version 1

changes.mady.by.user sven.christiansen

Saved on

compared with

New Version Current

changes.mady.by.user sven.christiansen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Husk å legg til etiketten “api-dokumentasjon” når denne malen benyttes, samt å slette denne notisen

Overordnet beskrivelse av meldingenMeldingene 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.

Page Properties

API-navn

Navn på API’et


PERSONVERN_INNBYGGER_SAMTYKKE

Funksjonelt område

Navn på det funksjonelle området

Status

Status
colourYellow
titleUnder utvikling

Personvern

API-versjon og dato publisert

Hvilken versjon er den siste

1.0

Status

Status
colourGreen
titleI Drift

Status
titleAvviklet

API-dokumentasjon sist endret

2021

Teknologi

Status
colourPurple
titleAMQP

Prosesser

Prosess og flyt

Her er info om prosesser og flyt

Her er strukturen på query
Expand
titleOverordnet flyt og sekvensdiagram

  • Dette inkluderes hvis man har en overordnet flyt og sekvensdiagram å vise til.

Forespørsel om ???

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).

Image Added

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.

Image Added

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

Image Added

Info

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

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

Meldingens innhold

Expand
titleStruktur på query

Svar på forespørsel om ???

Her er strukturen på en respons

Expand
titleStruktur på responsemelding

 

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:

  • Metadata

    • Omfang (obligatorisk)

    • Presisering (frivillig)

    • LogiskOmfang (frivillig)

    • Tidsbegrensning (fast på definisjonen)

  • TidsbegrensetTil

 

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.0"
          xmlns:pvi="http://ehelse.no/xmlstds/PersonvernInnstilling/v1.0"
          p1:schemaLocation="http://ehelse.no/xmlstds/samtykke/v1.0 samtykke-v1.0.xsd">
          <pvi:PersonvernInnstillingDefinisjonReferanse>
            <pvi:PersonvernInnstillingDefinisjonId>c351c83b-6202-4dec-9ad3-ade0db90a253</pvi:PersonvernInnstillingDefinisjonId>
            <!-- Bilateralt avtalt kodeverdi for aktuell 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>
              <SamtykkeOmfangElement>
                <Omfang V="OF" DN="Oppføring" S="2.16.578.1.12.4.1.1.7608"/>
              </SamtykkeOmfangElement>
            </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åren 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: Meldingsutveksling med Helsenorge og PVK

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

Expand
titleYtterligere informasjon om strukturen eller elementer i Query eller Response
Expand
titleEvt relevante kodeeksempler
Expand
titleBenytter av følgende komponenter

Navn

Type

Beskrivelse
i Melding

 Metadata

Image Added

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.

Tidsbegrensning

I kapittel 4 beskrev vi den generelle strukturen med eventuelle tidsbegrensninger på en personverninnstilling. For samtykker er det åpnet opp for at et av «omfang-elementene» det gis samtykke til kan ha en individuell tidsbegrensning som avviker fra øvrige.

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».

Expand
titleEvt relevante meldingseksempel

View file
name2018-04-18_Personvern_samtykke-gitt.xml