Oikeusapujärjestelmä/Romeo Laskuerittelyn liittymäkuvaus

Oikeusapujärjestelmä/Romeo 1 / 20 Oikeusapujärjestelmä/Romeo Laskuerittelyn liittymäkuvaus Versio 16.3.2

Oikeusapujärjestelmä/Romeo 2 / 20 Sisältö 1 Dokumentin tarkoitus... 7 2 Toiminnallisuus... 7 3 Laskuerittelyn tietosisältö... 7 3.1 Input... 7 3.2 Laskutuslajin koodit:... 14 3.3 Tuomioistuinkoodit... 14 3.4 Oikeusaputoimistojen tunnukset... 15 3.5 Syyttäjänvirastojen tunnukset... 17 3.6 Output... 17 4 Salaus ja allekirjoitus... 18 5 Esimerkki XML... 19

Oikeusapujärjestelmä/Romeo 3 / 20 Muutoshistoria Versio Pvm Tekijä Kuvaus 0.1 26.2.2009 Marjo Liesegang Ensimmäinen versio 0.2 4.3.2009 Marjo Liesegang Päivitetty 0.3 24.3.2009 Marjo Liesegang Päivitetty/Täydennetty 0.4 8.4.2009 Sami Mäkinen Päivitetty/Täydennetty 0.5 3.5.2009 Sami Mäkinen Päivitetty/Täydennetty 0.6 13.1.2010 Marjo Liesegang Päivitetty paluusanoman tiedot ja tarkennettu dokumenttia 0.7 25.2.2010 Ilkka Nummi Lisätty tuomioistuinkoodit ja oikeusaputoimistojen tunnukset 0.8 1.3.2010 Sari Inkeroinen legalmatternumber ja processdate päivitetty lukumäärä 0-1, ssn pakollisuus päivitetty, lisätty idcode 10.2.1 1.7.2010 Marjo Liesegang Poistettu viitenumeron ja laskun numeron pakollisuus. 10.2.2 2.7.2010 Marjo Liesegang Uudet tiedot syyttäjänvirasto ja syyttäjän diaarinumero 10.2.3 8.7.2010 Marjo Liesegang Tarkennettu. 10.3.1 14.11.2010 Ilkka Nummi Web service käyttäjätunnus ja salasana lisätty. Viittaus mallitoteutukseen. 10.4.1 8.12.2010 Marjo Liesegang 3.1, uusi atribuutti, avustaja alv-rekisterissä. 10.4.2 15.12.2010 Marjo Liesegang Täydennety outputtiin attachment elementti.

Oikeusapujärjestelmä/Romeo 4 / 20 Muutoshistoria Versio Pvm Tekijä Kuvaus 10.4.3 17.12.2010 Marjo Liesegang Päivitetty kohtia: - decisiontype - reason - deathestategrossassets - unit 10.4.4 27.12.2010 Marjo Liesegang Päivitetty, laskun lajin aino sallittu arvo. 11.1.1 11.2.2011 Marjo Liesegang Ylivieska-Raahen tuomioistuinkoodi muutettu 749 -> 768. 11.1.2 17.2.2011 Marjo Liesegang Lisätty attribuutti courtdepartment 11.1.3 21.2.2011 Marjo Liesegang Lisätty attribuutti notificationmethod (tiedoksiantotapa) 11.1.4 24.2.2011 Sari Inkeroinen 3.5 Output, tarkennettu palautettavia virhetekstejä 11.1.5 29.3.2011 Ilkka Nummi Lisätty syyttäjänvirastojen tunnukset (3.5) 11.1.6 15.4.2011 Marjo Liesegang Toinen tiedosta viitenumero tai laskunumero on pakollinen. 11.1.7 25.5.2011 Marjo Liesegang Käsittelypäivä (3.1) ei ole pakollinen tieto. 11.2.1 12.9.2011 Ilkka Nummi Tarkennettu elementtien reason ja insurance selitteitä. 11.3.1 9.11.2011 Jani Lyttinen decisionnumber (3.1) muutettu pakolliseksi ja kuvaus: Oikeusapupäätöksen asianumero -> Oikeusapuasian tunnus 12.1.3 23.01.2012 Jani Halinen Lisätty attribuutit creator ja assistantname keskeneräiseksi tallennettavia laskuerittelyitä varten 12.1.4 15.2.2012 Ilkka Nummi Muutos laskutuslajeihin, kohta 3.2. Laji Palkkio jakautunut kahtia. 12.1.5 23.4.2012 Sari Inkeroinen 3.4, Päivitetty oikeusaputoimistolistaus. 12.1.6 2.5.2012 Sari Inkeroinen 3.4, Poistettu yhdistyneet oikeuaputoimistot.

