# Cégjelző API leírás (v2)

Utolsó módosítás dátuma: 2025-10-08

# API elérési címek

Éles API endpoint: https://api.cegjelzo.com/api/v2 (opens new window)

Teszt API endpoint: https://dev.api.cegjelzo.com/api/v2 (opens new window)

Segédanyagok a teszteléshez:

  • A teszt adatbázisban szereplő vállalkozások listája:
    Elérhető a következő linken: Letöltés (Excel)
    A listában minden tesztadatbázisban megtalálható vállalkozás és azok alapadatai szerepelnek.
  • A társas vállalkozások rovat-információi:
    Letölthető innen: Letöltés (Excel)
    Ez a fájl megmutatja, hogy a teszt adatbázisban elérhető társas vállalkozások cégkivonatában mely rovatok szerepelnek, és milyen mezők fordulhatnak elő bennük. Így ha például a „képviseletre jogosultak” mezőt szeretné tesztelni, könnyen megkeresheti, mely vállalkozásoknál található meg ez a rovat, és milyen típusú adatok várhatók a válaszokban.

# Általános információk

A Cégjelző API cégek, egyéni vállalkozók, civil szervezetek és költségvetési szervek jogi illetve pénzügyi adatainak lekérdezésére szolgál. A rendszer naprakész információkat tartalmaz, így minden mező az éppen hatályos aktuális adatokat tartalmazza.

# FONTOS

A Cégjelző API nem szerződésszerű használata esetén a rendszer automatikusan korlátozza az adott ügyféltől érkező összes hívást, ezért javasoljuk hogy élesítés előtt fokozott figyelemmel nézzék át a beépített terméket.

Kvóta

Az API-ról lekérdezhető vállalkozások számát a szerződésben meghatározott havi kvóta korlátozza. A kvóta minden a Cégjelző API felé indított kérést számol, amennyiben a kérések száma meghaladja a szerződés által meghatározott mennyiséget az api Limit Exceeded üzenettel válaszol.

Amennyiben a szerződésben foglalt kvóta növelésére lenne szükség (akár csak a hónap végéig) kérjük vegy fel velünk a kapcsolatot.

Rate limit

A Cégjelző API rate limitált. Egy api kulccsal másodpercenként 30 kérés indítható. Amennyiben a kérések száma ezt meghaladja az API Limit Exceeded üzenettel válaszol, amit a következő másodpercben felold, és ismét 30 hívást enged.

URL encoding

Az API használata közben előfordul, hogy az ügyfél speciális vagy ékezetes karaktereket, illetve szóközöket vagy írásjeleket is használ egyes lekérdezések során. Ezeket kérjük minden esetben szíveskedjenek URL encode-oldva továbbítani az API felé, mivel a rendszer csak így tudja őket értelmezni.

Változások lekérdezésének ideje

Az előző nap beszerzett adatokat hajnali 3 órakor kezdjük el betölteni. Ezért az előző nap adataival frissített cégek csak hajnali 4 óra után állnak rendlekezésre. Ezt megelőzően csak a frissítés előtti adataik elérhetők.

# Integráció és tesztelés

A beépítési és tesztelési időszak alatt erősen javasoljuk a Teszt API endpoint használatát, mivel az éles endpoint-on számolódik a lekérdezések száma. A szerződésben meghatározott kvóta eseti megemelérésre csak indokolt esetben van lehetőség.

A Cégjelző Kft. fenntartja a jogot, hogy a beépítéssel kapcsolatban a megrendelőtől kérhet, kérdezhet üzleti és technikai információkat, illetve kérésre a megrendelőnek hozzáférést kell biztosítania a Cégjelző Kft. munkatársainak a beépítés ellenőrzésére.

# Teszt végpont

A teszt végpont célja, hogy segítse az integrátorok fejlesztési és tesztelési munkáját. A teszt végpont mögött futó adatbázis szerkezete megegyezik az éles adatbáziséval, azonban csak korlátozott mennyiségű (kb. 2000) vállalkozást tartalmaz.

A teszt adatbázis nem alkalmas az adatok pontosságának vagy naprakészségének ellenőrzésére, mivel egy szűkített, válogatott céglistát tartalmaz, és ezek adatai sem kerülnek frissítésre.

A teszt végpont nem használható az éles API elérhetőségének vagy működésének ellenőrzésére (health check) sem, mivel a teszt és az éles környezet teljesen egymástól független infrastruktúrán fut.

A teszt adatbázis minta vállalkozásokat tartalmaz az összes támogatott vállalkozástípusból (egyéni vállalkozó, társas vállalkozás, civil szervezet, költségvetési szerv, őstermelő). Ha az integrátor ezeket a típusokat is szeretné tesztelni, érdemes a vállalkozáslistát tartalmazó fájlt átnézni, és néhány megfelelő vállalkozást kiválasztani a tesztelésekhez.

