# Monitoring firiem a webhooky

FirmAPI priebežne sleduje 38 verejných registrov. Keď sa u sledovanej firmy niečo zmení – nový dlh, insolvencia, zmena konateľa – webhook to okamžite doručí do vášho systému.

## Aké zmeny zachytíme

- **Rizikové signály** – Firma pribudla na zoznam dlžníkov, vstúpila do konkurzu, pribudlo exekučné poverenie alebo prišla o spoľahlivosť pre DPH.
- **Zmeny v Obchodnom registri** – Zmena konateľov, spoločníkov, sídla, obchodného mena, základného imania či predmetov podnikania.
- **Stavové zmeny** – Vstup do likvidácie, výmaz z registra, zmena právnej formy.
- **Finančné dáta** – Nová účtovná závierka v Registri účtovných závierok.

## Ako monitoring funguje

1. **Prihláste firmy na odber** – Cez API alebo dashboard si vyberiete IČO firiem, ktoré chcete sledovať – zákazníkov, dodávateľov, konkurenciu.
2. **Nastavte webhook** – Zadáte URL vášho endpointu. Každú doručenú udalosť podpisujeme, aby ste si vedeli overiť jej pravosť.
3. **Reagujte automaticky** – Zmena príde ako JSON payload s typom udalosti, IČO a rozdielom hodnôt. Zvyšok je na vašom systéme – od Slack notifikácie po zablokovanie kreditu.

```bash
curl -X POST -H "X-API-Key: fa_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "ico": "51636549",
    "url": "https://vas-system.sk/webhooks/firmapi",
    "events": ["debtor.added", "insolvency.opened", "officers.changed"]
  }' \
  "https://firmapi.sk/v1/notifications"
```

## Typické nasadenia

- Kreditný manažment – automatické zastavenie dodávok, keď zákazník pribudne na zoznam dlžníkov.
- Compliance – priebežná kontrola sankčných zoznamov u existujúcich klientov.
- CRM hygiena – adresy, názvy a konatelia vo vašom CRM sa aktualizujú samy.
- Obchodné príležitosti – nová firma v odvetví alebo zmena vedenia u potenciálneho zákazníka.

## Časté otázky

### Koľko firiem môžem sledovať?

Podľa plánu – od jednotiek firiem v bezplatnom pláne po tisíce v pláne Enterprise. Počet sledovaných firiem a webhookov nájdete v cenníku.

### Ako rýchlo sa o zmene dozviem?

Webhook odchádza okamžite po tom, čo zmenu zachytí synchronizácia príslušného registra. Väčšina registrov sa synchronizuje denne.

### Čo ak môj endpoint nebude dostupný?

Doručenie opakujeme s exponenciálnym odstupom a históriu doručení vidíte v dashboarde aj cez API.

### Môžem dostávať zmeny aj e-mailom?

Áno, popri webhookoch podporujeme aj e-mailové notifikácie – vhodné, keď zmeny sleduje človek a nie systém.

---

Registrácia zadarmo: https://firmapi.sk/registracia · Dokumentácia webhookov: https://firmapi.sk/dokumentacia.md