Funksjonalitet og bakgrunn

Noen aktører tilbyr et sett med helsetjenester til alle medlemmene sine og alle medlemmer mottar de samme helsetjenestene.
Basisinformasjon om disse helsekontaktene er nødvendig for Helsenorge som inngangsbillett til digitale innbyggertjenester som timeadministrasjon og dialog med behandler. Helsenorge har da informasjon om hvilke helsetjenester en innbygger mottar og hvor kommunikasjon skal sendes. Denne siden beskriver hvordan integrasjon med Helsenorge for oversending av helsetilbud og medlemsliste skal implementeres.

Figuren under viser løsningskomponentene for overføring av helsetilbud og medlemsinformasjon .

Tabellen under beskriver kortfattet komponentene som inngår i løsningen.

Autorisasjon

To metoder for tilgang er tilgjengelige:

1. HelseId sin autoriseringstjeneste for maskin-til-maskin kan benyttes:

   1. Velg Helsenorge Ekstern API i HelseId sin selvbetjeningsløsning

   2. Velg deretter scope “Helsekontakter”

   3. Når tilgangen er godkjent av Helsenorge, kan aksesstoken hentes ut fra HelseId

2. API-klienten kan alternativt autentisere seg mot Helsenorge Sikkerhetstjeneste.

   1. API-klienten må forhåndskonfigureres på Helsenorge med sin public key

   2. Fullmaktinformasjon API-et skal benyttes i system-til-system kontekst: 01 - System til System

   3. Deretter kan API-klienten få utsedt et AksessToken fra Helsenorge STS.

AksessToken som mottas fra HelseId eller Helsenorge STS skal deretter være med i Authorization header i alle HTTP-requestene. Se: 02 - Kall til Helsenorge og PVK API'er og bruk av AccessToken

Valg av standarder

For overføring av helsetilbud og medlemsinformasjon er den internasjonale standarden FHIR valgt, med bruk av versjon 4.0. Dokumentasjon av standarden fins her: http://hl7.org/fhir/.

Helsetilbud- HealthCareService bundle

For å oversende en virksomhets helsetilbud benyttes FHIR ressursen HealthCareService.
https://www.hl7.org/fhir/healthcareservice.html
For å håndtere knytninger til hvem som leverer tjenesten og hvor tjenesten leveres benyttes henholdsvis Organization og Location. Informasjonen sendes i en bundle og oppdateres som en transaksjon.

Medlemmer- Patient bundle

For å oversende medlemmer som mottar helsetilbud benytte FHIR ressursen Patient
https://www.hl7.org/fhir/patient.html
For å kunne sende en liste med flere pasienter benyttes ressursen bundle som er beskrevet her: https://www.hl7.org/fhir/bundle.html

Overføring av medlemstilbud

Dette avsnittet beskriver hvilken informasjon som skal sendes fra medlemssystem, ikke-funksjonelle krav som skal dekkes og angir et eksempel på hvordan forespørsel skal se ut.

Overføring av helsetilbud

Overføring av helsetilbud derfinerer hvilke helsetjenester medlemmene mottar.

Ved publisering av helsetilbud skal det gjøres en POST operasjon mot endepunkt eksponert av helsenorge.no
Forespørsel vil være på formen https://<miljø>/ helsekontakter/api/<versjon>
Eksempel fra integrasjonstestmiljø https://eksternapi-hn-mas-02.int-hn.nhn.no/helsekontakter/api/v1
Tabellen under viser hvilken informasjon som skal overføres for helsetilbud

Eksempel XML

URL

URL til de ulike miljøene i Helsenorge er vist i tabellen under.

Overføring av medlemsliste

Ved overføring av medlemsliste knyttes medlemmer til helsetilbudet.

Dersom innbygger ikke har samtykket til bruk av Helsenorge kan informasjon for denne innbyggeren ikke lagres, og Helsenorge vil da sende en status tilbake for dette.

• For at innbygger skal få tilgang til tjenester på Helsenorge må informasjon sendes på nytt senere

• Avsender persisterer informasjon om innbygger er digitalt aktiv og lager en prosess som jevnlig sender medlemmer som ikke er digitalt aktive.

Listen med innbyggere skal deles opp i et konfigurerbart antall, for å unngå timeout og store transaksjoner.

Forespørsel for medlemsliste

Forespørsel vil være på formen https://<miljø>/ helsekontakter/api/<versjon>
Eksempel fra integrasjonstestmiljø https://eksternapi-hn-mas-02.int-hn.nhn.no/helsekontakter/api/v1

Eksempel XML

Et XML-eksempel er vist under.

Respons medlemsliste

For hvert medlem som sendes i medlemslisten, vil Helsenorge svare med en respons for det spesifikke medlemmet. Et XML-eksempel for respons er vist under.

Ikke funksjonelle krav

Respons fra helsenorge.no

Respons fra helsenorge.no skal være i henhold til FHIR standard og bruk av RESTful api beskrevet her: https://www.hl7.org/fhir/http.html