Ennakonpidätystietojen nouto -näkymällä voi noutaa Verohallinnosta (VeroAPI) palkkaverokortteja ja muita tulotyyppejä palkansaajille ilman aikarajoitusta joko manuaalisesti tai automaattisesti. Näkymä löytyy ohjelman kohdasta Palkat > Ennakonpidätystietojen nouto.

Ennakonpidätystietojen haulla palkansaajan palkkatietoihin tuodaan:

Käyttäjät, joilla on käyttöoikeudet palkanlaskentaan sekä ilmoituksiin pääsevät Ennakonpidätystietojen nouto -näkymälle ja noutamaan verokorttitietoja.

Manuaalisessa ja automaattisessa noutotavassa käytetään varmennetta. Manuaalisessa noudossa käytetään noudon käynnistäjän Omat tiedot ja asetukset -kohdassa valittua tulorekisterivarmennetta.

Koska automaattinen nouto käynnistyy ilman käyttäjän toimenpiteitä, varmenteena ei voida käyttää käyttäjän asetuksiin määritettyä varmennetta, vaan automaattinoudossa käytetään yrityksen käyttöasetuksiin määritettyä varmennetta.

Asiakasyritysten ennakonpidätystietoja voi noutaa myös Tilitoimiston tulorekisterivarmenteella.

Ennakonpidätystiedot voi hakea palkansaajille, joilla on palkkaverokortti tai muu tulotyyppi käytössä.

Voit valita, mille tulotyypille verokorttitiedot haetaan. Tämä mahdollistaa esimerkiksi työkorvausten verokorttitietojen haun. Palkansaajalla voi olla käytössä useamman eri tulotyypin mukaisia verokortteja. Ennakonpidätystietojen noudossa käytettävät verokortin tulotyypit määritellään palkansaajan palkkatiedoissa kohdassa Palkat > Palkansaajarekisteri > Palkkatiedot > Verokortti. Huomaathan, että jos Ennakonpidätystietojen noudossa käytettävät verokortin tulotyypit -alasvetovalikossa ei ole tehty valintaa (Ei valintoja), ei palkansaaja nouse mukaan ennakonpidätystietojen noudon hakulistalle.

Uusin (viimeisimmällä päivällä) oleva verokortti on aina voimassa oleva kortti.

Poikkeukset koskien muutosverokortteja

.

Voit hakea ennakonpidätystietoja kaikkien niiden palkansaajien osalta, joiden Palkkatiedot -näkymälle on täytetty pakolliset tiedot. Tämän lisäksi Henkilörekisteristä täytyy löytyä myös palkansaajan tilinumero sekä henkilötunnus kirjattuna tietoihin HETU-tunnuksella.

Ennakonpidätystietojen nouto -näkymän hakuehdoissa Palkansaajien listausta voi sortata palkansaajan nimen tai perustetun henkilöryhmän perusteella. Hakuun voi sisällyttää myös passiiviseksi asetetut henkilöt.

Hae -painikkeella suoritat ehtojen mukaisen haun ja Tyhjennä -painikkeella tyhjennät hakuehdot ja ohjelma listaa uudelleen kaikki palkansaajat näkyville.

Verokortit voidaan noutaa kahdella tavalla:

Manuaalisessa noudossa käyttäjä käynnistää noudon itse Ennakonpidätystietojen nouto -toiminnolla ja antaa päivämäärän, jolle verokortit noudetaan, esimerkiksi palkkakauden palkkapäivän.

Verohallinto palauttaa kaikille valituille palkansaajille verokortin, joka on voimassa annettuna päivänä. Noudettu verokortti päivitetään Procountoriin vain, jos se eroaa palkansaajalla olevasta verokortista.

Uusi pyyntö - näkymän taulukko listaa oletuksena näkyville kaikki ympäristöön lisätyt palkansaajat tai erikseen hakuehtojen mukaisesti määritellyt palkansaajat. Taulukko kertoo palkansaajakohtaisesti viimeisimmän haetun verokortin tilan.

Näin haet uudet verokorttitiedot verottajalta

Pyyntö lähetetään 5min sisällä ja vastaus on melkein välitön.

Uudet Verokorttitiedot päivitetään, mikäli verokortin voimaantulopäivä, lisä% tai vuosituloraja on muuttunut. Jos tiedot ovat samat kuin edellisessä verokortissa, uutta verokorttia ei lisätä. Jos esimerkiksi palkansaajan veroprosenttia on muutettu manuaalisesti Palkkatiedot -näkymällä viimeisimmän haetun verokortin jälkeen ja tämän jälkeen palkansaaja sisällytetään uudelleen hakuun, ei verokorttitietoja päivitetä.

Jonossa = Odottaa lähetystä Procountorin puolella (5min lähetysväli).
​Käynnissä = Lähetetty Verohallinnolle.
​Vastaanotettu, uusi = Uusi verokortti on tallennettu palkansaajan taakse Palkansaajarekisteri / Palkkatiedot -välilehdelle.
​Vastaanotettu, ei muutoksia = Verokorttia ei tallennettu, koska se on sama kuin edellinen.
​Vastaanotettu, puutteellinen = Verokorttia ei ole saatavilla. Pyydä palkansaajaa hakemaan verokorttia verottajalta.

