Organisaatiotietojen välittäminen tallennuksessa ja korvauksessa
Seuraavassa kuvataan muutaman esimerkin avulla, miten organisaatiotiedot välitetään tallennus- ja korvauspyynnöissä.
Esimerkit eivät vastaa todellisia tilanteita.
Käytettävät liittymistavat on kuvattu Tekniset liittymismallit Kanta-palveluihin.
Esimerkkeinä seuraavat tilanteet:
- Tallennus pyynnön tehneen organisaation omaan rekisteriin, liittyjänä pyynnön tehnyt julkinen organisaatio
- Tallennus pyynnön tehneen organisaation omaan rekisteriin, liittyjänä pyynnön tehnyt yksityinen organisaatio (suoraliittymismalli)
- Tallennus pyynnön tehneen organisaation omaan rekisteriin, liittyjänä isäntäorganisaatio (yksityisten yhteisliittymismalli)
- Ostopalvelutilanne
- Tallennus ostopalvelun järjestäjän rekisteriin, pyynnön tehneenä organisaationa yksityinen ostopalvelun tuottaja, liittyjänä pyynnön tehnyt organisaatio (suoraliittymismalli)
1. Tallennus pyynnön tehneen organisaation omaan rekisteriin, liittyjänä pyynnön tehnyt julkinen organisaatio
Esimerkissä:
JWT
- Liittyjäorganisaatio: Hämeen hyvinvointialue
- Pyynnön tehnyt organisaatio: Hämeen hyvinvointialue
Metatiedot
- Resurssin tallentaneen ammattihenkilön palveluyksikkö: Asiakaspalvelu, Kirkonkylän sosiaali- ja terveystoimi
- Rekisterinpitäjä: Hämeen hyvinvointialueen rekisterinpitäjä
- Resurssin tuottanut palveluntuottaja: Hämeen hyvinvointialue
- Palvelunjärjestäjä: Hämeen hyvinvointialue (Palvelunjärjestäjä sama kuin palveluntuottaja aina, kun kyseessä ei ole ostopalvelutilanne)
Palvelun toteuttajan tiedot
- Ajanvarauksen vastuuyksikkö: Hämeen hyvinvointialue
- Palvelun toteuttava yksikkö: Diabeteshoitajan vastaanotto, Kirkonkylän sosiaali- ja terveystoimi (Hämeen hyvinvointialueeseen kuuluva palveluyksikkö)
| Pakollisuus | Esimerkki | ||
|---|---|---|---|
| Pääsynhallintaan ja lokitukseen liittyvät tiedot | JWT:n claimit | ||
| Liittyjäorganisaation tunnus (käytetään käyttöoikeuden tarkastuksessa, sama arvo kuin subscriber_id kentässä) | sub | P | 1.2.246.10.99999773.10.0 |
| Liittyjäorganisaation tunnus (käytetään käyttöoikeuden tarkastuksessa) | subscriber_id | P | 1.2.246.10.99999773.10.0 |
| Liittyjäorganisaation nimi | subscriber_name | P | Hämeen hyvinvointialue |
| Liittyjäorganisaation palveluyksikön tunnus | subscriber_unit_id | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Liittyjäorganisaation palveluyksikön tunnus | subscriber_unit_name | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Pyynnön tehneen organisaation tunniste | requester_id | P | 1.2.246.10.99999773.10.0 |
| Pyynnön tehneen organisaation tunniste | requester_name | P | Hämeen hyvinvointialue |
| Pyynnön tehneen organisaation palveluyksikön tunnus | requester_unit_id | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Pyynnön tehneen organisaation palveluyksikön nimi | requester_unit_name | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Metatiedot | Provenance | ||
| Resurssin tallentaneen ammattihenkilön palveluyksikkö | Provenance.agent.who.identifier, Provenance.agent.who.role (7 Resurssin tallentaneen ammattihenkilön palveluyksikkö) | Ehdon pakollisuus: Pakollinen, kun ammattilainen tehnyt ajanvarauksen | 1.2.246.10.99999773.10.20.1014 |
| Resurssin tallentaneen ammattihenkilön palveluyksikön nimi | Provenance.agent.who.display, Provenance.agent.who.role (7 Resurssin tallentaneen ammattihenkilön palveluyksikkö) | Ehdon pakollisuus: Pakollinen, kun ammattilainen tehnyt ajanvarauksen | Asiakaspalvelu, Kirkonkylän sosiaali- ja terveystoimi |
| Rekisterinpitäjä | Provenance.agent.who.identifier, Provenance.agent.who.role (1 Resurssin rekisterinpitäjä) | P | 1.2.246.10.99999773.19.0 |
| Rekisterinpitäjän nimi | Provenance.agent.who.display, Provenance.agent.who.role (1 Resurssin rekisterinpitäjä) | P | Hämeen hyvinvointialueen rekisterinpitäjä |
| Resurssin tuottanut palveluntuottaja (Huom! Oltava sama kuin JWT:llä ilmoitettu pyynnön tehneen organisaation tunniste) | Provenance.agent.who.identifier, Provenance.agent.who.role (13 Resurssin tuottanut palveluntuottaja) | P | 1.2.246.10.99999773.10.0 |
| Resurssin tuottaneen palveluntuottajan nimi | Provenance.agent.who.display, Provenance.agent.who.role (13 Resurssin tuottanut palveluntuottaja) | P | Hämeen hyvinvointialue |
| Isäntäorganisaatio yksityisten yhteisliittymistilanteessa | Provenance.agent.who.identifier, Provenance.agent.who.role (8 Isäntäorganisaatio yksityisten yhteisliittymistilanteessa) | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Palvelunjärjestäjä | Provenance.agent.who.identifier, Provenance.agent.who.role (10 Palvelunjärjestäjä) | P | 1.2.246.10.99999773.10.0 |
| Palvelunjärjestäjän nimi | Provenance.agent.who.display, Provenance.agent.who.role (10 Palvelunjärjestäjä) | P | Hämeen hyvinvointialue |
| Palvelun toteuttajan tiedot | Organization | ||
| Ajanvarauksen vastuuyksikön tunniste | Organization.partOf.identifier | P | 1.2.246.10.99999773.10.0 |
| Ajanvarauksen vastuuyksikön nimi | Organization.partOf.display | P | Hämeen hyvinvointialue |
| Palvelun toteuttavan yksikön tunniste | Organization.identifier | P | 1.2.246.10.99999773.10.20.1010 |
| Palvelun toteuttavan yksikön nimi | Organization.name | P | Diabeteshoitajan vastaanotto, Kirkonkylän sosiaali- ja terveystoimi |
2. Tallennus pyynnön tehneen organisaation omaan rekisteriin, liittyjänä pyynnön tehnyt yksityinen organisaatio (ei yhteisliittymistilanne)
Esimerkissä:
JWT
- Liittyjäorganisaatio: Testi yritys Oy
- Pyynnön tehnyt organisaatio: Testi yritys Oy
- connection_model=1
Metatiedot
- Resurssin tallentaneen ammattihenkilön palveluyksikkö: Testi yritys Oy, Palveluyksikkö
- Rekisterinpitäjä: Testi yritys Oy
- Resurssin tuottanut palveluntuottaja: Testi yritys Oy
- Palvelunjärjestäjä: Testi yritys Oy (Palvelunjärjestäjä sama kuin palveluntuottaja aina, kun kyseessä ei ole ostopalvelutilanne)
Palvelun toteuttajan tiedot
- Ajanvarauksen vastuuyksikkö: Testi yritys Oy
- Palvelun toteuttava yksikkö: Testi yritys Oy, Palveluyksikkö
| Pakollisuus | Esimerkki | ||
|---|---|---|---|
| Pääsynhallintaan ja lokitukseen liittyvät tiedot | JWT:n claimit | ||
| Liittyjäorganisaation tunnus (käytetään käyttöoikeuden tarkastuksessa, sama arvo kuin subscriber_id kentässä) | sub | P | 1.2.246.10.48484999.10.0 |
| Liittyjäorganisaation tunnus (käytetään käyttöoikeuden tarkastuksessa) | subscriber_id | P | 1.2.246.10.48484999.10.0 |
| Liittyjäorganisaation nimi | subscriber_name | P | Testi yritys Oy |
| Liittyjäorganisaation palveluyksikön tunnus | subscriber_unit_id | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Liittyjäorganisaation palveluyksikön tunnus | subscriber_unit_name | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Pyynnön tehneen organisaation tunniste | requester_id | P | 1.2.246.10.48484999.10.0 |
| Pyynnön tehneen organisaation tunniste | requester_name | P | Testi yritys Oy |
| Pyynnön tehneen organisaation palveluyksikön tunnus | requester_unit_id | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Pyynnön tehneen organisaation palveluyksikön nimi | requester_unit_name | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Metatiedot | Provenance | ||
| Resurssin tallentaneen ammattihenkilön palveluyksikkö | Provenance.agent.who.identifier, Provenance.agent.who.role (7 Resurssin tallentaneen ammattihenkilön palveluyksikkö) | Ehdon pakollisuus: Pakollinen, kun ammattilainen tehnyt ajanvarauksen | 1.2.246.10.48484999.10.1 |
| Resurssin tallentaneen ammattihenkilön palveluyksikön nimi | Provenance.agent.who.display, Provenance.agent.who.role (7 Resurssin tallentaneen ammattihenkilön palveluyksikkö) | Ehdon pakollisuus: Pakollinen, kun ammattilainen tehnyt ajanvarauksen | Testi yritys Oy, Palveluyksikkö |
| Rekisterinpitäjä | Provenance.agent.who.identifier, Provenance.agent.who.role (1 Resurssin rekisterinpitäjä) | P | 1.2.246.10.48484999.10.0 |
| Rekisterinpitäjän nimi | Provenance.agent.who.display, Provenance.agent.who.role (1 Resurssin rekisterinpitäjä) | P | Testi yritys Oy |
| Resurssin tuottanut palveluntuottaja (Huom! Oltava sama kuin JWT:llä ilmoitettu pyynnön tehneen organisaation tunniste) | Provenance.agent.who.identifier, Provenance.agent.who.role (13 Resurssin tuottanut palveluntuottaja) | P | 1.2.246.10.48484999.10.0 |
| Resurssin tuottaneen palveluntuottajan nimi | Provenance.agent.who.display, Provenance.agent.who.role (13 Resurssin tuottanut palveluntuottaja) | P | Testi yritys Oy |
| Isäntäorganisaatio yksityisten yhteisliittymistilanteessa | Provenance.agent.who.identifier, Provenance.agent.who.role (8 Isäntäorganisaatio yksityisten yhteisliittymistilanteessa) | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Palvelunjärjestäjä | Provenance.agent.who.identifier, Provenance.agent.who.role (10 Palvelunjärjestäjä) | P | 1.2.246.10.48484999.10.0 |
| Palvelunjärjestäjän nimi | Provenance.agent.who.display, Provenance.agent.who.role (10 Palvelunjärjestäjä) | P | Testi yritys Oy |
| Palvelun toteuttajan tiedot | Organization | ||
| Ajanvarauksen vastuuyksikön tunniste | Organization.partOf.identifier | P | 1.2.246.10.48484999.10.0 |
| Ajanvarauksen vastuuyksikön nimi | Organization.partOf.display | P | Testi yritys Oy |
| Palvelun toteuttavan yksikön tunniste | Organization.identifier | P | 1.2.246.10.48484999.10.1 |
| Palvelun toteuttavan yksikön nimi | Organization.name | P | Testi yritys Oy, Palveluyksikkö |
3. Tallennus pyynnön tehneen organisaation omaan rekisteriin, liittyjänä isäntäorganisaatio (yksityisten yhteisliittymistilanne)
Esimerkissä:
JWT
- Liittyjäorganisaatio: Testi isäntä Oy
- Liittyjäorganisaation palveluyksikkö: Testi isäntä Oy, Palveluyksikkö
- Pyynnön tehnyt organisaatio: Testi vuokralainen
- Pyynnön tehneen organisaation palveluyksikkö: Testi vuokralainen, Palveluyksikkö (arvoksi annetaan toimintayksikkötaso, jos toimintayksikön alla ei ole hierarkassa palveluyksiköitä)
- connection_model=2
Metatiedot
- Resurssin tallentaneen ammattihenkilön palveluyksikkö: Testi isäntä Oy, Palveluyksikkö
- Esimerkissä ajanvarauksia hoidetaan keskitetysti isäntäorganisaation toimesta
- Rekisterinpitäjä: Testi vuokralainen
- Resurssin tuottanut palveluntuottaja: Testi vuokralainen
- Isäntäorganisaatio yksityisten yhteisliittymistilanteessa: Testi isäntä Oy
- Palvelunjärjestäjä: Testi vuokralainen (Palvelunjärjestäjä sama kuin palveluntuottaja aina, kun kyseessä ei ole ostopalvelutilanne)
Palvelun toteuttajan tiedot
- Ajanvarauksen vastuuyksikkö: Testi vuokralainen
- Palvelun toteuttava yksikkö: Testi vuokralainen, Palveluyksikkö (arvoksi annetaan toimintayksikkötaso, jos toimintayksikön alla ei ole hierarkassa palveluyksiköitä)
| Pakollisuus | Esimerkki | ||
|---|---|---|---|
| Pääsynhallintaan ja lokitukseen liittyvät tiedot | JWT:n claimit | ||
| Liittyjäorganisaation tunnus (käytetään käyttöoikeuden tarkastuksessa, sama arvo kuin subscriber_id kentässä) | sub | P | 1.2.246.10.48484990.10.0 |
| Liittyjäorganisaation tunnus (käytetään käyttöoikeuden tarkastuksessa) | subscriber_id | P | 1.2.246.10.48484990.10.0 |
| Liittyjäorganisaation nimi | subscriber_name | P | Testi isäntä Oy |
| Liittyjäorganisaation palveluyksikön tunnus | subscriber_unit_id | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | 1.2.246.10.48484990.10.1 |
| Liittyjäorganisaation palveluyksikön tunnus | subscriber_unit_name | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | Testi isäntä Oy, Palveluyksikkö |
| Pyynnön tehneen organisaation tunniste | requester_id | P | 1.2.246.10.48484666.10.0 |
| Pyynnön tehneen organisaation tunniste | requester_name | P | Testi vuokralainen |
| Pyynnön tehneen organisaation palveluyksikön tunnus | requester_unit_id | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | 1.2.246.10.48484666.10.1 |
| Pyynnön tehneen organisaation palveluyksikön nimi | requester_unit_name | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | Testi vuokralainen, Palveluyksikkö |
| Metatiedot | Provenance | ||
| Resurssin tallentaneen ammattihenkilön palveluyksikkö | Provenance.agent.who.identifier, Provenance.agent.who.role (7 Resurssin tallentaneen ammattihenkilön palveluyksikkö) | Ehdon pakollisuus: Pakollinen, kun ammattilainen tehnyt ajanvarauksen | 1.2.246.10.48484990.10.1 |
| Resurssin tallentaneen ammattihenkilön palveluyksikön nimi | Provenance.agent.who.display, Provenance.agent.who.role (7 Resurssin tallentaneen ammattihenkilön palveluyksikkö) | Ehdon pakollisuus: Pakollinen, kun ammattilainen tehnyt ajanvarauksen | Testi isäntä Oy, Palveluyksikkö |
| Rekisterinpitäjä | Provenance.agent.who.identifier, Provenance.agent.who.role (1 Resurssin rekisterinpitäjä) | P | 1.2.246.10.48484666.10.0 |
| Rekisterinpitäjän nimi | Provenance.agent.who.display, Provenance.agent.who.role (1 Resurssin rekisterinpitäjä) | P | Testi vuokralainen |
| Resurssin tuottanut palveluntuottaja (Huom! Oltava sama kuin JWT:llä ilmoitettu pyynnön tehneen organisaation tunniste) | Provenance.agent.who.identifier, Provenance.agent.who.role (13 Resurssin tuottanut palveluntuottaja) | P | 1.2.246.10.48484666.10.0 |
| Resurssin tuottaneen palveluntuottajan nimi | Provenance.agent.who.display, Provenance.agent.who.role (13 Resurssin tuottanut palveluntuottaja) | P | Testi vuokralainen |
| Isäntäorganisaatio yksityisten yhteisliittymistilanteessa | Provenance.agent.who.identifier, Provenance.agent.who.role (8 Isäntäorganisaatio yksityisten yhteisliittymistilanteessa) | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | 1.2.246.10.48484990.10.0 |
| Palvelunjärjestäjä | Provenance.agent.who.identifier, Provenance.agent.who.role (10 Palvelunjärjestäjä) | P | 1.2.246.10.48484666.10.0 |
| Palvelunjärjestäjän nimi | Provenance.agent.who.display, Provenance.agent.who.role (10 Palvelunjärjestäjä) | P | Testi vuokralainen |
| Palvelun toteuttajan tiedot | Organization | ||
| Ajanvarauksen vastuuyksikön tunniste | Organization.partOf.identifier | P | 1.2.246.10.48484666.10.0 |
| Ajanvarauksen vastuuyksikön nimi | Organization.partOf.display | P | Testi vuokralainen |
| Palvelun toteuttavan yksikön tunniste | Organization.identifier | P | 1.2.246.10.48484666.10.1 |
| Palvelun toteuttavan yksikön nimi | Organization.name | P | Testi vuokralainen, Palveluyksikkö |
4. Ostopalvelutilanne Tallennus ostopalvelun järjestäjän rekisteriin, pyynnön tehneenä organisaationa ostopalvelun tuottaja, liittyjänä pyynnön tehnyt organisaatio eli ostopalvelun tuottaja (esimerkissä ei ole yksityisten yhteisliittymistilanne)
JWT
- Liittyjäorganisaatio: Testi yritys Oy
- Pyynnön tehnyt organisaatio: Testi yritys Oy
Metatiedot
- Resurssin tallentaneen ammattihenkilön palveluyksikkö: Testi yritys Oy, Palveluyksikkö
- Rekisterinpitäjä: Hämeen hyvinvointialueen rekisterinpitäjä
- Resurssin tuottanut palveluntuottaja: Testi yritys Oy
- Palvelunjärjestäjä: Hämeen hyvinvointialue
Palvelun toteuttajan tiedot
- Ajanvarauksen vastuuyksikkö: Testi yritys Oy
- Palvelun toteuttava yksikkö: Testi yritys Oy, Palveluyksikkö
| Pakollisuus | Esimerkki | ||
|---|---|---|---|
| Pääsynhallintaan ja lokitukseen liittyvät tiedot | JWT:n claimit | ||
| Liittyjäorganisaation tunnus (käytetään käyttöoikeuden tarkastuksessa, sama arvo kuin subscriber_id kentässä) | sub | P | 1.2.246.10.48484999.10.0 |
| Liittyjäorganisaation tunnus (käytetään käyttöoikeuden tarkastuksessa) | subscriber_id | P | 1.2.246.10.48484999.10.0 |
| Liittyjäorganisaation nimi | subscriber_name | P | Testi yritys Oy |
| Liittyjäorganisaation palveluyksikön tunnus | subscriber_unit_id | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Liittyjäorganisaation palveluyksikön tunnus | subscriber_unit_name | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Pyynnön tehneen organisaation tunniste | requester_id | P | 1.2.246.10.48484999.10.0 |
| Pyynnön tehneen organisaation tunniste | requester_name | P | Testi yritys Oy |
| Pyynnön tehneen organisaation palveluyksikön tunnus | requester_unit_id | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Pyynnön tehneen organisaation palveluyksikön nimi | requester_unit_name | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Metatiedot | Provenance | ||
| Resurssin tallentaneen ammattihenkilön palveluyksikkö | Provenance.agent.who.identifier, Provenance.agent.who.role (7 Resurssin tallentaneen ammattihenkilön palveluyksikkö) | Ehdon pakollisuus: Pakollinen, kun ammattilainen tehnyt ajanvarauksen | 1.2.246.10.48484999.10.1 |
| Resurssin tallentaneen ammattihenkilön palveluyksikön nimi | Provenance.agent.who.display, Provenance.agent.who.role (7 Resurssin tallentaneen ammattihenkilön palveluyksikkö) | Ehdon pakollisuus: Pakollinen, kun ammattilainen tehnyt ajanvarauksen | Testi yritys Oy, Palveluyksikkö |
| Rekisterinpitäjä | Provenance.agent.who.identifier, Provenance.agent.who.role (1 Resurssin rekisterinpitäjä) | P | 1.2.246.10.99999773.19.0 |
| Rekisterinpitäjän nimi | Provenance.agent.who.display, Provenance.agent.who.role (1 Resurssin rekisterinpitäjä) | P | Hämeen hyvinvointialueen rekisterinpitäjä |
| Resurssin tuottanut palveluntuottaja (Huom! Oltava sama kuin JWT:llä ilmoitettu pyynnön tehneen organisaation tunniste) | Provenance.agent.who.identifier, Provenance.agent.who.role (13 Resurssin tuottanut palveluntuottaja) | P | 1.2.246.10.48484999.10.0 |
| Resurssin tuottaneen palveluntuottajan nimi | Provenance.agent.who.display, Provenance.agent.who.role (13 Resurssin tuottanut palveluntuottaja) | P | Testi yritys Oy |
| Isäntäorganisaatio yksityisten yhteisliittymistilanteessa | Provenance.agent.who.identifier, Provenance.agent.who.role (8 Isäntäorganisaatio yksityisten yhteisliittymistilanteessa) | Ehdon pakollisuus: pakollinen yhteisliittymistilanteessa | |
| Palvelunjärjestäjä | Provenance.agent.who.identifier, Provenance.agent.who.role (10 Palvelunjärjestäjä) | P | 1.2.246.10.99999773.10.0 |
| Palvelunjärjestäjän nimi | Provenance.agent.who.display, Provenance.agent.who.role (10 Palvelunjärjestäjä) | P | Hämeen hyvinvointialue |
| Palvelun toteuttajan tiedot | Organization | ||
| Ajanvarauksen vastuuyksikön tunniste | Organization.partOf.identifier | P | 1.2.246.10.48484999.10.0 |
| Ajanvarauksen vastuuyksikön nimi | Organization.partOf.display | P | Testi yritys Oy |
| Palvelun toteuttavan yksikön tunniste | Organization.identifier | P | 1.2.246.10.48484999.10.1 |
| Palvelun toteuttavan yksikön nimi | Organization.name | P | Testi yritys Oy, Palveluyksikkö |