Provera ugovorne strane po matičnom broju preko API-ja

Od matičnog broja do proverenog zapisa o kompaniji za nekoliko sekundi: naziv, pravna forma, status, datum osnivanja i opština, iz Registra privrednih subjekata, u istom obliku kao za svaku drugu zemlju.

Zašto proveravati ugovornu stranu u registru

Pre posla treba utvrditi da privredno društvo postoji, da se njegov naziv i pravna forma poklapaju sa ugovorom i da nije u likvidaciji ili stečaju. Podatke koje vam ugovorna strana sama pošalje ne treba uzimati zdravo za gotovo: registar je izvor koji se može navesti u internoj proceduri, reviziji i pred nadzornim organom.

Ručno (otvoriti registar, snimiti ekran, prepisati podatke) to ne radi kada ugovornih strana ima više desetina nedeljno ili kada proveru treba ponoviti. Zato se provera pretvara u poziv API-ja koji se ugrađuje u onboarding, ERP ili CRM i svaki put vraća isti oblik odgovora.

Kako to radi sa Prometiam API-jem

Srpska kompanija se nalazi po matičnom broju od 8 cifara (company_number) ili po nazivu (name), latinicom ili ćirilicom. Isti poziv i isti oblik odgovora važe za svaku drugu zemlju, pa se logika provere ne piše iznova za Srbiju.

  • GET /companies/search?country=RS&company_number=17204106 nalazi kompaniju i vraća standardni objekat kompanije.
  • GET /companies/{id} vraća ceo zapis (koristite id iz odgovora pretrage).
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=RS&company_number=17204106' \
  -H 'Authorization: Bearer rk_live_...'

Skraćeni odgovor na ovaj zahtev. Vrednosti su ilustrativne (datum je zamenjen oznakom mesta), a stvarni odgovor ima sva standardna polja objekta kompanije:

{
  "data": [
    {
      "company_name": "PREDUZEĆE ZA SPOLJNU I UNUTRAŠNJU TRGOVINU ELEKTROHEM DOO, BEOGRAD (NOVI BEOGRAD)",
      "company_number": "17204106",
      "legal_form": "DOO",
      "status": "active",
      "city": "NOVI BEOGRAD",
      "founding_date": "GGGG-MM-DD"
    }
  ]
}

Šta proveriti u odgovoru

  • status: aktivno društvo, u likvidaciji, u prinudnoj likvidaciji, u stečaju ili brisano iz registra. Registar se objavljuje kao mesečni presek koji sadrži samo subjekte koji još postoje, pa društvo koje nestane iz preseka dobija status brisanog.
  • legal_form i company_name: da li se pravna forma (d.o.o., a.d., o.d. ili k.d.) i naziv poklapaju sa onim što stoji u ugovoru.
  • founding_date: datum osnivanja; veoma novo društvo je razlog za dodatnu pažnju.
  • city: opština sedišta; ulica i broj se ne objavljuju u otvorenim podacima.
  • nace_class: delatnost, pročitana iz šifre KD 2010, nacionalne verzije klasifikacije NACE Rev. 2.

Praćenje posle provere

Provera važi samo na dan kada je urađena. Zato se ugovorna strana može pretplatiti na praćenje (POST /monitor): webhook javlja promenu statusa, brisanje iz registra, poklapanje sa sankcionom listom i događaje promena u registru (naziv, status, pravna forma, adresa). Događaji se datiraju kada se promena prvi put pojavi u mesečnom preseku, a brisanje iz registra daje upozorenje o prestanku datirano proverom koja ga je prva uočila, jer registar ne daje datum prestanka. Događaja pre lansiranja Srbije u oktobru 2026. nema; prvi stižu sa sledećim mesečnim presekom. Poziv događaja košta 2 kredita.

Granice za Srbiju

  • Rukovodioce, osnivače i stvarne vlasnike: za Srbiju postoji samo zapis o kompaniji. Nema ni signala usklađenosti registra.
  • Ulicu i broj, osnovni kapital i poreski broj (PIB): otvoreni podaci ih ne sadrže. Umesto adrese vraća se opština (latinicom), a pretraga po vat se odbija.
  • Finansijske izveštaje i obaveštenja o insolventnosti: Srbija nije jedno od šesnaest tržišta sa takvim obaveštenjima; stečaj i likvidacija vide se u statusu.
  • Događaje pre lansiranja: događaji promena u registru postoje tek od lansiranja Srbije u oktobru 2026, a prvi stižu sa sledećim mesečnim presekom.
  • Preduzetnike i druge subjekte: isporučuju se samo privredna društva iz Registra privrednih subjekata (d.o.o., a.d., o.d. i k.d.); preduzetnici, zadruge, javna preduzeća, ogranci i predstavništva stranih društava, udruženja i fondacije nikada.

Contains data from the Business Registers Agency of the Republic of Serbia (Агенција за привредне регистре, APR), Open Data API (https://openapi.apr.gov.rs/api/opendata/companies), published under the Serbian Open Data Licence (https://data.gov.rs/sr/terms/). Adapted by Prometiam (status and legal form normalised, municipality names transliterated to Latin, whitespace in names normalised).

Cene

Cene su javne, razgovor sa prodajom nije potreban. Starter košta 9,99 € mesečno (1.000 kredita), Professional 29,99 € (10.000 kredita), Scale 99,99 € (50.000 kredita), a Enterprise se dogovara. Pretraga kompanije ili njen zapis košta 1 kredit, a provera po sankcionim listama (beta) 3 kredita; odgovori sa greškom su besplatni. Probni period traje 14 dana i uključuje 500 kredita: potrebna je platna kartica, tokom probnog perioda se ništa ne naplaćuje, a zatim važi Starter ako ne otkažete pretplatu.

Povezane stranice

Započnite besplatni probni period od 14 dana · API dokumentacija

Probni period traje 14 dana i uključuje 500 kredita. Potrebna je platna kartica, tokom probnog perioda se ništa ne naplaćuje; zatim važi Starter (9,99 € mesečno) ako ne otkažete.

Frequently asked questions

Mogu li proveriti ugovornu stranu samo po nazivu?
Da. Pretraga po nazivu radi latinicom i ćirilicom, ali matični broj daje jedan siguran pogodak, pa se preporučuje kada ga imate.
Šta ako je matični broj pogrešno ukucan?
API proverava kontrolnu cifru i oblik: broj sa pogrešnom kontrolnom cifrom ili 13-cifreni broj (to je JMBG, lični broj) dobija grešku 400 (validation_error). Broj sa manje od 8 cifara čita se sa vraćenom vodećom nulom.
Da li odgovor sadrži PIB?
Ne. Poreski broj (PIB) je poseban broj koji otvoreni podaci registra ne sadrže i koji se ne može izvesti iz matičnog broja; pretraga po vat se odbija.
Koliko košta jedna provera?
Pretraga ili zapis košta 1 kredit. Grupni upit (POST /companies/lookup) prima do 100 brojeva, a svaka stavka košta 1 kredit; odgovori sa greškom su besplatni.