Oikeusapujärjestelmä/Romeo 5 / 20 Muutoshistoria Versio Pvm Tekijä Kuvaus 13.1.1 2.1.2013 Marjo Liesegang Hyväksytty vanhat trackingit ja päivitetty kohtaan 3.4 uudet oikeusaputoimistot (2013). 13.1.2 19.2.2013 Seppo Kaartinen Hyväksytty vanhat muutokset ja lisätty voimassaolevat osastot 13.1.3 11.6.2013 Marjo Liesegang Hyväksytty vanhat muutokset. Laskun viitenumeron oikeellisuustarkistus lisätty (kohta 3.1 referencenumber). Lisätty attribuutti generatedraft. Päivitetty esimerkki XML (kohta 5). 13.3.1 7.11.2013 Marjo Liesegang Hyväksytty vanhat muutokset. Lisätty uusi laskutuslaji kohtaan 3.2. 13.3.2 25.11.2013 Marjo Liesegang Päivitetty 1.1.2014 voimaan tulevat oikeusaputoimistot ja syyttäjänvirastot, kohdat 3.4 ja 3.5. 13.3.3 19.12.2013 Marjo Liesegang Tarkennettu oikeusaputoimistojen nimiä ja osastotunnuksia, kohta 3.4. 14.1.1 26.2.2014 Marjo Liesegang Hyväksytty vanhat muutokset. Päivitetty 1.4.2014 voimaan tulevat tuomioistumet ja tuomioistuin koodit, kohta 3.3. 14.2.1 14.11.2014 Marjo Liesegang Hyväksytty vanhat muutokset. Päivitetty 1.1.2015 voimassa olevat oikeusaputoimistot, kohta 3.4. 14.2.2 16.2.2015 Marjo Liesegang Lisätty uusi päätöslaji (decision type). 16.3.1 7.6.2016 Marjo Liesegang Lisätty tarkistus vastaanottavan organisaation/osaston voimassaolo, kohta 3.6.

Oikeusapujärjestelmä/Romeo 6 / 20 Muutoshistoria Versio Pvm Tekijä Kuvaus 16.3.2 14.9.2016 Marjo Liesegang Rajapintaan uusia tietoja: turvapaikanhakijan asiakasnumero (asylumseekernumber) ja asiakohtainen palkkio (minimumfee), päätöslajeihin kolme uuttaa lajia, kohta 3.1 Päivitetty oikeusaputoimistot (1.10.2016 alkaen), kohta 3.4

Oikeusapujärjestelmä/Romeo 7 / 20 1 Dokumentin tarkoitus Tässä dokumentissa kuvataan Oikeusministeriön oikeusapujärjestelmän (Romeoo) laskuerittelyrajapinta. Rajapintaa käytetään yksityisen avustajan (esim. asianajotoimiston) laskuerittelyn lähettämiseen. 2 Toiminnallisuus Yksityinen avustaja hakee korvausta oikeusapupäätöksestä. Laskuerittely käsitellään sähköisesti Romeo-järjestelmässä. 3 Laskuerittelyn tietosisältö 3.1 Input Nimi Tietotyyppi Luku määrä Pakollinen Kuvaus Käytettävä koodisto user String 1 Kyllä Tyhjä kenttä senddate Date 1 Kyllä Timestamp lähetyksessä source String 1 Kyllä Vapaa teksti, ei käyttöä toistaiseksi wsusername String 1 Kyllä web service käyttäjätunnus wspassword String 1 Kyllä web service salasana generatedraft Boolea n 0-1 Ei Laskuerittelyn luonnosdokument in luontiin käytettävä attribuutti. EI KÄYTÖSSÄ!

