Lietuvos įmonių duomenys
jūsų sistemoje

Rekvizitai, kontaktai, finansai, skolos valstybei, darbuotojai, valdymas, licencijos, viešieji pirkimai, transportas ir finansinė būklė A–E per vieną paprastą REST API.

GET https://api.navis.lt/v1

Pradžia

Kiekviena užklausa siunčiama su API raktu antraštėje. Raktą gaunate užsakę planą, jis rodomas tik vieną kartą. Atsakymai visada JSON, koduotė UTF-8.

Autentifikacija

Antraštė X-API-Key: ndc_... arba Authorization: Bearer ndc_.... Rakto niekada nedėkite į URL: tokios užklausos atmetamos.

Skaičiavimas

Kiekviena grąžinta duomenų grupė yra viena užklausa. Įmonės objektas su 4 grupėmis skaičiuojamas kaip 4. Šaltinio klaidos ir tuščios grupės neskaičiuojamos.

# Įmonės rekvizitai
curl -H "X-API-Key: ndc_JUSU_RAKTAS" https://api.navis.lt/v1/imones/120094086/rekvizitai

Adresai

Įmonės kodas visada 7–9 skaitmenys.

GET/v1/paieska?q=vilma arba /v1/paieska?pvm=LT200940811

Įmonių paieška pagal pavadinimą (2–100 simbolių) arba PVM kodą. Grupė paieska.

GET/v1/imones/{kodas}

Visos jūsų plane esančios grupės vienu objektu. Grupės surenkamos lygiagrečiai. Siaurinti: ?grupes=rekvizitai,kontaktai. Nepavykusi ar tuščia grupė grąžinama kaip null, o priežastis nurodoma lauke klaidos.

GET/v1/imones/{kodas}/{grupe}

Viena grupė, pvz. /v1/imones/120094086/finansai.

GET/v1/naudojimas

Jūsų šio mėnesio naudojimas pagal grupes, dienas ir raktus, plano limitai. Neskaičiuojama.

Pavyzdžiai

# Paieška
curl -H "X-API-Key: ndc_JUSU_RAKTAS" "https://api.navis.lt/v1/paieska?q=vilma"

# Kelios grupės vienu kartu
curl -H "X-API-Key: ndc_JUSU_RAKTAS" "https://api.navis.lt/v1/imones/120094086?grupes=rekvizitai,kontaktai,skolos"

# Mėnesio naudojimas
curl -H "Authorization: Bearer ndc_JUSU_RAKTAS" https://api.navis.lt/v1/naudojimas

{
  "kodas": "120094086",
  "pavadinimas": "Akcinė bendrovė \"VILMA\"",
  "grupes": ["rekvizitai", "kontaktai", "skolos"],
  "duomenys": { "rekvizitai": { ... }, "kontaktai": { ... }, "skolos": { ... } },
  "klaidos": null
}

Atsakymo antraštės

X-Navis-Plan: jūsų plano kodas.
X-RateLimit-Limit, X-RateLimit-Remaining: mėnesio limitas ir likutis (visiems jūsų raktams kartu).
X-RateLimit-Limit-Minute: užklausų per minutę limitas.
Retry-After: po kiek sekundžių kartoti, kai gaunate 429.
X-Request-Id: užklausos numeris, nurodykite jį kreipdamiesi dėl klaidos.

Duomenų grupės

Kurios grupės įeina į kiekvieną planą.

