Digitalt aktiv

Digital Aktiv inngår i et sett med funksjoner på Helsenorge som gir svar på om en innbygger er Digitalt aktiv i Helsenorge, og eventuelt hvordan. Disse funksjonen kan benyttes fra helkseaktører for å avgjølre i hvilken grad Helsenorge er egnet for kommunikasjon med pasienten i det enkelte tilfelle. Les mer om dette på nhn.no: Hvem når du på Helsenorge?

Det er 3 tilgjengelige metoder i API’et:

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

Helsenorge vil alltid sjekke status for digitalt aktiv hver gang en melding mottas eller informasjon sendes via et API. Det er derfor ikke nødvendig å sjekke status før hver sending. 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 aktiv.

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.

Forutsetninger & tips

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.
~~Informasjon om~~ ~~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 i test-systemene våre, må NHN whiteliste IP adressen, trafikken kommer fra.
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
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.
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.

Hva betyr det å være Digital aktiv?

Beskrivelse av Digitalt aktiv

Svaret på Digital Aktiv er ikke binært ja/nei og 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

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
REST	Metode DigitaltAktivOmraade	Gir informasjon om én innbygger sin digitalt aktiv status
REST	Metode DigtaltAktivOmraadeliste	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 - V2	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”.
		Hvordan generere et RSA-nøkkelpar som skal benyttes for autentisering mot STS
		Kall til STS for å få AksessToken som må benyttes for å få tilgang til API
		Hvordan inkludere AksessToken (man fikk fra STS i API-kall)