Pārdošanas signāli: uzzini par izmaiņu, pirms konkurents piezvana

Jauns nosaukums, jauna adrese, pamatkapitāla izmaiņas vai juridiskās formas maiņa bieži ir brīdis, kad uzņēmums sāk pirkt. API uzrauga uzņēmumus no tava CRM, paziņo par izmaiņu pēc Uzņēmumu reģistra datiem un parāda tikko reģistrētos uzņēmumus. Vienmēr uzņēmuma līmenī, nevis ar cilvēku datiem mārketingam.

Izmaiņas, kas Latvijā sāk pirkšanas ciklu

Pārdošanas signāls ir reģistra izmaiņa, pēc kuras uzņēmums bieži sāk izvēlēties piegādātājus. Latvijai API sniedz šādus notikumus:

Izmaiņa reģistrā	event_type	Kāpēc tas svarīgi pārdošanai
Jauns uzņēmums reģistrēts	new_incorporation	Jaunam uzņēmumam vajag banku, grāmatvedi, apdrošināšanu, programmatūru un telpas
Nosaukuma maiņa	name_change	Jauns zīmols vai jauni īpašnieki no jauna atver līgumus, rēķinu datus un sistēmas
Juridiskās adreses maiņa	address_change	Jauns birojs: iekārtošana, sakari, drošība un vietējie piegādātāji
Pamatkapitāla maiņa	capital_change	Īpašnieki iegulda naudu, ko drīz iztērēs
Juridiskās formas maiņa	legal_form_change	Pārkārtošana, piemēram, no AS uz SIA: līgumus un dokumentus pārskata
Izslēgšana no reģistra sākta	status_change	Statuss active_strike_off_pending: pārbaudi uzņēmumu pirms nākamā rēķina
Likvidācija, maksātnespēja, tiesiskās aizsardzības process	liquidation, insolvency	Pārtrauc pārdošanu, aizsargā rēķinu un iztīri CRM
Izslēgšana vai apvienošana	dissolution, merger	Uzņēmuma vairs nav vai tas ir apvienots: slēdz iespēju un iztīri CRM
Atgriešanās darbībā	reactivation	Uzņēmums atkal ir aktīvs, piemēram, pēc maksātnespējas procesa: jauna iespēja

Notikumi ir reģistra izmaiņas: nosaukums, statuss, juridiskā forma, juridiskā adrese un pamatkapitāls. Datums ir diena, kad izmaiņa reģistra datos parādījās pirmo reizi, nevis reģistra ieraksta datums, un notikumu nav agrāk par Latvijas datu pirmo ielādi 2026. gada oktobrī. Amatpersonu Latvijai API nesniedz, tāpēc valdes maiņas signāla (director_change) šeit nav.

Laukos previous_value un new_value ir vecā un jaunā vērtība. Pamatkapitāla notikumā tukšs new_value nozīmē, ka uzņēmums ir izslēgts no reģistra vai apvienots un kapitāls vairs nav norādīts: tas nav palielinājums, tāpēc tādus notikumus izlaid. Kapitāls var arī samazināties, tāpēc salīdzini abus skaitļus. Statuss active_strike_off_pending nozīmē, ka reģistrā ir likvidācijas ieraksts par darbības izbeigšanu vai nokavētu atkārtotu reģistrāciju un uzņēmuma izslēgšana no reģistra notiek.

Uzrauga mērķa uzņēmumus un nogādā paziņojumu CRM

Katru mērķa uzņēmumu atrodi vienreiz pēc reģistrācijas numura, pievieno uzraudzībai un savu CRM identifikatoru saglabā laukā label: tas atgriežas katrā paziņojumā. Uzraudzības pārvaldība neprasa kredītus.

import requests

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

merki = [('40003032949', 'crm-1001'), ('40003053029', 'crm-1002')]   # reģistrācijas numurs un CRM identifikators

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

