Documentație

Name: Firme360 API
Brand: Firme360
Availability: InStock

Tot ce ai nevoie pentru a integra Firme360

Postman Collection Postman Environment

Primii pași

Integrarea cu Firme360 este simplă și rapidă. Urmează acești pași pentru a începe:

Creează un cont

Înregistrează-te gratuit pe app.firme360.ro și primești automat 100 de credite.

Generează API Key

Din dashboard, navighează la secțiunea API Keys și generează o cheie nouă. Păstrează cheia în siguranță.

Fă primul request

Folosește exemplele de cod de mai jos pentru a face primul tău request către API.

Autentificare

Toate request-urile către API trebuie să includă header-ul Authorization cu API Key-ul tău:

Authorization: Bearer YOUR_API_KEY

Important: Nu expune niciodată API Key-ul în cod client-side sau în repository-uri publice.

Endpoint-uri

GET/api/v1/businesses/{'{tax_id}'}

Verifică o singură firmă după CUI/CIF

Parametri

Parametru	Tip	Descriere
`tax_id`	string	CUI/CIF-ul firmei (6-10 cifre)

Răspuns

{
  "success": true,
  "credits": {
    "consumed": 1,
    "remaining": 999
  },
  "data": {
    "tax_id": "12345678",
    "name": "EXEMPLU TECH SRL",
    "registration_number": "J40/1234/2020",
    "status": "INREGISTRAT din data 01.01.2020",
    "address": "JUD. BUCURESTI, SECTOR 1, STR. EXEMPLU, NR.10",
    "phone": "0700000000",
    "postal_code": "010101",
    "registration_date": "2020-01-01",
    "fiscal_authority": "Administrația Sector 1 a Finanțelor Publice",
    "caen_code": "6201",
    "vat": {
      "is_payer": true,
      "start_date": "2020-02-01",
      "end_date": null
    },
    "inactive": {
      "is_inactive": false,
      "inactive_date": null
    },
    "split_vat": {
      "is_active": false,
      "start_date": null
    },
    "ro_efactura": true,
    "headquarters": {
      "street": "Str. Exemplu",
      "street_number": "10",
      "city": "București",
      "county": "BUCURESTI",
      "postal_code": "010101"
    }
  }
}

POST/api/v1/businesses

Verifică mai multe firme simultan (max 100)

Body (JSON)

{
  "tax_ids": ["12345678", "87654321", "11223344"]
}

Răspuns

{
  "success": true,
  "credits": {
    "consumed": 2,
    "remaining": 998
  },
  "data": [
    {
      "tax_id": "12345678",
      "name": "FIRMA 1 SRL",
      "registration_number": "J40/1000/2020",
      "status": "INREGISTRAT din data 01.01.2020",
      "vat": { "is_payer": true, "start_date": "2020-02-01" },
      "ro_efactura": true,
      "inactive": { "is_inactive": false }
    },
    {
      "tax_id": "87654321",
      "name": "FIRMA 2 SRL",
      "registration_number": "J40/1001/2020",
      "vat": { "is_payer": false },
      "ro_efactura": false,
      "inactive": { "is_inactive": false }
    }
  ],
  "not_found": ["11223344"]
}

GET/api/v1/businesses/{'{tax_id}'}/financialsNOU

Obține datele financiare (bilanțuri) ale unei firme pentru toți anii disponibili

Nou! Endpoint-ul /financials returnează toate datele financiare disponibile de la înființarea firmei până în prezent. Costul este de 1 credit per request, indiferent de câți ani sunt returnați.

Parametri

Parametru	Tip	Descriere
`tax_id`	string	CUI/CIF-ul firmei (6-10 cifre)

Răspuns

{
  "success": true,
  "credits": {
    "consumed": 1,
    "remaining": 998
  },
  "data": {
    "tax_id": "12345678",
    "company_name": "EXEMPLU TECH SRL",
    "years": [
      {
        "year": 2023,
        "caen_code": "6201",
        "caen_name": "Activități de realizare a soft-ului la comandă",
        "assets": {
          "fixed_assets": 500000,
          "current_assets": 200000,
          "inventory": 50000,
          "receivables": 100000,
          "cash_and_accounts": 50000,
          "prepaid_expenses": 10000
        },
        "liabilities": {
          "short_term_debt": 150000,
          "long_term_debt": 100000,
          "provisions": 20000,
          "deferred_revenue": 30000
        },
        "equity": {
          "subscribed_capital": 200000,
          "total_equity": 400000
        },
        "income_statement": {
          "revenue": 2000000,
          "total_income": 2100000,
          "total_expenses": 1800000,
          "gross_profit": 300000,
          "gross_loss": null,
          "net_profit": 250000,
          "net_loss": null
        },
        "employee_count": 25,
        "extra_indicators": null
      }
    ]
  }
}

Indicatori Financiari (I1-I20)

Cod	Câmp API	Descriere
I1	`assets.fixed_assets`	Active imobilizate
I2	`assets.current_assets`	Active circulante
I3	`assets.inventory`	Stocuri
I4	`assets.receivables`	Creanțe
I5	`assets.cash_and_accounts`	Casa și conturi la bănci
I6	`assets.prepaid_expenses`	Cheltuieli în avans
I7	`liabilities.short_term_debt`	Datorii pe termen scurt (<1 an)
I8	`liabilities.long_term_debt`	Datorii pe termen lung (>1 an)
I9	`liabilities.provisions`	Provizioane
I10	`liabilities.deferred_revenue`	Venituri în avans
I11	`equity.subscribed_capital`	Capital subscris vărsat
I12	`equity.total_equity`	Capitaluri proprii
I13	`income_statement.revenue`	Cifra de afaceri netă
I14	`income_statement.total_income`	Venituri totale
I15	`income_statement.total_expenses`	Cheltuieli totale
I16	`income_statement.gross_profit`	Profit brut
I17	`income_statement.gross_loss`	Pierdere brută
I18	`income_statement.net_profit`	Profit net
I19	`income_statement.net_loss`	Pierdere netă
I20	`employee_count`	Număr mediu de salariați

Exemple de cod - Financials

const response = await fetch('https://api.firme360.ro/api/v1/businesses/12345678/financials', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data.data.years); // Array cu datele financiare pe ani

Exemple de cod

const response = await fetch('https://api.firme360.ro/api/v1/businesses/12345678', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Coduri de eroare

Cod	Descriere
200	Success - Request procesat cu succes
400	Bad Request - CUI invalid sau parametri lipsă
401	Unauthorized - API Key invalid sau lipsă
402	Payment Required - Credite insuficiente
404	Not Found - Firma nu a fost găsită
429	Too Many Requests - Rate limit depășit
500	Server Error - Eroare internă

Rate Limits

Limitele de request-uri variază în funcție de planul tău:

Plan	Credite/lună	Req/min	Req/zi	Batch max
Free	100	10	100	10
Basic	5,000	60	1,000	50
Plus	25,000	120	5,000	75
Pro	100,000	300	10,000	100

Headers de răspuns

Fiecare răspuns include headers cu informații despre rate limit:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 55
X-RateLimit-Reset: 1703001600