Oikeusapujärjestelmä/Romeo 8 / 20 Invoice elementti 1 Kyllä id int 0-1 Ei, käytetään vain keskeneräis issä laskuerittely issä Keskeneräisen laskuerittelyn sisäinen id ytunnus Ytunn us 0-1 Kyllä, jos kyseessä avustajatoi misto Avustajatoimiston Y-tunnus. ssn Hetu 0-1 Kyllä, jos idcode puuttuu idcode String 0-1 Kyllä, jos hetu ssn puuttuu Avustajan hetu. Jos yksityinen ammatinharjoittaj a, pelkästään tämä (ei Y- tunnusta). Avustajan käyttäjätunnus. creator String 0-1 Ei Tallentaja Ei käytössä WSrajapinnassa. notificationmethod int 1 Kyllä Avustajalle menevän päätöksen tiedoksiantotapa. 1 = Posti 2 = Muu 5 = Faksi legalmatternumber String 0-1 Kyllä, jos organisaati on tyyppi = tuomioistuin Pääasian, tuomioistuimen tai muun viranomaisen asianumero (diaarinumero) responsibleorgtype int 1 Kyllä Organisaatio jossa pääasia on käsiteltävänä (johon laskuerittely lähetetään). Organisaation tyyppi: 1 = oa-toimisto 2 = tuomioistuin

Oikeusapujärjestelmä/Romeo 9 / 20 court int 0-1 Kyllä jos organisaati on tyyppi = tuomioistuin Tuomioistuin, jossa pääasia on käsiteltävänä. Tuomioistuinkood i, esim 707 courtdeparment String 0-1 Ei Tuomioistimen osasto legalaidoffice String 0-1 Kyllä jos organisaati on tyyppi = oikeusaput oimisto Oikeusaputoimist o jossa pääasia on käsiteltävänä. Oikeusaputoimist on tunnus, esim 325 processdate Date 0-1 Ei Oikeudellisen (pääasian) käsittelypäivä. prosecutoroffice String 0-1 Ei Syyttäjänviraston tunnus Syyttäjänvirasto prosecutorsnumber String 0-1 Kyllä jos syyttäjävira sto on valittu Syyttäjänviraston diaarinumero clientfirstname String 1 Kyllä Päämiehen etunimi. clientlastname String 1 Kyllä Päämiehen sukunimi. clientssn Hetu 0 1 Ei Päämiehen henkilötunnus. clientdateofbirth Date 0 1 EI, paitsi jos hetu puuttuu Päämiehen syntymäaika, tieto pakollinen jos hetua ei ole annettu. asylumseekernumb er String 0 1 Ei Päämiehen turvapaikanhakija n asiakasnumero. Numeron pitää olla numeerinen ja 6 tai 7 merkkiä pitkä.

Oikeusapujärjestelmä/Romeo 10 / 20 minimumfee 0 1 Ei Asiakohtainen palkkio turvapaikkaasiassa 7 = Hallintomenettely 8 = Hallintomenettely, puhuttelu 9 = Hallintooikeus, normaali 10 = Hallintooikeus, vaativa 11 = KHO, normaali 12 = KHO, vaativa 13 = Hallintomenettely, suppea, 7 14 = Hallintooikeus, suppea, 7 a 15 = KHO, suppea, 7 a 2 Jos annetaan asiakohtainen palkkio turvapaikkaasiassa, pitää päätöslajin olla 9 = Oikeusapupäätös turvapaikanhakija decisiontype int 1 Kyllä Oikeusapupäätök sen tyyppi. Päätöslaji 1 = Oikeusapupäätös 2 = Puolustajan määräys 5 = Asianomistajan

Oikeusapujärjestelmä/Romeo 11 / 20 decisionnumber String 1 Kyllä Oikeusapuasian tunnus. avustajamääräys 6 = Edunvalvojan määräys 7 = Avustajan määräys 8 = Oikeusapupäätös HAO 9 = Oikeusapupäätös turvapaikanhakija category int 1 Kyllä Laskun laji (esim. Yksityisen avustajan lasku). Laskulaji 1 = Yksityisen avustajan referencenumber String 0-1 Ei Laskun viitenumero. Järjestelmä tarkistaa viitenumeron oikeellisuuden. invoicenumber String 0 1 Kyllä, jos refrencenu mber puuttuu Laskunumero reason int 1 Kyllä Laskun peruste. Laskun peruste increaseclaim Decim 1 Kyllä Korotusvaatimus. 1 = Oikeusapupalkkio 2= Vakuutuksen omavastuu 3 = Vakuutuksen ylimenevä

