Vero API

Vero API on Verohallinnon rajapintapalvelu reaaliaikaisiin ja tapauskohtaisiin käyttötilanteisiin.

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.

Rajapintojen käyttö edellyttää käyttäjäkohtaista varmennetta ja ohjelmistokohtaista API-avainta.

Miten pääsen alkuun?

Vaihe 1: Kokeile hiekkalaatikossa

Tutustu ja kokeile API-palveluita hiekkalaatikossa.

Lue lisää

Vaihe 2: Toteuta ja testaa

Ohjeet testauksen aloittamiseen.

Lue lisää

Vaihe 3: Tuotantoon siirtyminen

Ohjeet tuotantoon siirtymiseen.

Lue lisää

Vero API rajapinnat

Henkilöverotuksen rajapinnat

  • Kotitalousvähennystietojen ilmoittaminen palkanmaksajille
  • Kotitalousvähennystietojen ilmoittaminen yrityksille
  • Eläke- ja etuustietojen ilmoittaminen
  • Muuttuneet eläkkeiden ja etuuksien ennakonpidätystiedot maksajille
  • Ennakonpidätystiedot maksajille kysely
  • Verovelvollisuusaseman kysely
  • Vuokratulotietojen ilmoittaminen

Hiekkalaatikko  Vero API portaali

Autoverotus

  • Ilmoitus esittelyajoneuvosta
  • Jaksokohtaiset autoverotuspäätökset
  • Ajoneuvokohtaiset autoverotuspäätökset
  • Jaksokohtainen autoveroilmoitus
  • Uusien ajoneuvojen hintatietoilmoitukset
  • Ajoneuvokohtainen autoveroilmoitus
  • Ajoneuvokohtaisen ilmoituksen tila
  • Ajoneuvon tietojen haku Verohallinnon tiedoista

Hiekkalaatikko  Vero API portaali

Kirjeet ja päätökset

  • Hae kirje tai selvityspyyntö
  • Listaa selvityspyynnöt
  • Listaa kirjeet
  • Lähetä liitetiedosto selvityspyyntöön
  • Vastaa selvityspyyntöön

Hiekkalaatikko Vero API portaali

Verotusroolit

  • Rekisteröintitietojen päivitys
  • Toimialan ja tilikausien kysely
  • Rekisteröintitietojen kysely
  • Verokausitietojen kysely

Hiekkalaatikko Vero API portaali

Tunnukset

  • Verkkolaskuosoitteen kysely
  • Verolajikohtaisten viitenumeroiden kysely
  • Veronumerorekisteröinti
  • Verkkolaskuosoitteen päivitys
  • Veronumerorekisterin kysely

Hiekkalaatikko Vero API portaali

Oma-aloitteiset verot

  • Lähetä arvonlisäveron yhteenvetoilmoitus
  • Lähetä arvonlisäveroilmoitus
  • Hae annettu arvonlisäveroilmoitus
  • Hae arvonlisäveron kaudet

Hiekkalaatikko Vero API portaali

Yhteisöverotus

  • Koelaskenta ennakkoveron muutostarpeesta
  • Tarkista voimassaolevan ennakkoveron määrä
  • Lähetä uusi ennakkoverohakemus
  • Ilmoita voitonjako
  • Osakkeen arvotietojen kysely

Hiekkalaatikko Vero API portaali

EMCS-järjestelmän rajapinnat

EMCS-järjestelmää (Excise Movement and Control System) käyttävät yritykset voivat antaa valmisteverollisten tuotteiden siirtoja koskevia ilmoituksia tämän rajapinnan kautta. 

Lue lisää: EMCS-järjestelmän rajapinnat siirtyvät Vero APIin

 

Hiekkalaatikko Vero API portaali

Maksutiedot

  • Saldotietojen kysely
  • Tapahtumahaku

Hiekkalaatikko Vero API portaali

Koodistot

  • Koodien ja selitteiden kysely

Hiekkalaatikko Vero API portaali

Suomi.fi asiointivaltuus

  • Hae Suomi.fi valtuus-token rajapinta asiointia varten

Hiekkalaatikko Vero API portaali

Notifikaatiopalvelu

  • Päätä notifikaatioiden tilaus
  • Listaa notifikaatiot
  • Listaa notifikaatioiden tilaukset
  • Tilaa notifikaatioita
  • Hae notifikaatio
  • Rekisteröi Push-rajapinta

Hiekkalaatikko Vero API portaali

Valmisteverot

  • Lähetä virvoitusjuomaveroilmoitus
  • Lähetä juomapakkausveroilmoitus
  • Lähetä alkoholiveroilmoitus
  • Hae aiemmin annetut ilmoitukset

Hiekkalaatikko  Vero API portaali

Varainsiirtovero

  • Lähetä varainsiirtoveroilmoitus

Vero API portaali

Suunnitteilla olevat rajapinnat

Hiekkalaatikosta löydät nykyiset ja suunnitteilla olevat rajapinnat. Voit tutustua siellä uusien rajapintojen tietosisällön alustaviin kuvauksiin. 

Siirry hiekkalaatikkoon

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.

Vero API rajapintapalvelun saatavuus

Testiympäristö on käytettävissä klo 8.00–16.00. Muina aikoina saattaa olla suunniteltuja huoltokatkoja. Testiympäristö ei ole käytettävissä sunnuntaisin.

Tuotantoympäristö on käytettävissä lähes ympäri vuorokauden. Huoltotoimenpiteitä tehdään arkipäivinä klo 17.00–18.00 ja klo 21.00 viikonloppuisin. Näiden lisäksi tuotannossa on säännöllinen huoltoikkuna klo 10.00 - 14.00 jokaisen kuukauden joka kolmas sunnuntai sekä jokaisen kuukauden viimeinen torstai klo 17:00 - 01:30. Huoltoikkunoiden aikana palveluissa saattaa esiintyä katkoksia.

Huoltokatkot ja häiriöt -sivulta voit tarkistaa, mitä suunniteltuja huoltokatkoja tai muita poikkeustilanteita Verohallinnon asiointipalveluissa ja asiakaspalvelussa on.

Sivu on viimeksi päivitetty 11.10.2024