Fejlesztői kézikönyv Occsz

Átírás

1 Számítástechnikai Fejlesztő zrt. Fejlesztői kézikönyv Occsz Az Occsz szolgáltatásainak automata rendszerekből való használata november 6. MICROSEC Számítástechnikai Fejlesztő zrt Budapest, Záhony u. 7.

2 Tartalomjegyzék BEVEZETÉS.. 3 A CÉG AZONOSÍTÁSA KIADMÁNYOK KÉRÉSÉHEZ.. 3 Keresés cégjegyzékszám vagy adószám szerint 3 Keresés a cég elnevezése szerint.. 3 Keresés természetes vagy jogi személy szerint és székhely szerint.. 4 Árajánlat kérése 4 KOMMUNIKÁCIÓS FELÜLET.. 5 SZOLGÁLTATÁSOK FELHÍVÁSA, PARAMÉTEREK ÁTADÁSA 5 KIMENET FELDOLGOZÁSA 5 HTML alapú eredmény. 5 XML alapú eredmény 6 Aláírt listák. 6 e-akták.. 7 Egyéb dokumentumok 7 ELÉRHETŐ SZOLGÁLTATÁSOK 8 KERESÉSEK 8 Általános paraméterek.. 8 Kimenet felépítése 9 Keresés cégadatok alapján.. 10 Keresés természetes ill. jogi személy alapján. 12 KIADMÁNYOK ÉS IRATOK LEKÉRÉSE 13 Általános paraméterek 13 Cégbizonyítvány lekérése. 14 Meghatározott alrovatok lekérése.. 15 Kiadmány XML-ek felépítése cégmásolat, cégkivonat és cégbizonyítvány esetén 16 Kiadmány.. 16 CégAdatlap 16 Rovatok.. 17 Kiadmány XML-ek felépítése mérlegjegyzék esetén 18 Kiadmány XML-ek felépítése közleménylista esetén 19 Kiadmány XML-ek felépítése iratjegyzék esetén 20 ÁRAJÁNLAT KÉRÉSE 21 KIADMÁNY LEKÉRDEZÉSE ÁRAJÁNLAT ALAPJÁN HTML FORMÁTUM ESETÉN. 21 KIADMÁNY LEKÉRDEZÉSE ÁRAJÁNLAT ALAPJÁN XML FORMÁTUM ESETÉN 22 CÉGFIGYELÉS. 23 PÉLDA EGY CÉGFIGYELÉS XML-RE 23 A HIBAJEGYZÉKBEN HASZNÁLT KÓDOK ÉS JELENTÉSÜK:.. 24 CÉGFIGYELÉS LÉTREHOZÁSA.. 25 FIGYELT CÉGEK LISTÁJA 25 CÉGFIGYELÉS MÓDOSÍTÁSA. 26 CÉGFIGYELÉS TÖRLÉSE.. 26 FÜGGELÉK. 27 HIBAKÓDOK LISTÁJA.. 27 MICROSEC Számítástechnikai Fejlesztő zrt. 2/28

3 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. 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. 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. 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 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.: MICROSEC Számítástechnikai Fejlesztő zrt. 3/28

4 Auto, Buda, Pest, Comp, Inter, Hung, Micro stb.)! Ezek nagyszámú találatot eredményeznek, melyeknek költsége igen magas. 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. Á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. MICROSEC Számítástechnikai Fejlesztő zrt. 4/28

5 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. 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, a kommunikáció 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évjelszó párossal) azonosítjuk. Minden esetben az alábbi címet kell a paraméterek kíséretében megszólítani: 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. Paraméterek átadása A lekérdezések paraméterei GET vagy POST lekérdezések paraméterei formájában kerülnek átadásra. A bemenő paraméterek karakterkódolását a paramencoding nevű paraméterben lehet átadni. A paraméter lehetséges értékei: iso88592 vagy utf8. Alapértelmezett értéke: iso 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. 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. MICROSEC Számítástechnikai Fejlesztő zrt. 5/28

