Prodajni signali: saznajte za promjenu prije nego što konkurencija nazove

Novi naziv, novo sjedište, promjena temeljnog kapitala ili pravnog oblika često je trenutak kad tvrtka počinje kupovati. API prati tvrtke iz vašeg CRM-a, javlja promjenu prema podacima Sudskog registra i nabraja novoosnovane tvrtke. Uvijek na razini tvrtke, nikad s osobnim podacima za marketing.

Promjene koje u Hrvatskoj pokreću kupovni ciklus

Prodajni signal je promjena u registru nakon koje tvrtka često počinje birati dobavljače. Za Hrvatsku API daje ove događaje:

Promjena u registru	event_type	Zašto je važna prodaji
Nova tvrtka upisana	new_incorporation	Nova tvrtka treba banku, računovođu, osiguranje, softver i prostor
Promjena naziva	name_change	Novi brend ili novi vlasnici iznova otvaraju ugovore, podatke za račune i sustave
Promjena sjedišta	address_change	Novi ured: opremanje, veze, zaštita i lokalni dobavljači
Promjena temeljnog kapitala	capital_change	Vlasnici ulažu novac koji će se uskoro potrošiti; pazite na preračunavanja iz kuna
Promjena pravnog oblika	legal_form_change	Tipično j.d.o.o. postaje d.o.o.: tvrtka raste, ugovori i dokumenti se obnavljaju
Likvidacija, stečaj, predstečajni postupak	liquidation, insolvency	Zaustavite prodaju, zaštitite račun i očistite CRM
Brisanje iz registra	dissolution	Tvrtke više nema: zatvorite priliku i očistite CRM
Povratak u poslovanje	reactivation	Tvrtka je opet aktivna, na primjer nakon predstečajnog postupka: nova prilika

Događaji su registarske promjene: naziv, status, pravni oblik, sjedište i temeljni kapital. Datum je dan kad se promjena prvi put pojavila u podacima registra, a ne datum upisa u registar, i događaja nema prije 30. rujna 2026. Članove uprave za Hrvatsku API ne daje, pa signala promjene uprave (director_change) nema.

Polja previous_value i new_value sadrže staru i novu vrijednost. Kod temeljnog kapitala budite oprezni: dio događaja nije novo ulaganje nego preračunavanje iz kuna u eure po fiksnom tečaju 7,5345 (na primjer 20000 → 2650, jer je 20.000 kuna oko 2.654 eura), a kapital se može i smanjiti, pa usporedite dva broja. Prijelaz j.d.o.o. u d.o.o. često stiže dvaput, kao legal_form_change i kao capital_change (na primjer 10 → 2500): to je jedan signal, ne dva. Događaj insolvency pokriva stečaj i predstečajni postupak.

Pratite ciljane tvrtke i prenesite obavijest u CRM

Svaku ciljanu tvrtku pronađite jednom po MBS-u, uključite je u praćenje i svoj CRM identifikator spremite u polje label: vraća se u svakoj obavijesti. Upravljanje praćenjem ne troši kredite.

import requests

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

ciljevi = [('080000604', 'crm-1001'), ('080266256', 'crm-1002')]   # MBS i oznaka u CRM-u

for mbs, crm_id in ciljevi:
    r = requests.get(f'{BASE}/companies/search', headers=H,
                     params={'country': 'HR', 'company_number': mbs})
    r.raise_for_status()
    nadjeno = r.json()['data']
    if nadjeno:
        requests.post(f'{BASE}/monitor', headers=H, json={
            'company_id': nadjeno[0]['id'],
            'country': 'HR',
            'label': crm_id,
            'events': ['corporate_event', 'status_change', 'dissolution'],
            'webhook_url': 'https://example.com/hooks/prometiam',
        }).raise_for_status()

