Testivarmenteet

Tunnistaudu palveluun pankkitunnuksilla, mobiilivarmenteella tai varmennekortilla. Et tarvitse Suomi.fi-valtuutta.

• Kun kirjaudut ensimmäisen kerran, anna sähköpostiosoitteesi ja puhelinnumerosi.
• Pääset jatkamaan palveluun, kun olet vahvistanut sähköpostiosoitteesi sinulle lähetettävän viestin kautta.

Kirjautumisen jälkeen näet listauksen kaikista testauksen rajapinnoista, joihin sinulla on käyttöoikeus. Näet myös varmenteet, jotka liittyvät näihin rajapintoihin.

Tarkista, että tiedot ovat ajan tasalla. Varmista, että organisaatiollasi on käytössä halutut rajapinnat. Tarkista ja päivitä tarvittaessa myös organisaation yhteyshenkilö ja varmenteiden tekniset yhteyshenkilöt.

• Jos olet mukana monen eri organisaation testauksessa, näet kaikki organisaatiot samassa listassa.
• Tutustu ryhmiin, joiden avulla voit jakaa käyttöoikeuksia uusille testaajille.

Jos organisaatiolla on jo haluamasi rajapinta käytössä, siirry suoraan kohtaan 3. Tilaa testivarmenne.

Jos organisaatiolla ei ole vielä yhtään rajapintaa käytössä, valitse Tee rajapintahakemus.

• Valitse, testaatko Verohallinnon vai tulorekisterin rajapintoja.
  • • Ilmoita testaavan organisaation tiedot.
      • Jos testaat tulorekisterin rajapintoja, ilmoita myös keinotekoinen tunniste (yleensä Y-tunnus), jonka olet saanut tulorekisteriltä testausta varten.
    • Valitse, mitä rajapintoja organisaatio tarvitsee.
      • Jos haet käyttöoikeutta tulorekisterin rajapintaan, ilmoita myös rajapinnan käyttötarkoitus, eli ilmoitatko itse maksamiasi tuloja vai tietoja toisen tahon puolesta.
      • Jos haet käyttöoikeutta tulorekisterin etuustietojen ilmoittamisen rajapintaan, rastita hakemuksessa myös vahvistus siitä, että organisaatiosi ottaa käyttöön etuustietojen ilmoittamisen toiminnot.
    • Ilmoita organisaation yhteyshenkilön tiedot.
      • Kannattaa varmistaa, kuka on vastuussa rajapintojen testauksesta organisaatiossasi tai asiakkaasi organisaatiossa.
      • Varmenteen tekninen yhteyshenkilö ilmoitetaan jokaisessa varmennetilauksessa erikseen.
    • Lähetä lopuksi hakemus.

Voit tilata testivarmenteen heti kun olet lähettänyt rajapintahakemuksen. Varmenteen voi kuitenkin noutaa vasta kun hakemus on hyväksytty.

Jos organisaatiolla on jo rajapintoja käytössä, mutta haluat samalle keinotekoiselle organisaatiolle käyttöön uuden rajapinnan, valitse ensin organisaatio listalta ja valitse sen jälkeen Tee korvaava hakemus. Tilaa oma testivarmenne jokaiseen rajapintaan.

Jos huolehdit testaamisesta useiden tahojen puolesta ja tarvitset niille omat käyttöoikeudet, tee jokaiselle taholle oma rajapintahakemus. Silloin saat palveluun oman käyttöoikeuden jokaiselle eri keinotekoiselle organisaatiolle.

Virkailijan pitää hyväksyä hakemus

Virkailijat käsittelevät Verohallinnon ja tulorekisterin hakemukset rajapinta kerrallaan. Jos rajapintojen testaukseen liittyen on tarkennettavaa, virkailija ottaa yhteyttä rajapintahakemuksessa ilmoittamaasi yhteyshenkilöön.

Varmennepalvelun asiointipalvelusta näet, mitkä rajapinnat on hyväksytty ja mitkä vielä odottavat hyväksyntää. Kun kaikki rajapinnat on hyväksytty, tekemäsi testivarmenteiden tilaukset otetaan automaattisesti käsittelyyn.

Positiivisen luottotietorekisterin rajapinnat

Positiivisen luottotietorekisterin rajapintojen testauksessa ei tarvitse tehdä erillistä rajapintahakemusta varmennepalvelussa.

Virkailija tallentaa testauksen aloitusilmoituksessa antamasi tiedot palveluun ja tilaa ensimmäisen varmenteen. Samalla testausryhmän ylläpitäjäksi merkitään aloitusilmoituksessa annettu testauksen yhteyshenkilö. Voit siirtyä suoraan kohtaan 4. Tekninen yhteyshenkilö noutaa varmenteen.

Jos tarvitset testaukseen useamman varmenteen, tilaa lisävarmenteet kuten kohdassa 3. Tilaa testivarmenne.

Valitse varmenteen tilaajaksi organisaatio, jonka puolesta testaat.

Valitse rajapinta, johon haluat tilata varmenteen.

• Voit antaa varmenteelle lyhyen kuvauksen.
• Ilmoita varmenteen tekninen yhteyshenkilö, esimerkiksi ohjelmistotalon edustaja.
• Yhteyshenkilö vastaa varmenteen käytöstä ja saa erikseen ohjeet varmenteen noutamiseksi.
• Yhteyshenkilö saa ilmoituksen vanhenevasta varmenteesta 60 päivää ennen vanhenemista.
• Lähetä lopuksi tilaus.

Jos rajapintahakemus on jo hyväksytty, varmenteen noutamiseen tarvittavat tiedot lähetetään saman tien tekniselle yhteyshenkilölle.

Kun olet lähettänyt varmennetilauksen, tilauksessa nimeämäsi tekninen yhteyshenkilö saa varmenteen noutoon tarvittavat tiedot.

Varmenne on sen jälkeen noudettavissa 14 vuorokauden ajan.

Katso tarkemmat ohjeet varmenteen noutamiseen

Jos haluat muuttaa olemassa olevia testauksen käyttöoikeuksia tai hakea lisää Verohallinnon tai tulorekisterin rajapintoja testaavalla organisaatiolla, kirjaudu Testivarmenteet-osioon uudelleen ja tee korvaava rajapintahakemus.

Korvaava hakemus korvaa aiemmat valinnat, joten merkitse hakemukseen kaikki organisaation käyttämät testauksen rajapinnat. Jotta voit tehdä korvaavan hakemuksen, sinun tulee olla testaavan organisaation ryhmän ylläpitäjä. Lue lisää ryhmien hallinnasta.

Täytä korvaava hakemus samalla tavalla kuin ensimmäinen. Älä poista hakemuksessa jo valmiina olevia valintoja, jos niissä valitut rajapinnat ovat edelleen organisaatiosi käytössä. Jos et enää käytä aiemmin valittuja rajapintoja, voit poistaa valinnat. Silloin myös rajapintojen käyttöoikeus päättyy.

Positiivisen luottotietorekisterin rajapinnat

Jos testaat positiivisen luottotietorekisterin rajapintoja ja haluat muuttaa olemassa olevia testauksen käyttöoikeuksia, ota yhteyttä rekisteriin sidosryhmätestauksen yhteydenottolomakkeella.