Om å utvikle mot VKPs API uten samarbeid

Owned by Stein Thelle
Last updated: 03 11 2023
2 min read

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. HelseID | Dokumentasjon 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:

Valgfritt

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

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:

Kontakt: send en e-post til kundesenter@nhn.no