Katrs paziņojums ir parakstīts: galvene X-Prometiam-Signature satur sha256= un ziņojuma satura HMAC-SHA256, kas aprēķināts ar webhook_secret, ko POST /monitor atgriež tikai vienu reizi, tāpēc saglabā to. Pārbaudi parakstu, pirms izveido uzdevumu klientu vadītājam. Paziņojumā ir tavs label, alert_type (piemēram, corporate_event) un detail.event_type (piemēram, address_change).

Webhook ir katrā plānā. Paziņojumus var nolasīt arī ar GET /monitor, tāpēc der arī nakts skripts. Uzraugāmo uzņēmumu skaits: izmēģinājumā 3, Starter 25, Professional 250, Scale 2 500. Pirms pirmā zvana viena mērķa uzņēmuma pēdējās izmaiņas redzamas ar GET /company-events/search?country=LV&company_number=40003032949 (2 kredīti); tukšs saraksts nozīmē, ka izmaiņu vēl nav redzēts.

Visas izmaiņas Latvijā, ne tikai tavi mērķa uzņēmumi

Izlaid uzņēmuma nosaukumu un reģistrācijas numuru, un tas pats pieprasījums ir valsts notikumu plūsma: visas izmaiņas, kas parādījušās reģistra datos, jaunākās pirmās, filtrētas pēc event_type. Plūsma sniedzas ne tālāk kā 31 dienu atpakaļ (pēc noklusējuma 7), tāpēc skripts, kas katru dienu vai katru nedēļu nolasa plūsmu un patur tavam segmentam piemērotos uzņēmumus, atrod tos, kurus tu vēl neuzrauga.

# Pēdējo 7 dienu pamatkapitāla izmaiņas Latvijā (līdz 100 notikumiem vienā pieprasījumā)
curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=LV&event_type=capital_change&limit=100' \
  -H 'Authorization: Bearer rk_live_...'

# Uzņēmumi, kuriem pēdējās 7 dienās sākta izslēgšana no reģistra (date_from ne vecāks par 31 dienu)
curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=LV&event_type=status_change&limit=100' \
  -H 'Authorization: Bearer rk_live_...'

Pieprasījums maksā 2 kredītus par ne vairāk kā 100 notikumiem, nākamo lapu dod next_cursor. Ja date_from ir senāks par 31 dienu, atbilde ir kļūda 400 validation_error, kas nemaksā neko. Latvijas plūsma sniedz veidus new_incorporation, name_change, address_change, capital_change, legal_form_change, status_change, liquidation, insolvency, dissolution, merger un reactivation.

Notikumā ir uzņēmuma nosaukums un reģistrācijas numurs, bet nav pilsētas. Lai atrastu savu segmentu, atver ierakstu ar GET /companies/search?country=LV&company_number=... (1 kredīts) un nolasi city, region un capital_amount. Šis cikls nolasa visas lapas un patur tikai īstos pamatkapitāla palielinājumus:

from datetime import date, timedelta
import requests

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

params = {'country': 'LV', 'event_type': 'capital_change', 'limit': 100,
          'date_from': (date.today() - timedelta(days=7)).isoformat()}
palielinajumi = []
while True:
    r = requests.get(f'{BASE}/company-events/search', headers=H, params=params)
    r.raise_for_status()
    body = r.json()
    for e in body['data']:
        if e['new_value'] is None or e['previous_value'] is None:
            continue                  # uzņēmums izslēgts no reģistra, nav jauna kapitāla
        if float(e['new_value']) > float(e['previous_value']):
            palielinajumi.append((e['company_number'], e['previous_value'], e['new_value']))
    if not body['pagination']['next_cursor']:
        break
    params['cursor'] = body['pagination']['next_cursor']

Jaundibinātie uzņēmumi

Dibināšana ir pirmais signāls: jaunam uzņēmumam vajag banku, grāmatvedi, apdrošināšanu, programmatūru un telpas. founded_after uzskaita kopš datuma dibinātos uzņēmumus bez nosaukuma, jaunākos pirmos, pa 100; nākamo lapu dod next_cursor. Pieprasījums maksā 1 kredītu.

