Hakemus teknisen rajapinnan käyttöönottamiseksi

Rajaustarkenteita ei voi toistaiseksi tehdä Suomi.fi -valtuuksissa. Tulorekisteri tiedottaa, kun toiminto otetaan käyttöön .

Tee hakemus rajapintapalveluiden käyttöönottoa varten, kun haluat aloittaa tulorekisterin teknisen rajapinnan käytön. Hakemus käynnistää myös varmennetilauksen. Lue lisää varmenteesta.

Tähdellä (*) merkityt tiedot ovat pakollisia.

 1. Hakemuksen tiedot

Hakijan tiedot

Hakemuksen tekee organisaatio, joka tulee käyttämään järjestelmää, josta tekninen rajapinta on rakennettu tulorekisteriin. Rajapinnan käyttäjä voi olla yritys itse, tilitoimisto tai muu ulkoistettu palkkahallinnon kumppani. Lue lisää varmenteen hakemisesta

Kanavat

Yritys voi ottaa käyttöön useita teknisen rajapinnan kanavia. Samalla hakemuksella voi tehdä useamman kanavan varmennetilauksen. Jos yritys haluaa myöhemmin ottaa käyttöön uusia kanavia sen on haettava uusia kanavia uudella hakemuksella. Lue lisää teknisen rajapinnan kanavista

Korvaava hakemus

Uusi hakemus korvaa aikaisemman. Jos teet korvaavan hakemuksen, merkitse hakemukseen myös ne kanavat, jotka ovat jo käytössä. Jos et merkitse aikaisempien kanavien tietoja, näiden kanavien käyttöoikeus päättyy. Korvaava hakemus käynnistää varmennetilauksen vain uusiin kanaviin. Järjestelmä ei siis tee uusia varmennetilauksia niihin kanaviin, jotka ovat jo käytössäsi.

Jos tarvitset uuden varmenteen jo käytössä olevaan kanavaan, voit tilata sen kohdasta "Hae uutta varmennetta".

Rajapinnan käyttötarkoitus

    • Hakija voi käyttää rajapintaa oman organisaationsa tarpeisiin.
    • Hakija voi toimia rajapinnan kautta toisen organisaation puolesta. Jos hakija toimii toisen organisaation puolesta, on näiden kahden tahon välillä oltava keskinäinen toimeksiantosopimus.

Varmenteen tekninen yhteyshenkilö

Varmenteen teknisen yhteyshenkilön on oltava ns. luonnollinen henkilö, eli yhteyshenkilö ei voi olla yritys tai muu yhteisö. Tekninen yhteyshenkilö saa sähköpostilla tiedot varmenteen noutamiseksi ja tekstiviestillä PIN-koodin viestin avaamiseksi.

Ilmoita puhelinnumero kansainvälisessä muodossa: maakoodi + matkapuhelinnumero (esim. +35840xxxxxxx). Sähköpostiosoite ei voi olla yhteispostilaatikko tai jakelulista.

Hakemus käynnistää varmennetilauksen. Varmennetilaus on voimassa 14 vuorokautta, jonka aikana varmenne tulee noutaa.

Ongelmatilanteissa ota yhteys Tulorekisteriyksikköön.

Lisätietoja varmenteen noutamisesta

Varmenteen kuvaus

Varmenteelle on annettava kuvaus, jonka perusteella esimerkiksi eri ohjelmistojen tai asiakasyritysten varmenteet voi erottaa toisistaan. Sallittu merkkimäärä on 40 merkkiä.

2. Käyttöehdot

Käyttöehdot-vaiheessa hakija hyväksyy tulorekisterin ja Verohallinnon rajapintapalveluiden käyttöehdot. Tutustu käyttöehtoihin (pdf)

3. Viimeistely

Tarkista ennen lähettämistä, että tiedot ovat oikein. Tarkista erityisesti varmenteen yhteyshenkilön sähköpostiosoite ja puhelinnumero. Näiden tietojen on tärkeä olla oikein, sillä varmenteen noutamiseen tarvittavat tiedot lähetetään yhteyshenkilön sähköpostiin. Hakemus käynnistää automaattisesti varmennetilauksen.

Yksi hakemus – monta kanavaa

Organisaatio voi hakea yhdellä hakemuksella useita käyttöoikeuksia eri kanaviin.

Jos organisaatio tarvitsee useita varmenteita samaan kanavaan, voi organisaation nimenkirjoitusoikeudellinen tilata lisävarmenteita kohdassa Hae uutta varmennetta.  

Organisaatio voi käyttää samaa varmennetta eri ohjelmistoissaan, jos samantyyppinen varmenne soveltuu eri tarpeisiin. Vaihtoehtoisesti jokaiselle ohjelmistolle voi hakea oman varmenteen.

Lue lisää teknisestä rajapinnasta