fejlesztői kézikönyv – occsz - e-cegjegyzek.hue-akták az e-akta egy .es3 kiterjesztésű...
Post on 30-Sep-2020
6 Views
Preview:
TRANSCRIPT
Számítástechnikai Fejlesztő zrt.
Fejlesztői kézikönyv – Occsz
Az Occsz szolgáltatásainak automata rendszerekből való használata
2019. szeptember 12.
MICROSEC Számítástechnikai Fejlesztő zrt.
1033 Budapest, Ángel Sanz Briz út 13.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 2/28
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
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 3/28
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év-
re bukkan a rendszer, amelynek kezdete illeszkedik a hosszabb megadott mintára. Itt jegyez-
zü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 hi-
bá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 ered-
mé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.:
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 4/28
Auto, Buda, Pest, Comp, Inter, Hung, Micro stb.)! Ezek nagyszámú találatot eredményez-
nek, 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égjegy-
zé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.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 5/28
Kommunikációs felület
Az alábbi fejezet azt mutatja be, hogy az Occsz rendszerrel milyen kommunikációs protokol-
lok 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 proto-
kollon belül definiált, jelszó alapú Basic Authentication módszerrel (felhasználónév-jelszó
párossal) azonosítjuk. 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 se-
gí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: iso88592.
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 adato-
kat, 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 au-
tomatikusan, 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
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 6/28
é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=20180901
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:
http://occsz.e-
cegjegyzek.hu/info/page/schema/2006/XmlOccsz_v6_20180901.xsd
A struktúra megváltozása esetén az adatok automatikusan az új séma szerint kerülnek kiszol-
gá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émaver-
zió 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. le-
ké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 elekt-
ronikus 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özok-
irati 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.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 7/28
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, il-
letve 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án-
lá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 megfe-
lelő rendszerintegrációs megállapodás keretében. Ezen lehetőséggel kapcsolatban kérjük, ér-
deklődjön kapcsolattartójánál.
Egyéb dokumentumok
Előfordulnak dokumentumok, amelyek pl. lapolvasóval, PDF formátumban kerülnek a cég-
jegyzé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.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 8/28
Elérhető szolgáltatások
Az alábbi fejezetben azon lekérdezési lehetőségeket tartalmazza, amelyeket megfelelő jogo-
sultság esetén az automata letöltő programok elérhetnek. A fejezet a továbbiakban a megadha-
tó paraméterek és az XML alapú eredmény leírásával foglalkozik, HTML alapú dokumentu-
mok 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átum-
ban 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ít-
ségével korlátozni a lehetséges találatok számát vagy előzetesen árajánlat kérésével tájékozód-
ni a találatok számát illetően.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 9/28
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="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, va-
lamint 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.
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
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 10/28
cégjegyzékszám="0109078353", 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,01..23 egy/több, vesszővel tagolt kétjegyű szám>
megye = <01,02..20 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 1000-2000>
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 max-
num 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 sze-
repel. 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.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 11/28
A cegnev paraméterben a cég nevére vagy rövidített nevére lehet keresni. A kereséshez leg-
alább 4 betű megadása szükséges. A keresés alapértelmezetten a név elején történik, név köze-
pé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, 1000-2000.
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
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 12/28
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ör-
ténő keresés is. A lekérdezés paraméterei közül a név az egyetlen kötelezően megadandó pa-
raméter, a többi opcionális.
Az irányítószám legfeljebb négyjegyű, csak számokat tartalmazhat. Amennyiben négynél ke-
vesebb 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
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 13/28
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ípu-
sokat 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|pdf]
Az outformat paraméterrel adható meg, hogy az adatlekérdezés kimenete milyen formátum-
ban jelenjen meg. A paraméter lehetséges értékei: html, az xml6 és a pdf – utóbbi csak
Névjegy, Cégkivonat, Cégmásolat és Cégbizonyítvány esetében választható. 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.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 14/28
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, ak-
kor az alairt paramétert eszignoval értékre kell állítani. Ilyen esetben a lekérdezés ered-
ménye egy .es3 kiterjesztésű fájl lesz, amely az e-Szignó, vagy más MELASZ-Ready prog-
ram segítségével nyitható meg.
Egyes kiadmányok (cégkivonat, cégmásolat, cégbizonyítvány és névjegy) elektronikus közok-
irati 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.
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 ti-
pus paraméter alapértelmezett értéke masolat.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 15/28
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 rovat-
nak is szerepelnie kell a bizonyítványban, akkor több tlist paramétert is át kell adni a lekér-
dezé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 je-
lezni: az első két számjegy a rovat sorszáma, a második kettő pedig a cégforma kódja kell le-
gyen, 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 para-
mé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 pa-
ramé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 tartal-
mazhatja 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
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 16/28
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>
Kiadmány
Minden esetben a Kiadmány attribútumai jelzik a dokumentum címét (Cégkivonat, Cégmáso-
lat, 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 jel-
zi, hogy a cég adatai módosítás alatt állnak.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 17/28
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, van-
nak 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ég-
formá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ény-
leges 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ú.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 18/28
Kiadmány XML-ek felépítése mérlegjegyzék esetén
<?xml version="1.0" encoding="ISO-8859-2"?>
<Cégjegyzék ...>
<Kiadmány cím="Mérlegjegyzék" dátum="2017-01-05" cégjegyzék-
szám="0109078353">
<Beszámolók>
<Beszámoló>
<Megnevezés>Bizonylatok</Megnevezés>
<IdőszakKezdete>2008-01-01</IdőszakKezdete>
<IdőszakVége>2008-12-31</IdőszakVége>
<KözzétételDátuma>2009-11-24T00: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>052747084501100G1</Kulcs>
<RaktáriSzám>Mg.05-2747/08/45</RaktáriSzám>
<BeszámolóAzonosító>11801207</BeszámolóAzonosító>
<Cégjegyzékszám>0109078353</Cégjegyzékszám>
<XmlFormátum>true</XmlFormátum>
</Bizonylat>
<Bizonylat>
...
</Bizonylat>
<Bizonylat>
...
</Bizonylat>
</Bizonylatok>
</Beszámoló>
...
<Beszámoló>
<Megnevezés>Bizonylatok</Megnevezés>
<IdőszakVége>1994-12-31</IdőszakVége>
<KözzétételDátuma>1995-05-31T00:00:00</KözzétételDátuma>
<Bizonylatok>
<Bizonylat>
<Megnevezés>Egyszerűsített éves beszámoló MÉRLE-
GE</Megnevezés>
<Típus>text/html</Típus>
<Kulcs>01024094290010021</Kulcs>
<RaktáriSzám>Mg.01-0240/94/29</RaktáriSzám>
<Cégjegyzékszám>0109078353</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). A text/html formá-
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 19/28
tumú mérlegek HTML formátumban is lekérhetőek, ehhez az outformat paramétert html
értékre kell állítani. Az outformat alapértelmezett értéke pdf. Figyelem! Az application/pdf
formátumú mérlegeket nem lehet HTML formátumban lekérni. Lehetséges a mérlegek xml
formátumban történő lekérdezése is, amennyiben az XmlFormátum igaz értékkel megtalálható
a bizonylat elemen belül. Az xml mérlegek sémadefiníciója az alábbi url-en érhető el: http://e-
beszamolo.im.gov.hu/fejlesztoknek.
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|xml]
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="0109078353"
dátum="2008-02-22">
<Közlemények fejléc="Közzétételi közlemények">
<Alrovat sorszám="i" állapot="Hatályos">
<Közlemény>009705240400001.103</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>1997-06-12</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]
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 20/28
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="0109078353"
dátum="2008-02-22">
<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>2008-02-14</IktatásDátuma>
<OkiratHelye>
irattar/2008/0215/C_u50109078353000470.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.0109078353/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>2007-12-18</IktatásDátuma>
<JogerősítésDátuma>2007-12-18</JogerősítésDátuma>
<OkiratHelye>
irattar/2007/1220/C_u5010907835300044v.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
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 21/28
Á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 ke-
rü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 para-
mé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értel-
mezetten HTML. Az XML formátumú árajánlat lekérdezéséhez az előzőeken kívül be kell ál-
lí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.
Figyelem: PDF formátumú kiadmányok letöltése esetén az árajánlat lekérdezésekor is szüksé-
ges az outformat=pdf paraméter megadása.
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ő felhasz-
ná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: 0.00.-HUF</B>
...
<INPUT TYPE=hidden NAME=file_name VALUE=usrdata/25878_20080304_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.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 22/28
Az árajánlat alapján történő kiadmány lekérdezések paraméterezése a következő.
https://occsz.e-cegjegyzek.hu/Occsz_Html_ReadAjanlat
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 au-
tomaták számára könnyebben feldolgozható, így az adatok kinyerése is lényegesen egysze-
rű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>
https://occsz.e-
cegjegy-
zek.hu/Occsz_Html_ReadAjanlat?file_name=usrdata/33515_20130910_143951_25143
</ÁrajánlatUrl>
<Árajánlat>
Az árajánlat összege az Árajánlat Ártáblázat Összesen Végösszeg elemben, a kiad-
má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érdez-
hető, 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.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 23/28
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 e-mail alapú értesítést kérhessenek, ezt a szolgáltatást nevezzük cégfi-
gyelésnek. A szolgáltatás havi díjas: figyelt cégenként számlázunk, a ténylegesen kiküldött e-
mail ü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 email 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ősor-
szám="1" végsorszám="3">
<Cégfigyelés sorszám="1">
<Azonosító>31888</Azonosító>
<Cégjegyzékszám>1209004609</Cégjegyzékszám>
<Leírás>MOTOR-SPECIÁL Ker... (2660 Balassagyarmat, Ady E
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 24/28
út 47.)</Leírás>
<Email>nyirobalazs@microsec.hu</Email>
<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>2016-04-07</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 e-mail 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ő email címet adjon meg!
42 A cégfigyelés létrehozásához használt kulcs nem megfelelő hosszúságú!
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 25/28
Cégfigyelés létrehozása
https://occsz.e-cegjegyzek.hu/IMOnline
doku = Cegfigyeles
muvelet = letrehozas
KEY = <cégjegyzékszám>
esemeny = <1,2,3,4,5,6,7,8,cegjegyzek>
email = <é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él-
kü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
https://occsz.e-cegjegyzek.hu/IMOnline
doku = Cegfigyeles
muvelet = listazas
datum = <ééééhhnn>
cegnev = <cégnevekre szűrés>
cjsz = <1209>
email = <email 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 fel-
haszná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 e-mail 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 email értékét nem adjuk meg, akkor nem történik szűrés
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 26/28
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 ti-
zesével kérjük le őket a rendszerből, akkor válaszonként / oldalanként 10 elem, az utolsó olda-
lon 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égfi-
gyelések változása visszakövethető legyen. Az esemeny és email 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 tu-
lajdonságai jönnek létre. Például ha nem adjuk meg az email paramétert, a törölt figyelés
email 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üze-
neteknél a módosításhoz szükséges törlés és létrehozás során keletkezett üzenetek láthatók.
https://occsz.e-cegjegyzek.hu/IMOnline
doku = Cegfigyeles
muvelet = modositas
KEY = <a cégfigyelés azonosítója>
esemeny = <1,2,3,4,5,6,7,8,cegjegyzek>
email = <é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 e-mail
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
https://occsz.e-cegjegyzek.hu/IMOnline
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ó.
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 27/28
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!
Fejlesztői kézikönyv – Occsz
MICROSEC Számítástechnikai Fejlesztő zrt. 28/28
132 A bejelentkezett és a kijelölt felhasználó különbözik! A kért szolgáltatást csak a bejelentkezett felhasz-ná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ó!
3001- 3001-3141: e-Szignó hibák
top related