6 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. XML alapú eredmény outformat=xml6 semaverzio= Az XML alapú kimenet használata automatikus feldolgozás esetén ajánlott. Az Occsz rendszer által szolgáltatott XML tartalmak jelenlegi adatstruktúra leírását az alábbi címről tölthetik le: A struktúra megváltozása esetén az adatok automatikusan az új séma szerint kerülnek kiszolgálásra. Egy átmeneti időszakban lehetőség van az adatok régi séma szerinti lekérdezésére, melyet a semaverzio paraméter megadásával lehet megtenni. A paraméter alapértelmezett értéke a legújabb séma verziószáma, további lehetséges értéke az átmeneti időszakban elérhető előző séma verziószáma. Az átmeneti időszak letelte után a rendszer hibát ad a régi sémaverzió szerinti kérésre. 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. Aláírt listák alairt=[alairasnelkul 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 é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. MICROSEC Számítástechnikai Fejlesztő zrt. 6/28

7 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. 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. 7/28

8 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. Keresések Az alábbi alfejezetek tartalmazzák a keresések során megadható paramétereket. Á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 arajanlat] 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. 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. MICROSEC Számítástechnikai Fejlesztő zrt. 8/28

9 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 adatokra teljesül a keresési feltétel. Amennyiben a keresés csak hatályos adatokra irányul, 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. Kimenet felépítése <Cégjegyzék xsi:schemalocation=" "> <Kiadmány cím="céglista" forma="másolat" dátum=" "> <CégAdatlap rovat="0" fejléc="a cég adatlapja"> <Cégjegyzékszám> </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> </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 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. MICROSEC Számítástechnikai Fejlesztő zrt. 9/28

10 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=" ", míg pl. cégnév alapú keresésnél cégnév="microsec". Keresés cégadatok alapján stype = Cegkereses 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, egy/több, vesszővel tagolt kétjegyű szám> megye = <01, egy/több, vesszővel tagolt 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 > telepules = <a település elejére illeszkedő kereső kifejezés> utca = <kereső kifejezés> hazszam = <kereső kifejezés> A cégadatok alapján történő keresés több rovaton alapul csak azokat a cégeket adja vissza eredményként, melyek minden beírt feltételnek megfelelnek. 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 a következő 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. MICROSEC Számítástechnikai Fejlesztő zrt. 10/28

11 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. 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, A telepules, az utca és a hazszam 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. 11/28

12 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. 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 htcur paraméterben lehet átadni vesszővel elválasztva, vagy a htcur paraméter többszöri megadásával. 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. 12/28

13 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. Á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 arajanlat] 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. 13/28

14 key=<cégjegyzékszám> vagy adoszam=<adószám> Fontos: a cégjegyzékszám és adószám itt kizárólag számok sorozataként jelenik meg, elválasztó jeleket nem tartalmazhat. Az adószám alapú lekérdezés kizárólag cégkivonat, cégmásolat, cégbizonyitvány, névjegy és mérlegjegyzék esetén használható. Adószám alapú lekérdezés során a hatalyos=1 paraméterrel lehet az élő cégjegyzékszámú cégre szűkíteni a kiadmányt. 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 é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. 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. MICROSEC Számítástechnikai Fejlesztő zrt. 14/28

15 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 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. 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. tlist=2,3 2_sorsz=1,3,6-10 3_sorsz=1,2 MICROSEC Számítástechnikai Fejlesztő zrt. 15/28

16 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=" "> <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> </BejegyzésKelte> <TörlésKelte> </TörlésKelte> <VáltozásIdőpontja> </VáltozásIdőpontja> <VáltozásMegszűnése> </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> 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. 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. MICROSEC Számítástechnikai Fejlesztő zrt. 16/28

17 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. 17/28

