Tilauslomake

Kategoriat

SD Worx Vira x Asteri (VeroAPI)

Palvelu julkaistaan ennakkokäyttäjille 23.2.2026 ja virallinen lanseeraus 1.3.2026.
Koostamme tälle sivulle ohjeita palautteen ja toiveiden perusteella.
Lisätietoja antti@asteri.fi, p. 09 350 75 313

SD Worx Vira palvelun avulla lähetät ilmoitukset tulorekisteriin ja verohallintoon. Lisäksi voit noutaa verokortit kuukausittain (VeroAPI) palvelusta. Liikennöintiin käytetään viivästettyä Web Services -kanavaa ja Verohallinnon varmennetta.


SD Worx Viran kautta välitettäviä aineistoja


Aineistot lähetetään samalla idealla, kuin verkkopalkka. Sd Worx Viran liittymässä aineistoista saa selväkielisen virhepalautteen ja osaa aineistoa pääsee muokkaamaan, esim ay jäsenmaksutilityksiä ja vuosi-ilmoituksia (muokata ei voi pti, tei, verkkopalkka).

Varmenteen tilaus Verohallinnolta

Vira käyttää liikennöintiin Verohallinnolta noudettavaa varmennetta. Ilman voimassa olevaa varmennetta voidaan tehdä ay-jäsenmaksuselvityksiä liitoille ja lähettää verkkopalkka-aineistoja. Muiden aineistotyyppien osalta edellytetään varmenne. Viraa varten noudetaan varmenne tilitoimisto-kohtaisesti. Samalla varmenteella voidaan lähettää kaikkien asiakasyritysten aineistot.

Verohallinnon varmenne on voimassa 2 vuotta. Vira uusii varmenteen.

Pikaohje

Varmenteen nouto tehdään Verohallinnon varmennepalvelussa.

Samaan varmenteeseen kannattaa sisällyttää kaikki Verohallinnon ilmoituksia varten vaadittavat rajapintatyypit:

  • Vero Api (Web service)
    • mm. kuukausittaiset verokortit
  • Apitamo PKI (Web service)
    • muut aineistotyypit, mm. oma-aloitteiset verot, vuosi-ilmoitukset
  • Palkkatiedot (Web service)
    • Palkkatietoilmoitukset ja työnantajan erillisilmoitukset

Huom! Sftp-varmennepalvelu ei ole käytössä.

Anna varmenteelle vapaavalintainen nimi, esimerkiksi Asteri.

Varmennehakemukselle ilmoitetaan tekninen yhteyshenkilö. Tämän henkilön sähköpostiin toimitetaan turvapostina varmenteen asettamista varten tarvittavat tiedot. Käytä sellaista puhelinnumeroa, johon voidaan vastaanottaa tekstiviestejä.

Pidempi, kuvallinen ohje varmenteen noutoon

Varmenteen nouto Viraan

Varmenteen tilaamisen jälkeen teknisen yhteyshenkilön sähköpostiin tulee Verohallinnolta turvapostitse viesti, jossa on varmenteen noutoa varten tarvittavia tietoja. Ennen viestin avaamista varmista, että kyseessä on varmasti Verohallinnon varmennepalvelun viesti.

Sähköpostista pääset avaamaan viestin ”Lue viesti selaimessa” -napista. Tämän jälkeen teknisen yhteyshenkilön puhelimeen tulee tekstiviestitse pin-koodi, jolla saa turvapostin auki.

Ota viestistä talteen esimerkiksi muistioon tarpeelliset tiedot:

  • siirtotunnus (TransferID)
  • Kertakäyttösalasana (TransferPassword)
  • Varmenteen hakijan tunniste
  • Varmenteen myöntäjä
  • Varmenteen kuvaus

Noutotiedot ovat kertakäyttöiset ja voimassa 14 vuorokautta varmennetilauksesta. Jos nouto epäonnistuu tai tarvitset useamman varmenteen, tee uusi varmennetilaus.

Varmenteen lisääminen Viraan

Varmenne lisätään Viraan ensin kirjautumalla sisään ja valitsemalla vasemmasta paneelista ensin ”Editor” ja sen jälkeen yläpalkista ”Asetukset”

Asetukset -valikossa näet kaikki perustetut asiakkuudet ja pääset muokkaamaan näiden tietoja. Tilaaja -taso on ”tilitoimisto” ja Asiakas -taso on ”tilitoimiston asiakas”. Perustilanteessa varmenne lisätään tilaata -tasolle, jolloin samalla varmenteella voidaan lähettää kaikkien Viraan perustettujen asiakkaiden aineistoja. On myös mahdollista hakea varmenne asiakaskohtaisesti: tällöin varmenne noudetaan Asiakas-tasolle.

Lisätäksesi varmenteen Tilaaja -tasolle kattamaan kaikki asiakkuudet, klikkaa riviä, jossa on Taso -kentässä tieto ”Tilaaja”.

Valitse vasemmalta Valtuutukset ja klikkaa oikeassa yläkulmassa olevaa (+) -ikonia.