Oikeusapujärjestelmä/Romeo 12 / 20 casebenefits deathestategrossas sets minimumclaim clientaccepted demandclientshare invoicevat attorneyvatregister ed multipleclients al Decim al Decim al Boolea n Boolea n Boolea n Boolea n Boolea n Boolea n 1 Ei Asiasta saatu hyöty. 1 Ei Kuolinpesän bruttovarat. 1 Kyllä Tieto suostuuko avustaja vähimmäisvaatim ukseen. 1 Kyllä Tieto onko päämies hyväksynyt laskun. 1 Kyllä Tieto vaaditaanko päämiehen osuus 1 Kyllä Tieto onko asiakas alv laskutettava vai ei. 1 Ei Tieto onko avustaja alvrekisterissä. Jos tietoa ei ole annettu, oletuksena Kyllä. 1 Kyllä Tieto useammasta asiakkaasta description String 1 Ei Perustelut Perustelu on pakollinen jos Asiakohtainen palkkio turvapaikkaasiassa ja valittu: 8, 10 tai 12 assistantname String 0-1 Ei Avustajan nimi Ei käytössä WSrajapinnassa.

Oikeusapujärjestelmä/Romeo 13 / 20 Insurance elementti 0-1 Ei liabilitypercent liabilityeuros insurancemaximum Decim al Decim al Decim al 1 Kyllä Vakuutus omavastuu% 1 Kyllä Vakuutus omavastuu 1 Kyllä Vakuutus max korvaus Invoicerow elementti 0 - n Kyllä date Date Kyllä Toimenpiteen päivämäärä. category int Kyllä Toimenpiteen laji (erittely). Laskutuslaji ks. alla description String Ei Toimenpiteeseen liittyvä selite. unit int Kyllä Laskutusyksikkö (tuntikorvaus vai kertakorvaus). Laskutusyksikkö 1= Tunti 2=Kerta amount Decim al Kyllä jos laskutusyks ikkö tunti Laskutusyksiköid en (tuntien) määrä. Esim. 0.1, 0.25, 0.5, 0.75, jne. unitprice Decim al Kyllä Yhden laskutusyksikön hinta (euromäärä) insurance boolea n Kyllä Vakuutusrivi True kun Laskun peruste / reason = 2. False kun Laskun peruste / reason = 1 tai 3. Attachment elementti 0 - n originalname String Kyllä Tiedoston nimi binary Binary Kyllä

Oikeusapujärjestelmä/Romeo 14 / 20 3.2 Laskutuslajin koodit: 1 Palkkio/valmistautuminen 2 Istuntoaika 3 Matka-aika istuntoon 4 Muu matka, matka-aik 5 Matkakulut 6 Muut kulut 7 Alv verottomat kulut 8 Todistelukustannukset 9 Tulkkaus- ja käännöskulut 10 Todistelukustannukset, Alv 0% 11 Tulkkaus/ käännöskulut, Alv 0% 12 Palkkio, ei sallittu WS-rajapinnassa, käytä lajeja 1 tai 13 13 Palkkio/esitutkinta 19 Palkkio/Jälkitoimet 3.3 Tuomioistuinkoodit Tunnus Tuomioistuin Osastot 1 Korkein oikeus 2 Korkein hallinto-oikeus 16 Helsingin hovioikeus 50 Kirjaamo 17 Itä-Suomen hovioikeus 50 Muutoksenhakukanslia 18 Turun hovioikeus 50 Muutoksenhakukanslia 19 Vaasan hovioikeus 50 Muutoksenhakukanslia 21 Rovaniemen hovioikeus 50 Muutoksenhakukanslia 23 Vakuutusoikeus 50 Muutoksenhakukanslia 70 Helsingin hallinto-oikeus 50 Muutoksenhakukanslia 71 Hämeenlinnan hallinto-oikeus 1 1. jaosto 2 2. jaosto 3 3. jaosto 4 4. jaosto 50 Muutoksenhakukanslia 73 Itä-Suomen hallinto-oikeus 50 Muutoksenhakukanslia 75 Pohjois-Suomen hallinto-oikeus 50 Muutoksenhakukanslia 76 Turun hallinto-oikeus 50 Muutoksenhakukanslia 77 Vaasan hallinto-oikeus 50 Muutoksenhakukanslia 78 Ålands förvaltningsdomstol 50 Muutoksenhakukanslia 702 Espoon käräjäoikeus 50 Muutoksenhakukanslia 706 Helsingin käräjäoikeus 1 Osasto 1 2 Osasto 2 3 Osasto 3 4 Osasto 4 5 Osasto 5 6 Osasto 6 7 Osasto 7