18 Kiadmány XML-ek felépítése mérlegjegyzék esetén <?xml version="1.0" encoding="iso "?> <Cégjegyzék > <Kiadmány cím="mérlegjegyzék" dátum=" " cégjegyzékszám=" "> <Beszámolók> <Beszámoló> <Megnevezés>Bizonylatok</Megnevezés> <IdőszakKezdete> </IdőszakKezdete> <IdőszakVége> </IdőszakVége> <KözzétételDátuma> T00:00:00</KözzétételDátuma> <Bizonylatok> <Bizonylat> <Megnevezés>Beszámoló mérlegének PDF formátumú képei</megnevezés> <Típus>application/pdf</Típus> <Kulcs> G1</Kulcs> <RaktáriSzám>Mg /08/45</RaktáriSzám> <BeszámolóAzonosító> </BeszámolóAzonosító> <Cégjegyzékszám> </Cégjegyzékszám> </Bizonylat> <Bizonylat> </Bizonylat> <Bizonylat> </Bizonylat> </Bizonylatok> </Beszámoló> <Beszámoló> <Megnevezés>Bizonylatok</Megnevezés> <IdőszakVége> </IdőszakVége> <KözzétételDátuma> T00:00:00</KözzétételDátuma> <Bizonylatok> <Bizonylat> <Megnevezés>Egyszerűsített éves beszámoló MÉRLEGE</Megnevezés> <Típus>text/html</Típus> <Kulcs> </Kulcs> <RaktáriSzám>Mg /94/29</RaktáriSzám> <Cégjegyzékszám> </Cégjegyzékszám> </Bizonylat> <Bizonylat> </Bizonylat> </Bizonylatok> </Beszámoló> </Beszámolók> </Kiadmány> </Cégjegyzék> A Bizonylat tag adatai segítenek egy adott mérleg letöltésében. Az adott mérleg formátumát a Típus jelzi szabványos MIME kódolással (text/html vagy application/pdf) jelzi. A text/html formátumú mérlegek HTML formátumban is lekérhetőek, ehhez az outformat paramétert MICROSEC Számítástechnikai Fejlesztő zrt. 18/28

19 html értékre kell állítani. Az outformat alapértelmezett értéke pdf. Figyelem! Az application/pdf formátumú mérlegeket kizárólag PDF formátumban lehet lekérni. A mérleg dokumentumok letöltése az alábbi paraméterezéssel történik: doku=merleg key=<kulcs tag tartalma> outformat=[pdf html] reqtip=[adat arajanlat] Kiadmány XML-ek felépítése közleménylista esetén <Cégjegyzék xsi:schemalocation=" "> <Kiadmány cím="közleményjegyzék" cégjegyzékszám=" " dátum=" "> <Közlemények fejléc="közzétételi közlemények"> <Alrovat sorszám="i" állapot="hatályos"> <Közlemény> </Közlemény> <Cím>Cégbírósági közlemény: Változások közzététele</cím> <KözzétételHelye> <Cégközlöny> <Szám>97/24</Szám> <Fejezet>2</Fejezet> <Oldal>15378</Oldal> </Cégközlöny> </KözzétételHelye> <KözzétételDátuma> </KözzétételDátuma> <Megjegyzés></Megjegyzés> </Alrovat> </Közlemények> </Kiadmány> </Cégjegyzék> Az egyes közlemények HTML formátumban az alábbi paraméterek megadásával tölthetők le: doku=kozlemeny key=<közlemény tag tartalma> alairt=[alairasnelkul eszignoval] reqtip=[adat arajanlat] MICROSEC Számítástechnikai Fejlesztő zrt. 19/28

