Varmenteen hakeminen Jiiri Ilmoittimeen

Varmenteen käyttöönotto – yleistä

ApitamoPKI-rajapinnan käyttöön tarvitaan aktiivinen tulorekisterivarmenne, joka haetaan tulorekisterin asiointipalvelusta (tulorekisteri.fi). Tulorekisterivarmenteen käyttöönottoa varten tulee ottaa käyttöön tekninen rajapinta tulorekisterin asiointipalvelussa. Yrityksellä tai muulla yhteisöllä voi olla vain yksi voimassa oleva tekninen rajapinta, mutta tähän rajapintaan voi liittää useita eri varmenteita. Eri varmenteita tarvitaan lähetettäessä ilmoituksia useammasta kuin yhdestä ohjelmasta.

Ilmoitinta varten teknisen rajapinnan käyttöönoton hakemuksen voi tehdä vain hakijaorganisaation nimenkirjoitusoikeudellinen henkilö.

Tuotantovarmenteiden tilaaminen on muuttunut lokakuussa 2024. Verohallinnon varmennepalvelu on sähköinen palvelu, jossa voit hallinnoida organisaation rajapintaoikeuksia ja varmenteita. Verohallinnon ja tulorekisterin asiakkaat tekevät tuotannon rajapinta- ja varmennetilaukset 9.10. alkaen Verohallinnon varmennepalvelun asiointipalvelussa.

Palvelun ohjeet: Verohallinnon varmennepalvelu

HUOM. Etene edellä olevasta linkistä verohallinnon varmennepalvelun ohjeistuksen mukaisesti.

Kun kirjaudut Tuotantovarmenteet-osioon ensimmäisen kerran, tarkista että organisaatiollasi on käytössä halutut rajapinnat ja että organisaatiosi yhteyshenkilö on ajan tasalla. Tarkista ja päivitä tarvittaessa myös tuotantovarmenteiden tekniset yhteyshenkilöt. 

Alla olevat eri vaiheet saattavat olla vanhentuneita johtuen verohallinnon varmennepalvelun muuttumisesta lokakuussa 2024.

Asiointipalveluun kirjautumisen jälkeen valitaan Asioi toisen puolesta > Asioi yrityksen tai organisaation puolesta -kohta.

Tämän jälkeen valitaan yritys tai organisaatio, jonka puolesta halutaan asioita. Sivuston vasemmalta puolelta löytyy valikko, josta Asetukset-kohdasta valitaan Tekninen rajapinta ja varmenteet.

Tämän jälkeen näkyviin tulee Voimassa olevat oikeudet -osio, josta pääsee tarkistamaan rajapinnan voimassaolon, käyttötarkoituksen ja valitun kanavan. Alla esimerkki kyseisestä kohdasta.

Teknisen rajapinnan käyttöönotto

Mikäli yrityksellänne ei vielä ole käytössä teknistä rajapintaa, tulee rajapinnan käyttöönottohakemus tehdä Tulorekisterin asiointipalvelussa alla kuvattujen ohjeiden mukaan.

Huom. Jos yrityksenne käyttää esimerkiksi Jydacom Palkat -ohjelmistoa, yrityksellänne on tekninen rajapinta jo käyttöönotettu. Mikäli rajapinta on jo käytössä, siirry ohjeen kohtaan Varmenteen hakeminen.

Asiointipalveluun kirjautumisen jälkeen valitaan ”Asioi yrityksen tai organisaation puolesta”, valitaan oikea yritys ja sen jälkeen vasemman reunan Asetukset-kohdasta valitaan ”Tekninen rajapinta ja varmenteet”. Tällöin aukeaa sivu, jossa näkyy Tee hakemus teknisen rajapinnan käyttöönottamiseksi -painike:

Painikkeen painamisen jälkeen avautuu näkymälle seuraavat asetusvalinnat:

Tee valinnat seuraavasti:

• Rajapinnan käyttötarkoitus: Valitse ”Palkkatiedot, ilmoittaa maksamiaan palkkoja”

HUOM. Myös veroilmoitusten osalta, kuten oma-aloitteisten verojen veroilmoitus ja rakentamisilmoitukset, käytetään samaa rajapintaa kuin palkkatietojen osalta. Siksi myös niiden osalta viitataan tässä termiin ”Palkkatiedot”.

• Kanavat: Valitse ”Palkkatiedot – Web Service”

HUOM. Myös veroilmoitusten osalta, kuten oma-aloitteisten verojen veroilmoitus ja rakentamisilmoitukset, käytetään samaa rajapintaa kuin palkkatietojen osalta. Siksi myös niiden osalta viitataan tässä termiin ”Palkkatiedot”.

Lue ja hyväksy lopuksi käyttöehdot. Paina lopuksi Lähetä-painiketta.

Onnistuneesta hakemuksesta tulee ilmoitus ”Rajapintahakemus onnistui”.

Seuraavaksi tulorekisterin asiointipalvelussa jatketaan kohtaan Hae varmenne, joka on ohjeistettu tarkemmin seuraavassa kohdassa Varmenteen hakeminen.

Varmenteen hakeminen

Kun tekninen rajapinta on yritykselle avattu siten, että kanavana on WebService (eli SFTP-kanava ei ole käytössä), voidaan edetä suoraan varmenteen hakemiseen. Yrityksellä voi olla käytössään useita eri varmenteita, esim. omat varmenteet käytössä olevia eri ohjelmistoja varten.

