--- title: Ongelmia tulorekisteri ilmoitusten lähettämisessä? description: "Ohje Maestro-järjestelmän Tulorekisteri‑ilmoittamisen virhetilanteiden ratkaisuun: käyttäjä- ja yritystietojen tarkistus, siirtotiedostojen asetukset, varmenteet, yleiset virhekoodit, eläkejärjestelynumerot sekä palautteiden nouto ja aineiston mitätöinti." --- [Siirry sisältöön](https://tuki.maestro.fi/tietopankki/ongelmia_ilmoitusten_lhettmisess#main-content) Suomi Näytä käännöksien alavalikko [Asiakasportaali](https://tuki.maestro.fi/asiakasportaali?hsLang=fi) [![maestro\_musta](https://tuki.maestro.fi/hs-fs/hubfs/maestro_musta.png?width=200&height=40&name=maestro_musta.png)](https://tuki.maestro.fi/tietopankki?hsLang=fi) Avaa päänavigointi Sulje päänavigointi - Suomi Näytä käännöksien alavalikko - [Asiakasportaali](https://tuki.maestro.fi/asiakasportaali) Kuinka voimme auttaa sinua? - Ehdotuksia ei ole, koska hakukenttä on tyhjä. 1. [Tietopankki](https://tuki.maestro.fi/tietopankki?hsLang=fi) 2. [Palkat](https://tuki.maestro.fi/tietopankki/palkat?hsLang=fi) 3. [Tulorekisteri Maestrossa](https://tuki.maestro.fi/tietopankki/palkat?hsLang=fi#tulorekisteri-maestrossa) 25\. maaliskuuta 2026 # Ongelmia tulorekisteri ilmoitusten lähettämisessä? ## Teksti kokoaa kattavan ohjeen Maestro-järjestelmän Tulorekisteri‑ilmoittamisen yleisimmistä virhetilanteista ja niiden ratkaisuista. Ohjeessa käydään läpi tarkistuslista käyttäjä‑ ja yritystietojen oikeellisuudesta, siirtotiedostojen asetuksista sekä varmenteiden toimivuudesta. Lisäksi kuvataan Tulorekisterin viiveistä johtuvat virhekoodit ja muita ilmoitusten lähetykseen, palautteisiin ja mitätöinteihin liittyviä ongelmia. Ohje auttaa käyttäjää paikallistamaan virheen, tarkistamaan oikeat Maestro-asetukset ja tarvittaessa korjaamaan varmenne- tai tunnistetiedot. Mukana on myös esimerkkejä eläkejärjestelynumeroista ja ohjeita toimipistetunnusten, tulolajien ja palkkarivien korjaukseen. ### Ongelmia ilmoitusten lähettämisessä? Tässä on hyvä tarkistuslista, jonka voi käydä läpi jo ennen lähetysten tekemistä, tai jos Tulorekisteri-ilmoittamisen yhteydessä tulee virheilmoituksia. Eli varmista että nämä tiedot ovat kunnossa Maestrossa. ### Käy tarkistuslista läpi 1\. Varmista että käyttäjätiedot on syötetty Maestroon valitsemalla **Ohje/Käyttäjän tiedot**. ![](https://tuki.maestro.fi/hs-fs/hubfs/image-png-Mar-25-2026-11-42-14-4622-AM.png?width=670&height=423&name=image-png-Mar-25-2026-11-42-14-4622-AM.png) 2\. Varmista että yrityksen yleistietoihin valinnalla **Kirjanpito/Ylläpito/Yrityksen yleistiedot** määritelty palkanlaskijan käyttäjätunnus on sama kuin **Käyttäjän tiedot** -valintaikkunan vasemmassa yläkulmassa näkyvä käyttäjätunnus. ![](https://tuki.maestro.fi/hs-fs/hubfs/image-png-Mar-25-2026-11-42-34-2918-AM.png?width=595&height=535&name=image-png-Mar-25-2026-11-42-34-2918-AM.png)   3\. Tarkista että **Tulorekisterin yhteysyritykselle** on syötetty Y-tunnus yrityksen perustietoihin valinnalla **Kirjanpito/Ylläpito/Yrityksen perustiedot** kentässä **Tunnisteen tyyppi.** ![](https://tuki.maestro.fi/hs-fs/hubfs/image-png-Mar-25-2026-11-43-08-1373-AM.png?width=670&height=548&name=image-png-Mar-25-2026-11-43-08-1373-AM.png) 4\. Tarkista, että valinnalla **Tiedosto/Palkat/Yleistiedot/Siirtotiedostot** siirtotiedostoihin on asetettu yhteysyrityksen firmakoodi, ja että Y-tunnus on sama kuin yhteysyrityksen perustiedoissa oleva. Alla olevassa esimerkissä ATE on Tulorekisterin yhteysyrityksenä toimiva yritys Maestron ympäristössä. ![](https://tuki.maestro.fi/hs-fs/hubfs/image-png-Mar-25-2026-11-43-32-7325-AM.png?width=492&height=399&name=image-png-Mar-25-2026-11-43-32-7325-AM.png) **Mikäli siirtotiedostoissa on jo syötettynä palvelutunnus, joka on eri kuin yhteysyrityksen Y-tunnus, saatetaan tätä käyttää verkkopalkkojen lähetyksessä.** Tällöin verkkopalkkojen lähetyksessä käytettävä Y-tunnus tulee syöttää verkkopalkkojen lähetystietoihin valinnalla **Tiedosto/Palkat/Yleistiedot/Verkkopalkkojen yleistiedot/ Lähetystietojen päivitys** kenttään **Tilitoimisto y-tunnus**. Epävarmoissa tilanteissa ota yhteys Maestron asiakaspalveluun. ![](https://tuki.maestro.fi/hs-fs/hubfs/image-png-Mar-25-2026-11-47-29-7169-AM.png?width=594&height=256&name=image-png-Mar-25-2026-11-47-29-7169-AM.png) ### Virhekoodit GEDD0090 ja GEN0010 Tulorekisterin latauspalvelussa ja rajapintojen toiminnassa on toisinaan viivettä. Näistä viiveistä johtuen asiakkaille on saattanut tulla seuraavia virhekoodeja: - **GEDD0090** - Aineiston lähettäjällä ei ole oikeutta toimittaa aineistoja toisen osapuolen puolesta - **GEN0010** - Unexpected technical error = Aineiston status: Tuntematon Nämä virhetilanteet liittyvät Tulorekisterin hitauteen. Saattaa kuitenkin olla, että aineisto on mennyt tulorekisteriin vaikka käyttäjä ei sitä vielä sähköisessä asiointipalvelussa näe. **Tässä tilanteessa on syytä odottaa rauhassa, tuleeko aineisto näkyviin tulorekisteriin. Älä lähetä ilmoituksia uudelleen! **Mikäli aineistot eivät 1-2 päivän viiveellä tule Tulorekisteriin näkyviin, on suositeltavaa täyttää havaintolomake Tulorekisterin sähköisessä asiointipalvelussa. **[Täältä](https://maestro10.helpdocsonline.com/tulorekisteri_virhekoodit)** voit katsoa listauksen kaikista virhekoodeista. **[Täältä](https://tuki.maestro.fi/tietopankki/tarkistus_onko_ilmoitus_mennyt_perille_tulorekisteriin?hsLang=fi)**löytyy ohje, miten voit tarkistaa onko ilmoitus mennyt perille Tulorekisteriin. ### Varmennenäkymään siirryttäessä tulee virhe ![](https://tuki.maestro.fi/hs-fs/hubfs/image-png-Mar-25-2026-01-14-38-4044-PM.png?width=556&height=211&name=image-png-Mar-25-2026-01-14-38-4044-PM.png)   Tarkista, että yhteyssalasana on sama sekä Maestrossa valinnalla **Kirjanpito/Ylläpito/Yrityksen** **perustiedot** että NG:ssä. Jos käyttäjä on jo kirjautuneena NG:hen, ja Maestrosta yritetään siirtyä väärällä salasanalla varmennenäkymään, tulee virheilmoitus "Virhe: 401" Jos käyttäjä ei ole kirjautuneena NG:hen kun varmennenäkymään yritetään siirtyä väärällä salasanalla, tulee virheilmoitus "Kirjautuminen epäonnistui". ### Kirjanpidon siirrossa muodostetun Tulorekisterisanoman näyttö ei onnistu Jos kirjanpidon siirrossa muodostetun Tulorekisterisanoman näyttö ei onnistu, ja tulee virhe: "Palkkatieto-ilmoituksen näyttäminen selaimessa ei onnistunut!", tarkista yrityksen perustiedoista valinnalla **Kirjanpito/Ylläpito/Yrityksen perustiedot** kentän **Yhteysosoite** -tieto. Jos yhteysosoitteessa on esimerkiksi https://extranet.maestro.fi, tai ettei yhteysosoitteen perässä ole ylimääräisiä merkkejä. Hyväksy yrityksen perustiedot, ja kirjaudu uudelleen Maestroon. ### Aineiston lähetyksessä Tulorekisteriin tulee virhe - Jos aineiston lähetyksessä Tulorekisteriin tulee virhe "Unauthorized to access IR service. Check Client certificate!", varmenteessa on vikaa ja WS-varmenne täytyy noutaa uudestaan Maestroon. Uuden varmenteen saa pyydettyä **[Verohallinnon varmennepalvelusta](https://asiointi.tulorekisteri.fi/https://tunnistautuminen.suomi.fi/sivut/discovery-page/?entityId=https%3A%2F%2Fvarmennepalvelu.vero.fi%2Fprod&timeout=295&tid=50s1ibdt4qbf7jli665sacpet0&pid=cab24a9480b88367fe110b8a10e5699e5a7b536829a0c731f7389dbe8a97b829&tag=2603251154c206&authMethdReq=FFI;fLoA2;eLoA3;eLoA2;fLoA3&conversation=e2s1)**. Kun olet saanut uuden varmenteen tiedot, mene varmenteiden hallintaan yhteysyrityksellä valinnalla **Palkat/Tulorekisteri/Varmenteet**, poista vanha WS-varmenne ja nouda uusi. - Jos aineiston lähetyksessä Tulorekisteriin tulee virhe "Aineisto hylätty !!! Tulorekisteri hylkäsi lähetetyn aineiston", virheestä ei tule mitään tietoa ja aineisto vain hylkääntyy, on todennäköisesti varmenteessa vikaa ja WS-varmenne täytyy noutaa uudestaan Maestroon.  Uuden varmenteen saa pyydettyä **[Verohallinnon varmennepalvelusta](https://asiointi.tulorekisteri.fi/https://tunnistautuminen.suomi.fi/sivut/discovery-page/?entityId=https%3A%2F%2Fvarmennepalvelu.vero.fi%2Fprod&timeout=295&tid=50s1ibdt4qbf7jli665sacpet0&pid=cab24a9480b88367fe110b8a10e5699e5a7b536829a0c731f7389dbe8a97b829&tag=2603251154c206&authMethdReq=FFI;fLoA2;eLoA3;eLoA2;fLoA3&conversation=e2s1)**. Kun olet saanut uuden varmenteen tiedot, mene varmenteiden hallintaan yhteysyrityksellä valinnalla **Palkat/Tulorekisteri/Varmenteet**, poista vanha WS-varmenne ja nouda uusi. ### Jos aineiston validoinnissa tai lähetyksessä tulee virhe "PIV0110 - Unknown data item Pension policy number" Eläkejärjestelynumero on 11-merkkinen numerosarja, jota käytetään palkkatietojen ilmoittamiseen. Saat sen lisäämällä vakuutusnumeroosi nollia: - Veritaksen asiakkaiden eläkejärjestelynumero on muotoa 56-**00**12345A. - Alandian entisten asiakkaiden eläkejärjestelynumero on muotoa 56-74**0**1234A Maksajan pitää ilmoittaa palkkatietoilmoituksessa eläkejärjestelynumero (ns. vakuutusnumero), jos tulonsaaja on työeläkevakuutettu. Jos tulonsaaja on vakuutettu maatalousyrittäjän eläkelain mukaan (MYEL-vakuutettu) tai yrittäjän eläkelain mukaan (YEL-vakuutettu), eläkejärjestelynumeroa ei ilmoiteta. Eläkejärjestelynumero on 11 merkkiä, ja se ilmoitetaan koko pituudessaan. Eläkejärjestelynumeron alkuosa ennen yhdysmerkkiä yksilöi eläkejärjestelyä hoitavan eläkelaitoksen eli eläkevakuuttajan. **Numero voi olla kahta muotoa:** - **a T on tarkistusmerkki** (numero tai iso kirjain) nn-nnnnnnnT, jossa n on numero j - **nnnnn-nnnnT**, jossa n on numero ja T on tarkistusmerkki (numero tai iso kirjain) Alkuosan numero on pääsääntöisesti 2-merkkinen, poikkeuksena tilanteet, joissa eläkevakuutus on hoidettu eläkesäätiössä tai eläkekassassa. Jos alkuosa on 5-merkkinen ja muotoa 7nnnn, on kyse eläkesäätiöstä, ja jos se on muotoa 8nnnn on kyseessä eläkekassa. Jos eläkejärjestelynumero on lyhyempi kuin 11 merkkiä, yhdysmerkin jälkeen merkitään riittävä määrä nollia, esimerkiksi 46-0123456T. Yhdysmerkki lasketaan mukaan merkkimäärään. Yhdysmerkkiä ei saa korvata millään muulla merkillä. Eläkejärjestelynumeron viimeinen merkki on tarkistusmerkki. Tarkistusmerkki voi olla numero tai kirjain. Jos tarkistusmerkki on kirjain, se on aina iso kirjain. Esimerkiksi Ilmarisen eläkejärjestelynumero olisi muotoa 46-0123456T, Elon eläkejärjestelynumero muotoa 54-0123456T ja Varman eläkejärjestelynumero muotoa 55-0123456T. Eläkesäätiöiden numerot olisivat muotoa 70001-1234T. Eri eläkevakuuttajilla on erilaisia käytäntöjä, mutta yleensä eläkejärjestelynumero on merkitty työeläkevakuuttajan asiakaskirjeisiin. ### Palautteen noutopyynnössä tulee virhe Jos palautteen noutopyynnössä tulee virhe "Creator information and signing certificate mismatch", yhteysyrityksen Y-tunnus on FI-muodossa eikä palautteen noutopyyntö osaa sitä tällä hetkellä muuttaa Y-tunnus muotoon. Käy muuttamassa yhteysyrityksen Y-tunnus ilman FI alkua, ja lisäämällä viiva ennen viimeistä numeroa. Tämän jälkeen palautteen noudon tulisi toimia.  ### Aineiston mitätöinnissä tulee virhe Jos aineiston mitätöinnissä tulee virhe "The earnings payment report to be cancelled cannot be found with the search criteria given.", ilmoitus ei ole mennyt Tulorekisteriin läpi, eikä Tulorekisteri löydä ilmoitusviitteellä mitätöitävää ilmoitusta. Tulorekisterin antamat virheet aineistossa saa nähtäville noutamalla kyseisen aineiston palautteet valinnalla **Palkat/Tulorekisteri/Palautteiden nouto**. Jos palkat tulee saada kirjanpitoon ja maksuun, mutta on ongelmia varmenteen kanssa, käytä valintaa **Tulorekisteriin lähetys** on **Aineiston lähetys** -näkymästä. Näin ilmoituksen lähettämisen voi hoitaa muutamaa päivää myöhemmin. Tarkempi ohje löytyy **[täältä](https://tuki.maestro.fi/tietopankki/ilmoitusten_lhettminen?hsLang=fi)**. ### Aineiston lähetysnäkymässä tai palautteiden noutonäkymässä tulee ilmoitus Jos aineiston lähetysnäkymässä tai palautteiden noutonäkymässä tulee ilmoitus: "Yritystä ei ole valittu seurattavaksi", Yrityksen yleistiedoissa valinnalla **Kirjanpito/Ylläpito/Yrityksen yleistiedot** on kentän **Tilitysrastilista SIVUKULUL** valinta asetettu arvoon EI. Mikäli haluat yrityksen mukaan lähetysnäkymään, aseta valinta arvoon KYLLÄ. ![](https://tuki.maestro.fi/hs-fs/hubfs/image-png-Mar-25-2026-01-15-36-5810-PM.png?width=581&height=526&name=image-png-Mar-25-2026-01-15-36-5810-PM.png) Aineiston lähetysnäkymää tai palautteiden noutoa käytettäessä näkymään ei tule lähteviä ilmoituksia näkyviin vaikka palkkailmoituksia on muodostettu Tarkista yrityksen perustiedostoista valinnalla **Kirjanpito/Ylläpito/Yrityksen perustiedot**, että **Verokausi palkat** -kentässä on valittuna jokin palkkakausi. Mikäli valintana on **Ei palkkoja**, ei yritykselle tule aineiston lähetysnäkymään ilmoituksia näkyviin. ![](https://tuki.maestro.fi/hs-fs/hubfs/image-png-Mar-25-2026-01-15-58-4276-PM.png?width=924&height=753&name=image-png-Mar-25-2026-01-15-58-4276-PM.png)   ### Ohjelma ilmoittaa, että palkkariviltä puuttuu tulolaji Todennäköisesti syynä on se, että palkkakirjaus on tehty ensin ja palkkalaji-kortin tulolaji on muutettu sen jälkeen. **Ohjelma kuitenkin kopioi palkkalaji-kortin tietoja riveille kirjausvaiheessa**, joten palkkalaji-kortin muutos jälkikäteen ei auta asiassa. Korjaa tekemällä muutos palkkalaji-kortille, poista palkkarivi/rivit joita asia koskee, ja kirjaa palkkarivi/rivit uudelleen. Jos ohjelma ilmoittaa että, toimipaikkakoodi / toimipistetunnus puuttuu, ja et halua lähettää Tilastokeskuksen toimipistetunnuksia Tulorekisteriin, nollaa kohta **Palkat/Tilastot/Jäsennumero**. Jos haluat kuitenkin lähettää toimipistetunnukset, mutta osastojakoa ei ole asetettu kohdassa **Palkat/Tilastot/Yleistiedot** (käytössä vain yksi yksikkö), syötä toimipistetunnus koodilla 9999 valinnalla **Palkat/Tilastot/Yksikkönumerot**, ja anna 9999:n pariksi Tilastokeskuksen toimipistetunnus. ![](https://tuki.maestro.fi/hs-fs/hubfs/image-png-Mar-25-2026-01-16-40-7593-PM.png?width=414&height=384&name=image-png-Mar-25-2026-01-16-40-7593-PM.png)   Palkat, **joissa ei ole tulorekisteri-viitettä**, saa haettua näin **Jakson palkat** -selauksessa. Eli ne palkat, joita ei ole toimitettu Tulorekisteriin tai jotka eivät ole lähdössä Tulorekisteriin **Aineiston lähetys** -näkymässä. ![](https://tuki.maestro.fi/hs-fs/hubfs/image-png-Mar-25-2026-01-17-02-6882-PM.png?width=604&height=585&name=image-png-Mar-25-2026-01-17-02-6882-PM.png)   ### Virhekoodit  - Tulorekisterin virhekoodit löytyvät [**täältä**](https://www.vero.fi/tulorekisteri/ohjelmistokehitt%C3%A4j%C3%A4t/dokumentaatio/#koodistot)  **Avainsanat** - Tulorekisteri - Virhekoodit - Y-tunnus - WS-varmenne - Siirtotiedostot - Eläkejärjestelynumero - Aineiston lähetys - Palautteiden nouto - Toimipistetunnus - Palkkalaji - Varmennepalvelu   [![maestro\_musta-1](https://tuki.maestro.fi/hs-fs/hubfs/maestro_musta-1.png?width=100&height=20&name=maestro_musta-1.png "maestro_musta-1")](https://maestro.fi/) [mailto:tuki@maestro.fi](mailto:tuki@maestro.fi) Copyright © 2025, Mediamaestro Oy