20 Kiadmány XML-ek felépítése iratjegyzék esetén <Cégjegyzék xsi:schemalocation=" "> <Kiadmány cím="iratjegyzék" cégjegyzékszám=" " dátum=" "> <CégAdatlap rovat="0" fejléc="a cég adatlapja"> <MódosításAlatt>igen</MódosításAlatt> </CégAdatlap> <Cégiratok fejléc="cégiratok adatai"> <Alrovat sorszám="47" állapot="bejegyzés alatt"> <Megnevezés>I. Igazolási kérelem</megnevezés> <Megjegyzés>Bejegyzés alatt</megjegyzés> <Ügyintéző>Tóthné Perger Krisztina</Ügyintéző> <Bíró>Dr. Ribárszki E. Éva</Bíró> <IktatásDátuma> </IktatásDátuma> <OkiratHelye> irattar/2008/0215/c_u es3 </OkiratHelye> </Alrovat> <Alrovat sorszám="44" állapot="hatályos"> <Megnevezés>E. Hiánypótló végzés</megnevezés> <Megjegyzés> Hivatkozva a Cg /43 iktatószámú iratra. </Megjegyzés> <Ügyintéző>Wölcz Edit</Ügyintéző> <Bíró>Dr. Ribárszki E. Éva</Bíró> <IktatásDátuma> </IktatásDátuma> <JogerősítésDátuma> </JogerősítésDátuma> <OkiratHelye> irattar/2007/1220/c_u v.es3 </OkiratHelye> </Alrovat> </Cégiratok> </Kiadmány> </Cégjegyzék> Az egyes iratok lekérése az alábbi paraméterek megadásával lehetséges: doku=cegirat key=<okirathelye tag tartalma> reqtip=adat MICROSEC Számítástechnikai Fejlesztő zrt. 20/28

21 Árajánlat kérése reqtip=arajanlat Az egyes adatlekérdezések megjelennek az adott felhasználó számláján. Annak érdekében, hogy az ügyfél kézben tarthassa kiadásait, egy-egy lekérdezés előtt a lekérdezés paramétereit megadva, és a reqtip paramétert arajanlat értékre állítva lekérdezheti, mennyibe fog kerülni a kiválasztott adatok letöltése. Az árajánlat kérés paraméterezése teljes mértékben megegyezik a kiadmány lekérdezés paraméterezésével (3.2. fejezet), azzal a különbséggel, hogy a reqtip paramétert arajanlat értékre kell állítani. Az árajánlat lekérdezhető HTML és XML formátumban is. Az árajánlat formátuma alapértelmezetten HTML. Az XML formátumú árajánlat lekérdezéséhez az előzőeken kívül be kell állítani a format paramétert is. format=xml Amennyiben a számlán nincs megfelelő fedezet a kiadmány lekérdezéséhez, abban az esetben árajánlat típusú válaszként fog ez megjelenni, ezért a format paraméter értékét a kiadmányok árajánlat nélküli lekérdezése esetén is érdemes beállítani a megfelelő formátumú árajánlathoz. Kiadmány lekérdezése árajánlat alapján HTML formátum esetén Automata feldolgozás esetén lehetséges az árajánlat humán átnézés céljára történő eltárolás, valamint a HTML kódból kinyerhető pár fontos információ, mint az árajánlatot kérő felhasználó neve, keresés esetén a találatok száma, a kiadmány mérete, valamint az árajánlat összege. Az árajánlatot kérte: <b>orvos Péter</b>. Kiadmány: <B>Cégkeresés</B><BR> Találatok száma: <B>6</B><BR> A kiadmány mérete: <B>2172</B><BR> <B>Összesen: HUF</B> <INPUT TYPE=hidden NAME=file_name VALUE=usrdata/25878_ _151441_8203> Értelemszerűen a <b> </b> közötti adatokat érdemes kiolvasni, és az ezeket megelőző szövegek tekinthetőek fix kiigazodási alapnak. Fontos továbbá a form elem értéke is, ugyanis ha valamilyen dokumentumról vagy keresési végeredményről árajánlatot kértünk, akkor azt a kiadmányt az árajánlatban szereplő azonosító alapján az árajánlatkérés időpontját követő 24 órában akár többször is letölthetjük, miközben a rendszer csak az első lekérdezést számlázza. Az árajánlat alapján történő kiadmány lekérdezések paraméterezése a következő. MICROSEC Számítástechnikai Fejlesztő zrt. 21/28

