Registar poslovnih subjekata

Pregled statusa sinkronizacije i API-ja

Ovdje vidiš zadnje pokretanje Sudreg cron joba i možeš ga ručno pokrenuti, zaustaviti ili rollbackati.

Status joba

IDLE

Faza / endpoint

–

Početak

–

Završetak

–

API base:

Odgovor statusa (JSON)

{}

API metode

Popis endpointa koje backend izlaže, grupirano na public, write i cron. Podaci dolaze iz /api/sudreg_docs.

Još nema učitanih podataka.

Prikaži raw JSON /api/sudreg_docs

{}

Specifikacija endpointa (statički popis)

Base URL: https://registar-poslovnih-subjekata.onrender.com

Javni endpointi

Metoda	Putanja	Opis
GET	`/`	Health-check (isti odgovor kao `/health`).
GET	`/health`	Health-check.
GET	`/api/sudreg_token`	Dohvat OAuth tokena za Sudreg (client_credentials).
GET	`/api/sudreg`	Proxy prema Sudreg API-ju. Obavezan parametar `endpoint` (npr. `subjekti`, `detalji_subjekta`, `sudovi`); ostali query parametri se prosljeđuju.
GET	`/api/sudreg_expected_counts`	Čitanje očekivanih brojeva redaka po endpointu/snapshotu iz baze. Parametri: `snapshot_id` (obavezno), opcionalno `endpoint`, `limit`, `offset`.
GET	`/api/sudreg_cron_daily/status`	Status zadnjeg `cron_daily` joba (startedAt, finishedAt, status, summary, currentPhase, currentEndpoint).
GET	`/api/sudreg_docs`	JSON s popisom svih endpointa i konfiguracijom Sudreg API-ja.

Write endpointi (zahtijevaju API ključ)

Metoda	Putanja	Opis
POST	`/api/sudreg_token`	Dohvat OAuth tokena (isto kao GET, ali POST).
POST	`/api/sudreg_expected_counts`	Dohvat `X-Total-Count` sa Sudreg API-ja i upis u `rps_sudreg_expected_counts`. Opcionalno: `snapshot_id`.
POST	`/api/sudreg_sync_entiteti`	Sync entitetskih tablica (subjekti, tvrtke, sjedista, email_adrese, postupci, pravni_oblici, pretezite_djelatnosti, predmeti_poslovanja, evidencijske_djelatnosti, temeljni_kapitali) za jedan snapshot. Parametri: `snapshot_id`, `max_batches`.
POST	`/api/sudreg_sync_promjene`	Sync Sudreg promjena u tablicu `sudreg_promjene`. Parametri: `snapshot_id`, `start_offset`.

Cron / ETL endpointi (API ključ)

Metoda	Putanja	Opis
POST	`/api/sudreg_cron_daily`	Pokreće daily job: `expected_counts` → `sync_sifrarnici` → `sync_entiteti`. Bez parametara vraća 202 (background). Uz `?wait=1` čeka završetak i vraća 200 + summary.
POST	`/api/sudreg_cron_daily/stop`	Zahtjev za zaustavljanje tekućeg sync joba (postavlja `cronDailyShouldStop=true`).
POST	`/api/sudreg_cron_daily/rollback`	Zaustavlja sync i briše sve podatke iz tablica `sudreg_%` i `rps_sudreg_%`.

Primjeri poziva (curl)

Base URL: https://registar-poslovnih-subjekata.onrender.com

Bez upisa u bazu

Ovi pozivi ili samo proxy-aju prema Sudreg API-ju ili čitaju postojeće podatke iz naše baze.

# Token za Sudreg (client_credentials)
curl -s "https://registar-poslovnih-subjekata.onrender.com/api/sudreg_token"

# Proxy prema Sudreg API-ju – subjekti (snapshot_id=123, prva stranica)
curl -s "https://registar-poslovnih-subjekata.onrender.com/api/sudreg?endpoint=subjekti&snapshot_id=123&limit=10&offset=0"

# Detalji subjekta po OIB-u
curl -s "https://registar-poslovnih-subjekata.onrender.com/api/sudreg?endpoint=detalji_subjekta&tip_identifikatora=oib&identifikator=12345678901"

# Šifrarnik sudova
curl -s "https://registar-poslovnih-subjekata.onrender.com/api/sudreg?endpoint=sudovi&snapshot_id=123"

# Očekivani brojevi redaka (čitanje iz rps_sudreg_expected_counts)
curl -s "https://registar-poslovnih-subjekata.onrender.com/api/sudreg_expected_counts?snapshot_id=123"

S upisom u bazu (API ključ)

Ovi pozivi čitaju Sudreg API i upisuju/obnavljaju podatke u tablicama rps_sudreg_% i sudreg_%. Potreban je API ključ: X-API-Key: <tvoj_kljuc>.

# Upis očekivanih brojeva redaka za jedan snapshot (rps_sudreg_expected_counts)
curl -s -X POST "https://registar-poslovnih-subjekata.onrender.com/api/sudreg_expected_counts?snapshot_id=123" \
  -H "X-API-Key: TVOJ_API_KLJUC"

# Sync promjena (Sudreg /promjene → sudreg_promjene)
curl -s -X POST "https://registar-poslovnih-subjekata.onrender.com/api/sudreg_sync_promjene?snapshot_id=123" \
  -H "X-API-Key: TVOJ_API_KLJUC"