A tesztadatokkal kapcsolatban két segédanyag érhető el:

  • A teszt adatbázisban szereplő vállalkozások listája:
    Elérhető a következő linken: Letöltés (Excel)
    A listában minden tesztadatbázisban megtalálható vállalkozás és azok alapadatai szerepelnek.
  • A társas vállalkozások rovat-információi:
    Letölthető innen: Letöltés (Excel)
    Ez a fájl megmutatja, hogy a teszt adatbázisban elérhető társas vállalkozások cégkivonatában mely rovatok szerepelnek, és milyen mezők fordulhatnak elő bennük. Így ha például a „képviseletre jogosultak” mezőt szeretné tesztelni, könnyen megkeresheti, mely vállalkozásoknál található meg ez a rovat, és milyen típusú adatok várhatók a válaszokban.

# API végpontok

# 1. /autocomplete - Keresés név eleji egyezésre

HTTP Method: GET

Végpont: /autocomplete

URL paraméterek:

  • search: Kötelező. A kiegészíteni kívánt név, vagy név eleji töredék. Minimum hossza 3 karakter.
  • type: Opcionális. Kívánt jogi forma megadása, mellyel specifikusan egy adott társasági típusra lehet szűrni. Lehetséges értékei: companies / self_employed / civil_orgs
  • limit: Opcionális. Egész szám. Limitálja a visszaadott találatok számát. ( default: 30)
  • page: Opcionális. Több találat esetén a találati oldal sorszáma (default: 1)
  • only-active: Opcionális. 0 vagy 1 érték. Keresés csak működő entitásokra ( default: 0)

Headers (Fejléc):

  • X-Api-Key: Kötelező. Kapott Api key.

Hibaüzenetek:

Minta keresés: /autocomplete?search=c%C3%A9gjelz%C5%91&type=companies

Válasz:

{
    "result": [
        {
            "name": "Cégjelző Céginformációs Korlátolt Felelősségű Társaság",
            "collection": "companies",
            "id": 26163190,
            "address": "1124 Budapest, Kempelen Farkas utca 1. fszt. 3.",
            "full_tax_number": "26163190-2-43"
        }
    ]
}

Az autocomplete hívás is cégek esetében hosszú névre adja meg a kiegészítést. Az id paraméter a válaszban minden esetben az egyedi azonosítóját adja meg a jogi entitásoknak. Cégek esetében adótörzsszám, egyéni vállalkozóknál adótörzs- vagy teljes adószám, civil szervezetek esetében nyilvántartási szám, költségvetési szervek esetén a törzskönyvi nyilvántartási szám.

# 2. /financials-data-table - Cégek pénzügyi mutatóinak lekérdezése

HTTP Method: GET

Végpont: /financials-data-table

URL paraméterek:

  • value: Kötelező. A keresett cég adótörzsszáma

Headers (Fejléc):

  • X-Api-Key: Kötelező. Kapott Api key.
  • X-Client-Id: Kötelező. Egyedi ügyfél azonosító (pl.: CEG-0042357)

A hívás fejlécében szereplő X-Api-Key a megrendelő api kulcsa, amit minden hívásnál meg kell adni. Ez authentikálja a hívó felet.

Az X-Client-Id a kapott ügyfél azonosító, illetve tovább forgalmazás esetén a hívó ügyfél egyedi azonosítója a kapott prefix-szel.

A válasz egy objektum lista ami tartalmazza a cég feldolgozott beszámolóit, mutatók (name) szerint csoportosítva.

  • az adott mutató értékét value
  • a pénznemet currency
  • a szorzót multiplier
  • beszámoló időszakának megjelölését
    • start_date A beszámoló időszakának kezdő dátuma
    • end_date, A beszámoló időszakának vég dátuma
    • year Számolt mező, melyet az end_date dátumából képzünk

Hibaüzenetek:

Minta keresés: /financials-data-table?value=26163190

Válasz:

[
    {
        "name": "Árbevétel",
        "data": [
            {
                "value": 0,
                "year": "2014",
                "currency": "HUF",
                "multiplier": 1000,
                "start_date": "2014-01-01",
                "end_date": "2014-12-31"
            },
            {
                "value": 6799,
                "year": "2015",
                "currency": "HUF",
                "multiplier": 1000,
                "start_date": "2015-01-01",
                "end_date": "2015-12-31"
            }
        ]
    },
    {
        "name": "Egyéb bevételek",
        "data": [
            {
                "value": 0,
                "year": "2014",
                "currency": "HUF",
                "multiplier": 1000,
                "start_date": "2014-01-01",
                "end_date": "2014-12-31"
            },
            {
                "value": 0,
                "year": "2015",
                "currency": "HUF",
                "multiplier": 1000,
                "start_date": "2015-01-01",
                "end_date": "2015-12-31"
            }
        ]
    },
    {
        "name": "Adózott eredmény",
        "data": [
            {
                "value": 498,
                "year": "2014",
                "currency": "HUF",
                "multiplier": 1000,
                "start_date": "2014-01-01",
                "end_date": "2014-12-31"
            },
            {
                "value": 142,
                "year": "2015",
                "currency": "HUF",
                "multiplier": 1000,
                "start_date": "2015-01-01",
                "end_date": "2015-12-31"
            }
        ]
    }
]

