(V2.0 fases ut) 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.0 Apr 23, 2020

Status

I Drift

API-dokumentasjon sist endret

Dec 23, 2020

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

Obligatoriske elementer i Reservasjon:

  • PersonvernInnstillingDefinisjonReferanse

    • PersonvernInnstillingDefinisjonId

    • Part

    • PersonvernInnstillingNavn

  • OpprettetTidspunkt

  • Status

  • Versjonsnummer

  • SistEndretTidspunkt

Frivillige elementer i Reservasjon:

  • Metadata

    • Omfang (obligatorisk)

    • Presisering (frivillig)

    • LogiskOmfang (frivillig)

  • TidsbegrensetTil

 

Lovlige kodeverdier som kan brukes i Status:

  • RES –  Opprettet reservasjon

  • IRES - Tidligere opprettet reservasjon er fjernet

 

Eksempel på Reservasjonsdel når innbygger reserverer seg mot utlevering av helseopplsuyninger til andre formål enn primærformålet med registeret.

<Document>
    <!-- Overordnet beskrivelse av innhold" -->
    <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.0"
          xmlns:pvi="http://ehelse.no/xmlstds/PersonvernInnstilling/v1.0"
          p1:schemaLocation="http://ehelse.no/xmlstds/reservasjon/v2.0 reservasjon-v2.0.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 skal disse være med i replikeringen. -->
          <pvi:Metadata>
            <ReservasjonMetadata>
              <ReservasjonOmfangElement>
                <Omfang V="UO" DN="Utlevering av helseopplysninger" S="2.16.578.1.12.4.1.1.7608"/>
                <Presisering>ANDRE_FORMÅL</Presisering>
              </ReservasjonOmfangElement>
            </ReservasjonMetadata>
          </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: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/690913297

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

Metadata

 

Element

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.