Anvisningar för testning av gränssnittsförfrågningar

Testning av regelmotorns inställningar

Vid testning av gränssnittsförfrågningar används Testmaterialtjänsten:

• adress: https://testiaineisto.fiÖppnas i ett nytt fönster..
• Du får inloggningskoder av ibruktagningsteamet.

Bekanta dig med beskrivningarna av regelmotorerna: 

• Regelmotorn vid uträttande av ärenden för ett företags räkning (OrganizationalRoles)
• Regelmotor för uträttande av ärenden för en persons räkning (Delegate, Authorization)

Uträttande av ärenden för ett företags räkning

Testa gränssnittstjänstens integration och säkerställ att de roller och fullmakter som krävs för att uträtta ärenden för företagets räkning i er ärendetjänst returneras till ärendetjänsten i fullmaktsförfrågan.

Vi rekommenderar att åtminstone verkställande direktören och den som har firmateckningsrätt tillåts uträtta ärenden, eftersom de i vilket fall som helst kan ge sig själva fullmakt att uträtta ärenden. Dessa roller bör alltså tillåtas att uträtta ärenden för företagets räkning enligt basregistret, så att de inte behöver ge fullmakt till sig själva i onödan. Reglerna 015.002.1.1 och 016.002.1.2 möjliggör detta, då ska TJ- och NIMKO-rollerna beaktas i svaret på fullmaktsbegäran.

Regler för regelmotor: 015.002.1.1 Personen ska ha en fastställd uppgift vid ett organ

Val av regel och uppgift som regeln returnerar: ELI, IS, J, PJ, S, TIL, TJ, YHM

Testas genom att i Testmaterialtjänsten välja en person som har rollen i fråga i företaget. Kontrollera om rollen returneras i svaret på fullmaktsbegäran.

Exempel på svarsmeddelande med Web API-anslutning i TJ-rollen:

[{"name":"Rova Oy","identifier":"7019376-8","complete":true,"roles":["TJ"]}]

Exempel på svarsmeddelande med Informationsledens anslutning i TJ-rollen:

<organization>
    <organizationIdentifier>7019376-8</organizationIdentifier>
    <name>Rova Oy</name>
    <roles>
        <role>TJ</role>
    </roles>
</organization>

Övriga roller förmedlas till svaret på fullmaktsbegäran på samma sätt, dvs. rollens förkortning förmedlas till svarsmeddelandet om rollen har valts i regelmotorns inställningar.

Regler för regelmotor: 016.002.1.2 Personen ska ha namnteckningsrätt på viss behörighetsnivå

• Val av regel: berättigad, prokurist
• Regeln returnerar följande uppgifter: NIMKO

Testa genom att i Testmaterialtjänsten välja en person som har namnteckningsrätt för företaget. Kontrollera att NIMKO-rollen returneras i svaret på fullmaktsbegäran.

OBS! Rollen bör alltid möjliggöra uträttande av ärenden för företagets räkning, eftersom en person med firmateckningsrätt i vilket fall som helst alltid kan befullmäktiga sig själv.

Exempel på svarsmeddelande med Web API-anslutning:

[{"name":"Rova Oy","identifier":"7019376-8","complete":true,"roles":["NIMKO"]}]

Exempel på svarsmeddelande med Informationsledens anslutning:

<organization>
  <organizationIdentifier>7019376-8</organizationIdentifier>
  <name>Rova Oy</name>
    <roles>
        <role>NIMKO</role>
    </roles>
</organization>

Regler för regelmotor: 019.003.1.2 Personen har fullmakt i fullmaktsregistret

• Val av regel: <fullmaktsärende>
• Regeln returnerar följande uppgifter: <fullmaktsärendets tekniska kod URI>

OBS! Endast fullmaktsärenden som valts med regelmotorn returneras i fullmaktsbegäran. Du kan begära tillstånd för fullmaktskoder för regelmotorn av ibruktagningsteamet.

Exempel på svarsmeddelande med Web API-anslutning:

[{"name":"Rova Oy","identifier":"7019376-8","complete":true,"roles":
["http://valtuusrekisteri.suomi.fi/palkkatietojen_ilmoittaminen"]}]

Exempel på svarsmeddelande med Informationsledens anslutning:

<organization>
  <organizationIdentifier>7019376-8</organizationIdentifier>
  <name>Rova Oy</name>
    <roles>
        <role>http://valtuusrekisteri.suomi.fi/palkkatietojen_ilmoittaminen</role>
    </roles>
</organization>

Uträtta ärenden för en person

Vi uträttande av ärenden för en persons räkning returneras alltid ett ja/nej-svar eller den fullmaktsärendets tekniska kod (URI) som valts under regel 019.003.1.1. I övrigt är reglerna regler som hindrar uträttande av ärenden.

• Authorization-förfrågan returnerar ALLOWED/DISALLOWED.
• Med AuthorizationList-förfrågan returneras ALL-rollen om man har rätt att uträtta ärenden för en minderårig person under vårdnad, eller fullmaktskodens tekniska kod om man har fullmakt att uträtta ärenden för en vuxen.