Versions Compared

Old Version 42

changes.mady.by.user Alette N. L. Olrik

Saved on

compared with

New Version Current

changes.mady.by.user kjetill.vassmo.lund

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Digital Aktiv inngår i et sett med funksjoner på Helsenorge som HelsenorgeAktiv gir svar på om en innbygger er Digitalt aktiv i på Helsenorge, og eventuelt hvordan. Disse funksjonen Funksjonen kan benyttes fra helkseaktører av helseaktører for å avgjølre i hvilken grad avgjøre om Helsenorge er egnet for kommunikasjon med pasienten i det enkelte tilfellepasient. 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 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 der dette gjrøres maskinelt. 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 aktivHelsenorgeAktiv.

    Dokumentasjon:

    Status
    colourGreen
    titleFERDIG

    Løsningen:
    Status
    colourGreen
    titleI DRIFT

    Kun for NHN:

    Swagger
    Gi tilgang

    gliffyInnholdimageAttachmentId

    Table of Contents
    att1852571660
    style
    macroId57dbbb7e-c1cb-4978-a925-7ddc1f5cddcfbaseUrlhttps://helsenorge.atlassian.net/wikinameDigitl AKtivdiagramAttachmentIdatt1852702727containerId1810268162timestamp1654602906582
    none

    Forretningsbehov

    Expand
    titleBrukerhistorier & forretningsmessige akseptansekriterier
    Hva betyr det å være Digital aktiv?
    Expand
    titleBeskrivelse av Digitalt aktiv
    Svaret på Digital Aktiv

    Id

    Brukerhistorie

    Forretningsmessige akseptansekriterier

    1

    Som helseaktør behandler ønsker jeg å sjekke om en innbygger er digitalt tilstrekkelig aktiv i HN på Helsenorge slik at jeg vet om jeg kan sende meldinger/informasjon til mottaker pasienten kan følge et digitalt behandlingsløp eller ikke.

    • Tilgjengeliggjøre mulighet for integrasjonspart/helsepersonell til å gjøre kall for aktuell innbyggerinformasjonen for behandler slik at behandler kan vurdere om innbygger kan følge et digitalt behandlingsløp via Helsenorge eller ikke.

    2

    Som system behandler ø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

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

    2. Informasjon om Testmiljøer og endepunkter.

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

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

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

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

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

    View file
    nameBestilling tilgang til DigitalAktiv.docx

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

    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

    • Folkeregisteret

    • Om personens kontaktinformasjon i

    DigDirs “kontakt

    • Kontakt- og

    reservasjonsregister”

    • 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

    gjort

    • satt.

    • 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

    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

    kan motta digital informasjon innenfor det området det er snakk om i det aktuelle tilfellet

    at pasientens kan inngå i et behandlingsløp som inkluderer digital kommunikasjon.

    Aktiv via andre

    Betyr at det finnes minst

    en

    é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

    barnet det er snakk om

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

    Manglende samtykkekompetanse/Tildelt fullmakt

    Dersom det for en innbygger er opprettet en tildelt fullmakt vil det si at innbygger ikke er samtykkekompetent og innbygger har representant som opptrer i innbyggers sted på Helsenorge. Les mer om denne typen fullmakt her: https://www.helsenorge.no/fullmakt/om/fullmakt-pa-vegne-av-personer-med-manglende-samtykkekompetanse/

    Tolkning av svaret på

    DigitaltAktivOmråde

    HelsenorgeAktivSjekken

    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
    titleREST

    Metode DigitaltAktivOmraade

    Gir informasjon om én innbygger sin digitalt aktiv status

    Status
    titleREST

    Metode DigtaltAktivOmraadeliste

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

    Status
    titleREST

    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
    titleREST

    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)

    Integrasjonskrav

    Tabellen med krav og akseptansekriterier for integrasjonsparten finnes på egen underside.

    Integrasjonskrav Digital aktiv

    erAktivSelv eller erAktivViaAndre

    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

    		Ikke digitalt aktiv.svgImage Added

    Digitalt aktiv

    Innbygger er digitalt aktiv og kan nås på Helsenorge.

    erAktivSelv=ja

    erAktivViaAndre=nei

    Digitalt aktiv.svgImage Added

    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 selv og via andre.svgImage Added

    Digitalt aktiv via andre

    Innbygger er ikke digitalt aktiv selv, men via representant som følger med på Helsenorge.

    erAktivSelv=nei

    erAktivViaAndre=ja

    Digitalt aktiv via andre.svgImage Added

    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

    Manglende samtykkekompetanse.svgImage Added

    Ikke tilgjengelig

    Innbyggers status er for øyeblikket ikke tilgjengelig.

    sjekk svarer ikke

    Ikke tilgjengelig.svgImage Added

    Teknisk Implementasjon

    Det er mulig å sjekke status ved behov eller ha en lokalt cachet kopi som oppfriskes jevnlig. Flyten for de to tilfellene er vist i figuren under.

    Gliffy
    imageAttachmentIdatt1852571660
    macroId57dbbb7e-c1cb-4978-a925-7ddc1f5cddcf
    baseUrlhttps://helsenorge.atlassian.net/wiki
    nameDigitl AKtiv
    diagramAttachmentIdatt1852702727
    containerId1810268162
    timestamp1700478015143

    Teknologi

    Dokumentasjon

    Kommentar

    Status
    titleREST

    HelsenorgeAktivSjekken

    Gir informasjon om én eller flere innbygger sin digitalt aktiv-status. Ved periodisk ajourhold bør metodene benyttes med inntill masimalt antall pasienter pr kall, dvs. 1.000.