Varmennetta haetaan tulorekisterin asiointipalvelussa klikkaamalla Hae uutta varmennetta -painiketta.

Tällöin avautuu seuraavanlainen näkymä:

• Varmenteen tyyppi: Valitse alasvetovalikosta Palkkatiedon tuottaja Web Service -valinta
• Varmenteen kuvaus: Anna tähän kenttään haettavalle varmenteelle vapaamuotoinen nimi, jolla se erottuu Tulorekistgerin asiointipalvelussa näkyvistä muista varmenteista (esim. ”Ilmoitin-liittymä”)

• Varmenteen tekninen yhteyshenkilö: Anna näihin kenttiin sen henkilön tiedot, joka käy noutamassa varmenteen Tulorekisteristä ja syöttää tiedot Ilmoitin-liittymään (hakijaorganisaation työntekijä). Tälle henkilölle lähetetään varmenteen noudossa tarvittava siirtotunnus ja salasana. Varmista, että tiedoissa ei ole kirjoitusvirheitä, koska tällöin varmennetta koskevat tunnukset tai esimerkiksi vanhentuvaa varmennetta koskeva muistutusviesti eivät tule perille annetulle yhteyshenkilölle.

Paina lopuksi Lähetä-painiketta. Tämän jälkeen tekninen yhteyshenkilö saa Tulorekisteristä sähköpostitse varmenteen noutamiseen tarvittavat tunnukset.

HUOM! Jydacomin ohjelma ei vaadi mitään allekirjoitusta ja tästä näkymästä voi poistua Peruuta -toiminnolla. 

Jos varmenteen noutamisessa tai muussa Tulorekisterin asiointipalveluun liittyvässä asiassa on ongelmia, on niiden kohdalla oltava yhteydessä Tulorekisterin asiakaspalveluun.

Varmenteen asettaminen Jiirin Ilmoittimelle

Kun varmenteen hakenut tekninen yhteyshenkilö on saanut Tulorekisteristä varmenteen tiedot haltuunsa, tiedot haetaan Jiiriin. Varmenne on noudettava 14 vuorokauden kuluessa tunnusten saantihetkestä.

Jiirissä Asetukset / Ulkoiset järjestelmät / Ilmoitin-välilehdellä näytetään noudetun ja tallennetun varmenteen tiedot. Kentät ovat tyhjiä, mikäli varmennetta ei ole noudettu ja Nouda varmenne -painike on aktiivisena.

Jos varmennetta ei ole vielä noudettu, paina Nouda varmenne ja syötä kenttiin Verohallinnon sähköpostissa saadut tunnustiedot.

• Siirtotunnus
• Kertakäyttösalasana
• Varmenteen hakijan tunnus
• Varmenteen hakijan nimi tulee olla muotoa: etunimi sukunimi (välilyönti välissä)

Paina lopuksi Nouda varmenne, joka noutaa varmenteen Verohallinnon palvelusta. Mikäli tallennus onnistuu, näkyy tieto ”Varmenteen nouto onnistui” ja ikkuna sulkeutuu.

Varmenne on voimassa kerrallaan kaksi vuotta ja se tulee uusia ennen vanhenemista.

Varmenteen uusiminen

Mikäli varmenne ei ole vielä vanhentunut, niin Päivitä varmenne -painike päivittää varmenteen voimaan kahdeksi vuodeksi eteenpäin (toiminto voi kestää hetken).

Jos aiemmin haettu varmenne on vanhentunut, haetaan uusi varmenne kohdan Varmenteen hakeminen –ohjeen mukaisesti (katso ohje ylempänä). Varmenteen haun tekee aina yrityksen nimenkirjoitusoikeudellinen henkilö.

Kun uusi varmenne on luotu, ja verohallinto on palauttanut sähköpostiin tarvittavat tiedot: Siirtotunnus, Kertakäyttösalasana ja Varmenteen hakijan tunniste, niin nämä liitetään Jiirin Ilmoittimelle kohdassa Jiiri/Asetukset/Ulkoiset järjestelmät/Ilmoitin /Hae korvaava varmenne

– klikkaa Hae korvaava varmenne -painiketta ja lisää tiedot kyseisiin kenttiin verottajan lähettämästä sähköpostista.
Noiden yllä mainittujen lisäksi tulee lisätä myös varmenteen hakijan nimi.
– kun tiedot on tallennettu, näyttää ohjelma uuden voimassaolopäivämäärän.

Tiedot tulee liittää Jiiriin 14 vuorokauden kuluessa noudosta.
Mikäli tuo aika ylittyy, tulee varmenne hakea uudelleen yllä olevien ohjeiden mukaan.

Käsittelyssä oleva varmenne

Mikäli varmenne jää tilaan Käsittelyssä oleva varmennepyyntö, syynä voi olla Verohallinnon varmenteen hakupalvelussa oleva ruuhka. Yritä varmenteen hakemista uudelleen seuraavana päivänä ja voit kokeilla vielä uudelleen sitä seuraavana päivänä.

Mikäli varmenteen tila on edelleen Käsittelyssä, saattaa verohallinnon Tulorekisteri-palvelussa olla häiriöitä. Hae varmenne tällöin alusta alkaen uudelleen, katso kohta Varmenteen hakeminen. Tee toimenpiteet siitä eteenpäin ohjeen mukaan.