Oikeusapujärjestelmä/Romeo 15 / 20 8 Osasto 8 50 Muutoksenhakukanslia 707 Hyvinkään käräjäoikeus 50 Muutoksenhakukanslia 708 Kanta-Hämeen käräjäoikeus 50 Hämeenlinnan kanslia 713 Pohjois-Karjalan käräjäoikeus 1 Lainkäyttöosasto 1 715 Keski-Suomen käräjäoikeus 50 Muutoksenhakukanslia 717 Kainuun käräjäoikeus 50 Muutoksenhakukanslia 723 Keski-Pohjanmaan käräjäoikeus 50 Muutoksenhakukanslia 725 Kymenlaakson käräjäoikeus 50 Muutoksenhakukanslia 726 Pohjois-Savon käräjäoikeus Iisalmi Iisalmen kanslia 729 Päijät-Hämeen käräjäoikeus 50 Muutoksenhakukanslia 730 Lapin käräjäoikeus 50 Muutoksenhakukanslia 731 Etelä-Karjalan käräjäoikeus 50 Muutoksenhakukanslia 736 Etelä-Savon käräjäoikeus 50 Muutoksenhakukanslia 742 Oulun käräjäoikeus 50 Muutoksenhakukanslia 747 Satakunnan käräjäoikeus 50 Muutoksenhakukanslia 748 Itä-Uudenmaan käräjäoikeus 50 Muutoksenhakukanslia 750 Länsi-Uudenmaan käräjäoikeus 50 Muutoksenhakukanslia 757 Etelä-Pohjanmaan käräjäoikeus 50 Muutoksenhakukanslia 758 Pirkanmaan käräjäoikeus 50 Muutoksenhakukanslia 763 Tuusulan käräjäoikeus 50 Muutoksenhakukanslia 764 Pohjanmaan käräjäoikeus 50 Muutoksenhakukanslia 766 Vantaan käräjäoikeus 50 Muutoksenhakukanslia 768 Ylivieska-Raahen käräjäoikeus 50 Muutoksenhakukanslia 769 Ålands tingsrätt 50 Muutoksenhakukanslia 771 Kemi-Tornion käräjäoikeus 50 Muutoksenhakukanslia 761 Varsinais-Suomen käräjäoikeus 50 Muutoksenhakukanslia 3.4 Oikeusaputoimistojen tunnukset Tunnus Oikeusaputoimisto Osastot 326 Kanta-Hämeen oikeusaputoimisto 1 Hämeenlinnan toimipaikka 325 Forssan toimipaikka 333 Satakunnan oikeusaputoimisto 1 Porin toimipaikka 327 Kankaanpään toimipaikka 333 Kokemäen toimipaikka 334 Rauman oikeusaputoimisto 1 Rauman toimipaikka 334 Uudenkaupungin toimipaikka 336 Tampereen oikeusaputoimisto 1 Tampereen toimipaikka 337 Pirkanmaan oikeusaputoimisto 336 Tampereen toimipaikka/tampella 3 Akaan toimipaikka 5 Ikaalisten vastaanotto 6 Kangasalan vastaanotto 7 Lempäälän vastaanotto 2 Mänttä-Vilppulan toimipaikka 8 Nokian vastaanotto 9 Oriveden vastaanotto 10 Parkanon vastaanotto 11 Ruoveden vastaanotto 4 Sastamalan toimipaikka