# A pénzügyi végpont mezői

  • Árbevétel
  • Egyéb bevételek
  • Üzemi/üzleti eredmény
  • Adózott eredmény
  • Befektetett eszközök
  • Forgóeszközök
  • Követelések
  • Pénzeszközök
  • Eszközök összesen
  • Saját tőke
  • Hosszú lejáratú kötelezettségek
  • Rövid lejáratú kötelezettségek
  • Kötelezettségek
  • Értékcsökkenés
  • Személyi jellegű ráfordítások
  • Exportértékesítés nettó árbevétele
  • EBITDA
  • Fizetendő kamatok és kamatjellegű ráfordítások
  • Adózás előtti eredmény
  • Adófizetési kötelezettség
  • Pénzügyi műveletek eredménye
  • Tárgyi eszközök
  • Osztalék

# 3. /search - Cégek jogi adatainak lekérdezése

HTTP Method: GET

Végpont: /search

URL paraméterek:

  • value: Adó(törzs)szám, nyilvántartási szám, bejegyzett hosszú- vagy rövid név
  • type: Opcionális. Keresési érték típusának definiálása. Lehetséges értékek (tax_number, name, reg_number)
  • limit: Opcionális. Egész szám. Limitálja a visszaadott találatok számát. ( default: 30)
  • page: Opcionális. Több találat esetén a találati oldal sorszáma (default: 1)

Headers (Fejléc):

  • X-Api-Key: Kötelező. Kapott Api key.
  • X-Client-Id: Kötelező. Egyedi ügyfél azonosító (pl.: CEG-0042357)
  • X-Fields: Nem kötelező. Lista a lekérdezni kívánt mezőkről. Vesszővel elválasztott, szóközök nélkül (pl.: short_name,long_name,address). Ha nincs megadva, akkor a szerződésben foglalt mezők mindegyikét tartalmazni fogja a válasz. A teljes lista a mezőnevekről megtalálható itt.

Hibaüzenetek:

Minta keresés: /search?value=c%C3%A9gjelz%C5%91&type=name

Válasz:

[
  {
    "short_name": [
      {
        "insertion": "2017-10-25",
        "name": "Cégjelző Kft.",
        "value_hash": "fbf522bbd9b7a3d6db4f32ca2b92eb52"
      }
    ],
    "long_name": [
      {
        "insertion": "2017-10-25",
        "name": "Cégjelző Céginformációs Korlátolt Felelősségű Társaság",
        "value_hash": "22b9bcb430f89865fcd22dc100ee15cc"
      }
    ],
    "address": [
      {
        "address": "1124 Budapest, Kempelen Farkas utca 1. fszt. 3.",
        "address_zip": 1124,
        "insertion": "2017-10-25",
        "value_hash": "9190912a2071805f74b2b84470726ab8"
      }
    ]
  }
]

A hívás fejlécében szereplő X-Api-Key a megrendelő api kulcsa, amit minden hívásnál meg kell adni. Ez authentikálja a hívó felet.

Az X-Client-Id a kapott ügyfél azonosító, illetve tovább forgalmazás esetén a hívó ügyfél egyedi azonosítója a kapott prefix-szel.

A válasz tartalmazhat vegyesen céget, civil szervezetet, egyéni vállalkozót vagy költségvetési szervet is. A találatok száma alapból limitálva van 30 darabra. Ha a keresett entitás nincs benne a találati listában pontosítani kell a keresési feltételt vagy megadni egy nagyobb limit paramétert.

Névre keresés esetében minden esetben név eleji egyezést vesz csak figyelembe a rendszer, és cégek esetében a hosszú névben, illetve a rövid névben történik a keresés, civil szervezetek esetén a hosszú neves keresés lehetséges.

# 4. Bankszámla szerinti keresés

FONTOS

A bankszámlaszám szerinti keresés az új Cégjelző Kereső API része, ezért más URL-en lehet elérni.

Saját dokumentációval rendelkezik, ami tartalmazza az integrációhoz, teszteléshez szüksége információkat.
Elérni a következő linken lehet: Cégjelző Kereső API.

# 5. Kapcsolati háló

FONTOS

A kapcsolati háló az új Cégjelző Kapcsolati Háló API része, ezért más URL-en lehet elérni.

Saját dokumentációval rendelkezik, ami tartalmazza az integrációhoz, teszteléshez szüksége információkat.
Elérni a következő linken lehet: Cégjelző Kapcsolati Háló API.

# A /search végpont lekérdezhető mezői

# Cégek esetében

