Gliffy | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Ikke-funksjonelle krav
Kvalitetskrav til integrasjonspartnere
Forretningsbehov
Expand | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
|
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 | |
Digitalt aktiv | Innbygger er digitalt aktiv og kan nås på Helsenorge. | erAktivSelv=ja erAktivViaAndre=nei | |
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 via andre | Innbygger er ikke digitalt aktiv selv, men via representant som følger med på Helsenorge. | erAktivSelv=nei erAktivViaAndre=ja | |
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 | |
Ikke tilgjengelig | Innbyggers status er for øyeblikket ikke tilgjengelig. | sjekk svarer ikke |
Forutsetninger og tips
Bestilling av tilgang til ekstern-API, eller ved behov for opprettelse av nye installasjoner for HelsenorgeAktiv-sjekk, skal sendes til ide-ogbestillingsmottak@nhn.no. Fyll ut bestillingsskjema under.
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åN whiteliste IP-adressen trafikken kommer fra.
Aktør er konfigurert med en API-klient i avtalt/egnet testmiljø
API-klient er gitt tilgang til STS i context (System til System - V2)
API-klient er gitt tilgang til DigitalAktiv API
NB! Helsen orgeAktiv-svaret fra Helsenorge inneholder ikke 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 f.eks. at viktige brev kan leveres på Helsenorge. For slike behov skal metoden FinnFormidlingskanal eller eventuelt videreformidlingstjenesten på Helsenorge 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 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
Om personens kontaktinformasjon i Kontakt- og 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 satt.
Om det er et barn som har en forelder som kan representere det
Om personen har gitt andre fullmakt til å operere på vegne av seg (og til hva)
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 at pasientens kan inngå i et behandlingsløp som inkluderer digital kommunikasjon.
Aktiv via andre
Betyr at det finnes minst é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 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å.
Tolkning av svaret på HelsenorgeAktivSjekken
Integrasjonsparten er ansvarlig for å avgjøre hva som er riktig å gjøre med svarene. Aktøren må selv definere behov for å skille på erAktivSelv eller erAktivViaAndre
Teknisk Implementasjon
Teknologi | Dokumentasjon | Kommentar | ||||
---|---|---|---|---|---|---|
| Gir informasjon om én eller flere innbygger sin digitalt aktiv-status | |||||
| 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 HelsenorgeAktivSjekken ikke er egnet å benytte direkte. | |||||
| 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 | ||||||