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.
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 https://vkp-testportal.azurewebsites.net/
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: