Synkron integrasjon
REST-kall til endepunkt hos aktør
Benyttes alltid HTTPS (ikke krav om toveis-SSL)
Det benyttes alltid HTTP POST.
Alltid bruk av JWT token i REST-kall. Dette skal “forstås- og valideres av aktør: Innlogget innbygger
Be om innsyn i registrerte opplysninger (i Helseregistre)
Kall:
URL som er konfigurert på Helsenorge peker til metode i endepunkt hos aktør som gir denne funksjonaliteten. Ingen parametere, kun JWT-token i HTTP-header (der representert innbyggers fødselsnummer finnes).
Respons:
HTTP-respons kode
Payload:
Innsyn-v5.1.xsd (se skjemaer nederst på siden)
Be om innsyn i Logg over bruk (i Helseregistre)
Kall:
URL som er konfigurert på Helsenorge peker til metode i endepunkt hos aktør som gir denne funksjonaliteten. Ingen parametere, kun JWT-token i HTTP-header.
Respons:
HTTP-respons kode
Payload:
Logg-respons_v1.1.xsd (se skjemaer nederst på siden)
Be om status på deltagelse i forskningsprosjekter og screeningprogrammer
Kall:
URL som er konfigurert på Helsenorge peker til metode i endepunkt hos aktør som gir denne funksjonaliteten. Ingen parametere, kun JWT-token i HTTP-header.
Respons:
HTTP-respons kode
Payload:
Under implementering: Status-rapport_v1.0.xsd (se skjemaer nederst på siden)
Inkludert skjema: Innsyn-felles-v1.0.xsd
Kan inneholde selvbetjeningsfunksjoner:
Kall når selvbetjeningsfunksjon utføres på Helsenorge:
URL som er konfigurert på Helsenorge knyttet til referert selvbetjeningsfunksjon. Peker til metode i endepunkt hos aktør som gir denne funksjonaliteten. JWT-token i HTTP-header.
Når innbygger utfører en selvbetjeningsfunksjon skal det våre følgende i Payload:
For EnkleFunksjoner skal det alltid være med følgende i Body fra Helsenorge:
{
"funksjonKortnavn":"<kortnavnet på funksjonen>""funksjonsType":1
"nyTilstand": true eller false
}For RadioFunksjoner skal alltid følgende med i Body
{
"funksjonKortnavn":"<kortnavnet på funksjonen>""funksjonsType":2
"valgtOpsjon":"<Opsjonkortnavn>"
}
Respons: Kun HTTP-respons kode
Asynkron integrasjon
Alle dialog-meldinger sendes og mottas fra løsningsområde Helseregistre
Det benyttes AMQP som transportprotokoll (se: Meldingsutveksling med Helsenorge
NHN service BUS benyttes som AMQP service provider.
Det benyttes alltid KITH hodemelding: MsgHead-v1_2.xsd
Inkluderte skjema:
Dialogmelding (benyttes alltid): dialogmelding-v1.1.xsd
Diverse andre KITH felles elementer:
kith.xsd
felleskomponent1.xsd
Container for ikke XML-innhold (benyttes hvis respons er f.eks. PDF-dokument): kith-base64.xsd
Be om innsyn i registrerte opplysninger (i Helseregistre)
Meldingens funksjon i Hodemelding (Volven kodeverk 8279): DIALOG_INNBYGGER_HREG_INNSYN_HELSEOPPLYSNINGER
Se detaljer om bruk av Hodemelding og Dialogmelding i Implementasjonsguide i kapittel 3.17
Respons fra Helseregister (som et "Document" i hodemelding):
I produksjon:
PDF-vedlegg (kith-base64.xsd)
Støtte for XML innsynsrapport (bare for responser via Innsynsorkestrator?): Innsyn-v6.0.xsd
Ønsket støtte for alle nye registre:
PDF-vedlegg (kith-base64.xsd)
Støtte for XML innsynsrapport også for innsyn som ikke går gjennom innsynsorkestrator: Innsyn-v6.0.xsd
Støtte for andre innsynsrapporter enn STANDARD (default) vil utvikles på Helsenorge etter egen prioritering
Vedlegg støttes på Helsenorge
Be om innsyn i Logg over bruk (i Helseregistre)
Meldingens funksjon i Hodemelding (Volven kodeverk 8279): DIALOG_INNBYGGER_HREG_INNSYN_BRUK
Se detaljer om bruk av Hodemelding og Dialogmelding i Implementasjonsguide (lagt inn over) i kapittel 3.19
Respons fra Helseregister (som et "Document" i hodemelding):
I produksjon:
PDF-vedlegg (kith-base64.xsd)
Ønsket støtte for alle nye registre:
PDF-vedlegg (kith-base64.xsd)
For alle registre (samme som ønsket payload for synkron respons): Logg-respons_v1.1.xsd
Be om innsyn i Logg over utlevering (i Helseregistre)
Meldingens funksjon i Hodemelding (Volven kodeverk 8279): DIALOG_INNBYGGER_HREG_INNSYN_UTLEVERING
Se detaljer om bruk av Hodemelding og Dialogmelding i Implementasjonsguide (lagt inn over) i kapittel 3.18
Respons fra Helseregister (som et "Document" i hodemelding):
I produksjon:
PDF-vedlegg (kith-base64.xsd)
Ønsket støtte for alle nye registre:
PDF-vedlegg (kith-base64.xsd)
For alle registre (samme som ønsket payload for synkron respons): Logg-respons_v1.1.xsd
Melde feil eller stille spørsmål om registrerte opplysninger
Meldingens funksjon i Hodemelding (Volven kodeverk 8279): DIALOG_INNBYGGER_HREG_MELDE_FEIL
Se detaljer om bruk av Hodemelding og Dialogmelding i Implementasjonsguide (lagt inn over) i kapittel 3.20
Innhold for både forespørsel og svar ligger i Dialogmeldingen
Be om at opplysninger slettes eller sperres for helsepersonell
Meldingens funksjon i Hodemelding (Volven kodeverk 8279): DIALOG_INNBYGGER_HREG_SLETTING_ELLER_SPERRING
Se detaljer om bruk av Hodemelding og Dialogmelding i Implementasjonsguide (lagt inn over) i kapittel 3.21
Innhold for både forespørsel og svar ligger i Dialogmeldingen
Forespørsel til Innsynsorkestrator om Oppføringer
Meldingens funksjon i Hodemelding (Volven kodeverk 8279): DIALOG_INNBYGGER_HREG_OPPFORINGER
Se detaljer om bruk av Hodemelding og Dialogmelding i Implementasjonsguide (lagt inn over) i kapittel 3.16
Innhold i svar:
Det som er i Produksjon: Registeroppforing_V1.0.xsd
Foreslått nytt skjema som inneholder kapabiliteter hvert register har: Registeroppforing_V2.0.xsd