NetBaron Instructions
NetBaron Instructions
Breadcrumbs

Tulorekisteri - Varmenteet

Asetukset > Sovellukset > Palkka > Tulorekisteri - Varmenteet-välilehti

Verohallinnolta voidaan tilata varmenne, jonka avulla tulorekisteri-ilmoitukset voidaan lähettää suoraan NetBaronista tulorekisteriin.

Hakemus teknisen rajapinnan käyttöönottamiseksi

Ennen varmenteen noutamista tulee tehdä hakemus teknisen rajapinnan käyttöönottamiseksi.

Verohallinnon ohjeet hakemukseen liittyen löytyy tästä linkistä.

Hakemuksessa annettavat tiedot

Käytettävä rajapintakanava

Järjestelmä käyttää Viivästettyä Web Service -rajapintaa

Rajapinnan käyttötarkoitus

Valitse käyttötarkoitus sen mukaan, mitä aineistoja lähetetään:

  • jos lähetetään vain oman organisaation palkkatietoja: Organisaationi ilmoittaa tulorekisteriin tietoja omasta puolestaan

  • jos lähetetään vain asiakkaiden aineistoja: Organisaationi lähettää tietoja toisen tahon puolesta

  • jos lähetetään sekä omia että asiakkaiden aineistoja, valitse molemmat vaihtoehdot

Varmenteen tekninen yhteyshenkilö

Varmenteen tekninen yhteyshenkilö saa sähköpostitse turvasähköpostiviestin, joka sisältää varmennepyyntöön tarvittavat siirtotunnukset:

  • TransferID

  • TransferPassword

Lisäksi yhteyshenkilö saa tekstiviestillä PIN-koodin, jolla turvasähköpostiviesti voidaan avata.

Tekniseksi yhteyshenkilöksi tulee määrittää sen henkilön tiedot, joka tekee varmennepyynnön tulorekisteriin tunnusten saavuttua.

💡 Yhteyshenkilön sähköpostiosoite ja puhelinnumero tulee tarkistaa huolellisesti ennen hakemuksen lähettämistä.

Hakemuksella nimenkirjoitusoikeudellisen henkilön tulee lisäksi hyväksyä käyttöehdot ja tietoturvavaatimukset.

Varmenteen noutaminen

Varmenne noudetaan siinä organisaatiossa, jonka varmenteella ilmoituksia jatkossa lähetetään tulorekisteriin.

Moniyrityskäytössä:

  • jos aineisto lähetetään pääorganisaation kautta, varmenne noudetaan pääorganisaatioon

  • jos pääorganisaatiolla ei ole aliorganisaation valtuutusta palkka-aineistojen lähettämiseen, varmenne noudetaan suoraan aliorganisaatioon

Pääorganisaation varmenteen käyttäminen (moniyrityskäyttö)

Kun tietoja lähetetään moniyrityksen yli, aliorganisaatioiden tulee antaa valtuutukset Suomi.fi-palvelussa.

Suositeltava valtuutus:

  • palkkatietojen lähettäminen

  • palkkatietojen katselu

Lisätietoa valtuutuksen tekemisestä löytyy Tulorekisteri - Valtuutukset ohjeesta.

Valinta tehdään kohdassa Valitse pääorganisaatio, jonka varmennetta käytetään.

Valikossa näkyvät ne pääorganisaatiot joille on myönnetty Moniyritysliitännät-välilehdellä Palkka-sovellusoikeus ja jotka ovat aktiivisia.

💡 Jos pääorganisaatiolla on varmenne käytössä ja aliorganisaatio on antanut tarvittavat valtuutukset, järjestelmä käyttää pääorganisaation varmennetta automaattisesti. Tällöin valintaa ei tarvitse erikseen tehdä.

Oman varmenteen käyttöönotto

Toimi seuraavasti:

att_9_for_1473118214.png

  1. Valitse Aktiivinen

  2. Valitse Käyttöympäristö-kenttään: Tuotanto

  3. Syötä:

    • Asiakkaan tunniste (CustomerId)

    • Asiakkaan nimi (CustomerName)
      Tiedot löytyvät tulorekisterin toimittamasta teknisen rajapinnan käyttösopimuksesta.

  4. Tallenna.

  5. Klikkaa Luo avaimet.

  6. Avautuvassa ikkunassa syötä:

    • Siirtoavain

    • Kertakäyttöinen salasana
      Tiedot löytyvät tekniselle yhteyshenkilölle lähetetystä turvasähköpostista.
      💡 Tunnukset ovat voimassa 14 vuorokautta.

  7. Avaa turvasähköpostiviesti avataan klikkaamalla viestissä olevaa Avaa viesti -linkkiä.

  8. Tämän jälkeen tekstiviestillä saatu PIN-koodi syötetään PIN-koodi-kenttään ja valitaan Jatka.

    Viestistä voidaan tämän jälkeen kopioida:

    • Siirtotunnus

    • Kertakäyttösalasana

    Kenttiin täyttyvät automaattisesti:

    • Yleinen nimi = Asiakkaan tunniste (CustomerId)

    • Organisaatio = Asiakkaan nimi (CustomerName)

    • Maa = organisaation maatunnus

  9. Lopuksi klikkaa Lähetä varmennepyyntö.

att_10_for_1473118214.png

Kun varmennepyyntö onnistuu:

  • tulorekisteri palauttaa vastauksen

  • Varmenteet-kohtaan tulee näkyviin varmenteen voimassaoloaika

  • Noutotunnus-kenttään tallentuu varmenteen noutotunnus (kuvassa peitetty)

Varmenne on voimassa 2 vuotta.

att_8_for_1473118214.png

Varmenteen uusiminen

Varmenteet uusitaan automaattisesti, kun niiden vanhenemiseen on 30 päivää.

Varmenteen voi uusia myös käsin:

  1. klikkaa varmennerivin alussa Uudista varmenne image-20260408-125017.png -painiketta.

  2. klikkaa avautuvassa ikkunassa uudelleen Uudista varmenne

💡 Manuaalinen uusiminen on mahdollista 60 päivää ennen varmenteen vanhenemista.

Varmenteen siirtäminen toiseen organisaatioon

Varmenteen lataaminen toisesta organisaatiosta

Voimassa olevan varmenteen voi ladata klikkaamalla Lataa varmenne

Avautuvassa ikkunassa:

  1. syötä PIN-koodi (voit määrittää sen itse)

  2. klikkaa Lataa

image-20260408-125219.png

Tiedosto tallennetaan omalle koneelle.
Tiedoston nimeksi muodostuu automaattisesti Asiakkaan tunniste -kohtaan annettu Y-tunnus.

Varmenteen tallentaminen toiseen organisaatioon

Siirry organisaatioon, johon varmenne halutaan tuoda ja asetuksiin: Asetukset > Sovellusasetukset > Palkka > Tulorekisteri > Varmenteet-välilehti

Toimi seuraavasti:

  1. valitse Käyttöympäristö: Tuotanto

  2. varmista, että Asiakkaan tunniste ja Asiakkaan nimi ovat samat kuin organisaatiossa, josta varmenne ladattiin.

  3. klikkaa Tallenna

  4. klikkaa Tuo varmenne

Avautuvassa ikkunassa:

  1. syötä aiemmin määritetty PIN-koodi

  2. valitse varmennetiedosto Lisää tiedosto -painikkeella

  3. klikkaa Tuo varmenne

Tämän jälkeen varmenne on valmis käytettäväksi myös toisessa organisaatiossa.

att_6_for_1473118214.png