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

SursaCe luămCâ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 autorizateLa fiecare set publicat, aproximativ lunar
Agenția Națională de Administrare Fiscală, serviciul web public pentru TVAStarea fiscală, înregistrarea în scopuri de TVA, TVA la încasare, plata defalcată, inactivitate, e-Factura, cod CAENZilnic 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.roSituațiile financiare anuale, din 2008La 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 listeiLa fiecare listă publicată, o dată pe an
Banca Națională a RomânieiCursul 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:

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

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:

Î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.