Signály pre predaj z registra: dozviete sa o zmene u klienta skôr než konkurencia

Nové sídlo, nové obchodné meno, premena na inú právnu formu, zmena základného imania alebo čerstvo založená firma často znamenajú začiatok nákupného cyklu. API sleduje firmy z vášho CRM, pošle zmenu z Registra právnických osôb (RPO) a vypíše novozaložené firmy. Vždy na úrovni firmy, nikdy s osobnými údajmi na marketing.

Zmeny v registri, od ktorých sa začína obchodný rozhovor

Pri slovenských firmách API zaznamenáva zmeny obchodného mena, sídla, právnej formy, základného imania a stavu a tiež vznik novej firmy. Udalosť nesie dátum, keď sa zmena prvýkrát objavila v údajoch registra, nie dátum zápisu; najstaršie udalosti sú od 30. septembra 2026.

Zmena v registri	event_type	Prečo je to signál pre predaj
Vznik novej firmy	new_incorporation	Nová firma potrebuje banku, účtovníka, poistenie, softvér a priestory
Zmena sídla	address_change	Nové priestory: sťahovanie, vybavenie, pripojenie, upratovanie, miestni dodávatelia
Zmena obchodného mena	name_change	Nové meno často znamená novú značku alebo nového majiteľa; zmluvy a fakturačné údaje sa aktualizujú
Zmena základného imania	capital_change	Navýšenie imania prináša čerstvé peniaze, ktoré sa čoskoro minú
Zmena právnej formy	legal_form_change	Nová štruktúra, nové zmluvy a často nové úverové limity
Vstup do likvidácie	liquidation	Pozastavte predaj na faktúru, skontrolujte otvorené pohľadávky
Zánik alebo zrušenie firmy	dissolution	Koniec vzťahu: zatvorte účet v CRM
Konkurz	insolvency	Najnaliehavejší signál pre pohľadávky a obchodný úver
Návrat do aktívneho stavu	reactivation	Firma, ktorú ste odpísali, funguje ďalej

• Základné imanie. previous_value a new_value sú hodnoty zapísané v registri, bez meny (tú nájdete v poli capital_currency záznamu firmy). signal_category je pri každej zmene imania growth, aj pri znížení, preto smer určíte porovnaním oboch hodnôt. Prázdna new_value býva pri firmách, ktoré zanikli: register imanie už neuvádza, o navýšenie nejde. Zmenou imania sú aj drobné zaokrúhlenia (napríklad zo 6 638,78 na 6 640 EUR), preto si pre navýšenie stanovte minimálnu hodnotu.
• Právna forma. Hodnoty sú kódy právnej formy, nie text: 112 je s.r.o., 121 a.s. Názov ku kódu nájdete v poli local_legal_form_name záznamu.

Sledujte svoje účty a posielajte upozornenia do CRM

Každú firmu z CRM nájdite raz podľa IČO, uložte jej id, prihláste ju na monitoring a číslo klienta z CRM dajte do poľa label: vráti sa pri každom upozornení. Prihlásenie nespotrebuje žiadne kredity.

import requests

BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}

ucty = [('35763469', 'crm-1001'), ('31322832', 'crm-1002')]   # IČO a číslo klienta v CRM

for ico, id_crm in ucty:
    r = requests.get(f'{BASE}/companies/search', headers=H,
                     params={'country': 'SK', 'company_number': ico})
    r.raise_for_status()
    nasli = r.json()['data']
    if nasli:
        requests.post(f'{BASE}/monitor', headers=H, json={
            'company_id': nasli[0]['id'],
            'country': 'SK',
            'label': id_crm,                      # vráti sa pri každom upozornení
            'events': ['corporate_event', 'status_change', 'dissolution'],
            'webhook_url': 'https://vasa-domena.sk/hooks/prometiam',
        }).raise_for_status()

Každé upozornenie prichádza podpísané. Hlavička X-Prometiam-Signature nesie sha256= a HMAC-SHA256 nezmeneného tela požiadavky s kľúčom webhook_secret, ktorý vracia POST /monitor (zobrazí sa len raz, uložte si ho). Podpis overte skôr, než obchodníkovi založíte úlohu. Webhook je v každom pláne; upozornenia prečítate aj v GET /monitor, takže stačí aj nočný skript.

import hashlib, hmac

def podpis_ok(telo: bytes, hlavicka: str, secret: str) -> bool:
    """telo: nezmenené telo požiadavky; hlavicka: X-Prometiam-Signature; secret: webhook_secret z POST /monitor."""
    ocakavany = 'sha256=' + hmac.new(secret.encode(), telo, hashlib.sha256).hexdigest()
    return hmac.compare_digest(hlavicka, ocakavany)

História pred prvým telefonátom

Skôr než firmu oslovíte, pozrite sa, čo sa v nej zmenilo: GET /company-events/search?country=SK&company_number=35763469 vráti udalosti jednej firmy (tu Slovak Telekom, a.s.) od najnovšej, za 2 kredity. Hľadať môžete aj podľa názvu (company_name). Prázdny zoznam znamená len to, že sme od 30. septembra 2026 nezaznamenali žiadnu zmenu.

Všetky zmeny v krajine, nielen u vašich účtov

