Rakenteisten tilinpäätösten XBRL-vastaanottorajapinta kaupparekisteriin
Tämä ohje on tarkoitettu palveluntarjoajille, jotka ylläpitävät taloushallinnon ohjelmistoja.
Ohjelmistoyritys voi ottaa käyttöön PRH:n vastaanottorajapinnan, josta rakenteinen iXBRL-muotoinen tilinpäätös metatietoineen voidaan lähettää kaupparekisteriin.
Rajapintayhteyden käyttö on maksutonta.
PRH ei tarjoa valmista asiakasohjelmistoa rajapinnan käyttöön. Ohjelmistoyrityksen täytyy siksi kehittää omaan taloushallinnon ohjelmistoonsa riittävä toiminnallisuus, jolla iXBRL-tilinpäätös lähetetään kaupparekisteriin.
Mitä tilinpäätöksiä rajapintaan voi lähettää?
Tällä hetkellä rajapinta ottaa vastaan osakeyhtiöiden, osuuskuntien sekä tiettyjen finanssialan yritysten tilinpäätöksiä iXBRL-muodossa.
Lähetettävän tilinpäätöksen täytyy olla IXBRL-muodossa (Inline eXtensible Business Reporting Language). IXBRL-muotoisissa tilinpäätöksissä XBRL-tiedot on upotettu HTML-sisältöön.
Tiedot esitetään standardien ja luokitusten eli taksonomioiden mukaisesti yhtenäisellä tavalla mutta sellaisessa visuaalisessa muodossa, johon käyttäjät ovat tottuneita. Tietojen esittämiseen ei ole muita vaatimuksia. Tilinpäätöksen voi siis visualisoida haluamallaan tavalla, kunhan se noudattaa XBRL-standardeja.
Tarkista ajantasainen tilanne, mitä yritysmuotoja ja taksonomioita rajapinnassa tuetaan.
Millainen rajapinta on?
Rajapinta on REST API. Siihen tunnistaudutaan erillisen autentikaatiopalvelimen kautta, josta saadaan varsinaisissa rajapintakutsuissa käytettävä access token.
Rajapinnasta saadaan haettua erillisellä kyselyllä tieto siitä, mitä yhtiömuotoja ja taksonomiaversioita rajapinta kyseisellä hetkellä tukee.
Tilinpäätöksen mukana toimitetaan metatietoja, kuten Y-tunnus sekä tilikauden alkamis- ja päättymispäivämäärät. Lue lisää kutsun yhteydessä toimitettavista metatiedoista rajapintakuvauksesta.
Lähetyksen yhteydessä aineistoon tehdään eri tasoisia validointeja, joilla varmistetaan aineiston rekisteröinti oikealle yritykselle sekä aineiston tekninen eheys. Jos lähetyksen validoinnit onnistuvat, rajapinta palauttaa onnistuneen vastauksen. Muissa tapauksissa palautetaan virhekoodi ja tarkempi kuvaus virheen syystä. Aineiston voi lähettää rekisteriin onnistuneen validoinnin jälkeen.
Rajapintayhteys on avoinna ympäri vuorokauden.
Miten otat rajapinnan käyttöön?
Rajapintayhteyden käyttöönotto edellyttää rajanpinnan käyttöehtojen hyväksymistä. PRH tarjoaa testipalvelimen rajapinnan testausta varten. PRH tarjoaa myös tukea ja ohjeita käyttöönottoon.
Rajapinnan käyttöehdoissa on kuvattu tarkemmin rajapinnan testauskäyttöä ja vaatimuksia tuotantokäytön aloittamiseksi.
Rajapinnan kehittämiseen liittyvät materiaalit
Ohjelmistotaloille hyödylliset materiaalit kehittämistyön tueksi on koottu omalle sivulle. Sivulta on ladattavissa viimeisimmät versiot tarvittavasta ohjeistuksesta.
Haluatko lisätietoja?
PRH lähettää uutiskirjettä ohjelmistotaloille rakenteisesta tilinpäätösraportoinnista. Pyydä lisäämään yhteystietosi uutiskirjeen lähetyslistalle. PRH tarjoaa myös tukea rakenteisten tilinpäätösten kehittämiseen ja rajapinnan käyttöönottoon.
Ota yhteyttä:
digitilinpaatos(at)prh.fi