-> Izvještaj - Pregled poslanih obavijesti
Kada sam otvorila tvrtku, ubrzo sam počela zaprimati raznu poštu. U kratkom roku stiglo mi je desetak pisama vrlo sličnog sadržaja od različitih tvrtki. Uz svako pismo bila je priložena i uplatnica na iznose od 80 do 130 eura, uz napomenu kako se radi o "upisu u poslovni registar".
Pisma su bila napisana službenim tonom, s formulacijama poput: "Pozivamo Vas na upis poslovnog subjekta u registar poduzetnika…", a često se dodatno naglašavalo kako će, ako se uplata ne izvrši do odredenog roka, cijena porasti. Tek bi pri samom kraju teksta, nerijetko sitnim slovima, bilo navedeno da plaćanje zapravo nije obavezno.
Zbog forme u kojoj su pisma sastavljena, mnogim primateljima ona djeluju kao još jedna zakonska obveza koju moraju podmiriti.
Međutim te uplatnice nisu obavezne i ne odnose se na nikakav službeni državni registar vec komercijalnu ponudu.
Koliko ovakva praksa može biti zbunjujuća imali smo prilike već čitati a imala sam priliku vidjeti i osobno. Kod javnog bilježnika jedan je čovjek došao na šalter pitati o čemu se radi jer je, nažalost, uplatnicu već platio. Tek tada je shvatio da nije bila riječ o obaveznoj naknadi. Razmišljajući o tome, počela sam se pitati kako su uopće znali da sam tvrtku otvorila i to gotovo odmah.
Odgovor sam pronašla vrlo brzo: Sudski registar je javan, a podaci o tvrtkama dostupni su svima.
Zainteresiralo me kako podaci u registru uopće izgledaju pa sam odlučila istražiti i napravila .NET servis koji svakodnevno dohvaća podatke o novootvorenim tvrtkama iz Sudskog registra te im jednokratno šalje informativnu e-mail obavijest da uplatnice za „upis u poslovni registar” nisu obavezne nego dobrovoljne.
Na portalu otvorenih podataka sudskog registra dostupne su upute za razvojne inženjere s opisima endpointa, usluga je implementirana kao REST servis s Token based autorizacijom.
Kako bi mogli preuzimati podatke potrebno je registrirati se te s user/password pozvati endpoint za dobivanje tokena koji se dalje prosljeđuje za autorizaciju dohvata podataka o subjektima.
Primjer curl poziva za dohvat tokena:
curl -i -k --user user:password --data "grant_type=client_credentials" https://sudreg-data.gov.hr/api/oauth/token
Curl poziv za dohvat tokena
Open API specifikaciju servisa moguće je pregledati u alatu poput swaggera
API sudskog registra u Swaggeru
Predviđena su dva glavna načina upotrebe api-ja:
1. kao upit koji vraća sve dostupne podatke o pojedinom subjektu
2. kao upit koji vraća pojedini podatak za sve subjekte
Za dohvat novootvorenih poslovnih subjekata na dnevnoj bazi, potrebno je zvati
GET api /subjekti koji vraća, ako nije navedeno drugačije, 1000 subjekata po pozivu.
Od parametara kojima je moguće filtrirati podatke, koristila sam:
- snapshot_id - za konzistentne podatke posljednje snimke u registru
- only_active – za prikaz samo aktivnih subjekata
- offset i limit – za uzastopan dohvat po tisuću subjekata dok se ne dohvate svi subjekti
subjekti API request
Odgovor api-ja sadrži samo nekoliko podataka o subjektu, od kojih su ključni:
- mbs - jedinstveni identifikacijski broj dodjeljen svakom subjektu prilikom upisa
- datum_osnivanja – prema datumu prepoznajem koja tvrtka je novokreirana
Primjer odgovora :
subjekti API response
Nakon dohvata podataka o tvrtkama koje su novoosnovane, potrebno je pozvati servis za dohvat više detalja o tvrtkama gdje se nalazi i podatak o emailu subjekta.
API /detalji_subjekta od parametara prima:
- snapshot_id
- tip_identifikatora – obavezno polje “MBS” ili “OIB”
- identifikator – obavezno polje s vrijednosti oib ili mbs ovisno o tipu
Detalji subjekta API request
API kao odgovor vraća više detalja za pojedini poslovni subjekt, od čega sam koristila email.
Primjer odgovora Api-ja:
Detalji subjekta API response
Kreiran je hangfire scheduled job, koji se pokreče jednom dnevno te prikuplja podatke o poslovnim subjektima iz sudskog registra koji su kreirani prethodnoga dana.
Hangfire job
Nakon prikupljanja detalja o tvrtkama koje su kreirane prethodnoga dana, servis šalje email obavijest tvrtkama sa informativnim sadržajem o tome da pristigle ponude za upis u poslovni registar mogu ali nisu dužni koristiti i plaćati. Nakon poslane obavijesti podaci o emailovima subjekata se brišu, sustav ima namjenu isključivo jednokratnog slanja obavijesti.
Više detalja o tome koliko je svakoga dana poslano obavijesti Pogledajte ovdje
Projekt možete podržati:
