Profiilit ja laajennokset
Ajanvarauksen tietosisältömäärittely löytyy Termeta-palvelusta.
Tietokenttien attribuutti ’Näyttömuodossa’ ilmaisee, välitetäänkö tieto ainoastaan rakenteisessa muodossa vai myös näyttömuodossa.
Ajanvarausten arkistoinnissa ja palautuksessa käytettävät FHIR-resurssit, niistä muodostetut profiilit ja profiloinnissa käytetyt laajennokset on kuvattu alla. Tietojen pakollisuudet ja käytettävät kansalliset koodistot pohjautuvat ajanvarauksen tietosisältömäärittelyyn.
Ajanvarauksen tunniste-, asiointi- ja lisätiedot
Tietojen välittämiseen käytetään käytetään profiilia AppointmentAppointment.
| Välitettävä tieto | FHIR-resurssi ja elementti | Profiloinnissa käytetty laajennos |
|---|---|---|
| Ajanvarauksen tunnistetiedot | ||
| Ajanvarauksen tunniste | Appointment.identifier | |
| Aliajanvarauksen tunniste | Appointment.extension | ChildAppointment |
| Ajanvaraukseen liittyvän suunnitelman tunniste | Appointment.extension | CareplanIdentifier |
| Ajanvarauksen tila | Appointment.status | |
| Ajanvaraukseen liittyvän lähetteen tai pyynnön tunniste | Appointment.basedOn.identifier | |
| Alkamisaika | Appointment.start | |
| Päättymisaika | Appointment.end | |
| Asiakkaan palvelupolun tunniste | Appointment.extension | CustomerJourney.CustomerJourneyId |
| Asiakkaan palvelupolun nimi | Appointment.extension | CustomerJourney.CustomerJourneyName |
| Ajanvarauksen syy | ||
| Asiakkaan antamat tiedot | Appointment.extension | AppointmentReason.ReasonText |
| Kontaktin syy | Appointment.extension | AppointmentReason.ReasonCode |
| Palvelutarve | Appointment.extension | AppointmentReason.ServiceNeed |
| Ajanvarauksen asiointitiedot | ||
| Asiointipalvelun linkki | Appointment.extension | SelfServiceInfo.URL |
| Alaikäisen puolesta asiointi | Appointment.extension | SelfServiceInfo.SupportsMinor |
| Asiointi valtakirjalla täysi-ikäisen puolesta | Appointment.extension | SelfServiceInfo.SupportsProxy |
| Rekisteripohjainen asiointi täysi-ikäisen puolesta | Appointment.extension | SelfServiceInfo.SupportsRegister |
| Peruttavissa | Appointment.extension | AppointmentMutability.Cancellable |
| Siirrettävissä | Appointment.extension | AppointmentMutability.Reschedulable |
| Perumisen tai siirron takaraja | Appointment.extension | AppointmentMutability.NotAfter |
| Perumisen tai siirron syy | Appointment.cancelationReason | |
| Muistutuksen tapa | Appointment.extension | NotificationMedium |
| Huoltajan oikeus käsitellä ajanvaraustietoja | Appointment.meta.security | |
| Ajankohta, jolloin ajanvaraus ohjeistettu tehtäväksi | Appointment.requestedPeriod | |
| Tiketti | Appointment.extension | TicketNo |
| Linkki etäpalveluun liittymiseksi | Appointment.extension | RemoteServiceURL |
| Ajanvarauksen lisätiedot | ||
| Jonotusnumero | Appointment.extension | QueueNo |
| Potilasohje | Appointment.patientInstruction | |
| Linkki potilasohjeeseen | Appointment.patientInstruction.extension | PatientInstructionURL |
| Lisätiedot | Appointment.comment | |
| Lisätietojen osoite | Appointment.extension | AdditionalInfomationURL |
| Jatkohoidon tai palveluprosessin lisätiedot | Appointment.extension | ServiceAdditionalInformation |
| Palvelun toteuttajan sukupuoli | Appointment.extension | PractitionerGender |
Ajanvarauksen asiakkaan ja yhteyshenkilön tiedot
Tietojen välittämiseen käytetään profiilia AppointmentPatient.
| Välitettävä tieto | FHIR-resurssi ja elementti | Profiloinnissa käytetty laajennos |
|---|---|---|
| Asiakkaan tunniste | Patient.identifier | |
| Asiakkaan nimi | Patient.name | |
| Asiakkaan syntymäaika | Patient.birthDate | |
| Äidinkieli | Patient.communication | |
| Viranomaisasioinnin kieli | Patient.extension | OfficialCommunicationLanguage |
| Yhteyshenkilön nimi | Patient.contact.name | |
| Yhteyshenkilön tyyppi | Patient.contact.relationship |
Palvelun toteuttajan tiedot
Tietojen välittämiseen käytetään profiilia AppointmentOrganization.
| Välitettävä tieto | FHIR-resurssi ja elementti | Profiloinnissa käytetty laajennos |
|---|---|---|
| Ajanvarauksen vastuuyksikön tunniste | Organization.partOf.identifier | |
| Ajanvarauksen vastuuyksikön nimi | Organization.partOf.display | |
| Palvelun toteuttavan yksikön tunniste | Organization.identifier | |
| Palvelun toteuttavan yksikön nimi | Organization.name | |
| Palvelun toteuttavan yksikön yhteystiedot (puhelinnumero, sähköpostiosoite, www-osoite) | Organization.telecom |
Palvelupiste
Tietojen välittämiseen käytetään profiilia AppointmentLocation.
| Välitettävä tieto | FHIR-resurssi ja elementti | Profiloinnissa käytetty laajennos |
|---|---|---|
| Palvelupisteen sijainti (lähiosoite, postinumero, postitoimipaikka) | Location.address | |
| Palvelupisteen sijainnin lisätiedot | Location.description |
Ajanvarauksen kohde
Tietojen välittämiseen käytetään profiilia AppointmentHealthcareService.
| Välitettävä tieto | FHIR-resurssi ja elementti | Profiloinnissa käytetty laajennos |
|---|---|---|
| Palvelun otsikko | HealthcareService.name | |
| Palvelun luokka | HealthcareService.category | |
| Erikoisala | HealthcareService.specialty | |
| Asiointitapa | HealthcareService.extension | AppointmentType |
| Varaustuotteen tunniste | HealthcareService.extension | RequestedService.RequestedServiceIdentifier |
| Varaustuotteen nimi | HealthcareService.extension | RequestedService.RequestedServiceName |
| Varauksen sisältötarkenne | HealthcareService.type | |
| Varattava resurssi - Kalenteritunniste | HealthcareService.extension | ResourceCalendar.ResourceCalendarIdentifier |
| Varattava resurssi - Nimi | HealthcareService.extension | ResourceCalendar.ResourceName |
| Varattava resurssi - Ammatti | HealthcareService.extension | ResourceCalendar.ResourceProfession |
| Palvelukieli | HealthcareService.communication |
Ajanvarauksen metatiedot
Ajanvarauksen metatietojen välittämisessä käytetään profiilia AppointmentProvenance.
| Metatieto | Pakollisuus | FHIR-resurssi ja elementti | Profiloinnissa käytetty laajennos | Tarkennuksia |
|---|---|---|---|---|
| Ajanvarauksen yksilöivä tunnus | P | Provenance.target.reference | Viittaus sen Appointment-resurssin yksilöivään tunnukseen, johon Provenance-resurssi liittyy. Yksilöivänä tunnuksena ilmoitetaan Appointment-resurssissa ilmoitettu yksilöintitunnus Appointment.id. | |
| Ajanvaraustoimenpiteen tekijän palveluyksikkö | Ehdon pakollisuus: Pakollinen, jos ammattihenkilön tallentama ajanvaraus. Voidaan lisäksi antaa, jos ohjelmiston tallentama ajanvaraus. | Provenance.agent.who.identifier, Provenance.agent.who.display | Sosiaali- ja terveydenhuollon organisaation yksilöivänä tunnuksena THL - SOTE-organisaatiorekisterin (1.2.246.537.6.202.2008) mukainen OID-koodi ja nimi. Itsenäisen ammatinharjoittajan organisaation yksilöivänä tunnuksena Valvira - Terveydenhuollon itsenäiset ammatinharjoittajat -rekisterin (1.2.246.537.6.203.2014) mukainen yksilöintitunnus ja nimi. | |
| Luontiaika | P | Provenance.recorded | Ajankohta, jolloin potilas- tai ajanvaraustietojärjestelmän tiedoista tehtiin arkistoitava ajanvaraus. | |
| Valmistumisen tila | P | Provenance.extension | Status | eArkisto - Asiakirjan valmistumisen tila, 1.2.246.537.5.40154.2008. Potilastietovarantoon tallennuksissa tila "Arkistointivalmis". Poikkeuksena mitätöinti, jolloin tilan tulee olla "Poistettu". |
| Rekisterinpitäjä | P | Provenance.agent.who.identifier, Provenance.agent.who.display | Rekisterinpidosta vastaavan rekisterinpitäjän OID-koodi ja nimi. Julkiset rekisterinpitäjät ilmoitetaan koodistolla eArkisto - Rekisterinpitäjärekisteristä - 1.2.246.537.6.40174.2008. Yksityiset rekisterinpitäjät ilmoitetaan koodistolla Sosiaali- ja terveydenhuollon organisaation yksilöivänä tunnuksena THL - SOTE-organisaatiorekisterin (1.2.246.537.6.202.2008), rekisterinpitäjä terveydenhuollon toimintayksikkö. Itsenäiset ammatinharjoittajat ilmoitetaan koodistolla Valvira - Terveydenhuollon itsenäiset ammatinharjoittajat -rekisterin (1.2.246.537.6.203.2014). | |
| Rekisteri | P | Provenance.extension | RegisterType | Sen rekisterin tunnus, johon asiakas- tai potilastiedot kuuluvat. Tieto ilmoitetaan koodistolla KanTa-palvelut - Potilasasiakirjan rekisteritunnus (1.2.246.537.5.40150.2009). |
| Rekisterin tarkenne | Ehdon pakollisuus: Pakollinen, kun kyseessä työterveyshuollon rekisteriin tallennus. | Provenance.extension | RegisterSpecifier | Tarkennetta käytetään työterveyshuollon rekisterissä ilmaisemaan, minkä työnantajan työterveyshuollosta on kyse. Rekisteritarkenteena käytetään y-tunnuksesta muodotettua työnantajan OID-tunnusta. Tilanteissa, joissa y-tunnusta ei ole olemassa, voidaan käyttää virallista henkilötunnusta tai työterveyspalvelunantajakohtaista työnantajan numeroa. |
| Nimeke | P | Provenance.target.display | Nimekkeenä ilmoitetaan vakioarvo "Ajanvaraus" | |
| Kieli | P | Provenance.language | Kieli, jolla ajanvaraus on laadittu. | |
| Viivästämisen päättymispvm | Provenance.extension | ReleaseDateForPatientViewing | Päivämäärä, jolloin asiakirjan viivästäminen päättyy eli ensimmäinen päivä, jolloin viivästetty asiakirja voidaan näyttää kansalaiselle. LT1 | |
| Palvelutapahtuman tunnus | P | Provenance.extension | ServiceEvent | Palvelutapahtuman OID-tunnus. |
| Palveluntuottaja | P | Provenance.agent.who.identifier, Provenance.agent.who.display | Resurssin tuottaneen palveluntuottajan OID-koodi ja nimi. Sosiaali- ja terveydenhuollon organisaation yksilöivänä tunnuksena THL - SOTE-organisaatiorekisterin (1.2.246.537.6.202.2008) mukainen yksilöintitunnus. Itsenäisen ammatinharjoittajan organisaation yksilöivänä tunnuksena Valvira - Terveydenhuollon itsenäiset ammatinharjoittajat -rekisterin (1.2.246.537.6.203.2014) mukainen yksilöintitunnus. | |
| Isäntäorganisaatio yksityisten yhteisliittymistilanteissa | Ehdon pakollisuus: Pakollinen yhteisliittymistilanteessa | Provenance.agent.who.identifier | Isäntäorganisaation OID-koodi. Sosiaali- ja terveydenhuollon organisaation yksilöivänä tunnuksena THL - SOTE-organisaatiorekisterin (1.2.246.537.6.202.2008) mukainen yksilöintitunnus. Itsenäisen ammatinharjoittajan organisaation yksilöivänä tunnuksena Valvira - Terveydenhuollon itsenäiset ammatinharjoittajat -rekisterin (1.2.246.537.6.203.2014) mukainen yksilöintitunnus. | |
| Palvelunjärjestäjä | P | Provenance.agent.who.identifier, Provenance.agent.who.identifier | Palvelunjärjestäjän OID-koodi ja nimi. Sosiaali- ja terveydenhuollon organisaation yksilöivänä tunnuksena THL - SOTE-organisaatiorekisterin (1.2.246.537.6.202.2008) mukainen yksilöintitunnus. Itsenäisen ammatinharjoittajan organisaation yksilöivänä tunnuksena Valvira - Terveydenhuollon itsenäiset ammatinharjoittajat -rekisterin (1.2.246.537.6.203.2014) mukainen yksilöintitunnus. | |
| Erityissuojauksen piiriin kuuluva näkymä | Provenance.extension | TableOfContents | Jos ajanvaraus kohdistuu erityissuojattavaan palveluun, kuvailutietona on välitettävä erityissuojauksen piiriin kuuluva kansallinen näkymäkoodi. LT1 |
Ajanvarauksen metatiedot sisältävästä Provenance-resurssista viitataan seuraaviin resursseihin, jotka esitetään Provenance-resurssin sisällä olevassa contained-rakenteessa.
Ajanvarauksen asiakkaan tietojen välittämiseen käytetään profiilia AppointmentPatient (tietosisältö kuvattu aiemmin tällä sivulla).
Pakollisia tietoja:
- Asiakkaan tunniste
- Asiakkaan nimi
- Asiakkaan syntymäaika, kun asiakkaan tunnisteena käytetty tilapäistä yksilöintitunnusta.
Ajanvaraustoimenpiteen tekijä
Ajanvaraustoimenpiteen tekijänä voi olla ammattilainen, asiakas, asiakkaan puolesta asioiva tai ohjelmisto.
a) Ajanvaraustoimenpiteen tekijänä ammattilainen
Tietojen välittämiseen käytetään profiilia AppointmentPractitioner.
| Metatieto | Pakollisuus | FHIR-resurssi ja elementti | Tarkennuksia |
|---|---|---|---|
| Ammattihenkilön yksilöivä tunnus | P | Provenance.identifier | Ammattihenkilö yksilöidään virallisella henkilötunnuksella tai terhikki-numerolla. Jos henkilö ei ole terveydenhuollon ammattihenkilö, tunnisteena voidaan käyttää VRK:n yksilöivää tunnusta. |
| Ammattihenkilön nimi | P | Provenance.name |
b) Ajanvaraustoimenpiteen tekijänä asiakas
Tietojen välittämiseen käytetään profiilia AppointmentBookerPatient.
| Metatieto | Pakollisuus | FHIR-resurssi ja elementti | Tarkennuksia |
|---|---|---|---|
| Asiakkaan tunniste | P | Patient.identifier | Asiakkaan virallinen henkilötunnus |
| Asiakkaan nimi | P | Patient.name |
c) Ajanvaraustoimenpiteen tekijänä puolesta asioiva
Tietojen välittämiseen käytetään profiilia AppointmentBookerOnBehalfOf.
| Metatieto | Pakollisuus | FHIR-resurssi ja elementti | |
|---|---|---|---|
| Ajanvarauksen tekijän tunniste | P | RelatedPerson.identifer | Puolesta asioivan virallinen henkilötunnus |
| Ajanvarauksen tekijän nimi | P | RelatedPerson.name |
d) Ajanvaraustoimenpiteen tekijänä ohjelmisto
Tietojen välittämiseen käytetään profiilia KantaDevice.
| Metatieto | Pakollisuus | FHIR-resurssi ja elementti |
|---|---|---|
| Ohjelmiston tunniste | P | Device.identifier |
| Ohjelmiston nimi | P | Device.deviceName |
| Ohjelmiston versio | P | Device.version |
Ajanvarauksen tuottanut ohjelmisto
Tietojen välittämiseen käytetään profiilia KantaDevice.
| Metatieto | Pakollisuus | FHIR-resurssi ja elementti |
|---|---|---|
| Ohjelmiston tunniste | P | Device.identifier |
| Ohjelmiston nimi | P | Device.deviceName |
| Ohjelmiston versio | P | Device.version |
Potilastietovaranto lisää ajanvaraukselle seuraava metatiedot, jotka palautetaan haun vastaussanomalla:
| Metatieto | FHIR-resurssi ja elementti | Profiloinnissa käytetty laajennos | Tarkennuksia |
|---|---|---|---|
| Huoltajille luovuttamisen kielto (palvelutapahtumalle asetettu tieto) | Provenance.extension | RestrictionParent | Potilastietovaranto hakee tiedon palvelutapahtumalta ja palauttaa sen haun vastaussanomalla, jos palvelutapahtumalle on asetettu huoltajille luovuttamisen kielto. LT1 |
| Aktiivi rekisterinpitäjä | Provenance.agent.who.identifier, Provenance.agent.who.display | Potilastietovaranto palauttaa kaikissa tilanteissa Rekisterinpidosta vastaavan rekisterinpitäjän OID-koodin ja nimen. Rekisterinpitäjän muutostilanteissa Aktiivi rekinterpitäjä -tiedon arvo voi poiketa Rekisterinpitäjä-tiedosta, jonka arvona säilyy ajanvarauksen alkuperäinen rekisterinpitäjä. |
Lisätiedot
LT1 Potilastietovaranto lisää haussa palautettavan ajanvarauksen Appointment.meta.security-elementtiin Provenance-resurssilta ne tiedot, jotka liittyvät ajanvaraustietojen näyttämissääntöihin. Kuvattu AppointmentAppointment-profiilin Appointment.meta.security-elementin Definition-kentässä.