Pardavimų signalai: sužinokite apie pokytį, kol konkurentai dar nepaskambino

Naujas pavadinimas, nauja buveinė, pasikeitęs kapitalas ar teisinė forma dažnai yra momentas, kai įmonė pradeda pirkti. API stebi jūsų CRM įmones, praneša apie pokytį pagal Juridinių asmenų registro (JAR) duomenis ir parodo naujai įregistruotas įmones. Visada įmonės lygmeniu, be asmens duomenų rinkodarai.

Pokyčiai, kurie Lietuvoje pradeda pirkimo ciklą

Pardavimų signalas yra registro pokytis, po kurio įmonė dažnai pradeda rinktis tiekėjus. Lietuvai API teikia šiuos įvykius:

Pokytis registre	event_type	Kodėl tai svarbu pardavimams
Nauja įmonė įregistruota	new_incorporation	Naujai įmonei reikia banko sąskaitos, buhalterio, draudimo, programų ir patalpų
Pavadinimo pakeitimas	name_change	Naujas prekių ženklas ar nauji savininkai vėl atveria sutartis, sąskaitų duomenis ir sistemas
Buveinės pakeitimas	address_change	Naujos patalpos: įrengimas, ryšys, apsauga ir vietos tiekėjai
Įstatinio kapitalo pokytis (UAB ir AB)	capital_change	Savininkai investuoja pinigus, kurie netrukus bus išleisti
Teisinės formos pakeitimas	legal_form_change	Pavyzdžiui, MB tampa UAB: įmonė auga, keičiamos sutartys ir dokumentai
Likvidavimas ir bankrotas	liquidation, insolvency	Sustabdykite pardavimą, apsaugokite sąskaitą ir sutvarkykite CRM
Išregistravimas	dissolution	Įmonės nebėra: uždarykite galimybę ir sutvarkykite CRM
Sugrįžimas į veiklą	reactivation	Įmonė vėl veikia, pavyzdžiui, po likvidavimo: nauja galimybė

Įvykiai yra registro pakeitimai: pavadinimas, statusas, teisinė forma, buveinės adresas ir įstatinis kapitalas (tik UAB ir AB). Data yra diena, kai pakeitimas pirmą kartą atsirado registro duomenyse, o ne registro įrašo data. Įvykių nėra iki pirmojo duomenų įkėlimo 2026 m. spalį. Vadovų Lietuvai API neteikia, todėl vadovo pasikeitimo (director_change) signalo čia nėra.

Laukai previous_value ir new_value rodo senąją ir naująją reikšmę. Teisinės formos įvykyje tai JAR formų kodai: 310 yra UAB, 960 yra MB, 320 yra AB; tą patį kodą rodo įmonės įrašo laukas local_legal_form. Kapitalo įvykyje tuščia new_value reiškia, kad kapitalo nebėra, dažniausiai todėl, kad įmonė išregistruota: tai ne didinimas, tokius įvykius praleiskite. Kapitalas gali ir mažėti, todėl palyginkite abu skaičius.

Stebėkite tikslines įmones ir perduokite pranešimą į CRM

Kiekvieną tikslinę įmonę vieną kartą suraskite pagal 9 skaitmenų juridinio asmens kodą, pridėkite ją prie stebimų ir savo CRM numerį palikite lauke label: jis grįžta kiekviename pranešime. Stebėsenos valdymas kreditų nekainuoja.

import requests

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

tikslai = [('301844044', 'crm-1001'), ('110053842', 'crm-1002')]   # juridinio asmens kodas ir CRM numeris

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

Kiekvienas pranešimas pasirašomas: antraštėje X-Prometiam-Signature yra sha256= ir pranešimo turinio HMAC-SHA256, apskaičiuotas su webhook_secret, kurį POST /monitor grąžina tik vieną kartą, todėl jį išsaugokite. Patikrinkite parašą ir tik tada sukurkite užduotį klientų vadybininkui. Pranešime yra jūsų label, alert_type (pvz., corporate_event) ir detail.event_type (pvz., address_change).

Webhook veikia kiekviename plane. Pranešimus galima perskaityti ir per GET /monitor, todėl tinka ir naktinė užduotis. Stebimų įmonių skaičius: bandomuoju laikotarpiu 3, Starter 25, Professional 250, Scale 2 500. Prieš pirmą skambutį vienos įmonės paskutinius pokyčius rodo GET /company-events/search?country=LT&company_number=301844044 (2 kreditai); tuščias sąrašas reiškia, kad pokyčių dar nematyta.

Visi pokyčiai Lietuvoje, ne tik jūsų tikslinės įmonės

Nenurodykite nei pavadinimo, nei kodo, ir ta pati užklausa tampa šalies įvykių srautu: visi pokyčiai, kurie atsirado registro duomenyse, naujausi pirmiausia, filtruojami pagal event_type. Srautas siekia ne toliau kaip 31 dieną atgal (be date_from – 7 dienas), todėl užduotis, kuri kasdien ar kas savaitę perskaito srautą ir palieka jūsų segmentui tinkamas įmones, suranda tas, kurių dar nestebite.

# Paskutinių 7 dienų įstatinio kapitalo pokyčiai Lietuvoje (iki 100 įvykių per užklausą)
curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=LT&event_type=capital_change&limit=100' \
  -H 'Authorization: Bearer rk_live_...'

# Teisinės formos pokyčiai per pastarąsias 7 dienas (date_from ne senesnis kaip 31 diena)
curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=LT&event_type=legal_form_change&limit=100' \
  -H 'Authorization: Bearer rk_live_...'

