Kritisk informasjon
Her finner du all informasjon du trenger for å komme i gang med å bruke Kritisk Informasjon API. Lenger ned finner du blant annet en beskrivelse av tjenesten, en kom i gang-guide, utviklerdokumentasjon, release notes mm.
Kritisk Informasjon er en del av den nasjonale kjernejournalen, og krever autentisering med HelseID, medlemskap i Helsenettet og signering av bruksvilkår.
Kritisk informasjon API er en tjeneste som åpner for deling av pasientens kritiske informasjon på tvers av helseinstitusjoner. Med kritisk informasjon menes informasjon som man i en behandlingssituasjon ønsker at det varsles særskilt om til helsepersonell. Eksempler på kritisk informasjon er legemiddelreaksjoner, spesielle lidelser eller tidligere komplikasjoner ved anestesi.
Gjennom API-et kan aktørene i helse- og omsorgstjenesten endre, opprette og dele kritisk informasjon som en integrert del av deres eget fagsystem.
Informasjonsmodellen for kritisk informasjon er basert på:
Legemiddelreaksjon: Registreres med type reaksjon og reaksjonens alvorlighetsgrad, sannsynlig agens og i hvilken grad årsaken til reaksjonen(-e) er verifisert. Det kan benyttes ATC-kode, virkestoff, merkevarenavn eller hjelpestoff (i kombinasjon med merkevarenavn).
Annen allergi: Omfatter kritiske allergier mot insektgift, lateks og utvalgte allergener fra matvareallergi-registeret som f eks skalldyr, peanøtter og egg.
Smitte: Omfatter infeksjonssykdommer med konsekvens for valg av behandling til pasienten. Når pasienten er blitt smittefri skal opplysningene fjernes. Blodsmitte skal ikke registreres.
Kritisk medisinsk tilstand: Omfatter tilstand/sykdom som kan være vanskelig å identifisere i en akuttsituasjon, og som kan medføre alvorlige komplikasjoner eller feilbehandling dersom den overses ved utredning og behandling av pasienten.
HLR-minus/Behandlingsavklaringer: Helsedirektoratet utvikler en ny delingsløsning samt veileder for HLR-minus/Behandlingavklaringer hos pasienter med alvorlig eller livsbegrensende sykdom. Forventet ferdigstilt Q2 2026. Når den er ferdig utviklet blir dette en egen kategori kritisk informasjon.
Annen prosedyreendring: Ansvarlig helsepersonell og pasient kan i noen tilfeller gjøre beslutninger som vil ha betydning for hvilken helsehjelp pasienten kan få, og som kan kreve avvik fra vanlige prosedyrer og retningslinjer. Dette omfatter f eks pasientens reservasjon mot blodprodukter og avtale om endringer i spesifikke behandlingsrutiner. Foreløpig omfatter kategorien også begrensning av livsforlengende behandling men det vil komme en ny kategori (HLR-minus/Behandlingsavklaringer) når denne er ferdig utviklet.
Intubasjonsproblem: Registrering av gradering av anatomisk tilgjengelighet for intubasjon (Cormack & Lehane) samt om pasienten kan ventileres på maske.
Annet problem ved anestesi: Her kan det registreres f.eks anatomiske forhold i columna som kompliserer spinalanestesi, malign hypertermi eller unormal lang oppvåkningstid. Anafylaksi utløst av f.eks perifert virkende nevromuskulære blokkere, lateks, antibiotika eller klorheksidin skal ikke dokumenteres her, men under Legemiddelreaksjon eller Annen allergi.
Pågående behandling: Omfatter opplysninger om pågående viktige behandlingsløp som kan innebære en helserisiko hvis det ikke tas hensyn til i forbindelse med helsehjelp til pasienten. Eksempler kan være dialyse, psykiatrisk kriseplan eller cytostatica. Behandlingsløp som ikke fremkommer når man ser pasientens legemiddelliste er spesielt viktige å gjøre oppmerksom på her.
Implantat: Mekaniske implantater som kan ha betydning for diagnose og behandlingsvalg i en akuttsituasjon, f.eks pacemaker, intrakranielle vaskulære klips eller mekanisk hjerteventil.
Transplantat: Biologiske transplantater som pasienten har, f.eks transplantert nyre eller transplantert hjerte. Metall i øyet (fremmedlegeme) registreres også her.
Kom i gang
For å starte prosessen for å ta i bruk kritisk informasjon APIet (KI-API) skal leverandøren gjennom en samtale med Norsk helsenett for å for å avdekke behov, besvare spørsmål og for å hjelpe leverandøren med å komme raskt i gang. En demo av brukergrensesnittet i fagsystemet (i testmiljø) vil også være aktuelt å se på. Ved behov kan flere møter settes opp.
Send en e-post til kundesenter@nhn.no for å komme i gang med samtalen med en kort beskrivelse av dere selv, og gjerne med tittel “Ønske om integrasjon mot Kritisk informasjon API".
Les gjerne "Veiledning for bruk av kritisk informasjon API", samt "Utviklerdokumentasjon" i forkant av første møte.
Slik går du frem teknisk for å begynne å ta i bruk kritisk informasjon APIet:
Tjenestens API er beskyttet med HelseID. Tilgang fra ditt fagsystem mot tjenesten må først konfigureres i HelseID Selvbetjening sitt testmiljø. Deretter må du gjøre en integrasjon mot HelseID for OAuth token exchange.
Følg HelseID Selvbetjening sin dokumentasjon for å komme i gang. Du må først opprette et Klientsystem og deretter en Klientkonfigurasjon.
Ved oppretting av Klientsystem:
- Hva skal HelseID brukes til: API-kall
- Tjenester som skal konsumeres: nhn:critical-information
Etter klientkonfigurasjonen er opprettet vil det gå ut en epost til oss for manuell godkjenning. Etter vi har godkjent må du lage integrasjon mot HelseID med OAuth token exchange for å sette korrekt scope og audience mot tjenesten.
PS: Dersom du ønsker å hoppe over dette steget for å komme raskere i gang med å teste APIet, har HelseID en tokengenerator som fungerer mot testmiljøet. Her kan du generere access tokens du kan bruke videre til autorisering mot tjenesten i testmiljø.
Når man er integrert mot HelseID og kan skaffe seg access tokens er man klar til å utvikle og teste en integrasjon mot tjenestens API.
APIet tilbys i flere miljøer, der test-miljøet er tilgjengelig på både internett og helsenett, mens QA og prod-miljøene kun er tilgjengelig på helsenett. Se miljøoversikt for full oversikt over tilgjengelige miljøer.
Vi anbefaler også å lese utviklerdokumentasjonen for nærmere beskrivelse av funksjonalitet som er støttet i APIet og tilgengelige endepunkter.
Introduksjons -og demomøte
Før du kan gå i produksjon med tjenesten må du ha gjennomgått et introduksjonsmøte og et demo møte. Dette gjøres ved å sende en epost til kundesenter@nhn.no.
Integrasjon HelseID
For å bli godkjent som leverandør må integrasjonen fra fagsystemet godkjennes av HelseID og tilgang til produksjonsmiljøet må utstedes. Hensikten er å sikre at at løsninger som produksjonsettes ikke har store feil eller svakheter som går utover informasjonssikkerhet eller personvern. Se godkjenningsprosess HelseID.
Etter at integrasjon mot HelseID er godkjent må leverandøren opprette de nødvendige konfigurasjonene i HelseID Selvbetjening for produksjon. Etter dette er det klart for å ta APIet i bruk.
Tilgang til tjenesten på helsenettet
For å bruke Kritisk info-API i produksjon må man være medlem av helsenettet. Dersom din organisasjon ikke er medlem finnes det informasjon om hvordan man blir medlem her.
Øvrig info om tilgjengelige miljøer, inkl. produksjonsmiljøet finnes her.
Vær oppmerksom på at alle nye tjenester som tilgjengeliggjøres fra NHNs private sky er publisert på et annet IP-segment enn enkelte andre NHN-tjenester. Hvis din organisasjon allerede bruker tjenester via helsenettet må dere kanskje legge til nye brannmur-regler for NHN privat sky.