Jogi adatok:

Cégformától független

  • general_details - Általános cégadatok (pl. cégforma),
  • short_name - Rövid név (ha van),
  • long_name - Hosszú név,
  • foreign_name - Idegen nyelvű elnevezés,
  • address - Székhely,
  • sites - Telephely,
  • branches - Fióktelep,
  • constituent_document_date - Alapító okirat kelte,
  • main_activities - Főtevékenység(ek),
  • end_of_operation - A működés befejezésének időpontja
  • registered_capital - Jegyzett tőke,
  • representatives - Képviseletre jogosultak adatai,
  • auditors - Könyvvizsgáló adatai,
  • supervising_board_members - A felügyelőbizottsági tagok adatai
  • predecessors - A jogelőd cég(ek) adatai
  • chamber_membership - Annak a kamarának a megnevezése, melynek a cég tagja
  • statistical_code - Statisztikai számjegy
  • tax_number - Adószám (EU adószám és státus is),
  • group_tax_number - Csoportos adószámmal rendelkező cégek esetén a csoportazonosító
  • successor - A jogutód cég(ek) adatai
  • suspension_of_operation - A cég működésének felfüggesztése
  • termination - A cég megszűntnek nyilvánítása
  • successorless_termination - A jogutód nélküli megszűnés elhatározásának dátuma
  • registration_order_lawsuit - Jogerős bejegyző végzés hatályon kívül helyezése iránti per adatai
  • constituent_document_lawsuit - A létesítő okirat érvénytelenségének megállapítása iránti per adatai
  • corporate_decision_lawsuit - A társasági határozat felülvizsgálata iránti per adatai
  • bank_accounts - Számlavezető bank neve, bankszámlaszám,
  • insurance_measure - A biztosítási intézkedés adatai
  • seizure_of_property_ownership - A cég tagja (részvényese) vagyoni részesedésének lefoglalása
  • emails_and_webpages - E-mail cím és értesítési e-mail cím (ha van)
  • member_of_company_group - Az elismert vállalatcsoportban való tagság adatai
  • other_members_of_company_group - Az elismert vállalatcsoporthoz tartozó többi cég adatai
  • level_of_charity - A közhasznúsági fokozat és jogállás adatai
  • company_registration_number - Cégjegyzékszám,
  • central_administration_address - A cég központi ügyintézésének helye
  • annual_report_production - Az összevont (konszolidált) éves beszámoló készítésére vonatkozó adatok
  • other_companies_of_annual_report - Az összevont (konszolidált) éves beszámoló készítésébe bevont többi cég adatai
  • balance_sheet_date - A cég üzleti évének mérlegfordulónapja
  • property_law_practitioner - Magyar Állam tulajdonos (tag) esetén a tulajdonosi joggyakorló
  • member_with_unlimited_responsibility - A képviseletre jogosult személy, vagy minősített többséggel rendelkező tag, vagy az uralkodó tag korlátlanul felelős a cég tartozásaiért
  • language_of_company_documents - A cégiratok fordítása az Európai Unió melyik hivatalos nyelvén szerepel a cégnyilvántartásban
  • banned_member - Eltiltás hatálya alatt álló tagra, képviselőre vonatkozó adatok
  • electronic_availability - A cég hivatalos elektronikus elérhetősége
  • eu_id - Európai Egyedi Azonosító
  • freezing_of_members_property_share - A cég tagja (részvényese) vagyoni részesedésének büntetőeljárásban alkalmazott zár alá vétele
  • capital_merging_predecessors - A tőkeegyesítő jogelőd cég(ek) adatai
  • capital_merging_successors - A tőkeegyesítő jogutód cég(ek) adatai
  • public_restructuring - A nyilvános szerkezetátalakítási eljárás kezdete és befejezése

Cégformától függő

  • firm_type - A társulat típusa
  • owners_details - A cégtulajdonos adatai
  • foreign_company_details - A külföldi vállalkozás adatai
  • members_details - A tag(ok) adatai
  • office_members_details - Az iroda tagjainak adatai
  • shareholders_details - Részvényes(ek) adatai
  • acting_partner_details - A beltag(ok) adatai
  • silent_partner_details - A kültag(ok) adatai
  • foreign_company_representatives - A külföldi vállalkozás képviseletére jogosult személy vagy szerv adatai
  • firm_management_type - A vállalat irányítási formája
  • registration_authority_details - A külföldi vállalkozás cégjegyzékét (nyilvántartását) vezető bíróság, illetve hatóság megnevezése és székhelye
  • lien_details - Az üzletrészen alapított jelzálogjog adatai
  • water_company_members_details - Az ellenőrző bizottsági/felügyelő bizottsági tag(ok) adatai
  • share_details - A részvények száma és névértéke
  • share_transfer - A részvény átruházását az alapító okirat korlátozza
  • convertible_bond_details - A kibocsátott átváltoztatható kötvények száma és névértéke
  • announcement_details - A részvénytársasági hirdetmények közzétételének módja és helye
  • subscription_bond_details - A kibocsátott jegyzési jogot biztosító kötvények száma és névértéke
  • management_type - Az ügyvezetés típusa

