Alapadatok
Név, jogi forma, nyilvántartási bejegyzés, cím, tevékenységi kör, tőke és képviseleti szabályok: minden cégprofil alapadatai.
Az alapadatok azt írják le, ki egy cég: név, jogi forma, nyilvántartási bejegyzés, cím, tevékenységi kör, tőke és képviseleti szabályok. Az alapadatok részei, és minden cégprofillal megérkeznek, funkció kérése nélkül.
A legtöbb mező a Handelsregisterből (német cégnyilvántartás) és a többi hivatalos nyilvántartásból származik. Kulcsszavakat, termékeket és elérhetőségeket a webről is gyűjtünk. Hogy egy cégnek mit kell bejegyeztetnie, az a jogi formájától függ; az Elérhetőség oszlop ezt mezőnként mutatja.
Példa
Az oldal példái egy, a Hetzner Online GmbH-ra (Ansbach HRB 6089) vonatkozó példakérésből származnak. Ha a bejegyzése változik, a saját kérésed más értékeket ad vissza.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: AZ_API_KULCSOD" \ --data-urlencode 'q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "AZ_API_KULCSOD"}, params={ "q": "Hetzner Online GmbH", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "Hetzner Online GmbH"); const response = await fetch(url, { headers: { "x-api-key": "AZ_API_KULCSOD" }, }); const data = await response.json();
1{2 "entity_id": "94eb910fef13f94585c48c263fa446d4",3 "name": "Hetzner Online GmbH",4 "status": "ACTIVE",5 "legal_form": "GmbH",6 "registration": {7 "court": "Ansbach",8 "register_type": "HRB",9 "register_number": "6089"10 },11 "keywords": [12 "Dedicated Server",13 "Cloud Hosting",14 "Webhosting",15 "Colocation",16 "Object Storage",17 "Domainregistrierung",18 "SSL-Zertifikate",19 "Web-Hosting-Unternehmen"20 ],21 "products_and_services": [22 "Dedizierte Root-Server (Dedicated Servers)",23 "Cloud-Server und virtuelle Server",24 "Managed Server",25 "Webhosting (Shared Hosting)",26 "Colocation Rack / Rechenzentrumsflächen",27 "Storage Box / Object Storage / Storage Share",28 "Domain-Registrierung",29 "SSL-Zertifikate",30 "Load Balancer",31 "DNS Console",32 "Registration Robot",33 "Custom Solutions"34 ],35 "industry_classification": {36 "WZ2008": [37 {38 "code": "62.01.0",39 "label": "Erbringung von Dienstleistungen der Informationstechnologie"40 },41 {42 "code": "63.11.0",43 "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"44 },45 {46 "code": "61.90.0",47 "label": "Telekommunikation, sonstige"48 }49 ],50 "WZ2025": [51 {52 "code": "62.20.1",53 "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"54 },55 {56 "code": "46.50.1",57 "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"58 },59 {60 "code": "62.90.0",61 "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"62 }63 ]64 },65 "contact_data": {66 "website": "https://www.hetzner.com/",67 "phone_number": "09831 5050",68 "email": "[email protected]"69 },70 "address": {71 "house_number": "25",72 "street": "Industriestraße",73 "postal_code": "91710",74 "city": "Gunzenhausen",75 "county": "Weißenburg-Gunzenhausen",76 "state": "Bayern",77 "country": "DEU",78 "coordinates": {79 "latitude": 49.12483,80 "longitude": 10.7805281 }82 },83 "seat": {84 "city": "Gunzenhausen"85 },86 "registration_date": null,87 "representation_scheme": {88 "current": [89 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."90 ],91 "history": [92 {93 "value": [94 "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."95 ],96 "effective_from": "2002-10-15",97 "effective_to": "2015-07-28"98 },99 {100 "value": [101 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."102 ],103 "effective_from": "2015-07-28",104 "effective_to": null105 }106 ]107 },108 "capital": {109 "current": {110 "amount": 50000,111 "currency": "EUR",112 "kind": "STAMMKAPITAL"113 },114 "history": [115 {116 "value": {117 "amount": 50000,118 "currency": "EUR",119 "kind": "GRUNDKAPITAL"120 },121 "effective_from": "2002-10-15",122 "effective_to": null123 }124 ]125 },126 "purpose": "Die Durchführung von Internet- und Netzwerkdienstleistungen, das Erstellen und Vertreiben von Software, der Handel mit Hard- und Software, der Betrieb einer Werbeagentur,darüber hinaus der Im- und Export von Waren aller Art, soweit sie keiner Einfuhr- oder Ausfuhrbeschränkung unterliegen und soweit keine Genehmigungen erforderlich sind.",127 "meta": {128 "request_credit_cost": 5,129 "credits_remaining": 145130 }131}
Név és jogi forma
A név, a jogi forma és a státusz leírja a céget, az entity_id azonosítja. Mentsd el az entity_id-t, ha később újra le akarsz kérni vagy figyelni egy céget, vagy a saját adataidhoz akarod kapcsolni.
| Mező | Jelentés | Példa | Elérhetőség |
|---|---|---|---|
| entity_idstring | A cég azonosítója a handelsregister.ai-nál. Mentsd el kulcsként az adataidban. A q paraméterben pontosan erre a cégre illeszkedik.Alapadatok |
"94eb910fef13f94585c48c263fa446d4" |
mindig |
| namestring | Cégnév, ahogy a nyilvántartásban szerepel, a jogiforma-utótaggal. |
"Hetzner Online GmbH" |
mint fent |
| legal_formstring |
Jogi forma, általában a szokásos német rövidítéssel. Kis- és nagybetűtől függetlenül hasonlítsd össze, mert az írásmód kissé eltérhet, például oHG. AI móddal a teljes forma is megjelenhet. A lista a gyakori értékeket mutatja; vannak továbbiak is.Értékek: GmbH Gesellschaft mit beschränkter Haftung (korlátolt felelősségű társaság), UG (haftungsbeschränkt) Unternehmergesellschaft (mini GmbH), AG Aktiengesellschaft (részvénytársaság), SE Societas Europaea (európai részvénytársaság), KGaA Kommanditgesellschaft auf Aktien (betéti részvénytársaság), GmbH & Co. KG KG, amelynek beltagja egy GmbH, KG Kommanditgesellschaft (betéti társaság), OHG Offene Handelsgesellschaft (közkereseti társaság), e.K. eingetragener Kaufmann (bejegyzett egyéni kereskedő), eG eingetragene Genossenschaft (bejegyzett szövetkezet), PartG Partnerschaftsgesellschaft (szabadfoglalkozásúak társasága), korlátozott szakmai felelősséggel is, e.V. eingetragener Verein (bejegyzett egyesület), eGbR eingetragene Gesellschaft bürgerlichen Rechts (bejegyzett polgári jogi társaság) |
"GmbH" |
mint fent |
| statusstring |
A cég nyilvántartási státusza. Más értékek is lehetségesek; az ismeretlen értékeket kezeld „nem aktív”-ként.Értékek: ACTIVE aktív, INSOLVENT fizetésképtelenségi eljárás alatt, DISSOLVED megszűnt, felszámolás alatt, TERMINATED törölve a nyilvántartásból |
"ACTIVE" |
mint fent |
Nyilvántartási bejegyzés
A cégbíróság, a nyilvántartás típusa és a cégjegyzékszám azonosít egy céget. Együtt írjuk őket, a példánkban „Ansbach HRB 6089”. Ebben a formában a q paraméterben is megadhatod őket.
| Mező | Jelentés | Példa | Elérhetőség |
|---|---|---|---|
| registrationobject|null | A cég nyilvántartási bejegyzése.Üres, ha az AI mód a céget csak webes forrásokból ismeri; az entity_id-ja ilyenkor AI_TMP_ előtaggal kezdődikAlapadatok | – | mindig |
| registration.courtstring | Cégbíróság helynévként, „Amtsgericht” (helyi bíróság) nélkül, például Ansbach vagy Charlottenburg (Berlin). |
"Ansbach" |
mint fent |
| registration.register_typestring |
A nyilvántartás típusa, vagyis a nyilvántartás, és a Handelsregisternél annak része.Értékek: HRB A Handelsregister B része: GmbH, UG, AG, SE, KGaA, HRA A Handelsregister A része: e.K., OHG, KG, GmbH & Co. KG, GnR Genossenschaftsregister (szövetkezeti nyilvántartás), PR Partnerschaftsregister (partnerségi nyilvántartás), VR Vereinsregister (egyesületi nyilvántartás), GsR Gesellschaftsregister (társasági nyilvántartás) az eGbR-hez |
"HRB" |
mint fent |
| registration.register_numberstring | Cégjegyzékszám szövegként. Csak a cégbírósággal és a nyilvántartás típusával együtt egyedi. |
"6089" |
mint fent |
| registration_datestring|null | A nyilvántartásba vétel dátuma ISO 8601 időbélyegként.Üres, ha a dátum nincs rögzítve |
"2013-03-18T00:00:00+00:00" |
többnyire: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG ritkán: GmbH & Co. KG, e.K. |
Egy cégjegyzékszám csak a cégbíróságával együtt egyedi. Sok bíróságnak lehet ugyanaz a száma.
Cím és székhely
Az address az üzleti cím, a seat a nyilvántartás szerinti székhely (Sitz). A kettő eltérhet, például ha egy cég Münchenben van bejegyezve, és Gautingban működik.
| Mező | Jelentés | Példa | Elérhetőség |
|---|---|---|---|
| addressobject | A cég üzleti címe.Alapadatok | – | mindig |
| address.streetstring|null | Utca házszám nélkül.Üres, ha a cím csak a városból áll |
"Industriestraße" |
többnyire |
| address.house_numberstring|null | Házszám szövegként, toldattal is, például „6 a”.Üres, ha a címben nincs házszám |
"25" |
mint fent |
| address.postal_codestring|null | Irányítószám szövegként, így a vezető nullák megmaradnak.Üres, ha a cím csak a városból áll |
"91710" |
mint fent |
| address.citystring | Az üzleti cím városa. |
"Gunzenhausen" |
mindig |
| address.countystring | Járás (Landkreis) vagy járási jogú város. Egyes címekben kulcsként hiányzik. |
"Weißenburg-Gunzenhausen" |
többnyire |
| address.statestring | Szövetségi tartomány (Bundesland). Egyes címekben kulcsként hiányzik. |
"Bayern" |
mint fent |
| address.countrystring | Ország háromjegyű ISO 3166 kódként, például DEU. Egyes címekben kulcsként hiányzik. |
"DEU" |
mint fent |
| address.coordinatesobject | Az üzleti cím földrajzi koordinátái, térképekhez és körzetes keresésekhez. | – | mint fent |
| address.coordinates.latitudenumber|null | Szélesség tizedes fokban.Üres, ha a címet nem sikerült geokódolni |
49.12483 |
mint fent |
| address.coordinates.longitudenumber|null | Hosszúság tizedes fokban.Üres, ha a címet nem sikerült geokódolni |
10.78052 |
mint fent |
| seatobject | A cég nyilvántartás szerinti székhelye (Sitz). | – | mindig |
| seat.citystring | A székhely városa. Eltérhet az üzleti címtől. |
"Gunzenhausen" |
mint fent |
Tevékenységi kör és iparág
A tevékenységi kör (Unternehmensgegenstand) a GmbH, az UG, az AG, az SE, a KGaA, az eG és a PartG esetén szerepel a nyilvántartásban. A GmbH & Co. KG, a KG, az OHG és az egyéni kereskedők (e.K.) nem jegyeztetnek be tevékenységi kört. Iparág, kulcsszavak, valamint termékek és szolgáltatások minden jogi formánál vannak.
| Mező | Jelentés | Példa | Elérhetőség |
|---|---|---|---|
| purposestring|null | Tevékenységi kör, ahogy a nyilvántartásban szerepel, németül. AI móddal az üzleti tevékenység rövid összefoglalója, a bejegyzett tevékenységi kör nélküli jogi formáknál is.Üres, ha a jogi forma nem jegyeztet be tevékenységi kört, például KG, OHG és e.K.Alapadatok |
"Die Durchführung von Internet- und Netzwerkdienstleistun…" |
mindig: GmbH, UG, AG, SE, KGaA, eG, PartG soha: GmbH & Co. KG, KG, OHG, e.K. |
| industry_classificationobject | Iparág a német gazdasági tevékenységi osztályozás (WZ) szerint, két változatban. | – | mindig |
| industry_classification.WZ2025array | Iparágkódok a WZ 2025, a jelenlegi változat szerint. A keresés iparágszűrője is ezeket a kódokat használja.Üres, ha nem sikerült iparágat hozzárendelni | – | többnyire |
| industry_classification.WZ2025[].codestring | Ötjegyű WZ-kód, például 62.20.1. |
"62.20.1" |
mint fent |
| industry_classification.WZ2025[].labelstring | A gazdasági tevékenység neve, németül. |
"Erbringung von Beratungsleistungen auf dem Gebiet der In…" |
mint fent |
| industry_classification.WZ2008array | Iparágkódok a régebbi WZ 2008 változat szerint, azokhoz a rendszerekhez, amelyek még ezt használják.Üres, ha nincs WZ 2008 szerinti besorolás | – | részben |
| industry_classification.WZ2008[].codestring | Ötjegyű WZ-kód a WZ 2008 szerint. |
"62.01.0" |
mint fent |
| industry_classification.WZ2008[].labelstring | A gazdasági tevékenység neve, németül. |
"Erbringung von Dienstleistungen der Informationstechnolo…" |
mint fent |
| keywordsarray | Kulcsszavak a cég üzleti tevékenységéről, nyilvános webes forrásokból gyűjtve. AI móddal bővítve.Üres, ha a cég alig van jelen a weben | – | mint fent |
| products_and_servicesarray | A cég termékei és szolgáltatásai listaként, nyilvános webes forrásokból gyűjtve. AI móddal bővítve.Üres, ha a cég alig van jelen a weben | – | mint fent |
AI móddal a
purpose a nyilvántartási szöveg helyett az üzleti tevékenység rövid összefoglalóját tartalmazza. Az AI mód kulcsszavakat, valamint termékeket és szolgáltatásokat ad hozzá a webről.
Tőke
A tőketársaságok bejegyeztetik a jegyzett tőkéjüket (Stammkapital vagy Grundkapital), minden változást dátummal. A current a hatályos összeg, a history a változások időrendben. A személyegyesítő társaságoknak és az egyéni kereskedőknek nincs rögzített tőkéjük; ott a current értéke null, a history pedig üres.
| Mező | Jelentés | Példa | Elérhetőség |
|---|---|---|---|
| capitalobject | Bejegyzett tőke az előzményeivel.Alapadatok | – | mindig |
| capital.currentobject|null | A hatályos tőkeösszeg.Üres, ha a jogi forma nem jegyeztet be rögzített tőkét, például KG, OHG, e.K. és PartG | – |
mindig: GmbH, UG, AG, SE, KGaA ritkán: eG soha: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.current.amountnumber | Összeg számként, a currency pénznemében. |
50000 |
mint fent |
| capital.current.currencystring | Pénznem ISO 4217 kódként, szinte mindig EUR. |
"EUR" |
mint fent |
| capital.current.kindstring |
A tőke fajtája. Más értékek is lehetségesek.Értékek: STAMMKAPITAL Stammkapital (törzstőke) egy GmbH-nál vagy UG-nál, GRUNDKAPITAL Grundkapital (alaptőke) egy AG-nál, SE-nél vagy KGaA-nál, LIABILITY_SUM Haftsumme (felelősségi összeg), például egy szövetkezetnél, CONDITIONAL egy AG feltételes tőkéje, korábbi bejegyzésekben |
"STAMMKAPITAL" |
mint fent |
| capital.historyarray | Az összes bejegyzett összeg időrendben, a hatályosat is beleértve. | – | mint fent |
| capital.history[].valueobject | Az összeg amount, currency és kind mezővel, a current-hez hasonló felépítésben. | – | mint fent |
| capital.history[].value.change_amountobject | A változás összege a nyilvántartási bejegyzés szerint, amount és currency mezővel. Hogy a tőkét emelték vagy csökkentették, az az előző összeggel való összevetésből derül ki. | – |
részben: AG, SE, KGaA ritkán: GmbH, UG, eG soha: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_fromstring|null | Ettől a naptól érvényes, YYYY-MM-DD formátumban. |
"2002-10-15" |
mindig: GmbH, UG, AG, SE, KGaA ritkán: eG soha: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_tostring|null | Eddig a napig érvényes.Üres, ha az összeg még hatályos |
"2005-02-28" |
mint fent |
A tőke előzményeit automatikusan olvassuk ki a nyilvántartási bejegyzésekből. Ehhez a legújabb technológiát használjuk, és sokat fektetünk a minőségbe; egyes hibák ennek ellenére előfordulhatnak.
Képviseleti szabályok
A képviseleti szabályok (Vertretungsregelung) határozzák meg, ki járhat el a cég nevében. A válasz szó szerint, németül tartalmazza őket a nyilvántartásból. A Hetzner Online GmbH-ra vonatkozó példakérésünkben az előzmények 2015. július 28-ig az igazgatóságot (Vorstand), azután az ügyvezetőket nevezték meg. Az egyes személyek jogköre a Képviseleti jogkör alatt található.
| Mező | Jelentés | Példa | Elérhetőség |
|---|---|---|---|
| representation_schemeobject | A cég általános képviseleti szabályai az előzményeikkel.Alapadatok | – |
mindig: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG többnyire: AG, SE, KGaA, e.K. |
| representation_scheme.currentarray|null | A hatályos szabályok szövegbekezdések listájaként, szó szerint a nyilvántartásból.Üres, ha nincsenek bejegyzett szabályok | – | mint fent |
| representation_scheme.historyarray | Az összes bejegyzett változat az érvényességével, a hatályosat is beleértve. | – | mint fent |
| representation_scheme.history[].valuearray | Ennek a változatnak a szövege bekezdések listájaként. | – | mint fent |
| representation_scheme.history[].effective_fromstring|null | Ettől a naptól érvényes, YYYY-MM-DD formátumban. |
"2002-10-15" |
mint fent |
| representation_scheme.history[].effective_tostring|null | Eddig a napig érvényes.Üres, ha a változat még hatályos |
"2015-07-28" |
mint fent |
Valós idejű móddal a
history üres. A hatályos változat a current alatt van.
Elérhetőség és web
Az elérhetőségek nem szerepelnek a nyilvántartásban. A cég weboldaláról gyűjtjük őket. Hogy léteznek-e, az tehát attól függ, mit tesz közzé a cég a weben.
| Mező | Jelentés | Példa | Elérhetőség |
|---|---|---|---|
| contact_dataobject | Elérhetőségek a cég weboldaláról.Alapadatok | – | mindig |
| contact_data.websitestring|null | A weboldal címe.Üres, ha nem találtunk weboldalt |
"https://www.hetzner.com/" |
részben |
| contact_data.phone_numberstring|null | Telefonszám, ahogy a cég közzéteszi. A formátum nincs egységesítve.Üres, ha nem találtunk számot |
"09831 5050" |
mint fent |
| contact_data.emailstring|null | A cég általános e-mail-címe.Üres, ha nem találtunk címet |
"[email protected]" |
mint fent |
| website_contentstring|null |
A weboldal szövege Markdownként, például saját elemzéshez vagy egy nyelvi modellhez. A website_content funkcióval érkezik, csak AI móddal együtt, felár nélkül.Üres, ha nem találtunk weboldaltwebsite_content |
"Dedicated Servers, Cloud & Hosting from Germany | Hetzne…" |
mint fent |
Valós idejű mód
A realtime_mode=handelsregister-default paraméterrel az API élőben is lekérdezi a Handelsregistert. A válasz ekkor tartalmazza a jelenleg bejegyzett személyeket és a lekérdezés eredményét a _realtime_mode alatt. A valós idejű módot csak akkor számoljuk fel, ha a lekérdezés sikerül, de akkor függetlenül attól, mit ad vissza.
| Mező | Jelentés | Példa | Elérhetőség |
|---|---|---|---|
| _realtime_modeobject | A valós idejű lekérdezés eredménye. Csak akkor szerepel a válaszban, ha kérted a realtime_mode paramétert.Alapadatok | – | mindig |
| _realtime_mode.modestring | A kért mód, handelsregister-default. |
"handelsregister-default" |
mint fent |
| _realtime_mode.statusstring |
Hogy az élő lekérdezés sikerült-e. Bármely más értéknél a válasz a tárolt adatokat tartalmazza, és a valós idejű módot nem számoljuk fel.Értékek: success az élő lekérdezés sikerült, az adatok közvetlenül a Handelsregisterből jönnek |
"success" |
mint fent |
Egy valós idejű lekérdezés tovább tart, ezért állítsd a kliensed időkorlátját legalább 120 másodpercre. Ha az élő lekérdezés nem sikerül, az API a tárolt adatokat adja vissza. A
_realtime_mode.status ilyenkor nem success, és a valós idejű módot nem számoljuk fel. Ha a kérés túl sokáig tart, díjmentesen 408-at kapsz; próbáld újra később.
Tovább
fetch-organization
Az alapadatokat visszaadó végpont, paraméterekkel és hibákkal.
Személyek és képviselet
Ügyvezetők, Prokura és tagok a jogköreikkel.
Alapfogalmak
Hogyan olvasd a current és a history mezőt, a null értéket és az üres listákat.
Adatok elérhetősége
Mit tartalmaz a nyilvántartás jogi formánként, és honnan származnak az adatok.