OpusCapitaTYVI asiakasjärjestelmäliittymä 2.2

Koko: px
Aloita esitys sivulta:

Download "OpusCapitaTYVI asiakasjärjestelmäliittymä 2.2"

Transkriptio

1 OpusCapita TYVI AJL 1 (28) OpusCapitaTYVI asiakasjärjestelmäliittymä 2.2 Tekninen kuvaus versio 1.6 OpusCapita Group Oy Postintaival 7 FI HELSINKI, FINLAND Tel Fax VAT FI

2 OpusCapita TYVI AJL 2 (28) Sisällysluettelo 1 Yleistä Termien selitykset Palvelun kutsuminen Paluuviesti Sanoman lähettäminen Sisäänkirjautuminen Autentikoinnin vastausviestin lukeminen Ilmoitettavan yrityksen lisääminen Tiedoston lähetys Tiedonsiirron paluuviestin lukeminen Saapuvan aineiston noutaminen Hakukomennon paluuviestin lukeminen Saapuvan aineiston tiedoston lataus Katso- ja Raksi-välilehdet Katso-kirjautuminen Katso-kirjautumisviestin lukeminen Katso- ja Raksi-välilehden listaaminen Katso- ja Raksi-välilehden listauksen vastauksen lukeminen Katso- ja Raksi-ilmoituksen lähettäminen Katso- ja Raksi-ilmoituksen lähetyksen vastauksen lukeminen PDF-kuitti PDF-kuittien listaus PDF-kuittien listauksen lukeminen PDF-kuitin lataus PDF-kuitin lukeminen Uloskirjautuminen palvelusta Vastausviesti ja yhteyden katkaisu Testaamiseen liittyviä huomioita Uudet ominaisuudet versiossa Viitteet Versiohistoria... 25

3 OpusCapita TYVI AJL 3 (28) 1 YLEISTÄ Tämä dokumentti kuvaa OpusCapitan ohjelmistotaloille tarjoaman HTTPS-protokollaa [1] käyttävän yleisen rajapinnan ohjelmistojen integrointiin OpusCapitaTYVI-palveluun. Rajapinta tarjoaa sovellusohjelmoijalle käsitteellisen sanomaversiosta tai tyypistä riippumattoman tiedonsiirtorajapinnan OpusCapitaTYVI- palvelun kautta viranomaisille. Rajapinta tarjoaa turvallisen ja yksinkertaisen tavan siirtää aineistoa TYVI-palveluun suoraan sovelluksesta ilman että käyttäjä joutuu tekemään manuaalisia toimenpiteitä. 2 TERMIEN SELITYKSET Termi TYVI OpusCapitaTYVI Lähetyskerta Sanoma 3 PALVELUN KUTSUMINEN Selitys Tietovirrat Yritysten ja Viranomaisten Välillä OpusCapita toteuttama TYVI-palvelu Kaikki saman lähetyksen aikana yhdellä tunnuksella lähetettävät tiedot. Lähetyskerta voi sisältää 0 n sanomaa. Lähetyskerran osa. Yksi yksittäinen ilmoitus yhdelle vastaanottajalle. Esimerkiksi yksi ilmoittavan yrityksen työnantajasuoritus Verohallintoon. Kutsut palveluun tehdään käyttämällä tiettyjä ennalta määriteltyjä URL:a [2]. URL (Uniform Resource Locator) on nimensä mukaisesti osoitin resursseihin. Se on merkkijono, joka kuvaa yksiselitteisesti palvelun (järjestelmä, palvelun nimi sekä palvelun versio) johon sanoma liittyy sekä komennon, joka määrittelee millaista kutsua palveluun ollaan tekemässä. Suurin osa URL:n tiedoista on kiinteitä eri lähetyskertojen välillä samaa palvelua käytettäessä, mutta komento riippuu siitä mitä kyseisellä hetkellä tehdään. Lähetettävään sanomaan liittyvä URL on muotoa: Konteksti sisältää palvelun sijainnin (koneen nimi tai osoite sekä portti). Palvelun looginen sijainti määrää myös käytetyn järjestelmän. URL:n osa iea on kiinteä merkkijono, joka kertoo vastaanottavalle järjestelmälle, että kyseessä on ohjelmistotaloliittymä (iea tulee sanoista Interface for External Applications). Palvelu ja versio kertovat käytetyn palvelun ja sen halutun version. Komento määrittelee mitä kyseisen kutsun halutaan tekevän. Mahdolliset komennot on lueteltu allaolevassa taulukossa:

4 OpusCapita TYVI AJL 4 (28) auth Komento transmit terminate query Kirjaudutaan sisään palveluun, paluuviestissä saadaan session tunniste, jota käytetään siirrettäessä aineistoa ja kirjauduttaessa ulos palvelusta. Siirretään aineisto palveluun, paluuviestissä saadaan sanomakohtainen tieto siirron onnistumisesta. Kirjaudutaan ulos palvelusta. Noudetaan erityyppistä aineistoa palvelusta (ei toteutettu draftversiossa) add_company Lisätään ilmoitettava yritys katso/login katso/list katso/send Aktivoidaan Katso-tiedot nykyiseen istuntoon. Mahdollistaa Katso- ja Raksi-välilehdillä olevien ilmoitusten lähettämisen 10 minuutin aikaikkunan aikana. Tämän jälkeen tunnistautuminen Katsoon on tehtävä uudestaan. Listaa Katso-ja Raksi-välilehtien sisältämät ilmoitukset (ilmoitukset, joiden lähettämiseen vaaditaan Katso-tunnus) Lähettää halutun ilmoituksen eteenpäin Katso-tunnuksella Esimerkki: Tehdään kutsu OpusCapita TYVI-palveluun rajapintaversiolla 2.1. Kyseessä tunnistautuminen. Itse autentikointitiedot lähetetään POST-datassa eivätkä ne näy URL:ssa 4 PALUUVIESTI Lähetykseen liittyvä paluuviesti on XML-sanoma [3], jossa kerrotaan tilakoodin avulla lähetyksen onnistumisesta, viitataan lähetyksen sessiotunnisteeseen ja kerrotaan tarvittaessa sanomakohtaisesti vastaanottokuittaus tai mahdollinen virheilmoitus lähetetyistä tiedoista. Paluuviestin merkistö on UTF-8. Paluuviestin XML Schema [4] on esitetty liitteessä 1. Esimerkkejä erilaisista paluuviesteistä on kappaleessa 5. Oheisessa taulukossa on käytössä olevat tilakoodit ja niiden mukana palautuvat selitteet. Tilakoodi teksti Tarkennus 0 OK Pyyntö palveluun on onnistunut. 100 Authentication failure Annettu käyttäjätunnus tai salasana on väärä. Tarkista käyttäjätunnus ja salasana. Ota tarvittaessa yhteys helpdeskiin. 101 No active session Session tunniste ei ole oikea tai sessio on jo vanhentunut. 102 No command verb in url Palvelimelle on lähetetty pyyntö, jossa ei ole komentoosaa. 103 Internal Server Error Määrittelemätön virhetilanne palvelussa. Tilanne on luonteeltaan sellainen, että palvelu ei ole osannut käsitellä virhettä. 104 Transfer format error Lähetyssä aineiston esitystavassa on virhe ts. tiedon esitysmuoto on epävalidi. Virhe tulee myös silloin jos

