Majandusaasta aruanne
Mida on integratsiooniks vaja?
Majandustarkvara puhul on oluline lahendada, kuidas lisada tehingutele (ost, müük, finantskanne) või registritele (konto, klient, vara) juurde andmepõhise aruandluse klassifikaatorid, mis võimaldaksid koostada päringuid andmesektsioonide (saadetav andmete komplekt) moodustamiseks. Kui andmete moodustamine on lahendatud, siis tuleb andmefail edastada kasutades õigeid teenuseid.
Klassifikaatorid
Klassifikaatorite elemendid on need, mille lõikes esitatakse andmeid ja mille kombinatsiooni põhjal saab kokku panna aruande elemendi. On põhiklassifikaator MAJANDUSLIKSISU2024ap, mis tuleb alati lisada tehingule, ning abiklassifikaatorid, mida tuleb lisada teatud juhtudel.
Majandustarkvarasse saab laadida klassifikaatorid, kas Andmesilla API vahendusel või Statistikaameti teenustest. Andmesilla klassifikaatorite teenus tagastab kehtivate elementide loetelu ühesuguse struktuuriga (kood, nimetus, elemendi kehtivuse algus ja lõpp). Vaikimisi tagastatakse teenusega ainult valitavad elemendid ehk need, mida saab kasutada andmete esitamisel. Klassifikaatorid on riigiasutuste ülesed (ühised).
Andmesektsioonid
Andmesektsioon on kokkulepitud struktuuriga detailsete andmete komplekt, mis võimaldab koostada erinevaid aruandeid ja/või lisasid. Näiteks majandusaasta põhiaruandeid kui ka aruande lisasid.
Majandusaasta aruande koostamiseks tuleb majandustarkvarast saata alati saldod. Sõltuvalt aruande lisadest võib osutuda vajalikuks saata juurde ka täiendavaid andmesektsioone.
Andmete saatmine
Majandustarkvara peab saatma andmed otse andmesilla andmete vastuvõtuteenusesse (XML või JSON vormingus). Majandustarkvara otsustada on, kas esitab andmed üle HTTP REST või X-Tee SOAP standardipõhise lahenduse.
Aruande andmete edastamiseks on kaks eeldust:
majandustarkvaral on sõlmitud kokkulepe RIK-iga;
aruannet esitava ühingu volitatud isik on nõustunud andmesilla kasutustingimustega ja andnud kinnituse, et andmeid võib elektroonselt saata.
Andmed majandusaasta aruande jaoks tuleb saata ühe korraga terve majandusaasta aruande perioodi kohta.
Andmete valideerimine
Andmete valideerimine toimub mitmes osas. Esmalt valideeritakse saadetavate andmete struktuur ja seejärel tehakse sisulised kontrollid lähtuvalt saadetavatest andmete sisust (andmesektsioonide reeglid).
Andmete valideerimise tulemust saab pärida andmete saatmisel vastusena tagastatud esitamise tunnuse submission_uuid abil. Kui edastatud andmetes on vajalik teha parandusi, siis tuleb andmete muutmiseks andmesilla kaudu korrata sama perioodi päringut parandatud andmetega.