Siirry tuotantoon

Tuotannon rajapinnan Vero API käyttöönotto

Ennen kuin rajapintaa hyödyntävä käyttäjäorganisaatio voi käyttää Vero API rajapintaa, edellyttää se tuotantovarmenteen hakemista. Jos käyttäjäorganisaation sovelluksessa on jo käytössä tulorekisterin tiedon tuottajan Web Service varmenne, uutta varmennetta ei tarvitse hakea vaan myös Vero API toimii samalla varmenteella.

Tuotantovarmenteen hakeminen tapahtuu seuraavasti:

Hakemus tehdään tulorekisterin sähköisessä asiointipalvelussa.

  • asiointipalvelussa valitaan yritys, jolle varmennetilaus tehdään (tuotantovarmennetta voi hakea ainoastaan varmennetta hakevan tahon nimenkirjoitusoikeudellinen henkilö)
  • yrityksen sivuilta valitaan; asetukset > tekninen rajapinta ja varmenteet > hae uutta varmennetta
  • tuotannon varmenne tyypiksi tulee valita Web Service
  • tuotantovarmenteen käyttäjän on hyväksyttävä ja noudatettava Verohallinnon ja tulorekisterin rajapintapalveluiden käyttöehtoja (pdf)
  • hakemuksessa tulee ilmoittaa tekninen yhteyshenkilö. Tekninen yhteyshenkilö hoitaa tekniset käytännön asiat varmenteen haussa
  • hakemus lähetetään Lähetä-painikkeella. Lähetys käynnistää varmenteen tilauksen
  • tekniselle yhteyshenkilölle lähetetään turvasähköpostilla tarvittavat tiedot varmenteen muodostamista varten sekä matkapuhelinnumeroon tekstiviestillä PIN-koodi viestin avaamista varten. PIN-koodi lähetetään sen jälkeen, kun varmenteen hakemisen yhteydessä lähetetyn suojatun sähköpostin "Avaa viesti" -linkkiä on painettu. Varmenne on noudettava 14 vrk sisällä hakemuksen tekemisestä Web Service rajapinnan kautta
  • kun varmenne saadaan noudetuksi rajapintapalvelun kehittäjä vastaa varmenteen syöttämisestä ohjelmistoon. Ilman varmennetta rajapinta ei palauta käyttäjäorganisaation pyytämää aineistoa.

Varmennepalvelusta voi lukea tarkemmin tulorekisterin omilta sivuilta:
Varmennepalvelu
Kysymyksiä ja vastauksia varmennepalvelusta

Kannattaa tutustua myös tulorekisterin tekemään ohjevideoon:
Tulorekisterin tiedon tuottaja - Hae uutta varmennetta

Huomioita ohjelmistokehittäjille:

  • Tuotantovarmennetta hakevalla organisaatiolla tulee olla suora palvelusopimus rajapintapalveluiden käyttöehtojen mukaisen asiakkaan kanssa. Mikäli ohjelmistosi on tarkoitettu esimerkiksi tilitoimistojen tai muiden palveluntarjoajien käyttöön eikä suoraan ilmoitus- tai verovelvollisille, tulee käyttäjäorganisaatioiden hakea varmenne.
  • Varmenteen noudon jälkeen ohjelmistotalon tulee itse ohjata käyttäjäorganisaatioitaan siihen, miten varmenteiden käsittely kyseisen ohjelmiston osalta tapahtuu.
  • Käyttäjäorganisaation varmenne tulee syöttää ohjelmiston sisään, koska aineistoa haettaessa varmenne toimii käyttäjäorganisaation sähköisenä allekirjoituksena.
  • Verohallinto suosittelee tuotantovarmenteen muodostamisen sekä uusimisen toteuttamista osaksi varmenteita hyödyntävää ohjelmistoa.

Tuotantoympäristö

Vero API rajapintojen dokumentaatiot ja tuotantoympäristön URL:t löydät osoitteesta: https://avoinomavero.vero.fi/APIPortal/