Mitä rajapinnat ovat?
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: 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.
Roolit rajapintojen käytössä
Seuraavissa esimerkkikuvauksissa on kerrottu, millaisia rooleja eri osapuolilla Vero API -rajapintapalvelussa on.
- Tarjoaa Vero API -rajapintapalvelun ohjelmistotaloille käytettäväksi.
- Tarjoaa ohjelmistotaloille teknistä tukea rajapintojen käyttöönottoon ja käyttöön.
- Tutustuu Vero API -rajapintojen tarjontaan, valitsee omaan liiketoimintaansa ja ohjelmistoihinsa sopivia rajapintoja.
- Kehittää Vero API -integraation omaan ohjelmistoonsa ja tarjoaa sitä eri toimijoille käytettäväksi.
- Esimerkiksi tilitoimisto voi käyttää ohjelmistotalon kehittämää taloushallinnon ohjelmistoa, jonka avulla hoidetaan tilitoimiston henkilö- ja yritysasiakkaiden veroasioita.
- Esimerkiksi tilitoimisto tai konsulttiyritys, joka hoitaa useiden eri henkilöiden tai yritysten veroasioita.
- Organisaatio toimii joko valtuutettuna (Suomi.fi) tai perustuen muuhun keskinäiseen sopimukseen.
- Käyttää liiketoiminnassaan avuksi ohjelmistoa, jossa on Vero API integraatio mukana.
- Ohjelmisto on ostettu valmiina tai tilattu erikseen ohjelmistotalolta.
- Esimerkiksi suurempi taloushallinto- ja ohjelmistokehitysyritys tai alustapalvelu.
- Kehittää Vero API -integraation itse omaan ohjelmistoonsa.
- Hoitaa omien asiakkaidensa veroasioita suoraan oman ohjelmistonsa avulla.
- Ei tarjoa omaa ohjelmistoaan käytettäväksi muille toimijoille.
- Verovelvollinen yritys tai henkilö, jonka puolesta veroasiat hoidetaan rajapintaintegraation avulla.
- Asiakkaan veroasiat hoidetaan toisen organisaation toimesta joko valtuutettuna tai muuhun sopimukseen perustuen.
- Esimerkiksi tilitoimiston, konsulttiyrityksen tai muun palveluntarjoajan asiakas.