Pénzügyi adatok:

  • revenue - Előző éves nettó árbevétel,
  • profit_after_tax - Előző éves mérleg eredmény,

Létszám adatok:

  • fin_head_count - Beszámoló létszám - a beszámolóban leadott tárgyévi létszám
  • nav_head_count - NAV Létszám - a NAV-tól rendelkezésre álló létszám adat

Számított adatok:

  • status - Státusz,
  • status_code - Státusz kód (0 - nem működő, 1 - működő, 2 - szüneteltetett)
  • head_count - Aktuális létszám - a beszámolóban leadott tárgyévi létszám és a NAV-tól szerinti létszám adat közül az amelyik frissebb
  • pending_proceedings - Van-e ellene eljárás, csak a Cégközlönyben megjelent közleményeket veszi alapul
  • finished_proceedings - Volt-e ellene eljárás, csak a Cégközlönyben megjelent közleményeket veszi alapul
  • finished_proceedings_within_five_years - Volt-e ellene eljárás az elmúlt 5 évben, csak a Cégközlönyben megjelent közleményeket veszi alapul
  • member_list - Tagok/tulajdonosok alapadatai listaszerűen
  • company_type - A vállalkozás cégformája

Eljárási adatok:

  • bankruptcy - Csőd eljárás
  • liquidation - Felszámolás
  • forced_cancellation - Kényszertörlés
  • voluntary_liquidation - Végelszámolás
  • execution - Végrehajtás
  • criminal_measure - Büntetőjogi intézkedés
  • cancellation - Megszűnés (eljárási példa adatok a 2.sz mellékeltben)

Ezen kívül kérhetőek specifikusan a hatályos eljárások, illetve társasági forma függvényében a különböző tagok adatai.

# Civil szervezetek esetében

  • registration_number - Nyilvántartási szám,
  • long_name - Bejegyzett név,
  • short_name - Rövidített név (ha van),
  • address - Székhely,
  • status - Státusz,
  • status_code - Státusz kód (0 - törölt, 1 - működő)
  • type - Szervezet típusa,
  • insertion - Bejegyzés dátuma,
  • constituent_document_date - Létesítő okirat kelte,
  • activity - Cél szerinti besorolás,
  • level_of_charity - Közhasznúsági fokozat,
  • description - Cél szerinti leírás,
  • tax_number - Adószám (ha van),
  • representatives - Képviseletre jogosultak,
  • leading_orgs - Ügyvezető szervek (ha van),
  • bank_accounts - Bankszámlaszám (ha van),
  • proceedings - Folyamatban lévő eljárások (ha van)

# Egyéni vállalkozók esetében

  • name - Név,
  • tax_number - Adószám,
  • ksh_num - KSH szám,
  • registration_num - Nyilvántartási szám,
  • main_activities - Főtevékenység(ek),
  • status - Státusz,
  • status_code - Státusz kód (0 - nem működő, 1 - működő, 2 - szüneteltetett)
  • start_date - Vállalkozói tevékenység kezdete,
  • end_cause - Megszűnésének oka (ha van),
  • end_date - Vállalkozói tevékenység megszűnésének dátuma (ha van),
  • address - Székhely (telephely ha van)

# Költségvetési szervek esetében

  • register_id - Törzskönyvi nyilvántartási azonosító (PIR),
  • name - Név,
  • address - Székhely,
  • county - Megye,
  • financial_area - Pénzügyi körzet,
  • main_activity - Alaptevékenység fő TEÁOR kódja,
  • sector - Alaptevékenység államháztartási szakágazata,
  • tax_number - Adószám,
  • ksh_number - KSH statisztikai számjel,
  • om_id - Közoktatási OM azonosító,
  • ahti_id - Államháztartási egyedi azonosító (ÁHTI),
  • leader - Vezető,
  • nominated_at - Kinevezés kezdete,
  • chapter - Fejezet,
  • founded_at - Alapítás időpontja,
  • registered_at - Törzskönyvi bejegyzés dátuma,
  • controller - Irányító / felügyelet,
  • founders_right_owner - Alapítói jog gyakorlója,
  • joint_office_members - Közös önkormányzati hivatal tagjai,
  • legal_entry_members - Jogi személyiségű társulások tagjai,
  • maintainer - Fenntartó,
  • status - Státusz,
  • status_code - Státusz kód (0 - törölt, 1 - működő)