Grupė	Turinys	Bandomasis	Vidinė sistema	Startas	Verslas	Pro
`paieska`Paieška	Įmonių paieška pagal pavadinimą arba PVM kodą.	Įeina	Įeina	Įeina	Įeina	Įeina
`rekvizitai`Rekvizitai	Pavadinimas, kodas, PVM kodas, adresas, teisinė forma, statusas, registracijos data, veiklos sritys (EVRK), įstatinis kapitalas.	Įeina	Įeina	Įeina	Įeina	Įeina
`kontaktai`Kontaktai	Svetainės, el. paštai, telefonai, banko sąskaitos (IBAN, bankas, SWIFT), socialiniai tinklai, logotipas, aprašymas, paslaugos, darbo laikas, biuro adresas.	·	Įeina	Įeina	Įeina	Įeina
`skolos`Skolos valstybei	Sodros skolos pagal mėnesius, VMI nepriemokos ir apskaičiuota santrauka.	·	Įeina	Įeina	Įeina	Įeina
`finansai`Finansai	Metinės pelno (nuostolių) ir balanso ataskaitos, Sodros apdraustieji ir įmokos pagal mėnesius, paskutinių ataskaitų santrauka.	·	Įeina	·	Įeina	Įeina
`darbuotojai`Darbuotojai	Apdraustųjų skaičius ir vidutinis atlyginimas, pokyčiai per 1, 3, 6, 12 mėn., įmonės dydžio klasė ir procentiliai tarp visų bei sektoriaus įmonių.	·	Įeina	·	Įeina	Įeina
`valdymas`Valdymas	Vadovas, valdyba, stebėtojų taryba ir taryba: ar yra, nuo kada, sudėtis pagal lytį.	·	Įeina	·	Įeina	Įeina
`licencijos`Licencijos	Licencijos, leidimai ir pažymėjimai iš LIS, LTSA, atliekų tvarkytojų registro, VMVT ir kitų registrų.	·	Įeina	·	Įeina	Įeina
`pirkimai`Viešieji pirkimai	Įmonė kaip pirkėja ir kaip tiekėja viešuosiuose pirkimuose (VPT).	·	Įeina	·	Įeina	Įeina
`transportas`Transportas	Transporto priemonių parkas (Regitra): kiekis, markės, modeliai, amžius, kuras, nuosavybė ir finansuotojai.	·	Įeina	·	Įeina	Įeina
`susijusios`Susijusios įmonės	Įmonės, turinčios tą pačią banko sąskaitą, svetainę, el. pašto domeną, telefoną ar adresą, su priežastimis.	·	Įeina	·	·	Įeina
`konkurentai`Konkurentai	Atlyginimas palyginti su tos pačios veiklos įmonėmis ir artimiausi konkurentai.	·	Įeina	·	·	Įeina
`bukle`Finansinė būklė A–E	Automatinis įvertinimas A–E ir balas 0–100 iš finansinių ataskaitų, Sodros ir VMI duomenų, su stabdžiais ir priežastimis. Tai nėra kredito reitingas.	·	Įeina	·	·	Įeina

Planai

Kainos be PVM. Mėnesio limitas bendras visiems jūsų raktams ir atsinaujina kiekvieno mėnesio 1 d. (Lietuvos laiku).

Planas	Kaina	Užklausų per mėnesį	Per minutę	Grupės
Bandomasis14 dienų bandymas	Nemokamai	500	10	2 iš 13
Vidinė sistemaNemokamas planas mūsų ir partnerių sistemoms, prijungtoms prie Navis DC	Nemokamai	10 000 000	1 000	Visos grupės
Startas	49 € / mėn.	10 000	60	4 iš 13
Verslas	149 € / mėn.	50 000	120	10 iš 13
ProVisos grupės, įskaitant konkurentus, susijusias įmones ir būklės įvertinimą	399 € / mėn.	250 000	300	Visos grupės

Norite užsakyti ar išbandyti? Rašykite info@navis.lt.

Klaidos

Klaidos grąžinamos JSON formatu {"klaida": "Aprašymas", "kodas": "kodas"} su atitinkamu HTTP kodu.

HTTP	Kodas	Reikšmė
400	`neteisingas_kodas`	Įmonės kodas ne iš 7–9 skaitmenų.
400	`nezinoma_grupe`	Parametre grupes nurodyta nežinoma grupė.
400	`truksta_parametro, netinkamas_parametras`	Paieškai trūksta q arba pvm, arba jie netinkami.
400	`raktas_url_adrese`	Raktas įdėtas į URL. Siųskite jį tik antraštėje ir pakeiskite raktą.
401	`nera_rakto`	Užklausoje nėra rakto.
401	`neteisingas_raktas, raktas_atsauktas`	Raktas neteisingas arba atšauktas.
403	`grupe_neleidziama`	Jūsų planas neapima šios grupės.
403	`klientas_sustabdytas, klientas_uzdarytas`	Paskyra sustabdyta arba uždaryta.
403	`baigesi_galiojimas`	Apmokėtas laikotarpis baigėsi.
404	`imone_nerasta`	Įmonės su tokiu kodu nėra.
404	`duomenu_nera`	Šios grupės duomenų apie įmonę nėra (užklausa neskaičiuojama).
404	`nezinoma_grupe, nerastas`	Nežinoma grupė arba adresas.
429	`limitas_per_minute`	Per daug užklausų per minutę. Žr. antraštę Retry-After.
429	`limitas_per_menesi`	Išnaudotas mėnesio limitas. Retry-After rodo sekundes iki kito mėnesio.
502	`saltinio_klaida, saltinio_laikas`	Duomenų šaltinis laikinai nepasiekiamas (užklausa neskaičiuojama).

Lietuvos įmonių duomenysjūsų sistemoje