Számítástechnikai Fejlesztő zrt. Fejlesztői kézikönyv Occsz Az Occsz szolgáltatásainak automata rendszerekből való használata 2015. augusztus 27. MICROSEC Számítástechnikai Fejlesztő zrt. 1031 Budapest, Záhony u. 7.
Tartalomjegyzék 1. BEVEZETÉS.. 3 1.1 A CÉG AZONOSÍTÁSA KIADMÁNYOK KÉRÉSÉHEZ.. 3 1.1.1 Keresés cégjegyzékszám vagy adószám szerint 3 1.1.2 Keresés a cég elnevezése szerint.. 3 1.1.3 Keresés természetes vagy jogi személy szerint és székhely szerint.. 4 1.1.4 Összetett keresés.. 4 1.1.5 Árajánlat kérése 4 1.2 A CÉG KIVÁLASZTÁSA ÉS A KIADMÁNYOK KÉRÉSE. 4 2. KOMMUNIKÁCIÓS FELÜLET.. 6 2.1 SZOLGÁLTATÁSOK FELHÍVÁSA, PARAMÉTEREK ÁTADÁSA 6 2.2 SZOLGÁLTATÁS FELHÍVÁSA TANÚSÍTVÁNYALAPÚ AUTHENTIKÁCIÓ ESETÉN.. 6 2.3 KIMENET FELDOLGOZÁSA 6 2.3.1 HTML alapú eredmény. 7 2.3.2 XML alapú eredmény 7 2.3.3 Aláírt listák. 7 2.3.4 e-akták.. 8 2.3.5 Egyéb dokumentumok 8 3. ELÉRHETŐ SZOLGÁLTATÁSOK 9 3.1 KERESÉSEK 9 3.1.1 Általános paraméterek.. 9 3.1.2 Kimenet felépítése. 10 3.1.3 Keresés cégjegyzékszám alapján.. 11 3.1.4 Keresés cégnév alapján. 11 3.1.5 Keresés székhely alapján.. 12 3.1.6 Keresés adószám alapján. 12 3.1.7 Keresés természetes ill. jogi személy alapján. 12 3.1.8 Összetett keresés 14 3.2 KIADMÁNYOK ÉS IRATOK LEKÉRÉSE 16 3.2.1 Általános paraméterek 16 3.2.2 Cégbizonyítvány lekérése. 17 3.2.2.1 Meghatározott alrovatok lekérése.. 18 3.2.3 Kiadmány XML-ek felépítése cégmásolat, cégkivonat és cégbizonyítvány esetén 19 3.2.3.1 Kiadmány.. 19 3.2.3.2 CégAdatlap 20 3.2.3.3 Rovatok.. 20 3.2.4 Kiadmány XML-ek felépítése mérlegjegyzék esetén 21 3.2.5 Kiadmány XML-ek felépítése közleménylista esetén 22 3.2.6 Kiadmány XML-ek felépítése iratjegyzék esetén 23 3.3 ÁRAJÁNLAT KÉRÉSE 24 3.4 KIADMÁNY LEKÉRDEZÉSE ÁRAJÁNLAT ALAPJÁN HTML FORMÁTUM ESETÉN. 24 3.5 KIADMÁNY LEKÉRDEZÉSE ÁRAJÁNLAT ALAPJÁN XML FORMÁTUM ESETÉN 25 4. CÉGFIGYELÉS. 26 4.1 CÉGFIGYELÉS BEÁLLÍTÁSA.. 26 4.2 FIGYELT CÉGEK LISTÁJA 26 4.3 CÉGFIGYELÉS (ÉRTESÍTÉSI CÍM) MÓDOSÍTÁSA 28 4.4 CÉGFIGYELÉS TÖRLÉSE.. 28 4.5 FIGYELMEZTETŐ E-MAIL FELDOLGOZÁSA. 29 5. FÜGGELÉK. 30 5.1 HIBAKÓDOK LISTÁJA.. 30 MICROSEC Számítástechnikai Fejlesztő zrt. 2/31
1. Bevezetés A Céginformációs és az Elektronikus Cégeljárásban Közreműködő Szolgálattól kiadmányok kérhetők. A kiadmányokban feltüntetett adatok az ország cégbíróságain vezetett cégjegyzékekből származnak. A kért kiadmányhoz szükséges adatokat a kérés időpontjában az Országos Cégnyilvántartó és Céginformációs Rendszer gyűjti össze az adott cég illetékes cégbíróságának számítógépes rendszeréből. Így bárki biztos lehet abban, hogy az adott céggel kapcsolatos kiadmányban azok az adatok szerepelnek, amelyek az illetékes cégbíróság számítógépes rendszerében az adott időpillanatban rendelkezésre állnak. Az alábbiakban röviden bemutatjuk az Occsz WEB-es, interaktív felületének használatát, ugyanis az automatikus lekérdezések során is ugyanezt a mechanizmust kell HTTPS alapú lekérdezések formájában reprodukálni. 1.1 A cég azonosítása kiadmányok kéréséhez A kiadmányok kérelméhez először azonosítani kell a céget. A cég azonosításához válassza a képernyő bal oldalán megjelenő Menüben a Cégkeresés menüpontot. A céget többféleképpen azonosíthatja: Cégjegyzékszám szerint A cég elnevezése szerint Székhely szerint Adószám szerint Természetes vagy jogi személy szerint Összetett, több szűrőfeltételt tartalmazó kereséssel A megfelelő menüpont kiválasztása után a menüpont neve alatt megjelenik a keresési adatok megadására szolgáló ablak. A kérvény keresési adatokat értelemszerűen kell kitölteni. 1.1.1 Keresés cégjegyzékszám vagy adószám szerint Mind a cégjegyzékszámot, mind az adószám törzsszám részét pontosan, teljes hosszában meg kell adni. 1.1.2 Keresés a cég elnevezése szerint Cégnév szerinti keresésénél elegendő a keresett cég nevének vagy rövidített elnevezésének a kezdetét megadni. Hosszabb cégnév-kezdet (minta) szelektívebb, azaz kevesebb olyan cégnévre bukkan a rendszer, amelynek kezdete illeszkedik a hosszabb megadott mintára. Itt jegyezzük meg, hogy a szelektív minták jelentősen csökkentik a feladatok elvégzéséhez tartozó kommunikációs költségeket. Ugyanakkor a hosszabb minta megadásakor nagyobb az ügyfél által elkövethető gépelési hibák valószínűsége is. így előfordulhat, hogy a rendszer gépelési hiba miatt nem talál meg olyan céget a nyilvántartásban, amely egyébként más források alapján törvényesen bejegyzett MICROSEC Számítástechnikai Fejlesztő zrt. 3/31
cégnek tekinthető. Eredménytelen keresés esetében ezért javasoljuk a többszöri próbálkozást egyre rövidülő névkezdetek megadásával. Felhívjuk azonban a figyelmet arra, hogy a rövidebb mintához tartozó bővülő cégnevek listája a kommunikációs költségek növekedésével jár együtt. Az ügyfelek által megadott cégnév kezdetekben a rendszer nem tesz különbséget a kis és nagy betűk, illetve a rövid és hosszú magánhangzók között, de természetesen megkülönbözteti az o és ö, valamint u és ü betűket. Nem veszi kereséskor figyelembe továbbá a szóköz karaktereket és a különböző írásjeleket sem. A következő cégnév kezdetek ezért azonos eredményre vezetnek: ALMA alma AL-MA a.l.m.a A megadott mintának legalább 4 karakter hosszúnak kell lennie. Ne használjon olyan keresési mintát, amely kevés betűből áll, vagy gyakran szerepel különböző cégek elnevezésében (pl.: Auto, Buda, Pest, Comp, Inter, Hung, Micro stb.)! Ezek nagyszámú találatot eredményeznek, melyeknek költsége igen magas. 1.1.3 Keresés természetes vagy jogi személy szerint és székhely szerint A személyneveket, utca és város neveket olyan formában kell megadni, ahogy azok a cégjegyzékben szerepelnek: a kis és nagy betűk, illetve a rövid és hosszú magánhangzók ezekben a keresésekben különbözőnek számítanak. 1.1.4 Összetett keresés Az összetett keresés egy felületen tartalmazza a név, a cím, az adószám, a cégjegyzékszám szerinti keresést kiegészítve őket irányítószám intervallumra, cégformára és megyére vonatkozó kereséssel is. A keresés eredménye azon cégeket tartalmazza, melyek az összes megadott feltételnek megfelelnek. 1.1.5 Árajánlat kérése Az azonosításhoz szükséges adatok megadása után kiválaszthatja, hogy azonnal lekéri-e az adatokat, vagy előbb árajánlatot kér. Javasoljuk, hogy az adatok azonnali lekérdezése előtt kérjen árajánlatot. Ennek nem csak az az előnye, hogy látja a kiadmányok árát, hanem az is, hogy a kiadmányokat az árajánlat kérés időpontjától számított 24 órán belül az árajánlat lapján található linkről többször is lekérheti anélkül, hogy ezért a rendszer külön számlázna. Ha az árajánlatot nem fogadja el, akkor a rendszer nem számlázza a kiadmány díját. 1.2 A cég kiválasztása és a kiadmányok kérése A keresési minta megadása után a keresést a kérek nyomógomb megnyomásával indíthatja el. A keresési adatoknak megfelelő cégek a képernyő jobb oldalán, az eredmény ablakban jelennek meg. MICROSEC Számítástechnikai Fejlesztő zrt. 4/31
Több talált cég esetén először ki kell választania azt a céget, vagy cégeket, amelynek kiadmányát le szeretné kérni. Ez után a lap alján meg kell adnia hogy a cégjegyzék mely időpontban érvényes állapotában kéri a kiadmányt, elektronikusan aláírva vagy anélkül kéri a kiadmányt, ki kell választania a kiadmányt, választania kell, hogy az adatok azonnali lekérését választja, vagy előbb árajánlatot kér A kiadmányt lekérését az adatok megadása után a befejeztem nyomógomb megnyomásával indíthatja el. A rendszer által szolgáltatott kiadmányok hitelességét az Igazságügyi és Rendészeti Minisztérium Céginformációs és az Elektronikus Cégeljárásban Közreműködő Szolgálat szavatolja. MICROSEC Számítástechnikai Fejlesztő zrt. 5/31
2. Kommunikációs felület Az alábbi fejezet azt mutatja be, hogy az Occsz rendszerrel milyen kommunikációs protokollok segítségével lehet kapcsolatba lépni, illetve a rendszer által adott válasz dokumentumok milyen módon értelmezhetőek, dolgozhatóak fel. 2.1 Szolgáltatások felhívása, paraméterek átadása Amikor valamilyen automata rendszerből szeretnénk az Occsz céginformációs szolgáltatásait elérni, gyakorlatilag szimulálnunk kell azt a folyamatot, mintha egy felhasználó a böngészője előtt ülve, az egérrel kattintgatva ill. a form-okon adatokat megadva navigálna az oldalak között. Ennek megfelelően minden egyes lekérdezés HTTPS protokoll felett történik, a lekérdező felhasználót ezen protokollon belül definiált, jelszó alapú Basic Authentication módszerrel (felhasználónév-jelszó párossal) azonosítjuk. A lekérdezések paraméterei GET vagy POST lekérdezések paraméterei formájában kerülnek átadásra ISO-8859-2 (Latin 2) karakterkódolás használatával. Minden esetben az alábbi címet kell a paraméterek kíséretében megszólítani: https://felhasználó:jelszó@occsz.e-cegjegyzek.hu/imonline A szolgáltatás nyilvános Internet kapcsolaton keresztül érhető el, így védett hálózatokon belül az automata rendszer számára biztosítani kell a lehetőséget (pl. transzparens proxy szerver segítségével), hogy az Occsz szerverét a belső, védett hálózatból elérhesse. 2.2 Szolgáltatás felhívása tanúsítványalapú authentikáció esetén A céginformáció szolgáltatás tanúsítványalapú authentikációval is elérhető. Ebben az esetben az alábbi címet kell a paraméterek kíséretében megszólítani: https://gov.e-cegjegyzek.hu/imonline A dokumentációban minden helyen, ahol az URL-ekben occsz.e-cegjegyzek.hu szerepel, tanúsítványalapú authentikáció esetén a gov.e-cegjegyzek.hu használandó. Minden más paramétert ugyanolyan módon kell használni. 2.3 Kimenet feldolgozása A HTTPS lekérdezés eredménye 200-as eredménykód esetén minden esetben egy, a szerverről letöltött dokumentum. A dokumentum formátumát a lekérdezés outformat nevű paramétere határozza meg, és ennek függvényében lehet HTML dokumentum, ami felhasználók számára nyújt olvasható, könnyen áttekinthető eredményt, vagy XML dokumentum, amely kifejezetten számítógépes, automatikus feldolgozás számára ideális. A paraméter alapértelmezett értéke: html. MICROSEC Számítástechnikai Fejlesztő zrt. 6/31
2.3.1 HTML alapú eredmény outformat=html A HTML alapú kimenetek szabad szemmel való olvasás számára megfelelőek, használatuk olyan esetben célszerű, ha az automata rendszer különböző adatforrásokból gyűjt össze adatokat, de azt nem maga dolgozza fel, hanem csak megmutatja felhasználója számára, vagy abban az esetben, ha a rendszer elvégzi ugyan az adatgyűjtést, de az eredményt nem dolgozza fel automatikusan, csak eltárolja későbbi, emberi interaktivitást igénylő feldolgozás számára. Fontos: a HTML dokumentumban minden hivatkozás tartalmazza az Occsz szerver teljes elérési útvonalát, így ha nem kívánt, hogy a felhasználók közvetlenül elérjék az Occsz szervert és szolgáltatásait, az eredményül kapott HTML dokumentumban módosítani kell a fellelhető URL-eket. 2.3.2 XML alapú eredmény outformat=xml6 Az XML alapú kimenet használata automatikus feldolgozás esetén ajánlott. Az Occsz rendszer által szolgáltatott XML tartalmak adatstruktúra leírását az alábbi címről tölthetik le: http://occsz.ecegjegyzek.hu/info/page/schema/2006/xmloccsz_v6_20140315.xsd A listázások eredmény XML dokumentumának gyökéreleme a Cégjegyzék tag, ezen belül találhatók a Kérelem vagy Kiadmány tag található, amelyek pontos belső felépítését a fenti XSD dokumentum írja le. 2.3.3 Aláírt listák alairt=[eszignoval kozokirat] Egy-egy, pl. a keresési eredmény lista alapján kiválasztott cég névjegye, cégkivonata, stb. lekérhető aláírt formában is, ekkor a lekérdezés eredménye egy.es3 kiterjesztésű fájl lesz, amely az e-szignó program, vagy más, a MELASZ által szabványosított e-aktákat kezelni képes program segítségével nyitható meg. Az akta az Occsz rendszer hitelesítő elektronikus aláírását, és a kért dokumentumot tartalmazza a kért formátumban (HTML vagy XML). Az elektronikus aláírásnak köszönhetően az ilyen e-akták bizonyító erejű dokumentumok. Egyes kiadmányok (cégkivonat, cégmásolat, cégbizonyítvány és névjegy) elektronikus közokirati formában is letölthetőek. Az így kapott kiadmányok a Cégszolgálat minősített tanúsítványon alapuló fokozott biztonságú aláírásával és időbélyegzővel vannak ellátva, így a 2006. évi V. törvény 17. (1) bekezdése alapján elektronikus közokiratnak minősülnek. Figyelem! A közokirati kiadmányok ára eltérhet a nem közokirati kiadmányok árától! MICROSEC Számítástechnikai Fejlesztő zrt. 7/31
Az aláírt formátumhoz a paramétert eszignoval értékre, a közokirati formához kozokirat értékre kell állítani. A paraméter alapértelmezett értéke: alairasnelkul. 2.3.4 e-akták Az e-akta egy.es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozása legegyszerűbben az e-szignó programmal történhet, amely képes ellenőrizni az aláírást, illetve feldolgozásra kiolvasni, megnyitni magát az aláírt dokumentumot. Az e-akta szabványos formátum, amely megfelel a XAdES nemzetközi szabványnak, ill. a MELASZ magyar ajánlásnak, így az aláírás ellenőrizhető, ill. az akta tartalma kiolvasható más, a fenti szabványokat támogató alkalmazás segítségével is. A Microsec zrt. automatikus feldolgozó rendszerek fejlesztéséhez lehetőséget biztosít az e- Szignó program parancssoros változatának vagy fejlesztőkészletének felhasználására is megfelelő rendszerintegrációs megállapodás keretében. Ezen lehetőséggel kapcsolatban kérjük, érdeklődjön kapcsolattartójánál. 2.3.5 Egyéb dokumentumok Előfordulnak dokumentumok, amelyek pl. lapolvasóval, PDF formátumban kerülnek a cégjegyzékbe, ezek közé tartozhatnak pl. a letölthető mérlegek. Az ilyen dokumentumok formátuma és feldolgozása a megfelelő leírások alapján történik. MICROSEC Számítástechnikai Fejlesztő zrt. 8/31
3. Elérhető szolgáltatások Az alábbi fejezetben azon lekérdezési lehetőségeket tartalmazza, amelyeket megfelelő jogosultság esetén az automata letöltő programok elérhetnek. A fejezet a továbbiakban a megadható paraméterek és az XML alapú eredmény leírásával foglalkozik, HTML alapú dokumentumok ugyanilyen módon kérhetők le az outformat megfelelő értékének (html) beállításával. 3.1 Keresések Az alábbi alfejezetek tartalmazzák a keresések során megadható paramétereket. A keresések során megadható paraméterek köre kiolvasható a WEB-es felületet használva, a megfelelő keresési típus kiválasztásával, majd a menüt tartalmazó bal oldali keret HTML forrását megtekintve. 3.1.1 Általános paraméterek Az alábbi paraméterek minden keresés során megadhatóak, megadandóak, függetlenül attól, milyen típusú adat alapján keresünk éppen a cégek között. reqtip=adat Annak érdekében, hogy ne árajánlatot, hanem magukat a szükséges adatokat kapjuk meg, a reqtip paramétert adat értékkel lehet átadni. Fontos: Amennyiben nem kerül a reqtip átadásra, a rendszer adatokat fog szolgáltatni! Fontos: Amennyiben a rendszer adatokat szolgáltat, a lekérdezés számlázva lesz! outformat=[html xml6] Az outformat paraméterrel adható meg, hogy az adatlekérdezés kimenete milyen formátumban jelenjen meg. A paraméter lehetséges értékei: html és xml6. Amennyiben ez a paraméter nem kerül átadásra, az Occsz rendszer alapértelmezetten HTML formátumot fog használni, így automata feldolgozás esetén a lekérdezéseknek mindig tartalmazniuk kell xml6 értékkel ezt a paramétert. maxnum=<egész> A maxnum paraméterrel adhatjuk meg, hogy az egyes keresések során a találati listán maximálisan hány elem jelenjen meg. A paraméter opcionális, alapértelmezett értéke 100. MICROSEC Számítástechnikai Fejlesztő zrt. 9/31
Fontos: mivel a számlázást érinti a listázott találatok száma, érdemes a fenti paraméter segítségével korlátozni a lehetséges találatok számát vagy előzetesen árajánlat kérésével tájékozódni a találatok számát illetően. hatalyos=[0 1] A hatalyos paraméter 1-es értékével szűkíthetjük le a név, székhely, adószám, valamint a személy alapú keresés eredményhalmazát a hatályos adatokra. A találati lista ebben az esetben csak azokat a cégeket tartalmazza, amelyeknél a jelenleg hatályos adatok között szerepel a keresési feltétel. Amennyiben a keresés csak hatályos adatokra irányul, az új funkció használatával a kevesebb, csak releváns találatokat tartalmazó lista a meg nem jelenő adatok miatti költségcsökkenésen túl könnyebb áttekinthetőséget is biztosít. A hatalyos paraméter alapértelmezett értéke 0, így a paraméter megadása nélkül a teljes eredményhalmazt adja vissza a keresés. 3.1.2 Kimenet felépítése <Cégjegyzék xsi:schemalocation=" "> <Kiadmány cím="céglista" forma="másolat" dátum="2008-02-18"> <CégAdatlap rovat="0" fejléc="a cég adatlapja"> <Cégjegyzékszám>0109078353</Cégjegyzékszám> <Név>MICROSEC Számítástechnikai Fejlesztő Korlátolt Felelősségű Társaság</Név> <Székhely>1022 Budapest, Marcibányi tér 9. al. 1.</Székhely> <Adószám>10589605241</Adószám> <Állapot>Hatályos</Állapot> </CégAdatlap> </Kiadmány> </Cégjegyzék> A keresések eredménye minden esetben egy Kiadmány, amelynek címe Céglista, és amely cégmásolatokat tartalmaz CégAdatlap tag-ek formájában. Az egyes bejegyzések minden esetben tartalmazzák az adott cég cégjegyzékszámát, megnevezését, székhelyének címét, valamint adószámát. Minden bejegyzésnél szerepel annak állapota, amelynek értéke lehet: Bejegyzés alatt Hatályos Törlés alatt Törölve MICROSEC Számítástechnikai Fejlesztő zrt. 10/31
Nem bejegyzett Értelemszerűen, ha a jelenleg érvényes bejegyzésekre vagyunk kíváncsiak, akkor a listának csak az Állapot=Hatályos bejegyzéseivel szabad foglalkoznunk. A Kiadmány tag tartalmazza továbbá a keresési kifejezést is, mint attribútumot. Az attribútum nevét a keresés típusa határozza meg, pl. cégjegyzékszám alapján történő keresés esetén cégjegyzékszám="0109078353", míg pl. cégnév alapú keresésnél cégnév="microsec". 3.1.3 Keresés cégjegyzékszám alapján stype=cgjszkeres bs=<két számjegy> cf=<két számjegy> n=<hat számjegy> A különböző keresési típusokat az stype paraméter különbözteti meg egymástól. Cégjegyzékszám alapú keresés esetén ennek értéke CgjszKeres. A cégjegyzékszám három részből tevődik össze, ezeket kell a különböző paraméterekben átadni. Az első két számjegy a cégbíróság száma, ez kerül a bs paraméterbe. A második két számjegy a cégformát határozza meg, ezt kell a cf paraméterben átadni. Az utolsó hat számjegy a bíróságon belüli sorszám, ez kerül az n paraméterbe. Ha tehát a cégjegyzékszám pl. 01-09-078353, akkor a lekérdezésben a bs=01, cf=09 és n=078353. Fontos: a keresés akkor és csakis akkor sikeres, ha mind a 10 számjegy meg lett adva! A keresés értelemszerűen 1 vagy 0 hatályos állapotú találatot ad vissza, azonban a listán a cég többször is előfordulhat, amennyiben a cég történetében előfordult névváltoztatás. 3.1.4 Keresés cégnév alapján stype=cgnevkeres cegnev=<kereső kifejezés> kozepen=[0 1] Minden esetben a cégnév elejét, és legalább 4 karakter hosszan kell megadni a kereséshez. A találati lista minden olyan elnevezést tartalmazni fog, amelyre illeszkedik a keresési feltétel, így ha pl. a cég cégformát váltott, vagy változott a neve, amelynek eleje változatlan maradt, az adott cégről több, de csak egyetlen hatályos állapotú lesz közöttük. Fel kell továbbá készülni a hasonló nevű cégek megjelenésére is a listán, így arra, hogy a lista több hatályos állapotú bejegyzést is tartalmazhat. A keresés alapértelmezetten csak cégnév eleji egyezőséget vizsgál, a kozepen paraméter 1-es értékével adhatjuk meg, hogy a keresés a cégnév egészén történjen, ekkor viszont előfordulhat (főleg rövid, vagy gyakori keresési minta esetén), hogy a találati lista jóval hosszabb lesz. MICROSEC Számítástechnikai Fejlesztő zrt. 11/31
3.1.5 Keresés székhely alapján stype=cgcimkeres htirsz=<négyjegyű irányítószám> htvaros=<település neve> htutca=<közterület neve> hthsz=<házszám> Minimum a település nevét meg kell adni, a többi paraméter opcionális, de értelemszerűen a találati lista használható méretűre szűkítéséhez elengedhetetlen. Az irányítószám négy számjegyből állhat, amennyiben ennél rövidebb, akkor az adott számsorral kezdődő irányítószámú címek jelennek csak meg a találati listán. A közterület megadásánál javasolt a közterület típusát (út, utca, tér stb.) kihagyni. 3.1.6 Keresés adószám alapján stype=cgadoszamkeres adoszam=<nyolc számjegyű törzsszám> Az adószámnak pontosan az első 8 számjegyét kell megadni a keresés sikeres futásához. Hasonlóan a cégjegyzékszám alapú kereséshez itt is 1 vagy 0 hatályos állapotú bejegyzés szerepelhet a találati listán. További (nem hatályos) bejegyzések akkor fordulhatnak elő, ha azonos törzsszám mellett a cég más adószámmal is rendelkezett. 3.1.7 Keresés természetes ill. jogi személy alapján stype=cgszemelykeres htname=<név> htpanev=<anyja neve> htpirsz=<lakcím irányítószám> htphely=<lakcím település> htpteru=<lakcím közterület neve> htphsz=<lakcím házszám> htadoszam=<adószám> htadoazon=<adóazonosító jel> htcur=<1. Bíróság számkódja> htcur=<n. Bíróság számkódja> Az előzőeken kívül lehetséges a társaságok tulajdonosai és tisztségviselőinek neve alapján történő keresés is. A lekérdezés paraméterei közül a név az egyetlen kötelezően megadandó paraméter, a többi opcionális. Az irányítószám legfeljebb négyjegyű, csak számokat tartalmazhat. Amennyiben négynél kevesebb számjegy kerül megadásra, az adott számsorral kezdődő irányítószámokat veszi alapul a rendszer. A közterület esetében nem javasolt a közterület típusának (út, tér stb.) megadása. MICROSEC Számítástechnikai Fejlesztő zrt. 12/31
Lehetőség van szűkíteni cégbíróság(ok)ra a keresést, amelyet ha nem adunk meg, a rendszer mind a 20 cégbíróságot lekérdezi, ami hosszabb időt is igénybe vehet. A bíróságok listáját a WEB felületen multiselect-ben lehet kijelölni, ennek megfelelően automata rendszerben a htcur paramétert akár többször is meg lehet/kell adni. A htcur paraméter lehetséges értékei kétjegyű számkódok a következő módon: 00: ország valamennyi cégbírósága 01: Fővárosi Törvényszék 02: Pécsi Törvényszék 03: Kecskeméti Törvényszék 04: Gyulai Törvényszék 05: Miskolci Törvényszék 06: Szegedi Törvényszék 07: Székesfehérvári Törvényszék 08: Győri Törvényszék 09: Debreceni Törvényszék 10: Egri Törvényszék 11: Tatabányai Törvényszék 12: Balassagyarmati Törvényszék 13: Budapest Környéki Törvényszék 14: Kaposvári Törvényszék 15: Nyíregyházi Törvényszék 16: Szolnoki Törvényszék 17: Szekszárdi Törvényszék 18: Szombathelyi Törvényszék 19: Veszprémi Törvényszék 20: Zalaegerszegi Törvényszék MICROSEC Számítástechnikai Fejlesztő zrt. 13/31
3.1.8 Összetett keresés stype = CgosszetettKeres outformat = <xml6 html> reqtip = <adat arajanlat> maxnum = <1-999 közötti szám> page = <0-nál nagyobb szám> hatalyos = <csak hatályos adatokban keressen-e, 1 vagy 0> cegjegyzekszam = <tíz számjegy> cegforma = <00,01..23 egy/több vesszővel tagolt kétjegyű szám> megye = <01,02..20 vesszővel tagolt egy/több kétjegyű szám> adoszam = <nyolc számjegyű törzsszám> cegnev = <kereső kifejezés> nevkozep = <név közepén is keressen-e, 1 vagy 0> iranyitoszam = <1234 vagy 12 vagy 1000-2000> telepules = <a település elejére illeszkedő kereső kifejezés> utca = <kereső kifejezés> hazszam = <kereső kifejezés> Az összetett keresés több rovaton alapul csak azokat a cégeket adja vissza eredményként, melyek minden beírt feltételnek megfelelnek. Az összetett keresésnél lehetőség van a találatok lapozására. Az egy oldalon lévő találatok maximális száma a maxnum paraméterben, a lekérni kívánt oldal sorszáma pedig a page paraméterben adható meg. Például maxnum=100 esetén az első 100 találat a page=1, a második 100 találat a page=2 megadásával érhető el. A cegjegyzekszam paraméter segítségével a cégjegyzékszámra lehet szűrni tíz számjegy megadásával. A cegforma paraméterben egy vagy több kétjegyű, vesszővel elválasztott számot sorolhatunk fel az eredménylistában csak azok a cégek láthatóak, melyek cégformája a felsorolásban szerepel. A cégformák kódjai a fejezet végén találhatók meg. A megye paraméterben 01-től 20-ig terjedően lehet veszővel tagolva kétjegyű megyekódokat felsorolni. A megyekódok megfeleltetése az előző fejezetben leírt táblázat alapján történik. Az adoszam paraméterbe az adószám első 8 számjegye (törzsszám) adható meg. A cegnev paraméterben a cég nevére vagy rövidített nevére lehet keresni. A kereséshez legalább 4 betű megadása szükséges. A keresés alapértelmezetten a név elején történik, név közepén történő kereséshez a nevkozep=1 paraméter megadása szükséges. MICROSEC Számítástechnikai Fejlesztő zrt. 14/31
Az iranyitoszam paraméterben irányítószámot vagy irányítószám tartományt adhatunk meg. Tartomány megadása kétféle módon lehetséges: négynél kevesebb számjegy megadásával az adott számsorral kezdődő irányítószámokat, kötőjellel elválasztva pedig az alsó és felső határ közötti irányítószámokat lehet kiválasztani. Példák: 1234, 12, 1000-2000. A hazszam, az utca és a varos paraméterrel a cég székhelye szerint lehet keresni. A keresés itt is a megfelelő adat elején történik. A cégformák számkódjai: 00: Névfoglalás 01: Vállalat 02: Szövetkezet 03: Közkereseti társaság 04: Gazdasági munkaközösség 05: Jogi személy felelősségvállalásával működő gazdasági munkaközösség 06: Betéti társaság 07: Egyesülés 08: Közös vállalat 09: Korlátolt felelősségű társaság 10: Részvénytársaság 11: Egyéni cég 12: Külföldiek magyarországi közvetlen kereskedelmi képviselete 13: Oktatói munkaközösség 14: Közhasznú társaság 15: Erdőbirtokossági társulat 16: Vízgazdálkodási társulat 17: Külföldi vállalkozás magyarországi fióktelepe 18: Végrehajtói iroda 19: Európai gazdasági egyesülés 20: Európai részvénytársaság 21: Közjegyzői iroda 22: Külföldi székhelyű európai gazdasági egyesülés magyarországi telephelye 23: Európai szövetkezet MICROSEC Számítástechnikai Fejlesztő zrt. 15/31
3.2 Kiadmányok és iratok lekérése A keresési lista, vagy egyéb módon rendelkezésre álló cégjegyzékszámok alapján lehetséges a konkrét cégek különféle kiadmányainak és iratainak a lekérdezése. Az alfejezet ezen irattípusokat veszi sorra. 3.2.1 Általános paraméterek Az alábbi paraméterek minden kiadmánykérés során megadhatóak, megadandóak, függetlenül attól, milyen típusú kiadmányt kérünk éppen le egy adott cégről. doku=<kiadmány típusa> A doku paraméterrel lehet kiválasztani a lekérni kívánt kiadmány típusát. Lehetséges értékei: Nevjegy Cegkivonat Cegmasolat Cegbizonyitvany MerlegJegyzek KozlemenyJegyzek IratJegyzek reqtip=adat Annak érdekében, hogy ne árajánlatot, hanem magukat a szükséges adatokat kapjuk meg, a reqtip paramétert adat értékkel lehet átadni. Fontos: Amennyiben nem kerül a reqtip átadásra, a rendszer adatokat fog szolgáltatni! Fontos: Amennyiben a rendszer adatokat szolgáltat, a lekérdezés számlázva lesz! outformat=[html xml6] Az outformat paraméterrel adható meg, hogy az adatlekérdezés kimenete milyen formátumban jelenjen meg. A paraméter lehetséges értékei: html és xml6. Amennyiben ez a paraméter nem kerül átadásra, az Occsz rendszer alapértelmezetten HTML formátumot fog használni, így automata feldolgozás esetén a lekérdezéseknek mindig tartalmazniuk kell xml6 értékkel ezt a paramétert. MICROSEC Számítástechnikai Fejlesztő zrt. 16/31
key=<cégjegyzékszám> Fontos: a cégjegyzékszám itt kizárólag számok sorozataként jelenik meg, elválasztó jeleket nem tartalmazhat. alairt=[alairasnelkul eszignoval kozokirat] A cégiratok alapértelmezetten HTML vagy XML formában kerülnek letöltésre elektronikus aláírás nélkül. Amennyiben bizonyító erejű e-akta formájában van szükség az adott iratra, akkor az alairt paramétert eszignoval értékre kell állítani. Ilyen esetben a lekérdezés eredménye egy.es3 kiterjesztésű fájl lesz, amely az e-szignó, vagy más MELASZ-Ready program segítségével nyitható meg. Egyes kiadmányok (cégkivonat, cégmásolat, cégbizonyítvány és névjegy) elektronikus közokirati formában is letölthetőek. Az így kapott kiadmányok a Cégszolgálat minősített tanúsítványon alapuló fokozott biztonságú aláírásával és időbélyegzővel vannak ellátva, így a 2006. évi V. törvény 17. (1) bekezdése alapján elektronikus közokiratnak minősülnek. Figyelem! A közokirati kiadmányok ára eltérhet a nem közokirati kiadmányok árától! Az aláírt formátumhoz a paramétert eszignoval értékre, a közokirati formához kozokirat értékre kell állítani. A paraméter alapértelmezett értéke: alairasnelkul. 3.2.2 Cégbizonyítvány lekérése A cégbizonyítványnak két különböző típusa van, ezek a kivonat vagy másolat, attól függően, hogy a cégbizonyítvány csak a hatályos, vagy az összes alrovatot tartalmazza. tipus=[kivonat masolat] A tipus paraméter tartalmazza, hogy a lekérni kívánt cégbizonyítvány milyen típusú. A tipus paraméter alapértelmezett értéke masolat. tlist=<rovatszám_1> tlist=<rovatszám_2> tlist=<rovatszám_n> vagy tlist=mind A kért rovatokat két féle módon lehet átadni: úgy, mintha checkbox-ok lennének egy web-es form-on, azaz minden rovathoz egy-egy tlist paramétert kell beállítani, tehát ha több MICROSEC Számítástechnikai Fejlesztő zrt. 17/31
rovatnak is szerepelnie kell a bizonyítványban, akkor több tlist paramétert is át kell adni a lekérdezésben, vagy lehetséges egyetlen tlist paraméter átadása is, amelyben vesszőkkel elválasztva lehet felsorolni a kért rovatok számait. Cégformától független rovatok esetén a rovat számát kell átadni, kivéve a 9. (tevékenységi kör) rovat esetében, ahol 901 (EÁOR kód szerint) és/vagy 902 (TEÁOR kód szerint) értéket kell átadni. A cégforma függő rovatok esetén a rovat kódját mindig négy számjegyen kell jelezni: az első két számjegy a rovat sorszáma, a második kettő pedig a cégforma kódja kell legyen, például a 0109 rovat a kft. (09-es cégforma) első rovata, azaz a kft. tagjainak adatai. Az összes rovat lekérdezéséhez a tlist paramétert mind értékre kell állítani. A tlist paraméter alapértelmezett értéke mind. 3.2.2.1 Meghatározott alrovatok lekérése Lehetőség van a rovatokon belül meghatározott alrovatok lekérdezésére. Ekkor a tlist paraméter mellé meg kell adni a lekérni kívánt alrovatok sorszámát. A rovatonként megadható paraméter nevének felépítése: <rovatszám>_sorsz. A paraméter vesszővel elválasztva tartalmazhatja a szükséges sorszámokat vagy intervallumokat. Az intervallum megadása kötőjellel történik. Példa: 2_sorsz=1,3,6-10 vagy 3_sorsz=1,2 A paraméter elhagyása esetén nem történik szűrés a rovaton belül. Fontos, hogy a tlist-ben szerepelnie kell a lekérni kívánt rovat számának. MICROSEC Számítástechnikai Fejlesztő zrt. 18/31
tlist=2,3 2_sorsz=1,3,6-10 3_sorsz=1,2 3.2.3 Kiadmány XML-ek felépítése cégmásolat, cégkivonat és cégbizonyítvány esetén <Cégjegyzék xsi:schemalocation=" "> <Kiadmány cím="kiadmány címe" forma="kivonat" dátum="2008-02-18"> <CégAdatlap rovat="0" fejléc="a cég adatlapja"> <MódosításAlatt>igen</MódosításAlatt> </CégAdatlap> <CégformátólFüggetlenAdatok> <RovatNév rovat="n" fejléc="rovat megnevezése"> <Alrovat sorszám="i" állapot="hatályos"> <AlrovatAdat1></AlrovatAdat1> <AlrovatAdat2></AlrovatAdat2> <BejegyzésKelte>1999-12-31</BejegyzésKelte> <TörlésKelte>2001-03-10</TörlésKelte> <VáltozásIdőpontja>2001-03-10</VáltozásIdőpontja> <VáltozásMegszűnése>2001-03-10</VáltozásMegszűnése> </Alrovat> </RovatNév> </CégformátólFüggetlenAdatok> <CégformátólFüggőAdatok> <RovatNév rovat="m(cf)" fejléc="rovat megnevezése"> <Alrovat sorszám="i" állapot="hatályos"> </Alrovat> </RovatNév> </CégformátólFüggőAdatok> </Kiadmány> </Cégjegyzék> 3.2.3.1 Kiadmány Minden esetben a Kiadmány attribútumai jelzik a dokumentum címét (Cégkivonat, Cégmásolat, Cégbizonyítvány), formáját (Kivonat vagy Másolat), valamint azt a dátumot, amikori érvényes állapotot tartalmazza a kiadmány. MICROSEC Számítástechnikai Fejlesztő zrt. 19/31
3.2.3.2 CégAdatlap Ez a 0. rovat akkor szerepel csak a kiadmányban, ha az adott cégnek vannak függő bejegyzési ügyei a cégbíróságon. Ha szerepel ez a bejegyzés, a tartalma fixnek tekinthető: mindig azt jelzi, hogy a cég adatai módosítás alatt állnak. 3.2.3.3 Rovatok A cég bejegyzett adatai rovatokba szedve jelennek meg a cégjegyzék adatbázisában. Minden rovatnak saját száma, elnevezése és rendeltetése van. A rovatok két csoportba sorolhatók, vannak cégformától független, és cégformától függő rovatok. A cégformától független rovatok az xml sémában Cégjegyzék Kiadmány CégformátólFüggetlenAdatok elemeiként találhatók meg, a cégforma specifikus rovatok az xml séma Cégjegyzék Kiadmány CégformátólFüggőAdatok elemeiként találhatók meg. A rovatok tag elnevezései és szöveges leírásai (fejléc) az alábbi táblázatban találhatók. A cégformától független rovatok 1-54 sorszámmal (n) rendelkezhetnek, míg a cégformától függő rovatok sorszáma 1-10(cégforma száma) alakúak (pl. 1(09) ). Minden rovat belsejében Alrovat-ok sorozata található, és ezeken belül jelennek meg az adott rovatra jellemző információk. Az alrovatoknak sorszáma és állapota van. Egy alrovat állapota lehet: Hatályos Törölve Bejegyzés alatt Törlés alatt Nem jogerős/lezárt Fellebbezett Hatályon kívül helyezett Nem jogerős/lezárt (bevitel és törlés) Fellebbezett (bevitel és törlés) Bevitel és törlés alatt Hatályon kívül helyezett (bevitel és törlés) Nem bejegyzett Nem bejegyzett (bevitel és törlés) Ellenőrzés alatt Minden alrovatban szerepel a bejegyzés kelte, valamint ha törölt állapotú, akkor szerepelhet benne a törlés kelte. Amennyiben a cégbíróság nyilvántartja a rovat adatai változásának tényleges időpontját, ezt a dátumot a változás időpontja, ill. a törlés esetében a változás megszűnése jelzi. Mind a négy dátum ÉÉÉÉ-HH-NN formátumú. MICROSEC Számítástechnikai Fejlesztő zrt. 20/31