Kontrolli kliendi ettevõtet e-äriregistri andmete põhjal: registrikoodi järgi leiad kirje, staatuse, õigusliku vormi, KMKR-numbri ja tegevusala ühe päringuga ning jääd registrimuudatuste peale seirega.
Rahapesu ja terrorismi rahastamise tõkestamise seaduse (RahaPTS) kohustatud isikud, näiteks krediidi- ja finantseerimisasutused, virtuaalvääringu teenuse pakkujad, raamatupidamisteenuse pakkujad ja kinnisasja ostu-müügi vahendajad, peavad ärisuhte loomisel kohaldama hoolsusmeetmeid. Juriidilise isiku puhul tähendab see esmalt seda, et ettevõte on tõesti registris, tegutseb ja on see, kellena ta end esitleb. Käsitsi tehtud päring äriregistris töötab kümne kliendi puhul, kuid mitte siis, kui kliendiks võtmine peab käima automaatselt ja jätma auditi jaoks jälje. Kohustatud isikute ring ja hoolsusmeetmete sisu on sätestatud seaduses (RahaPTS § 2 ja § 19–20); see leht ei ole õigusnõu.
Prometiam võtab selle sammu üle: sa saad e-äriregistri (RIK) kirje REST API kaudu ühtses JSON-kujus, sama objektiga, mida kasutad ka Soome, Läti või Poola ettevõtete puhul. Piiriülese kliendibaasi puhul ei pea sa iga riigi jaoks eraldi integratsiooni ehitama.
Töövoog koosneb kolmest päringust. Esiteks leiad ettevõtte registrikoodi järgi. Teiseks küsid täisprofiili. Kolmandaks paned ettevõtte seire alla, et staatuse või andmete muutumisest teada saada.
GET /companies/search?country=EE&company_number=10060701 leiab ettevõtte (otsida saab ka nime järgi name= või KMKR-numbri järgi vat=)GET /companies/{id} annab täisprofiili; kasuta otsingu tagastatud id-dPOST /monitor kehaga {"company_id": ..., "country": "EE"} saadab veebihaagi, kui staatus muutub, ettevõte kustutatakse või registris tehakse muudatuscurl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=EE&company_number=10060701' \
-H 'Authorization: Bearer rk_live_...'
curl -X POST 'https://api.prometiam.com/functions/v1/risk-api/monitor' \
-H 'Authorization: Bearer rk_live_...' \
-H 'Content-Type: application/json' \
-d '{"company_id": 123, "country": "EE"}'
Registrikood on kaheksakohaline ja lõpeb kontrollnumbriga; vigase koodi korral vastab API veaga 400 validation_error, seega kirjaviga ei jõua vaikselt kontrollini. Enne integreerimist saad koodi proovida tasuta registrikoodi otsingus.
| Väli | Mida see tähendab |
|---|---|
company_name | ärinimi registris |
company_number, identifiers | registrikood ja teised tunnused |
status, local_status | ühtne staatus ja registri enda sõnastus, sealhulgas likvideerimine ja pankrot |
legal_form, local_legal_form | õiguslik vorm ühtse väärtuse ja registri nimetusena (AS, OÜ jt) |
founding_date | asutamise kuupäev |
| aadressiväljad | registreeritud aadress |
activity_code | tegevusala EMTAK 2008 või EMTAK 2025, olenevalt ettevõttest |
vat_number, vat_number_source | KMKR-number, mille register ise avaldab (register) |
Seire annab teada staatuse muutustest, kustutamisest, sanktsioonide kattuvusest ja registrimuudatustest (nimi, staatus, õiguslik vorm, registreeritud aadress). Registrimuudatused saavad kuupäeva siis, kui muudatus registriandmetes esimest korda nähtavaks saab, mitte registri enda kandekuupäeva järgi, ja neid ei ole enne 30. septembrit 2026. Andmed uuenevad igal tööpäeval.
GET /sanctions/screen) on beetaversioon ja kuulub Professional-paketti; PEP-kontroll on beeta ja ainult Hispaania kohtaAPI on andmeallikas, mitte hoolsusmeetmete asendaja. Otsuse kliendi vastuvõtmise kohta teeb ikka kohustatud isik oma RahaPTS-i riskihinnangu alusel.
Eesti puhul avaldab register KMKR-numbri ise, seetõttu on väli vat_number_source väärtusega register. KMKR-numbri järgi saab otsida parameetriga vat=. Kui ettevõte kuulub käibemaksugruppi, võib sama grupinumber olla mitmel liikmel ja vat= päring annab siis rohkem kui ühe tulemuse. Teise EL riigi partneri numbrit saab kontrollida päringuga GET /vat/{number} (VIES).
Auditi jaoks tasub säilitada mitte ainult otsus, vaid ka see, mille põhjal see tehti. Praktiline miinimum on: päringu kuupäev ja kellaaeg, registrikood, API tagastatud id, company_name, status ja local_status, legal_form, registreeritud aadress, vat_number koos allikaga ning vastuse koopia JSON-kujul. Kui ettevõte pannakse seire alla, salvesta ka seire algus ja iga hilisem registrimuudatus. Kui kaua andmeid säilitada, määrab kohustatud isiku oma kord ja seadus, mitte API.
Tüüpiline lahknevus on see, et kliendi esitatud nimi erineb registrinimest, aadress on vana või staatus ei ole active. Nime ja õigusliku vormi erinevus (näiteks AS asemel OÜ) tuleb enne kliendiks võtmist selgeks teha, sest see võib tähendada teist juriidilist isikut. Kui local_status näitab likvideerimist või pankrotti, ei ole tegemist tavalise kliendiga ja otsus kuulub kohustatud isiku riskihinnangusse. Kui registrikoodi ei leita üldse, kontrolli esmalt numbrit ja seejärel seda, kas tegu on FIE-ga, keda API Eesti kohta ei väljasta, või välisriigi ettevõttega, keda saad otsida selle riigi country väärtusega.
Päringute ja seire jaoks sobib Starter (9,99 € kuus, 1 000 krediiti). Kui vajad ka sanktsioonide kontrolli (beeta) ja veebihaake, võta Professional (29,99 € kuus, 10 000 krediiti). Prooviperiood kestab 14 päeva ja sisaldab 500 krediiti; kaart on nõutav, prooviperioodi jooksul tasu ei võeta.
Contains data from the Estonian e-Business Register (RIK), CC BY 4.0. Prometiam ei ole ametlik registriväljavõte.
Alusta 14-päevast prooviperioodi · API dokumentatsioon
Prooviperiood kestab 14 päeva ja sisaldab 500 krediiti. Kaart on nõutav, prooviperioodi jooksul tasu ei võeta; seejärel jätkub Starter-pakett (9,99 € kuus), kui sa ei tühista.