# Sync entiteta (subjekti, tvrtke, sjedista, ...) za snapshot_id=123
curl -s -X POST "https://registar-poslovnih-subjekata.onrender.com/api/sudreg_sync_entiteti?snapshot_id=123&max_batches=5" \
  -H "X-API-Key: TVOJ_API_KLJUC"

# Cijeli cron_daily (expected_counts → šifrarnici → entiteti) u pozadini
curl -s -X POST "https://registar-poslovnih-subjekata.onrender.com/api/sudreg_cron_daily" \
  -H "X-API-Key: TVOJ_API_KLJUC"

# cron_daily uz čekanje završetka
curl -s -X POST "https://registar-poslovnih-subjekata.onrender.com/api/sudreg_cron_daily?wait=1" \
  -H "X-API-Key: TVOJ_API_KLJUC"

Sudreg open_api metode (izvorni servis)

Službena open_api specifikacija Sudreg javnog servisa dostupna je na:
https://sudreg-data.gov.hr/api/javni/dokumentacija/open_api

Donji popis je sažetak najčešće korištenih metoda. Sve su GET i prihvaćaju standardne parametre za straničenje: snapshot_id, offset, limit, no_data_error, omit_nulls (ako nije drukčije navedeno).

Glavna knjiga – subjekti i osnovni podaci

Path	Sažetak	Ključni parametri
`/subjekti`	Osnovni podaci o subjektima.	`snapshot_id`, `tvrtka_naziv`, `only_active`, `offset`, `limit`
`/tvrtke`	Pune tvrtke / nazivi subjekata.	`snapshot_id`, `offset`, `limit`
`/skracene_tvrtke`	Skraćene tvrtke.	`snapshot_id`, `offset`, `limit`
`/sjedista`	Sjedišta i adrese subjekata.	`snapshot_id`, `offset`, `limit`
`/email_adrese`	E-mail adrese subjekata.	`snapshot_id`, `offset`, `limit`
`/postupci`	Postupci nad subjektima (stečaj, likvidacija...).	`snapshot_id`, `offset`, `limit`
`/temeljni_kapitali`	Temeljni kapitali subjekata.	`snapshot_id`, `offset`, `limit`

Djelatnosti i poslovanje

Path	Sažetak	Ključni parametri
`/pretezite_djelatnosti`	Pretežite djelatnosti subjekata.	`snapshot_id`, `offset`, `limit`
`/predmeti_poslovanja`	Predmeti poslovanja (djelatnosti) subjekata.	`snapshot_id`, `expand_relations`, `offset`, `limit`
`/evidencijske_djelatnosti`	Evidencijske djelatnosti (nije obavezno upisivati).	`snapshot_id`, `offset`, `limit`
`/gfi`	Predana godišnja financijska izvješća (meta‑podaci).	`snapshot_id`, `offset`, `limit`

Podružnice

Path	Sažetak	Ključni parametri
`/nazivi_podruznica`	Nazivi podružnica subjekata.	`snapshot_id`, `offset`, `limit`
`/skraceni_nazivi_podruznica`	Skraćeni nazivi podružnica.	`snapshot_id`, `offset`, `limit`
`/sjedista_podruznica`	Sjedišta i adrese podružnica.	`snapshot_id`, `offset`, `limit`
`/email_adrese_podruznica`	E-mail adrese podružnica.	`snapshot_id`, `offset`, `limit`
`/djelatnosti_podruznica`	Djelatnosti podružnica.	`snapshot_id`, `offset`, `limit`

Ostalo, promjene i snimke

Path	Sažetak	Ključni parametri
`/promjene`	Popis zadnjih promjena nad subjektima.	`snapshot_id`, `offset`, `limit`
`/snapshots`	Popis svih snimki baze sudskog registra.	`no_data_error`, `omit_nulls`
`/counts`	Ukupan broj redaka po tablici (aktivni i povijesni).	`snapshot_id`, `no_data_error`, `omit_nulls`
`/detalji_subjekta`	Svi podaci o jednom subjektu u strukturiranom objektu.	`tip_identifikatora` (mbs\|oib, obavezno), `identifikator` (obavezno), `snapshot_id`, `expand_relations`, `only_active`

Šifrarnici (primjeri)

Path	Sažetak	Ključni parametri
`/drzave`	Šifrarnik država.	`snapshot_id`, `history_columns`, `no_data_error`
`/jezici`	Šifrarnik jezika.	`snapshot_id`, `history_columns`, `no_data_error`
`/nacionalna_klasifikacija_djelatnosti`	NKD šifrarnik djelatnosti.	`snapshot_id`, `history_columns`, `no_data_error`
`/sudovi`	Šifrarnik sudova (uključuje stalne službe).	`snapshot_id`, `expand_relations`, `history_columns`
`/valute`	Šifrarnik valuta.	`snapshot_id`, `expand_relations`, `history_columns`
`/vrste_pravnih_oblika`	Vrste pravnih oblika.	`snapshot_id`, `history_columns`, `no_data_error`
`/vrste_postupaka`	Vrste postupaka (stečaj, likvidacija...).	`snapshot_id`, `no_data_error`
`/statusi`	Šifrarnik statusa retka.	`snapshot_id`, `no_data_error`