Miten rajapinnat otetaan käyttöön

Lue yleiset ja tekniset ohjeet ennen rajapintaintegraation kehittämistä tai testauksen aloittamista.

• Yleiset ohjeet: Mitä rajapinnat ovat - vero.fi
• Tekniset ohjeet: Tekniset ohjeet - vero.fi
• Puolesta asiointi rajapinnoissa ja valtuudet: Puolesta asiointi - vero.fi
• Rajapintapalveluiden käyttöehdot: Käyttöehdot - vero.fi

Hiekkalaatikossa kehittäjät voivat tutustua Vero API -rajapintapalvelun nykyisiin ja tuleviin rajapintoihin.

• Rajapintojen URL: api-sandbox.vero.fi
• Hiekkalaatikkoon rekisteröidytään erikseen, jolloin käyttäjä saa vain hiekkalaatikossa toimivan API-avaimen (Subscription key).

Tutustu ja kokeile API-palveluita hiekkalaatikossa

Ohjelmistojen rekisteröinnin tavoitteena on parantaa rajapintojen käyttökokemusta ja integraatioiden laatua määrämuotoisen käyttöönottomenettelyn ja kohdennetun ohjauksen avulla.

• Ohjelmisto rekisteröidään portaalissa, jonka jälkeen käyttäjä saa API-avaimen, jota tarvitaan rajapintojen tuotantokäytössä.
• Rekisteröinti portaalissa on suositeltua tehdä jo ennen testaamisen aloittamista.

Ohjelmiston rekisteröinti ja hyväksyntämenettely - vero.fi

Testauksella varmistetaan toimiva integraatio ohjelmiston ja Verohallinnon välillä.

• Rajapintoja käyttävällä organisaatiolla pitää olla voimassa oleva Vero API rajapintasopimus.
  • Testauksen rajapintahakemus tehdään Verohallinnon varmennepalvelun testivarmenteet-osiossa.
  • Varmennepalvelusta voi myös tarkistaa, onko testauksen rajapintasopimus voimassa.
• Tarvitset testivarmenteen Varmennepalvelusta.
• API-portaalista saatu API-avain annetaan Vero-SoftwareKey headerissa.
• Rajapintojen dokumentaatiot ja testiympäristön osoitteet löydät Vero API-portaalista (URL Testi)

Vero API - Toteuta ja testaa testiympäristössä - vero.fi

Rajapintojen tuotantokäyttö edellyttää ohjelmistojen hyväksymistestausta. Ohjelmiston hyväksymistestaus tehdään itsepalveluna API-portaalissa. 

• Hyväksymistestausmenettely on eri asia, kuin varsinainen integraation toimivuuden testaaminen. Hyväksymistestaus tehdään, kun ohjelmisto on kehitetty ja testattu kokonaan.
• Rajapintoja käyttävällä organisaatiolla pitää olla voimassa oleva Vero API rajapintasopimus.
  • Tuotannon rajapintahakemus tehdään Verohallinnon varmennepalvelun tuotantovarmenteet-osiossa.
  • Varmennepalvelusta voi myös tarkistaa, onko tuotannon rajapintasopimus voimassa.
• Tarvitset tuotantovarmenteen Varmennepalvelusta.
• API-avain annetaan Vero-SoftwareKey headerissa.
• Hyväksymistestauksen osoitteet löydät Vero API-portaalista (URL Integraation verifiointi)

Ohjelmiston rekisteröinti ja hyväksyntämenettely - vero.fi

Rajapintojen tuotantokäyttöä varten käyttäjän tulee suorittaa ja huomioida alla olevat asiat.

• Sovellus on rekisteröity API-portaaliin ja hyväksymistestaus on suoritettu.
• Rajapintoja käyttävällä organisaatiolla pitää olla voimassa oleva Vero API rajapintasopimus.
  • Tuotannon rajapintahakemus tehdään Verohallinnon varmennepalvelun tuotantovarmenteet-osiossa.
  • Varmennepalvelusta voi myös tarkistaa, onko tuotannon rajapintasopimus voimassa.
• Rajapintojen käyttäjä on hakenut tuotantovarmenteen Varmennepalvelusta.
• Ohjelmisto asettaa API-avaimen Vero-SoftwareKey headeriin.
• Rajapintojen tuotanto-osoitteet löydät Vero API-portaalista (URL Tuotanto)

Vero API - Siirry tuotantoon - vero.fi