Termene

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