Clasamentul firmelor dintr-un domeniu: topul după cifra de afaceri, prin API

Cererea cu clasamentul vine de la tot felul de oameni: agenți de vânzări, analiști de piață, jurnaliști, antreprenori care vor să știe unde stau față de alții. Răspunsul e în bilanțurile publice. Ca să-l scoți singur, însă, ar trebui să aduni situațiile financiare ale tuturor firmelor dintr-un cod CAEN, să le filtrezi pe an și să le sortezi. Cu API-ul de statistici e o singură cerere.

După ce poți ordona

Ruta GET /api/v1/statistici/clasament din API-ul Statistici întoarce primele firme după o mărime, opțional într-un sector. Poți ordona după cifra de afaceri (cine vinde cel mai mult), după rezultat (cine câștigă cel mai mult), după angajați (cei mai mari angajatori), după capitaluri (firmele cu cea mai solidă bază proprie) sau după datorii (cele mai îndatorate).

Cererea costă 3 credite, oricare ar fi sectorul. Datele vin din toate bilanțurile în format standard depuse din 2008 încoace și se actualizează la fiecare import de bilanțuri. Un detaliu care poate surprinde: în clasament intră doar firmele cu valoare pozitivă la mărimea aleasă. Clasamentul după rezultat îi cuprinde deci doar pe cei cu profit, iar firmele pe pierdere nu apar deloc, nici la coadă.

Prima cerere

Forma răspunsului o vezi în sandbox, unde cererile nu consumă credite; sandbox-ul cere doar o cheie API, deci un cont gratuit, fără card:

curl -H "X-API-KEY: cheia-ta" \
  "https://www.bilantapi.ro/api/sandbox/v1/statistici/clasament?dupa=cifra_afaceri&caen=4120&limita=50"

Parametrii sunt patru, toți opționali. dupa primește cifra_afaceri (implicit), rezultat_net, angajati, capitaluri sau datorii. caen e codul CAEN de patru cifre; fără el, clasamentul e pe toate firmele. limita spune câte firme vrei, de la 1 la 100, implicit 20. an alege exercițiul financiar; fără el se ia ultimul an cu date.

În data.firme primești, pentru fiecare firmă, cui, denumire, caen, denumire_caen, cifra_afaceri, rezultat_net și angajati. Descrierea completă e în documentație, împreună cu fișierul OpenAPI din care îți generezi un client. În producție schimbi adresa în https://www.bilantapi.ro/api/v1.

Clasamentul cu tot cu sector

Dacă vrei și contextul sectorului, ruta GET /api/v1/statistici/sectoare/{caen} (tot 3 credite) întoarce, pe lângă primele firme (în top), totalurile sectorului, distribuția cifrei de afaceri (p25, mediana, p75, p90), marja mediană, gradul de concentrare și evoluția pe ani:

curl -H "X-API-KEY: cheia-ta" \
  https://www.bilantapi.ro/api/sandbox/v1/statistici/sectoare/4120

Câmpul concentrare îți spune, în procente, ce parte din cifra de afaceri a sectorului revine primelor 5 (top5) și primelor 10 firme (top10). Fără el, un clasament se citește greșit. Într-un sector foarte concentrat, locurile 1–10 sunt aproape toată piața, iar de la locul 50 în jos ești deja printre firmele mici.

Lista de conturi-țintă

Pentru o echipă care vinde firmelor mari, clasamentul unui sector e lista de conturi strategice, deja ordonată. Eu aș lucra așa: cer clasamentul după cifra de afaceri pentru codurile CAEN în care vând și scot firmele cu care lucrez deja. Pentru primele rămase cer profilul fiscal (/registru/firme/{cui}, 1 credit), ca să confirm că sunt active și să aflu adresa. Abia pentru cele pe care le abordez efectiv cer datele de contact (/registru/firme/{cui}/contact, 10 credite): telefoane, emailuri, site-uri și reprezentanți legali.

Ordinea asta ține costul jos. Nu plătești date de contact pentru firme pe care n-o să le suni niciodată.

Alte feluri de a-l folosi

Salvat an de an, clasamentul îți arată cine urcă și cine coboară. O firmă care a intrat în top 20 venind din afara primelor 100 în trei ani e fie un concurent de urmărit, fie un client în plină creștere. De multe ori e amândouă.

Dacă firma ta e în același cod CAEN, clasamentul îți arată și unde te afli tu. Pentru un răspuns mai precis, ruta /bilant/{cui}/pozitie (3 credite) întoarce locul, percentila și raportul față de mediana sectorului.

Ce să nu uiți când citești un clasament

Anul datelor. Clasamentul stă pe bilanțuri anuale. În prima parte a anului, cel mai nou exercițiu complet poate fi cel de acum doi ani, pentru că bilanțurile anului trecut încă se depun. Scrie anul lângă orice clasament pe care îl arăți cuiva.

Codul CAEN principal. Firmele sunt încadrate după activitatea principală declarată. O firmă care face mai ales distribuție, dar are ca activitate principală un cod de producție, apare printre producători. Dacă un nume din listă te surprinde, uită-te la activitățile autorizate.

Grupurile. Un grup poate avea vânzările împărțite între mai multe firme. Clasamentul e pe firme, nu pe grupuri, deci un jucător important poate apărea mai jos decât te aștepți sau de mai multe ori.

Vânzări versus rezultat. Primul loc la vânzări nu e neapărat cel mai sănătos. Pune alături clasamentul după rezultat și pe cel după datorii. O firmă sus în toate trei e un lider solid. Una sus la vânzări și la datorii, dar jos la rezultat, merită o analiză separată.

Un flux complet

Să zicem că un furnizor de echipamente de construcții vrea 30 de conturi strategice în vestul țării. Ia clasamentul după cifra de afaceri pentru construcțiile de clădiri și păstrează firmele cu sediul în județele care îl interesează (sediul e în profilul fiscal, în sediu_social.judet). Scoate firmele cu care lucrează deja și pe cele cu pierderi în ultimul an. Pentru cele 30 rămase cere datele de contact. Totalul rămâne la câteva sute de credite, iar lista stă pe cifre oficiale, nu pe impresiile cuiva din echipă.

Pentru comparații punctuale, ruta /statistici/comparatie (3 credite) pune până la 10 firme una lângă alta; CUI-urile merg în parametrul cui, despărțite prin virgulă.

Cât de des îl reînnoiești

Clasamentele se schimbă o dată pe an, odată cu bilanțurile. N-are rost să ceri același clasament în fiecare săptămână: salvează-l și reîmprospătează-l după sezonul de depunere, când datele noi au intrat în statistici.

Starea firmelor din listă se poate schimba însă oricând. O firmă din top poate intra în insolvență sau poate fi radiată în cursul anului, așa că înainte de o campanie mai verifici o dată profilul fiscal, care se actualizează zilnic din registrul ANAF. Și păstrează clasamentele vechi. După doi-trei ani ai propria serie despre cine urcă și cine coboară în domeniul tău.

Clasamentul, statisticile pe sectoare, panorama economiei și comparațiile sunt pe pagina API-ului Statistici. Cele 250 de credite gratuite de la înregistrare, fără card, îți ajung pentru clasamentele tuturor codurilor CAEN în care lucrezi.