Versions Compared

Old Version 40

changes.mady.by.user sven.christiansen

Saved on

compared with

New Version Current

changes.mady.by.user kjetill.vassmo.lund

Saved on

Key

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

Digital Aktiv inngår i et sett med funksjoner på Helsenorge som HelsenorgeAktiv gir svar på om en innbygger er Digitalt aktiv i på Helsenorge, og eventuelt hvordan. Disse funksjonen Funksjonen kan benyttes fra helkseaktører av helseaktører for å avgjølre i hvilken grad avgjøre om Helsenorge er egnet for kommunikasjon med pasienten i det enkelte tilfellepasient. Les mer om dette HER.
Det er 3 tilgjengelige metoder i API’et:

  1. Metoden DigitaltAktivOmraade brukes for å få svar på om en innbyggers digitale status i Helsenorge. Dette er den foretrukne metoden og vil være tilstrekkelig for legekontorer og andre med mindre pasientmengder.

  2. Metoden DigitaltAktivOmraadeliste Samme som over men man kan spørre om status på mange innbyggere i samme API-kall (dvs. en liste med fødselsnummer max 1000 per kall).

  3. Metoden DigitaltAktivStatusEndringer. Denne gir en totaloversikt over de som potensielt har fått endret DigitalAktiv status siden et gitt tidspunkt. Ved å sammenlikne dette svaret med lokal “pasient status-liste”, vil det kun være behov for deretter å kalle metoden DigitaltAktivOmraadeListe for de pasienter i systemet som er på “endringslisten”.

på nhn.no: Hvem når du på Helsenorge?

Helsenorge vil alltid sjekke status for digitalt aktiv HelsenorgeAktiv hver gang en melding mottas eller informasjon sendes via et API til Helsenorge. Det er derfor ikke nødvendig å sjekke status før hver sending der dette gjrøres maskinelt. Avsender må også håndtere at status kan ha blitt endret siden sjekk ble gjort og alle meldinger/API-kall kan svare med negativ status for digitalt aktivHelsenorgeAktiv.

Dokumentasjon:

Status
colourGreen
titleFERDIG

Løsningen:
Status
colourGreen
titleI DRIFT

Kun for NHN:

Swagger
Gi tilgang

gliffyInnholdimageAttachmentId

Table of Contents
att1852571660macroId57dbbb7e-c1cb-4978-a925-7ddc1f5cddcfbaseUrlhttps://helsenorge.atlassian.net/wikinameDigitl AKtivdiagramAttachmentIdatt1852702727containerId1810268162timestamp1654602906582
stylenone

Forretningsbehov

Expand
titleBrukerhistorier & forretningsmessige akseptansekriterier
Hva betyr det å være Digital aktiv?
Expand
titleBeskrivelse av Digitalt aktiv
Svaret på Digital Aktiv

Id

Brukerhistorie

Forretningsmessige akseptansekriterier

1

Som helseaktør behandler ønsker jeg å sjekke om en innbygger er digitalt tilstrekkelig aktiv i HN på Helsenorge slik at jeg vet om jeg kan sende meldinger/informasjon til mottaker pasienten kan følge et digitalt behandlingsløp eller ikke.

  • Tilgjengeliggjøre mulighet for integrasjonspart/helsepersonell til å gjøre kall for aktuell innbyggerinformasjonen for behandler slik at behandler kan vurdere om innbygger kan følge et digitalt behandlingsløp via Helsenorge eller ikke.

2

Som system behandler ønsker jeg å sjekke på digital status i HN avhengig av hvilket område min tjeneste gjelder.

  • Integrasjonspart må dekke aktuelle, en til flere tjenesteområder.

3

Som helseaktør ønsker jeg å sjekke hvilke innbyggere som har endret status, slik at jeg ikke trenger å sjekke status for alle innbyggere for å fange opp statusendringer

