Teknisk dokumentation
Kontroll av fullmakt
Rätten att uträtta ärenden åt någon annan påverkas av bland annat uppgifterna om vårdnad, företagets representanter samt de uppgifter som sparats i fullmaktsregistret. Vid granskningen av fullmakterna gör organisationens e-tjänst automatiskt en förfrågan av tjänsten Fullmakter. Tjänsten Fullmakter returnerar ett svar som säger om personen har rätt att uträtta ärenden åt någon annan. Uppgifterna hämtas från basuppgiftsregistren och/eller fullmaktsregistret. Tjänsten Fullmakter kontrollerar till exempel om personbeteckningen för den person som uträttar ärenden åt någon annan finns i befolkningsdatasystemet och om personen är vid liv.
I organisationens e-tjänst kan även andra granskningsregler fastställas och som hindrar uträttandet av ärendena ifall villkoren uppfylls. Dessa fastställs med hjälp av regelmotorn. Användningen av tjänsten spärras om en eller flera av de fastställda kontrollreglerna uppfylls. Information om begränsningens orsak överlåts inte till e-tjänsten, utan endast huruvida det är möjligt att uträtta ärendet åt någon annan eller inte.
Regelmotor
Med regelmotorn kan kundorganisationens e-tjänster ges servicespecifika kontrollregler för fullmakten. Utifrån dessa ges e-tjänsten antingen ett godkännande (ALLOWED) eller nekande (DISALLOWED) svar på personens rätt att uträtta ärenden. Svaret är i regel nekande. Ett godkännande svar erbjuds endast om alla regler i regelkoden har uppfyllts och resultatet för alla regler är ALLOWED.
I kontrollen av uträttande av ärenden åt en person är det även möjligt att utnyttja AuthorizationList-förfrågan. AuthorizationList-svaret innehåller information om ärenderollerna som ombudet kan uträtta för huvudmannens del. Rätten att uträtta ärenden uttrycks i fältet roles vars värde är antingen ALL (obegränsad rättighet att uträtta ärenden) eller en lista på ärenden (URI) som rättigheten gäller. Om listan är tom finns ingen rättighet att uträtta ärenden. I förfrågningar om att uträtta ärenden åt ett företag returneras det eller de företag som gäller den som uträttar ärendet samt uppgifter om rollen, till exempel verkställande direktör.
- Regelmotor, att uträttä ärenden åt en person (Delegate, Authorization)
- Regelmotor, att uträtta ärenden åt ett företag (OrganizationalRoles)
Gränssnitt
Fullmaktsgranskningsförfrågningarna i tjänsten Fullmakter görs antingen via Suomi-fi-informationsleden (anslutningsserverns gränssnitt) eller via internet (Web API -gränssnittet). Det lämpligaste anslutningssättet väljs för e-tjänsten. Kundorganisationen bygger upp ett gränssnitt i sitt datasystem för att skicka och ta emot svaret från förfrågan.