Tarnija taustakontroll API kaudu

Kontrolli tarnijat registrikoodi ja KMKR-numbri järgi ning saa teada, kui ta staatus, nimi või aadress registris muutub, enne kui see arvele või lepingule mõju avaldab.

Probleem

Tarnija andmed lähevad ostujuhi või raamatupidaja töölauale tavaliselt üks kord: lepingu sõlmimisel. Aasta hiljem võib ettevõte olla likvideerimisel, ta nimi või õiguslik vorm muutunud, KMKR-number kehtetu või aadress teine. Kui tarnijaid on sadu, ei jõua keegi neid käsitsi äriregistris üle vaadata. Samas on vale ärinimi või KMKR-number arvel tüütu parandada ning tellimus ettevõttele, mida enam ei ole, läheb kulukaks.

Kui oled RahaPTS-i kohustatud isik, tuleb äripartneri puhul hinnata, kas ja milliseid hoolsusmeetmeid seadus nõuab; muul juhul on tarnija kontroll tavaline sisekontroll. Prometiam annab sulle selleks e-äriregistri (RIK) andmed API kaudu ja seire, mis töötab ilma, et keegi peaks registrisse sisse logima.

Kuidas see toimib

  • GET /companies/search?country=EE&company_number=10060701 leiab tarnija registrikoodi järgi; nime järgi otsid parameetriga name=, KMKR-i järgi parameetriga vat=
  • GET /companies/{id} annab profiili: staatus, õiguslik vorm, aadress, tegevusala, KMKR
  • POST /monitor paneb tarnija seire alla ja veebihaak teavitab muutusest
  • GET /company-events/search?country=EE&company_number=10060701 annab registrimuudatuste ajaloo
  • GET /vat/{number} kontrollib välismaise tarnija KMKR-numbrit EL-i VIES-süsteemis
import requests

BASE = "https://api.prometiam.com/functions/v1/risk-api"
H = {"Authorization": "Bearer rk_live_..."}

r = requests.get(f"{BASE}/companies/search", headers=H,
                 params={"country": "EE", "company_number": "10060701"})
for c in r.json().get("data", []):
    print(c["company_name"], c["status"], c.get("vat_number"))

Sama päring töötab ka teiste riikide tarnijate jaoks: vaheta country ja registrinumber. Nii saad kõigi 27 riigi tarnijad, Eesti, Soome ja Läti kaasa arvatud, ühte tabelisse samade väljadega.

Mida sa saad

VäliMida see tähendab
status, local_statuskas ettevõte tegutseb; registri sõnastus näitab ka likvideerimist ja pankrotti
vat_number, vat_number_sourceKMKR-number, mille register avaldab (register)
legal_form, local_legal_formAS, OÜ jt
aadressiväljadregistreeritud aadress, et võrrelda arve ja lepingu andmetega
activity_codeEMTAK 2008 või EMTAK 2025, olenevalt ettevõttest
registrimuudatuste sündmusednime, staatuse, õigusliku vormi ja aadressi muutused kuupäevaga

KMKR-numbri järgi otsides tasub teada, et käibemaksugrupi number võib olla mitmel liikmel ühine ja päring võib anda rohkem kui ühe ettevõtte. Eesti andmed uuenevad igal tööpäeval. Registrimuudatused saavad kuupäeva siis, kui muudatus registriandmetes esimest korda nähtavaks saab; enne 30. septembrit 2026 sündmusi ei ole.

Mida sa Eesti kohta ei saa

  • juhatuse liikmeid ega tegelikke kasusaajaid API Eesti kohta ei anna, ainult ettevõtte kirjed
  • registri vastavussignaali ei ole
  • maksejõuetuse teateid Eesti kohta ei ole; likvideerimine ja pankrot on ettevõtte staatuses ning registrimuudatuste sündmustes
  • füüsilisest isikust ettevõtjaid (FIE) ei väljastata kunagi
  • finantsaruandeid Eesti ettevõtete kohta ei ole
  • sanktsioonide kontroll (GET /sanctions/screen?name=...) on beetaversioon; PEP-kontroll on beeta ja ainult Hispaania kohta

Välismaiste tarnijate puhul on olukord riigiti erinev: ettevõtte kirjed on olemas kõigis 27 riigis, juhatuse liikmed Hispaanias, Prantsusmaal, Ühendkuningriigis ja Norras ning maksejõuetuse teated kaheteistkümnel turul. Vaata riigi kirjeldust dokumentatsioonis.

Näide: tarnijabaasi esmane läbivaatus

Võta raamatupidamistarkvarast tarnijate registrikoodide loend ja käi see skriptiga läbi: iga koodi kohta üks otsingupäring. Salvesta id, status, local_status ja vat_number ning võrdle neid arve- ja lepinguandmetega. Kõik, mille staatus ei ole active või mille nimi või KMKR-number ei kattu lepingus olevaga, lähevad käsitsi ülevaatusele. Seejärel pane tarnijad POST /monitor abil seire alla: edaspidi vaatad üle ainult need, mille kohta tuleb teade.

Vigase registrikoodi korral vastab API veaga 400 validation_error, nii et kirjavead tulevad nähtavale kohe, mitte vaikselt tühja tulemusena.

Milline pakett sobib

Tarnijabaasi regulaarseks kontrolliks ja seireks piisab Starterist (9,99 € kuus, 1 000 krediiti). Kui kasutad ka sanktsioonide kontrolli (beeta) ja veebihaake, vali 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.

Seotud lehed

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.

Frequently asked questions

Kuidas kontrollida tarnija KMKR-numbrit?
Otsi GET /companies/search?country=EE&vat=... või loe vat_number ettevõtte profiilist. Teise EL riigi numbrit kontrollid päringuga GET /vat/{number}.
Kas saan teate, kui tarnija läheb likvideerimisele?
Jah: pane tarnija POST /monitor abil seire alla ja veebihaak teavitab staatuse muutusest ja registrimuudatustest.
Kas API annab tarnija finantsaruanded?
Eesti ettevõtete kohta mitte. Finantsaruanded on olemas mõne teise riigi ettevõtete kohta (Scale-pakett), kuid mitte Eesti jaoks.
Kas sanktsioonide kontroll on valmis?
See on beetaversioon ja kuulub Professional-paketti.
Kas prooviperioodiks on kaart vaja?
Jah. 14 päeva, 500 krediiti, kaart nõutav, prooviperioodi jooksul tasu ei võeta; seejärel Starter 9,99 € kuus, kui sa ei tühista.