Verejné zmluvy SK + CZ

Centrálny register zmlúv (CRZ) je verejný register na crz.gov.sk, kde od roku 2011 musí byť zverejnená každá zmluva, kde jedna strana je štát alebo obec. Bez zverejnenia zmluva nenadobúda účinnosť (§ 47a Občianskeho zákonníka). Český Registr smluv (smlouvy.gov.cz, od 2016) má ten istý princíp pre CZ verejné subjekty. Open data, CC-BY 4.0, stiahnuteľné ako bulk CSV / JSON. Entyrix ingestuje oba denne.

SK: od 1. 1. 2011 (zavedenie zákona 382/2011 o povinnom zverejňovaní zmlúv). CZ: od 1. 7. 2016 (zákon 340/2015 Sb.). Aktuálne máme 14 429 020 zmlúv v DB, najstaršie z 2011-01-04, najnovšie z 2026-08-01. Weekly refresh (nedeľa 04:15) + denný delta sync.

GET /api/v1/companies/:ico/contracts vracia per-firma zoznam: supplier_ico, supplier_name, buyer (department / ministry / municipality), title, amount_cents (EUR), published_at, signed_at, contract_url (naspäť do CRZ), subject_matter. Plus denorm na companies: public_contracts_count, public_contracts_total_cents, last_contract_date. Pre-computed pre rýchle filtre v advanced-search.

Workflow: (1) GET /api/v1/companies/advanced-search?nace_prefix=62&has_contracts=1&limit=100&sort=contracts_total_desc — TOP IT (NACE 62) dodávatelia štátu. (2) Pre konkrétnu firmu: GET /api/v1/companies/:ico/contracts — všetky jej zmluvy. (3) Cross-ref s /compliance (shell address? sankcie? UBO offshore?) — red-flag kombinácia. (4) CSV export pre spreadsheet analysis: /api/v1/companies/advanced-search.csv?nace_prefix=62&has_contracts=1 — 38 stĺpcov vrátane NIS2/credit/UBO. Licencia je per-feed (viď attribution header v CSV + meta.license v JSON): CRZ/Registr smluv sú CC-BY 4.0, no niektoré stĺpce (napr. FS bank accounts) majú vlastnú upstream licenciu (per-feed) — nedajú sa re-publikovať pod jednou CC-BY 4.0 strieškou.

Niektoré rámcové zmluvy (framework agreements) deklarujú maximálny zazmluvnený objem, nie reálnu čerpanú hodnotu. MIRRI (Ministerstvo investícií, regionálneho rozvoja a informatizácie) má jednu mega-zmluvu s max limit €11 mld na viacročný operačný program — skutočné čerpanie je stovky miliónov/ročne. Pre reálny cash flow kombinuj s ITMS datasetom (/eu-funds-recipients) kde sú actual payments. Total €490.7 mld agregát teda "deklarované zazmluvnené maximum", nie skutočne vyplatené.

Áno — ale licencia je per-feed, nie jedna strieška. CRZ/Registr smluv sú CC-BY 4.0 (attribution: footer link na entyrix.com + uvedenie zdrojov CRZ/Registr smluv, komerčné použitie OK). Iné feedy majú vlastnú licenciu uvedenú v meta.license (JSON) / attribution headeri (CSV) — napr. FS bank accounts sú nekomerčné, share-alike feedy (ICIJ Offshore Leaks = ODbL 1.0 + CC-BY-SA 3.0) majú povinnosť rovnakého zdieľania. Pred re-publikovaním skontroluj licenciu konkrétneho poľa. Rate-limit 600 req/min per API key (free tier, bez karty). Primer product ideas: (a) alerty pre novinárov keď sa objaví mega-kontrakt v danom sektore; (b) supplier benchmarking pre procurement tímy; (c) anti-korupčný dashboard krížiaci CRZ × shell-address × UBO offshore; (d) NGO compliance rating štátu per ministerstvo.

(1) Supplier IČO: ~3 % starších zmlúv (2011-2013) má supplier_cin prázdny alebo neparsovateľný — fallback parsovanie z názvu. (2) Preklepy v názvoch: ten istý dodávateľ môže mať 3-5 variantov mena (s.r.o. vs. s. r. o., diakritika). Rieši ER (entity resolution) cez IČO priamy match. (3) Rámcové zmluvy: sumy sú max zazmluvnené, nie čerpané (viď FAQ vyššie). (4) CZ Registr smluv: niektoré zmluvy sú "utajené" (§ 3 odst. 2 zák. 340/2015), my vidíme len metadátum bez obsahu. (5) Dátumový drift: published_at ≠ signed_at (môže byť mesiace rozdiel pri backlog publikáciách).