Page Comparison

Info

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

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:

Status

colour	Green
title	FERDIG

Løsningen:

Status

colour	Green
title	I DRIFT

Gliffy

imageAttachmentId	att1852571660
macroId	57dbbb7e-c1cb-4978-a925-7ddc1f5cddcf
baseUrl	https://helsenorge.atlassian.net/wiki
name	Digitl AKtiv
diagramAttachmentId	att1852702727
containerId	1810268162
timestamp	1654602906582

Forretningsbehov

Expand

title	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. videreformidling av 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 alle endringene fra hele folkeregisteretendring for all innbyggere som er på Helsenorge.

View file

name	Bestilling tilgang til DigitalAktiv.docx

Hva betyr det å være Digital aktiv?

Expand

title	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

Status

title	REST

Metode DigitaltAktivOmraade

Gir informasjon om én innbygger sin digitalt aktiv status

Status

title	REST

Metode DigitaltAktivOmraadeliste

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

Status

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

Status

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

Versions Compared

Old Version 39

New Version 40

Key

Forretningsbehov

Forutsetninger & tips

Hva betyr det å være Digital aktiv?

Aktiv selv

Aktiv via andre

Tolkning av svaret på DigitaltAktivOmråde

Teknisk Implementasjon

Integrasjonskrav