MBS ili OIB na ulazu, standardizirani profil tvrtke iz Sudskog registra na izlazu. Isti oblik odgovora kao za ostalih 17 zemalja, pa hrvatski klijenti ne traže poseban kod.
Obveznici iz Zakona o sprječavanju pranja novca i financiranja terorizma (među ostalima pružatelji usluga povezanih s virtualnom imovinom te revizori i računovođe) moraju prije uspostave poslovnog odnosa utvrditi i provjeriti identitet stranke, uključujući pravnu osobu. Popis obveznika i opseg provjere određuje sam Zakon, pa ga provjerite u aktualnom pročišćenom tekstu; ova stranica nije pravni savjet. U praksi to znači otvoriti web-pretraživač Sudskog registra, prepisati podatke u vlastiti sustav i ponoviti postupak za svakog klijenta. Kod nekoliko desetaka onboardinga mjesečno to je trošak koji nitko ne vidi, a kod stotina je to usko grlo.
Prometiam taj korak pretvara u jedan REST poziv. Sustav vraća službene podatke Sudskog registra u istom standardnom obliku kao i za Španjolsku, Francusku, Poljsku ili Veliku Britaniju. Ako klijent posluje i u drugim državama, ne gradite drugu integraciju: mijenja se samo parametar country. Ako trebate samo jednokratnu provjeru, upotrijebite besplatnu pretragu Sudskog registra.
Tok ima tri koraka: pronađite tvrtku, dohvatite profil i, ako je potrebno, uključite praćenje. Pretraga prihvaća company_number (MBS), oib ili name.
# 1. Pretraga po MBS-u (npr. INA d.d.)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=HR&company_number=080000604' \
-H 'Authorization: Bearer rk_live_...'
# 2. Puni profil tvrtke (id iz rezultata pretrage)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/{id}' \
-H 'Authorization: Bearer rk_live_...'
# 3. Provjera naziva po sankcijskim listama (beta)
curl 'https://api.prometiam.com/functions/v1/risk-api/sanctions/screen?name=INA-Industrija%20nafte' \
-H 'Authorization: Bearer rk_live_...'
Isti tok u Pythonu, s odlukom o ručnom pregledu:
import os, requests
API = 'https://api.prometiam.com/functions/v1/risk-api'
HEAD = {'Authorization': f'Bearer {os.environ["PROMETIAM_API_KEY"]}'}
def kyb_hr(mbs):
r = requests.get(f'{API}/companies/search',
params={'country': 'HR', 'company_number': mbs}, headers=HEAD).json()
if not r.get('data'):
return {'status': 'not_found'}
firma = requests.get(f'{API}/companies/{r["data"][0]["id"]}', headers=HEAD).json()['data']
sank = requests.get(f'{API}/sanctions/screen',
params={'name': firma['company_name']}, headers=HEAD).json()['data']
ok = firma['status'] == 'active' and not sank
return {'status': 'ok' if ok else 'review', 'firma': firma, 'sankcije': sank}
| Polje | Značenje |
|---|---|
company_name, company_number | Naziv tvrtke i MBS; OIB je u identifiers |
status, local_status | Standardni status i izvorni opis iz registra |
legal_form, local_legal_form | Pravni oblik (d.o.o., d.d., j.d.o.o.) standardizirano i kako ga navodi registar |
founding_date, adresa | Datum osnivanja i sjedište |
vat_number, vat_number_source | PDV broj u obliku HR + OIB; izvor je rule |
PDV broj za hrvatske tvrtke izveden je pravilom iz OIB-a (HR + OIB): oblik je ispravan, ali registracija u sustavu PDV-a nije potvrđena. Za potvrdu pozovite GET /vat/HR..., koji provjerava broj u sustavu VIES.
Cijene su javne, bez razgovora s prodajom; godišnje plaćanje donosi dva mjeseca besplatno. Za većinu hrvatskih onboarding timova dovoljan je Starter, a Professional je potreban čim uključite sankcije ili webhookove.
Izvor: Sudski registar. Prometiam standardizira podatke i nije ovjereni izvadak iz registra.
Pokreni besplatno probno razdoblje od 14 dana · Dokumentacija API-ja
Probno razdoblje traje 14 dana i uključuje 500 kredita. Kartica je obavezna, tijekom probnog razdoblja ništa se ne naplaćuje; nakon toga slijedi paket Starter (9,99 € mjesečno) ako ne otkažete.