Documentație API

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

Mesaje de răspuns

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.

Exemplu de request

https://termene.ro/api/dateFirmaSumar.php?cui=33034700

Parameter

cui	Number	CUI-ul firmei căutate
tip	Number	`0` oferă ultima informaţie disponibilă sau `1` actualizează doar Statuturile realtime, dacă acestea sunt mai vechi de 24 de ore.

Error 4xx

NoAccessRight	Only authenticated Admins can access the data.
CompanyNotFound	The `id` of the Company was not found.

API Endpoint

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	`Neplatitor`, `Platitor`, `Anular`, `null` (nu poate fi luat)
`statut_fiscal`	String	`Activa`, `Inactiva`, `Reactiva`, `null` (nu poate fi luat)
`TVA_incasare`	Boolean	`NU`, `DA`, `null` (nu poate fi luat)
`split_tva`	Boolean
`vechime_firma`	Object	Obiect cu detalii
`data`	String	Data infiintare
`vechime`	String	Vechime firma
`datorii_anaf`	Object[]
`ultima_actualizare`	String

Success Response

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.

Exemplu de request

https://termene.ro/api/dateFirmaSumar.php?nume=Termene

Parameter

number

Number

Numele firmei căutate

API Endpoint

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 Response

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":[ ]
     }
 ]
}