# Negatív NAV-os adatok

  • nav_status - Csak társas vállalkozásoknál elérhető - Az adószám szerepel e a NAV szankciósan törölt listáján (valid - nem szerepel a listán, invalid - az adószám szankciósan törölt)
  • nav_status_code - Csak társas vállalkozásoknál elérhető - Az adószám szerepel e a NAV szankciósan törölt listáján (1 - nem szerepel a listán, 0 - az adószám szankciósan törölt)
  • nav_significant_debt - Az összes társasági formánál elérhető - Jelentős összegű adóhiánnyal rendelkezik a vállalkozás (true - igaz, false - hamis)
  • nav_executions - Az összes társasági formánál elérhető - Van e NAV által indított hatályos végrehajtási eljárás a vállalkozással szemben (true - van eljárás, false - nincs eljárás)
  • nav_missing_reports - Az összes társasági formánál elérhető - A NAV szerint minimum 2 ciklus óta nem adott le beszámolót (true - igaz, false - hamis)
  • nav_tax_debt - Az összes társasági formánál elérhető - Adótartozással rendelkező nem magánszemély adózók (true - igaz, false - hamis)

# Pozitív NAV-os adatok

  • nav_no_tax_debt - Az összes társasági formánál elérhető - A vállalkozás szerepel e a NAV által közzétett köztartozásmentes adózók listáján (true - igaz, false - hamis)
  • nav_trustworthy_tax_payers - Az összes társasági formánál elérhető - A vállalkozás szerepel e a NAV által közzétett megbízható adózók listáján (true - igaz, false - hamis)

# Darabolt NAV szerinti cím

Az API search végpontján elérhető a vállalkozás NAV szerinti, darabolt címe is.

FONTOS A NAV szerinti székhely cím és a közhiteles nyilvántartásban elérhető székhely cím nem minden esetben egyezik meg.

A teszt környezetben a NAV szerinti darabolt cím 4 vállalkozás esetén tesztelhető, ezek adótörzsszámai a következőek:

  • társas vállakozások (companies) - 28856395
  • egyéni vállalkozók (self_employed) - 67523340
  • civil szervezetek (civil_orgs) - 18739206
  • költségvetési szervek (budget_orgs) - 16797460

Példa válasz:

{
  "collection": "companies",
  "key": "xxx",
  "updated": "2020-11-02",
  "zip": "4031",
  "city": "DEBRECEN",
  "place_name": "ZELEMÉR",
  "place_category": "UTCA",
  "number": "36",
  "building": null,
  "staircase": null,
  "floor": null,
  "door": null,
  "parcel_number": null
}

# Csoportos adószámok

Az API search végpontján lehetőség van csoportos adószám csoport azonosítójára keresni. Továbbá, ha a keresett cég egy adócsoport tagja a válaszban megjelenik a csoport azonosítója.
Ez a funkció csak akkor elérhető, ha a kapott hozzáférési adatok erre feljogosítják a felhasználót.

# FONTOS

A teszt környezetben a csoportos adószám szerinti keresés 3 csoport esetén tesztelhető, ezek adószámai a következőek:

  • 17780010-5-44
  • 17780027-5-44
  • 17780041-5-44

# Keresés csoport azonosítóra

Amikor egy csoportos adószámmal rendelkező céghalmaz azonosítójára (ez gyakorlatilag azonos a csoportos adószám karaktersorával) keres, akkor válaszként a céghalmaz tagjainak adatait (listáját) kapja vissza.

A group_members alatti lista a csoport tagjait tartalmazza, azok számlázási adataival. Az is_representative mező jelzi, hogy az adott cég a csoport képviselője-e. Ezen entitások type mező szerinti típusa minden esetben group_tax_numbers lesz. Az egyes tagok name mezője az adott cég rövid nevét tartalmazza, amennyiben a cég rendelkezik rövid névvel, ennek hiányában az adott cég hosszú nevét.

Minta keresés: /search?value=17780041-5-44 vagy /search?value=17780041

Minta válasz:

    {
        "group_tax_number": "17780041-5-44",
        "group_members": [
            {
                "name": "Magyar Posta Biztosító Zrt.",
                "address": "1022 Budapest, Bég utca 3-5. IV. em.",
                "tax_id": 12833632,
                "tax_number": "12833632-4-44",
                "is_representative": true
            },
            {
                "name": "Magyar Posta Életbiztosító Zrt.",
                "address": "1022 Budapest, Bég u. 3-5. 4. em.",
                "tax_id": 12833625,
                "tax_number": "12833625-4-44",
                "is_representative": false
            }
        ],
        "type": "group_tax_numbers"
    }

# Keresés csoport tagra

Ha Ön olyan cég adószámára keres, amely cég egy csoportos adószámmal rendelkező céghalmaz (adócsoport) tagja, akkor a válaszban - a többi szokásos mező mellett - visszaadjuk e céghalmaz (az adócsoport) csoportazonosítóját is a group_tax_number kulcs alatt.

Minta keresés: /search?value=12833632

Minta válasz:

