Top Banner
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.
28

Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

Sep 30, 2020

Download

Documents

dariahiddleston
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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.

Page 2: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 3: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 4: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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.

Page 5: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 6: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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.

Page 7: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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.

Page 8: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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.

Page 9: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 10: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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.

Page 11: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 12: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 13: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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.

Page 14: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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.

Page 15: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 16: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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.

Page 17: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 18: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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á-

Page 19: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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]

Page 20: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 21: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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.

Page 22: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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.

Page 23: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 24: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

Fejlesztői kézikönyv – Occsz

MICROSEC Számítástechnikai Fejlesztő zrt. 24/28

út 47.)</Leírás>

<Email>[email protected]</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ú!

Page 25: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 26: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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

Page 27: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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!

Page 28: Fejlesztői kézikönyv – Occsz - e-cegjegyzek.hue-akták Az e-akta egy .es3 kiterjesztésű fájl, amely XML alapú tartalommal rendelkezik. Feldolgozá-sa legegyszerűbben az e-Szignó

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