Om å utvikle mot VKPs API uten samarbeid

Det er mulig å starte å utvikle mot VKPs API uten å ha et etablert samarbeid med en kunde og VKP-teamet. Man vil da kunne gjøre enkle tester mot VKPs testportal. Se mer informasjon om dette nedenfor.

For å etablere en reell integrasjon mot et EPJ-system i test- og produksjonsmiljø må det gjøres mange forberedelser der man må involvere kunde (som har sitt EPJ-system) og VKP-teamet som etablerer konfigurasjoner og kommunikasjon mot EPJ-systemets API hos kunden.

VKPs API er sikret med HelseID. https://helseid.atlassian.net/wiki/spaces/HELSEID/overview Før man får bruke en løsning mot HelseID i produksjon må løsningen registreres i HelseID Selvbetjening. Før man får sin løsning oppført i selvbetjeningsportalen i produksjon, vil NHN ha en kodegjennomgang med leverandøren for å sikre at implementasjonen benytter HelseID's API på riktig måte. (For å kunne ta i bruk HelseID må en leverandør være godkjent leverandør hos NHN.)

Kunden er selv ansvarlig for å installere EPJ-systemets API og åpne for at VKP får tilgang til å kalle API'et.

VKP-teamet må etablere konfigurasjoner og infrastruktur for hver enkelt integrasjon med en kundes EPJ-system.

Her er litt informasjon om å teste mot VKPs testportal selv:

Man trenger:

Konto på utviklerportal. https://portal.test.vkpnorge.no/ (test)
HelseID-konfigurasjon. https://selvbetjening.test.nhn.no/ (test)

Valgfritt

Opprette konto på testportalen som brukes til å bekrefte journalføring utstedt til eksempel-konfigurasjonen nevnt nedenfor

Eksempel på konfigurasjoner for test

En testkommune er opprettet og konfigurert i testmiljøet. Identifikasjonen for denne kommunen er 888134576, og brukes ved oppkalling av API, f.eks. “https://api.test.vkpnorge.no/epj/r4/888134576/patient/_search”

For å teste innsending av journalnotat til testportalen vil test-pasienten Line Danser med personnummer 13116900216 kunne brukes.

(Vi tar forbehold om at det kan forekomme endringer i testdata over tid.)

Dette må på plass for å kalle API mot testportalen

En abonnements-API-nøkkel kreves i overskriften (kalt Ocp-Apim-Subscription-Key).
Et gyldig autorisasjonstoken i overskriften utstedt av HelseID testmiljø.

Nyttige linker til testverktøy og dokumentasjon:

(testportal)
(utviklerportal - test)
(test)