Oikeusapujärjestelmä/Romeo 16 / 20 1 Tampereen toimipaikka/hämeenkatu 12 Valkeakosken vastaanotto 341 Varsinais-Suomen oikeusaputoimisto 1 Turun toimipaikka/eerikinkatu 325 Loimaan toimipaikka 335 Salon toimipaikka 339 Turun toimipaikka/humalistonkatu 344 Ålands rättshjälpsbyrå 1 Mariehamns kontor 347 Keski-Suomen oikeusaputoimisto 1 Jyväskylän toimipaikka 2 Jämsän toimipaikka 3 Äänekosken toimipaikka 359 Viitasaaren toimipaikka 356 Etelä-Pohjanmaan oikeusaputoimisto 1 Seinäjoen toimipaikka 2 Lapuan toimipaikka 352 Alavuden toimipaikka 356 Kauhajoen toimipaikka 357 Keski-Pohjanmaan ja Pohjanmaan oikeusaputoimisto 1 Vaasan toimipaikka 2 Kokkolan toimipaikka 351 Pietarsaaren toimipaikka 357 Närpiön toimipaikka 358 Ylivieskan oikeusaputoimisto 1 Ylivieskan toimipaikka 2 Haapajärven toimipaikka 362 Pohjois-Karjalan oikeusaputoimisto 1 Joensuun toimipaikka 4 Nurmeksen toimipaikka 362 Lieksan toimipaikka 3 Kiteen toimipaikka 2 Ilomantsin toimipaikka 364 Kainuun oikeusaputoimisto 1 Kainuun oikeusaputoimisto 364 Kuhmon toimipaikka 397C Suomussalmen toimipaikka 366 Pohjois-Savon oikeusaputoimisto 1 Kuopion toimipaikka 366 Nilsiän toimipaikka 361 Iisalmen toimipaikka 367 Etelä-Savon oikeusaputoimisto 3733 Pieksämäen toimipaikka 3732 Varkauden toimipaikka 3 Juvan vastaanotto 4 Kangasniemen vastaanotto 2 Mikkelin toimipaikka 5 Mäntyharjun vastaanotto 6 Puumalan vastaanotto 7 Rantasalmen vastaanotto 1 Savonlinnan toimipaikka 8 Sulkavan vastaanotto 373 Keski-Savon oikeusaputoimisto 2 Varkauden toimipaikka 3 Pieksämäen toimipaikka 374 Länsi-Uudenmaan oikeusaputoimisto 1 Espoon toimipaikka 2 Helsingin toimipaikka 3 Lohjan toimipaikka 378 Raaseporin toimipaikka 375 Helsingin oikeusaputoimisto 1 Helsingin toimipaikka 377 Keski-Uudenmaan oikeusaputoimisto 1 Hyvinkään toimipaikka 377 Järvenpään toimipaikka 382 Itä-Uudenmaan oikeusaputoimisto 1 Vantaan toimipaikka

Oikeusapujärjestelmä/Romeo 17 / 20 379 Porvoon vastaanotto 386 Kymenlaakson oikeusaputoimisto 385 Kotkan toimipiste 386 Kouvolan toimipiste 387 1 Lahden toimipaikka 387 Heinolan toimipaikka Päijät-Hämeen oikeusaputoimisto 388 Lappeenrannan oikeusaputoimisto 1 Lappeenrannan toimipaikka 388 Imatran toimipaikka 391 Kemi-Tornion oikeusaputoimisto 1 Kemin toimipaikka 2 Kemin toimipaikka 391 Tornion toimipaikka 395 Oulun oikeusaputoimisto 1 Oulun toimipaikka 2 Raahen toimipaikka 397B Kuusamon toimipaikka 397 Rovaniemen oikeusaputoimisto 397A Rovaniemen toimipaikka 397b Kuusamon toimipaikka 397c Suomussalmen toimipaikka 398 Lapin oikeusaputoimisto 3985 Ivalon toimipaikka 3931 Kittilän toimipaikka 3987 Muonion toimipaikka 3933 Pellon toimipaikka 3984 Sodankylän toimipaikka 3986 Utsjoen toimipaikka 397D 397A 0 Kemin toimipaikka 1 Kemin toimipaikka 391 Tornion toimipaikka Kemijärven vastaanotto Rovaniemen toimipaikka 3.5 Syyttäjänvirastojen tunnukset 601 Länsi-Uudenmaan syyttäjävirasto 607 Helsingin syyttäjävirasto 634 Salpausselän syyttäjävirasto 648 Itä-Suomen syyttäjävirasto 655 Oulun syyttäjävirasto 667 Lapin syyttäjävirasto 678 Länsi-Suomen syyttäjävirasto 680 Pohjanmaan syyttäjävirasto 684 Itä-Uudenmaan syyttäjävirasto 690 Landskapsåklagarämbeter i landskapet Åland 901 Valtakunnansyyttäjävirasto 675 Sisä-Suomen syyttäjänvirasto 3.6 Output newinvoicerespons