22 file_name=<árajánlatból> Kiadmány lekérdezése árajánlat alapján XML formátum esetén Az XML árajánlat tartalmazza a HTML árajánlaton található összes információt, azonban automaták számára könnyebben feldolgozható, így az adatok kinyerése is lényegesen egyszerűbb. Az XML formátuma a következő. <Árajánlat> <Státusz kód="0">nincs számlázva</státusz> <Ártáblázat> <Összesen> <Végösszeg>317.50</Végösszeg> </Összesen> </Ártáblázat> <ÁrajánlatMime>text/xml xml</árajánlatmime> <ÁrajánlatUrl> 1_25143 </ÁrajánlatUrl> <Árajánlat> Az árajánlat összege az Árajánlat Ártáblázat Összesen Végösszeg elemben, a kiadmány lekérdezéséhez szükséges URL pedig az Árajánlat ÁrajánlatUrl elemben található. Az Áraánlat Státusz elemben lévő kód attribútum 3 különböző értéket vehet fel: - 0: az árajánlat még nem lett számlázva; a kiadmány 24 órán belül többször is lekérdezhető, miközben számlázás csak az első lekérdezés után történik - 1: nincs megfelelő fedezet a számlán a lekérdezéshez - 2: a szolgáltatónak nincs megfelelő fedezete a lekérdezéshez Utóbbi két esetben a kiadmány a számlával kapcsolatos probléma rendezése után kérhető le. MICROSEC Számítástechnikai Fejlesztő zrt. 22/28

23 Cégfigyelés Az IM Online rendszer lehetőséget biztosít arra, hogy felhasználói egyes cégek beállítható adatainak változásáról alapú értesítést kérhessenek, ezt a szolgáltatást nevezzük cégfigyelésnek. A szolgáltatás havi díjas: figyelt cégenként számlázunk, a ténylegesen kiküldött üzenetek díjmentesek. A cégfigyeléssel kapcsolatos műveletekre XML válasz érkezik, melynek belseje két fő részre bontható: a műveletre, ami megmutatja: mi volt a kérés sikerült-e teljesíteni milyen paramétereket kapott az automata a kérés fogadásakor milyen hibák fordultak elő, ami miatt a művelet nem sikerült az érintett cégfigyelések listájára, ami az egyes figyelések tulajdonságait tartalmazza: a cégfigyelés azonosító számát (ez szükséges a törléshez és a módosításhoz) a figyelt cég cégjegyzékszámát a figyelés leírását, ami a cégnévből és a székhelyéből áll az címet, ahova a cégadatokban történt változásról értesítést küldünk a figyelt események kódjait a figyelés kezdetét és ha van, akkor a figyelés végét Példa egy cégfigyelés xml-re <?xml version="1.0" encoding="utf-8"?> <Cégfigyelések > <Művelet> <Típus>listázás</Típus> <Sikeres>igen</Sikeres> <Paraméterek> <Paraméter név="datum">2016/04/07</paraméter> <Paraméter név="doku">cegfigyeles</paraméter> <Paraméter név="maxnum">30</paraméter> <Paraméter név="muvelet">listazas</paraméter> <Paraméter név="page">1</paraméter> </Paraméterek> <Hibajegyzék> <Hiba kód="33" sorszám="1 >Kérem adjon meg érvényes e- mail címet. (a@b)</hiba> </Hibajegyzék> </Művelet> <Figyelések száma="3" oldalszám="1" összes_találat="3" kezdősorszám="1" végsorszám="3"> <Cégfigyelés sorszám="1"> <Azonosító>31888</Azonosító> <Cégjegyzékszám> </Cégjegyzékszám> <Leírás>MOTOR-SPECIÁL Ker (2660 Balassagyarmat, Ady E MICROSEC Számítástechnikai Fejlesztő zrt. 23/28