Svaka obavijest je potpisana: zaglavlje X-Prometiam-Signature sadrži sha256= i HMAC-SHA256 tijela poruke izračunat s webhook_secret, koji POST /monitor vraća samo jednom, pa ga spremite. Provjerite potpis prije nego što komercijalistu otvorite zadatak. U obavijesti su vaš label, alert_type (na primjer corporate_event) i detail.event_type (na primjer address_change).

Webhook je u svakom paketu. Obavijesti se mogu čitati i s GET /monitor, pa može i noćni skript. Broj praćenih tvrtki: u probnom razdoblju 3, Starter 25, Professional 250, Scale 2.500. Prije prvog poziva posljednje promjene jedne tvrtke daje GET /company-events/search?country=HR&company_number=080000604 (2 kredita); prazan popis znači da promjena još nije viđena.

Sve promjene u Hrvatskoj, ne samo vaše ciljane tvrtke

Izostavite naziv i MBS i isti poziv postaje državni tok događaja: sve promjene koje su se pojavile u podacima registra, najnovije prve, filtrirane po event_type. Tok seže najviše 31 dan unatrag (bez date_from 7 dana), pa skripta koja svaki dan ili svaki tjedan čita tok i zadržava tvrtke iz vašeg segmenta pronalazi one koje još ne pratite.

# Promjene temeljnog kapitala u Hrvatskoj u zadnjih 7 dana (do 100 događaja po pozivu)
curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=HR&event_type=capital_change&limit=100' \
  -H 'Authorization: Bearer rk_live_...'

# Promjene pravnog oblika u zadnjih 7 dana (date_from ne stariji od 31 dana)
curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=HR&event_type=legal_form_change&limit=100' \
  -H 'Authorization: Bearer rk_live_...'

Poziv košta 2 kredita za do 100 događaja, a sljedeću stranicu daje next_cursor. date_from stariji od 31 dana vraća grešku 400 validation_error, koja ne košta ništa. Hrvatski tok daje tipove new_incorporation, name_change, address_change, capital_change, legal_form_change, liquidation, insolvency, dissolution i reactivation.

Događaj sadrži naziv i MBS tvrtke, ali ne grad ni djelatnost. Za svoj segment otvorite zapis s GET /companies/search?country=HR&company_number=... (1 kredit) i čitajte city, region i activity_code. Ova petlja čita sve stranice i zadržava samo stvarna povećanja kapitala i prijelaze j.d.o.o. u d.o.o.:

from datetime import date, timedelta
import requests

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

def tok(event_type, dana=7):
    params = {'country': 'HR', 'event_type': event_type, 'limit': 100,
              'date_from': (date.today() - timedelta(days=dana)).isoformat()}
    while True:
        r = requests.get(f'{BASE}/company-events/search', headers=H, params=params)
        r.raise_for_status()
        body = r.json()
        yield from body['data']
        if not body['pagination']['next_cursor']:
            return
        params['cursor'] = body['pagination']['next_cursor']

povecanja = [e for e in tok('capital_change')
             if e['new_value'] is not None and e['previous_value'] is not None
             and float(e['new_value']) > float(e['previous_value'])]   # preračunavanja iz kuna su smanjenja
prijelazi = [e for e in tok('legal_form_change')
             if e['previous_value'] == 'j.d.o.o.' and e['new_value'] == 'd.o.o.']

Novoosnovane tvrtke

Osnivanje je prvi signal: nova tvrtka treba banku, računovođu, osiguranje, softver i prostor. founded_after nabraja tvrtke osnovane od datuma bez naziva, najnovije prve, po 100; sljedeću stranicu daje next_cursor. Poziv košta 1 kredit.

# Tvrtke osnovane od 1. listopada, najnovije prve (100 po pozivu)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=HR&founded_after=2026-10-01&limit=100' \
  -H 'Authorization: Bearer rk_live_...'

Popis nisu samo trgovačka društva: uz d.o.o. i j.d.o.o. u njemu su i ustanove (u.) te stečajne mase (s.m.) sa statusom in_liquidation_insolvent, pa filtrirajte po legal_form i status:

