PTV Open API method examples, Interface Version 6 Contents 1. POST Organization... 2 1.1 Creating a new sub-organization: Municipality... 2 2. POST Service... 4 2.1 Creating a new Service: SelfProduced, one Responsible... 4 2.2 Creating a new Service: SelfProduced, two Responsibles, one Producer... 6 2.3 Creating a new Service: SelfProduced, two Responsibles, two Producers... 9 2.4 Creating a new Service: PurchaseServices, one Responsible, one Producer (ID)... 12 2.5 Creating a new Service: PurchaseServices, one Responsible, one Producer (name)... 15 2.6 Creating a new Service: Other, one Responsible, one Producer (ID)... 18 2.7 Creating a new Service: Other, one Responsible, one Producer (name)... 21 3. POST ServiceChannel/ServiceLocation... 24 3.1 Creating a new Service Location Service Channel: ServiceHours... 24 3.2 Creating a new Service Location Service Channel: languages fi and sv... 30 4. POST Service/ServiceAndChannel... 35 4.1 Creating a connection between Service and Service Channel... 35 1
PTV Open API method examples, Interface Version 6 1. POST Organization 1.1 Creating a new sub-organization: Municipality "sourceid": "ExampleSubOrganization", "municipality": "109", "organizationtype": "Municipality", "businesscode": "9165116-0", "organizationnames": [ "value": "Alaorganisaatio Esimerkki", "type": "Name", "value": "Esim AO", "type": "AlternateName" "displaynametype": [ "type": "Name", "organizationdescriptions": [ "value": "Esimerkki alaorganisaatiosta. Tähän kenttään kuvataan Alaorganisaatioon liittyviä tietoja.", "emailaddresses": [ "description": "Aulapalvelu", "value": "info@esimerkki.fi", "phonenumbers": [ "additionalinformation": "Vaihde", "servicechargetype": "Charged", "chargedescription": "Jonotusajalta peritään normaali puhelumaksu", "prefixnumber": "+358", "isfinnishservicenumber": false, "number": "501234567", 2
"webpages": [ "ordernumber": "1", "value": "Esimerkkikunnan verkkosivut", "url": "http://www.esimerkkikunta.fi", "addresses": [ "type": "Postal", "postofficebox": [ "value": "PL 101", "postalcode": "00101", "additionalinformations": [ "value": "Postit postilokeroon",, "type": "Visiting", "streetaddress": [ "value": "Mäkitie", "postalcode": "33880", "streetnumber": "4", "municipality": "418", "additionalinformations": [ "value": "ei vastaanottoja - ilmoita tulosta etukäteen", "publishingstatus": "Draft", "parentorganizationid": "b458d033-042d-4cbe-b030-34e81da28821" 3
2. POST Service 2.1 Creating a new Service: SelfProduced, one Responsible Service type (palvelutyyppi) = Service (palvelu) ProvisionType (toteutustapa) = SelfProduced (itse tuotetut palvelut) Service has one Responsible organization (vastuutaho) Service voucher (palveluseteli) is in use "type": "Service", "fundingtype": "PubliclyFunded", "servicenames": [ "value": "Testi100-palvelu-050717", "type": "Name", "value": "palvelu-050717", "type": "AlternateName" "areatype": "AreaType", "areas": [ "type": "Municipality", "areacodes": [ "109" "servicedescriptions": [ "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...\n\nyleiskaava kertoo, miten...", "type": "Description", "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...", "type": "ShortDescription", "value": "Maksullisuuden lisätieto -kentässä voit kuvata maksullisuuden tiedot tarkemmin.", "type": "ChargeTypeAdditionalInfo" 4
"servicechargetype": "Charged", "languages": [ "fi", "sv" "serviceclasses": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v1001", "http://urn.fi/urn:nbn:fi:au:ptvl:v1087" "ontologyterms": [ "http://www.yso.fi/onto/koko/p63205" "targetgroups": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v2001" "legislation": [ "names": [ "value": "Rikoslaki", "webpages": [ "url": "http://www.finlex.fi/fi/laki/ajantasa/1889/18890039001", "serviceorganizations": [ "organizationid": "b458d033-042d-4cbe-b030-34e81da28821", "roletype": "Responsible" "provisiontype": "SelfProduced", "roletype": "Producer", "organizationid": "b458d033-042d-4cbe-b030-34e81da28821" "servicevouchers": [ "ordernumber": 1, "value": "Verkkosivun nimi, josta käyttäjä saa tietoa palvelusetelin käytöstä", "url": "http://stm.fi/palveluseteli", "additionalinformation": "Palvelusetelillä voi hankkia sellaisia sosiaali- ja terveyspalveluja, jotka kunnan tai kuntayhtymän kuuluu järjestää asukkailleen." "publishingstatus": "Published" 5
2.2 Creating a new Service: SelfProduced, two Responsibles, one Producer Service type (palvelutyyppi) = PermissionAndObligation (lupa tai muu velvoite) ProvisionType (toteutustapa) = SelfProduced (itse tuotetut palvelut) Service has two Responsible organizations (vastuutaho) Service has one Producer organization (tuottaja) Service voucher (palveluseteli) is in use "type": "PermissionAndObligation", "fundingtype": "PubliclyFunded", "servicenames": [ "value": "Testi200-palvelu-050717", "type": "Name", "value": "palvelu-050717", "type": "AlternateName" "areatype": "AreaType", "areas": [ "type": "Municipality", "areacodes": [ "109" "servicedescriptions": [ "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...\n\nyleiskaava kertoo, miten...", "type": "Description", "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...", "type": "ShortDescription", "value": "Edellyttääkö palvelun käyttö tietynlaista toimintatapaa?\nkuvaa tieto tähän kenttään", "type": "ServiceUserInstruction", 6
"value": "Lupaa on haettava tiettyyn määräaikaan mennessä...", "type": "DeadLineAdditionalInfo", "value": "Kuvaa lyhyesti tieto siitä, miten kauan lupa tai velvoite on voimassa. Esim. Lupa on voimassa kolme (3) vuotta.\n Lupa on voimassa toistaiseksi.", "type": "ValidityTimeAdditionalInfo", "value": "Kuvaa lyhyesti, miten kauan asian käsittely viranomaistasolla kestää.", "type": "ProcessingTimeAdditionalInfo", "value": "Maksullisuuden lisätieto -kentässä voit kuvata maksullisuuden tiedot tarkemmin.", "type": "ChargeTypeAdditionalInfo" "servicechargetype": "Charged", "languages": [ "fi", "sv" "requirements": [ "value": "Kuvaa sanallisesti ehdot ja kriteerit...", "serviceclasses": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v1001", "http://urn.fi/urn:nbn:fi:au:ptvl:v1087" "ontologyterms": [ "http://www.yso.fi/onto/koko/p63205" "targetgroups": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v2001" "legislation": [ "names": [ "value": "Rikoslaki", "webpages": [ "url": "http://www.finlex.fi/fi/laki/ajantasa/1889/18890039001", 7
"serviceorganizations": [ "organizationid": "b458d033-042d-4cbe-b030-34e81da28821", "roletype": "Responsible", "organizationid": "b51f13d6-6dc1-4643-a648-c41702aa1680", "roletype": "Responsible", "provisiontype": "SelfProduced", "roletype": "Producer", "organizationid": "b51f13d6-6dc1-4643-a648-c41702aa1680" "servicevouchers": [ "ordernumber": 1, "value": "Verkkosivun nimi, josta käyttäjä saa tietoa palvelusetelin käytöstä", "url": "http://stm.fi/palveluseteli", "additionalinformation": "Palvelusetelillä voi hankkia sellaisia sosiaali- ja terveyspalveluja, jotka kunnan tai kuntayhtymän kuuluu järjestää asukkailleen." "publishingstatus": "Published" 8
2.3 Creating a new Service: SelfProduced, two Responsibles, two Producers Service type (palvelutyyppi) = ProfessionalQualifications (ammattipätevyys) ProvisionType (toteutustapa) = SelfProduced (itse tuotetut palvelut) Service has two Responsible organizations (vastuutaho) Service has two Producer organizations (tuottaja) Service voucher (palveluseteli) is in use "type": "ProfessionalQualifications", "fundingtype": "PubliclyFunded", "servicenames": [ "value": "Testi300-palvelu-050717", "type": "Name", "value": "palvelu-050717", "type": "AlternateName" "areatype": "AreaType", "areas": [ "type": "Municipality", "areacodes": [ "109" "servicedescriptions": [ "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...\n\nyleiskaava kertoo, miten...", "type": "Description", "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...", "type": "ShortDescription", "value": "Edellyttääkö palvelun käyttö tietynlaista toimintatapaa?\nkuvaa tieto tähän kenttään", "type": "ServiceUserInstruction", 9
"value": "Lupaa on haettava tiettyyn määräaikaan mennessä...", "type": "DeadLineAdditionalInfo", "value": "Kuvaa lyhyesti tieto siitä, miten kauan lupa tai velvoite on voimassa. Esim. Lupa on voimassa kolme (3) vuotta.\n Lupa on voimassa toistaiseksi.", "type": "ValidityTimeAdditionalInfo", "value": "Kuvaa lyhyesti, miten kauan asian käsittely viranomaistasolla kestää.", "type": "ProcessingTimeAdditionalInfo", "value": "Maksullisuuden lisätieto -kentässä voit kuvata maksullisuuden tiedot tarkemmin.", "type": "ChargeTypeAdditionalInfo" "servicechargetype": "Charged", "languages": [ "fi", "sv" "requirements": [ "value": "Kuvaa sanallisesti ehdot ja kriteerit...", "serviceclasses": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v1001", "http://urn.fi/urn:nbn:fi:au:ptvl:v1087" "ontologyterms": [ "http://www.yso.fi/onto/koko/p63205" "targetgroups": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v2001" "legislation": [ "names": [ "value": "Rikoslaki", "webpages": [ "url": "http://www.finlex.fi/fi/laki/ajantasa/1889/18890039001", 10
"serviceorganizations": [ "organizationid": "b458d033-042d-4cbe-b030-34e81da28821", "roletype": "Responsible", "organizationid": "b51f13d6-6dc1-4643-a648-c41702aa1680", "roletype": "Responsible", "provisiontype": "SelfProduced", "roletype": "Producer", "organizationid": "b51f13d6-6dc1-4643-a648-c41702aa1680", "provisiontype": "SelfProduced", "roletype": "Producer", "organizationid": "b458d033-042d-4cbe-b030-34e81da28821" "servicevouchers": [ "ordernumber": 1, "value": "Verkkosivun nimi, josta käyttäjä saa tietoa palvelusetelin käytöstä", "url": "http://stm.fi/palveluseteli", "additionalinformation": "Palvelusetelillä voi hankkia sellaisia sosiaali- ja terveyspalveluja, jotka kunnan tai kuntayhtymän kuuluu järjestää asukkailleen." "publishingstatus": "Published" 11
2.4 Creating a new Service: PurchaseServices, one Responsible, one Producer (ID) Service type (palvelutyyppi) = PermissionAndObligation (lupa tai muu velvoite) ProvisionType (toteutustapa) = PurchaseServices (ostopalvelut) Service has one Responsible organization (vastuutaho) Service has one Producer organization (tuottaja) Producer organization is in PTV (organization ID is given) "type": "PermissionAndObligation", "fundingtype": "PubliclyFunded", "servicenames": [ "value": "Testi400-palvelu-050717", "type": "Name", "value": "palvelu-050717", "type": "AlternateName" "areatype": "AreaType", "areas": [ "type": "Municipality", "areacodes": [ "109" "servicedescriptions": [ "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...\n\nyleiskaava kertoo, miten...", "type": "Description", "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...", "type": "ShortDescription", "value": "Edellyttääkö palvelun käyttö tietynlaista toimintatapaa?\nkuvaa tieto tähän kenttään", "type": "ServiceUserInstruction", 12
"value": "Lupaa on haettava tiettyyn määräaikaan mennessä...", "type": "DeadLineAdditionalInfo", "value": "Kuvaa lyhyesti tieto siitä, miten kauan lupa tai velvoite on voimassa. Esim. Lupa on voimassa kolme (3) vuotta.\n Lupa on voimassa toistaiseksi.", "type": "ValidityTimeAdditionalInfo", "value": "Kuvaa lyhyesti, miten kauan asian käsittely viranomaistasolla kestää.", "type": "ProcessingTimeAdditionalInfo", "value": "Maksullisuuden lisätieto -kentässä voit kuvata maksullisuuden tiedot tarkemmin.", "type": "ChargeTypeAdditionalInfo" "servicechargetype": "Charged", "languages": [ "fi", "sv" "requirements": [ "value": "Kuvaa sanallisesti ehdot ja kriteerit...", "serviceclasses": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v1001", "http://urn.fi/urn:nbn:fi:au:ptvl:v1087" "ontologyterms": [ "http://www.yso.fi/onto/koko/p63205" "targetgroups": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v2001" "legislation": [ "names": [ "value": "Rikoslaki", "webpages": [ "url": "http://www.finlex.fi/fi/laki/ajantasa/1889/18890039001", 13
"serviceorganizations": [ "organizationid": "b458d033-042d-4cbe-b030-34e81da28821", "roletype": "Responsible", "provisiontype": "PurchaseServices", "roletype": "Producer", "organizationid": "b60130f9-5814-441e-ba03-58c0bd01c852" "publishingstatus": "Published" 14
2.5 Creating a new Service: PurchaseServices, one Responsible, one Producer (name) Service type (palvelutyyppi) = PermissionAndObligation (lupa tai muu velvoite) ProvisionType (toteutustapa) = PurchaseServices (ostopalvelut) Service has one Responsible organization (vastuutaho) Service has one Producer organization (tuottaja) Producer organization is not in PTV (organization name is given) "type": "PermissionAndObligation", "fundingtype": "PubliclyFunded", "servicenames": [ "value": "Testi410-palvelu-050717", "type": "Name", "value": "palvelu-050717", "type": "AlternateName" "areatype": "AreaType", "areas": [ "type": "Municipality", "areacodes": [ "109" "servicedescriptions": [ "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...\n\nyleiskaava kertoo, miten...", "type": "Description", "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...", "type": "ShortDescription", "value": "Edellyttääkö palvelun käyttö tietynlaista toimintatapaa?\nkuvaa tieto tähän kenttään", "type": "ServiceUserInstruction", 15
"value": "Lupaa on haettava tiettyyn määräaikaan mennessä...", "type": "DeadLineAdditionalInfo", "value": "Kuvaa lyhyesti tieto siitä, miten kauan lupa tai velvoite on voimassa. Esim. Lupa on voimassa kolme (3) vuotta.\n Lupa on voimassa toistaiseksi.", "type": "ValidityTimeAdditionalInfo", "value": "Kuvaa lyhyesti, miten kauan asian käsittely viranomaistasolla kestää.", "type": "ProcessingTimeAdditionalInfo", "value": "Maksullisuuden lisätieto -kentässä voit kuvata maksullisuuden tiedot tarkemmin.", "type": "ChargeTypeAdditionalInfo" "servicechargetype": "Charged", "languages": [ "fi", "sv" "requirements": [ "value": "Kuvaa sanallisesti ehdot ja kriteerit...", "serviceclasses": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v1001", "http://urn.fi/urn:nbn:fi:au:ptvl:v1087" "ontologyterms": [ "http://www.yso.fi/onto/koko/p63205" "targetgroups": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v2001" "legislation": [ "names": [ "value": "Rikoslaki", "webpages": [ "url": "http://www.finlex.fi/fi/laki/ajantasa/1889/18890039001", 16
"serviceorganizations": [ "organizationid": "b458d033-042d-4cbe-b030-34e81da28821", "roletype": "Responsible", "provisiontype": "PurchaseServices", "roletype": "Producer", "additionalinformation": [ "value": "Ulkopuolinen tuottaja Z - tietoja ei lyödy Palvelutietovarannosta", "publishingstatus": "Published" 17
2.6 Creating a new Service: Other, one Responsible, one Producer (ID) Service type (palvelutyyppi) = PermissionAndObligation (lupa tai muu velvoite) ProvisionType (toteutustapa) = Other (muu) Service has one Responsible organization (vastuutaho) Service has one Producer organization (tuottaja) Producer organization is in PTV (organization ID is given) "type": "PermissionAndObligation", "fundingtype": "PubliclyFunded", "servicenames": [ "value": "Testi500-palvelu-050717", "type": "Name", "value": "palvelu-050717", "type": "AlternateName" "areatype": "AreaType", "areas": [ "type": "Municipality", "areacodes": [ "109" "servicedescriptions": [ "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...\n\nyleiskaava kertoo, miten...", "type": "Description", "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...", "type": "ShortDescription", "value": "Edellyttääkö palvelun käyttö tietynlaista toimintatapaa?\nkuvaa tieto tähän kenttään", "type": "ServiceUserInstruction", 18
"value": "Lupaa on haettava tiettyyn määräaikaan mennessä...", "type": "DeadLineAdditionalInfo", "value": "Kuvaa lyhyesti tieto siitä, miten kauan lupa tai velvoite on voimassa. Esim. Lupa on voimassa kolme (3) vuotta.\n Lupa on voimassa toistaiseksi.", "type": "ValidityTimeAdditionalInfo", "value": "Kuvaa lyhyesti, miten kauan asian käsittely viranomaistasolla kestää.", "type": "ProcessingTimeAdditionalInfo", "value": "Maksullisuuden lisätieto -kentässä voit kuvata maksullisuuden tiedot tarkemmin.", "type": "ChargeTypeAdditionalInfo" "servicechargetype": "Charged", "languages": [ "fi", "sv" "requirements": [ "value": "Kuvaa sanallisesti ehdot ja kriteerit...", "serviceclasses": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v1001", "http://urn.fi/urn:nbn:fi:au:ptvl:v1087" "ontologyterms": [ "http://www.yso.fi/onto/koko/p63205" "targetgroups": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v2001" "legislation": [ "names": [ "value": "Rikoslaki", "webpages": [ "url": "http://www.finlex.fi/fi/laki/ajantasa/1889/18890039001", 19
"serviceorganizations": [ "organizationid": "b458d033-042d-4cbe-b030-34e81da28821", "roletype": "Responsible", "provisiontype": "Other", "roletype": "Producer", organizationid" : "b60130f9-5814-441e-ba03-58c0bd01c852", "publishingstatus": "Published" 20
2.7 Creating a new Service: Other, one Responsible, one Producer (name) Service type (palvelutyyppi) = PermissionAndObligation (lupa tai muu velvoite) ProvisionType (toteutustapa) = Other (muu) Service has one Responsible organization (vastuutaho) Service has one Producer organization (tuottaja) Producer organization is not in PTV (organization name is given) "type": "PermissionAndObligation", "fundingtype": "PubliclyFunded", "servicenames": [ "value": "Testi510-palvelu-050717", "type": "Name", "value": "palvelu-050717", "type": "AlternateName" "areatype": "AreaType", "areas": [ "type": "Municipality", "areacodes": [ "109" "servicedescriptions": [ "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...\n\nyleiskaava kertoo, miten...", "type": "Description", "value": "Kaikilla, joiden oloihin tai etuihin yleiskaavoitus vaikuttaa, on...", "type": "ShortDescription", "value": "Edellyttääkö palvelun käyttö tietynlaista toimintatapaa?\nkuvaa tieto tähän kenttään", "type": "ServiceUserInstruction", 21
"value": "Lupaa on haettava tiettyyn määräaikaan mennessä...", "type": "DeadLineAdditionalInfo", "value": "Kuvaa lyhyesti tieto siitä, miten kauan lupa tai velvoite on voimassa. Esim. Lupa on voimassa kolme (3) vuotta.\n Lupa on voimassa toistaiseksi.", "type": "ValidityTimeAdditionalInfo", "value": "Kuvaa lyhyesti, miten kauan asian käsittely viranomaistasolla kestää.", "type": "ProcessingTimeAdditionalInfo", "value": "Maksullisuuden lisätieto -kentässä voit kuvata maksullisuuden tiedot tarkemmin.", "type": "ChargeTypeAdditionalInfo" "servicechargetype": "Charged", "languages": [ "fi", "sv" "requirements": [ "value": "Kuvaa sanallisesti ehdot ja kriteerit...", "serviceclasses": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v1001", "http://urn.fi/urn:nbn:fi:au:ptvl:v1087" "ontologyterms": [ "http://www.yso.fi/onto/koko/p63205" "targetgroups": [ "http://urn.fi/urn:nbn:fi:au:ptvl:v2001" "legislation": [ "names": [ "value": "Rikoslaki", "webpages": [ "url": "http://www.finlex.fi/fi/laki/ajantasa/1889/18890039001", 22
"serviceorganizations": [ "organizationid": "b458d033-042d-4cbe-b030-34e81da28821", "roletype": "Responsible", "provisiontype": "Other", "roletype": "Producer", "additionalinformation": [ "value": "Ulkopuolinen tuottaja Y - tietoja ei lyödy Palvelutietovarannosta", "publishingstatus": "Published" 23
3. POST ServiceChannel/ServiceLocation 3.1 Creating a new Service Location Service Channel: ServiceHours "sourceid": "Palvelupisteen-testi", "organizationid": "b458d033-042d-4cbe-b030-34e81da28821", "servicechannelnames": [ "value": "Testi100-Palvelupiste-050717", "servicechanneldescriptions": [ "value": "Kirjoita tiivistelmä eli lyhyt kuvaus palvelupisteestä.", "type": "ShortDescription", "value": "Kuvaa palvelupiste mahdollisimman selkeästi ja asiakkaan kannalta ymmärrettävästi.", "type": "Description" "areatype": "AreaType", "areas": [ "type": "Municipality", "areacodes": [ "109" "emails": [ "value": "info@palvelupiste.fi", "phonenumbers": [ "additionalinformation": "palvelupisteen neuvonta", "servicechargetype": "Charged", "chargedescription": "Jonotusajalta peritään normaali puhelumaksu", "isfinnishservicenumber": true, "number": "080071600",, "additionalinformation": "palvelupisteen neuvonta", "servicechargetype": "Charged", 24
"chargedescription": "Jonotusajalta peritään normaali puhelumaksu", "prefixnumber": "+358", "isfinnishservicenumber": false, "number": "36125114", "languages": [ "sv", "fi" "webpages": [ "ordernumber": "1", "value": "Esimerkkikunnan palvelun verkkosivut", "url": "http://www.esimerkkikunta.fi/palvelupiste", "addresses": [ "type": "Visiting", "streetaddress": [ "value": "Mäkitie", "postalcode": "33880", "streetnumber": "4", "municipality": "418", "additionalinformations": [ "value": "palvelupiste avoinna - katso aukioloajat", "servicehours": [ "servicehourtype": "Standard", "validfrom": null, "validto": null, "isclosed": false, "validfornow": true, "additionalinformation": [ "value": "Normaalit voimassa toistaiseksi 1 (ma + extra)", "openinghour": [ 25
"dayfrom": "Monday", "dayto": null, "from": "08:00", "to": "11:00", "isextra": false, "dayfrom": "Monday", "dayto": null, "from": "12:00", "to": "16:00", "isextra": true, "servicehourtype": "Standard", "validfrom": null, "validto": null, "isclosed": false, "validfornow": true, "additionalinformation": [ "value": "Normaalit voimassa toistaiseksi 24/7", "openinghour": [, "servicehourtype": "Standard", "validfrom": "2017-08-29", "validto": "2017-09-01", "isclosed": false, "validfornow": false, "additionalinformation": [ "value": "Normaalit voimassa ajanjaksolla", "openinghour": [ "dayfrom": "Wednesday", "dayto": "", "from": "08:00:00", "to": "16:00:00", "isextra": false, "dayfrom": "Monday", "dayto": "", "from": "08:00:00", 26
"to": "16:00:00", "isextra": false, "servicehourtype": "Standard", "validfrom": "2017-08-29", "validto": "2017-09-01", "isclosed": false, "validfornow": false, "additionalinformation": [ "value": "Normaalit voimassa ajanjaksolla 24/7", "openinghour": [, "servicehourtype": "Exception", "validfrom": "2017-07-25", "validto": null, "isclosed": false, "validfornow": false, "additionalinformation": [ "value": "Poikkeavat aukioloajat 1 - päivä", "openinghour": [ "dayfrom": "Monday", "dayto": null, "from": "01:00:00", "to": "1:15:00", "isextra": false, "servicehourtype": "Exception", "validfrom": "2017-07-26", "validto": null, "isclosed": true, "validfornow": false, "additionalinformation": [ "value": "Poikkeavat aukioloajat 2 - päivä suljettu", 27
"openinghour": [, "servicehourtype": "Exception", "validfrom": "2017-06-27", "validto": "2017-06-28", "isclosed": false, "validfornow": false, "additionalinformation": [ "value": "Poikkeavat aukioloajat 3 - ajanjakso", "openinghour": [ "dayfrom": "Monday", "dayto": null, "from": "01:00:00", "to": "1:15:00", "isextra": false, "servicehourtype": "Exception", "validfrom": "2017-06-28", "validto": "2017-06-29", "isclosed": true, "validfornow": false, "additionalinformation": [ "value": "Poikkeavat aukioloajat 4 - ajanjakso suljettu", "openinghour": [, "servicehourtype": "Special", "validfrom": null, "validto": null, "isclosed": false, "validfornow": true, "additionalinformation": [ "value": "Vuorokauden ylimenevät 1 - toistaiseksi", "openinghour": [ "dayfrom": "Monday", 28
"dayto": "Tuesday", "from": "19:00:00", "to": "1:00:00", "isextra": false, "servicehourtype": "Special", "validfrom": "2017-07-28", "validto": "2017-07-30", "isclosed": false, "validfornow": false, "additionalinformation": [ "value": "Vuorokauden ylimenevät 2 - ajanjaksolla", "openinghour": [ "dayfrom": "Monday", "dayto": "Wednesday", "from": "20:00:00", "to": "1:15:00", "isextra": false "publishingstatus": "Draft", "isvisibleforall": true 29
3.2 Creating a new Service Location Service Channel: languages fi and sv "sourceid": "Palvelupisteen-testi-4", "organizationid": "b458d033-042d-4cbe-b030-34e81da28821", "servicechannelnames": [ "value": "Testi800-Palvelupiste-060717",, "value": "Test800-tjänst-060717", "language": "sv" "servicechanneldescriptions": [ "value": "Kirjoita tiivistelmä eli lyhyt kuvaus palvelupisteestä.", "type": "ShortDescription", "value": "Kuvaa palvelupiste mahdollisimman selkeästi ja asiakkaan kannalta ymmärrettävästi.", "type": "Description", "language": "sv", "value": "Skriv en sammanfattning, dvs. en kort beskrivning av servicestället.", "type": "ShortDescription", "language": "sv", "value": "Beskriv servicestället så tydligt som möjligt och på ett förståeligt sätt för kunden.\n Beskriv på ett allmänt plan vilka ärenden som kan uträttas på servicestället.", "type": "Description" "areatype": "AreaType", "areas": [ "type": "Municipality", "areacodes": [ "109" "emails": [ "value": "info@palvelupiste.fi",, 30
"value": "sv-information@palvelupiste.fi", "language": "sv" "phonenumbers": [ "additionalinformation": "palvelupisteen tuki", "servicechargetype": "Charged", "chargedescription": "Jonotusajalta peritään normaali puhelumaksu", "isfinnishservicenumber": true, "number": "080071600",, "additionalinformation": "palvelupisteen neuvonta", "servicechargetype": "Charged", "chargedescription": "Jonotusajalta peritään normaali puhelumaksu", "prefixnumber": "+358", "isfinnishservicenumber": false, "number": "36125114",, "additionalinformation": "Serviceställe support - endast tillgänglig på finska.", "servicechargetype": "Charged", "chargedescription": "Precisera i skrift vilka avgifter som kan höra till samtalet.", "isfinnishservicenumber": true, "number": "080071600", "language": "sv", "additionalinformation": "Serviceställe information", "servicechargetype": "Charged", "chargedescription": "Precisera i skrift vilka avgifter som kan höra till samtalet.", "prefixnumber": "+358", "isfinnishservicenumber": false, "number": "36125114", "language": "sv" "languages": [ "sv", "fi" "webpages": [ "ordernumber": "1", "value": "Esimerkkikunnan palvelun verkkosivut", "url": "http://www.esimerkkikunta.fi/palvelupiste",, "ordernumber": "1", 31
"value": "Serviceställe webbsida", "url": "http://www.esimerkkikunta.fi/sv/servicetälle", "language": "sv" "addresses": [ "type": "Visiting", "streetaddress": [ "value": "Ahvenkoskenkatu",, "value": "Abborforsgatan", "language": "sv" "postalcode": "06100", "streetnumber": "4", "municipality": "638", "additionalinformations": [ "value": "palvelupiste avoinna - katso aukioloajat",, "value": "Serviceställe öppen - se öppettider", "language": "sv" "servicehours": [ "servicehourtype": "Standard", "validfrom": null, "validto": null, "isclosed": false, "validfornow": true, "additionalinformation": [ "value": "Normaalit voimassa toistaiseksi 1 (ma + extra)", "openinghour": [ "dayfrom": "Monday", "dayto": null, "from": "08:00", "to": "11:00", "isextra": false 32
, "dayfrom": "Monday", "dayto": null, "from": "12:00", "to": "16:00", "isextra": true, "servicehourtype": "Exception", "validfrom": "2017-07-25", "validto": null, "isclosed": false, "validfornow": false, "additionalinformation": [ "value": "Poikkeavat aukioloajat 1 - päivä", "openinghour": [ "dayfrom": "Monday", "dayto": null, "from": "01:00:00", "to": "1:15:00", "isextra": false, "servicehourtype": "Standard", "validfrom": null, "validto": null, "isclosed": false, "validfornow": true, "additionalinformation": [ "value": "Normala betjäningstider 1 (mån + extra)", "language": "sv" "openinghour": [ "dayfrom": "Monday", "dayto": null, "from": "08:00", "to": "11:00", "isextra": false, 33
"dayfrom": "Monday", "dayto": null, "from": "12:00", "to": "16:00", "isextra": true, "servicehourtype": "Exception", "validfrom": "2017-07-25", "validto": null, "isclosed": false, "validfornow": false, "additionalinformation": [ "value": "Avvikande betjäningstider 1 - dag", "language": "sv" "openinghour": [ "dayfrom": "Monday", "dayto": null, "from": "01:00:00", "to": "1:15:00", "isextra": false "publishingstatus": "Published", "isvisibleforall": true 34
4. POST Service/ServiceAndChannel 4.1 Creating a connection between Service and Service Channel [ "serviceid": "b2e1e794-1477-4096-8e93-e5f1edc80280", "servicechannelid": "71beff1d-698f-48ea-a3f0-c7835d68c584", "description": [ "value": "Extra information for connection", "type": "Description" "servicechargetype": "Free" 35