Etusivu

Tämä implementointiopas sisältää FHIR-rajapinnat, joilla voidaan arkistoida potilaan ajanvarauksia Kanta-palvelujen Potilastietovarantoon ja hakea niitä Kanta-palvelujen Potilastietovarannosta.

Ajanvaraussovelluksen, jolla kansalainen voi hakea ajanvarauksia Kanta-palvelujen Potilastietovarannosta, on oltava hyvinvointisovellus. Kansalaisen tekemät haut Kanta-palvelujen Potilastietovarannosta toteutetaan käyttäen hyvinvointisovelluksille tarkoitettua rajapintaa. Tässä soveltamisoppaassa ei kuvata kansalaisen tekemiin hakuihin liittyviä käyttötapauksia eikä REST-rajapintoja.

Kaikki tässä implementointioppaassa määritellyt profiilit perustuvat HL7® FHIR:n ® R4-versioon. Tämän implementointioppaan lukijalla oletetaan olevan perustietämys FHIR-standardista.

Arkiston FHIR-standardin mukaisissa toteutuksissa tuettu formaatti on JSON, muita formaatteja ei tueta.

Profiiliesimerkeissä käytetyt henkilötunnukset ovat testihenkilötunnuksia.

Implementointiopas on RC-versio, joka voi päivittyä työn etenemisen ja kommenttien perusteella.

Implementointiopas liittyy pakettiin fi.kela.kanta.pta.ajanvaraus.r4 1.0.0-RC1, joka sisältää profiilien, laajennosten, ValueSet:ien ja CodeSystem:ien määrittelyt, jotka ovat käytössä asiakastestiympäristössä.

Seuraavia esimerkkejä on korjattu paketin julkaisemisen jälkeen:

  • Tallennus- ja mitätöintisanomien esimerkkeihin korjattu fullurl- ja url-tietojen välittäminen
  • Mitätöinnissä käytettävän Provenance-esimerkkiin korjattu viittaus ajanvaraukseen

Otettu käyttöön THL - Yhteystapa -koodiston uusi versio paketin julkaisemisen jälkeen:

  • Päivitetty ValueSet fipta-vs-AppointmentType, jossa otettu käyttöön THL - Yhteystapa -koodiston uusi versio (202501). Päivitetty koodiston uusi versio ajanvarausesimerkkiin Appointment_2.

Tiedossa olevat tulevat muutokset

Kanta-palveluiden yhteiseen Kanta JSON Web Token määrittelyn versioon 1.4.0 lisätään uusi claim, jolla ilmoitetaan yksityisen toimijan liittymismalli Kanta-palveluihin. Potilastietovaranto tulee hyödyntämään tietoa.

Yhteystiedot

FHIR-rajapinnan toteutukseen ja tähän oppaaseen liittyvät kysymykset voi laittaa sähköpostilla osoitteeseen kanta@kanta.fi.

Sisältö