24 út 47.)</Leírás> <Események> <Esemény kód="1">új társaságok bejegyzése</esemény> <Esemény kód="2">változások közzététele</esemény> <Esemény kód="cegjegyzek">cégfigyelés változások</esemény> </Események> <Kezdete> </Kezdete> </Cégfigyelés> </Figyelések> </Cégfigyelések> A hibajegyzékben használt kódok és jelentésük: 1 A cégfigyelést nem regisztráltuk. Nincs fedezete a folyószámláján! 2 A cégfigyelést nem regisztráltuk, mert az már szerepel az Ön cégfigyelései között! 3 A cég nem élő, ezért a figyelést nem regisztráltuk! 4 Az adatigényt nem regisztráltuk! 5 Az adatigényt nem regisztráltuk! 6 Az adatigényt nem regisztráltuk! 7 A cégfigyelés NEM hatályos, vagyis nem lehet még egyszer törölni! 8 A cégfigyelések táblában nem létezik ilyen azonosítójú figyelés. 9 A cégfigyelés módosítása nem sikerült. 10 a cégfigyelés hatályosság vége frissítés sikertelen volt. 11 A cégfigyeles tulajdonosa nem a megadott felhasználó. 12 A dátum nem lehet a mainál régebbi. 30 A a céget azonosító kulcs csak számjegyet tartalmazhat és nem lehet üres. 31 A figyelt esemény csak számjegyeket, vagy a 'cegjegyzek' szót tartalmazhatja. 32 Kérem adja meg a figyelendő eseményt - ön jelenleg semmit sem adott meg. 33 Kérem adjon meg érvényes címet. 34 A felhasználó azonosítója csak számjegyeket tartalmazhat! 35 A figyelés azonosítója csak számjegyeket tartalmazhat! 36 A hatályossag vége csak számjegyeket tartalmazhat! 37 Nem érvényes dátum. 38 A 'page' paraméter csak számot tartalmazhat. 39 A 'maxnum' paraméter csak számot tartalmazhat. 40 A cégfigyelés kulcsa csak szám lehet! 41 Két eltérő címet adjon meg! 42 A cégfigyelés létrehozásához használt kulcs nem megfelelő hosszúságú! MICROSEC Számítástechnikai Fejlesztő zrt. 24/28

25 Cégfigyelés létrehozása doku = Cegfigyeles muvelet = letrehozas KEY = <cégjegyzékszám> esemeny = <1,2,3,4,5,6,7,8,cegjegyzek> = <értesítési cím> A cégjegyzékszám csak számjegyeket tartalmazhat. A lentebb felsorolt eseménykód értékekből egyszerre több is megadható, két módon: vagy többször szerepel az esemeny paraméter a kérésben egy-egy kódot megadva, vagy lehetőség van a kívánt kódok vesszővel elválasztott lista formájában történő megadására is. Az események felsorolásánál a cegjegyzek ékezetek nélkül irandó ez egy lehetséges értéke az esemenynek. Lehetséges esemény kódok: 1 Új társaságok bejegyzése 2 Változások közzététele 3 Elutasító, kijavító és egyéb végzések 4 Végelszámolási eljárások 5 Törlések (megszűnések, egyszerűsített végelszámolások) 6 Csődeljárások 7 Felszámolási eljárások 8 Kényszertörlési eljárások cegjegyzek cégjegyzék adat változás Figyelt cégek listája doku = Cegfigyeles muvelet = listazas datum = <ééééhhnn> cegnev = <cégnevekre szűrés> cjsz = <1209> = < címre szűrés> page = <kért oldal száma> maxnum = <egy oldalon max. ennyi figyelés lehet> Tetszőleges időpontra lekérdezhető, hogy akkor mely cégek milyen adatait figyeltette a felhasználó. Hasonló módon szűkíthetjük a listát, ha megadjuk a cégnév vagy cégjegyzékszám kezdetét, valamit szűrhetjük a listát az értesítési cím alapján is. Opcionális paraméterek alapértelmezett értékei, ha nem adjuk meg őket: page = 1 maxnum = 100 datum = mai dátum ha cegnev, cjsz vagy értékét nem adjuk meg, akkor nem történik szűrés MICROSEC Számítástechnikai Fejlesztő zrt. 25/28

