Vero API on Verohallinnon rajapintapalvelu, jonka avulla ohjelmistotalot, tilitoimistot ja muut palvelun tarjoajat voivat ilmoittaa tai hakea verotukseen liittyvää tietoa reaali-aikaisesti. API, eli Application Programming Interface tarkoittaa ohjelmointirajapintaa kahden eri ohjelmiston välillä. Vero API rajapintoja kehitetään Verohallinnossa erilaisiin käyttökohteisiin verotuksessa, joiden on tunnistettu helpottavan ja nopeuttavan veroasioiden hoitamista sekä vähentävän hallinnollista työtä eri toimijoilta, kuten: verovelvolliset yritykset ja henkilöt, puolesta asioivat organisaatiot tai tilitoimistot.
Vero API rajapintoja löytyy tällä hetkellä yli 80, liittyen eri verotusalueisiin ja käyttötarkoituksiin. Rajapinnat jakautuvat kahteen päätyyppiin: tietojen ilmoittamiseen ja tietojen kyselyyn. Verohallinto suunnittelee, kehittää ja julkaisee uusia Vero API rajapintoja uusien tunnistettujen verotus- ja asiointitarpeiden mukaisesti.
Rajapintojen käyttö ei maksa mitään, mutta ohjelmistotalon tulee rakentaa integraatio Vero API rajapinnalle omaan ohjelmistoonsa. Myös ohjelmiston kehitystyö, toteutusratkaisu ja kustannukset ovat ohjelmistotalon omalla vastuulla.
Kenelle rajapinnat on tarkoitettu ja mitä hyötyä niiden käytöstä on?
Vero API rajapintapalvelu on tarkoitettu ohjelmistotoimittajille ja muille palveluntarjoajille, jotka tekevät omaa ohjelmistokehitystä. Rajapinnat voidaan integroida erilaisiin käyttäjän ohjelmistoihin, esimerkiksi: kirjanpito-, palkanlaskenta- tai toiminnanohjausohjelmistoihin.
Samaan ohjelmistoon voidaan rakentaa esimerkiksi prosessit, joissa tarvittavat verotustietojen ilmoittamis- tai hakemisprosessit automatisoidaan Vero API rajapintoja käyttäen ja rajapintojen käyttö liitetään olennaiseksi osaksi ohjelmiston muihin toimintoihin, esimerkiksi kirjanpitoasioiden hoitamiseen.
Esimerkki alkaa
Esimerkki: Kirjanpito- tai palkanlaskenta ohjelmisto voi ottaa käyttöön Ennakonpidätystietojen kysely -rajapinnan, jonka avulla ohjelmiston käyttäjä saa kaikkien työntekijöidensä uusimmat verokortit haettua ohjelmallisesti suoraan Verohallinnon omasta järjestelmästä. Työntekijöiden uusia verokortteja ei tarvitse kerätä työntekijöiltä paperiversiona tai pdf-tiedostoina, vaan verokortit haetaan rajapintaintegraatiolla automaattisesti Verohallinnolta aina, kun uusia verokortteja on luotu henkilöille.
Sama kirjanpito-ohjelmisto voi käyttää myös esimerkiksi kirjeiden kyselyn rajapintoja. Tällä rajapinnalla ohjelmiston käyttäjä saa haettua Verohallinnolta saapuneet kirjeet ja pystyy reagoimaan niihin välittömästi. Tili- tai palkanlaskentatoimiston ei siis tarvitse kysellä ja kerätä verokortteja työntekijöiltä itseltään eikä heidän tarvitse kirjautua Omaveroon valtuutettuna tarkastelemaan asiakkaidensa tietoja.
Esimerkki päättyy
Roolit rajapintojen käytössä
Seuraavissa esimerkkikuvauksissa on kerrottu, millaisia rooleja eri osapuolilla Vero API -rajapintapalvelussa on.