Kolme tapaa hyödyntää Suomi.fi-valtuuksien Authorization REST-rajapintaa
Puolesta-asiointioikeus voidaan selvittää asiointipalvelussa myös ilman loppukäyttäjän ohjaamista Suomi.fi-valtuuksien päämiehen valintakäyttöliittymälle.
Päämiehen valintakäyttöliittymällä asiamies voi valita, kenen puolesta hän haluaa asioida. Asiointipalvelu suorittaa valtuuskyselyn tunnistautuneen henkilön henkilötunnuksella ja päämiehen valintakäyttöliittymältä valitun päämiehen henkilötunnuksella. Asiointipalvelun tiedossa kuitenkin saattaa olla molempien osapuolten henkilötunnukset aiemmasta asioinnista, jolloin asiointioikeus voidaan varmistaa käyttäen Authorization REST -rajapintaa.
Tämä kysely poikkeaa normaalista Web API -rajapinnan kyselystä siten, että kyselyn voi tehdä järjestelmätasolla ilman loppukäyttäjän toimia. Tässä valtuuskyselyssä asiointipalvelu välittää kutsussa asiamiehen ja päämiehen henkilötunnukset, jolloin rajapintapalvelu vastaa ALLOWED tai DISALLOWED sen mukaan, onko asiamiehellä asiointioikeus vai ei. Sääntömoottorin asetuksilla palveluntarjoaja voi vaikuttaa puolesta asioinnin edellytyksiin.
Palvelun käyttöehdot edellyttävät, että puolesta asioiva henkilö jollain tavalla ilmaisee asioivansa toisen henkilön puolesta. Asiointioikeuskyselyä ei siis saa suorittaa käyttäjän tietämättä. Tämä ei koske asiointioikeuden selvittämistä herätteiden lähettämisen yhteydessä.
- Rajapintakuvauksessa kappale "Authorization REST-rajapinta": Web API rajapintakuvaus
- Valtuuskyselyn tekeminen tähän rajapintapalveluun edellyttää erikseen aktivoitavan Rest API key:n, jonka voi pyytää käyttöönottotiimiltä: valtuudet-kayttoonotot@dvv.fi
- Tämä kysely on käytettävissä ainoastaan henkilön puolesta asiointiin.
- Puolesta asioiva henkilö pitää tunnistaa vahvasti.
Käyntipisteasiointi
Puolesta-asiointioikeus voidaan tarkistaa myös käyntipisteessä kasvokkain tapahtuvassa asioinnissa. Tällöin asiakaspalvelija tunnistaa asiakkaan henkilötodistuksesta ja syöttää järjestelmään päämiehen ja asiamiehen henkilötunnukset ja käynnistää asiointioikeuskyselyn. Järjestelmä ilmoittaa asiakaspalvelijalle, onko asiamiehellä asiointioikeus päämiehen puolesta. Tämä edellyttää, että asiakaspalvelijalla on tätä tarkoitusta varten käytössään erillinen käyttöliittymä, johon voi syöttää henkilötunnukset ja käynnistää valtuuskyselyn. Tällä tavalla esimerkiksi apteekeissa selvitetään, onko henkilöllä oikeus noutaa toisen henkilön lääkemääräykset.
Mobiilisovellus
Käytettävyyttä voi parantaa mobiilisovelluksessa hyödyntämällä ensimmäisen päämiehen valinnan jälkeen Authorization REST -rajapintaa asiointioikeuden tarkistamiseen. Tällöin asiakasta (asiamies) ei tarvitse ohjata uudestaan päämiehen valintakäyttöliittymälle, jos hän on aiemmin asioinut jonkun puolesta.
Herätteet
Puolesta-asiointioikeus voidaan tarkistaa myös järjestelmätason kyselynä ilman loppukäyttäjän toimia, jos on tarpeen tarkistaa asiointioikeus ennen asiakkaalle järjestelmästä automaattisesti lähetettävää herätettä.