HelsenorgeAktiv

HelsenorgeAktiv gir svar på om en innbygger er aktiv på Helsenorge, og eventuelt hvordan. Funksjonen kan benyttes av helseaktører for å avgjøre om Helsenorge er egnet for kommunikasjon med pasient. Les mer om dette på nhn.no: Hvem når du på Helsenorge?

Det er 2 tilgjengelige metoder i API-et:

  1. Metoden HelsenorgeAktivSjekken brukes for å få svar på om en innbygger er digitalt aktiv på Helsenorge eller ikke. Innbygger kan være digitalt aktiv via andre, enten ved at foreldre representerer et barn, at en voksen representerer en annen voksen basert på fullmakt, eller at en voksen representerer en annen voksen eller et barn via såkalt tildelt fullmakt. Tildelt fullmakt innebærer at den som representeres ikke er samtykkekompetent. Metoden kan ta inntil 1000 fødselsnummer i samme forespørsel. Dette er den foretrukne metoden for å kunne vise behandler pasientens digitale status på Helsenorge i sann tid.

  2. Metoden DigitaltAktivStatusEndringer. Denne er beregnet for systemer som ønsker å ha “lokal kopi” av sine pasienters digitale status på Helsenorge. Denne gir en totaloversikt over de innbyggere som potensielt har fått endret HelsenorgeAktiv-status siden et gitt tidspunkt. Ved å sammenlikne dette svaret med lokal “pasient status-liste”, vil det kun være behov for deretter å kalle metoden HelsenorgeAktivSjekken for de pasienter i systemet som er på “endringslisten”.

Helsenorge vil alltid sjekke status for HelsenorgeAktiv hver gang en melding mottas eller informasjon sendes via et API til Helsenorge. 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 HelsenorgeAktiv.

Dokumentasjon: FERDIG
Løsningen: I DRIFT

 

 

Ikke-funksjonelle krav

Forretningsbehov

Id

Brukerhistorie

Forretningsmessige akseptansekriterier

1

Som behandler ønsker jeg å sjekke om en innbygger er tilstrekkelig aktiv på Helsenorge slik at jeg vet om pasienten kan følge et digitalt behandlingsløp eller ikke.


  • Tilgjengeliggjøre informasjonen for behandler slik at behandler kan vurdere om innbygger kan følge et digitalt behandlingsløp via Helsenorge eller ikke.

2

Som behandler ønsker jeg å vite om det er innbygger selv eller en representant som er aktiv på Helsenorge slik at jeg vet hvem jeg når når jeg benytter Helsenorge som kanal.

 

I de fleste tilfeller skilles det ikke på hvordan en innbygger er aktiv i HN.
Det er kun ved enkelte meldingstyper hvor systemet må håndtere om aktiv status via andre skal hindre utførelse.

  • Tilgjengeliggjøre informasjon for behandler om hvem som er aktiv på Helsenorge på vegne av aktuell innbygger:

    • Innbygger selv (aktiv selv)

    • En forelder (aktiv via andre)

    • En fullmektig (aktiv via andre)

  • En innbygger kan være:

    • kun aktiv selv

    • kun aktiv via andre

    • både digitalt aktiv selv og samtidig aktiv via andre

    • ingen av delene

3

Som behandler ønsker jeg, dersom innbygger er aktiv via andre, å vite om representanten har en tildelt fullmakt slik at jeg vet om innbygger er ikke-samtykkekompetent og fullmektig kan erstatte direkte kontakt med innbyggeren.

  • Tilgjengeliggjøre informasjon for behandler dersom en innbygger er representert av en fullmektig basert på en tildelt fullmakt (en fullmakt som utstedes til nærmeste pårørende for en ikke-samtykkekompetent innbygger)

4

Som behandler ønsker jeg å kunne benytte Helsenorge som kanal, dersom jeg vurderer at innbygger kan følge et digitalt behandlingsløp.

  • Systemet tilbyr digital dialog med innbygger på Helsenorge, dersom behandler vurderer dette som hensiktsmessig

 

5

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 eventuelle 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. Ved kommunikasjonsfeil, logge/fortelle sluttbruker at noe har gått galt.

 

6

Som helseaktør må jeg kunne skille på om helsehjelpen er knyttet til ordinær bruk av Helsenorge eller om det er knyttet til ungdomstjenester der ungdom fra 13 år selv kan gi samtykke til egen bruk av Helsenorge (primært i bruk i forbindelse med timebestilling hos helsesykepleier på skolen).

Systemene må håndtere forespørsler og mottak av svar for følgende områder:

  • 3 (Helsehjelp)

  • 6 (Ungdom) - nytt område (2022) for ungdom som er innlogget selv gjennom eget samtykke og som er mellom 13-23 år)
    Volven kodeverk, 7618

HelsenorgeAktivSjekken skal benyttes ved ytelse av Helsehjelp til innbygger.

Forutsetninger og tips

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

  2. API-et krever at klienten på forhånd har autentisert seg mot vår Sikkerhetstjeneste og fått utstedt et aksesstoken.

  3. For å nå https://eksternapi i test-systemene våre må NHN whiteliste IP-adressen trafikken kommer fra.

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

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

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

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

Teknologi

Dokumentasjon

Kommentar

REST

Gir informasjon om én eller flere innbygger sin digitalt aktiv-status

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 HelsenorgeAktivSjekken 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)