Olemme julkaisseet uuden version (14.10.2025) DomaCaresta, joka sisältää uuden PSOP-rajapinnan. 

Vanha parastapalvelua.fi rajapinta suljetaan Tieran toimesta 16.10.2025.


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

Otattehan ennen muutoksia kuvakaappaukset aiemmista PSOP tuotelinkityksistä, jotta saatte palautettua tuotelinkitykset, kuten ne aiemmin olivat. 


Huomiothan, että PSOP-rajapinnan käyttö on maksullinen lisäpalvelu. Lisätietoa hinnasta saat myynnistämme tuki@domacare.fi.


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 tulee 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 API-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 tai suljettu sivuston kokonaisuudessaan ei avainta enää pysty uudelleen kopioimaan. 


Mikäli avain jää kopioimatta, tulee API-avain luoda uudelleen. 


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ä.


PSOP Hinnaston voimassaolo


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


Avautuu ikkuna, jossa näkyy tieto onko hinnasto voimassa:


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. 

Kaksoisklikkaamalla tekstikenttää aktivoituu tekstinkirjoitus.

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


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


Uuden rajapinnan takia kaikki ostovoimatunnisteet on haettava uudelleen asiakkaille.

Ostovoimatunnisteiden hakua varten on tehty massatyökalu, jonka avulla saadaan siirrettyä 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.



Asiakkaan PSOP-alueen valinta ja tuotelinkitykset


Henkilötunnus on pakollinen tieto - ilman henkilötunnusta ostovoimatunnisteiden haku ei onnistu.


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.


Mikäli ostovoimatunniste ei aktivoidu tarkistattehan, että asiakkaalle on tallennettu henkilötunnus tietoihin.



Ostovoimarivien kohdistus palveluihin tulee tehdä vain ensimmäiselle asiakkaalle, joka kyseisellä PSOP-alueella on. 

Jatkossa DomaCare muistaa, mitkä DomaCare-tuotteet on linkitetty PSOP-tuotteisiin.


Yhdistäminen on jaettu kolmeen eri sarakkeeseen.
Ensimmäisellä sarakkeella näet PSOP-alueen.

Toisella sarakkeella tähän liittyvät tuotteet.

Ja kolmannella sarakkeella saat asetettua DomaCaren tuotteet vastaaville PSOP-tuotteille.


Tuote DomaCaressa sarake on ensimmäisellä kerralla tyhjä ja vasta lisäyksen jälkeen tuotteet näkyvät alla olevan esimerkkikuvan mukaisesti.

Tuotteiden lisäys tapahtuu sitä, että klikataan haluamaasi riviä. Aukeaa uusi ikkuna, josta valitaan tuote/tuotteet, jotka halutaan liittää rivin PSOP-tuotteeseen.



Palvelusetelin Aktiivinen -valintaa ei voi tällä hetkellä muuttaa manuaalisesti.

Poista -painikkeen rastista painamalla pystytte poistamaan ylimääräiset palvelusetelit näkymästä: