Digitalt aktiv

Digital Aktiv er en funksjon på Helsenorge som gir svar på om en innbygger er Digitalt aktiv i Helsenorge, slik at meldinger kan utveksles eller på annen måte kan kontaktes via 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 henvendelsen sendes til ide-ogbestillingsmottak@nhn.no
Fyll ut dette 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. videreformidling av viktige brev.
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 alle endringene fra hele folkeregisteret.

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