# 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 a podielu v percentách
- Štatutárny orgán – mená, funkcie, adresy a dátumy vzniku a zániku funkcie
- 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: name, address, share_amount, share_percentage, is_company, ico. |
| `statutory_body` | Pole štatutárov: name, role, address, acting_method. |
| `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?

Vraciame aktuálny stav zápisu. Historické zmeny vlastníctva sa dajú sledovať cez webhook company.updated, ktorý zachytí zmenu v čase, keď nastane.