Vero API

Vero API on Verohallinnon uusi rajapintapalvelu.

Rajapintapalvelu on tarkoitettu ohjelmistotoimittajille ja muille palveluntarjoajille, jotka tekevät omaa ohjelmistokehitystä. Jos et tee omaa ohjelmistokehitystä, ota yhteyttä ohjelmistotoimittajaasi saadaksesi pääsyn näihin uusiin ominaisuuksiin.

Vero API helpottaa kehitystä tarjoamalla materiaalit ja dokumentaatiot myös englanniksi. Vero API yleiskuvausta voit tarkastella englanninkielisillä sivuillamme Vero API overview.

Vero API rajapintapalvelun saatavuus

Miten pääsen alkuun?

Vaihe 1: Kokeile hiekkalaatikossa

Tutustu ja kokeile API-palveluita hiekkalaatikossa

Vaihe 2: Toteuta ja testaa

Ohjeet testauksen aloittamiseen testivarmenteella

Vaihe 3: Tuotantoon siirtyminen

Ohjeet tuotantoon siirtymiseen

Vero API rajapinnat

Alustatalouden ilmoitukset

Alustatalouden toimijat, kuten välityspalveluiden tarjoajat tai niiden Suomessa toimivat edustajat voivat antaa ilmoituksia välittämistään kuljetuspalveluiden korvauksista ja vuokratuloista tämän rajapinnan kautta. API on käytettävissä seuraavissa ympäristöissä:

Autoverotus

Autoverotuksen rajapintapalveluiden kautta rekisteröidyt autoveroilmoittajat voivat lähettää autoveroilmoituksia, hinnastoja ja esittelyauton käyttöönottoilmoituksia. API on käytettävissä seuraavissa ympäristöissä:

Arvonlisävero

Tarkista arvonlisäveron verokaudet ja eräpäivät, tee arvonlisäveroilmoitus ja hae aiemmin lähetettyjä ilmoituksia. Voit myös tehdä arvonlisäveron yhteenvetoilmoituksen. API on käytettävissä seuraavissa ympäristöissä:

Ennakonpidätystiedot sekä eläke- ja etuustietojen ilmoittaminen

Voit hakea voimassa olevat suorituksen saajan ennakonpidätystiedot, maksajakohtaiset eläkkeiden ja etuuksien saajien ennakonpidätystiedot sekä ilmoittaa eläkkeiden ja etuuksien tietoja. API on käytettävissä seuraavissa ympäristöissä:

Eläkkeiden ja etuuksien dokumentaatio on löydettävissä hiekkalaatikosta.

Uusien alkavien eläke- ja etuustietojen ilmoitusmahdollisuus aukeaa vuonna 2022.

Kirjeet, päätökset ja selvityspyynnöt

Hae asiakkaiden kirjeitä ja selvityspyyntöjä pdf-muodossa. Vastaa selvityspyyntöihin tekstillä ja liitetiedostoilla. API on nyt käytettävissä seuraavissa ympäristöissä:

Maksuviitekysely

Tutustu reaaliaikaisen maksuviitekyselyn rajapintakuvaukseen. API on käytettävissä seuraavissa ympäristöissä:

Rekisteritilan näyttäminen ja muutokset

Tarkista ja tee muutoksia asiakkaan alv-, työnantaja- ja ennakkoperintärekisteritietoihin. Voit tarkistaa myös asiakkaan verokauden pituuden. API on käytettävissä seuraavissa ympäristöissä:

Arvioitu testi- ja tuotantoaikataulu muutosten osalta alkuvuoden 2022 aikana.

Tapahtumahaku

Tapahtumahaun rajapinta vastaa Omaverossa olevaa tapahtumahakua, jolla voi hakea tapahtumia, maksuja ja palautuksia eri verolajeista. API on käytettävissä seuraavissa ympäristöissä:

Varainsiirtovero

Tutustu varainsiirtoveron ilmoittamisen rajapintakuvaukseen. API on käytettävissä seuraavissa ympäristöissä:

testi ja tuotanto

Verkkolaskuosoite

Hae asiakkaan voimassa oleva verkkolaskuosoite. Voit myös ilmoittaa uuden verkkolaskuosoitteen. API on käytettävissä seuraavissa ympäristöissä:

Veronumero

Tutustu veronumerokysely ja -rekisteröinti rajapintakuvauksiin. API on käytettävissä seuraavissa ympäristöissä:

Yhteisön ennakkoveron hakeminen

Tarkista voimassa olevan ennakkoveron määrä, tee uusien tietojen perusteella koelaskenta ennakkoveron määrästä ja hae uutta ennakkoveroa. API on käytettävissä seuraavissa ympäristöissä:

Suunnitteilla olevat rajapinnat

Hiekkalaatikosta löytyviä rajapintoja suunnitellaan. Voit tutustua niiden tietosisällön alustaviin kuvauksiin hiekkalaatikossa.

Siirry hiekkalaatikkoon (linkki avautuu uudessa ikkunassa).

Huomioitavaa kuitenkin on, että suunnitteilla olevien rajapintojen käyttöönotosta ei ole tehty päätöstä. Rajapintojen tietosisällöt voivat muuttua.

Voit ilmaista kiinnostuksesi suunnitteilla oleviin rajapintoihin antamalla palautetta ja mahdollisia kehitysideoita havaintolomakkeen kautta.

Vero API havaintolomake

Rajapintoihin liittyvät yleiset huomiot, tekniset havainnot sekä mahdolliset häiriöt voit ilmoittaa Vero API tuelle havaintolomakkeen avulla.