Systemet kan sjekke hvilke innbyggere som har endret status, sammenligne med lokal pasientliste og lokalt lagret status og hente oppdatert status for innbyggere som har endret status.

Forutsetninger & tips

  1. Bestilling av tilgang til eksternapi, eller ved behov for opprettelse av nye installasjoner for digital aktiv sjekk, skal sendes til ide-ogbestillingsmottak@nhn.no. Fyll ut bestillingsskjema under.

  2. Informasjon om Testmiljøer og endepunkter.

  3. API’et krever at klienten på forhånd har autentisert seg mot vår Sikkerhetstjeneste og fått utstedt et aksesstoken.

  4. For å nå https://eksternapi i test-systemene våre, må NHN whiteliste IP adressen, trafikken kommer fra.

  5. Aktør er konfigurert med en API-klient i avtalt/egnet testmiljø 

    1. API-klient er gitt tilgang til STS i context (System til System - V2) 

    2. API-klient er gitt tilgang til DigitalAktiv API 

  6. NB! DigitaltAktiv svaret fra HN inneholder ikke status på om innbygger har reservert seg mot digital kommunikasjon i DigDirs kontakt- og reservasjonsregister. Det betyr at personer kan være aktive på Helsenorge, også i de tilfeller hvor de har reservert seg mot digital kommunikasjon sentralt. Dette hindrer ikke digital dialog via HN (som har eget samtykke), men hindrer f.eks. at viktige brev kan leveres på Helsenorge. For slike behov kan videreformidlingstjenesten på HN benyttes.

  7. Dersom DigitaltAktivStatusEndringer sendes uten dato, vises resultat for siste 3 måneder.
    Denne metoden skiller kun på område (fra forespørselen), ikke på virksomhet - mao svaret inneholder endring for all innbyggere som er på Helsenorge.

View file
nameBestilling tilgang til DigitalAktiv.docx

vite om det er innbygger selv eller en representant som er aktiv på Helsenorge slik at jeg vet hvem jeg når når jeg benytter Helsenorge som kanal.

I de fleste tilfeller skilles det ikke på hvordan en innbygger er aktiv i HN.
Det er kun ved enkelte meldingstyper hvor systemet må håndtere om aktiv status via andre skal hindre utførelse.

  • Tilgjengeliggjøre informasjon for behandler om hvem som er aktiv på Helsenorge på vegne av aktuell innbygger:

    • Innbygger selv (aktiv selv)

    • En forelder (aktiv via andre)

    • En fullmektig (aktiv via andre)

  • En innbygger kan være:

    • kun aktiv selv

    • kun aktiv via andre

    • både digitalt aktiv selv og samtidig aktiv via andre

    • ingen av delene

3

Som behandler ønsker jeg, dersom innbygger er aktiv via andre, å vite om representanten har en tildelt fullmakt slik at jeg vet om innbygger er ikke-samtykkekompetent og fullmektig kan erstatte direkte kontakt med innbyggeren.

  • Tilgjengeliggjøre informasjon for behandler dersom en innbygger er representert av en fullmektig basert på en tildelt fullmakt (en fullmakt som utstedes til nærmeste pårørende for en ikke-samtykkekompetent innbygger)

4

Som behandler ønsker jeg å kunne benytte Helsenorge som kanal, dersom jeg vurderer at innbygger kan følge et digitalt behandlingsløp.

  • Systemet tilbyr digital dialog med innbygger på Helsenorge, dersom behandler vurderer dette som hensiktsmessig

5

Som helseaktør må jeg kunne skille på om helsehjelpen er knyttet til ordinær bruk av Helsenorge eller om det er knyttet til ungdomstjenester der ungdom fra 13 år selv kan gi samtykke til egen bruk av Helsenorge (primært i bruk i forbindelse med timebestilling hos helsesykepleier på skolen).

