Lühivastus
Kui sinu toode tegeleb Eesti või Läti ettevõtetega, vajad kolme asja: puhast kirjet iga ettevõtte kohta, viisi oma andmete sellega sidumiseks ja viisi kuulda, kui see muutub. ContactPiti andme-API annab kõik kolm mõlema riigi kohta ühes vormingus, iga fakti juures allikas ja kuupäev.
Miks ise tegemine on raske
Eestil ja Lätil on kummalgi oma register, oma vormingute, väljanimede ja tähendustega. Mõlema vastu ehitamine tähendab kahte liidestust, kahte komplekti erijuhte ja öist tööd, mis märkaks muudatusi. Globaalsed andmebaasid katavad mõlemat riiki, aga õhukeselt: välju on puudu ja uuendused jõuavad hilja.
Nii jõuab enamik tooteid ettevõttekirjeteni, mis on käsitsi sisse trükitud. Need on valed esimesel päeval ja aegunud aasta lõpuks.
Mis andme-API-s on
Iga võti saab tuuma:
- Ettevõttekirjed. Ärinimi, staatus, õiguslik vorm, tegevusalakood, töötajate arv, veebileht, linn ja piirkond, iga välja juures allikas.
- Otsing ja sidumine. Täpne vaste registrikoodi järgi, kandidaadid nime või veebilehe järgi ning filtreeritud otsing staatuse, tegevusala ja suuruse järgi.
- Muudatuste voog. Järjestatud uuendused, kustutamised ja asendused, et sinu koopia püsiks ajakohane.
Ülejäänu lülitatakse sisse võtmepõhiselt, kui oleme kokku leppinud, kuidas seda kasutad:
- Finantsandmed. Majandusaasta aruannete ajalugu, viimane kokkuvõte ning käibe ja kasumi põhinäitajad täpsete väärtustena koos valuuta ja perioodiga.
- Isikud ja rollid. Juhatuse liikmed ja teised ametiisikud, osanikud ja tegelikud kasusaajad ning ettevõtted, kus ettevõttel on osalus.
- Maksud, käibemaks ja aruanded. Käibemaksukohustuslasena registreerimise staatus, aruandeaastad ja viimane esitatud aruanne.
- Äriprofiil. Millega ettevõte tegeleb, inglise ja eesti keeles, loetuna tema enda veebilehelt: kokkuvõte, segmendid, turud, pakkumised, kaubamärgid ja sertifikaadid.
- Signaalid. Kuupäevaga sündmused, näiteks likvideerimine, ühinemine, nime või kapitali muutus, tegevusluba, käibemaks, maksuvõlg ja töötajate arvu muutus.
Mida tiimid sellega ehitavad
- CRM- ja SaaS-tooted ei palu kasutajal enam ettevõtte andmeid trükkida. Nad leiavad vaste registrikoodi, nime või veebilehe järgi, täidavad kirje ja lasevad muudatuste vool seda ajakohasena hoida.
- Finantstehnoloogia, krediidi ja KYB tiimid loevad ettevõtte staatuse ühest allikast, selle asemel et iga uue kliendi puhul mitut registrit külastada, ning lisavad kokkuleppel käibemaksu, aruanded, omanikud ja juhatuse.
- Müügivihjete ja müügi tööriistad otsivad staatuse, tegevusala ja töötajate arvu järgi ning saadavad nimekirjad otse oma tootesse.
- Andmetiimid hoiavad oma koopiat ja loevad ainult seda, mis muutus, õiges järjekorras, selle asemel et registrikoopiat ikka ja jälle uuesti ehitada.
Kuidas liidestus töötab
- Küsi, mida sinu võti kasutada saab. Võimekuste päring loetleb sinu õigused, registrid ja limiidid. Näita funktsiooni oma tootes ainult siis, kui see on sisse lülitatud.
- Seo oma olemasolevad kirjed. Saada registrikood täpse vaste saamiseks. Koodi võrreldakse tekstina, koos algusnullidega. Nimi või veebidomeen tagastab kandidaadid koos põhjendusega, mitte kinnitatud vasteid.
- Salvesta ContactPiti ettevõtte ID. See on püsiv ja jääb samaks, kui ettevõte muudab nime või aadressi.
- Otsi ja lehitse. Küsi, milliseid filtreid register toetab, ja siis otsi. Ühel lehel on kuni 50 ettevõtet.
- Jälgi muudatuste voogu. Hoia otsingust saadud kursor alles ja küsi muudatusi iga paari minuti tagant.
Päringud ja vastused on JSON üle HTTPS-i. Võti läheb Authorization-päisesse ja seda kasutatakse ainult sinu serverist, mitte kunagi brauserist ega mobiilirakendusest. Vaikimisi limiit on 120 päringut minutis kliendi kohta. Täielik viide on API dokumentatsioonis.
Andmepõhimõtted, mida tasub iga pakkuja puhul kontrollida
- Allikas ja kuupäev iga fakti juures. Saad oma kasutajatele näidata, kust väärtus pärineb ja millal seda nähti.
- Puuduval väärtusel on põhjus. Tundmatut ei muudeta kunagi vääraks, nulliks ega tühjaks nimekirjaks.
- Identiteet registrikoodi järgi. Nimed ja veebilehed annavad ainult kandidaate.
- Täpsed arvud. Finantssummad on täpsed kümnendväärtused koos valuuta ja perioodiga. Teisendusi ega kasvuarvutusi sinu eest ei tehta.
- Isikukoode ei ole. Neid ei tagastata kunagi.
Levinud vead
Esimene viga on nime järgi sidumine. Kahel ettevõttel võib olla sama nimi ja üks ettevõte võib seda muuta; registrikood on ainus kindel võti. Teine viga on andmed üks kord kopeerida ja mitte kunagi sünkroonida, mis loob aegunud kirjete probleemi uuesti sinu enda andmebaasis. Kolmas viga on kutsuda API-t brauserist, mis paljastab võtme.
Ligipääsu saamine
Iseteeninduslikku registreerumist ei ole. Ligipääsu seab üles meie tiim ja tavaliselt piisab ühest lühikesest vestlusest: ütle meile, mida ehitad, milliseid riike vajad ja umbes kui palju ettevõtteid loed. Ehitusprojektid ja uurimisnimekirjad on pilootpartneritele samuti API kaudu saadaval; vaata Construction Radarit ja Market Scouti.
KKK
Kas Eesti ja Läti ettevõtete andmete jaoks on API?
Jah. ContactPiti andme-API tagastab Eesti äriregistri ja Läti ettevõtteregistri registreeritud ettevõtted ühes JSON-vormingus, iga fakti juures allikas ja kuupäev.
Kuidas ma API võtme saan?
Iseteeninduslikku registreerumist ei ole. Sa ütled meile, mida ehitad, milliseid riike vajad ja umbes kui palju ettevõtteid loed. Lepime kokku andmestikud, päringulimiidi ja selle, kuidas andmeid tohib kasutada, ning saadame serverivõtme.
Kas API tagastab isikukoode?
Ei. Isikukoode ei tagastata kunagi. Rolli- ja omandikanded nimetavad juhatuse liikmeid, ametiisikuid, osanikke ja tegelikke kasusaajaid ilma nendeta.
Kuidas hoida oma andmekoopia ajakohasena?
Muudatuste voo abil. Pärast otsingut küsid voogu kursoriga ja rakendad järjestatud uuendused, kustutamised ja asendused. Iga paari minuti tagant küsimisest piisab.