Tuotantovarmenteet

Varmennepalvelusta saat tuotantovarmenteet

Ennen kuin haet tuotantovarmenteita, tutustu rajapintojen ohjeisiin palveluiden omilla sivuilla. Varmista testaamalla ohjelmistosi toimivuus halutun rajapinnan kanssa.

Varmenteen käyttöönotto vaatii teknistä osaamista. Sovi työnjaosta ja toimintatavoista käyttämäsi ohjelmiston ohjelmistotoimittajan kanssa.

Kun kirjaudut palveluun ensimmäisen kerran, tarkista organisaatiosi tiedot

Ennen 24.10.2024 tehdyt voimassa olevat rajapinnat ja tuotantovarmenteet on kopioitu varmennepalveluun. Historiatietoja eli tietoja vanhentuneista tai noutamattomista varmenteista ei ole tuotu.

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. 

Näin saat varmenteen käyttöösi

  • 1

    Kirjaudu: Tuotantovarmenteet

  • Tuotantovarmenteet tilataan Tuotantovarmenteet-osiosta

    Kirjaudu Verohallinnon varmennepalveluun (Tuotantovarmenteet)

    Tunnistaudu palveluun pankkitunnuksilla, mobiilivarmenteella tai varmennekortilla.

    Tarkista, milloin tarvitset lisäksi Suomi.fi-valtuuden

    Valitse listasta yritys tai organisaatio, jolle haet rajapinnan käyttöoikeutta ja varmennetta. Valittuasi organisaation näet sen käytössä olevat rajapinnat ja varmenteet.

    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 haluamasi rajapinta on jo käytössä, siirry suoraan kohtaan 3. Tilaa varmenne.

  • 2

    Tee rajapintahakemus

  • Verohallinnon ja tulorekisterin rajapinnat

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

    • Valitse, mitä rajapintoja organisaatio tarvitsee.
      • Voit hakea samalla kertaa käyttöoikeuden useampaan rajapintaan, ja haetut rajapinnat voivat olla eri tahojen tarjoamia. Voit valita esimerkiksi Vero API:n Verohallinnolta ja palkkatietojen ilmoittamisen rajapinnan tulorekisteriltä.
      • Jos haet käyttöoikeutta tulorekisterin rajapintaan, ilmoita siitä 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.
      • Varmenteen tekninen yhteyshenkilö ilmoitetaan jokaisessa varmennetilauksessa erikseen.
    • Tutustu rajapintapalveluiden käyttöehtoihin.
    • Lähetä lopuksi hakemus.

    Voit tilata varmenteen heti, kun olet lähettänyt hakemuksen. Suosituksena on, että tilaat oman varmenteen jokaiseen rajapintaan. Voit kuitenkin käyttää samaa tiedon tuottajan Web service -varmennetta Verohallinnon rajapinnoissa ja tulorekisterin ilmoittamisen WS-rajapinnassa.

    Jos organisaatiolla on jo jokin rajapinta käytössä, mutta haluat ottaa uuden rajapinnan käyttöön, valitse Näytä tiedot ja sen jälkeen Tee korvaava hakemus.

    Jos organisaatiosi on tulorekisterin tiedon käyttäjä, tarvitset rajapinnan käyttöä varten tietoluvan. Siksi et voi tehdä rajapintahakemusta varmennepalvelussa. Tutustu tietoluvan ohjeisiin tulorekisterin verkkosivuilla.

  • Positiivisen luottotietorekisterin rajapinnat

    Positiivisen luottotietorekisterin rajapintojen käyttäjän ei tarvitse tehdä erillistä rajapintahakemusta varmennepalvelussa. Voit siirtyä suoraan kohtaan 4. Tekninen yhteyshenkilö noutaa varmenteen.

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

  • 3

    Tilaa varmenne

  • Valitse asiointipalvelussa painike Tilaa uusi varmenne

    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.
  • 4

    Tekninen yhteyshenkilö noutaa varmenteen

  • Tekninen yhteyshenkilö vastaa varmenteen noutamisesta ja käyttöönotosta

    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

  • 5

    Jos haluat muuttaa käyttöoikeuksia

  • Verohallinnon ja tulorekisterin rajapinnat

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

    Korvaava hakemus korvaa aiemmat valinnat, joten merkitse hakemukseen kaikki organisaation käyttämät rajapinnat.

    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 käytät positiivisen luottotietorekisterin rajapintoja ja haluat tehdä muutoksia, ota yhteyttä positiivisen luottotietorekisterin asiakaspalveluun.

Huomioitavaa ohjelmistoista ja varmenteista

  • Jos ohjelmistotalo hoitaa Verohallinnon tai tulorekisterin rajapinta- ja varmenneasiat asiakkaansa puolesta, sillä pitää olla palvelusopimus asiakkaansa kanssa rajapintapalveluiden käyttöehtojen mukaisesti.
  • Jos ohjelmistosi on tarkoitettu esimerkiksi tilitoimistojen tai muiden palveluntarjoajien käyttöön eikä suoraan ilmoitus- tai verovelvollisille yrityksille, pitää asiakkaittesi, esimerkiksi tilitoimiston, tehdä rajapintahakemus ja tilata varmenteet itse.
  • Varmenteen noudon jälkeen ohjelmistotalon pitää itse ohjata asiakkaitaan siihen, miten varmenteita heidän käyttämässään ohjelmistossa käsitellään. Varmenne toimii organisaation sähköisenä allekirjoituksena.
  • Verohallinto suosittelee, että ohjelmistokehittäjät toteuttavat tuotantovarmenteen noutamisen ja uusimisen osaksi varmenteita hyödyntävää ohjelmistoa.
Sivu on viimeksi päivitetty 24.10.2024