Systemene må håndtere forespørsler og mottak av svar for følgende områder:

  • 3 (Helsehjelp)

  • 6 (Ungdom) - nytt område (2022) for ungdom som er innlogget selv gjennom eget samtykke og som er mellom 13-23 år)
    Volven kodeverk, 7618

HelsenorgeAktivSjekken skal benyttes ved ytelse av Helsehjelp til innbygger.

Hva betyr det å være HelsenorgeAktiv?

Svaret på HelsenorgeAktivSjekken er ikke binært ja/nei og svaret funksjonen gir

,

vil avhenge av mange faktorer:

  • Hvilke opplysninger som er registrert om personen i

folkeregisteret

  • Folkeregisteret

  • Om personens kontaktinformasjon i

DigDirs “kontakt

  • Kontakt- og

reservasjonsregister”

  • reservasjonsregisteret fra Digitaliseringsdirektoratet er oppdatert eller bekreftet siste 18 mnd.

  • Om personen har tatt i bruk Helsenorge

,

  • og i så fall hvilke samtykker og personverninnstillinger personen har

gjort

  • satt.

  • Om det er et barn som har en

voksen (

  • forelder

)

  • som kan representere det

  • Om personen har gitt andre fullmakt til å operere på vegne av seg (og til hva)

Hvilke type tjeneste/område det er snakk om

Merk at HelseorgeAktiv-svaret fra Helsenorge ikke inneholder status på om innbygger har reservert seg mot digital kommunikasjon i Kontakt- og reservasjonsregisteret fra Digitaliseringsdirektoratet. Det betyr at personer kan være aktive på Helsenorge også i de tilfeller hvor de har reservert seg mot digital kommunikasjon sentralt. Dette hindrer ikke digital dialog via Helsenorge (som har eget samtykke), men hindrer for eksempel at viktige brev kan leveres bare på Helsenorge. For slike behov skal metoden FinnFormidlingskanal eller eventuelt videreformidlingstjenesten på Helsenorge benyttes.

Aktiv selv

Betyr at innbygger har en aktiv profil på Helsenorge og

kan motta digital informasjon innenfor det området det er snakk om i det aktuelle tilfellet

at pasientens kan inngå i et behandlingsløp som inkluderer digital kommunikasjon.

Aktiv via andre

Betyr at det finnes minst

en

én annen person som har tilgang til å representere den aktuelle innbyggeren innenfor det aktuelle området på Helsenorge. Dvs. at det finnes andre som kan få tilgang til informasjon på vegne av innbyggeren og evt. utføre aktuelle handlinger på vegne av denne. Dette kan også fungere som et supplement i tillegg til informasjon som også må gis i andre kanaler for å nå innbygger direkte. Personen(

-

e) som kan representere andre på denne måten har fått denne tilgangen gjennom fullmakt eller fordi de har foreldreansvar for

barnet det er snakk om

et barn.
Helsenorge tilbyr pårørendeinvolvering og ønsker å gjøre det lettest mulig å være pårørende. Det betyr at vi ønsker å tilrettelegge slik at det er mulig å tilgjengeliggjøre mest mulig informasjon for pårørende samtidig som vi ivaretar at innbyggeren/pasienten selv får informasjon på den måten de har krav på.

Manglende samtykkekompetanse/Tildelt fullmakt

Dersom det for en innbygger er opprettet en tildelt fullmakt vil det si at innbygger ikke er samtykkekompetent og innbygger har representant som opptrer i innbyggers sted på Helsenorge. Les mer om denne typen fullmakt her: https://www.helsenorge.no/fullmakt/om/fullmakt-pa-vegne-av-personer-med-manglende-samtykkekompetanse/

Tolkning av svaret på

DigitaltAktivOmråde

HelsenorgeAktivSjekken

Integrasjonsparten er ansvarlig for å avgjøre hva som er riktig å gjøre med svarene. Aktøren må selv definere behov for å skille på

erDigitaltAktivSelv eller erDigitalAktivViaAndre

