De unde vin datele și cum sunt ținute la zi
Tot ce întoarce API-ul vine din registre publice oficiale: nu completăm, nu estimăm și nu combinăm date din surse neoficiale. Fiecare răspuns are un câmp sources care spune, pentru fiecare sursă, când a furnizat informația prima și ultima oară și din ce set de date.
Sursele
| Sursa | Ce luăm | Cât de des |
|---|---|---|
| Oficiul Național al Registrului Comerțului, date deschise pe data.gov.ro (licență CC BY 4.0) | Firmele înregistrate în registrul comerțului: denumire, CUI, număr de înregistrare, EUID, formă juridică, sediu, stările din registru, activitățile autorizate | La fiecare set publicat, aproximativ lunar |
| Agenția Națională de Administrare Fiscală, serviciul web public pentru TVA | Starea fiscală, înregistrarea în scopuri de TVA, TVA la încasare, plata defalcată, inactivitate, e-Factura, cod CAEN | Zilnic pentru firmele noi, săptămânal pentru cele active plătitoare de TVA, la două luni pentru celelalte |
| Ministerul Finanțelor, date deschise pe data.gov.ro | Situațiile financiare anuale, din 2008 | La fiecare publicare, de obicei o dată pe an, cu actualizări |
| Ministerul Finanțelor, date deschise pe data.gov.ro (licență CC BY 4.0) | Obligațiile fiscale ale fiecărui contribuabil (vectorul fiscal), la data listei | La fiecare listă publicată, o dată pe an |
| Banca Națională a României | Cursul de referință, din 2005 | În fiecare zi bancară |
Firmele noi
O firmă nou înregistrată apare la noi, de obicei, în ziua următoare înregistrării ei.
Cine urmărește firmele noi are nevoie de două lucruri, care nu trebuie confundate:
registered_oneste data înregistrării: intrarea în registrul comerțului, acolo unde o cunoaștem; altfel, înregistrarea fiscală la ANAF, care are loc cu câteva zile mai târziu. După ea se alege perioada (days,registered_after).next_cursorarată de unde se continuă. Cine întreabă zilnic păstreazănext_cursordin ultimul răspuns — chiar și de pe ultima pagină — și îl trimite a doua zi cacursor. Nu se continuă după data înregistrării: o firmă înregistrată luni poate fi indexată vineri, iar cursorul o aduce și pe ea.
Un sediu secundar al unei firme primește la ANAF un CUI propriu. Îl putem căuta după CUI, dar nu îl numărăm și nu îl întoarcem ca firmă nouă.
Lista cuprinde și persoanele fizice care desfășoară o activitate economică. Cu persoana_fizica=false se cer doar persoanele juridice, cu persoana_fizica=true doar persoanele fizice; o înregistrare pe care încă nu o putem clasifica nu apare în niciuna dintre cele două și nu este dată a doua oară când o clasificăm.
Ce înseamnă datele din răspuns
updated_on: ziua în care s-a schimbat ultima oară ceva în datele firmei.changed_on: ziua în care o sursă a înlocuit ultima oară o informație pe care o aveam deja cu alta (orice câmp dat de ANAF, de la denumire, adrese și telefon la TVA și e-Factura, datele registrului comerțului, obligațiile fiscale). Este gol cât timp nu s-a schimbat nimic de când avem firma; o informație completată, care lipsea, nu este o schimbare.checked_on: ziua în care am întrebat ultima oară ANAF despre firmă, chiar dacă nu s-a schimbat nimic. Este gol pentru o firmă cunoscută deocamdată doar din setul registrului comerțului.data_inmatriculare: data intrării în registrul comerțului (sursa: ONRC).data_inregistrare: data înregistrării fiscale (sursa: ANAF).stare: starea firmei într-un singur cuvânt:FUNCTIUNE,SUSPENDARE,REORGANIZARE JUDICIARA,INSOLVENTA,DIZOLVARE,LICHIDARE,FALIMENTsauRADIERE. Toate stările și mențiunile din registrul comerțului sunt înstari_registru.
O firmă pe care nu o avem încă este căutată pe loc la ANAF: răspunsul vine în aceeași cerere sau, dacă sursa întârzie, cu 202 și antetul Retry-After.
Situațiile financiare
Sunt cele publicate de Ministerul Finanțelor, cu indicatorii în lei întregi. Un indicator pe care ministerul îl lasă gol este null, nu zero. Tipurile de raportare cu alți indicatori decât cei comuni (bănci, asigurători, organizații fără scop patrimonial) îi au în alti_indicatori, cu denumirile date de minister. Înainte de a prelua un fișier verificăm că cifrele se leagă: veniturile totale minus cheltuielile totale trebuie să dea profitul brut minus pierderea brută. Situațiile depuse după ce ministerul și-a alcătuit setul de date lipsesc din el: pe acestea le luăm din serviciul web public al ANAF, din 2019 încoace, și le verificăm la fel, cu deosebirea că acolo un indicator nedeclarat apare ca zero, nu gol.
Obligațiile fiscale
Din lista contribuabililor pe care Ministerul Finanțelor o publică o dată pe an luăm, pentru fiecare CUI, obligațiile fiscale la care era înregistrat (vectorul fiscal: impozit pe profit sau pe veniturile microîntreprinderilor, accize, impozitul pe salarii, contribuțiile și celelalte) și zilele ultimei declarații și ale ultimei prelucrări. Le dăm în obligatii_fiscale așa cum erau în ziua listei, la_data, nu cum sunt azi: o firmă care și-a schimbat între timp regimul de impozitare apare cu cel vechi până la lista următoare. regim_impozitare spune într-un cuvânt cum era impozitat venitul: profit, micro sau specific. Lista spune doar dacă o obligație era înregistrată, nu de când.
ultima_declaratie este ziua în care a fost înregistrată ultima declarație a contribuabilului, cum o dă lista; nu este data înregistrării fiscale și nici a ultimei declarații de impozite. Unde nu le cunoaștem, obligatii_fiscale este null: la o firmă care nu apare în listă sau pe care am preluat-o după ce lista a fost importată, până la lista următoare.
Ce nu servim
Nu servim coduri numerice personale (CNP) și nu preluăm din registrul comerțului datele despre reprezentanții legali ai firmelor. Persoanele fizice care desfășoară o activitate economică — persoane fizice autorizate, întreprinderi individuale și familiale, profesii liberale — sunt servite ca firmele, cu ce publică registrele despre ele. Câmpul persoana_fizica din răspuns spune ce fel de înregistrare este: false pentru o persoană juridică, true pentru o persoană fizică, null cât timp sursele nu ne permit să spunem.
Ce nu avem deocamdată
Preferăm să spunem că nu avem o informație decât să o servim dintr-o sursă nesigură. Nu avem acum:
- Datoriile la bugetul de stat. ANAF publică lista firmelor cu obligații restante doar printr-o pagină de căutare protejată, nu ca set de date; setul de pe data.gov.ro este din 2016. Lista cuprinde oricum numai datoriile peste un prag, deci lipsa de pe listă nu înseamnă lipsa datoriilor.
- Punctele de lucru. Registrul comerțului nu le publică în datele deschise. ANAF dă cod fiscal propriu unor sedii secundare, dar fără legătura cu firma de care țin; le marcăm ca sedii secundare și nu le atribuim nimănui.
- Administratori, asociați și acționari. Sunt date despre persoane; le lăsăm deoparte până la o analiză juridică.
- Dosare în instanță, insolvență (BPI), Monitorul Oficial, licențe și autorizații (ANRE, ARR), import și export. Fiecare are altă sursă, cu altă siguranță; le vom adăuga pe rând, doar acolo unde sursa este oficială și stabilă.
Într-un răspuns, un câmp null înseamnă „nu știm”, nu „nu există”: de exemplu caen_autorizate este null pentru o firmă care nu apare în setul registrului comerțului.
O greșeală în date
Dacă vezi o informație greșită, scrie-ne la dev@apifirme.dev și spune-ne CUI-ul. O greșeală făcută de noi la preluare o îndreptăm aici; una care stă în registru se îndreaptă la registrul care o publică (ONRC sau ANAF), iar noi preluăm informația îndreptată la următoarea actualizare.
Atribuire
Datele registrului comerțului sunt publicate de Oficiul Național al Registrului Comerțului sub licența Creative Commons Attribution 4.0. Le-am prelucrat: am reunit înregistrările aceleiași firme, am adus diacriticele la forma corectă și am tradus codurile de stare.
Lista contribuabililor („Date de identificare plătitori”) este publicată de Ministerul Finanțelor sub aceeași licență, Creative Commons Attribution 4.0. Din ea luăm doar obligațiile fiscale și zilele ultimei declarații; denumirile codurilor le-am scris întregi, după nomenclatorul ministerului.