Dlho som pátral po rôznych zdrojoch na internete (nejakom verejnom API), kde by sa dali podľa IČO nájsť údaje o firmách, živnostníkoch a pod. Nakoniec som objavil použiteľné API na stránke www.registeruz.sk. Popis API nájdete priamo na ich stránke.
Najprv treba podľa IČO zistiť interné ID účtovnej jednotky takto:
//REQUEST (by ICO):
https://www.registeruz.sk/cruz-public/api/uctovne-jednotky?zmenene-od=2000-01-01&pokracovat-za-id=1&max-zaznamov=1&ico=47700203
//RESPONSE:
{"id":[1535938],"existujeDalsieId":false}
Následne treba použiť vrátené id a zavolať ďalšiu službu, ktorá už vráti detaily subjektu
//REQUEST (by id uctovna jednotka:
https://www.registeruz.sk/cruz-public/api/uctovna-jednotka?id=1535938
//RESPONSE:
{"id":1535938,"idUctovnychZavierok":[2474492,2729646,3067199,3430120,3793175,4164076,4553169,4946096],"skNace":"16290","konsolidovana":false,"dic":"2024060687","ico":"47700203","velkostOrganizacie":"04","druhVlastnictva":"2","kraj":"SK010","pravnaForma":"112","ulica":"Kadnárova 62","psc":"83153","datumPoslednejUpravy":"2020-01-30","datumZalozenia":"2014-03-12","nazovUJ":"NaVidieku.sk s. r. o.","mesto":"Bratislava - mestská časť Rača","okres":"SK0103","sidlo":"SK0103529354","zdrojDat":"SUSR"}
API nevracia žiadny návratový kód, či sa dáta našli alebo nie. Ak zadáte IČO, ktoré systém nenájde, vráti sa vám toto.
{"id":[],"existujeDalsieId":false}
Na volanie používam php funkciu file_get_contents a potom json_decode vytvorím PHP objekt.
$url = 'http://www.registeruz.sk/cruz-public/api/uctovne-jednotky?zmenene-od=2000-01-01&pokracovat-za-id=1&max-zaznamov=1&ico='.$ico;
$content = file_get_contents($url);
$obj = json_decode($content);
$uctj_id = $obj->id
$url = 'http://www.registeruz.sk/cruz-public/api/uctovna-jednotka?id='.$uctj_id;
$content = file_get_contents($url);
$obj = json_decode($content);
$nazov = $obj->nazovUJ;
Ak má hľadaný subjekt aj DIČ, verifikujem jeho IČ DPH pomocou európskeho systému VIES.
5 thoughts on “API na vyhľadanie firmy vo verejných registroch”
Ďakujem pekne!
Ak ma niekto postup ako ziskat data z ICO cez https://ekosystem.slovensko.digital/otvorene-api#rpo budem tiez vdacny. Tam sa to dotazuje podla nejakeho ID a neviem vie kde to ID zohnat.
Obávam sa, že sa to dá normálne používať až po registrácii. To už ale nie je zadarmo, viď. cenník. Existuje ešte niečo ako SQL API, cez to sa vieš dostať aj k tomu ID, preklikaj dokumentáciu. Tiež sa ale musíš zaregistrovať (úplne dole na stránke) aby si získal API KEY na prístup. Ja som sa s tým trocha hral, len som to nakoniec vzdal, lebo mi nebolo jasné ako presne to je spoplatnené. Tam sa nejako rátali DB dotazy a na moju otázku ako presne sa to počíta som už nedostal odpoveď. Tak som skončil na API, ktoré ma registeruz.sk. Funguje, ale zmeny a nové subjekty sa premietajú s veľkým oneskorením.
Ešte som tam našiel aj API, kde vieš priamo zadať IČO alebo názov – https://ekosystem.slovensko.digital/sluzby/autoform/integracny-manual#api Tam ale potrebuješ private_access_token , čo získaš asi len registráciou a za poplatok.
Pripajam celkom uzitocne API zo statistickeho uradu, ktore vrati aj spominane zahadne ID cislo 😉
Priklad: Firma s ICO = 51207664
https://api.statistics.sk/rpo/v1/search?identifier=51207664
vrati json udaje, kde sa da vycitat id=9363105
Tak pomocou tohto sa to potom už dá pekne vyskladať. Super, ďakujem za tip. Register UZ má oneskorenie pri zmenách a nových subjektoch. Pri zmene je to minimálne 14 dní oproti ORSR. Kedysi som používal html parser priamo na ORSR, ale keď pošleš viac dotazov z tej istej IP v priebehu nejakého času tak to zablokujú.