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 saadaan noudetuksi varmennehakemuksessa ilmoitettu tekninen yhteyshenkilö vastaa varmenteen syöttämisestä ohjelmistoon. Ilman testivarmennetta Vero API rajapinta ei palauta käyttäjäorganisaation pyytämää aineistoa.
- Vero API rajapinnat vastaavat testivarmenteella tehtyihin kutsuihin vasta, kun olemme noutaneet muodostetun testivarmenteen ja asentaneet sen ympäristöömme. Varmenteet noudetaan Vero API käyttöön Verohallinnon varmennepalvelusta. Pääsääntönä voidaan pitää sitä, että virka-aikana varmennepalvelussa (klo 8.00-16.15) muodostetut varmenteet toimivat Vero API rajapintojen kutsuissa viimeistään seuraavana päivänä.
-
Jos varmennetta ei noudettu 14 vrk aikana, tee uusi varmennetilaus Verohallinnon varmennepalvelussa.
Lue lisää:
Verohallinnon varmennepalvelu
Testivarmenteet
Testiympäristö
Vero API rajapintojen dokumentaatiot ja testiympäristön URL:t löydät Vero API-portaalista.
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).
- Jos testivarmenne on vanhentunut, on tilattava uusi testivarmenne Verohallinnon varmennepalvelusta.