Ohjeistus koskee versiota 22.9.2025 alkaen.


Ennen muutoksia otattehan kuvakaappaukset aiemmista PSOP:n tuotelinkityksistä.

Uuden rajapinnan käyttöönoton jälkeen vanhat tuotelinkitykset nollaantuvat.


API-avaimen luonti rajapintaa varten parastapalvelua.fi:ssä

Rajapinnan käyttöä varten tulee luoda API-avain, jotta rajapintaa pystyy käyttämään.

API-avaimia tarvitsee luoda yksi per y-tunnus. 


Valitaan parastapalvelua.fi:n uudella puolella ylävalikosta Organisaation tiedot.

Tämän jälkeen valitaan alle tulevista vaihtoehdoista Integraatiot.

Näytölle ilmestyy tämän jälkeen kaksi valintaa, joista valitaan alempi API-avaimet:


Tämän jälkeen avautuu listaus, jossa näkyy kaikki jo olemassa olevat avaimet - ensimmäistä kertaa luodessa API-avainta on listaus tyhjä.


Listauksen yläosassa luodaan uudet API-avaimet:

Avaimen tunniste - anna avaimelle jokin tunnistettava nimi, josta tunnistatte avaimen, esimerkiksi: "Domacare".

Valitse vanhenemispäivä - valitaan haluttu avaimen vanhenemispäivä, suosittelemme valitsemaan vanhenemispäiväksi mahdollisimman kaukaisen ajan eli enimmäispituuden 12kk.


Avaimen nimeämisen ja päiväyksen syöttämisen jälkeen aktivoituu oikealla puolella oleva Luo uusi avain -painike.

Painikkeen painamisen jälkeen avaimen alapuolelle ilmestyy luotu avain.

Kopioikaa luotu avain klikkaamalla Kopioi -painiketta vasemmalta. 


HUOM. Kopioikaa avain talteen heti.

Avain on kopioitavissa niin pitkään kuin kyseisellä välilehdellä olette, jos siirrytte toiselle välilehdelle PSOP:n sivustolla avainta ei enää pysty uudelleen kopioimaan tai jos sivuston sulkee kokonaan. 


Toimipaikan tunniste


Siirrytään kohtaan Toimipaikat, jossa luodaan rajapintaa varten tunnistetieto.

Jokaisella käytössä olevalla toimipaikalla on oltava oma tunnisteensa. 

Tietoja pääsee muokkaamaan painamalla Muokkaa tietoja -painiketta:
Muokkaa tietoja painikkeen jälkeen pääset lisäämää tunnistetiedon - tunnistetietona voidaan käyttää esim. kaupunkia.

Jokaisella toimipaikalla tulee olla oma tunnistetieto - samaa tunnistetietoa ei voi käyttää useammassa toimipaikassa. 

Tieto lisätään kohtaan Toimipaikan tunniste toiminnanohjausjärjestelmässä.


Tarkistattehan, että PSOP:n sopimuksilla on hinnastot voimassa.(Sopimukset, valitse haluttu sopimus Tarkastele sopimusta)

Siirtoja ei pysty tekemään uutta rajapintaa pitkin, jos hinnastot eivät ole voimassa.



Asetukset DomaCaressa:

Uutta rajapintaa varten on luotava alueet uudestaan.

Nimeättehän uudet alueet tunnistettavasti, jotta vanhoja alueita ei tule vahingossa käytettyä. 


Asetukset -> Palvelusetelijärjestelmien asetukset -> Psop-asetukset:

Aktivoi valinta Käytä uutta PSOP API-toteutusta.

Näytölle ilmestyy pop-up ikkuna, jossa pyydetään käynnistämään DomaCare uudelleen, jotta määritykset astuvat voimaan:


Uudelleenkäynnistämisen jälkeen palaa takaisin Palvelusetelijärjestelmien asetukset -välilehdelle.

Klikkaa Lisää alue, jonka jälkeen uusi rivi aktivoituu. 

Alue: aseta alueelle nimi - alueen nimi voi olla samanlainen kuin vanha, mutta erottele nimi esim. lisäämällä perään nimike UUSI, jotta tunnistat uuden alueen vanhasta.

API-avain: PSOP:n luoma avaimen tunniste, joka kopioitiin PSOP Integraatio -välilehdeltä.

Toimipaikan tunniste: Sama tunnus, joka määritettiin Toimipaikan tunniste toiminnanohjausjärjestelmässä -kohtaan parastapalvelua.fi:ssä. 

- kyseessä sama tunniste, kuin aiemmassa rajapinnassa ollut osatunnus




Ostovoimatunnisteiden massahaku


Uuden rajapinnan vuoksi kaikki ostovoimatunnisteet on haettava uudelleen asiakkailla.

Ostovoimatunnisteiden hakua varten on tehty massatyökalu, jonka avulla saadaan haettua vanhan rajapinnan kautta haetut ostovoimat uudelle rajapinnalle. 


Valitaan Palvelusetelijärjestelmien asetukset -välilehdellä Migraatio: 


Avautuu ikkuna, johon tulee vastata Kyllä:

HUOM. toiminto voidaan tehdä vain kerran per alue eikä tätä voi peruuttaa. 


Tämän jälkeen avautuu uusi ikkuna, jossa määritellään mitkä alueet linkitetään keskenään.

Ylempään valitaan vanha alue ja alempaan uusi alue.

Alueen linkityksessä tulee olla tarkkana, että on valittu oikeat alueet.


OK -painikkeen jälkeen tulee ikkuna, jossa kerrotaan siirron onnistuneen.

Tämän jälkeen suosittelemme käynnistäämän DomaCare uudelleen, jotta muutokset astuvat voimaan.


Massahaun avulla on mahdollista hakea aiemmin käytetyt ostovoimat automaattisesti, mutta tuotelinkitykset tulee tehdä uudelleen. 



Asiakkaan PSOP-alueen valinta ja tuotelinkitykset


Uuden rajapinnan kautta tulee hakea ostovoimat uudelleen asiakkaille maksajien tietojen kautta, jos massahakua ei ole käytetty.

Asiakkaan PSOP-alue -kohdassa valita aiemmin luotu uusi PSOP-alue, jotta ostovoimat saa haettua ja uudet tuotelinkitykset tehtyä. Vanhaa aluetta ei enää tule valita asiakkaille.


Tuotelinkitykset tehdään samalla tavalla kuin aiemminkin eli viimeisellä välilehdellä tehdään linkitykset