Puolesta asiointi Vero API -rajapinnoissa
Vero API -rajapinnoilla on mahdollista ilmoittaa tai kysellä tietoja oman organisaation puolesta tai jonkun toisen organisaation puolesta valtuutettuna. Jos rajapintojen käyttäjä asioi oman organisaation asioissa, erillistä Suomi.fi-valtuutta rajapintojen käyttämiseen ei tarvita. Sen sijaan, jos rajapintojen käyttäjä asioi toisen organisaation puolesta, voi käyttäjä tarvita erillisen Suomi.fi-valtuuden. Suomi.fi-valtuuden tarve on erikseen kerrottu aina kyseisen rajapinnan API-portaalin dokumentaatiossa.
Vero API -rajapinnat hyödyntävät Digi- ja Väestötietoviraston (DVV) tarjoamaa Suomi.fi-valtuuspalvelua, jonka kautta henkilöt ja yritykset voivat valtuuttaa toisia henkilöitä tai yrityksiä asioimaan heidän puolestaan eri viranomaisasioissa, kuten veroasioiden hoitamisessa. Suomi.fi-valtuuksia voi antaa ja pyytää DVV:n suomi.fi palvelussa. Lisätietoa veroasioinnin valtuuksista ja valtuuttamisesta löydät täältä Näin valtuutat - vero.fi.
Alla on käyttötapausesimerkkejä, miten asioiminen voi tapahtua joko oman organisaation puolesta tai toisen organisaation puolesta valtuutettuna.
Esimerkki 1: Tilitoimistolla on käytössään kirjanpito- ja palkanlaskentasovellus, jossa on käytössä kirjeiden kysely API rajapinta. Tilitoimisto käyttää rajapintaa omien veroasioidensa hoitamiseen ja kyselee rajapinnalla kirjeitä, jotka ovat tulleet Verohallinnolta vain tilitoimistolle itselleen. Tilitoimisto asioi tässä tapauksessa oman organisaation asioissa eikä se hoida muiden yritysten veroasioita kyseisellä rajapinnalla. Kirjeitä ei siis kysellä muiden organisaatioiden puolesta eikä tilitoimiston tarvitse erikseen hakea Suomi.fi valtuutta rajapinnan käyttämiseen.
Esimerkki 2: Tilitoimistolla on käytössään kirjanpito- ja palkanlaskentasovellus, jossa on käytössä kirjeiden kysely API rajapinta. Tilitoimisto hoitaa toisten yritysten vero- ja kirjanpitoasioita ja se käyttää kyseistä rajapintaa apuna tässä toiminnassa. Tilitoimisto kyselee rajapinnalla yritysasiakkaidensa kirjeitä, jotka ovat saapuneet Verohallinnolta. Tilitoimisto pystyy kirjeiden hakemisen jälkeen reagoimaan niihin sopivalla tavalla. Tilitoimisto asioi tässä tapauksessa toisen organisaation puolesta ja se tarvitsee oikean Suomi.fi valtuuden rajapinnan käyttämiseen.
Suomi.fi valtuuksia tarvitaan tällä hetkellä seuraavissa Vero API rajapinnoissa:
- Kirjeet ja päätökset-rajapinnat
- Roolirekisteröintitietojen päivitys
- Toimialan ja tilikausien kysely
- Verokausitietojen kysely
- Saldotietojen kysely
- Tapahtumahaku
- Autoverotuksen päätösrajapinnat ja ilmoituksen tilan kyselyrajapinnat
- EMCS-rajapinnat
- Valmisteverot
- Kotitalousvähennystietojen ilmoittaminen
- Eläke- ja etuustietojen ilmoittaminen sekä eläkkeiden ja etuuksien ennakonpidätystiedot maksajille -kysely
- Arvonlisäveroveron ja yhteenvetoilmoituksen rajapinnat
- Yhteisöverotuksen rajapinnat (ennakkovero, voitonjako, osakkeen arvotiedot)