Toteuta ja testaa testiympäristössä
Rekisteröi kehittämäsi ohjelmisto 18.1.2023 alkaen ja valitse sen käyttämät rajapinnat Vero API-portaalissa saadaksesi ohjelmistolle API-avaimen. API-avainta edellytetään testiympäristön kutsuissa 18.1.2023 alkaen. API-avain on ohjelmistokohtainen ja toimii ohjelmiston tunnisteena. API-avain ei ole tarkoitettu ohjelmiston käyttäjien hallittavaksi, vaan ohjelmistotalon tulee rakentaa sen käyttäminen ohjelmiston sisälle. Lue lisää ohjelmiston rekisteröinnistä.
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.
Vero API käyttää samaa testivarmennepalvelua kuin tulorekisteri. Jos sinulla on jo tulorekisterin WebService testivarmenne sinun ei tarvitse hakea erillistä testivarmennetta Verohallinnon rajapintojen käyttöön. Aloitusilmoitus on kuitenkin täytettävä ja varmennetiedoston sisältö on lähetettävä meille aloitusilmoitukselta löytyvään osoitteeseen.
Testivarmenteen hakeminen
Testivarmenteen hakeminen Vero API rajapinta testausta varten edellyttää seuraavia toimenpiteitä:
- täytä testauksen aloitusilmoitus 6700 (pdf)
- puhelinnumerot tulee olla kansainvälisessä muodossa (+358)
- lue testivarmenteen käyttöehdot (pdf)
- allekirjoittamalla ja lähettämällä aloitusilmoituksen pdf-muodossa ohjelmistotalot(at)vero.fi osoitteeseen, hyväksyt samalla testivarmenteen käyttöehdot
- aloitusilmoituksen lähettäminen käynnistää testivarmenteen haun
- tekniselle yhteyshenkilölle lähetetään sähköpostitse ohjeistus varmenteen noutamisesta sekä turvasähköposti testivarmenteen muodostamista varten
- testivarmenne noudetaan Tulorekisterin varmennepalvelun sidosryhmätestausympäristön web service -rajapinnasta, rajapinnan ohjeistus ja kuvaus
- varmennepalvelun sidosryhmätestausympäristön osoite: https://pkiws-testi.vero.fi/2017/10/CertificateServices
- tekninen yhteyshenkilö muodostaa varmennepyynnön (CSR) ja lähettää sen varmennepalvelun rajapintaan (SignNewCertificate), vastauksena saadaan noutotunnus (TransferId)
- tekninen yhteyshenkilö noutaa varmenteen noutotunnuksen avulla varmennepalvelun rajapinnasta (GetCertificate)
- varmenne on GetCertificate-vastaussanoman alussa <GetCertificate> <Certificate> -kohdassa
- kun testivarmenne on noudettu, lähetetään varmenteen sisältö meille vastauksena siihen sähköpostiviestiin, jossa oli ohjeistus varmenteen noutamisesta.
- testivarmenteen sisältö lähetetään meille tekstinä sellaisenaan kuin se palautui varmennepalvelusta (Base64-koodattuna tekstinä, ei liitetiedostona)
- tallennamme testivarmenteen testiympäristöömme ja tiedotamme kun se on käytettävissä.
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).
Muistathan lähettää uusitun testivarmenteen sisällön aloitusilmoitukselta löytyvään osoitteeseen, jotta uusittu varmenne on käytettävissä testiympäristössä.
Jos testivarmenne on vanhentunut, on tilattava uusi ottamalla yhteyttä Vero API tukeen havaintolomakkeen kautta.