Latvijas uzņēmuma PVN numurs nāk no Valsts ieņēmumu dienesta (VID) PVN maksātāju saraksta, un to var pārbaudīt pēc reģistrācijas numura vai pēc paša PVN numura vienā API pieprasījumā.
Latvijas PVN numurs sastāv no burtiem LV un uzņēmuma 11 ciparu reģistrācijas numura, piemēram, LV40003032949. Taču ne katram uzņēmumam ir PVN numurs: to piešķir tikai uzņēmumiem, kas reģistrēti VID PVN maksātāju reģistrā. Tāpēc ar reģistrācijas numura formātu vien nepietiek, lai zinātu, vai uzņēmums ir PVN maksātājs, un rēķinā norādītajam PVN numuram jābūt pārbaudītam.
Prometiam Latvijai ņem PVN numuru no VID PVN maksātāju saraksta. Ja uzņēmums sarakstā ir, vat_number satur numuru un vat_number_source ir register. Ja uzņēmuma sarakstā nav, vat_number ir null: tas nav kļūda, bet atbilde, ka reģistrs to kā PVN maksātāju nezina.
Uzņēmumu var atrast pēc reģistrācijas numura (company_number), nosaukuma (name) vai PVN numura (vat). Atbildes ir laukā data.
# pēc reģistrācijas numura curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=LV&company_number=40003032949' \ -H 'Authorization: Bearer rk_live_...' # pēc PVN numura curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=LV&vat=LV40003032949' \ -H 'Authorization: Bearer rk_live_...' # derīguma pārbaude VIES sistēmā curl 'https://api.prometiam.com/functions/v1/risk-api/vat/LV40003032949' \ -H 'Authorization: Bearer rk_live_...'
Reģistrācijas numura formātu un kontrolciparu (mod-11) API pārbauda pats: kļūdains numurs saņem validācijas kļūdu 400, nevis tukšu atbildi. Pirms integrācijas numuru var pārbaudīt bezmaksas reģistrācijas numura meklētājā.
| Jautājums | Kur atbilde |
|---|---|
| Vai Latvijas uzņēmums ir VID PVN maksātāju sarakstā? | vat_number un vat_number_source: register uzņēmuma objektā (GET /companies/search) |
| Vai PVN numurs ir derīgs ES VIES sistēmā (arī ārvalstu partnerim)? | GET /vat/{number} |
| Kādā statusā ir uzņēmums (aktīvs, likvidācijā)? | status un local_status uzņēmuma objektā |
| Vai uzņēmuma dati ir mainījušies? | POST /monitor un GET /company-events/search |
Pirmā pārbaude atbild uz jautājumu par Latvijas reģistru, otrā par ES PVN datu bāzi. Pārrobežu darījumā noder abas: reģistra ieraksts parāda, ka uzņēmums pastāv un ir aktīvs, bet VIES apstiprina PVN numura derīgumu.
Pārbaudi PVN maksātāja statusu, kad piegādātājs tiek pievienots grāmatvedības sistēmai, pirms pirmā rēķina apmaksas un pēc katras piegādātāja datu maiņas. Ja pārbaude ir automatizēta, rezultātu saglabā kopā ar pārbaudes datumu: tā var pierādīt, ka PVN atskaitījums tika veikts uz pārbaudīta numura pamata. Lēmumu par atskaitījumu un tā nosacījumiem pieņem uzņēmums pats.
null nenozīmē, ka uzņēmums nav derīgs: tas nav iekļauts VID PVN maksātāju sarakstā.Ja piegādātāja PVN statuss ir būtisks, pievieno to uzraudzībai ar POST /monitor un saņem webhook par statusa un reģistra izmaiņām. Meklēšana, uzņēmuma ieraksts un PVN pārbaude maksā 1 kredītu katra; 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). Izmēģinājums: 14 dienas un 500 kredītu; nepieciešama bankas karte, izmēģinājuma laikā nekas netiek iekasēts. Sīkāk: cenas.
Contains data from the Register of Enterprises of the Republic of Latvia and the State Revenue Service (CC0)
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.