Siirry tuotantoon
Tuotannon rajapintojen käyttöönotto
Ohje on jaettu rajapintaa käyttävän organisaation ja ohjelmiston kehittäjän toimenpiteisiin.
Rajapintaa käyttävä organisaatio
Rajapintojen käyttäjäorganisaatiolta, ohjelmiston käyttäjältä, edellytetään tuotantovarmennetta. Tuotantovarmenne toimii käyttäjän tunnistetietona. Rajapintojen käyttäjä voi olla asiakas eli ilmoitusvelvollinen itse tai hänen valtuuttama osapuoli rajapintojen käyttöehtojen mukaisesti.
Ohjelmiston kehittäjä
Ohjelmiston kehittäjä rekisteröi ohjelmistonsa API-portaalissa ja valitsee sen käyttämät rajapinnat ennen tuotantokäytön aloittamista. Rekisteröity ohjelmisto saa API-avaimen. API-avain on ohjelmistokohtainen ja toimii ohjelmiston tunnisteena. API-avain ei ole tarkoitettu ohjelmiston käyttäjien hallittavaksi, vaan ohjelmiston kehittäjän tulee rakentaa sen käsittely ohjelmiston sisälle.
Ohjelmiston kehittäjä varmistaa ohjelmiston tuotantoyhteyden ja API-avaimen teknisen toimivuuden käyttämiään rajapintoja vasten. Varmistus tehdään omatoimisesti API-portaalissa julkaistua integraation verifiointiosoitetta vasten (URL Integraation verifiointi).
Integraation verifioinnin jälkeen ohjelmisto on tuotantovalmis.
Lue lisää ohjelmiston rekisteröinnistä
Tuotantovarmenteen hakeminen:
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.
- Tee rajapintahakemus ja tilaa varmenne Verohallinnon varmennepalvelussa.
- Tuotantovarmenteiden tilaaminen on siirtynyt 24.10.2024 tulorekisterin sähköisestä asiointipalvelusta Verohallinnon varmennepalveluun.
- Tutustu Verohallinnon varmennepalvelun tuotantovarmenteet ohjeisiin.
- kun varmenne saadaan noudetuksi varmennehakemuksessa ilmoitettu tekninen yhteyshenkilö vastaa varmenteen syöttämisestä ohjelmistoon. Ilman varmennetta Vero API rajapinta ei palauta käyttäjäorganisaation pyytämää aineistoa.
- Vero API rajapinnat vastaavat tuotantovarmenteella tehtyihin kutsuihin vasta, kun olemme noutaneet muodostetun varmenteen ja asentaneet sen ympäristöömme. Varmenteet noudetaan Vero API käyttöön tulorekisterin varmennepalvelusta. Pääsääntönä voidaan pitää sitä, että virka-aikana varmennepalvelussa (klo 8.00-16.15) muodostetut tuotantovarmenteet toimivat Vero API rajapintojen kutsuissa viimeistään seuraavana päivänä.
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 Vero API-portaalista