{
    "id": 12833632,
    "type": "companies",
    "long_name": [
        {
            "change": "2006-03-07",
            "name": "Magyar Posta Biztosító Zártkörűen Működő Részvénytársaság",
            "value_hash": "2b487ab62c6e6b88f5f8d4498d9ba256",
            "sub_heading_number": 2
        }
    ],
    "short_name": [
        {
            "change": "2006-03-07",
            "name": "Magyar Posta Biztosító Zrt.",
            "value_hash": "70c684a8659b4906c0af647beefc3845",
            "sub_heading_number": 1
        }
    ],
  "group_tax_number": "17780041-5-44"
}

# Tagok/tulajdonosok

  • member_list - A vállalkozás tagjai/tulajdonosai listaszerű felsorolása

A társas vállalkozások esetén (Kft, Bt, Rt ... stb.) a tagokat/tulajdonosokat tartalmazó mezőket a Magyar Közlöny cégformánként más-más rovatban teszi közzé. Az API /search végpontja ezt a struktúrát igyekszik követni. Mivel ez megnehezíti a tagok/tulajdonosok lekérdezését, ezért bevezettünk egy member_list mezőt. Ez a mező összegyűjti az adott cégformánál elérhető, jelenleg hatályos tagokat/tulajdonosokat és azok alapadatait listaszerűen visszaadja.

# FONTOS

  • A tulajdonosi struktúra nem minden cégforma esetén publikus (pl. Vállalat, Szövetkezet, Nyrt ... stb.), ezért ezekben az esetekben a mező értéke üres lista [] lesz.

  • Az API a hatályos adatokból számolja ezt a mezőt. A megszűnt cégeknek nincs hatályos adata, ezért ilyen esetekben a mező értéke üres lista [] lesz.

A mező formátuma az alábbi példán látható.

{
  "member_list": [
    {
      "name": "ABC Korlátolt Felelősségű Társaság", // a tag neve
      "address": "1124 Budapest, Kempelen Farkas utca 1. fszt. 3.", // a tag székhelye/címe
      "member_type": "members_details" // a tag típusa
    },
    {
      "name": "Teszt Elek",
      "address": "1065 Budapest, Révay köz 4.",
      "member_type": "members_details"
    }
  ]
}

Amennyiben ennél bővebb információra van szüksége a tagokról, akkor azt a member_type által megjelölt mező alatt érheti el. A lenti példát véve alapul, ennek a cégnek a tagjaira vonatkozó részletes adatokat a members_details mezőben lehet megtalálni.

# Cégforma

  • company_type - A társas vállalkozás cégformája

A cégnyilvántartásban egy társas vállalkozás cégformája nem képez külön rovatot, ezért a lekérdezése nehézkes lehet. Ennek megkönnyítésére vezettük be a company_type mezőt. Ebből a mezőből egyszerűen kiolvasható a cégforma magyar megnevezése.

FONTOS Az API a hatályos adatokból számolja ezt a mezőt. A megszűnt cégeknek nincs hatályos adata, ezért megszűnt cégek esetén a mező értéke null lesz.

Pl:

{
  "company_type": "Korlátolt felelősségű társaság",
}

# Eljárási pédák

# Csőd eljárás (bankruptcy)

{
  "bankruptcy": [
    {
      "case_number": "Cspk. 14-**-***",
      "change": "2015-09-22",
      "cleaned_case_number": "CSPK14*****",
      "insertion": "2015-09-24",
      "start_date": "2015-09-22",
      "sub_heading_number": 1
    }
  ]
}

# Felszámolás (liquidation)

{
  "liquidation": [
    {
      "case_number": "Fpk.***/***",
      "change": "2018-08-17",
      "cleaned_case_number": "FPK******",
      "insertion": "2018-10-01",
      "start_date": "2017-07-10",
      "sub_heading_number": 2,
      "value_hash": "4d2c24cebd320b7676102bdfec87a533"
    }
  ]
}

# Kényszertörlés (forced_cancellation)

{
  "forced_cancellation": [
    {
      "change": "2018-01-03",
      "insertion": "2018-01-26",
      "start_date": "2017-05-12",
      "sub_heading_number": 2,
      "value_hash": "d41d8cd98f00b204e9800998ecf8427e"
    }
  ]
}

# Végelszámolás (voluntary_liquidation)

{
  "voluntary_liquidation": [
    {
      "change": "2017-05-01",
      "insertion": "2018-01-30",
      "start_date": "2017-05-01",
      "sub_heading_number": 1,
      "value_hash": "d41d8cd98f00b204e9800998ecf8427e"
    }
  ]
}

# Végrehajtás (execution)

{
  "execution": [
    {
      "case_number": "458***",
      "cleaned_case_number": "458***",
      "enactor_name": "NAV Somogy Megyei Adó- és Vámigazgatósága Hátralékkezelési Osztály",
      "insertion": "2018-07-26",
      "start_date": "2018-07-26",
      "start_notice": "2018-07-26",
      "sub_heading_number": 2,
      "value_hash": "dcde8278173a72bdf9472239d1651252"
    }
  ]
}

