Toteuta ja testaa testiympäristössä

Voit aloittaa ohjelmistokehityksen rajapintakuvauksia vasten.

Ohjelmistokehittäjän tulee hakea testivarmenne Vero API rajapintojen testaamista varten. Testivarmenteen avulla voi testata rajapinnan kautta ilmoittamista ja tiedon vastaanottamista Verohallinnon testiympäristössä, joka palauttaa staattisia vastauksia. Testiympäristöä käytät kutsumalla rajapintojen testiosoitetta testivarmenteen kanssa.

Rajapintahakemus ja testivarmenne 

Tee testauksen rajapintahakemus ja tilaa testivarmenne Verohallinnon varmennepalvelun testivarmenteet-osiossa.

  • 1

    Kirjaudu palveluun

  • Verohallinnon varmennepalvelun Testivarmenteet-osiossa täytetään rajapintahakemus ja tilataan testauksessa tarvittava testivarmenne.

    Tunnistaudu palveluun pankkitunnuksilla, mobiilivarmenteella tai varmennekortilla. Et tarvitse Suomi.fi-valtuutta.

    • Kun kirjaudut ensimmäisen kerran, anna sähköpostiosoitteesi ja puhelinnumerosi.
    • Pääset jatkamaan palveluun, kun olet vahvistanut sähköpostiosoitteesi sinulle lähetettävän viestin kautta.
  • 2

    Tee testauksen rajapintahakemus

  • Valitse Verohallinnon rajapinnoista Vero API ja syötä palvelun pyytämät tiedot.
  • 3

    Tilaa testivarmenne

  • Valitse asiointipalvelussa painike Tilaa uusi testivarmenne ja anna palvelun pyytämät tiedot.
  • 4

    Tekninen yhteyshenkilö noutaa testivarmenteen

  • Tekninen yhteyshenkilö vastaa varmenteen noutamisesta ja käyttöönotosta

    Kun olet lähettänyt varmennetilauksen, tilauksessa nimeämäsi tekninen yhteyshenkilö saa varmenteen noutoon tarvittavat tiedot. Varmenne on sen jälkeen noudettavissa 14 vuorokauden ajan.

    • Kun testivarmenne on noudettu, lähetä varmenteen sisältö meille vastauksena siihen sähköpostiviestiin, jossa on kerrottu että rajapintahakemus on hyväksytty.
    • Lähetä testivarmenteen sisältö tekstinä sellaisenaan kuin se palautui varmennepalvelusta <Certificate> -tägissä (Base64-koodattuna tekstinä, ei liitetiedostona tai pfx/p12-tiedostona).
    • Älä koskaan lähetä yksityistä avainta, pidä se suojattuna.
    • Tallennamme testivarmenteen testiympäristöömme ja tiedotamme kun se on käytettävissä.

  • Jos varmennetta ei noudettu 14 vrk aikana, tee uusi varmennetilaus Verohallinnon varmennepalvelussa ja lähetä testivarmenteen sisältö ohjelmistotalot(at)vero.fi -osoitteeseen.

Lue lisää:
Verohallinnon varmennepalvelu
Testivarmenteet

Testiympäristö

Vero API rajapintojen dokumentaatiot ja testiympäristön URL:t löydät Vero API-portaalista.

Siirry Vero API-portaaliin

Testivarmenteen uusimisen ohje

Ohje kuvaa yhden tavan suorittaa Verohallinnon myöntämän varmenteen uusiminen käyttäen Verohallinnon varmennepalvelun web service-rajapintaa. Esimerkin perusteella varmenteen uusimisen voi toteuttaa omaan ohjelmistoonsa.

Ohjeessa kuvattu testivarmenteen uusiminen on sovellettavissa myös tuotantovarmenteen
uusimiseen, jolloin käytetään aitoja asiakastietoja sekä varmennepalvelun tuotanto-osoitetta (URL).

  • Muistathan lähettää uusitun testivarmenteen sisällön ohjelmistotalot(at)vero.fi -osoitteeseen, että uusittu varmenne on käytettävissä testiympäristössä.
  • Jos testivarmenne on vanhentunut, on tilattava uusi testivarmenne Verohallinnon varmennepalvelusta. Uuden testivarmenteen sisältö on lähetettävä ohjelmistotalot(at)vero.fi -osoitteeseen, että uusi varmenne on käytettävissä testiympäristössä.
Sivu on viimeksi päivitetty 12.12.2024