Syötä varmenteen noutoikkunaan turvapostista löytyvät tunnistetiedot:

  • Y-tunnus (varmenteenhakijan tunniste)
  • Siirtotunnus
  • Kertakäyttösalasana

Ja paina lopuksi Tallenna -nappia.

Nouto voi kestää pisimmillään muutaman tunnin, joten odota rauhassa varmenteen noudon jälkeen ennen aineistojen lähettämistä.

Asterilla muodostettujen aineistojen lähettäminen Viralla

Kirjaudu Viraan ja valitse oikeasta paneelista ”VIRA”.

Klikkaa yläpalkista ”Aineistojen yhteenveto” ja vasemmalta ”Tiedoston lähetys”.

Oletustilanteessa yritystä ei tarvitse valita: siinä on ns. ”tilitoimisto” roolina, jolla on oikeus toimittaa kaikkien asiakkaiden aineistoja. Pudotusvalikkoa käytetään, jos yrityksessä on rajattuja käyttäjärooleja.

Halutessasi käyttää erillistä hyväksymistoimintoa ennen lähetystä voit ruksia [ ] Siirrä ladatut tiedostot Hyväksyntä-välilehdelle.

Valitse tiedosto painamalla + Valitse tiedostoja -nappia. Liitä Asterin muodostama tiedosto leikepöydältä ctrl + v tai selaa tiedosto kansiosta.

Nyt tiedosto tai tiedostot näkyvät listalla. Paina lopuksi Lataa valitut tiedostot -nappia. Lähetyksen jälkeen oikeassa yläkulmassa vilahtaa vihreä ilmoitus lähetyksen onnistumisesta.

Lähetysten seuranta, virhepalaute ja (kuukausi)verokorttien suorasiirtopyynnön vastaus

Lähetettyjä aineistoja, niiden tilaa, virhepalautteita ja vastaussanomia, kuten kuukausiverokortteja pääsee tarkastelemaan Lähetysten seuranta -välilehdeltä. Välilehdellä näet lähetykset ja niiden tilan. Klikkaamalla riviä näet lisätiedot, virhepalautteen ja pääset noutamaan vastaussanomia.

Aineistoilla on kolme tilaa: onnistunut, käsittelyssä ja epäonnistunut. Viivästetyn Web Service -rajapinnan kautta lähetettyjen aineistojen käsittelyaika on tyypillisesti 10-20 minuuttia.

Klikkaamalla riviä näet lisätietoja aineiston käsittelystä. Virheet -välilehdellä on mahdollinen virhepalauta, Historiatiedot -välilehdellä käsittelyhistoria ja jos lähetit verokorttipyyntöjä, Vastaustiedosto: Lataa tiedosto -napista pääset lataamaan verokortit palkanmaksuohjelmaan.

Aineistojen lähetystä varten ”täpät” Asterissa

Palkkatietoilmoitus

  • Aineiston tiedot: Tiedot toimittaa [X] Palveluntarjoaja
  • Palveluntarjoajan tiedot: Palveluntarjoajan tunnisteen tyyppi ja tunniste

Palveluntarjoaja = tilitoimisto tai se taho, jonka varmennetta käytetään

Työnantajan erillisilmoitus

  • Aineiston tiedot: Tiedot toimittaa [X] Palveluntarjoaja
  • Palveluntarjoajan tiedot: Palveluntarjoajan tunnisteen tyyppi ja tunniste

UKK

Meillä on jo verkkopalkka Asterissa käytössä. Säilyykö se ennallaan?
Kyllä säilyy ja voitte jatkaa sen käyttöä kuten ennen.
SD Worx Vira tarjoaa laajemmat mahdollisuudet ja myös sen kautta voi lähettää verkkopalkat.

Palkkatietoilmoituksen lähettäminen herjaa: Epäonnistunut. Tiedoston luojan y-tunnus ei täsmää allekirjoittajan y-tunnuksen kanssa?
Jos lähetät muulla varmenteella kuin palkanmaksajayrityksen varmenteella, tarkista, että ”Tiedot toimittaa” kohdassa on valittu (*) Palveluntarjoaja ja ”Palveluntarjoajan tiedot” välilehdelle on syötetty palveluntarjoajan Y-tunnus

Lähetin palkkatietoilmoituksen, näyttää sinistä ”Käsittelyssä”
Lähetys käyttää viivästettyä Web Services kanavaa. Lähettämisen jälkeen palautteen saamiseen voi mennä 15+ minuuttia (KatreSend, KatreFeedback)

Lähetin verkkopalkat Viran kautta. Näyttä sinistä palloa ja ”Käsittelyssä” vaikka sain sähköpostiini kuittauksen ”SD Worx Verkkopalkka DeliveryBatch process report”, että kaikki verkkopalkkalaskelmat ovat lähteneet ok ja ovat nähtävillä palkansaajan verkkopankissa?
Kuittauksen saaminen Viraan voi kestää 10+ minuttia vaikka laskelmat ovat jo perillä.


Tilauslomake