Oikeusapujärjestelmä/Romeo 18 / 20 e elementti receivedate Date Laskuerittelyn lähetyspäivä id Long Laskuerittelyn sisäinen id error Boolen a Virhetilanne (true/false) message String Mahdollinen virheteksti Virhetilanteet: Avustajaa ei löydy avustajarekisterist ä. Avustajalla ei ole oikeutta toimia avustajana. Avustaja ei ole voimassa. Organisaatio/osa sto ei ole voimassa. Muu virhe: palautetaan virhekoodi responsibleorg String Organisaatio, johon laskuerittely on lähetetty attachment Base6 4Binar y Järjestelmän muodostama laskuerittelytulost e 4 Salaus ja allekirjoitus Viestien muoto on SOAP document/literal, ja siirtoprotokolla on http.

Oikeusapujärjestelmä/Romeo 19 / 20 Mallitoteutus ja ohjeet dokumentissa Sanomaväylä_testi_client_v10.1.1.doc ja sen liitteissä. Salaus ja allekirjotus tehdään SOAP message body:lle, SOAP header:itä ei salata. Tehtävät ennen viestin lähetystä: Asiakas luo oman sertifikaatin (esim. keytool -genkey -alias clientx509v1 -keypass keypassword -storetype jks -storepass storepassword -validity 3650 -keyalg RSA -keystore client-keystore.jks ) Asiakkaan julkinen avain luetaan trust storesta (esim. keytool -export - alias clientx509v1 -file client-certfile.csr -keystore client-keystore.jks - storepass storepassword -keyalg RSA ) Asiakkaan julkinen avain importoidaan OA-palvelimen trust storeen OA-palvelimen julkinen avain importoidaan asiakkaan trust storeen Kutsuva sovellus suorittaa viestin lähetyksessä seuraavat tehtävät: Kryptaa SOAP-viestin body-alueen käyttäen AES-128-algoritmia ja palvelimen julkista avainta yhdessä oman suojatun avaimen kanssa. Luo sähköisen allekirjoituksen SOAP-viestin body-osasta (MD5- hajautusavain RSA-kryptattuna) Purkaa ja varmentaa vastaavalla logiikalla paluuviestin 5 Esimerkki XML <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:inv="http://www.om.fi/legalaid/invoice"> <soapenv:header/> <soapenv:body> <inv:newinvoicerequest> <senddate>2009-04-01</senddate> <source>soap UI</source> <wsusername>soap UI</wsUsername> <wspassword>soap UI</wsPassword> <generatedraft>false</generatedraft> <inv:invoice> <idcode>aaaaaaa</idcode> <notificationmethod>1</notificationmethod>  <legalmatternumber>*lanumber*</legalmatternumber> <responsibleorgtype>1</responsibleorgtype>   <legalaidoffice>387</legalaidoffice>  <processdate>2010-01-01</processdate>

<clientfirstname>clientf</clientfirstname> <clientlastname>clientl</clientlastname> <clientdateofbirth>1980-01-01</clientdateofbirth> <decisionnumber>100443511</decisionnumber> <category>1</category>  <referencenumber/>  <creator>tauno Tallentaja</creator> <assistantname>antti Avustaja</assistantName> <invoicenumber>*laskunumero*</invoicenumber> <minimumclaim>true</minimumclaim> <clientaccepted>false</clientaccepted> <demandclientshare>true</demandclientshare> <invoicevat>true</invoicevat> <multipleclients>false</multipleclients> <decisiontype>1</decisiontype> <increaseclaim>0</increaseclaim> <casebenefits>0</casebenefits> <deathestategrossassets>0</deathestategrossassets> <reason>1</reason>  <description>soap UI</description>  <inv:insurance> <liabilitypercent>0</liabilitypercent> <liabilityeuros>0.0</liabilityeuros> <insurancemaximum>0</insurancemaximum> </inv:insurance>  <inv:invoicerow> <date>2009-01-01</date> <category>1</category>  <description>selite</description> <insurance>false</insurance> <unit>1</unit> <unitprice>100.00</unitprice> <amount>4</amount> </inv:invoicerow> </inv:invoice> </inv:newinvoicerequest> </soapenv:body> </soapenv:envelope> Oikeusapujärjestelmä/Romeo 20 / 20