# BASE i H isti su kao gore
r = requests.get(f'{BASE}/companies/search', headers=H,
                 params={'country': 'HR', 'founded_after': '2026-10-01', 'limit': 100})
r.raise_for_status()
nove = [c for c in r.json()['data']
        if c['legal_form'] in ('d.o.o.', 'j.d.o.o.', 'd.d.') and c['status'] == 'active']

Zapis sadrži founding_date, legal_form, temeljni kapital (capital_amount, capital_currency), sjedište i djelatnost (activity_code, NKD) gdje je registar navodi. vat_number je za svaku hrvatsku tvrtku izveden pravilom (HR + OIB, izvor rule) i ne potvrđuje PDV registraciju. Druga mogućnost je tok s event_type=new_incorporation: tvrtka se u njemu pojavljuje na dan kad se prvi put pojavila u podacima registra, a event_detail navodi datum osnivanja.

Pravila igre

• Samo tvrtke. Za Hrvatsku API ne daje članove uprave ni zastupnike, a obrti i druge fizičke osobe nikad se ne poslužuju. Signal se odnosi na tvrtku, ne na osobu.
• Signal ne daje pravo na pisanje. Signal kaže kad nazvati, a ne da smijete pisati konkretnoj osobi. Pravila o komercijalnim e-porukama proizlaze iz hrvatskog prava i Opće uredbe o zaštiti podataka; provjerite ih prije kampanje.
• Za vaš prodajni proces. Uvjeti korištenja ne dopuštaju preprodaju podataka kao popisa ni kao konkurentske usluge podataka.
• Tok gleda 31 dan unatrag. Obavijesti stižu za tvrtke koje pratite; državni tok seže najviše mjesec dana unatrag, pa ga čitajte barem jednom mjesečno.

Što za Hrvatsku ne dobivate

• promjene uprave i vlasnika: za Hrvatsku postoje samo zapisi tvrtki
• događaje prije 30. rujna 2026.: povijest počinje tada
• stečajne odluke suda s poslovnim brojem: one su zasebna usluga, vidi praćenje stečaja; stečaj i predstečajni postupak vidljivi su i u statusu i u događaju insolvency
• obrte i druge fizičke osobe: nikad se ne poslužuju

Cijena

Praćenje ne troši kredite: paket određuje koliko tvrtki pratite (3 u probnom razdoblju, 25 Starter, 250 Professional i 2.500 Scale; webhookovi su u svakom paketu). Pretraga tvrtke košta 1 kredit, upit događaja 2; greške su besplatne. Starter košta 9,99 € mjesečno (1.000 kredita), Professional 29,99 € (10.000 kredita), Scale 99,99 € (50.000 kredita). Probno razdoblje traje 14 dana i uključuje 500 kredita: kartica je obavezna, tijekom probnog razdoblja ništa se ne naplaćuje, nakon čega slijedi Starter (9,99 € mjesečno) ako ne otkažete. Detalji: cijene.

Izvor: Sudski registar, Ministarstvo pravosuđa, uprave i digitalne transformacije (Otvorena dozvola). Prometiam standardizira podatke i nije ovjereni izvadak iz registra. Fiksni tečaj preračunavanja 7,5345 kuna za euro: priopćenje ESB-a od 12. srpnja 2022. (engleski).

Povezane stranice

• Prometiam na hrvatskom
• Sudski registar API: službeni i Prometiam
• Pretraga Sudskog registra (besplatno)
• Praćenje stečaja
• Sales trigger events (engleski)
• Hrvatska: API za podatke o tvrtkama (engleski)

Pokreni besplatno probno razdoblje od 14 dana · Dokumentacija API-ja

Probno razdoblje traje 14 dana i uključuje 500 kredita. Kartica je obavezna, tijekom probnog razdoblja ništa se ne naplaćuje; nakon toga slijedi paket Starter (9,99 € mjesečno) ako ne otkažete.