Versions Compared

Key

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

Digital Aktiv er en funksjon på Helsenorge som HelsenorgeAktiv gir svar på om en aktuell innbygger har Digitalt er aktiv status i Helsenorge, slik at meldinger kan utveksles
Det er 2 alternativer:

  • Metoden DigitaltAktivOmraade brukes av eksterne aktører for å undersøke om en innbygger er digitalt aktiv på Helsenorge eller ikke. Basert på svaret, kan det eksterne systemet vurdere om det kan og bør kommunisere med innbyggeren via Helsenorge og/eller om det må benytte alternative kanaler. Dette er den foretrukne metoden, og bør benyttes i det behov for dialog med innbygger oppstår.

  • DigitaltAktivStatusEndringer. Denne gir en totaloversikt over de innbyggere på Helsenorge 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 å kalle metoden DigitaltAktivOmraade for de pasienter som er på “endringslisten” og samtidig finnes lokalt

    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?

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

    Dokumentasjon:

    Status
    colourPurpleGreen
    titleUnder arbeidFERDIG

    Løsningen:
    Status
    colourGreen
    titleI DRIFT

    gliffyInnholdimageAttachmentId

    Table of Contents
    att867762177macroIda9b86c6c-90b1-478f-804d-8e9503a2aca8baseUrlhttps://helsenorge.atlassian.net/wikinameDigitalAktivdiagramAttachmentIdatt867631118containerId23691265timestamp1608017706283
    stylenone

    Forretningsbehov

    Expand
    titleBrukerhistorier & forretningsmessige akseptansekriterier

    Id

    Brukerhistorie

    Forretningsmessige akseptansekriterier

    1

    Som integrasjonspart 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 informasjonen for behandler slik at behandler kan vurdere om innbygger kan følge et digitalt behandlingsløp via Helsenorge eller ikke.

    2

    Svaret er nyansert avhengig av hvilket tjenesteområde det spørres om for den spesifikke innbyggeren. Ved å kunne spørre om innbygger er digital aktiv innenfor forskjellige tjenesteområder, tas det høyde for at innbygger på Helsenorge kan nyansere hvilke digitale helsetjenester de ønsker å benytte/få og hvilke de evt. ønsker å reservere seg mot.

    3

    Som legekontor … i …. ønsker jeg å …….
    slik at……

    Forutsetninger & tips

    1. <Liste forutsetninger 1>

    2. <Liste forutsetninger 2>

    Hva betyr det å være Digital aktiv?

    Spørsmålet om en person er Digital Aktiv er ikke et binært ja/nei-spørsmål. Svarene funksjonen gir vil avhenge av

    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 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 Difis kontaktKontakt- 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 gjortsatt.

    • 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

    : DigitalAktiv-sjekken for Helsenorge er helt uavhengig av om en

    at HelseorgeAktiv-svaret fra Helsenorge ikke inneholder status på om innbygger har reservert seg mot digital kommunikasjon i

    DigDirs kontakt

    Kontakt- og

    reservasjonsregister

    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ådeDet er den eksterne aktøren og det eksterne systemet som

    HelsenorgeAktivSjekken

    Integrasjonsparten er ansvarlig for å avgjøre hva som er riktig å gjøre

    i hvert enkelt tilfelle basert på

    med svarene.

    Den eksterne aktøren

    Aktøren

    derfor selv definere hva som er riktige forretningsregler for sin bruk når det gjelder de ulike svarkombinasjonene i svaret fra DigitalAktivOmraade

    En innbygger kan være:

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

    • kun aktiv selv

    • kun aktiv via andre

    • ingen av delene

    Teknisk Implementasjon

    Feilhåndtering

    Følgende responskoder kan forventes fra Helsenorge:

    Alle tjenester i API'ene har følgende logikk for HTTP-respons:

    • Statuskode når kallet er utført ok: 200 

    • Statuskode ved feilende validering av request: 400

    • Statuskodde ved feil eller manglende autorisasjon: 401

    • Statuskode ved manglende tilganger: 403

    Ved HTTP-statuskoder som tilsier at det har oppstått en feil returneres også en respons med feilkode og feilmelding.

    Eks:
    {
      "Code": "SEC-110000",
      "Message": "Token is expired or invalid"
    }

    Teknologi

    Dokumentasjon

    Kommentar

    Status
    titleREST

    Metode DigitaltAktivOmråde

    Gir informasjon om en innbygger sin digitalt aktiv status

    selv definere behov for å skille på 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
    Integrasjonskrav Digital aktiv

    Teknologi

    Dokumentasjon

    Kommentar

    Status
    titleREST

    Metode DigitaltAktivStatusEndringer

    HelsenorgeAktivSjekken

    Gir informasjon om

    hvilke innbyggere som potensielt har fått endret

    én eller flere innbygger sin digitalt aktiv

    status siden angitt tidspunkt

    Status
    titleREST
    ?

    01 - 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 dokumentasjonen til venstre.

    Integrasjonskrav

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

    -status. Ved periodisk ajourhold bør metodene benyttes med inntill masimalt antall pasienter pr kall, dvs. 1.000.