Informatii 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.
Costul de utilizare al serviciului depinde de informațiile solicitate și returnate, respectiv plătiți doar pentru informațiile efectiv primite din ceea ce ați solicitat. Plata interogărilor se face în afișări (la fel ca și accesul online) iar pachetele de acces eligibile sunt cele anuale. Nu sunt eligibile pentru acest serviciu pachetele de acces lunare.
Interogările 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 = obiect JSON care specifică datele care se doresc.
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", }
Proprietățile care pot fi enumerate în obiectul JSON (data) sunt:
Parametru | Descriere | Valori | Cost afișări |
---|---|---|---|
TaxCode | CUI-ul firmei căutate | [cui] | 0 |
RegNo | numărul de înmatriculare la Registrul Comerțului | - | 0.05 |
Status | starea de funcțiune a firmei | - | 0.05 |
LegalForm | forma de organizare juridică | - | 0.05 |
Name | numele firmei | - | 0.05 |
NACE | codul CAEN Rev2 al domeniului preponderent de activitate | - | 0.11 |
Date | data înființării firmei | - | 0.05 |
TownCode | codul SIRUTA al localității | - | 0.05 |
County | județul | - | 0.05 |
City | orașul/localitatea | - | 0.05 |
Address | adresa poștală | - | 0.49 |
ContactPerson | persoana de contact (redundant cu administratorii) | - | 0.33 |
Administrators | lista administratorilor | - | 0.65 |
Shareholders | lista asociaților/acționarilor | - | 0.65 |
Turnover | cifra de afaceri pe ultimul an | - | 0.11 |
Profit | profitul net pe ultimul an | - | 0.11 |
Employees | numărul mediu de angajați pe ultimul an | - | 0.11 |
Balance | informațiile de bilanț pe toți anii implicit sau pe anul specificat ca parametru, dacă este specificat | -, [an], latest | 1.75-0.87 |
Phone | numere de telefon la punct fix | - | 0.49 |
Mobile | numere de telefon mobil | - | 0.49 |
Fax | numere de fax | - | 0.49 |
adrese de email | - | 0.76 | |
Web | adrese de pagini web | - | 0.76 |
Geolocation | latitudine si longitudine | - | 0.11 |
Description | descrierea firmei oferită de reprezentantii acesteia | - | 0.22 |
Trademarks | mărci înregistrate | - | 0.65 |
Subsidiaries | număr de sucursale | - | 0.11 |
Branches | număr de sedii secundare | - | 0.11 |
FiscalActivity | stare de activitate ANAF | - | 0.33 |
Obligations | obligatii restante la bugetele de stat | - | 0.33 |
Links | firme conectate direct | - | 0.65 |
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) ș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 (rotunjit în sus) al interogării și numărul de afișări rămase în pachetul anual de acces.
Pentru testare și evaluarea costurilor (fără să adunați) în funcție de datele solicitate puteți interoga gratuit CUI=14837428 (care are majoritatea informațiilor completate).
În cazul î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","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": "J40/8118/2002", "Status": "functiune", "LegalForm": "SRL", "Name": "BORG DESIGN SRL", "NACE": "5829", "Date": "2002/8/26", "TownCode": "179178", "County": "BUCURESTI", "City": "SECTORUL 4", "Address": "STR. DEMOCRATIEI, Nr. 4, Bl. 8, Sc. 1, Et. P, Ap. 1, Cod 042132, ", "Administrators": [ { "Name": "DIAC IUSTIN", "Sex": "M", "Nationality": "642", "Position": "administrator", "Active": "True" } ], "Shareholders": [ { "Name": "DIAC IUSTIN", "Sex": "M", "Nationality": "642", "Position": "asociat", "Shares": "86.96" }, { "Name": "1ST MEDIA CONCEPT SRL", "FiscalCode": "18464976", "Sex": "-", "Nationality": "642", "Position": "asociat", "Shares": "13.04" } ], "Balance": [ { "Year": "2016", "FixedAssets": "391003", "CurrentAssets": "1143910", "Turnover": "3933824", "NetProfit": "1152997", "GrossProfit": "1350155", "Debts": "381546", "EquityOwnership": "1153367", "Stocks": "19139", "Cash": "1067162", "Receivables": "57609", "Income": "3936338", "Outgoings": "2586183", "Employees": "20", "NACE": "5829" } ], "Phone": [ "0213106792", "0213106791" ], "Mobile": [ "0728955732", "0730593252" ], "Fax": [ "0213106793" ], "Email": [ "anca.ionita@borgdesign.ro", "marketing@borgdesign.ro" ], "Web": [ "http://www.listamarci.ro", "http://www.borgdesign.ro" ], "Geolocation": { "Lat": "44.380364", "Lng": "26.132063", "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.
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
- Invalid key or access plan required
- Tax code not found
- Invalid tax code
- Tax code is missing
- Nothing requested
- Data is missing
- API key is invalid