search_companies
Keywords: firme, companii românești, CUI, CAEN, industrie, județ, localitate, cifră de afaceri, profit, datorii, angajați, caută firme după filtre, export firmă, bază de date firme, search company, find business, Romanian companies database.
Caută firme românești sau identifică o firmă specifică după denumire. Folosește același set de filtre ca pagina /cauta-firme: name (denumire firmă, free text, prefix-friendly), județ, localitate, industrie, cod CAEN, tip societate (SRL/SA/PFA…), stare (în funcțiune/suspendată/radiată), telefon, dată înregistrare și 19 indicatori financiari din bilanț (cifră de afaceri, profit, datorii, angajați, capital propriu/social, active, venituri, cheltuieli, etc.) — toți cu interval [gte, lte] și an opțional. Sortare multi-câmp identică cu UI-ul.
Returnează totalCount, un eșantion de firme (cu CUI și URL profil) și webOrderUrl (link către /cauta-firme cu filtrele pre-aplicate).
Pentru a găsi o firmă după denumire, apelează cu name: "Nume Firmă" — primești top-N candidați cu CUI și județ pentru dezambiguare; apoi folosește get_company cu CUI-ul ales pentru profil complet.
IMPORTANT: când utilizatorul cere lista completă sau export CSV, prezintă-i webOrderUrl ca link clickabil — acolo selectează câmpurile dorite, vede prețul și plătește (credite sau card). Tool-ul NU inițiază comenzi.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Localități — array de ID-uri sau nume (ex: ["Cluj-Napoca","Sector 1"]). Echivalent `f[city][]`. Auto-completează `county` dacă nu e dat. | |
| name | No | Numele firmei sau o parte din nume (free text, insensibil la diacritice, prefix-friendly via edge_ngram pe `nameNormalised`). Folosește acest parametru și pentru a identifica o firmă specifică după denumire (ex: "Altia", "Dedeman"). Echivalent `f[q]` din /cauta-firme. | |
| limit | No | Mărimea eșantionului returnat (default 5, max 5 — identic cu preview-ul de pe /cauta-firme). Pentru lista completă/export, folosește `webOrderUrl`. | |
| bsYear | No | Anul bilanțului contabil aplicat ca default tuturor filtrelor financiare care nu au propriul `year`. Default (identic cu /cauta-firme): din IUNIE anul curent − 1, până în mai anul curent − 2. ⚠️ Anul cel mai recent are acoperire PARȚIALĂ - firmele care nu au depus încă bilanțul lipsesc din rezultat, fără avertisment. Dacă vrei acoperire maximă, trimite explicit anul precedent. Echivalent param top-level `bsYear`. | |
| county | No | Județe — array de ID-uri sau nume (ex: ["Cluj","Timiș"] sau [12,35]). Echivalent `f[county][]`. | |
| equity | No | Capital propriu (RON) — `{gte,lte,year?}`. | |
| offset | No | Offset paginare (default 0). | |
| stocks | No | Stocuri (RON) — `{gte,lte,year?}`. | |
| netLoss | No | Pierdere netă (RON) — `{gte,lte,year?}`. | |
| orderBy | No | Sortare multi-câmp. Trimite ca array de OBIECTE (nu stringuri), de ex: `[{"field":"netTurnover","direction":"desc"},{"field":"name","direction":"asc"}]`. Câmpuri: name, county, city, mainNaceCode, netTurnover, netProfit, socialCapital, averageNumberOfEmployees, registrationDate, taxId, random, size. Aliasuri RO: nume, judet, localitate, caen, cifra, profit, capitalSocial, angajati, dataInfintarii, cui. Echivalent `o[1][field]=direction`, `o[2][...]`. | |
| hasPhone | No | Filtru telefon: "yes" (are telefon), "no" (nu are). Echivalent `f[hasPhone]`. | |
| industry | No | Industrii — array de ID-uri (din `list_industries`) sau nume/slug (ex: [5] sau ["IT și software"]). Echivalent `f[industry][]`. Se expandează automat la coduri CAEN descendente. | |
| naceCode | No | Coduri CAEN (clasă, 4 cifre) — array de string-uri (ex: ["6201","6202"]). Echivalent `f[naceCode][]`. Se expandează cu descendenți. | |
| netProfit | No | Profit net (RON) — `{gte,lte,year?}`. Echivalent `f[netProfit][...]`. | |
| provisions | No | Provizioane (RON) — `{gte,lte,year?}`. | |
| companyType | No | Tip societate — array de coduri din `LegalEntityType` (ex: ["SRL","SA","PFA"]). Echivalent `f[companyType][]`. | |
| fixedAssets | No | Active imobilizate (RON) — `{gte,lte,year?}`. | |
| liabilities | No | Datorii (RON) — `{gte,lte,year?}`. | |
| netTurnover | No | Cifră de afaceri (RON) — `{"gte":int,"lte":int,"year":int?}`. Echivalent `f[netTurnover][gte|lte|year]`. | |
| receivables | No | Creanțe (RON) — `{gte,lte,year?}`. | |
| totalAssets | No | Active totale (RON) — `{gte,lte,year?}`. Calculat ca fixedAssets + currentAssets. | |
| totalIncome | No | Venituri totale (RON) — `{gte,lte,year?}`. | |
| growthFilter | No | Creșterea cifrei de afaceri an/an, pe ultima pereche consecutivă de bilanțuri: "growing" (în creștere), "stable" (stagnare, bandă simetrică), "any" (implicit). Pragul implicit e 10%; îl schimbi cu `minGrowthPercent`. | |
| totalCapital | No | Capital total (RON) — `{gte,lte,year?}`. | |
| advanceIncome | No | Venituri în avans (RON) — `{gte,lte,year?}`. | |
| currentAssets | No | Active circulante (RON) — `{gte,lte,year?}`. | |
| socialCapital | No | Capital social (RON) — `{gte,lte,year?}`. | |
| totalExpenses | No | Cheltuieli totale (RON) — `{gte,lte,year?}`. | |
| companyPatrimony | No | Patrimoniu (RON) — `{gte,lte,year?}`. | |
| minGrowthPercent | No | Pragul în procente pentru `growthFilter` (ex: 20 pentru „creștere peste 20%"). Fără el, "growing" înseamnă ≥ +10%. | |
| registrationDate | No | Interval dată înregistrare — `{"gte":"YYYY-MM-DD","lte":"YYYY-MM-DD"}`. Echivalent `f[registrationDate][gte|lte]`. | |
| registrationYear | No | Scurtătură pentru anul înregistrării — `{"gte":2020,"lte":2024}`. Convertit intern la `registrationDate`. Echivalent `f[registrationYear][gte|lte]`. | |
| stateRegistration | No | Stare firmă — array cu valori din: "in_operation" (în funcțiune), "suspended" (suspendată), "deleted" (radiată). Acceptă și aliasuri RO/EN ("active"/"radiata"/etc.). Echivalent `f[stateRegistration][]`. **Default aplicat automat dacă nu specifici: `["in_operation"]`* | |
| cashAtBankAndInHand | No | Disponibilități bănești (RON) — `{gte,lte,year?}`. | |
| averageNumberOfEmployees | No | Număr mediu angajați — `{"gte":int,"lte":int,"year":int?}`. |