Teknisk Implementasjon

Teknologi

Dokumentasjon

Kommentar

Status
titleREST

Metode DigitaltAktivOmraade

Gir informasjon om én innbygger sin digitalt aktiv status

Status
titleREST

Metode DigitaltAktivOmraadeliste

Samme som over, men støtter å spørre om status på flere innbyggere i samme API-kall.

Status
titleREST

Metode DigitaltAktivStatusEndringer

Gir informasjon om hvilke innbyggere som har endret sin digitalt aktiv status siden angitt tidspunkt.

Benyttes for store aktører (f.eks. RHF og store kommuner) der DigitaltAktivOmråde ikke er egnet å benytte direkte.

Status
titleREST

V1 - AVVIKLET - System til System

Autorisasjon og aksesstoken

Alle API’er krever at klienten på forhånd har autentisert seg mot vår Sikkerhetstjeneste og fått utstedt et aksesstoken som skal være med i tjenestekallene til det enkelte API. DigitalAktiv tjenesten krever ikke at kallet utføres i context av en innlogget bruker dvs. UseCase 1 (system-til-system) beskrevet i “01 - System - System”.

Integrasjonskrav

Tabellen med krav og akseptansekriterier for integrasjonsparten finnes på egen underside.

Integrasjonskrav Digital aktiv

erAktivSelv eller erAktivViaAndre

Visning av innbyggers status i fagsystem

Det er utarbeidet et sett ikoner som kan benyttes til å vise innbyggers status i brukerflaten i fagsystemet som benytter HelsenorgeAktivSjekken.

Status

Forslag til forklarende tekst

Benyttes når

Ikon

Ikke digitalt aktiv

Innbygger er ikke digitalt aktiv og kan ikke nås på Helsenorge

erAktivSelv=nei

erAktivViaAndre=nei

Ikke digitalt aktiv.svgImage Added

Digitalt aktiv

Innbygger er digitalt aktiv og kan nås på Helsenorge.

erAktivSelv=ja

erAktivViaAndre=nei

Digitalt aktiv.svgImage Added

Digitalt aktiv selv og via andre

Innbygger er digitalt aktiv selv og kan nås på Helsenorge. Innbygger har også representant som følger med på Helsenorge.

erAktivSelv=ja

erAktivViaAndre=ja

Digitalt aktiv selv og via andre.svgImage Added

Digitalt aktiv via andre

Innbygger er ikke digitalt aktiv selv, men via representant som følger med på Helsenorge.

erAktivSelv=nei

erAktivViaAndre=ja

Digitalt aktiv via andre.svgImage Added

Manglende samtykkekompetanse

Innbygger er ikke samtykkekompetent, men er aktiv via representant som opptrer i innbyggers sted på Helsenorge.

erAktivSelv=ja/nei

erAktivViaAndre=ja

tildeltFullmakt=ja

Manglende samtykkekompetanse.svgImage Added

Ikke tilgjengelig

Innbyggers status er for øyeblikket ikke tilgjengelig.

sjekk svarer ikke

Ikke tilgjengelig.svgImage Added

Teknisk Implementasjon

Det er mulig å sjekke status ved behov eller ha en lokalt cachet kopi som oppfriskes jevnlig. Flyten for de to tilfellene er vist i figuren under.

Gliffy
imageAttachmentIdatt1852571660
macroId57dbbb7e-c1cb-4978-a925-7ddc1f5cddcf
baseUrlhttps://helsenorge.atlassian.net/wiki
nameDigitl AKtiv
diagramAttachmentIdatt1852702727
containerId1810268162
timestamp1700478015143

Teknologi

Dokumentasjon

Kommentar

Status
titleREST

HelsenorgeAktivSjekken

Gir informasjon om én eller flere innbygger sin digitalt aktiv-status. Ved periodisk ajourhold bør metodene benyttes med inntill masimalt antall pasienter pr kall, dvs. 1.000.