# Büntetőjogi intézkedés (criminal_measure)

{
  "criminal_measure": [
    {
      "acting_authority": "NAV Dél-Alföldi Bűnügyi Igazgatósága",
      "case_date": "2018-09-20",
      "case_number": "610**-***/20**.bü.",
      "change": "2018-09-20",
      "cleaned_case_number": "610*****20**BÜ",
      "insertion": "2018-09-26",
      "sub_heading_number": 1,
      "value_hash": "fc44af0447d5f09984eb52b28a1c8e6e"
    }
  ]
}

# Megszűnés (cancellation)

{
  "cancellation": [
    {
      "case_number": "Cgt.01-***",
      "cleaned_case_number": "CGT01***",
      "insertion": "2018-07-16",
      "start_date": "2017-10-12",
      "sub_heading_number": 2,
      "value_hash": "6796c628426f88c1f2906cf80e62a9fa"
    }
  ]
}

# Error schema

# Általános hibaüzenetek

Ezek a hibaüzenetek a v2-es API összes végpontjára azonosak

Hiányzó vagy hibás X-Api-Key:
HTTP error code: 401

Body:

{
    "message": "Unauthorized"
}

Hiányzó X-Client-Id:
HTTP error code: 401

Body:

{
    "message": "Unauthorized"
}

Lejárt előfizetés:
HTTP error code: 403

Body:

{
  "message": "User is not authorized to access this resource with an explicit deny in an identity-based policy"
}

Végpont hiba
HTTP error code: 401

Body:

{
    "error": true,
    "message": "Permission Denied",
    "status": 401
}

# /search végpont hibaüzenetei

A fenti általános hibaüzeneteken felül a végpont az alábbi esetekben jelezhet hibát:

Hiányzó value paraméter:
HTTP error code: 400

Body:

{
  "error": true,
  "message": "'value' parameter is required. Please give some search value!",
  "status": 400
}

Value paraméter kevesebb mint 3 karakter:
HTTP error code: 400

Body:

{
  "error": true,
  "message": "'value' parameter has to be at least 3 characters long",
  "status": 400
}

Value paraméter kevesebb mint 3 karakter hosszú a speciális karakterek nélkül:
HTTP error code: 400

Body:

{
  "error": true,
  "message": "Search value has to contain at least 3 non-special or whitespace characters",
  "status": 400
}

Hibás type paraméter:
HTTP error code: 400

Body:

{
  "error": true,
  "message": "Type parameter is invalid",
  "status": 400
}

Atype=tax_number keresésnél a megadott value paraméter nem adótörzsszám:
HTTP error code: 400

Body:

{
  "error": true,
  "message": "invalid 'value' format it has to be a valid Hungarian tax number",
  "status": 400
}

Limit parameter nem szám:
HTTP error code: 400

Body:

{
    "error": true,
    "message": "'limit' has to be a positive integer value",
    "status": 400
}

Page parameter nem szám:
HTTP error code: 400

Body:

{
    "error": true,
    "message": "'page' has to be a positive integer value",
    "status": 400
}

# /autocomplete végpont hibaüzenetei

A fenti általános hibaüzeneteken felül a végpont az alábbi esetekben jelezhet hibát:

Search paraméter kevesebb mint 3 karakter hosszú:
HTTP error code: 400

Body:

{
    "error": true,
    "message": "'search' parameter has to be at least 3 characters long",
    "status": 400
}

Search paraméter kevesebb mint 3 karakter hosszú a speciális karakterek nélkül:
HTTP error code: 400

Body:

{
    "error": true,
    "message": "'search' parameter has to be at least 3 characters long",
    "status": 400
}

Limit parameter nem szám:
HTTP error code: 400

Body:

{
    "error": true,
    "message": "'limit' has to be a positive integer value",
    "status": 400
}

Page parameter nem szám:
HTTP error code: 400

Body:

{
    "error": true,
    "message": "'page' has to be a positive integer value",
    "status": 400
}

# /financials és /financials-data-table végpont hibaüzenetei

A fenti általános hibaüzeneteken felül a végpontok az alábbi esetekben jelezhetnek hibát:

Hiányzó value paraméter:
HTTP error code: 400

Body:

{
  "error": true,
  "message": "'value' parameter is required. Please give some search value!",
  "status": 400
}

Value paraméter nem 8 karakter hosszú:
HTTP error code: 400

Body:

{
  "error": true,
  "message": "'value' parameter has to be at least 8 digits",
  "status": 400
}

Value paraméter nem 8 szám:
HTTP error code: 400

Body:

{
"error": true,
"message": "'value' parameter must have a Integer value.",
"status": 400
}

# Kapcsolat

Bármilyen felmerülő kérdés, vagy pontosítás esetén az alábbi e-mail címen elérhetőek vagyunk: support@cegjelzo.hu