ePalkkoihin on toteutettu vero API-rajapinta, joka siirtää verokorttitiedot pyydettäessä päivittäin ja ottaa huomioon myös muutosverokortit. Rajapintaanon toteutettu seuraavat Vero API:n tulotyypit:
- Palkkaa (000024)
- Merityötuloa (000025)
- Käyttökorvausta (ansiotulo) (tulossa)
- Käyttökorvausta (pääomatulo) (tulossa)
- Työkorvausta [henkilölle][yhtiölle], joka on arvonlisäverovelvollinen, ennakonpidätystä ei pidätetä arvonlisäveron osalta (000035)
- Työkorvausta [henkilölle][yhtiölle], joka ei ole arvonlisäverovelvollinen (000036)
- Työpanokseen perustuvaa osinkoa ja ylijäämää (työkorvaus) (000037)
Lue lisää palkansaajan verotustiedoista.
Verokorttien haku vero API rajapinnasta suoritetaan Pääkäyttäjätoiminnot - Tuonti-toiminnolla.
Valitse ensin tuotavat henkilöt "Valitse henkilöt"-painikkeesta. Voit valita kaikki henkilöt tai vain valitut henkilöt. Voit myös noutaa verotiedot päättyneille työsuhteille, valitse silloin "näytä päättyneet".
Valittuasi henkilöt, sulje ruutu.
Ennen tuontia, valitse huolella verokorttipvm., joka on oletusarvoisesti kuluva päivä. Verokorttipvm. ei voi olla menneisyydessä. Vero API palauttaa aina henkilöllä voimassa olevaa verotustieto asetetun päivämäärän mukaisesti. Muutosverokortti korvaa aina entisen verokortin.
Esimerkkejä päivämäärän vaikutuksesta:
- Päivämääräksi asetetaan 27.12.2024. Henkilöllä on muutosverokortti 28.12.2024 alkaen ja lisäksi jo verokortti 1.1.2025 alkaen. Kumpaakaan verokorttitietoa ei vielä palauteta, koska niiden voimassaolo on kyselyssä olleen maksupäivän 27.12.2024 jälkeen.
- Päivämääräksi asetetaan 31.12.2024. Henkilöllä on muutosverokortti 1.1.2025 alkaen. Verottaja palauttaa edelleen vuoden 2024 viimeisimmän lasketun ennakonpidätystiedon.
- Päivämääräksi asetetaan 10.2.2025. Henkilöllä on muutosverokortti 1.2.2025 alkaen. Verottaja palauttaa 1.2.2025 voimaan tulleen ennakonpidätystiedon.
Henkilöiden valinnan ja päivämään tarkastuksen jälkeen paina "Suorita tiedon tuonti"-painiketta.
Tuonnin jälkeen ePalkat kertoo kuinka monta verokorttia on käsitelty, ollut muuttumattomia tai ohitettuja.
Muutokset kohdasta saat avattua tiedoston, josta voit tarkistaa mitä tuonti on pitänyt sisällään.
Tarkasta huolelllisesti verotietojen muutokset. Huomioithan, että mikäli verotietoihin on syötetty lähtösaldoja, tulee nämä poistaa manuaalisesti henkilötietojen verotus-välilehdeltä.
Vero API tuottaa aina palautteen, jos tuonti on onnistunut. Mikäli palautetta ei tule, tarkista seuraavat asiat:
- Henkilöiden sotu
- Onko jollekin laitettu sotu kohtaan y-tunnus?
- Verokortin toimen laji
- Yrityksen y-tunnus ei sisällä välilyöntejä
Huomioithan, että verokortin tuloraja lasketaan aina verokortin voimassaoloajalle huolimatta siitä, missä vaiheessa verokorttia on ensimmäisen kerran käytetty palkanlaskennassa.
Mikäli tulonsaaja ilmoittaa työnantajalle suuremman veroprosentin ilman muutosverokorttia, tulee verokortti lukita. Henkilöt, joilta löytyy lukittu verokortti jätetään pois kyselystä, eikä heidän verotietoja voida päivättää Vero API rajapinnan kautta ennen kuin lukitus poistetaan.
Henkilöiden voimassaolevia verotietoja voi tarkastella palkansaajat-näkymässä. Valitse sarakkeista "syötetyt verotiedot" ja "verokortin pvm".
Lukittu-sarakkeesta voit tarkistaa onko henkilöiden verokortti lukittu ja syötetyistä sarakkeista näet onko henkilöille annettu verokortin lähtösaldoja.