Avaandmete API ehk XML teenuste kasutamiseks on vajalik sõlmida Registrite ja Infosüsteemide Keskusega leping.
Esialgu on avaandmete kasutamiseks tehtud kättesaadavaks olemasolevad äriregistri API (XML) teenused, mida on tulevikus plaanis RIKi poolt uuendada. Oleme tänulikud, kui leiate hetke, et jagada meiega avaandmete API osas ettepanekuid teenuste edasiseks arendamiseks.
Lepingu sõlmimine:
- Lepingu sõlmimiseks palume siseneda e-äriregistri portaali ja täita lepingutaotlus (loe ka lepingu sõlmimise üldtingimusi)
- Ainult e-äriregistri tasuta API teenuste kasutamiseks tuleks valida teenuste märkimisel vastav valik (sellisel juhul igakuist lepingutasu ei lisandu)
- Lepingutaotlused vaadatakse üle viie tööpäeva jooksul, misjärel saadetakse administraatorkasutajale vajalik info
- Lepingu sõlmimisel ainult e-äriregistri API teenuste kasutamiseks, on teenuste kasutamine tasuta
API teenuste nõuded:
- Maksimaalne päringu vastuste arv lepingupartneri kohta: 50 000 tk/päevas*
- Maksimaalne samaaegsete päringute arv lepingupartneri kohta: 1 päring*
- Dokumentide (nt PDF kujul majandusaasta aruanne, põhikiri jne) alla laadimisel kehtib täiendav IP-põhine piirang 20 päringut minutis
- Suuremahuliste andmekomplektide (alg)laadimiseks palume kasutada avaandmete allalaaditavaid faile, mida uuendatakse kord ööpäevas
- Äriregistri avaandmed on XML teenuste kaudu kättesaadavad reaalajas
*Mahtude ületamisel piiratakse lepingupartneri päringute tegemise õiguseid. Suurema mahuga päringute tegemise vajaduse korral palume saata eelnevalt põhjendus ning soovitud mahu info e-posti teel [email protected].
Teenuse WSDL faili link:
- Testkeskkonnas: https://demo-ariregxmlv6.rik.ee/?wsdl
- Toodangu keskkonnas: https://ariregxmlv6.rik.ee/?wsdl
Teenuse aadress:
- Toodangu keskkonnas: https://ariregxmlv6.rik.ee/
- Testkeskonnas: https://demo-ariregxmlv6.rik.ee
Sisendparameetrid:
Igal päringul vähemalt üks kohustuslik sisendparameeter: paringu_nimi, mis näitab millist päringut sooritatakse. Teenuste kasutamiseks tuleb ennast autentida kasutades e-äriregistri kasutajanime ja parooli. Lisaks on kõigil päringutel valikuline sisendparameeter:
- keel: est – eesti (vaikimisi), eng – inglise
Teenuste kirjeldused:
- Veebiteenustes kasutatavad klassifikaatorid
- Lihtandmete päring
- Detailandmete päring
- Ettevõtjaga seotud dokumentide loetelu päring
- Ettevõtja majandusaasta aruannete loetelu päring
- Ettevõtja majandusaasta aruannete päring
- Ettevõtjaga seotud kõikide isikute esindusõigused
- E-arvete vastuvõtjate päring
- Ettevõtja muudatuste loetelu päring
- Ettevõtja rekvisiitide faili teenus
- Ettevõtja rekvisiitide teenus
- Isikute muudatuse teenus (tegelike kasusaajate muudatused)
- Kannete ja määruste päring
- Majandusaasta aruandega seotud müügitulu jaotuste EMTAK’i järgi
- Tegelike kasusaajate andmete päring
- Usaldushalduste päring