Ei tietoja/ tyhjä = Ensimmäistä verokortti hakua ei ole vielä tehty.
​Epäonnistunut / Virhe= Ennakonpidätystietojen haku epäonnistui jostain syystä. Lisätiedot -sarakkeessa ilmoitetaan virheilmoitus, joka tulee suoraan Verohallinnon palvelusta.

Verohallinnon antamat virheilmoitukset (Jos saat jonkin alla olevista virheilmoituksista, ole yhteydessä Verohallintoon lisäohjeiden saamiseksi):

Versiopäivityksen 111.0 yhteydessä (14.3.2026) julkaistaan verokorttien automaattinen nouto.

Automaattisessa noudossa ohjelma noutaa joka yö ne muuttuneet verokortit, joista Verohallinto on antanut tiedon ennen noudon käynnistymistä ja päivittää muuttuneet verokortit palkansaajille ilman käyttäjän toimenpiteitä.

Automaattinen nouto otetaan käyttöön valitsemalla Salli Ennakonpidätystietojen automaattinen nouto Hallinta > Yrityksen tiedot > Käyttöasetukset-sivun Integraatioasetukset kohdassa. Lisäksi Käytettävä tulorekisterivarmenne -kohdassa valitaan varmenne, jota automaattinouto käyttää.

Kun uusi palkansaaja lisätään palkansaajarekisteriin, noudetaan palkansaajalle kyseisenä päivänä voimassa oleva verokortti automaattisesti, jos automaattinouto on otettu käyttöön ja palkansaajaa ei ole suljettu pois automaattinoudosta.

Automaattinouto näytetään myös Palkat > Ennakonpidätystietojen nouto > Hakuhistoria-välilehdellä.

Etusivun Uusimmat automaattisesti haetut verokortit -widgetissä näytetään automaattisesti haetut verokortit viimeisen viikon ajalta. Widgetissä näytetään aikaleima, palkansaajan nimi sekä noudossa mahdollisesti tullut virhe. Widgetin Ennakonpidätystietojen nouto -painikkeella pääsee helposti siirtymään Ennakonpidätystietojen nouto -näkymälle, jonka Hakuhistoria -välilehdellä näkyy tarkemmat tiedot automaattinoudosta.

Palkansaajarekisteri-painikkeella avautuu palkansaajarekisteri, josta pääsee helposti muuttamaan esimerkiksi palkansaajan Verokortin asetuksia Palkkatiedot-välilehdellä.

Jos Uusimmat automaattisesti haetut verokortit -widget ei näy etusivulla, voit lisätä sen:

Lisätietoa etusivun muokkaamisesta löydät ohjekirjasta.

Verokortin noudon VeroAPIn kautta voi tarvittaessa estää palkansaajakohtaisesti.

Verokortin noudon estäminen onnistuu palkansaajan Palkkatieto -näkymällä, jonne siirrytään Palkansaajarekisterin kautta. Palkkatiedoissa henkilön tietoihin lisätään valinta kohtaan Palkansaajaa ei sisällytetä Ennakonpidätystiedot maksajille kyselyyn (VeroAPI). Kun henkilöä ei sisällytetä verokorttitietojen noutoon, henkilö tulee näkyville Ennakonpidätystietojen nouto -näkymän palkansaajalistaukseen, mutta häntä ei pysty valitsemaan listalta. Tällä varmistetaan, että palkansaajalle ei haeta turhaan toista verokorttia käyttöön, mikäli henkilö ei palkkaverokorttia tarvitse.

Painiketta Näytä palkansaajat, joiden ennakonpidätystietoja ei noudeta klikkaamalla näytetään palkansaajat, jotka eivät ole mukana verokorttien haussa. Oletuksena näitä palkansaajia ei näytetä.

Hakuhistoria - näkymä näyttää ennakonpidätystietokyselyn pyyntöhistorian. Taulukosta näkee:

Aktivoimalla yksittäisen pyynnön rivin ja painamalla Näytä pyyntö -painiketta, pääsee näkymälle, josta näkee pyynnön sisältämät palkansaajat ja verokorttien tilat.

Kaikkien taulukkojen tiedot saa avattua Excel, PDF- tai HTML -muotoon klikkaamalla hiiren kakkospainiketta taulukon rivin kohdalla ja valitsemalla haluttu tiedostomuoto.

Kun Tulorekisterin sähköisessä asiointipalvelussa ennen 24.10.2024 tilattuja varmenteita uusitaan, ne eivät enää toimi Vero API -rajapinnoissa, jos varmenteelta puuttuu Vero API -rajapinnan käyttöoikeus. Ennakonpidätystietojen nouto saattaa esimerkiksi jäädä virheeseen "1005 client certificate validation failed, please check that the VeroAPI interface agreement is valid".

Varmenteen uusimisen jälkeen tulee käydä Verohallinnon varmennepalvelussa tekemässä varmenteelle korvaava rajapintahakemus, jos käytetään Vero API- rajapintoja, esimerkiksi Ennakonpidätystietojen nouto -toimintoa.

Korvaava hakemus tehdään kirjautumalla Verohallinnon varmennepalveluun (Kirjaudu: Tuotantovarmenteet) ja valitsemalla Tee korvaava hakemus sekä lisäämällä valintoihin Vero API -rajapinta. Uutta varmennetta ei tarvitse tilata. Kun Vero API -rajapinnan käyttöoikeus on aktivoitu, Verohallinto ottaa varmenteen automaattisesti käyttöön Vero APIa varten.

Tarkempia ohjeita antaa Verohallinnon asiakaspalvelu.