# Obchodný register SR (ORSR)

> Spoločníci, štatutári, základné imanie a predmety podnikania z Obchodného registra SR. Výpis podľa IČO cez REST API bez scrapovania.

Obchodný register obsahuje detail, ktorý v RPO nie je: kto firmu vlastní, kto za ňu koná, aké má základné imanie a akým spôsobom konajú štatutári. Týka sa obchodných spoločností a družstiev, nie živnostníkov.

## Čo register obsahuje
- Spoločníci vrátane výšky vkladu, splatenia, meny a podielu v percentách
- Štatutárny orgán – typ orgánu, mená, funkcie (predseda, podpredseda, člen), adresy a dátumy vzniku a zániku funkcie
- Dozorná rada, prokuristi so spôsobom konania, likvidátori, správcovia, zakladatelia a právni predchodcovia
- Emisie akcií – druh, podoba, forma, menovitá hodnota a počet
- Spôsob konania v mene spoločnosti
- Základné imanie a rozsah splatenia
- Predmety podnikania tak, ako sú zapísané v registri
- Oddiel a vložka, teda spisová značka, plus príslušný súd
- Zoznam listín uložených v zbierke

## Polia, ktoré vraciame

| Pole | Význam |
| --- | --- |
| `orsr_id` | Identifikátor záznamu v Obchodnom registri. |
| `registered_capital` | Základné imanie vrátane meny. |
| `shareholders` | Pole spoločníkov a akcionárov (len majetková účasť): name, address, share_amount, share_paid, share_currency, share_percentage, contribution_kind, deposit_lien, is_company, ico, stakeholder_type, function, effective_from, effective_to, current. |
| `supervisory_board` | Pole členov dozornej rady: name, address, is_company, ico, stakeholder_type, function (chairman / vice_chairman / member), effective_from, effective_to, current. |
| `procurators` | Pole prokuristov vrátane spôsobu konania prokuristu (acting_method). |
| `legal_predecessors` | Pole právnych predchodcov (zlúčené spoločnosti) s IČO. |
| `other_stakeholders` | Pole ďalších zapísaných osôb mimo dozornej rady, prokuristov, likvidátorov, správcov, zakladateľov a vedúcich organizačných zložiek (tie majú vlastné polia): name, address, is_company, ico, stakeholder_type, function, effective_from, effective_to, current. |
| `shares` | Pole emisií akcií: share_type, share_form, share_state, nominal_value, currency, count, transferability, effective_from, effective_to, current. |
| `statutory_body` | Pole štatutárov: name, role, function, body_type, address, acting_method, appointed_at, effective_from, effective_to, current. |
| `business_activities` | Pole predmetov podnikania: activity a since (dátum zápisu). |

## Ako si dáta vyžiadate

```http
GET /v1/company/ico/51636549

{
  "orsr_id": "SK-51636549",
  "shareholders": [
    { "name": "...", "share_percentage": "100.00", "is_company": false }
  ],
  "statutory_body": [
    { "name": "...", "role": "Konateľ" }
  ]
}
```

## Ako často aktualizujeme

Priebežne, s prioritou podľa toho, ako často sa subjekt dopytuje. Ak je detail starší ako 30 dní, vrátime posledné známe dáta okamžite spolu s príznakom stale a na pozadí spustíme obnovu – nečakáte na odpoveď registra.

## Na čo sa to používa

Pri preverovaní obchodného partnera je toto zdroj, ktorý povie, kto je za firmou. Spoločníci a štatutári sú vstupom do kontroly konfliktu záujmov aj do preverovania konečných užívateľov výhod.

Pri onboardingu klienta v regulovanom prostredí sa štatutár používa na kontrolu oprávnenia podpísať zmluvu. Pole acting_method hovorí, či konateľ koná samostatne alebo je potrebný podpis viacerých.

## Časté otázky

### Prečo niektoré firmy nemajú ORSR dáta?

Pretože v Obchodnom registri nie sú. Živnostníci, občianske združenia a orgány verejnej moci doň nepatria – pre tie máte údaje z RPO.

### Scrapujete stránku orsr.sk?

Nie. Čítame oficiálne rozhranie registra. Znamená to stabilnejšiu štruktúru dát a to, že sa nespoliehame na rozloženie HTML, ktoré sa môže kedykoľvek zmeniť.

### Sú v odpovedi aj historickí spoločníci?

Áno. Každý záznam nesie effective_from, effective_to a príznak current – aktuálny stav získate filtrom current = true. Zmeny vlastníctva sa dajú sledovať aj cez webhook company.updated, ktorý zachytí zmenu v čase, keď nastane.