Johdanto

Sosiaali- ja terveydenhuollossa otetaan käyttöön toimialojen välinen luovutuslupa, johon toteutus tulee FHIR-rajapinnalla. Tämä soveltamisopas on sosiaali- ja terveydenhuollon välisen luovutusluvan käsittelyä koskevan määrittelyn kehitysversio, joka on tehty luovutusluvan määrittelyn 16.6.-8.8.2025 olevaa kommentointikierrosta varten. Soveltamisopas tulee tarkentumaan kommentointikierroksen jälkeen.

Määrittelyn kommentointikierrosta varten soveltamisoppaassa on kuvattu sosiaali- ja terveydenhuollon välistä luovutuslupaa koskevat Kanta-palvelujen yhteiset määrittelyt.

Soveltamisoppaassa sote-luovutusluvalla tarkoitetaan lupaa luovuttaa terveydenhuollon potilastietoja sosiaalihuoltoon ja lupaa luovuttaa sosiaalihuollon asiakastietoja terveydenhuoltoon. Soveltamisoppaassa kuvataan Sote-luovutusluvan käsittelyn FHIR-standardin mukainen tietojen siirto asiakas- ja potilastietojärjestelmien (jatkossa järjestelmä) ja Kanta-palvelujen välillä.

Soveltamisoppaan osiossa Käyttötapaukset kuvataan sosiaali- ja teveydenhuollon välisen luovutusluvan tallennuksen, korvauksen, mitätöinnin ja haun käyttötapaukset. REST-rajapinta osuudessa kuvataan rajapinnan teknistä toimintaa. FHIR-tietosisällössä kuvataan Sote-luovutuslupaa koskevat tiedot ja metatiedot sekä näissä käytetyt laajennokset. Profiilit ja koodistot -osiosta löytyy Sote-luovutusluvN toteutuksessa tarvittavat Profiilit, Valuesetit ja Codesystemit. Esimerkit-osiossa on esimerkkejä sosiaali- ja terveydenhuollon välisistä luovutusluvista.

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

Tahdonilmaisupalvelun FHIR-standardin mukaisissa toteutuksissa Kanta-palveluissa tuettu formaatti on JSON eikä muita formaatteja tueta.

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