Užklausa kainuoja 2 kreditus už iki 100 įvykių, kitą puslapį duoda next_cursor. Jei date_from senesnis nei 31 diena, atsakymas yra 400 klaida validation_error, kuri nekainuoja nieko. Lietuvos srautas teikia tipus new_incorporation, name_change, address_change, capital_change, legal_form_change, liquidation, insolvency, dissolution ir reactivation.

Įvykyje yra įmonės pavadinimas ir kodas, bet nėra miesto ar veiklos kodo. Savo segmentui rasti atverkite įrašą per GET /companies/search?country=LT&company_number=... (1 kreditas) ir skaitykite city, region bei activity_code. Šis ciklas perskaito visus puslapius ir palieka tik tikrus kapitalo didinimus bei perėjimus iš MB į UAB:

from datetime import date, timedelta
import requests

BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
FORMOS = {'310': 'UAB', '960': 'MB', '320': 'AB'}     # JAR teisinių formų kodai

def srautas(event_type, dienos=7):
    params = {'country': 'LT', 'event_type': event_type, 'limit': 100,
              'date_from': (date.today() - timedelta(days=dienos)).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']

didinimai = [e for e in srautas('capital_change')
             if e['new_value'] is not None and float(e['new_value']) > float(e['previous_value'])]
mb_i_uab = [e for e in srautas('legal_form_change')
            if FORMOS.get(e['previous_value']) == 'MB' and FORMOS.get(e['new_value']) == 'UAB']

Naujai įregistruotos įmonės

Steigimas yra pirmasis signalas: naujai įmonei reikia banko, buhalterio, draudimo, programų ir patalpų. founded_after pateikia nuo datos įsteigtas įmones be pavadinimo, naujausias pirmiausia, po 100; kitą puslapį duoda next_cursor. Užklausa kainuoja 1 kreditą.

# Nuo spalio 1 d. įsteigtos įmonės, naujausios pirmiausia (100 per užklausą)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=LT&founded_after=2026-10-01&limit=100' \
  -H 'Authorization: Bearer rk_live_...'

Įraše yra founding_date, teisinė forma (legal_form: UAB, MB ir kt.), buveinės adresas, city ir region. Įstatinis kapitalas teikiamas tik UAB ir AB, todėl MB įrašuose jo nėra. Ką tik įregistruotos įmonės activity_code ir vat_number paprastai dar yra null: PVM kodas atsiranda tik įmonei patekus į VMI PVM mokėtojų sąrašą. Kita galimybė yra srautas su event_type=new_incorporation: įmonė jame atsiranda tą dieną, kai pirmą kartą pasirodo registro duomenyse, o event_detail nurodo įsteigimo datą.

Taisyklės, kurių verta laikytis

• Tik įmonių lygmuo. Lietuvai API neteikia vadovų ir dalyvių, o individualios įmonės, TŪB, KŪB, filialai, valstybės įmonės ir ne pelno siekiantys subjektai neteikiami niekada. Signalas yra apie įmonę, ne apie žmogų.
• Signalas sako, kada kreiptis, o ne tai, kad galite rašyti asmeniui. Komercinių el. laiškų taisyklės nustatytos Lietuvos teisės aktuose ir Bendrajame duomenų apsaugos reglamente; patikrinkite jas prieš kampaniją.
• Jūsų pardavimo procesui. Sąlygos draudžia duomenis perparduoti kaip sąrašą ar konkuruojančią duomenų paslaugą.
• Srautas žiūri 31 dieną atgal. Pranešimai ateina apie jūsų stebimas įmones; šalies srautas siekia ne toliau kaip paskutinį mėnesį, todėl skaitykite jį bent kartą per mėnesį.

Ko Lietuvai neteikiame

• vadovų ir dalyvių pokyčių: Lietuvai teikiami tik įmonių įrašai
• veiklos kodo ir PVM kodo pokyčių: įvykiai apima tik pavadinimą, statusą, teisinę formą, buveinę ir (UAB bei AB) įstatinį kapitalą
• pokyčių iki pirmojo duomenų įkėlimo 2026 m. spalį
• nemokumo pranešimų: Lietuva nėra tarp šešiolikos rinkų, kurioms jie teikiami; likvidavimas, bankrotas ir restruktūrizavimas matomi statuse ir pokyčių įvykiuose

Kaina

Stebėsena kreditų nekainuoja: planas nustato, kiek įmonių stebite (3 bandomuoju laikotarpiu, 25 Starter, 250 Professional ir 2 500 Scale; webhook yra kiekviename plane). Įmonės paieška kainuoja 1 kreditą, įvykių paieška 2; klaidų atsakymai nekainuoja nieko. Starter kainuoja 9,99 € per mėnesį (1 000 kreditų), Professional 29,99 € (10 000 kreditų), Scale 99,99 € (50 000 kreditų). Bandomasis laikotarpis trunka 14 dienų ir apima 500 kreditų: reikalinga banko kortelė, bandomuoju laikotarpiu nieko nenurašoma, vėliau taikomas Starter planas (9,99 € per mėnesį), jei neatsisakote. Daugiau: kainos.

Contains data from the Register of Legal Entities (JAR), Registrų centras, the State Data Agency (Statistics Lithuania) and the State Tax Inspectorate (VMI), CC BY 4.0. Adapted by Prometiam.

Susiję puslapiai

• „Prometiam“ Lietuvai: JAR duomenų API
• Įmonės kodo paieška (nemokama)
• Kas yra JAR?
• i.SAF ir PVM kodo patikra
• Sales trigger events (anglų k.)
• Lithuania company data API (anglų k.)

Pradėti 14 dienų nemokamą bandomąjį laikotarpį · API dokumentacija

Bandomasis laikotarpis trunka 14 dienų ir apima 500 kreditų. Reikalinga banko kortelė, bandomuoju laikotarpiu nieko nenurašoma; vėliau taikomas Starter planas (9,99 € per mėnesį), jei neatsisakote.