# Kopš 1. oktobra dibinātie uzņēmumi, jaunākie pirmie (100 vienā pieprasījumā)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=LV&founded_after=2026-10-01&limit=100' \
  -H 'Authorization: Bearer rk_live_...'

Ieraksts satur founding_date, legal_form, pamatkapitālu (capital_amount, capital_currency), juridisko adresi un city. Latvijai nav darbības koda, tāpēc jaunos uzņēmumus pēc nozares atlasīt nevar: atlasi pēc pilsētas, pamatkapitāla un nosaukuma. Tikko reģistrētam uzņēmumam vat_number parasti ir null, kamēr tas nav VID PVN maksātāju sarakstā. Otra iespēja ir plūsma ar event_type=new_incorporation: uzņēmums tur parādās dienā, kad tas pirmo reizi parādījās reģistra datos, un event_detail min dibināšanas datumu.

Spēles noteikumi

• Tikai uzņēmumi. Latvijai API nesniedz amatpersonas un dalībniekus, un individuālie komersanti, zemnieku saimniecības un kooperatīvās sabiedrības netiek sniegti. Signāls attiecas uz uzņēmumu, nevis uz cilvēku.
• Signāls nedod tiesības rakstīt. Signāls saka, kad zvanīt, nevis to, ka drīksti rakstīt konkrētam cilvēkam. Tiešā mārketinga e-pastu noteikumi izriet no Latvijas tiesību aktiem un vispārīgās datu aizsardzības regulas; pārbaudi tos pirms kampaņas.
• Tavam pārdošanas procesam. Lietošanas noteikumi neatļauj datus pārdot tālāk kā sarakstu vai konkurējošu datu pakalpojumu.
• Plūsma skatās 31 dienu atpakaļ. Paziņojumi nāk par uzņēmumiem, ko tu uzrauga; valsts plūsma sniedzas ne tālāk par pēdējo mēnesi, tāpēc lasi to vismaz reizi mēnesī.

Ko API nesniedz par Latviju

• valdes un dalībnieku izmaiņas: Latvijai ir tikai uzņēmuma ieraksti
• nozari: reģistrs darbības kodu nepublicē, tāpēc nozares filtra nav
• izmaiņas pirms Latvijas datu pirmās ielādes 2026. gada oktobrī
• Maksātnespējas reģistra paziņojumus par procesa sākumu un noslēgumu: tie ir atsevišķi, skat. Maksātnespējas reģistra pārbaudi; process redzams arī statusā un insolvency notikumā

Cena

Uzraudzība neprasa kredītus: plāns nosaka, cik uzņēmumu uzrauga (3 izmēģinājumā, 25 Starter, 250 Professional un 2 500 Scale; webhook ir katrā plānā). Uzņēmuma meklēšana maksā 1 kredītu, notikumu pieprasījums 2; kļūdas ir bez maksas. Starter maksā 9,99 € mēnesī (1 000 kredītu), Professional 29,99 € (10 000 kredītu) un Scale 99,99 € (50 000 kredītu). 14 dienu izmēģinājumā ir 500 kredītu: nepieciešama bankas karte, izmēģinājuma laikā nekas netiek iekasēts, pēc tam turpinās Starter (9,99 € mēnesī), ja neatsauc. Sīkāk: cenas.

Contains data from the Register of Enterprises of the Republic of Latvia and the State Revenue Service (CC0)

Saistītās lapas

• Uzņēmumu reģistra API Latvijai
• Reģistrācijas numura meklētājs
• Kas ir Uzņēmumu reģistrs?
• Maksātnespējas reģistrs
• Sales trigger events (angļu valodā)
• Latvia company data API (angļu valodā)

Sākt 14 dienu bezmaksas izmēģinājumu · API dokumentācija

Izmēģinājums ilgst 14 dienas un ietver 500 kredītu. Nepieciešama bankas karte, izmēģinājuma laikā nekas netiek iekasēts; pēc tam turpinās Starter plāns (9,99 € mēnesī), ja neatsauc.