Ilmoittaminen ja koulutus

Suosittelemme tilamaan koulutuksen rajapinnan käyttöönottoa varten.

Ilmoitattehan palvelusetelikäyntejä tekevien työntekijöiden määrä osoitteeseen 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 tunnistetiedot.

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



Asetukset DomaCaressa:

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

Varmista, että täppä Käytä uutta  PSOP API toteutusta on aktiivinen.


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