Ohjelmistoyrityksille digitilinpäätösten XBRL-rajapinta kaupparekisteriin
Tämä ohje on tarkoitettu palveluntarjoajille, jotka ylläpitävät taloushallinnon ohjelmistoja.
Ohjelmistoyritys voi ottaa käyttöön PRH:n rajapinnan, josta digitaalinen 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 tilinpäätöksiä ja säätiöiden vuosiselvityksiä IXBRL-muodossa.
Tulevaisuudessa rajapinta voi mahdollisesti ottaa vastaan myös muiden yritysmuotojen ja eri taksonomioiden mukaisia tilinpäätöksiä.
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 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 IXBRL-standardeja.
IXBRL-muotoiset tilinpäätökset ovat jäljennöksiä. Allekirjoitetut versiot jäävät raportointivelvollisen haltuun. IXBRL-tilinpäätösten ei siten tarvitse sisältää sähköisiä allekirjoituksia. Tiedon allekirjoittajista voi upottaa tilinpäätökseen vapaamuotoisella tavalla.
Millainen rajapinta on?
Rajapinta on REST API, ja 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 tai vuosiselvityksen mukana toimitetaan metatietoja, kuten Y-tunnus sekä tilikauden alkamis- ja päättymispäivämäärät. Metatietoja annetaan sekä URL-parametreissa että kutsun bodyssa JSON-muodossa. Body lähetetään multipart/form-data -muodossa, jossa annetaan metatietojen lisäksi itse IXBRL-tiedosto liitteenä.
Rajapinta tarkistaa, että annetut metatiedot ovat kunnossa ja täsmäävät itse IXBRL-tiedoston sisällön kanssa. Metatietojen täsmäävyyden lisäksi tarkistetaan, että tilinpäätös tai vuosiselvitys on rakenteeltaan oikeanlainen. Tulevaisuudessa rajapinta tulee tarkistamaan myös IXBRL-tiedoston sisällön tarkemmin.
Jos lähetyksen validoinnit onnistuvat, rajapinta palauttaa onnistuneen vastauksen. Muissa tapauksissa palautetaan virhekoodi ja tarkempi kuvaus virheen syystä.
Rajapintayhteys on lähtökohtaisesti avoinna ympäri vuorokauden.
Miten otat rajapinnan käyttöön?
Rajapintayhteyden käyttöönotto edellyttää sopimuksen tekemistä PRH:n kanssa. PRH tarjoaa testipalvelimen rajapinnan testausta varten.
Rajapintaa käyttävän ja sitä kokeilleiden yritysten kokemusten perusteella käyttöönotto vie 10–15 henkilötyöpäivää. PRH:stä saat tukea ja ohjeita käyttöönottoon.
Osakeyhtiöiden tilinpäätöksen taksonomian löydät Valtiokonttorin sivuilta.Avautuu uuteen välilehteen
Haluatko lisätietoja?
Kysy lisää tai tilaa sopimusehdot ja rajapinnan kuvaus sähköpostiisi.
PRH ylläpitää uutiskirjettä ohjelmistotaloille tarkoitettua uutiskirjettä rakenteisesta raportoinnista. Pyydä lisäämään yhteystietosi uutiskirjeen lähetyslistalle.
digitilinpaatos(at)prh.fi