Ulkomaisen organisaation ja henkilöasiakkaan asiointi varmennepalvelussa
Ohjeessa kerrotaan, kuinka ulkomainen organisaatio ja henkilöasiakas voivat asioida Verohallinnon varmennepalvelussa.
Kirjautuminen Varmennepalveluun
Ulkomaalainen asiakas kirjautuu varmennepalveluun Digi- ja väestötietoviraston tarjoamalla Finnish Authenticator -sovelluksella.
Ota sovellus käyttöön ennen kirjautumista. Sen jälkeen voit käyttää sitä tunnistautumisvälineenä kirjautuessasi palveluun. Sovellus toimii sekä tuotanto- että testivarmenneasioinnissa. Lue lisää: Finnish Authenticator -sovelluksen käyttöönotto - Suomi.fi.
Tuotantovarmenneasioinnissa voit vahvan tunnistautumisen lisäksi käyttää Suomi.fi valtuuksia. Lue lisää ulkomaisen organisaation ja henkilöasiakkaan valtuuksista ja tuotantovarmenteiden hausta.
Testivarmenneasiointiin riittää, että olet ottanut käyttöön pelkän Finnish Authenticator -sovelluksen.
Jos olet ottanut Finnish Authenticatorin käyttöösi, voit aloittaa asioinnin Varmennepalvelussa ja pystyt tekemään rajapintahakemuksia ja varmennetilauksia.
Lue yleiset Varmennepalvelun käyttöohjeet
Varmenteen tilaaminen ulkomaalaisella yritystunnuksella
Varmenteita pystyy tilaamaan seuraavilla yritystunnustyypeillä:
- Suomalainen y-tunnus
- Ulkomaalainen tunniste (vapaamuotoinen tunnus)
- Ture-tunnus (vain Tulorekisterin tiedon käyttäjä tunnus)
- ALV-tunniste (määrämuotoinen EU-tunniste)
- Keinotunnus (käytössä testivarmenteissa, muodoltaan suomalainen y-tunnus)
Tuotantovarmenneasioinnissa varmenteelle tuleva yritystunnustyyppi määräytyy sen mukaan, millä tunnustyypillä asiakas on tunnistautunut.
Esimerkki 1:
Ulkomainen henkilöasiakas on tunnistautunut Finnish Authenticatorilla ja hänellä on haettuna Suomi.fi valtuus tiettyyn ulkomaiseen organisaatioon. Asiakas valitsee kyseisen organisaation Suomi.fi valintalistalta kirjautumisen yhteydessä ja kirjautuu valtuutettuna asioimaan kyseisen organisaation puolesta. Asiakas tekee tuotantovarmennetilauksen. Tuotantovarmenteelle tulee automaattisesti ulkomaalainen tunniste. Jos asiakas taas on valtuutettu ulkomaalaiseen yritykseen, jolla on ALV-tunniste, silloin myös varmenteelle tulee ALV-tunniste.
Esimerkki 2:
Suomalainen organisaatio on myöntänyt Suomi.fi valtuuden ulkomaiselle organisaatiolle asioida sen puolesta Varmennepalvelussa. Ulkomaisen organisaation edustajalle on myönnetty oikea valtuus asioida ulkomaisen organisaation edustajana (edustamisvaltuus). Ulkomainen henkilöasiakas on tunnistautunut Varmennepalveluun Finnish Authenticatorilla.
Asiakas valitsee kirjautumisen yhteydessä suomalaisen organisaation (y-tunnuksen ja nimen) Suomi.fi valintalistalta ja kirjautuu edustajana asioimaan kyseisen organisaation puolesta. Asiakas tekee tuotantovarmennetilauksen. Tuotantovarmenteelle tulee automaattisesti suomalaisen organisaation y-tunnus tunnisteeksi.
Testivarmenneasioinnissa ulkomainen organisaatio käyttää omaa ulkomaalaista yritystunnustaan, mutta testirajapinnoille ja testivarmenteille on käytössä erikseen keinotunnukset kaikille asiakkaille, myös ulkomaalaisille organisaatioille. Keinotunnukset ovat aina muodoltaan suomalaisia y-tunnuksia. Jos ulkomainen organisaatio tilaa testivarmenteen, varmenteen tyypiksi tulee keinotunnus.
Verohallinnon rajapintapalveluiden käyttö ulkomaisella yritystunnuksella tilatulla varmenteella
Varmennepalvelun varmenteet ovat käytössä seuraavissa Verohallinnon rajapintapalveluissa:
- Vero API
- APItamoPKI
- Tulorekisteri
- Positiivinen luottotietorekisteri.
Ulkomaisella tunnisteella tilattua varmennetta ei voi käyttää kaikkiin rajapintapalveluihin, vaan jokaisessa palvelussa on erikseen määritelty, millaisella yritystunnuksella tilattu varmenne hyväksytään rajapintakutsuissa.
Jos ulkomaista tunnistetta ei hyväksytä rajapintapalvelussa, ulkomainen organisaatio ei voi käyttää kyseistä varmennetta rajapintakutsuihin. Tällöin ulkomainen organisaatio voi
- hakea valtuutusta suomalaiselta yritykseltä, jotta organisaatio pystyy hakemaan varmenteen suomalaiselle y-tunnukselle.
- ilmoittaa tiedot mahdollisuuksien mukaan OmaVerossa.
- olla yhteydessä kyseiseen rajapintapalveluun havaintolomakkeella ja pyytää neuvontaa.
Tuotantovarmenteen käyttö ulkomaisella varmenteella
- Vero API -rajapinnat hyväksyvät ainoastaan varmenteet, jotka on tilattu suomalaisella y-tunnuksella.
- APItamoPKI -rajapinnat hyväksyvät varmenteet, jotka on tilattu suomalaisella y-tunnuksella ja ALV-tunnisteella.
- Tulorekisterin rajapinnat hyväksyvät varmenteet, jotka on tilattu suomalaisella y-tunnuksella ja Ture-tunnuksella.
- Positiivisen luottotietorekisterin rajapinnat hyväksyvät varmenteet, jotka on tilattu suomalaisella y-tunnuksella ja ulkomaisella tunnisteella.
Testivarmenteen käyttö ulkomaisella varmenteella
- Vero API -Testirajapinnat hyväksyvät kaikki testivarmenteet, joissa tunnustyyppi on keinotunnus (y-tunnus).
- APItamoPKI - Testirajapinnat hyväksyvät kaikki testivarmenteet, joissa tunnustyyppi on keinotunnus (y-tunnus).
- Tulorekisterin -Testirajapinnat hyväksyvät kaikki testivarmenteet, joissa tunnustyyppi on keinotunnus (y-tunnus).
- Positiivisen luottotietorekisterin -Testirajapinnat hyväksyvät kaikki testivarmenteet, joissa tunnustyyppi on keinotunnus (y-tunnus).