Prometiam je en REST API z uradnimi podatki registrov 37 držav. Za Slovenijo: zapis družbe iz Poslovnega registra Slovenije (AJPES) po matični številki ali imenu, v enaki obliki kot za vsako drugo državo.
Prometiam je plačljiv REST API, ki podatke uradnih registrov podjetij vrača v enotni obliki. Za vsako državo dobite isti objekt podjetja z enakimi ključi v enakem vrstnem redu, vrednost, ki je register ne objavlja, pa je null, nikoli izpuščena. En ključ in isti klici veljajo za vse države, ki jih pokrivamo; katere so in kakšne so omejitve vsake od njih, vedno pove GET /coverage.
Vir je Poslovni register Slovenije (PRS), ki ga vodi AJPES: njegov odprti seznam na portalu Odprti podatki Slovenije (OPSI). Družbo poiščete po matični številki (10 mest ali sedemmestna oblika) ali po imenu.
| Polje | Pomen |
|---|---|
company_name, company_number | Ime družbe brez oznake stečaja ali likvidacije in matična številka, 10 mest s končnico 000 |
legal_form | Pravnoorganizacijska oblika: d.o.o., d.d., d.n.o., k.d. ali SE |
status | Prebrano samo iz oznake v imenu (v stečaju, v prisilni likvidaciji, v likvidaciji), sicer active; družba, ki izgine s seznama, je deregistered |
address, postal_code, city | Poslovni naslov: ulica in hišna številka, poštna številka in pošta |
registry_details | Registrsko sodišče, ime, kot ga objavlja register (name_as_registered), in celotno besedilo pravnoorganizacijske oblike |
Matično številko, polja zapisa in klic podrobno opisuje vodnik AJPES API.
Družba Krka po matični številki 5043611000:
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=SI&company_number=5043611000' \ -H 'Authorization: Bearer rk_live_...'
Odgovor vsebuje seznam data, vsak zapis pa polje id, s katerim GET /companies/{id} vrne celoten zapis. Sedemmestno obliko (5043611) API prebere z dodano končnico 000. Številka z drugo končnico označuje poslovno enoto in se zavrne, prav tako napačno oblikovana številka (napaka 400, validation_error); kontrolna števka je le svetovalna, ker ji nekatere vpisane družbe ne ustrezajo.
founded_after ne najde nobene slovenske družbe in starost družbe ni na voljo.vat se zavrne, polje vat_number je null.active, kar pomeni le, da je v registru. Družba v postopku brez oznake je prikazana kot aktivna.Vir: Poslovni register Slovenije – AJPES (Poslovni register Slovenije Agencije Republike Slovenije za javnopravne evidence in storitve), objavljen na portalu Odprti podatki Slovenije (OPSI) pod licenco Creative Commons Priznanje avtorstva 4.0. Prilagodil Prometiam (stanje prebrano iz oznake v imenu in oznaka odstranjena iz imena, hišne številke normalizirane).
POST /companies/lookup): do 100 številk v enem klicu, vsaka postavka stane 1 kreditGET /company-events/search?country=SI, 2 kredita na klicPOST /monitor): webhook sporoči spremembo stanja, prenehanje, ujemanje s seznamom sankcij in dogodke v registruGET /vat/{number}countryCene so javne, prodajni klic ni potreben. Starter stane 9,99 € na mesec (1.000 kreditov), Professional 29,99 € (10.000 kreditov), Scale 99,99 € (50.000 kreditov), Enterprise pa je po dogovoru. Iskanje ali zapis družbe stane 1 kredit, preverjanje po seznamih sankcij (beta) 3 kredite; odgovori z napako so brezplačni. Preizkus traja 14 dni in vključuje 500 kreditov: potrebna je plačilna kartica, med preizkusom se nič ne zaračuna, nato pa velja Starter, če ne odpoveste.
Registracija · Dokumentacija API
Preizkusno obdobje traja 14 dni in vključuje 500 kreditov. Potrebna je plačilna kartica, med preizkusom se nič ne zaračuna; nato velja paket Starter (9,99 € na mesec), če ne odpoveste.