5 OpusCapita TYVI AJL 5 (28) kyseisellä tunnuksella ei ole sallittua lähettää tällaista aineistoa. 105 Transfer content error Aineiston tietosisältö on virheellinen. 106 No data transmitted Varsinainen tietosisältö puuttuu kokonaan. 107 Transmitted data contained extraneous Ylimääräisiä rivejä sanoman lopussa lines No rights to send forms of this type Unknown or unsupported query type Invalid parameters for query 111 Duplicate file transferred 112 Unsupported protocol version 113 Authentication redirected 114 Katso ID is needed Kirjautuneella asiakkaalla ei ole oikeutta lähettää kyseistä aineistotyyppiä. Parametrin type arvo on joko tuntematon tai käyttäjällä ei ole oikeutta noutaa tyypin mukaista aineistoa Joku query-komennon parametreista on väärä tai vaihtoehtoisesti joku pakollinen parametri puuttuu. Tiedostosiirrossa on havaittu identtisen tiedoston aikaisempi siirtäminen. Asiakasohjelmiston ehdottamaa protokollaversiota ei tueta (uusi 2.1:ssä.) Sisäänkirjautuminen ei ole mahdollista tässä osoitteessa. Asiakasohjelmiston tulee käyttää kentässä <use-base> olevaa järjestelmän URL:a ja yrittää uudelleen. (uusi 2.1:ssä) Katso/send-käskyllä lähetetty ilmoitus vaatii Katsoistunnon. Istunto oli joko vanhentunut tai Katsotunnuksella ei ole riittäviä oikeuksia ilmoituksen lähettämiseen. 5 SANOMAN LÄHETTÄMINEN Lähetys tapahtuu käyttämällä HTTPS-protokollaa lomakepohjaiseen lähetykseen. Lähetys on luonteeltaan hyvin yksinkertainen. Lähetykseen liittyy tietty URL, jonka perusosa ( kertoo suoraan käytetyn protokollan, autentikointitiedot, palvelimen sekä portin. URL:n absoluuttinen polkuosa (perusosan jälkeinen osa mukaan lukien ensimmäinen kauttamerkki sekä kaikki parametrit) kuvaa lähetyksen palvelimen sisällä. Lähetys voidaan jakaa seuraaviin osiin: 1. Sisäänkirjautuminen palveluun. Kirjautumiseen tarvittavat tiedot välitetään POST-metodilla. 2. Sisäänkirjautumisen vastausviestin lukeminen. Luetaan ja tarkastetaan palvelimen lähettämä tilakoodi, session tunniste ja muu mahdollinen informaatio. Jos vastausviestissä ilmoitetaan, että sisäänkirjautuminen tulee tehdä toisessa osoitteessa, hypätään takaisin kohtaan 1 käyttäen annettua osoitetta. 3. Tiedoston lähetys. Lähetetään tiedosto POST-metodilla 4. Tiedonsiirron vastausviestin lukeminen. Luetaan ja tarkastetaan HTTP-palvelimen lähettämä siirron tilakoodi ja mahdollinen muu viestissä tuleva informaatio.

6 OpusCapita TYVI AJL 6 (28) 5. Mahdollisten palvelussa olevien tiedostojen noutaminen. Kerrotaan HTTPS-POSTkomennolla mitä halutaan noutaa ja samalla voidaan antaa joitain rajaavia hakuehtoja nuodettaville tiedostoille. 6. Tiedoston noutoon tarkoitettuun pyyntöön palautetaan paluuviesti, jossa on osoitin itse noudettavaan tiedostoon. Luetaan paluuviesti ja siellä oleva osoitin itse noudettavaan tiedostoon. 7. Noudetaan itse tiedosto käyttämällä paluuviestissä saatua osoitinta. Kyse on normaalista tiedostonlatauksesta HTTPS-palvelimelta. 8. Uloskirjautuminen palvelusta. Kirjaudutaan ulos ja suljetaan sessio eksplisiittisesti ennen yhteyden sulkemista. 9. Vastausviestin lukeminen. Luetaan palvelimen lähettämä tilakoodi ja tarkastetaan, että uloskirjautuminen onnistui. 5.1 Sisäänkirjautuminen Pyyntö lähetetään URL:n, jossa komento on auth, esimerkiksi Kutsulle voi antaa parametreina seuraavat tiedot: Pakolliset parametrit: username password software Vapaaehtoiset parametrit: protocol-version käyttäjätunnus OpusCapita TYVIpalveluun salasana OpusCapita TYVI-palveluun kirjautuvan ohjelmiston nimi ja versio Pyytää palvelinta käyttämään annettua protokollaversiota (2.0, 2.1 tai 2.2) force-redirect Ei-nolla arvo (esim 1 tai "yes") pyytää palvelinta antamaan vastauskoodin 113 "Authentication redirected" kirjautumiseen, joko asiakasohjelmiston testausta tai järjestelmän URL:n verifiointia varten. Parametrilla software on tarkoitus kertoa mikä ohjelmisto ja sen versio on kyseessä samaan tyyliin kuin www-selain lähettää www-palvelimelle user-agent parametrilla tiedon siitä mikä selain ja sen versio on kyseessä. Suositeltava muoto software parametrin arvoksi on <ohjelmisto> <versiotieto>. Esimerkiksi OpusCapitan testiohjelman tapauksessa: ElmaIEA C# DEMO $Revision: 1.6 $

7 OpusCapita TYVI AJL 7 (28) Esimerkki: autentikointi palvelimelle käyttäjänä user123 POST /ec/tyvi-r5/p/iea/auth HTTP/1.1 Host: Content-type: multipart/form-data; boundary=boundary-string-should-not-appear-in-data Content-length: 366 Content-Disposition: form-data; name="username" user123 Content-Disposition: form-data; name="password" passwd1234 Content-Disposition: form-data; name="software" ElmaIEA C# DEMO $Revision: 1.6 $ -- Huomaa, että merkkijono Boundary-string-should-not-appear-in-data on ainoastaan esimerkinomainen MIME Multipart-sanoman erotin [5] [6]. Merkkijonon tulisi olla satunnainen generoitu merkkijono, jonka sisältö on sellainen ettei sitä esiinny itse sanomalla. Esimerkkiohjelmistossa on tämä osuus toteutettu lisäämällä kiinteä merkkijono, jota ei esiinny itse sanomalla. Lisäksi kannattaa kiinnittää huomiota erottimen yhteydessä oleviin aloitus- ja lopetusmerkkeihin. Jokainen erotinmerkki alkaa kahdella viivalla -- ja viimeinen erotin päättyy lopetusmerkkiin, joka on myöskin kaksi viivaa --. Välissä olevien erottimien lopussa ei ole viivoja. 5.2 Autentikoinnin vastausviestin lukeminen Palvelu palauttaa paluuviestissä paluukoodin <status>-elementin id-attribuutin arvona, ja sessiotunnisteen <session>-elementissä. Paluukoodi on joko 0 kirjautumisen onnistuessa, 100 kirjautumisen epäonnistuessa tai 103 (Internal Server Error) jos kirjautumisen yhteydessä on tapahtunut virhetilanne, jota palvelu ei ole osannut käsitellä oikein. Kun käytetään protokollaversiota 2.1 tai suurempaa, vastaussanomassa voi olla elementti <usebase>. Tämän sisältö on järjestelmän URL:n perusosa, jota asiakasohjelmiston pitää käyttää istunnon seuraavissa pyynnöissä. <use-base> voi esiintyä kaikissa järjestelmän tuottamissa vastaussanomissa, myös muissa toiminteissa kuin sisäänkirjautumisessa. Esimerkki: paluuviestin sisältö onnistuneen kirjautumisen jälkeen: HTTP/ OK Transfer-Encoding: chunked Content-Type: text/xml b4 <?xml version="1.0" encoding="utf-8"?> <iea-response xmlns=" <status id="0">ok</status> <session>aqsyoakgkljpxn3</session>

8 OpusCapita TYVI AJL 8 (28) <use-base> </iea-response> 0 Esimerkki: epäonnistunut kirjautuminen palveluun: HTTP/ OK Transfer-Encoding: chunked Content-Type: text/xml b4 <?xml version="1.0" encoding="utf-8"?> <iea-response xmlns=" <status id="100">authentication failure</status> </iea-response> Ilmoitettavan yrityksen lisääminen Jotta yritykselle voidaan tehdä ilmoitus, on kyseinen yritys lisättä ilmoitettavien listaan. Pakolliset parametrit s company_name company_id sessiotunniste lisättävän ilmoitettavan yrityksen/henkilön nimi lisättävän ilmoitettavan yrityksen y-tunnus tai henkilön henkilötunnus Esimerkki: POST /ec/tyvi-r5/p/iea/add_company HTTP/1.1 Host: Content-type: multipart/form-data; boundary=boundary-string-should-not-appear-in-data Content-length: 373 Content-Disposition: form-data; name="s" aqsyoakgkljpxn3 Content-Disposition: form-data; name="company_name" Testi Asiakas Content-Disposition: form-data; name="company_id"

9 OpusCapita TYVI AJL 9 (28) Vastausviesti on yksinkertaisesti ok tai virhe (ei kerättäviä tietoja varsinaisesti). Mikäli ilmoitettava yritys löytyy jo listalta, annetaan virhe Duplicate file transferred. Mikäli annettu company_id ei ole hetu tai y-tunnus, annetaan virhe Invalid parameters for query. Mikäli käyttäjällä ei ole oikeutta lisätä ilmoitettavaa, annetaan virhe No rights to send forms of this type. 5.4 Tiedoston lähetys Pyyntö lähetetään URL:n, jossa komento on transmit. esimerkiksi Kutsulle voi antaa parametreina seuraavat tiedot: Pakolliset parametrit: s records Vapaaehtoiset parametrit: test sessiotunniste itse lähetettävä lähetyskerta ts. lähetettävät sanomat saa aina arvon 1, tätä parametria ei anneta ollenkaan jos kyseessä on tuotantolähetys. Huomatkaa, että testiparametria käytettäessä, aineistoa ei tallenneta kantaan ollenkaan. Esimerkki: Tiedonsiirto. Verohallinnolle menevä vuosi-ilmoitus. Palkansaajakohtainen erittely. Kirjautumisen yhteydessä on saatu URL: POST /a/iea/transmit HTTP/1.1 Host: Content-type: multipart/form-data; boundary=boundary-string-should-not-appear-in-data Content-length: 577 Content-Disposition: form-data; name="s" aqsyoakgkljpxn3 -- Content-Disposition: form-data; name="test" 1 Content-Disposition: form-data; name="records"; filename="tyvi-data.txt" Content-Type: application/octet-stream 000:VSPSERIE

10 OpusCapita TYVI AJL 10 (28) 101:0 110:P 109: : :1 111: XX1X 115: : : : : : :1 146:1 150: :1 999:1 -- Huomiotavaa on, että lähetettävän sanoman tyyppiä ei kerrota lähetyksessä. Se päätellään lähetettävästä sanomasta. Jos sanomaa ei tunnisteta, palautetaan virheilmoitus. Aineistoa lähetettäessä kannattaa kirjautuneen käyttäjän koko lähetyskerta lähettää yhdellä transmit-kutsulla. Palvelu pystyy erottelemaan ja käsittelemään sanomalajista ja vastaanottajasta riippumatta kaikki samassa lähetyskerrassa tulleet sanomat, joten lähettävässä päässä ei ole tarvetta pilkkoa niitä useiksi lähetyksiksi. 5.5 Tiedonsiirron paluuviestin lukeminen Paluuviesti pitää sisällään vähintään paluukoodin <status>- elementin id-attribuutin arvona, session <session>-elementissä ja sanomakohtaisen kuittauksen siirretyistä sanomista <transfer>-elementin alla <record>-elementeissä. Esimerkki: Paluuviesti onnistuneesta tiedonsiirrosta testimoodissa versiossa 2.1 tai aiempi: HTTP/ OK Transfer-Encoding: chunked Content-type: text/xml 110 <?xml version="1.0" encoding="utf-8"?> <iea-response xmlns=" <status id="0">ok</status> <session>aqsyoakgkljpxn3</session> <use-base> <transfer mode="test"> <record num="1"> <type id= vheritp >Palkansaajakohtainen erittely</type> </record> </transfer> </iea-response> 0

11 OpusCapita TYVI AJL 11 (28) Esimerkki: Paluuviesti onnistuneesta tiedonsiirrosta testimoodissa versiossa 2.2: HTTP/ OK Transfer-Encoding: chunked Content-type: text/xml 110 <?xml version="1.0" encoding="utf-8"?> <iea-response xmlns=" <status id="0">ok</status> <session>aqsyoakgkljpxn3</session> <use-base> <transfer mode="test"> <record num="1"> <type id= vheritp >Palkansaajakohtainen erittely</type> <message_id> </message_id> </record> </transfer> </iea-response> Erona aiempiin versioihin, on paluusanomassa message_id -tieto, jonka avulla voidaan kohdentaa lähetetty ilmoitus välittömästi Tyvin oikeaan ilmoitusnumeroon katso/sendkäskyä varten. Jos sanomalla on ollut virheitä, tulee <record>-elementin sisällä myös sanomakohtainen virheilmoitus. Virheilmoitus palautetaan <error>-elementissä. Elementin <record> numattribuutti kertoo kyseisen sanoman järjestysnumeron siirtovaiheessa. Esimerkki: Paluuviesti virheellisestä tiedonsiirrosta testimoodissa TYVI-VAHTI-palveluun: HTTP/ OK Transfer-Encoding: chunked Content-type: text/xml 110 <?xml version="1.0" encoding="utf-8"?> <iea-response xmlns=" <status id="105">transfer content error</status> <session>kq2ivnllejtou7x</session> <use-base> <transfer mode="test"> <record num="1"> <type id= ym_tuotanto >Tuotanto</type> </record> <record num="2"> <type id= ym_jatevesi >Veteen johdetut paastot</type> <error id="105">no customer number</error> </record> <record num="3"> <type id= ym_ilmaanjohd > Ilmaan johdetut jatteet</type> <error id="105">invalid parameter: 369</error> </record> <record num="4"> <type id= ym_ilmaanjohd >Ilmaan johdetut jatteet</type> <error id="105">invalid parameter: 369</error>

12 OpusCapita TYVI AJL 12 (28) </record> <record num="5"> <type id= ym_perustied >Perustiedot</type> </record> </transfer> </iea-response> Saapuvan aineiston noutaminen Tiedoston nouto on kaksiosainen tapahtuma. Ensin tehdään palveluun pyyntö, jolla määritellään mitä halutaan noutaa. Sen jälkeen paluuviestissä olleen viitteen avulla noudetaan itse aineisto toisella pyynnöllä. Aineisto merkitään noudetuksi vasta kun se on todellisuudessa haettu. Tiedoston nouto aloitetaan tekemällä pyyntö URL:n, jonka komento osa on query, esimerkiksi Kutsulle voi antaa parametreina seuraavat tiedot: Pakolliset parametrit: S Type Year Vapaaehtoiset parametrit: Bid New Sessiotunniste Tyyppi määrittelee mitä aineistoa halutaan hakea. Esimerkiksi VK_VAST määrittelee, että haetaan verokorttien suorasiirtopyyntöjen vastauksia. Määrittelee minkä vuoden aineistoa haetaan (pakollinen jos type = VK_VAST). Y-tunnus. Määrittelee minkä yrityksen tietoja ollaan hakemassa. Jos tätä ei anneta, haetaan kaikkien yritysten tiedot, joihin hakijalla on oikeus. Saa aina arvon 0. Määritellään haetaanko myös jo kerran haetuksi merkityt aineistot. Oletus on, että haetaan vain uudet ja tällöin koko parametri kuuluu jättää pois. Esimerkki: Query-komento, jolla haetaan vuoden 2004 verokortteja. Kirjautumisen yhteydessä on saatu URL: POST /ec/tyvi-r5/p/iea/query HTTP/1.1 Host: Content-type: multipart/form-data; boundary=boundary-string-should-not-appear-in-data Content-length: 345

13 OpusCapita TYVI AJL 13 (28) Content-Disposition: form-data; name="s" aqsyoakgkljpxn3 Content-Disposition: form-data; name="type" vk_vast Content-Disposition: form-data; name="year" 2004 Content-Disposition: form-data; name="bid" Hakukomennon paluuviestin lukeminen Paluuviesti pitää sisällään paluukoodin <status>- elementin id-attribuutin arvona ja viitteen ladattavaan aineistoon <query>-elementin alla <download-token>-elementeissä. Lisäksi sanomalla tulee tieto ladattavien sanomien määrästä <query> -elementin results - attribuutin arvona. Esimerkki: Paluuviesti, jossa kerrotaan, että Verokortin suorasiirron vastauksia 12 kappaletta noudettavana. HTTP/ OK Transfer-Encoding: chunked Content-type: text/xml 110 <?xml version="1.0" encoding="utf-8"?> <iea-response xmlns=" <status id="0">ok</status> <use-base> <query results="12"> <type id="vk_vast" count="12">verokortin vastaus</type> <download-token>7</download-token> </query> </iea-response> Saapuvan aineiston tiedoston lataus Kun aineistoon on saatu viite query -komennolla voidaan aineisto lopuksi noutaa laittamalla pyyntö URL:n, jonka komento-osa on download, esimerkiksi Kutsulle voi antaa parametreina seuraavat tiedot:

14 OpusCapita TYVI AJL 14 (28) Pakolliset parametrit: s token Sessiotunniste Query-komennon vastauksena saatu tiedostoviite ts. <download-token> - elementin sisältö. Esimerkki: Download -komento POST /ec/tyvi-r5/p/iea/download HTTP/1.1 Host: Content-type: multipart/form-data; boundary=boundary-string-should-not-appear-in-data Content-length: 123 Content-Disposition: form-data; name="s" aqsyoakgkljpxn3 Content-Disposition: form-data; name="token" 7 -- Kutsun vastaus pitää sisällään aina kaikki vastaussanomat ja noudattaa kulloisenkin sanoman määrityksiä. Esimerkiksi verokorttien vastaussanomat ovat Verohallinnon määrittelemää rivipohjaista dataa, jossa rivierottimena on merkki #10 ns. unix-rivinvaihto. 5.7 Katso- ja Raksi-välilehdet Katso-kirjautuminen Jotta Katso-välilehdellä olevia ilmoituksia (TVR, Vero, Tulli) voi lähettää, tulee sessiossa olla tieto hyväksytystä Katso-kirjautumisesta. Tyvin ilmoituksista OTP-tunnistautumisen vaativia ilmoituksia ovat kausiveroilmoituikset sekä tuloveroilmoitukset. Näistä Katsovälilehden kautta voi lähettää vain kausiveroilmoituksia. Muille Katsoa vaativille ilmoituksille PWD on riittävä tunnistautumistaso. Pakolliset parametrit: s Sessiotunniste username Katso-kirjautumistunnus, normaalisti 6 merkkiä, esim. d27ri2. password logintype Katso-tunnuksen salasana. Joko PWD tai OTP. Jos OTP, pitää myös parametri otp antaa.

15 OpusCapita TYVI AJL 15 (28) Vapaaehtoiset parametrit: otp logintype ollessa OTP, seuraava käyttämättömän OTP-salasana OTPlistalta. Vaaditaan Veron kausiveroilmoituksien lähettämiseen. Esimerkki: Katso-kirjautumiskomento POST /ec/tyvi-r5/p/iea/katso/login HTTP/1.1 Host: Content-type: multipart/form-data; boundary=boundary-string-should-not-appear-in-data Content-length: 521 Content-Disposition: form-data; name="s" aqsyoakgkljpxn3 Content-Disposition: form-data; name="username" d27ri2 Content-Disposition: form-data; name="password" katsosalasana Content-Disposition: form-data; name="logintype" OTP Content-Disposition: form-data; name="otp" Katso-kirjautumisviestin lukeminen Vastaus kertoo, kuka on kirjautunut Katsolla sovellukseen sekä milloin tunnistautuminen menee vanhaksi (deadline). Deadline ilmoitetaan GMT-aikana ja on voimassa 10 minuuttia kerrallaan. Esimerkkivastaus: HTTP/ OK Transfer-Encoding: chunked Content-type: text/xml <?xml version="1.0" encoding="utf-8"?> <iea-response xmlns=" <status id="0">ok</status> <session> aqsyoakgkljpxn3</session>

16 OpusCapita TYVI AJL 16 (28) <use-base> <deadline> t05:04:32.740z</deadline> <kid>d27ri2</kid> <version>katso-1.1</version> <personname>test Person </personname> <accountexpiring>false</accountexpiring> </iea-response> Virhetilanteessa, jossa on OTP-avainluku mukana, on vastaus muotoa <?xml version="1.0" encoding="utf-8"?> <iea-response xmlns=" <status id="100">authentication failure</status> <session> aqsyoakgkljpxn3</session> <use-base> <accountexpiring>false</accountexpiring> <nextotpcode>154</nextotpcode> </iea-response> Vastaus kertoo seuraavan vaaditun OTP-avaimen numeron kentässä nextotpcode Katso- ja Raksi-välilehden listaaminen Vastaavantyylinen komento kuin query, mutta hakee kaikki Katso- ja Raksi-välilehdellä olevat ilmoitukset. Pakolliset parametrit: s sessiotunniste Esimerkki: Katso-välilehden listaaminen: POST /ec/tyvi-r5/p/iea/katso/list HTTP/1.1 Host: Content-type: multipart/form-data; boundary=boundary-string-should-not-appear-in-data Content-length: 149 Content-Disposition: form-data; name="s" aqsyoakgkljpxn Katso- ja Raksi-välilehden listauksen vastauksen lukeminen Vastaus kertoo lomakkeen tunnisteen (message_id), itse lomakkeen tyypin (form), ilmoitettavan yrityksen y-tunnuksen (identifier) sekä nimen (common_name) ja mille ajalle ilmoitus kohdistuu (period). Esimerkkivastaus:

17 OpusCapita TYVI AJL 17 (28) HTTP/ OK Transfer-Encoding: chunked Content-type: text/xml <?xml version="1.0" encoding="utf-8"?> <iea-response xmlns=" <status id="0">ok</status> <session> aqsyoakgkljpxn3</session> <use-base> <forms> <form> <message_id>12345</message_id> <form>veroraksi.vsurakka</form> <identifier> </identifier> <common_name>test Company</common_name> <period> </period> </form> </forms> </iea-response> Katso- ja Raksi-ilmoituksen lähettäminen Tapahtuu ilmoittamalla message_id parametri katso/send-toiminnolle. Pakolliset parametrit: s message_id sessiotunniste Lähetettävän viestin tunniste, saatu katso/list-toiminnosta. Esimerkki: Raksi-ilmoituksen lähettäminen POST /ec/tyvi-r5/p/iea/katso/send HTTP/1.1 Host: Content-type: multipart/form-data; boundary=boundary-string-should-not-appear-in-data Content-length: 253 Content-Disposition: form-data; name="s" aqsyoakgkljpxn3 Content-Disposition: form-data; name="message_id

18 OpusCapita TYVI AJL 18 (28) Katso- ja Raksi-ilmoituksen lähetyksen vastauksen lukeminen Onnistunut lähetys tuottaa paluuviestin, jossa status_id=0 (OK). Raksi-ilmoituksissa tulee vielä ilmoituksen Veron puolen tunniste kentässä s807. Kyseistä tunnistetta tulee käyttää mm. kyseisen lomakkeen korjausilmoituksissa. Katso-välilehteä käyttävät ilmoitukset (ei Raksi-ilmoitukset) eivät sisällä tätä kenttää. Esimerkkivastaus: HTTP/ OK Transfer-Encoding: chunked Content-type: text/xml <?xml version="1.0" encoding="utf-8"?> <iea-response xmlns=" <status id="0">ok</status> <session> aqsyoakgkljpxn3</session> <use-base> <message_id>12345</message_id> <s087>v </s087> </iea-response> 5.8 PDF-kuitti Lähetetyistä ilmoituksista on mahdollista ladata PDF-muotoinen kuitti. Lähetetyt ilmoitukset listataan pdf/list-komennolla, jonka vastauksesta saatavalla message_id-tunnisteella voi ladata kuitin käyttämällä pdf/download-komentoa PDF-kuittien listaus Pakolliset parametrit: s bid Sessiotunniste Y-tunnus. Määrittelee minkä yrityksen tiedot haetaan. Esimerkki: POST /ec/tyvi-r5/p/iea/pdf/list/ HTTP/1.1 Host: Content-Length: 237 Content-Type: multipart/form-data; boundary=boundary-string-should-not-appear-in-data Content-Disposition: form-data; name="s" h9fi5uqrip0twrf Content-Disposition: form-data; name="bid"

19 OpusCapita TYVI AJL 19 (28) PDF-kuittien listauksen lukeminen Vastaus kertoo lomakkeen tunnisteen (message_id), itse lomakkeen tyypin (form), ilmoitettavan yrityksen nimen (common_name), mille ajalle ilmoitus kohdistuu (period) ja lähetysajan (deliver_time). Esimerkkivastaus: HTTP/ OK Transfer-Encoding: chunked Content-Type: text/xml <?xml version="1.0" encoding="utf-8"?> <iea-response xmlns=" <status id="0">ok</status> <session>h9fi5uqrip0twrf</session> <use-base> <pdfs> <pdf> <message_id>12345</message_id> <form>verovuosi.vheritp</form> <common_name>test Company</common_name> <period>2015</period> <deliver_time> :14: </deliver_time> </pdf> <pdf> <message_id>12346</message_id> <form>verovuosi.vheritp</form> <common_name>test Company</common_name> <period>2015</period> <deliver_time> :15: </deliver_time> </pdf> </pdfs> </iea-response> PDF-kuitin lataus Pakolliset parametrit: s message_id Sessiotunniste Lähetettävän viestin tunniste, saatu pdf/list-toiminnosta. Esimerkki: POST /ec/tyvi-r5/p/iea/pdf/download/ HTTP/1.1 Host: Content-Length: 240 Content-Type: multipart/form-data; boundary=boundary-string-should-not-appear-in-data

20 OpusCapita TYVI AJL 20 (28) Content-Disposition: form-data; name="s" h9fi5uqrip0twrf Content-Disposition: form-data; name="message_id" PDF-kuitin lukeminen Vastauksena tulee <pdffile>-elementti, jolla on status-attribuutti, joka on joko ok, delayed tai in_progress. Jos status on ok, pdffile-elementin alla on <content>-elementti, joka sisältää ladattavan tiedoston ja <filename>-elementti, joka sisältää tallentamiseen käytettäväksi sopivan tiedostonimen. Tiedosto on Base64-koodattu PDF. Jos statusattribuutti on queued, kuittitiedoston luonti suoritetaan taustalla sen suuren koon vuoksi ja tällöin tiedosto on ladattavissa kun tiedosto on valmis, eli yleensä 10 minuutin kuluessa. Jos kuittia yritetään tämän jälkeen ladata ennen kuin se on valmistunut, status on in_progress. Esimerkkivastaus: HTTP/ OK Transfer-Encoding: chunked Content-Type: text/xml <iea-response xmlns=" <status id="0">ok</status> <session> h9fi5uqrip0twrf</session> <use-base> <pdffile status= ok > <content>jvberi0xljqkmsawig9iago8paovvgl0bgugkp7/ae8acab1ahmaqwb hahaaaqb0ageaiabuafka JUVPRgo= </content> <filename> _palkansaajakohtainen_yhteenveto_ja_erittely.pdf</filename> </pdffile> </iea-response> 5.9 Uloskirjautuminen palvelusta Sessio tulee sulkea tiedonsiirron lopuksi. Sulkeminen tapahtuu tekemällä pyyntö URL:n, jonka komento-osa on terminate, esimerkiksi Kutsulle voi antaa parametreina seuraavat tiedot: Pakolliset parametrit: s sessiotunniste

21 OpusCapita TYVI AJL 21 (28) Esimerkki: Uloskirjautuminen palvelusta POST /ec/tyvi-r5/p/iea/terminate HTTP/1.1 Host: Content-type: multipart/form-data; boundary=boundary-string-should-not-appear-in-data Content-length: 157 Content-Disposition: form-data; name="s" aqsyoakgkljpxn Vastausviesti ja yhteyden katkaisu Tämän jälkeen vastausviesti voidaan lukea ulkoskirjautumisesta. 6 TESTAAMISEEN LIITTYVIÄ HUOMIOITA Lähdettäessä kehittämään ja testaamaan integrointikoodia OpusCapita TYVI-palvelua vasten, seuraavat asiat tulisi huomioida. 1. Testaamiseen tarvitsette OpusCapita TYVI-testitunnuksen ja salasanan. Jos teillä ei ole tunnuksia, ottakaa yhteys OpusCapitan Service Deskiin 2. Palvelua testataan OpusCapita TYVI-tuotantopalvelimella testitunnuksin. Vaikka palvelu on tuotanto-palvelu, mikään aineisto ei siirry oikeasti eteenpäin, koska tunnukset ovat palvelussa testistatuksella. 3. Itse lähetettävän aineiston oikeellisuus kannattaa testata ennen kuin aineistoa yrittää lähettää ohjelmistointegraatiokoodilla. Hyvin usein ongelmana on joko se, että data on epävalidia tai sitä ei voi lähettää kyseiselle testitunnuksella ollenkaan. Nämä asiat on syytä tarkastaa ennen kuin testaus oman koodin kanssa aloitetaan. 4. Tyypillisesti ohjelmistotalolle annetulla testitunnuksella voi ilmoittaa ainoastaan yhden yrityksen tietoja. Tämä yritys on testaava yritys ts. ohjelmistotalo itse. Y- tunnus testiaineistossa tulisi siis olla testitunnuksen omaavan yrityksen oma y- tunnus. 5. Kun testiaineisto on oikeanlaista, kannattaa sen lähettämistä testata seuraavaksi curl-ohjelman avulla esim. curl --insecure -d "username=testitunnus&password=salasana&software=test" 6. Tämän jälkeen kannattaa aloittaa testaaminen omalla sovelluksella. Jos kehityksen ja testauksen aikana tulee ongelmia, niistä kannattaa ilmoittaa OpusCapitan Service Deskiin. Mukaan tulisi liittää mieluusti lyhyt ongelman kuvaus, testattava aineisto sekä tuloste tehdystä pyynnöstä ja palvelun antamasta vastauksesta sekä

22 OpusCapita TYVI AJL 22 (28) testausajankohdasta. Testauksen tukipalvelu on maksullista ja siitä veloitetaan tuntityöperusteisesti voimassa olevan hinnaston mukaisesti.

23 OpusCapita TYVI AJL 23 (28) 7 UUDET OMINAISUUDET VERSIOSSA o pdf/list ja pdf/download käskyt lisätty. Käskyt dokumentoitu kappalessa Version 2.2 muutokset o Vastaussanoman XML-nimiavaruus riippuu käytetystä protokollaversiosta seuraavasti: = = o = Transmit-käskyn paluusanomaan lisätty message_id -elementti ilmoitukselle versiomuutokset (ei uutta protokollaversiota) o Katso/login, katso/list ja katso/send käskyt lisätty. Käskyjen myötä täysi tuki Katso-lähetykselle integraatiorajapinnan läpi. Käskyt dokumentoitu kappaleessa 5. o o o o Katso-id parametri poistettu vanhentuneena auth-käskyn parametrilistalta. Virhekoodia 114 muutettu vastaamaan nykyistä tarkoitusta. Lisätty add_company käsky. Päivitetty schema-kuvaus Edeltävät 2.1 muutokset o Sisäänkirjautumisessa on kaksi uutta vapaaehtoista parametriä force-redirect ja protocol-version, jotka on dokumentoitu kappaleessa 5. o Sisäänkirjautuminen voi johtaa redirektiin o Kaksi uuttaa virhekoodia 112 ja 113 on dokumentoitu kappaleessa 4. o Vastaussanomat voivat aina sisältää tagin <use-base> o Vastaussanoman XML-nimiavaruus riippuu käytetystä protokollaversiosta seuraavasti: = = o Versiossa 1.2 lisätty KATSO- tunnistautumiseen liittyvät osat.

24 OpusCapita TYVI AJL 24 (28) 1. Sisäänkirjautumisessa uusi vapaaehtoinen parametri katso-id, joka on dokumentoitu kappaleessa Yksi uusi virhekoodi 114 on dokumentoitu kappaleessa 4.

25 OpusCapita TYVI AJL 25 (28) 8 VIITTEET 1 HTTPS, RFC 2818, Network Working Group Request for Comments: 2818, Category: Informational, 2 URL, RFC 1738 (RFC1738), Network Working Group Request for Comments: 1738, Category: Standards Track, 3 XML, Extensible Markup Language (XML) 1.0 (Third Edition), W3C Recommendation 04 February 2004, 4 XML Schema, XML Schema Part 0: Primer Second Edition, W3C Recommendation 28 Octo-ber 2004, 5 MIME, RFC 1341 (RFC1341), Network Working Group Request for Comments: 1341, 6 MIME Multipart/Related Content Type, RFC 2112 (RFC2112), Network Working Group Re-quest for Comments: 2112, Obsoletes: 1872, Category: Standards Track, 9 VERSIOHISTORIA Versio Aika Muutos Edellinen ohjelmistotaloille suunnattu päivitys KATSO-toiminnallisuuden lisäys dokumentaatioon, kts. kappale Palvelun osoite päivitetty uuteen: Palvelun osoitteet päivitetty Lisätty katso/login, katso/list ja katso/send toiminnot. Poistettu vanhentunut viittaus katso-id kirjautumispolusta (p/iea/auth). Lisätty add_company-käsky Lisätty versio 2.2 (message_id transmit-käskyn paluusanomaan) ja schema versiolle Lisätty PDFkuittitoiminnallisuus, kts. kappale 7.

26 OpusCapita TYVI AJL 26 (28) Liite 1. Paluuviestin schema-kuvaus <?xml version="1.0" encoding="utf-8"?> <!-- IEA Schema $Revision: $ --> <xsd:schema xmlns:xsd=" xmlns:iea=" targetnamespace=" elementformdefault="qualified"> <xsd:element name="iea-response"> <xsd:complextype> <xsd:sequence> <xsd:element name="status" type="iea:statustype"/> <xsd:element name="session" type="xsd:string" minoccurs="0"/> <xsd:element name="terminated-session" type="xsd:string" minoccurs="0"/> <xsd:element name="use-base" type="xsd:string" minoccurs="0"/> <xsd:element name="transfer" type="iea:transfertype" minoccurs="0"/> <xsd:element name="query" type="iea:querytype" minoccurs="0"/> <!-- katso/list --> <xsd:element name="forms" type="iea:formstype" minoccurs="0"/> <!-- katso/login --> <xsd:element name="deadline" type="xsd:datetime" minoccurs="0"/> <xsd:element name="kid" type="xsd:string" minoccurs="0"/> <xsd:element name="version" type="xsd:string" minoccurs="0"/> <xsd:element name="personname" type="xsd:string" minoccurs="0"/> <xsd:element name="accountexpiring" type="xsd:boolean" minoccurs="0"/> <xsd:element name="nextotpcode" type="xsd:string" minoccurs="0"/> <!-- katso/send --> <xsd:element name="reason" type="xsd:string" minoccurs="0"/> <xsd:element name="info" type="xsd:string" minoccurs="0"/> <xsd:element name="errors" type="iea:errorstype" minoccurs="0"/> <xsd:element name="message_id" type="xsd:integer" minoccurs="0"/> <xsd:element name="s087" type="xsd:string" minoccurs="0"/> <xsd:element name="signature" type="xsd:string" minoccurs="0"/> <!-- pdf/list --> <xsd:element name="pdfs" type="iea:pdfstype" minoccurs="0"/> <!-- pdf/downlowd --> <xsd:element name="pdffile" type="iea:pdffiletype" minoccurs="0"/> </xsd:sequence> </xsd:complextype> </xsd:element> <xsd:complextype name="statustype"> <xsd:simplecontent> <xsd:extension base="xsd:string"> <xsd:attribute name="id" type="xsd:nonnegativeinteger" use="required"/> </xsd:extension> </xsd:simplecontent> </xsd:complextype> <xsd:complextype name="recordtypetype"> <xsd:simplecontent> <xsd:extension base="xsd:string"> <xsd:attribute name="id" type="xsd:string" use="required"/> </xsd:extension> </xsd:simplecontent> </xsd:complextype> <xsd:complextype name="transfertype"> <xsd:sequence> <xsd:element name="record" type="iea:transferrecordtype" minoccurs="0" maxoccurs="unbounded"/> </xsd:sequence> <xsd:attribute name="mode" type="iea:transfermodetype"/> </xsd:complextype> <xsd:complextype name="transferrecordtype"> <xsd:sequence> <xsd:element name="type" type="iea:recordtypetype"/> <xsd:element name="message_id" type="xsd:integer" minoccurs="0"/>

27 OpusCapita TYVI AJL 27 (28) <xsd:element name="error" type="iea:statustype" minoccurs="0"/> </xsd:sequence> <xsd:attribute name="num" type="xsd:positiveinteger" use="required"/> </xsd:complextype> <xsd:simpletype name="transfermodetype"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="test"/> </xsd:restriction> </xsd:simpletype> <xsd:complextype name="querytypetype"> <xsd:simplecontent> <xsd:extension base="xsd:string"> <xsd:attribute name="id" type="xsd:string" use="required"/> <xsd:attribute name="count" type="xsd:nonnegativeinteger" use="required"/> </xsd:extension> </xsd:simplecontent> </xsd:complextype> <xsd:complextype name="querytype"> <xsd:sequence> <xsd:element name="type" type="iea:querytypetype" minoccurs="0" maxoccurs="unbounded"/> <xsd:element name="download-token" type="xsd:string" minoccurs="0" maxoccurs="1"/> </xsd:sequence> <xsd:attribute name="results" type="xsd:nonnegativeinteger" use="required"/> </xsd:complextype> <xsd:complextype name="formstype"> <xsd:sequence> <xsd:element name="form" type="iea:formtype" minoccurs="0" maxoccurs="unbounded"/> </xsd:sequence> </xsd:complextype> <xsd:complextype name="formtype"> <xsd:sequence> <xsd:element name="message_id" type="xsd:integer"/> <xsd:element name="form" type="xsd:string"/> <xsd:element name="identifier" type="xsd:string"/> <xsd:element name="common_name" type="xsd:string"/> <xsd:element name="period" type="xsd:string"/> </xsd:sequence> </xsd:complextype> <xsd:complextype name="pdfstype"> <xsd:sequence> <xsd:element name="pdf" type="iea:pdftype" minoccurs="0" maxoccurs="unbounded"/> </xsd:sequence> </xsd:complextype> <xsd:complextype name="pdftype"> <xsd:sequence> <xsd:element name="message_id" type="xsd:integer"/> <xsd:element name="form" type="xsd:string"/> <xsd:element name="common_name" type="xsd:string"/> <xsd:element name="period" type="xsd:string"/> <xsd:element name="deliver_time" type="xsd:string"/> </xsd:sequence> </xsd:complextype> <xsd:complextype name="pdffiletype"> <xsd:sequence> <xsd:element name="content" type="xsd:string" minoccurs="0" maxoccurs="1"/> <xsd:element name="filename" type="xsd:string" minoccurs="0" maxoccurs="1"/> </xsd:sequence> <xsd:attribute name="pdfstatus" use="required"> <xsd:simpletype> <xsd:restriction base="xsd:string"> <xsd:enumeration value="ok"/> <xsd:enumeration value="delayed"/>

28 OpusCapita TYVI AJL 28 (28) <xsd:enumeration value="in_progress"/> </xsd:restriction> </xsd:simpletype> </xsd:attribute> </xsd:complextype> <xsd:complextype name="errorstype"> <xsd:sequence> <xsd:element name="error" type="iea:errortype" minoccurs="0" maxoccurs="unbounded"/> </xsd:sequence> </xsd:complextype> <xsd:complextype name="errortype"> <xsd:simplecontent> <xsd:extension base="xsd:string"> <xsd:attribute name="field" type="xsd:string"/> <xsd:attribute name="value" type="xsd:string"/> </xsd:extension> </xsd:simplecontent> </xsd:complextype> </xsd:schema>

OpusCapitaTYVI asiakasjärjestelmäliittymä 2.2

OpusCapitaTYVI asiakasjärjestelmäliittymä 2.2 OpusCapita TYVI AJL 1 (24) OpusCapitaTYVI asiakasjärjestelmäliittymä 2.2 Tekninen kuvaus versio 1.5 OpusCapita Group Oy Keilaranta 13 FI-02150 ESPOO, FINLAND Tel. +358 20 452 3000 Fax +358 20 452 9271

Lisätiedot

NELLI-Tunnis. Käyttäjän tunnistus NELLI-tiedonhakuportaalissa yleisissä kirjastoissa. Versio 1.0. 16.5.2006 Ere Maijala Kansalliskirjasto

NELLI-Tunnis. Käyttäjän tunnistus NELLI-tiedonhakuportaalissa yleisissä kirjastoissa. Versio 1.0. 16.5.2006 Ere Maijala Kansalliskirjasto NELLI-Tunnis Käyttäjän tunnistus NELLI-tiedonhakuportaalissa yleisissä kirjastoissa Versio 1.0 16.5.2006 Ere Maijala Kansalliskirjasto Sisällysluettelo Johdanto...3 Tekniikka...3 Esimerkit...4 XML-Skeema...5

Lisätiedot

Sosiaalihuollon asiakastiedon arkiston validointipalvelu. Käyttöohje

Sosiaalihuollon asiakastiedon arkiston validointipalvelu. Käyttöohje Sosiaalihuollon asiakastiedon arkiston validointipalvelu Käyttöohje Sisällys 1 Johdanto 3 2 Käyttötarkoitus 3 3 Palvelut 3 3.1 HL7 V3 Medical Records sanoman skeemavalidointi 3 3.2 HL7 V3 Medical Records

Lisätiedot

Sosiaalihuollon asiakastiedon arkiston validointipalvelu

Sosiaalihuollon asiakastiedon arkiston validointipalvelu Sosiaalihuollon asiakastiedon arkiston validointipalvelu Käyttöohje, 7.11.2017 Sisällys 1 Johdanto 3 2 Käyttötarkoitus 3 3 Palvelut 3 3.1 Käyttötapa 3 3.2 HL7 V3 Medical Records sanoman skeemavalidointi

Lisätiedot

Veronumero.fi Tarkastaja rajapinta

Veronumero.fi Tarkastaja rajapinta Suomen Tilaajavastuu Oy Veronumero.fi Tarkastaja rajapinta Rajapintakuvaus veronumeroiden tarkastamiseen ja henkilötietojen noutamiseen Suomen Tilaajavastuu Oy Muutoshistoria Päivämäärä Tekijä Muutos 11.2.2013

Lisätiedot

OnniSMS Rajapintakuvaus v1.1

OnniSMS Rajapintakuvaus v1.1 OnniSMS Rajapintakuvaus v1.1 1.0 Yleistä OnniSMS on HTTPS/XML pohjainen rajapinta tekstiviestin lähettämiseen. Palvelun käyttöön tarvitaan käyttäjätunnus, salasana ja palvelimen osoite, jotka saa tekemällä

Lisätiedot

Tekstiviestipalvelun rajapintakuvaus

Tekstiviestipalvelun rajapintakuvaus Tekstiviestipalvelun rajapintakuvaus Sisällysluettelo 1. Yleistä... 1 2. Lähtevien viestien rajapinta... 1 2.1. Rajapinnan tekniset tiedot ja parametrit... 1 2.2. Rajapinnan paluuarvot... 3 2.3. Rajapinnan

Lisätiedot

Suuli api dokumentaatio

Suuli api dokumentaatio Suuli api dokumentaatio Rajapinnan käyttöä varten tarvitset avaimen. Suulissa on käytössä kaksi rajapintaa: jäsen-, vene- ja venepaikkarajapinta sekä laskurajapinta. Näille on erilliset avaimet. Seuran

Lisätiedot

Tekninen kuvaus Aineistosiirrot Interaktiiviset yhteydet iftp-yhteydet

Tekninen kuvaus Aineistosiirrot Interaktiiviset yhteydet iftp-yhteydet Tekninen kuvaus Aineistosiirrot Interaktiiviset yhteydet iftp-yhteydet 15.11.2012 Sisällysluettelo 1 Johdanto... 3 1.2 Interaktiivinen FTP-yhteystapa... 3 1.3 Linkki aineistosiirtopalveluun liittyvät dokumentit...

Lisätiedot

K U U L A L A A K E R I LUOTTAMUKSELLINEN 1(6)

K U U L A L A A K E R I LUOTTAMUKSELLINEN 1(6) K U U L A L A A K E R I LUOTTAMUKSELLINEN 1(6) Messto HTTP API Messto HTTP API on sovelluskehittäjiä varten kehitetty helppo tapa toteuttaa tekstiviesti- ja multimediaviestisovelluksia. Rajapinnan avulla

Lisätiedot

Varmennepalvelu Rajapintakuvaus Tulorekisteriyksikkö

Varmennepalvelu Rajapintakuvaus Tulorekisteriyksikkö Versio 1.02 Varmennepalvelu Rajapintakuvaus Tulorekisteriyksikkö Varmennepalvelu Rajapintakuvaus 2 (15) Versiohistoria Versio Päivämäärä Kuvaus 1.0 30.10.2017 Dokumentti julkaistu. 1.01 15.12.2017 Dokumenttia

Lisätiedot

Tilaajavastuu.fi. Muutoshistoria. Suomen Tilaajavastuu Oy. Raporttinoutaja Rajapinta yritysten tilaajavastuutietojen tarkistamiseen

Tilaajavastuu.fi. Muutoshistoria. Suomen Tilaajavastuu Oy. Raporttinoutaja Rajapinta yritysten tilaajavastuutietojen tarkistamiseen Suomen Tilaajavastuu Oy Tilaajavastuu.fi Raporttinoutaja Rajapinta yritysten tilaajavastuutietojen tarkistamiseen Suomen Tilaajavastuu Oy Muutoshistoria Päivämäärä Tekijä Versio 21.11.2013 Sami Sinisalo

Lisätiedot

Varmennepalvelu Rajapintakuvaus Kansallisen tulorekisterin perustamishanke

Varmennepalvelu Rajapintakuvaus Kansallisen tulorekisterin perustamishanke Versio 1.0 Varmennepalvelu Rajapintakuvaus Kansallisen tulorekisterin perustamishanke Varmennepalvelu Rajapintakuvaus 2 (13) Versiohistoria Versio Päivämäärä Kuvaus 1.0 Dokumentti julkaistu. Varmennepalvelu

Lisätiedot

Uuden palvelun lisääminen liityntäpalvelimelle esuomi.fi

Uuden palvelun lisääminen liityntäpalvelimelle esuomi.fi Uuden palvelun lisääminen liityntäpalvelimelle esuomi.fi esuomi.fi/palveluntarjoajille/palveluvayla/tekninen-aineisto/konfigurointiohjeita/uuden-palvelun-lisaaminen-liityntapalvelimelle/ Suomi.fi-palveluväylä

Lisätiedot

sertifikaattiratkaisu Apitamopki

sertifikaattiratkaisu Apitamopki Ilmoitin.fi - tunnistamisen sertifikaattiratkaisu Apitamopki Web Services -rajapinnan muutokset Verohallinnon ja ohjelmistotalojen yhteistyöpäivä 23.5.2019 Esityksen sisällöstä Muutama sana varmenteista

Lisätiedot

Sähköpostitilin käyttöönotto

Sähköpostitilin käyttöönotto Sähköpostitilin käyttöönotto Versio 1.0 Jarno Parkkinen jarno@atflow.fi Sivu 1 / 16 1 Johdanto... 2 2 Thunderbird ohjelman lataus ja asennus... 3 3 Sähköpostitilin lisääminen ja käyttöönotto... 4 3.2 Tietojen

Lisätiedot

LoCCaM Riistakamerasovellus. Dimag Ky dimag.fi

LoCCaM Riistakamerasovellus. Dimag Ky dimag.fi LoCCaM Riistakamerasovellus Dimag Ky janne.koski @ dimag.fi +358505907788 Sovelluksen toimintaperiaate Toimintaperiaate yksinkertaistettuna on seuraavanlainen Kamera ottaa kuvan tai videon jonka lähettää

Lisätiedot

Tekninen dokumentti. TEKNINEN DOKUMENTTI Versio 4.4-1 29.9.2011 1 (24) Versio ja pvm Laatinut Tarkastanut Hyväksynyt.

Tekninen dokumentti. TEKNINEN DOKUMENTTI Versio 4.4-1 29.9.2011 1 (24) Versio ja pvm Laatinut Tarkastanut Hyväksynyt. 29.9.2011 1 (24) Tekninen dokumentti Metsäkeskusten sähköisten viestien (siirtotiedostojen) lähettäminen automaattisesti metsäkeskusten tiedonsiirtopalveluun ja palvelun palauteviestit Versio ja pvm Laatinut

Lisätiedot

VIRANOMAISEN PALUUKANAVA WS API. Suomi.fi-viestit julkinen rajapinta

VIRANOMAISEN PALUUKANAVA WS API. Suomi.fi-viestit julkinen rajapinta VIRANOMAISN PALUUANAVA Suomi.fi-viestit julkinen rajapinta V.01 RAJAPINTAUVAUS V 1.0 2 (9) DOUMNTINHALLINTA Omistaja Laatinut Lasse Pynnönen, VR Suomi.fi-viestit sovelluskehitystiimi Tarkastanut Hyväksynyt

Lisätiedot

EKP:N HANKINTAMENETTELYJEN VERKKOPALVELU OSALLISTUMINEN HANKINTAMENETTELYIHIN

EKP:N HANKINTAMENETTELYJEN VERKKOPALVELU OSALLISTUMINEN HANKINTAMENETTELYIHIN Taloushallinnon pääosasto ECB-UNRESTRICTED 8.11.2016 EKP:N HANKINTAMENETTELYJEN VERKKOPALVELU OSALLISTUMINEN HANKINTAMENETTELYIHIN Seuraavassa esitetään ohjeet pyydettyjen tietojen toimittamiseen EKP:n

Lisätiedot

Jos yritys tekee EU tavarakauppaa, käy tekemässä ennen käyttöönottoa myynnin perustiedoissa kerran seuraava toimenpide:

Jos yritys tekee EU tavarakauppaa, käy tekemässä ennen käyttöönottoa myynnin perustiedoissa kerran seuraava toimenpide: Uusi Alv-yhteenvetoilmoitus / käyttöönotto Myynnin perustiedot EU-tavarakaupan osalta Jos yritys tekee EU tavarakauppaa, käy tekemässä ennen käyttöönottoa myynnin perustiedoissa kerran seuraava toimenpide:

Lisätiedot

TEKNINEN MÄÄRITTELY. Matkahuollon osoitekorttihaun rajapinta. Ismo Koskinen

TEKNINEN MÄÄRITTELY. Matkahuollon osoitekorttihaun rajapinta. Ismo Koskinen TEKNINEN MÄÄRITTELY Matkahuollon osoitekorttihaun rajapinta Ismo Koskinen Versio 2.2 Päiväys 12.05.2014 Tekijä Ismo Koskinen MUUTOSHISTORIA Versio ja pvm Laatija Muutoksen kuvaus 1.0 / 07.07.2009 Ismo

Lisätiedot

Koodistopalvelun REST-rajapinnat

Koodistopalvelun REST-rajapinnat Koodistopalvelun REST-rajapinnat Yleiset tiedot Swagger Kuvaus Yhteiset kyselyparametrit (Query Parameters) Yhteiset otsikkoparametrit (HTTP Headers) Yhteiset vastauskoodit (HTTP Response Codes) Autentikointi

Lisätiedot

Käyttöohje Suomen Pankin DCS2-järjestelmään rekisteröityminen

Käyttöohje Suomen Pankin DCS2-järjestelmään rekisteröityminen 1 (13) Käyttöohje Suomen Pankin DCS2-järjestelmään rekisteröityminen 2 (13) Sisällysluettelo 1 Palveluun rekisteröityminen... 3 1.1 Henkilötiedot...4 1.2 Suomen Pankin tiedonkeruut... 5 1.2.1 Alustava

Lisätiedot

Poikkeusinfo XML-rajapinnan kuvaus, rajapinnan versio 2 Seasam Group

Poikkeusinfo XML-rajapinnan kuvaus, rajapinnan versio 2 Seasam Group 1.10.2010 1(15) Poikkeusinfo XML-rajapinnan kuvaus, rajapinnan versio 2 Seasam Group Graanintie 7 Tel. + 358 15 338 800 FIN-50190 MIKKELI Fax + 358 15 338 810 VERSIOHISTORIA Versio Pvm Tekijä Selite 1.0

Lisätiedot

Lemonsoft SaaS -pilvipalvelu OHJEET

Lemonsoft SaaS -pilvipalvelu OHJEET Lemonsoft SaaS -pilvipalvelu OHJEET Lemonsoft-käyttäjätunnukset Käyttäjätunnukset voit tilata suoraan omalta Lemonsoft-myyjältäsi tai Lemonsoftin asiakaspalvelun kautta. Käyttäjätunnusta tilatessasi ilmoitathan

Lisätiedot

OPUSCAPITA TYVI PALVELUKUVAUS. Versio 1.2. OpusCapita Group Oy Keilaranta 13 02150 Espoo FINLAND. Tel. +358 20 452 3000 Fax +358 20 452 9271

OPUSCAPITA TYVI PALVELUKUVAUS. Versio 1.2. OpusCapita Group Oy Keilaranta 13 02150 Espoo FINLAND. Tel. +358 20 452 3000 Fax +358 20 452 9271 Versio 1.2 OPUSCAPITA TYVI PALVELUKUVAUS OpusCapita Group Oy Keilaranta 13 02150 Espoo FINLAND Tel. +358 20 452 3000 Fax +358 20 452 9271 VAT FI14655702 www.opuscapita.com Sisältö 1 OpusCapita TYVI palvelu...

Lisätiedot

Tulorekisteri: Varmenne Visma Fivaldi

Tulorekisteri: Varmenne Visma Fivaldi Tulorekisteri: Varmenne Visma Fivaldi 1(15) Sisällysluettelo Yleistä 2 Muu tulorekisteri-dokumentaatio 2 Varmenne 3 Palvelusopimuksen tekeminen ja varmenteen tilaaminen 4 Varmenteen noutaminen 9 Asiakasyrityksen

Lisätiedot

Järjestelmän kriittisimmille toiminnallisuuksille (listattu alla), toteutetaan 1

Järjestelmän kriittisimmille toiminnallisuuksille (listattu alla), toteutetaan 1 1. Testattavat asiat Järjestelmän kriittisimmille toiminnallisuuksille (listattu alla), toteutetaan 1 selainyhteensopivuustesti käyttäen Suomessa eniten käytössä olevia selaimia. Uuden keräyksen lisääminen

Lisätiedot

Visma Fivaldi -käsikirja Tehtävienhallinta- ohje käyttäjälle

Visma Fivaldi -käsikirja Tehtävienhallinta- ohje käyttäjälle Visma Fivaldi -käsikirja Tehtävienhallinta- ohje käyttäjälle 2 Sisällys 1 Palvelunhallinta... 3 1.1 Käyttäjäryhmän luominen... 3 2 Tehtävienhallinta- perustiedot... 4 2.1 Yhtiön perustiedot... 4 2.2 Tehtävä-/

Lisätiedot

PALVELUKUVAUS OHJELMISTOTALOILLE SAMLINK VARMENNEPALVELU

PALVELUKUVAUS OHJELMISTOTALOILLE SAMLINK VARMENNEPALVELU PALVELUKUVAUS OHJELMISTOTALOILLE SAMLINK VARMENNEPALVELU Versio 1.0 OY SAMLINK AB 2 (8) Sisällysluettelo Sisällysluettelo 1 Johdanto... 4 2 Asiakasohjelmiston varmennehaun käyttötapaukset... 4 3 getcertificate-operaatio...

Lisätiedot

VIRANOMAISEN PALUUKANAVA WS API. Suomi.fi-viestit julkinen rajapinta

VIRANOMAISEN PALUUKANAVA WS API. Suomi.fi-viestit julkinen rajapinta VIRANOMAISN PALUUANAVA Suomi.fi-viestit julkinen rajapinta V.01 RAJAPINTAUVAUS V 1.1 2 (9) DOUMNTINHALLINTA Omistaja Laatinut Lasse Pynnönen, VR Suomi.fi-viestit sovelluskehitystiimi Tarkastanut Hyväksynyt

Lisätiedot

Käyttöohje. Ticket Inspector. Versio 1.0. Sportum Oy

Käyttöohje. Ticket Inspector. Versio 1.0. Sportum Oy Käyttöohje Ticket Inspector Versio 1.0 Sportum Oy 10.5.2017 Sivu 1 Sisällysluettelo 1. Yleistä... 2 2. Kirjautuminen ensimmäisellä kerralla / PIN-koodin unohtuessa... 3 3. Tunnistautuminen... 4 4. Päänäkymä...

Lisätiedot

EASY Tiedostopalvelin - mobiilin käyttöopas

EASY Tiedostopalvelin - mobiilin käyttöopas EASY Tiedostopalvelin - mobiilin käyttöopas ios www.storageit.fi - Äyritie 8 D, 01510 VANTAA Salorantie 1, 98310 KEMIJÄRVI Sisältö 1. Lataaminen ja asennus 2. Kansiot ja tiedostot Uusien tiedostojen luonti

Lisätiedot

Testaussuunnitelma. PUSU-ryhmä. Helsinki Ohjelmistotuotantoprojekti. HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos

Testaussuunnitelma. PUSU-ryhmä. Helsinki Ohjelmistotuotantoprojekti. HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos Testaussuunnitelma PUSU-ryhmä Helsinki 13.12.2007 Ohjelmistotuotantoprojekti HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos Kurssi 581260 Ohjelmistotuotantoprojekti (9 op) Projektiryhmä Jussi Hynninen

Lisätiedot

SSH Secure Shell & SSH File Transfer

SSH Secure Shell & SSH File Transfer SSH Secure Shell & SSH File Transfer TIETOHALLINTO Janne Suvanto 1.9 2002 Sisällysluettelo Sisällysluettelo... 1 Yleistä... 2 SSH Secure Shell ohjelman asetukset... 3 POP3 tunnelin asetukset... 6 Yhteyden

Lisätiedot

1 Uuden vuoden aloitus palkanlaskennassa

1 Uuden vuoden aloitus palkanlaskennassa 2 Sisällys 1 Uuden vuoden aloitus palkanlaskennassa... 3 2 Sosiaalivakuutus- ym. maksut... 4 3 Uudet verokortit... 7 4 TyEL vuosi-ilmoitus sähköisesti... 11 5 TVR palkkasummailmoitus sähköisesti... 12

Lisätiedot

Katso-tunnistautumisen muutos. Visma Fivaldi

Katso-tunnistautumisen muutos. Visma Fivaldi Katso-tunnistautumisen muutos Visma Fivaldi 22.10.2019 1(9) Sisällysluettelo 1 Yleistä... 2 2 Katso-tunnistautumisen muutos Fivaldissa... 2 2.1 Varmenteen olemassaolon tarkistaminen... 3 2.1.1 Tilitoimiston

Lisätiedot

1 Virtu IdP- palvelimen testiohjeet

1 Virtu IdP- palvelimen testiohjeet Versio Päivämäärä Muutoshistoria 1.0 5.9.2011 1.1 2.3.2012 Päivitetty metadataosoite 1.2. 24.2.2015 Päivitetty testipalvelinohjeen osoite 1 Virtu IdP- palvelimen testiohjeet Virtuun liitettävää IdP- palvelinta

Lisätiedot

Tietojen toimittaminen Skeemat Viestit Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Viestit Kansallisen tulorekisterin perustamishanke Versio 1.0 Tietojen toimittaminen Skeemat Viestit Kansallisen tulorekisterin perustamishanke Tietojen toimittaminen Skeemat Viestit 2 (14) Versiohistoria Versio Päivämäärä Kuvaus 1.0 12.6.2017 Dokumentti

Lisätiedot

Kelan työnantaja-asiakkaat

Kelan työnantaja-asiakkaat Ohjeita esaratiedostojen lähettäjälle Kelan työnantaja-asiakkaat 2017 Sisällysluettelo Palkkaohjelman edellytykset Lähettäjän edellytykset esara-tiedostoissa lähetettävät hakemukset esara-tiedostoissa

Lisätiedot

Ilmoitus saapuneesta turvasähköpostiviestistä

Ilmoitus saapuneesta turvasähköpostiviestistä Tullin turvasähköposti Asiakkaan ohje www.tulli.fi versio 2.2 8.1.2015 Korvaa version 2.1 22.5.2014 Tullin turvasähköposti Tulli lähettää sinulle sähköpostiviestin salattuna silloin, kun viesti tai sen

Lisätiedot

1 Uuden vuoden aloitus palkanlaskennassa

1 Uuden vuoden aloitus palkanlaskennassa 2 Sisällys 1 Uuden vuoden aloitus palkanlaskennassa... 3 2 Sosiaalivakuutus- ym. maksut... 4 3 Uudet verokortit... 7 4 TyEL vuosi-ilmoitus sähköisesti... 10 5 TVR palkkasummailmoitus sähköisesti... 11

Lisätiedot

Maventa Connector Käyttöohje

Maventa Connector Käyttöohje Maventa Connector Käyttöohje 17.4.2015 Sisällys 1. Esittely... 2 1.1. Käytön edellytykset... 2 1.2. Tuetut aineistomuodot... 2 2. Asennustiedosto... 3 2.1. Sisäänkirjautuminen... 7 3. Asetuksien määrittäminen...

Lisätiedot

SAMLINK VARMENNEPALVELU PALVELUKUVAUS OHJELMISTOTALOILLE

SAMLINK VARMENNEPALVELU PALVELUKUVAUS OHJELMISTOTALOILLE SAMLINK VARMENNEPALVELU Sisällysluettelo 2 (7) Sisällysluettelo 1 Johdanto... 3 2 Asiakasohjelmiston varmennehaun käyttötapaukset... 3 3 getcertificate-operaatio... 3 3.1 SenderId... 4 3.2 RequestId...

Lisätiedot

EMVHost Online SUBJECT: EMVHOST ONLINE CLIENT - AUTOMAATTISIIRROT COMPANY: EMVHost Online Client sovelluksen käyttöohje AUTHOR: DATE: 15.03.

EMVHost Online SUBJECT: EMVHOST ONLINE CLIENT - AUTOMAATTISIIRROT COMPANY: EMVHost Online Client sovelluksen käyttöohje AUTHOR: DATE: 15.03. EMVHost Online SUBJECT: COMPANY: COMMENTS: AUTHOR: EMVHOST ONLINE CLIENT - AUTOMAATTISIIRROT NETS OY EMVHost Online Client sovelluksen käyttöohje NETS OY DATE: 15.03.2011 VERSION: 1.0 1 SISÄLLYS SISÄLLYS...

Lisätiedot

TEKNINEN MÄÄRITTELY. Matkahuollon toimipistehaun rajapinta. Ismo Koskinen

TEKNINEN MÄÄRITTELY. Matkahuollon toimipistehaun rajapinta. Ismo Koskinen TEKNINEN MÄÄRITTELY Matkahuollon toimipistehaun rajapinta Ismo Koskinen Versio 1.2 Luonnos 21.03.2018 Tekijä Ismo Koskinen MUUTOSHISTORIA Versio ja pvm Laatija Muutoksen kuvaus 1.0 / 30.03.2017 Ismo Koskinen

Lisätiedot

KServer Etäohjaus Spesifikaatio asiakaspuolen toteutuksille

KServer Etäohjaus Spesifikaatio asiakaspuolen toteutuksille KServer Etäohjaus 1 (5) KServer Etäohjaus Spesifikaatio asiakaspuolen toteutuksille Palvelimen toteutuksen ollessa versio 1.0, spesifikaation versio 1.0.0. 2009, Riku Eskelinen/ KServer Software Development

Lisätiedot

Maksuturva-palvelun käyttöönottolomakkeen rajapintakuvaus verkkokauppaohjelmistolle

Maksuturva-palvelun käyttöönottolomakkeen rajapintakuvaus verkkokauppaohjelmistolle Maksuturva-palvelun käyttöönottolomakkeen rajapintakuvaus verkkokauppaohjelmistolle Versio 1.1 11.1.2010 2(8) Sisältö 1. Palvelun käyttöönoton tiedot... 3 Kenttien selitteet Palvelun käyttöönoton tiedot...

Lisätiedot

Muutokset suoran sanoma-asioinnin webservicepalvelun

Muutokset suoran sanoma-asioinnin webservicepalvelun SANOMALIIKENNE Tullihallitus Suora sanoma-asiointi 16.6.2012 Muutokset suoran sanoma-asioinnin webservicepalvelun XML-schemoihin v.1.8 muutos 16.6.2012 SISÄLLYSLUETTELO 1 Johdanto... 3 2 Aikataulu ja yhteensopivuus...

Lisätiedot

SoleMOVE lähtevän harjoittelijan ohje

SoleMOVE lähtevän harjoittelijan ohje SoleMOVE lähtevän harjoittelijan ohje 3.12.2013 Kuva: Sanna Waris SoleMOVE lähtevän ERASMUS- harjoittelijan ohje 1 SoleMOVE lähtevän harjoittelijan ohje... 1 1. Kirjautuminen... 3 2. Uuden lähtevän Erasmus-harjoittelijan

Lisätiedot

Varmennepalvelu Yleiskuvaus Kansallisen tulorekisterin perustamishanke

Varmennepalvelu Yleiskuvaus Kansallisen tulorekisterin perustamishanke Versio 1.0 Varmennepalvelu Yleiskuvaus Kansallisen tulorekisterin perustamishanke Varmennepalvelu Yleiskuvaus 2 (8) Versiohistoria Versio Päivämäärä Kuvaus 1.0 Dokumentti julkaistu. Varmennepalvelu Yleiskuvaus

Lisätiedot

Ohje luottamuksellista tietoa sisältävien sähköpostiviestien lähettämiseen ja vastaanottamiseen

Ohje luottamuksellista tietoa sisältävien sähköpostiviestien lähettämiseen ja vastaanottamiseen Ohje luottamuksellista tietoa sisältävien sähköpostiviestien lähettämiseen ja vastaanottamiseen Liikenteen turvallisuusvirasto 27.9.2012 Sisällysluettelo Luottamuksellista tietoa sisältävien sähköpostiviestien

Lisätiedot

Kelan työnantaja-asiakkaille 2017

Kelan työnantaja-asiakkaille 2017 Ohjeita esaratiedostojen lähettäjälle Kelan työnantaja-asiakkaille 2017 Sisällysluettelo Palkkaohjelman edellytykset Lähettäjän edellytykset esara-tiedostoissa lähetettävät hakemukset esara-tiedostoissa

Lisätiedot

Valtiokonttorin tunnistuspalvelu

Valtiokonttorin tunnistuspalvelu Tila Julkaistu Dok.nro Versio P Sivumäärä 18 Päiväys www.insta.fi Hallintatiedot Yleiset hallintatiedot Nimi Nimikirjoitus Päivämäärä Laatija Hyttinen Henna Tarkastaja Hyväksyjä Arkistoviite Versiohistoria

Lisätiedot

LUPAHANKKEET RAKENNUSVALVONNAN SAHKÖISESSÄ ASIOINTIPALVELUSSA

LUPAHANKKEET RAKENNUSVALVONNAN SAHKÖISESSÄ ASIOINTIPALVELUSSA LUPAHANKKEET RAKENNUSVALVONNAN SAHKÖISESSÄ ASIOINTIPALVELUSSA Rakennusvalvonnan sähköisessä asiointipalvelussa voi tehdä rakennusvalvonnan lupahakemuksia sähköisesti. Hakijan lisäksi hankkeita voi tarkastella

Lisätiedot

Asiointipalvelu. Asiakkaan sisäänkirjautumisohje

Asiointipalvelu. Asiakkaan sisäänkirjautumisohje Asiointipalvelu Asiakkaan sisäänkirjautumisohje sivu 1/7 Asiointipalvelu Asiakkaan sisäänkirjautumisohje 1 Yleiskuvaus... 3 2 Asiointipalvelun pääsivu... 4 2.1 Kieli... 4 2.2 Rekisteröityminen palveluun...

Lisätiedot

NORDEAN WEB SERVICES YHTEYDEN KÄYTTÖÖNOTTO

NORDEAN WEB SERVICES YHTEYDEN KÄYTTÖÖNOTTO 1 (11) NORDEAN WEB SERVICES YHTEYDEN KÄYTTÖÖNOTTO Sisältö 1 Web Services yhteyskanavan käyttöönotto... 1 2 Web Services varmenteiden tallennus... 2 2.1 Käyttäjätunnuksen tallennus Maksuliikenne-ohjelmistoon...

Lisätiedot

Ohjeita esara-tiedostojen lähettäjälle. Kelan työnantaja-asiakkaat, verkkoasiointiopas

Ohjeita esara-tiedostojen lähettäjälle. Kelan työnantaja-asiakkaat, verkkoasiointiopas Ohjeita esara-tiedostojen lähettäjälle Kelan työnantaja-asiakkaat, verkkoasiointiopas Sisällysluettelo Palkkaohjelman edellytykset Lähettäjän edellytykset esara-tiedostoissa lähetettävät hakemukset esara-tiedostoissa

Lisätiedot

Maksuturva- ja emaksut- palvelun integrointiohje

Maksuturva- ja emaksut- palvelun integrointiohje Maksuturva- ja emaksut- palvelun integrointiohje Versio 1.4 INTEGROINTIOHJE 2(9) Sisältö 1 INTEGROINTIMAHDOLLISUUDET... 3 2 INTEGROINTIRAJAPINNAT... 4 2.1 Yleistä... 4 2.2 MAKSUTURVA/EMAKSUT-TAPAHTUMAN

Lisätiedot

Avoin metsätieto - Rajapintapalvelut

Avoin metsätieto - Rajapintapalvelut Avoin metsätieto - Rajapintapalvelut 1 Johdanto Tässä asiakirjassa kuvataan lyhyesti Suomen metsäkeskuksen Avoin metsätieto -rajapintapalveluiden (AMT-rajapintapalvelut) sisältö ja käyttö. AMT-rajapintapalvelut

Lisätiedot

1 Visma L7 päivitysaineiston nouto

1 Visma L7 päivitysaineiston nouto 1 Visma L7 päivitysaineiston nouto Tässä ohjeessa kerrotaan, kuinka Visma L7 -järjestelmän master-ympäristö päivitetään etäpäivitysohjelman avulla. 1.1 Etäpäivitysohjelman asennus/päivitys Saat etäpäivitysohjelman

Lisätiedot

Onecapital Invoicer XML API

Onecapital Invoicer XML API 1(8) Onecapital Invoicer XML API Invoicerin XML-rajapinnan avulla voidaan tuoda laskuja Invoiceriin muista järjestelmistä. Rajapinta ottaa vastaan laskun tiedot XML-muodossa, ja palauttaa vastauksena tiedot

Lisätiedot

Varmennepalvelu Yleiskuvaus Kansallisen tulorekisterin perustamishanke

Varmennepalvelu Yleiskuvaus Kansallisen tulorekisterin perustamishanke Versio 1.01 Varmennepalvelu Yleiskuvaus Kansallisen tulorekisterin perustamishanke Varmennepalvelu Yleiskuvaus 2 (8) Versiohistoria Versio Päivämäärä Kuvaus 1.0 30.10.2017 Dokumentti julkaistu. 1.01 15.12.2017

Lisätiedot

Edico Lite ja S Käyttöohje istunnon pitäjälle ja kutsutulle

Edico Lite ja S Käyttöohje istunnon pitäjälle ja kutsutulle Edico Lite ja S Käyttöohje istunnon pitäjälle ja kutsutulle Sisältö: sivu Käyttäjäroolit Edico-istunnoissa 1 Istuntoon kutsutun kirjautuminen 1 Edico Lite, istunnon avausnäkymä 2 Edico S, istunnon avausnäkymä

Lisätiedot

Tietojen jakelu Skeemat Viestit Kansallisen tulorekisterin perustamishanke

Tietojen jakelu Skeemat Viestit Kansallisen tulorekisterin perustamishanke Versio 1.0 Tietojen jakelu Skeemat Viestit Kansallisen tulorekisterin perustamishanke Tietojen jakelu Skeemat Viestit 2 (20) Versiohistoria Versio Päivämäärä Kuvaus 1.0 12.6.2017 Dokumentti julkaistu.

Lisätiedot

Tulorekisteri: Erillisilmoitus Visma Fivaldi

Tulorekisteri: Erillisilmoitus Visma Fivaldi Tulorekisteri: Erillisilmoitus Visma Fivaldi 1(12) Sisällysluettelo 1. Yleistä 2 1.1. Muu tulorekisteri-dokumentaatio 2 2. Erillisilmoitukseen liittyvät asetukset 3 3. Erillisilmoituksen käyttötapaukset

Lisätiedot

L7 8.8 Tulorekisteriaineistot: Aineistojen lähetys ja virhetilanteet, aineistojen korjaaminen

L7 8.8 Tulorekisteriaineistot: Aineistojen lähetys ja virhetilanteet, aineistojen korjaaminen L7 8.8 Tulorekisteriaineistot: Aineistojen lähetys ja virhetilanteet, aineistojen korjaaminen Toimiala: Yleinen Kirjoittaja: Sovellus: Palkanlaskenta Tiedosto: Päivämäärä: 21.1.2019 Versio: 1.1 1 Yleistä

Lisätiedot

Titta-palvelun käyttöohje

Titta-palvelun käyttöohje LUONNOS 2 (12) Sisällysluettelo 1 Rekisteröityminen... 4 2 Kirjautuminen... 5 2.1 Unohtunut salasana... 5 2.2 Unohtunut käyttäjätunnus... 6 3 Etusivu... 6 4 Käyttäjätoiminnot... 6 4.1 Salasanan vaihtaminen...

Lisätiedot

Titta-palvelun käyttöohje

Titta-palvelun käyttöohje LUONNOS 226.10.2017 2 (11) Sisällysluettelo 1 Rekisteröityminen... 4 2 Kirjautuminen... 5 2.1 Unohtunut salasana... 6 2.2 Unohtunut käyttäjätunnus... 6 3 Etusivu... 6 4 Käyttäjätoiminnot... 6 4.1 Salasanan

Lisätiedot

Asiointipalvelun ohje

Asiointipalvelun ohje Asiointipalvelun ohje Yleistä 1. Kirjautuminen 2. Yhteystiedot 3. Vastaustavan valinta 1. Yleistä 2. Palkkatietojen lataaminen tiedostosta 4. Lomake 1. Yleistä 2. Linkit ja vastaajan tiedot 3. Lomakekäsittely

Lisätiedot

Ajankohtaista tietoa LähiTapiolan verkkopalvelun pääkäyttäjille

Ajankohtaista tietoa LähiTapiolan verkkopalvelun pääkäyttäjille Ajankohtaista tietoa LähiTapiolan verkkopalvelun pääkäyttäjille Hyvä verkkopalvelumme pääkäyttäjä, Kerromme tässä tiedotteessa ajankohtaisia ja tärkeitä asioita LähiTapiolan yritysten verkkopalveluun kirjautumisesta,

Lisätiedot

Convergence of messaging

Convergence of messaging Convergence of messaging Testausdokumentti The Converge Group: Mikko Hiipakka Anssi Johansson Joni Karppinen Olli Pettay Timo Ranta-Ojala Tea Silander Helsinki 20. joulukuuta 2002 HELSINGIN YLIOPISTO Tietojenkäsittelytieteen

Lisätiedot

Apix Vastaanota-palvelun lisäominaisuus. Vastaanota+ Pikaohje. 24.11.2011 Versio 1.0

Apix Vastaanota-palvelun lisäominaisuus. Vastaanota+ Pikaohje. 24.11.2011 Versio 1.0 Apix Vastaanota-palvelun lisäominaisuus Vastaanota+ Pikaohje 24.11.2011 Versio 1.0 1 Sisältö Yleistä...... 2 Käyttäjät...... 3 Näkymät...... 3 Kirjautumisnäkymä... 4 'Pääkäyttäjä -näkymä... 5 Luo lasku

Lisätiedot

EasyGO Hunter Käyttäjän opas

EasyGO Hunter Käyttäjän opas EasyGO Hunter Käyttäjän opas JOHDANTO Onnittelut EasyGO Hunter laajennuspaketin valinnasta! Hunter tarjoaa metsästäjien toivomia lisäominaisuuksia laajentaen EasyGO Personalin käyttävyyttä. Hunter mahdollistaa

Lisätiedot

Osallistavan suunnittelun kyselytyökalu

Osallistavan suunnittelun kyselytyökalu Osallistavan suunnittelun kyselytyökalu Käyttöohje InnoGIS- hankkeen aikana kehitetylle pilottiversiolle Dokumentti sisältää pilottiversiona toimivan kyselyn laatimiseen ja vastaamiseen liittyvän ohjeistuksen.

Lisätiedot

VEROHALLINTO

VEROHALLINTO VEROHALLINTO 20.3.2017 1.2 ERITTELY VARAUKSISTA, ARVONMUUTOKSISTA JA KULUVAN KÄYTTÖOMAISUUDEN POISTOISTA (62) TIETUEKUVAUS 2017 SISÄLTÖ 1 YLEISKUVAUS... 2 2 TIETOVIRRAN ANTAMISTA TARKENTAVAA KUVAUSTA...

Lisätiedot

LoCCaM. LoCCaM Cam laitteiston ohjaaminen. Dimag Ky dimag.fi

LoCCaM. LoCCaM Cam laitteiston ohjaaminen. Dimag Ky dimag.fi LoCCaM LoCCaM Cam laitteiston ohjaaminen Dimag Ky janne.koski @ dimag.fi +358505907788 Laitteen lisääminen sovellukseen Sovelluksen pääsivulta valitaan oikeasta yläkulman valikosta Aloita uusi (1) Aukeavaan

Lisätiedot

Toimittajaportaalin pikaohje

Toimittajaportaalin pikaohje 1 Toimittajaportaalin pikaohje Toimittajaportaalin rekisteröityminen Toimittajaportaalin sisäänkirjautuminen Laskun luonti Liitteen lisääminen laskulle Asiakkaiden hallinta Uuden asiakkaan lisääminen Laskujen

Lisätiedot

Ohjeita esara-tiedostojen lähettäjälle

Ohjeita esara-tiedostojen lähettäjälle Ohjeita esara-tiedostojen lähettäjälle Kelan työnantaja-asiakkaat, verkkoasiointiopas 1 Sisällysluettelo Palkkaohjelman edellytykset Lähettäjän edellytykset esara-tiedostoissa lähetettävät hakemukset esara-tiedostoissa

Lisätiedot

OPAS KULTA2 -JÄRJESTELMÄN KÄYTTÖÖN

OPAS KULTA2 -JÄRJESTELMÄN KÄYTTÖÖN OPAS KULTA2 -JÄRJESTELMÄN KÄYTTÖÖN 1. Kulta2 -järjestelmän käyttäminen ensimmäistä kertaa s. 1-3 2. Järjestelmään kirjautuminen olemassa olevalla käyttäjätunnuksella ja salasanalla s. 4-5 3. Hakemuksen

Lisätiedot

WEB SERVICES RAJAPINTA SAMLINKIN TEKNINEN RAJAPINTAKUVAUS OHJELMISTOTALOILLE

WEB SERVICES RAJAPINTA SAMLINKIN TEKNINEN RAJAPINTAKUVAUS OHJELMISTOTALOILLE WEB SERVICES RAJAPINTA 02.05.2014 Sisällysluettelo Sisällysluettelo 02.05.2014 2 (13) 1 SOAP-kehys... 4 2 Aineiston pakkaus... 4 3 Aineiston salaus... 4 4 Tuetut operaatiot... 4 5 Application Request Header...

Lisätiedot

BaseMidlet. KÄYTTÖOHJE v. 1.00

BaseMidlet. KÄYTTÖOHJE v. 1.00 KÄYTTÖOHJE v. 1.00 KUVAUS BaseMidlet on matkapuhelimessa toimiva sovellus jolla voi etäkäyttää Tiimi 7000 sarjan säätimiä. Copyright Team-Control Oy, oikeudet muutoksiin pidätetään. TiiMi on Team-Control

Lisätiedot

Ohjeita Omapalvelun käyttöön

Ohjeita Omapalvelun käyttöön Ohjeita Omapalvelun käyttöön Sisällysluettelo Omapalvelu 3 Omat tiedot ja Yhteydenottotapa 4 Aloitus 5 Uusi ja keskeneräinen hakemus 1/2 6 Uusi ja keskeneräinen hakemus 2/2 7 Etusivu 1/3 8 Etusivu 2/3

Lisätiedot

Tietojen toimittaminen Skeemat Käsittelypalaute Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Käsittelypalaute Kansallisen tulorekisterin perustamishanke Versio 1.04 Tietojen toimittaminen Skeemat Käsittelypalaute Kansallisen tulorekisterin perustamishanke Tietojen toimittaminen Skeemat Käsittelypalaute 2 (22) Versiohistoria Versio Päivämäärä Kuvaus 1.0

Lisätiedot

Sisäänkirjautuminen Tallennus/raportit (YAP) Tallennusohjelma

Sisäänkirjautuminen Tallennus/raportit (YAP) Tallennusohjelma Sisällysluettelo Sivu 2. Sisäänkirjautuminen Sivu 3. Käyttäjän tiedot Sivu 4. Etusivu Sivu 6. Lomakkeiden syöttö / Juoksijan valinta Sivu 7. Lomakkeiden syöttö / Juoksijoiden ja maksajien tietojen syöttö

Lisätiedot

Työsähköpostin sisällön siirto uuteen postijärjestelmään

Työsähköpostin sisällön siirto uuteen postijärjestelmään Työsähköpostin sisällön siirto uuteen postijärjestelmään edupori.fi/office 365 3.10.2013 Porin kaupunki ATK Tuki Sisällys Johdanto... 2 Edupori.fi sähköpostin määrittäminen Office 365:n Outlook-ohjelmaan

Lisätiedot

Varmennepalvelu - testipenkki. Kansallisen tulorekisterin perustamishanke

Varmennepalvelu - testipenkki. Kansallisen tulorekisterin perustamishanke Varmennepalvelu - testipenkki Kansallisen tulorekisterin perustamishanke 2 (9) SISÄLLYS 1 Johdanto... 3 2 Testimateriaali... 3 2.1 Testipenkin palveluissa käytettävät parametrit... 3 2.2 Testipenkin yhteysosoite...

Lisätiedot

Luottamuksellinen sähköposti Trafissa

Luottamuksellinen sähköposti Trafissa OHJE 1 (8) Luottamuksellinen sähköposti Trafissa Trafi käyttää Deltagon Sec@GW -ohjelmistoa sähköpostin luottamuksellisuuden suojaamiseen. D-Envelope sovelluksen avulla viestien vastaanottaminen ei edellytä

Lisätiedot

VEROHALLINTO

VEROHALLINTO VEROHALLINTO 1.1.2017 1.0 ERITTELY VARAUKSISTA, ARVONMUUTOKSISTA JA KULUVAN KÄYTTÖOMAISUUDEN POISTOISTA (62) TIETUEKUVAUS 2017 SISÄLTÖ 1 YLEISKUVAUS... 2 2 TIETOVIRRAN ANTAMISTA TARKENTAVAA KUVAUSTA...

Lisätiedot

PANKKILINJAN FTP - KUVAUS

PANKKILINJAN FTP - KUVAUS PANKKILINJAN FTP - KUVAUS 2 Sisällysluettelo SISÄLLYSLUETTELO...2 YLEISTÄ...3 YHTEYSKÄYTÄNTÖ...4 YHTEYDEN AVAAMINEN JA FTP-SISÄÄNKIRJAUS...4 ASIAKKAAN JA PANKIN TODENNUS...5 PALVELUN PYYNTÖ...5 AINEISTON

Lisätiedot

Lohtu-projekti. Testaussuunnitelma

Lohtu-projekti. Testaussuunnitelma Lohtu-projekti Testaussuunnitelma Versiohistoria: 1.0 19.2.2003 1. versio Mari 1.1 20.2.2003 Muutoksia Mari 1.2 25.2.2003 Katselmoinnissa esiin tulleet Mari muutokset 1.3 17.3.2003 2. syklissä tehtävät

Lisätiedot

OHJE EVENTALEN ASIAKASKUTSUJÄRJESTELMÄN KÄYTTÖÖN FKS-Tapahtumat Oy, v2

OHJE EVENTALEN ASIAKASKUTSUJÄRJESTELMÄN KÄYTTÖÖN FKS-Tapahtumat Oy, v2 Sisällys Mikä on Eventale?... 1 Miten käytän Eventalea? (kirjautumisohje)... 2 Käyttöohje... 2 Luo kutsu... 3 Miten toimitan kutsun yhdelle nimetylle asiakkaalle?... 3 Kutsun lähettäminen sähköpostilla...

Lisätiedot

29.8.2012 SUOMEN PANKIN RAPORTOINTIPALVELUN KÄYTTÖOHJE. Maksutaseen kuukausikysely ulkomaisista rahoitussaamisista ja -veloista (BOPM)

29.8.2012 SUOMEN PANKIN RAPORTOINTIPALVELUN KÄYTTÖOHJE. Maksutaseen kuukausikysely ulkomaisista rahoitussaamisista ja -veloista (BOPM) 1 (7) SUOMEN PANKIN RAPORTOINTIPALVELUN KÄYTTÖOHJE Maksutaseen kuukausikysely ulkomaisista rahoitussaamisista ja -veloista (BOPM) Suomen Pankin tilastotiedonkeruu tapahtuu DCS-raportointipalvelun (Data

Lisätiedot

Yhteistyökumppanit kirjautuvat erikseen annetuilla tunnuksilla osoitteeseen

Yhteistyökumppanit kirjautuvat erikseen annetuilla tunnuksilla osoitteeseen 1 Etäyhteysohje (vpn.lappia.fi) Yleistä ssl-vpn etäkäyttöpalvelusta Koulutuskuntayhtymän henkilökunnalla ja opiskelijoilla on käytössään selaimella käytettävä etäkäyttöpalvelu. Palvelun kautta voi käyttää

Lisätiedot

OFFICE 365 PIKAOHJE 14.01.2014

OFFICE 365 PIKAOHJE 14.01.2014 OFFICE 365 PIKAOHJE 14.01.2014 SISÄLTÖ 1. O365 AVAAMINEN 3 2. KIRJAUTUMINEN 3 3. SALASANAN VAIHTAMINEN 5 4. SÄHKÖPOSTIN KANSIO RAKENNE 6 5. POISSAOLOVIESTI 7 6. SÄHKÖPOSTIN ALLEKIRJOITUS 8 7. YHTEYSTIEDOT

Lisätiedot

Sähköposti ja uutisryhmät 4.5.2005

Sähköposti ja uutisryhmät 4.5.2005 Outlook Express Käyttöliittymä Outlook Express on windows käyttöön tarkoitettu sähköpostin ja uutisryhmien luku- ja kirjoitussovellus. Se käynnistyy joko omasta kuvakkeestaan työpöydältä tai Internet Explorer

Lisätiedot

Liite 7: Asiakastietoa käsittelevä järjestelmä Sosiaalihuollon asiakastiedon arkisto. Rajapintakäyttötapaukset

Liite 7: Asiakastietoa käsittelevä järjestelmä Sosiaalihuollon asiakastiedon arkisto. Rajapintakäyttötapaukset Liite 7: Asiakastietoa käsittelevä järjestelmä Sosiaalihuollon asiakastiedon arkisto Rajapintakäyttötapaukset Versiohistoria Versio Pvm Tekijät Muutokset 1.0 22.4.2016 Katja Korhonen Ensimmäinen julkaistu

Lisätiedot

Kirje -tasolla viestiliikenne suojataan automaattisesti SSL-salauksella, sekä viesti lukitaan Deltagon MessageLock -tekniikalla.

Kirje -tasolla viestiliikenne suojataan automaattisesti SSL-salauksella, sekä viesti lukitaan Deltagon MessageLock -tekniikalla. Luottamuksellinen sähköposti Lapin AMK:ssa Lapin AMK käyttää Deltagon Sec@GW -ohjelmistoa sähköpostin luottamuksellisuuden suojaamiseen. D-Envelope sovelluksen avulla viestien vastaanottaminen ei edellytä

Lisätiedot