Română
EnglezăInformații despre firme prin API
Informațiile despre firme pot fi accesate direct din aplicațiile dumneavoastră de tip ERP, CRM sau altele, prin intermediul acestui serviciu.
Serviciul este de tip REST API cu raspuns în format JSON și poate fi accesat doar de utilizatorii pentru care serviciul a fost activat. Pentru activarea serviciului API si generarea cheii click pe butonul reset din formularul pentru actualizare cont. Interogarea prin API se face în baza unor reguli diferite față de accesarea web, reguli specificate în continuare. Informațiile din rapoartele detaliate nu sunt accesibile prin API.
Plata interogărilor API se face în afișări putând fi accesate aceleași informații indiferent de tipul pachetului de acces. Consumul de afișări depinde de informațiile solicitate și returnate, respectiv se consumă afișări doar pentru informațiile efectiv primite din ceea ce ați solicitat. Costul în afișări este același indiferent de tipul și opțiunile pachetului de acces motiv pentru care sunt recomandate pachetele de acces cu pret pe afisare minim. Pachetele de acces cu care poate fi accesat API sunt cele anuale. Implicit este utilizat cel mai vechi pachet eligibil in cazul in care exista mai multe pachete de acces valabile. Nu poate fi accesat API cu pachetele de acces de tip Nelimitat cu valabilitate lunară.
Căutări după nume, CUI sau J
Pentru a interoga informații despre o firmă trebuie să-i cunoașteți CUI-ul. Dacă nu-i cunoașteți CUI-ul, puteți căuta după denumire sau părți din denumire și aflați CUI-ul pentru a fi utilizat in continuare.
Căutările se transmit utilizând protocolul HTTP (preferabil POST) la adresa:
https://www.listafirme.ro/api/search-v1.asp
Parametrii unei interogări sunt:
- key = cheia api secretă pe care o găsiti în datele contului dumneavoastră dacă serviciul este activat;
- src = textul căutat.
Exemplu de interogare:
key=yourkey&src=Borg Design
key=yourkey&src=J2002008118400
Raspunsul poate include rezultate multiple si este de forma:
{"Results":[{"Name":"BORG DESIGN SRL","FiscalCode":"14837428","County":"BUCURESTI","URL":"https://www.listafirme.ro/borg-design-srl-14837428/"}]}
Căutările sunt gratuite, au ca scop facilitarea interogărilor pentru informații detaliate și pot fi restricționate în caz de abuz (utilizarea în alt scop). Limita este de maxim 50 de căutări până la o interogare de informații punctuale.
Interogări pentru informații punctuale
Cunoscând CUI-ul firmei, interogările pentru informații se transmit utilizând protocolul HTTP (preferabil POST) la adresa
https://www.listafirme.ro/api/info-v1.asp
Parametrii unei interogări sunt:
- key = cheia api secretă pe care o găsiti în datele contului dumneavoastră dacă serviciul este activat;
- data = JSON object that specifies the desired data.
Exemplu de interogare:
key=yourkey&data={"TaxCode":"14837428","Name":"","Status":""}ar returna un răspuns JSON ca mai jos
{
"TaxCode": "14837428",
"Status": "functiune",
"Name": "BORG DESIGN SRL",
"cost": "1",
"views": "4026",
}
Informațiile punctuale disponibile dintre care trebuie să le enumerați ca proprietăți în obiectul JSON (data) doar pe cele pe care le doriți, sunt:
| Parametru | Descriere | Valori | Afișări |
|---|---|---|---|
| TaxCode | CUI-ul firmei căutate | [cui] | 0 |
| VAT | plătitor/neplătitor de TVA | - | 0.03 |
| RegNo | numărul de înmatriculare la Registrul Comerțului | - | 0.03 |
| Status | starea de funcțiune a firmei | - | 0.03 |
| LegalForm | forma de organizare juridică | - | 0.00 |
| Name | numele firmei | - | 0.03 |
| NACE | codul CAEN Rev2 al domeniului preponderent de activitate | -,info | 0.06 |
| Date | data înființării firmei | - | 0.03 |
| TownCode | codul SIRUTA al localității | - | 0.03 |
| County | județul | - | 0.03 |
| City | orașul/localitatea | - | 0.03 |
| Address | adresa poștală | - | 0.26 |
| Validity | durata de valabilitate a sediului social | - | 0.26 |
| ContactPerson | persoana de contact (redundant cu administratorii) | - | 0.17 |
| Administrators | lista administratorilor | - | 0.34 |
| Shareholders | lista asociaților/acționarilor | - | 0.34 |
| Beneficiary | lista beneficiarilor reali | - | 0.34 |
| Turnover | cifra de afaceri pe ultimul an | - | 0.06 |
| Profit | profitul net pe ultimul an | - | 0.06 |
| Employees | numărul mediu de angajați pe ultimul an | - | 0.06 |
| Balance | informațiile de bilanț pe toți anii implicit sau pe anul specificat ca parametru, dacă este specificat | -, [an], latest | 0.92-0.46 |
| Phone | numere de telefon la punct fix | - | 0.26 |
| Mobile | numere de telefon mobil | - | 0.26 |
| Fax | numere de fax | - | 0.26 |
| adrese de email | - | 0.40 | |
| Web | adrese de pagini web | - | 0.40 |
| Geolocation | latitudine si longitudine | - | 0.06 |
| Description | descrierea firmei oferită de reprezentantii acesteia | - | 0.11 |
| Trademarks | mărci înregistrate | - | 0.34 |
| Subsidiaries | număr de sucursale | - | 0.06 |
| Branches | număr de sedii secundare | - | 0.06 |
| FiscalActivity | stare de activitate ANAF | - | 0.17 |
| Obligations | obligatii restante la bugetele de stat | - | 0.17 |
| Links | firme conectate direct | - | 0.34 |
Costul total în afișări al fiecărei interogări este suma costurilor informațiilor solicitate și returnate rotunjită în sus la valori întregi.
API-ul returnează valori pentru orice proprietate enumerată în JSON dacă informația este cunoscută. Valorile proprietăților din cererea JSON sunt ignorate exceptând TaxCode (care este obligatoriu), NACE care poate avea valoarea "info" pentru a include descrierea și Balance la care poate fi specificat anul dorit (ex: 2014) sau cuvantul "latest" pentru cel mai recent bilanț (altfel sunt returnați toți anii)
Serviciul nu returnează valori pentru parametrii care nu au fost specificați în interogare sau pentru care nu există date. Lipsa în raspuns a unui parametru care a fost interogat înseamnă că nu au existat informații de returnat.
În răspuns este precizat costul în afișări al interogării și numărul de afișări rămase în pachetul anual de acces.
Pentru testare și evaluarea costurilor în funcție de datele solicitate puteți interoga gratuit CUI=14837428 (care are majoritatea informațiilor completate).
În cazurile în care anumite date nu pot fi returnate pentru anumite interogări, costul scade față de estimarea de mai sus.
Exemplu de interogare completă:
key=yourkey&data={"TaxCode":"14837428","VAT":"","RegNo":"","Status":"","LegalForm":"","Name":"","NACE":"","Date":"","TownCode":"","County":"","City":"","Address":"","Administrators":"","Shareholders":"","Balance":"latest","Phone":"","Mobile":"","Fax":"","Email":"","Web":"","Geolocation":"","Description":"","Trademarks":"","Subsidiaries":"","Branches":"","FiscalActivity":"","Obligations":"","Links":""}ar returna un răspuns JSON ca mai jos
{
"TaxCode": "14837428",
"RegNo": "J2002008118400",
"Status": "functiune",
"LegalForm": "SRL",
"Name": "BORG DESIGN SRL",
"NACE": "6201",
"Date": "2002/8/26",
"TownCode": "179187",
"County": "BUCURESTI",
"City": "SECTORUL 5",
"Address": "STR. ING. STEFAN HEPITES, Nr. 16A, Et. P, ",
"VAT": "True",
"Administrators": [
{
"Name": "DIAC IUSTIN",
"Sex": "M",
"Nationality": "642",
"Position": "administrator",
"Active": "-1"
}
],
"Shareholders": [
{
"Name": "DIAC IUSTIN",
"Sex": "M",
"Nationality": "642",
"Position": "asociat",
"Shares": "100"
}
],
"Balance": [
{
"Year": "2022",
"FixedAssets": "247479",
"CurrentAssets": "1689945",
"Turnover": "3708712",
"NetProfit": "351060",
"GrossProfit": "380337",
"Debts": "1522077",
"EquityOwnership": "351447",
"Stocks": "160769",
"Cash": "1396890",
"Receivables": "132286",
"Income": "3943592",
"Outgoings": "3563255",
"Employees": "23",
"NACE": "6201"
}
],
"Phone": [
"0213106791",
"0213106793"
],
"Mobile": [
"0730593252",
"0731013139"
],
"Email": [
"office@borgdesign.ro"
],
"Web": [
"https://www.borgdesign.ro",
"http://www.listamarci.ro"
],
"Geolocation": {
"Lat": "44.408874",
"Lng": "26.092908",
"Approximated": "False"
},
"Description": "Borg Design este o companie cu capital privat ale cărei principale activităţi sunt dezvoltarea şi distribuţia de software precum şi consultanţă in tehnologia informaţiei. În particular, preocupările Borg Design sunt orientate şi către Inteligenţa Artificială.
Software-ul dezvoltat de Borg Design are la bază solicitările, indicaţiile şi sugestiile clienţilor, şi are ca utilitate posibilitatea rapidă şi automatizată de a accesa şi prelucra informaţii publice de interes general. Obiectivul Borg Design este de a colecţiona aceste informaţii şi a vi le pune la dispoziţie intr-o formă prelucrată, alături de unele unelte software care au ca scop economisirea timpului dumneavoastră de informare şi in special a costurilor.
Borg Design şi-a inceput activitatea in septembrie 2003, a realizat pană in prezent mai multe colecţii de date cu informaţii de interes public şi unele unelte software populare:
- CD-ul Lista Firme;
- Asistent Financiar;
- Expert Email Validator;
- TVA Validator;
- Programul Telefoane.
Nomenclatoare:
- cetațeniile și naționalitățile sunt în format ISO 3166-1;
- codurile localităților sunt conform nomenclatorului SIRUTA;
- domeniile de activitate sunt conform codului CAEN Rev2.
Atenție: Utilizați API key doar în aplicații proprii sau pe server. Utilizarea în browser (client side) expune cheia secretă altor utilizatori. În producție utilizati metoda POST întrucat metoda GET deși este acceptată pentru teste poate expune API-key în loguri și statistici de trafic.
Puteți vizualiza/urmări în log de la ce IP-uri și câte interogări au fost efectuate și la nevoie solicitați resetarea cheii secrete. Vă recomandăm totodată să limitați IP-urile de la care poate fi accesat serviciul.
Orice răspuns are status HTTP 200 și include parametrul error (dacă este cazul) având una dintre posibilele valori:
- JSON data is invalid
- Access denied from IP
- A valid access plan is required
- Tax code not found
- Invalid tax code
- Tax code is missing
- Nothing requested
- Data is missing
- API key is invalid
API-ul este disponibil și pe platformele Zappier.com și Make.com .
Pentru ajutor la integrarea API în propriile aplicații puteți apela la integratori ca Makeitfuture SRL.
Exemple de implementare Angular, .NET, Python, Java, React.
Ania