# O FirmAPI

Poskytujeme spoľahlivý prístup k údajom slovenských firiem prostredníctvom moderného API.

## Naša misia

FirmAPI vzniklo s cieľom zjednodušiť prístup k údajom z obchodného registra SR. Veríme, že spoľahlivé firemné údaje by mali byť ľahko dostupné vývojárom a firmám.

Štruktúrované, overené, vždy aktuálne.

- **Jednotný prístup** – Jedno API na dopytovanie údajov z 5+ štátnych registrov namiesto scrapingu viacerých webov s nekonzistentnými formátmi.
- **Presnosť na prvom mieste** – Pravidelná synchronizácia s autoritatívnymi zdrojmi zaručuje, že vaša aplikácia vždy pracuje s aktuálnymi údajmi.
- **Vývojársky zážitok** – Prehľadné REST API s JSON odpoveďami, komplexná dokumentácia a predvídateľné spracovanie chýb.

## Náš tím

Sme malý tím vývojárov zo Slovenska, ktorí sa venujú tvorbe užitočných nástrojov pre vývojársku komunitu. FirmAPI vyvíja a spravuje spoločnosť Version Two s. r. o.

## Dáta, na ktoré sa môžete spoľahnúť

- Subjektov v RPO: 2,100,000+
- Synchronizácia zdrojov: Automatická
- Zdrojov údajov: 15+

## Zdroje údajov

Agregujeme a krížovo overujeme údaje z viacerých autoritatívnych slovenských a európskych registrov, aby sme poskytli ucelený pohľad na každý subjekt.

- **RPO** (Register právnických osôb, Primárny zdroj) – Primárny register obsahujúci všetky právnické osoby na Slovensku. Synchronizovaný v týždennom cykle.
- **ORSR** (Obchodný register, Obohatenie) – Oficiálny obchodný register na orsr.sk poskytujúci údaje o spoločníkoch, štatutárnych orgánoch, základnom imaní a predmetoch podnikania.
- **RegisterÚZ** (Register účtovných závierok, Daňové údaje) – Zdroj daňových identifikačných čísel (DIČ). Krížovo prepojený s IČO firmy pre obohatenie daňových údajov.
- **Finančná správa** (Finančná správa SR, Stav DPH) – Oficiálny zoznam platcov DPH (IČ DPH) publikovaný Finančnou správou SR. Aktualizovaný týždenne z publikovaných datasetov.
- **EU VIES** (Systém výmeny informácií o DPH, Validácia) – SOAP služba Európskej komisie na overovanie platnosti IČ DPH v reálnom čase naprieč všetkými členskými štátmi.

## Technológia

FirmAPI je postavené na moderných technológiách vrátane Laravel, Redis a MySQL. Pravidelne agregujeme údaje z RPO (Register právnických osôb), obohacujeme ich o detaily z ORSR, daňové identifikátory z RegisterÚZ, informácie o platcoch DPH z Finančnej správy a overujeme cez EU VIES.

Postavené na spoľahlivosti. Náš stack je optimalizovaný na rýchle odpovede, integritu údajov a nepretržitú dostupnosť.

- **Laravel** – Aplikačný framework zabezpečujúci API routing, spracovanie front a plánované synchronizačné úlohy.
- **MySQL** – Primárne úložisko uchovávajúce 1,2M+ záznamov o subjektoch s optimalizovanými indexmi pre rýchle vyhľadávanie.
- **Redis** – Cachovacia vrstva a backend pre fronty na pozadí, obohacovacie úlohy a rate limiting.

## Version Two s. r. o.

FirmAPI vyvíja a prevádzkuje spoločnosť Version Two s. r. o., softvérová firma so sídlom v Bratislave. Zameriavame sa na tvorbu vývojárskych nástrojov a dátovej infraštruktúry pre slovenský trh.

- IČO: 51636549
- Sídlo: Bratislava, Slovensko
- Založená: 2018
- Zameranie: Vývojárske nástroje a API

## Pripravení na integráciu?

Začnite používať FirmAPI ešte dnes. Bezplatný plán k dispozícii bez potreby platobnej karty.

- Prečítať dokumentáciu: https://api.firmapi.sk/dokumentacia.md
- Vytvoriť bezplatný účet: https://api.firmapi.sk/registracia

---

Prevádzkovateľ: Version Two s.r.o., https://www.versiontwo.sk