Cum funcţionează?
API-ul Termene.ro îţi oferă toate datele necesare activităţii tale într-o singură aplicaţie: a ta. Te ajută la eliminarea erorilor în facturare: afli înainte de a emite o factură din aplicația ta dacă agentul economic este în registrul TVA la încasare, dacă este activ/inactiv fiscal, dacă aplică split TVA etc.
Te ajută la ușurarea procesului de înregistrare pe site-ul tău pentru persoanele juridice. Acestea completează doar CUI-ul companiei, iar restul datelor le preiei prin API.
Accesul la API se face pe bază de abonament. Sunt necesare un nume de utilizator şi o parolă pentru iniţierea unei interogări.
API-ul poate fi integrat şi accesat în aplicaţii proprii prin adăugarea unui cod în interiorul codului sursă.
Documentație offline (PDF)
Această documentație este disponibilă și în format PDF - descarcă fișierul
Abonamentul de acces
API-ul poate fi accesat cu un cont de membru căruia îi poate fi asociat un abonament plătit sau gratuit.
În funcţie de abonamentul ales, API-ul poate fi accesat până la o limită maximă de interogări pe lună.
În funcţie de abonamentul ales, API-ul poate returna diferite tipuri de informatii:
- Date generale
- Bilanţuri (până la maxim 8 ani în trecut)
- Datorii ANAF
- Asociaţi şi Administratori
- TVA-uri (statut TVA, TVA la încasare, TVA fiscal, split TVA)
- Puncte de lucru
Tratarea excepţiilor
Următoarele erori pot apărea în cazul în care sursele de informaţii au fost schimbate, versiunea API-ului este expirată sau abonamentul de acces a expirat sau şi-a atins limita maximă lunară.
Numărul de interogări/zi (interogările rămase şi când se vor reseta se găsesc în browser console/Network/Headers)
Exemple:
- X-RateLimit-Limit:1000
- X-RateLimit-Remaining:897
- X-RateLimit-Reset:1449619200
200 - OK |
Apelul si actiunea asteptata au fost finalizate cu succes. In functie de metoda apelata, utilizatorul va primi un mesaj in legatura cu rezultatul apelului. |
400 - Bad Request |
Datele din request nu au fost completate corect sau sunt incomplete sau actiunea nu este permisa pentru datele furnizate. Pentru mai multe detalii si sugestii, va rugam sa urmariti mesajele de eroare returnate in raspuns. |
401 - Unauthorised access | Authentication data is incorrect. |
429 - Too Many Request | Prea multe interogări. |
DateFirma
DateFirma - Preia informații despre firmă
Interogarea API-ului pe bază de CUI, returnează informaţii despre firma respectivă, în funcţie de abonamentul ales.
https://termene.ro/api/dateFirmaSumar.php?cui=33034700
cui | Number | CUI-ul firmei căutate |
tip | Number |
|
NoAccessRight |
Only authenticated Admins can access the data. |
CompanyNotFound |
The |
GET
-
https://termene.ro/api/dateFirmaSumar.php?nume
cui |
Number | CUI-ul firmei |
cod_inmatriculare
|
Number | Codul de inmatriculare |
cod_caen |
Number | CAEN-ul firmei |
tip_activitate |
String[] | Activitatea prestata |
cifra_de_afaceri_neta
|
Object | Cifra de afaceri neta |
adresa |
String | Adresa firmei |
telefon |
Number | Numarul de telefon |
judet |
String | Judetul |
localitate |
String | Localitatea |
nume |
String | Nume Firma |
capital_social |
String | Capital Social |
adresa_anaf |
String | Adresa firma |
statut_TVA |
String |
|
statut_fiscal |
String |
|
TVA_incasare |
Boolean |
|
split_tva |
Boolean | |
vechime_firma |
Object | Obiect cu detalii |
data |
String | Data infiintare |
vechime
|
String | Vechime firma |
datorii_anaf |
Object[] | |
ultima_actualizare
|
String |
Success 200
HTTP/1.1 200 OK
{ "Date Generale": { "cui":"33034700", "cod_inmatriculare":"J29\/546\/2014", "cod_caen":"6311", "tip_activitate":"Prelucrarea datelor, administrarea paginilor web si activitati conexe", "cifra_de_afaceri_neta":"1111867", "adresa":"Aleea STRUNGA 2 Ploieşti", "telefon":"0726408327", "judet":"PRAHOVA", "localitate":"PLOIESTI", "nume":"TERMENE JUST SRL", "capital_social":"400", "adresa_anaf":"JUD. PRAHOVA, MUN. PLOIESTI, ALEEA STRUNGA, NR.2, BL.39, SC.B, ET.3, AP.47", "statut_TVA":"PLATITOR", "statut_fiscal":"ACTIVA", "TVA_incasare":"DA", "split_tva":"NU", "vechime_firma": { "data":"08.04.2014", "vechime":"4 ANI" }, "datorii_anaf":[ ], "ultima_actualizare":"2018-09-27 04:20:00" }, "Bilanturi": { "cui":"33034700", "an":"2017", "active_imobilizate":"76985", "active_circulante":"339838", "stocuri":"-", "creante":"268154", "casa_si_conturi_la_banci":"71684", "cheltuieli_in_avant":"853", "datorii":"379698", "venituri_in_avans":"-", "provizioane":"-", "capital_total":"37978", "capital_social":"400", "patrimoniu_regie":"-", "patrimoniu_public":null, "cifra_de_afaceri_neta":"1111867", "venituri_total":"1154648", "cheltuieli_totale":"828574", "profit_pierdere_bruta":null, "profit_brut":"326074", "pierdere_brut":"0", "profitul_sau_pierdere_neta":null, "profit_net":"314874", "pierdere_net":"0", "numar_mediu_angajati":"16", "cod_caen":"6311", "tip_activitate":"Prelucrarea datelor, administrarea paginilor web si activitati conexe", "tip_bilant":"" }, "Datorii Anaf": { "cui":"xxxxxxx", "principale_bugetul_stat":"95394", "accesorii_bugetul_stat":"3234692", "contestate_bugetul_stat":"3023942", "necontestate_bugetul_stat":"128644", "total_bugetul_stat":"39762136", "principale_bugetul_asigurarilor_sociale":"1233531", "accesorii_bugetul_asigurarilor_sociale":"2019", "contesate_bugetul_asigurarilor_sociale":"0", "necontesate_bugetul_asigurarilor_sociale":"1225550", "total_bugetul_asigurarilor_sociale":"12221350", "principale_bugetul_asigurarilor_somaj":"123901", "accesorii_bugetul_asigurarilor_somaj":"94", "contestate_bugetul_asigurarilor_somaj":"0", "necontestate_bugetul_asigurarilor_somaj":"49995", "total_bugetul_asigurarilor_somaj":"49995", "principale_bugetul_sanatate":"496470", "accesorii_bugetul_sanatate":"858", "contestate_bugetul_sanatate":"0", "necontestate_bugetul_sanatate":"4971238", "total_bugetul_sanatate":"497328", "observatii":"Faliment", "data_datorie_reala":"2018-06-01" }, "Asociaţi şi Administratori ce pot fi cu sau fără procentaj": { "administratori":[ { "nume_adm":"DRAGOMIR CARMEN ELIZA", "den_calit_pers":"administrator", "data_nastere_adm":"1979-08-15 10:19:13", "adresa":"", "tara":"România", "data_actualizare":"2018-08-28 00:00:00" }], "juridice":[ ], "fizice":[ { "nume_as":"IONIȚĂ GEORGE DORIN", "data_nastere_as":"1988-06-30 08:41:29", "localitate":"", "judet":"", "tara":"România", "data_actualizare":"2018-08-28 00:00:00" } ], }, "Puncte de lucru": { "data_actualizare":"28-08-2018", "puncte_lucru":[ { "adresa":"Str. 13 SEPTEMBRIE,nr. 19,loc. Ploieşti,jud. ", "adresa2":"-", "denumire_actfc":"Contract de închiriere", "denumire_fc":"Punct de lucru", "an":"-", "data_actfc":"2017-12-29 00:00:00", "de_la":"01-01-2018", "pana_la":"31-12-2018", "tip_durata":"Temporar" }, { "adresa":"Str. AUREL VLAICU,nr. 34,et. P,ap. 1,sect. 2,loc. Bucureşti Sectorul 2,jud. ", "adresa2":"Camera 6, Biroul nr.2", "denumire_actfc":"Contract de subînchiriere", "denumire_fc":"Punct de lucru", "an":"-", "data_actfc":"2018-01-31 00:00:00", "de_la":"01-02-2018", "pana_la":"31-01-2019", "tip_durata":"Temporar" }] } }
DateFirma - Returnează firmele găsite
Interogarea API-ului pe bază de nume, returnează firmele găsite.
https://termene.ro/api/dateFirmaSumar.php?nume=Termene
number | Number | Numele firmei căutate |
GET
-
https://termene.ro/api/dateFirmaSumar.php
cod_caen |
Number | CAEN-ul firmei |
judet |
String | Judetul |
nume |
String | Nume Firma |
cui |
Number | CUI-ul firmei |
localitate |
String | Localitatea |
cifra_afaceri |
Object | Cifra de afaceri neta |
pierdere_profit |
Object | Statistica pierdere profit |
numar_de_angajati
|
Object | Numar angajati pe ani |
Success 200
HTTP/1.1 200 OK
{ [ { "cod_caen":6311, "judet":"PRAHOVA", "nume":"TERMENE JUST SRL", "cui":33034700, "localitate":"PLOIESTI", "cifra_afaceri": { "2017":1111867, "2016":311815 }, "pierdere_profit": { "2017":"314874", "2016":"13643" }, "numar_de_angajati": { "2017":"16", "2016":"8" } }, { "cod_caen":0, "judet":"PRAHOVA", "nume":"TERMENE JUST SRL", "cui":34156021, "localitate":"PLOIESTI", "cifra_afaceri":[ ], "pierdere_profit":[ ], "numar_de_angajati":[ ] } ] }