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.

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.

Testivarmenteen hakeminen 

Testivarmenteen hakeminen Vero API rajapinta testausta varten edellyttää seuraavia toimenpiteitä:

  • 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
    • kun testivarmenne saadaan noudettua, lähetetään varmennetiedoston sisältö meille vastauksena siihen sähköpostiviestiin, jossa oli ohjeistus varmenteen noutamisesta.
      • testivarmenteen sisältö tulee olla Base64-koodattu X.509(.cer) -muotoisena (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 osoitteesta: https://avoinomavero.vero.fi/APIPortal/