Honnan származnak az adatok, és hogyan tartjuk őket naprakészen
Minden, amit az API visszaad, hivatalos nyilvános nyilvántartásokból származik: semmit nem egészítünk ki, nem becsülünk, és nem keverünk hozzá nem hivatalos forrásból származó adatot. Minden válaszban van egy sources mező, amely forrásonként megmondja, mikor szolgáltatta először és utoljára az információt, és melyik adatkészletből.
A források
| Forrás | Mit veszünk át | Milyen gyakran |
|---|---|---|
| Országos Cégjegyzéki Hivatal (ONRC), nyílt adatok a data.gov.ro oldalon (CC BY 4.0 licenc) | A cégjegyzékbe bejegyzett cégek: név, CUI, cégjegyzékszám, EUID, cégforma, székhely, a cégjegyzék szerinti állapotok, az engedélyezett tevékenységek | Minden közzétett adatkészletnél, nagyjából havonta |
| Országos Adóhatóság (ANAF), nyilvános áfa-webszolgáltatás | Adózási állapot, áfa-nyilvántartásba vétel, pénzforgalmi áfa (TVA la încasare), megosztott áfafizetés, inaktivitás, e-Factura, CAEN-kód | Naponta az új cégeknél, hetente az aktív áfaalanyoknál, kéthavonta a többinél |
| Pénzügyminisztérium, nyílt adatok a data.gov.ro oldalon | Az éves pénzügyi beszámolók, 2008-tól | Minden közzétételkor, általában évente egyszer, frissítésekkel |
| Pénzügyminisztérium, nyílt adatok a data.gov.ro oldalon (CC BY 4.0 licenc) | Minden adózó adókötelezettségei („vector fiscal”), a lista napjára | Minden közzétett listával, évente egyszer |
| Román Nemzeti Bank | A referencia-árfolyam, 2005-től | Minden banki munkanapon |
Új cégek
Egy újonnan bejegyzett cég általában a bejegyzését követő napon jelenik meg nálunk.
Aki az új cégeket követi, annak két adatra van szüksége, amelyeket nem szabad összekeverni:
registered_ona bejegyzés dátuma: a cégjegyzékbe való bejegyzés, ahol ismerjük; egyébként az ANAF-nál történt adóügyi nyilvántartásba vétel, amelyre néhány nappal később kerül sor. Ez alapján választható ki az időszak (days,registered_after).next_cursormegmutatja, honnan kell folytatni. Aki naponta kérdez le, megőrzi az utolsó válasznext_cursorértékét — az utolsó oldalét is —, és másnapcursorparaméterként küldi el. Ne a bejegyzés dátuma szerint folytassa: egy hétfőn bejegyzett céget lehet, hogy csak pénteken indexelünk, és a kurzor azt is elhozza.
Egy cég másodlagos telephelye saját CUI-t kap az ANAF-nál. E CUI alapján lekérdezhető, de nem számoljuk bele, és nem adjuk vissza új cégként.
A lista a gazdasági tevékenységet folytató természetes személyeket is tartalmazza. A persoana_fizica=false paraméterrel csak a jogi személyek, a persoana_fizica=true paraméterrel csak a természetes személyek kérhetők le; az a bejegyzés, amelyet még nem tudunk besorolni, egyikben sem jelenik meg, és a besorolásakor sem adjuk vissza még egyszer.
Mit jelentenek a válaszban szereplő időpontok
updated_on: az a nap, amikor utoljára változott valami a cég adataiban.changed_on: az a nap, amikor egy forrás utoljára egy általunk már ismert adatot másikra cserélt (az ANAF által megadott bármely mező, a névtől, a címektől és a telefontól az áfáig és az e-Facturáig, a cégjegyzék adatai, adókötelezettségek). Üres, amíg semmi sem változott, mióta a cég nálunk van; egy hiányzó, utólag kiegészített adat nem változás.checked_on: az a nap, amikor utoljára megkérdeztük az ANAF-ot a cégről, akkor is, ha semmi sem változott. Üres annál a cégnél, amelyet egyelőre csak a cégjegyzék adatkészletéből ismerünk.data_inmatriculare: a cégjegyzékbe való bejegyzés dátuma (forrás: ONRC).data_inregistrare: az adóügyi nyilvántartásba vétel dátuma (forrás: ANAF).stare: a cég állapota egyetlen szóval:FUNCTIUNE,SUSPENDARE,REORGANIZARE JUDICIARA,INSOLVENTA,DIZOLVARE,LICHIDARE,FALIMENTvagyRADIERE. A cégjegyzék összes állapota és megjegyzése astari_registrumezőben található.
Az olyan céget, amely még nincs meg nálunk, azonnal lekérdezzük az ANAF-nál: a válasz ugyanabban a kérésben érkezik, vagy ha a forrás késik, 202 kóddal és Retry-After fejléccel.
Pénzügyi beszámolók
A Pénzügyminisztérium által közzétett beszámolók, a mutatók egész lejben. Az a mutató, amelyet a minisztérium üresen hagy, null, nem nulla. Azok a beszámolótípusok, amelyeknek a közös mutatókon kívül továbbiak is vannak (bankok, biztosítók, nonprofit szervezetek), ezeket az alti_indicatori mezőben tartalmazzák, a minisztérium által adott megnevezésekkel. Mielőtt átveszünk egy fájlt, ellenőrizzük, hogy a számok egyeznek-e: az összes bevétel és az összes ráfordítás különbségének meg kell egyeznie a bruttó nyereség és a bruttó veszteség különbségével. Azok a beszámolók, amelyeket azután nyújtottak be, hogy a minisztérium összeállította az adatkészletét, hiányoznak belőle: ezeket az ANAF nyilvános webszolgáltatásából vesszük át, 2019-től, és ugyanígy ellenőrizzük, azzal a különbséggel, hogy ott a be nem jelentett mutató nulla, nem üres.
Adókötelezettségek
Az adózók listájából, amelyet a Pénzügyminisztérium évente egyszer tesz közzé, minden CUI-hoz átvesszük azokat az adókötelezettségeket, amelyekre nyilvántartásba volt véve (a „vector fiscal”: nyereségadó vagy mikrovállalkozási jövedelemadó, jövedéki adók, a bérek utáni adó, a járulékok és a többi), valamint az utolsó nyilatkozat és az utolsó feldolgozás napját. Ezeket az obligatii_fiscale mezőben adjuk meg úgy, ahogyan a lista napján (la_data) voltak, nem úgy, ahogyan ma vannak: az a cég, amely azóta adózási módot váltott, a következő listáig a régivel szerepel. A regim_impozitare egy szóban mondja meg, hogyan adózott a jövedelem: profit, micro vagy specific. A lista csak azt mondja meg, hogy egy kötelezettség nyilvántartásba volt-e véve, azt nem, hogy mióta.
Az ultima_declaratie az a nap, amikor az adózó utolsó nyilatkozatát nyilvántartásba vették, ahogyan a lista megadja; ez nem az adóügyi nyilvántartásba vétel napja, és nem is az utolsó adóbevallásé. Ahol nem ismerjük őket, az obligatii_fiscale mező null: annál a cégnél, amely nem szerepel a listán, vagy amelyet a lista importálása után vettünk fel, a következő listáig.
Amit nem szolgáltatunk
Személyi azonosító számot (CNP) nem szolgáltatunk, és a cégek törvényes képviselőire vonatkozó adatokat sem vesszük át a cégjegyzékből. A gazdasági tevékenységet folytató természetes személyeket — egyéni vállalkozókat (PFA), egyéni és családi vállalkozásokat, szabadfoglalkozásúakat — a cégekhez hasonlóan szolgáltatjuk, azzal, amit a nyilvántartások közzétesznek róluk. A válasz persoana_fizica mezője megmondja, milyen bejegyzésről van szó: false jogi személy, true természetes személy esetén, null, amíg a forrásokból ezt nem tudjuk megállapítani.
Amink egyelőre nincs
Inkább megmondjuk, hogy egy információ nincs meg nálunk, mintsem bizonytalan forrásból szolgáltassuk. Jelenleg nincs meg:
- Az állami költségvetéssel szembeni tartozások. Az ANAF a hátralékos cégek listáját csak egy védett keresőoldalon teszi közzé, nem adatkészletként; a data.gov.ro oldalon lévő adatkészlet 2016-os. A lista egyébként is csak egy küszöb feletti tartozásokat tartalmaz, tehát ha egy cég nincs rajta, az nem jelenti azt, hogy nincs tartozása.
- A munkapontok (telephelyek). A cégjegyzék nem teszi közzé őket a nyílt adatok között. Az ANAF egyes másodlagos telephelyeknek saját adószámot ad, de anélkül, hogy megadná, melyik céghez tartoznak; másodlagos telephelyként jelöljük őket, és senkihez sem rendeljük hozzá.
- Ügyvezetők, tagok és részvényesek. Ezek személyekre vonatkozó adatok; a jogi elemzésig félretesszük őket.
- Bírósági ügyek, fizetésképtelenség (BPI), a Hivatalos Közlöny (Monitorul Oficial), engedélyek (ANRE, ARR), import és export. Mindegyiknek más a forrása, más megbízhatósággal; egyenként vesszük fel őket, csak ott, ahol a forrás hivatalos és stabil.
Egy válaszban a null mező azt jelenti, hogy „nem tudjuk”, nem azt, hogy „nincs”: például a caen_autorizate null annál a cégnél, amely nem szerepel a cégjegyzék adatkészletében.
Hiba az adatokban
Ha hibás adatot látsz, írj nekünk a dev@apifirme.dev címre, és add meg a CUI-t. Az átvételkor általunk elkövetett hibát itt javítjuk; a nyilvántartásban szereplő hibát az a nyilvántartás javítja, amely közzéteszi (ONRC vagy ANAF), mi pedig a következő frissítéskor átvesszük a javított adatot.
Forrásmegjelölés
A cégjegyzék adatait az Országos Cégjegyzéki Hivatal (Oficiul Național al Registrului Comerțului) teszi közzé Creative Commons Attribution 4.0 licenc alatt. Feldolgoztuk őket: egyesítettük az azonos céghez tartozó bejegyzéseket, a diakritikus jeleket helyes alakra hoztuk, és lefordítottuk az állapotkódokat.
Az adózók listáját („Date de identificare plătitori”) a Pénzügyminisztérium ugyanazon licenc, Creative Commons Attribution 4.0 alatt teszi közzé. Ebből csak az adókötelezettségeket és az utolsó nyilatkozat napjait vesszük át; a kódok nevét a minisztérium nómenklatúrája szerint írtuk ki teljesen.