Ak vynecháte IČO aj názov, je to isté volanie prúdom udalostí celej krajiny: každá zmena, ktorú sme v registri zaznamenali, od najnovšej, s filtrom event_type. Siaha najviac 31 dní dozadu (predvolene 7), starší date_from skončí chybou 400. Denný alebo týždenný skript, ktorý prúd číta a nechá si firmy z vášho segmentu, nájde účty, ktoré ešte nesledujete. Prúd je rozsiahly, preto vždy filtrujte podľa event_type.

# Zmeny základného imania za posledných 7 dní, 100 udalostí na volanie
# (date_from: najviac 31 dní dozadu, predvolene 7 dní)
curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=SK&event_type=capital_change&limit=100' \
  -H 'Authorization: Bearer rk_live_...'

Volanie stojí 2 kredity za najviac 100 udalostí, ďalšie strany načítate kurzorom next_cursor. Zaujíma vás navýšenie imania? Nechajte len udalosti, kde new_value prevyšuje previous_value aspoň o zvolenú hodnotu:

import requests

BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}

r = requests.get(f'{BASE}/company-events/search', headers=H, params={
    'country': 'SK', 'event_type': 'capital_change', 'limit': 100})
r.raise_for_status()
MIN_NAVYSENIE = 1000   # EUR: drobné zaokrúhlenia nie sú signál
navysenia = [e for e in r.json()['data']
             if e['previous_value'] and e['new_value']
             and float(e['new_value']) - float(e['previous_value']) >= MIN_NAVYSENIE]
for e in navysenia:
    print(e['event_date'], e['company_number'], e['company_name'], e['previous_value'], '->', e['new_value'])

Novozaložené firmy

Vznik je prvý signál: nová firma potrebuje banku, účtovníka, poistenie, softvér aj priestory. founded_after vypíše firmy založené od zadaného dátumu bez názvu, stranu po strane (1 kredit za volanie s najviac 100 firmami), founded_before okno uzavrie. To isté oznámi udalosť new_incorporation v prúde udalostí: jej event_date je deň prvého zaznamenania v registri a dátum vzniku je v event_detail.

# Firmy založené od 1. októbra, od najnovších
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=SK&founded_after=2026-10-01&limit=100' \
  -H 'Authorization: Bearer rk_live_...'

Záznam novej firmy nesie právnu formu, obec, adresu, PSČ, kraj a základné imanie a väčšinou aj kód činnosti SK NACE. Filter podľa činnosti API pre Slovensko nemá (cnae je len pre Španielsko a končí chybou 400), preto segment zužujete vo vlastnom kóde.

Pravidlá hry

• Len firmy. Signál sa týka obchodnej právnickej osoby, nie človeka. API pre Slovensko nevracia štatutárov, spoločníkov ani akcionárov a osobné údaje sa na marketing nepoužívajú: firmu oslovujte jej zverejnenými kanálmi.
• Signál hovorí, kedy zavolať, nie že smiete napísať. Či a ako sa môžete ozvať konkrétnej osobe, určujú pravidlá pre obchodné oznamy a GDPR bez ohľadu na zdroj dát.
• Pre váš obchodný proces. Podmienky služby nedovoľujú dáta ďalej predávať ako zoznam ani ako konkurenčnú dátovú službu.
• Prúd siaha 31 dní dozadu. Upozornenia chodia pri firmách, ktoré sledujete; prúd krajiny ukazuje najviac posledný mesiac, takže ho čítajte aspoň raz mesačne.

Čo na Slovensku nedostanete

• Zmeny v štatutárnom orgáne (director_change): API vracia len záznamy o firmách, bez štatutárov, spoločníkov, akcionárov a skutočných vlastníkov a bez signálu o plnení povinností voči registru.
• Číslo DPH. Vyhľadávanie podľa vat= pre Slovensko API odmietne.
• Oznamy o insolvencii. Konkurz a reštrukturalizácia sú v stave firmy a v udalostiach (insolvency), samostatné oznamy API nevracia.
• Iné než obchodné právnické osoby. Združenia, nadácie a iné nekomerčné subjekty sa nevracajú, živnostníci a iné fyzické osoby nikdy.

Contains data from the Register of Legal Entities (RPO), Ministry of Interior and Statistical Office of the Slovak Republic, CC BY 4.0.

Koľko to stojí

Monitoring nespotrebúva kredity: plán určuje, koľko firiem sledujete (3 v skúšobnom období, 25 v pláne Starter, 250 v pláne Professional a 2 500 v pláne Scale; webhooky sú v každom pláne). Vyhľadanie firiem stojí 1 kredit, vyhľadanie udalostí 2. Starter stojí 9,99 EUR mesačne (1 000 kreditov), Professional 29,99 EUR (10 000 kreditov), Scale 99,99 EUR (50 000 kreditov). Skúšobné obdobie trvá 14 dní a zahŕňa 500 kreditov: vyžaduje platobnú kartu, počas neho sa nič neúčtuje a potom pokračuje Starter, ak ho nezrušíte.

Súvisiace stránky

• Prometiam pre Slovensko
• Vyhľadanie firmy podľa IČO
• Overenie dodávateľa
• KYB overenie cez API
• Čo je RPO?
• Sales trigger events (EN)

Začnite 14-dňové skúšobné obdobie · Dokumentácia API

Skúšobné obdobie trvá 14 dní a zahŕňa 500 kreditov. Vyžaduje sa platobná karta, počas skúšobného obdobia sa nič neúčtuje; potom pokračuje plán Starter (9,99 EUR mesačne), ak ho nezrušíte.