26 Ha részletekben kérjük a figyelt cégek listáját, az oldalszám mutatja meg, hogy a teljes válasz tartományban hol helyezkedik el az aktuális válasz. Ha 73 cégfigyelésünk van összesen, és tizesével kérjük le őket a rendszerből, akkor válaszonként / oldalanként 10 elem, az utolsó oldalon 3 elem lesz található. A kezdősorszám és a végsorszám a jelenlegi xml fájlban listázott első és utolsó cégfigyelés sorszámát tartalmazza. Cégfigyelés módosítása A módosítás egy figyelés törléséből és új adatokkal való felvételéből áll azért, hogy a cégfigyelések változása visszakövethető legyen. Az esemeny és paraméterek megadása nem kötelező a törlés után létrejövő új figyelésben alapértelmezettként a törölt figyelés tulajdonságai jönnek létre. Például ha nem adjuk meg az paramétert, a törölt figyelés paramétere lesz az új figyelésben is. Mivel egy cégfigyelés módosítása a törlés és létrehozás elemi lépésekből áll, ezért a hibaüzeneteknél a módosításhoz szükséges törlés és létrehozás során keletkezett üzenetek láthatók. doku = Cegfigyeles muvelet = modositas KEY = <a cégfigyelés azonosítója> esemeny = <1,2,3,4,5,6,7,8,cegjegyzek> = <értesítési cím> A fenti paraméterek megadásával át lehet irányítani az értesítési üzeneteket egy másik címre. A KEY paraméter értéke megegyezik a figyelések listázásakor kiolvasható azonosítóval. Cégfigyelés törlése doku = Cegfigyeles muvelet = torles KEY = <a cégfigyelés azonosítója> A KEY paraméter a listázás során kiolvasható azonosító. MICROSEC Számítástechnikai Fejlesztő zrt. 26/28

