Digitalt aktiv

Digital Aktiv er en funksjon på Helsenorge som gir svar på om en innbygger er Digitalt aktiv status i Helsenorge, slik at meldinger kan utveksles eller på annen måte kan kontaktes på Helsenorge.

Det er 3 alternative metoder:

Metoden DigitaltAktivOmraade brukes for å få svar på om en innbyggers digitale status i Helsenorge. Det bør kun sjekkes på pasienter som har status inaktiv. Dette er den foretrukne metoden og vil være tilstrekkelig for legekontorer og andre med mindre pasientmengder.
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)
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 å kalle metoden DigitaltAktivOmraade for de pasienter i systemet som er på “endringslisten”.

Dokumentasjon: FERDIG
Løsningen: I DRIFT

Forretningsbehov

Brukerhistorier & forretningsmessige akseptansekriterier

Id	Brukerhistorie	Forretningsmessige akseptansekriterier
1	Som helseaktør ønsker jeg å sjekke om en innbygger er digitalt aktiv i HN slik at jeg vet om jeg kan sende meldinger/informasjon til mottaker eller ikke.	Tilgjengeliggjøre mulighet for integrasjonspart/helsepersonell til å gjøre kall for aktuell innbygger.
2	Som system ø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. Dette kan gjøres for store aktører, for å unngå svært mange kall for å sjekke endringer i status.

Forutsetninger & tips

Bestilling av tilgang til eksternapi for sjekk av digital aktiv sendes til ide-ogbestillingsmottak@nhn.no
Her må det beskrives til hva, hvilket område, og hvilken metode APIet skal benyttes for.
Miljøer og endepunkter er tilgjengelig her: Testmiljøer og endepunkter
API’et krever at klienten på forhånd har autentisert seg mot vår Sikkerhetstjeneste og fått utstedt et aksesstoken.
For å nå https://eksternapi må man whiteliste IP trafikken kommer fra
NB! Digitalt aktiv 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. videreformidling av brev.

Hva betyr det å være Digital aktiv?

Beskrivelse av Digitalt aktiv

Svaret på Digital Aktiv er binært ja/nei. Men svaret funksjonen gir, vil avhenge av mange faktorer:

Hvilke opplysninger som er registrert om personen i folkeregisteret
Om personens kontaktinformasjon i DigDirs “kontakt- og reservasjonsregister” 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
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

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.

Aktiv via andre

Betyr at det finnes minst en 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.
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å.

Tolkning av svaret på DigitaltAktivOmråde

Det er den eksterne aktøren og det eksterne systemet som er ansvarlig for å avgjøre hva som er riktig å gjøre i hvert enkelt tilfelle basert på svarene. Den eksterne aktøren må derfor selv definere hva som er riktige forretningsregler for sin bruk når det gjelder de ulike svarkombinasjonene i svaret fra DigitalAktivOmraade

Teknisk Implementasjon

Teknologi	Dokumentasjon	Kommentar
REST	Metode DigitaltAktivOmraade	Gir informasjon om én innbygger sin digitalt aktiv status
REST	Metode DigitaltAktivOmraadeliste	Samme som over, men støtter å spørre om status på flere innbyggere i samme API-kall.
REST	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.
REST	01 - 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”.