Kaip rasti bet kurią Lietuvos įmonę pagal kodą, pavadinimą ar PVM numerį

Norint rasti Lietuvos įmonę, reikia vieno iš trijų identifikatorių: įmonės kodo, pavadinimo arba PVM kodo. Pateikite bet kurį iš jų ImonesMCP įrankiui search_companies ir gausite atitinkančias įmones su jų teisiniu statusu, veiklos sektoriumi ir naujausiomis pajamomis — be naršymo, be nuskaitymo. Šiame vadove aptariame kiekvieną identifikatorių, o paskui parodome, kaip DI agentas visą paiešką atlieka per vieną žingsnį.

Trys būdai identifikuoti įmonę

Kiekviena Lietuvoje registruota įmonė turi šiuos identifikatorius, ir kiekvienas veikia skirtingai:

• Įmonės kodas — nuolatinis 9 skaitmenų numeris, Registrų centro suteikiamas registruojant juridinį asmenį. Jis niekada nesikeičia ir yra patikimiausias raktas. Pavyzdys: 123456789.
• Pavadinimas — patogus žmogui, bet nėra nei unikalus, nei pastovus. Įmonės keičia pavadinimus, o kelios gali turėti panašius. Teisinės formos santrumpos, tokios kaip UAB, MB, IĮ ar AB, yra registruoto pavadinimo dalis.
• PVM kodas — prasideda LT ir egzistuoja tik jei įmonė registruota PVM mokėtoja VMI. Daugelis mažų įmonių ir individualią veiklą vykdančių asmenų nėra PVM mokėtojai, todėl šio identifikatoriaus tiesiog gali nebūti.

Kai žinote kodą, naudokite jį. Kai turite tik pavadinimą ar PVM numerį, pirmiausia atlikite paiešką ir patvirtinkite kodą, prieš remdamiesi bet kokiais kitais duomenimis.

Rankinė paieška ar per agentą

Rankiniu būdu paieška reiškia registro portalo atidarymą, pavadinimo įvedimą, rezultatų peržiūrą, perėjimą į profilį ir kodo, statuso bei finansų nusikopijavimą. Vienai įmonei tinka. Bet netinka užduočiai „patikrink šiuos keturiasdešimt tiekėjų“ ar „rask visas veikiančias Vilniaus logistikos įmones su daugiau nei vienu milijonu eurų pajamų“.

Su DI agentu, prijungtu prie ImonesMCP, ta pati paieška — vienas sakinys: „Rask [įmonės pavadinimas] įmonės kodą ir PVM statusą.“ Agentas iškviečia search_companies, perskaito rezultatą ir, jei paprašėte daugiau, tęsia su get_company pilnam profiliui. Jokio portalo, jokio kopijavimo, o rezultatas — struktūrizuoti duomenys, su kuriais agentas gali veikti toliau. Jei dar nežinote, kaip veikia toks prijungimas, skaitykite kas yra MCP.

Abiem atvejais šaltinis tas pats — oficialūs Lietuvos atvirieji duomenys iš Registrų centro ir VMI. Skirtumas tik tas, kad agentas atlieka mechaninį darbą: suranda kodą, patikrina statusą ir grąžina rezultatą tokiu pavidalu, kurį galima iškart panaudoti kitame žingsnyje, o ne perrašinėti ranka.

Paieška su search_companies

search_companies — atradimo įrankis. Jo laukas query atlieka apytikslę paiešką pagal pavadinimą, kodą ir PVM numerį, o rezultatų aibę galite susiaurinti filtrais: municipality, vatActive, activityDivision, minRevenue/maxRevenue, registeredAfter/registeredBefore, taip pat sort, limit ir offset.

Įprasta paieška sujungia pavadinimo fragmentą su keliais filtrais:

{
  "query": "logistika",
  "municipality": "Vilnius",
  "vatActive": true,
  "limit": 10
}

Tai grąžina iki dešimties Vilniuje registruotų įmonių, kurių pavadinimas, kodas ar PVM atitinka „logistika“ ir kurios šiuo metu turi aktyvią PVM registraciją. Kiekvienas rezultatas turi įmonės kodą, pavadinimą, teisinę formą, statusą ir naujausias pajamas — pakanka pasirinkti tinkamą įmonę prieš traukiant pilną įrašą.

Jei žinote tikslų įmonės kodą, galite jį perduoti tiesiai į query (apytikslė paieška tiksliai atpažįsta kodą) arba visai praleisti paiešką ir eiti į get_company.

Rezultatų siaurinimas ir puslapiavimas

Kai paieška grąžina daugiau kandidatų, nei norite, siaurinkite ją, o ne slinkite. Pridėkite activityDivision sektoriui apriboti, minRevenue/maxRevenue dydžiui apibrėžti arba registeredAfter/registeredBefore laikotarpiui sutelkti. Norėdami peržiūrėti didelę rezultatų aibę, palikite tuos pačius filtrus ir didinkite offset, o limit laikykite pastovų — pavyzdžiui, limit: 20, offset: 0, tada offset: 20 kitam puslapiui. Nustatykite sort (pavyzdžiui, pagal pajamas mažėjančia tvarka), kad puslapiavimas būtų nuoseklus, o aktualiausi atitikmenys — pirmi. Būtent taip agentas apdoroja užklausą „išvardyk visas veikiančias gamybos įmones Kaune“ — nepraleisdamas ir nekartodamas įrašų.

Pilnas profilis su get_company

Kai turite kodą, get_company grąžina pilną profilį. Jis priima arba įmonės kodą (code, ja_kodas), arba PVM kodą (vatCode):

{
  "code": "123456789"
}

Atsakyme yra teisinė forma, dabartinis statusas (veikianti, likviduojama, išregistruota), PVM registracija ir kodas, pagrindinė ekonominė veikla, savivaldybė ir naujausios pajamos. Metinėms sumoms naudokite get_company_financials; nuosavybės struktūrai — get_company_people (tik suvestiniai skaičiai, be įvardytų asmenų). Išsamų kiekvieno lauko ir statuso paaiškinimą rasite Lietuvos įmonių duomenų vadove.

Dažnos klaidos

Keletas dalykų, kurie klaidina, kai identifikatoriai laikomi tarpusavyje sukeičiamais:

• PVM kodas nėra įmonės kodas. Tai skirtingi numeriai su skirtingomis taisyklėmis. Niekada nemanykite, kad įmonės PVM numeris — tai įmonės kodas su priklijuotu LT. Skaitmenys nesusiję.
• Ne kiekviena įmonė turi PVM kodą. Jei vatActive yra false arba PVM kodo nėra, įmonė tiesiog nėra PVM mokėtoja. Tai normalu, o ne klaida ir ne požymis, kad įmonės nėra.
• PVM registracija gali baigtis. Įmonė gali būti veikiantis juridinis asmuo, kol jos PVM registracija neaktyvi. Filtruokite pagal vatActive, kai PVM statusas jums iš tikrųjų svarbus, ir skaitykite profilį, o ne spėkite.
• Pavadinimai nėra unikalūs. Panašūs pavadinimai — dažni. Visada patvirtinkite įmonės kodą prieš remdamiesi finansais ar statusu.

Norite patys atlikti tokias paieškas? Prijunkite agentą pagal dokumentaciją arba skaitykite toliau, kaip duomenys atitinka kiekvieną lauką.