27 Függelék Hibakódok listája Kód Leírás 1 Elfelejtett céget választani! 2 A keresési minta túl rövid. Adjon meg hosszabbat (min. 4 karakter)! 9 Az Ön által megadott cégjegyzékszám első két számjegye hibás. 10 Az Ön által megadott cégjegyzékszám második két számjegye hibás. 11 Elfelejtett a kereséshez adatokat adni! 12 A bíróság jelenleg nem fogad ügyfeleket. 13 A bíróság az országos távközlési hálózat túlterheltsége miatt elérhetetlen. Próbálkozzon később! 15 napján óra perckor kezdetű cégnév a cégnyilvántartásban nem szerepel. 16 A Cégnyilvántartási és Céginformációs rendszerben cégjegyzékszámon nincs nyilvántartott adat. 20 Az Ön által megadott cégjegyzékszámban a sorszám hibás. 22 Elfelejtett azonosító adatokat megadni! 25 Nincs megfelelő jogosítványa a művelet elvégzéséhez! 32 Elfelejtett bíróságot választani! 34 A megjelölt gazdasági társasággal kapcsolatosan nincs nyilvántartott közzétételi közlemény. 41 A találatok száma nagyobb, mint amit Ön kért, vagy amit a rendszer megenged az Ön számára. 54 A találatok száma nagyobb, mint amit a rendszer megenged az Ön számára. 58 Hibás dátumot adott meg! 60 Elfelejtett listaelemet választani! 81 Elfelejtett adat(oka)t kijelölni! 89 Elfelejtette a törzsszámot megadni! 90 napján óra perckor kezdetű adószám a cégnyilvántartásban nem szerepel. 91 Nincs kezdetű cég- vagy személynév a cégnyilvántartásban. 94 A Cégnyilvántartási és Céginformációs rendszerben a megadott feltételekkel nincs nyilvántartott adat. 111 Elfelejtett cégbíróságot választani, vagy rosszul adta meg a cégbíróság nevét 112 Hibás a cégjegyzékszám 114 Elfelejtett cégnevet adni, vagy a keresési minta túl rövid! 115 Elfelejtett nevet adni, vagy a keresési minta túl rövid! 117 A mérlegtár nem elérhető! 121 napján óra perckor a megadott feltételekkel a cégnyilvántartásban nincs nyilvántartott adat. 122 napján óra perckor kezdetű adószám a cégnyilvántartásban nem szerepel. Próbálja a céget más adatok alapján (név, cégjegyzékszám stb.) azonosítani! 123 napján óra perckor cégjegyzékszámú cég a cégnyilvántartásban nem szerepel. 126 Hibásan adta meg a törzsszámot! A törzsszámnak 8 számjegyet kell tartalmaznia! 127 A kiválasztott adat nem elérhető (például már törölték)! 128 Az árajánlatokat 24 óráig őrizzük meg. Az Ön által kért árajánlat már elavult, így nem kérhető le! 129 napján óra perckor kezdetű cégnév a cégnyilvántartásban nem szerepel. 130 Elfelejtett céget választani! 131 Az Ön szolgáltatója jelenleg nem használhatja a rendszert, így Ön sem! Forduljon a szolgáltatójához! MICROSEC Számítástechnikai Fejlesztő zrt. 27/28

28 132 A bejelentkezett és a kijelölt felhasználó különbözik! A kért szolgáltatást csak a bejelentkezett felhasználó veheti igénybe! 133 Nincs bejelentkezett felhasználó! A kért szolgáltatást csak bejelentkezett felhasználó veheti igénybe! 134 Nincs megadva se keresés típus, sem kiadmány! A feladat nem értelmezett! 135 Az Ön által kiválasztott kiadmány nem kérhető xml formátumban! 136 Az Ön által kiválasztott keresési típus nem kérhető xml formátumban! 137 Az Ön által kiválasztott kiadmány csak magyar nyelven kérhető 138 A rendszer pillanatnyi túlterheltsége miatt nem tudja Önt kiszolgálni! Ismételje meg a kérését néhány másodperc múlva 139 Az Ön kapott szolgáltatásai között nincs, ezért nincs joga a kért művelet elvégzéséhez! 140 Hibás találatok száma. A találatok maximális számának 1 és 999 közé kell esnie! 141 Ön vagy szolgáltatója nem jogosult a rendszer használatára! 142 Nincs megadva az irányítószám, a település nevéből legalább karakter megadása szükséges. 143 A cégforma kód hibás (cégjegyzékszámban a harmadik és negyedik számjegy). 144 A bíróság száma hibás (a megyekód)! 145 Az adószám első 8 számjegye hibásan van megadva (törzsszám)! 146 Az irányítószám mezőben megadott intervallum hibás! 147 A találatok száma nagyobb, mint amit a rendszer megenged (500 db). Kérjük, szűkítse a keresési feltételeket! 148 A cégjegyzékszámú cég adószám regisztráció alatt áll, az adatai nem megjeleníthetők. 149 Az Ön által megadott adóazonosító szám hibás! 150 Csak egy, tíz számjegyből álló cégjegyzékszámot adhat meg! 151 Nem megengedett XML sémaverzió! : e-szignó hibák MICROSEC Számítástechnikai Fejlesztő zrt. 28/28