Gyakran ismételt kérdések

A kreditek az a fizetőeszköz, amellyel az API-nkat használod. Minden lekérdezés a végponttól és a választott opcióktól függően meghatározott számú kreditbe kerül.

Krediteket háromféleképpen kaphatsz:

• Regisztrációs bónusz: Az új felhasználók regisztrációkor 150 ingyenes kreditet kapnak
• Havi előfizetési kreditek: Minden csomag havi kreditkeretet tartalmaz
• Feltöltések: Vásárolj további krediteket, amikor szükséged van rájuk

A költség a végponttól és a kiválasztott adatoktól függ. Pontos adatokat itt találsz:

• Az API-dokumentációnkban minden végpont szerepel az árával együtt
• A kezdőlapunkon lévő kreditkalkulátorral megbecsülheted a költségeidet

Ez attól függ, van-e előfizetésed:

• Előfizetéssel: A feltöltési kreditek és a regisztrációs bónusz nem járnak le, amíg az előfizetésed fut
• Előfizetés nélkül: A kreditek a jóváírástól számított 30 napig érvényesek
• Előfizetési kreditek: Az adott számlázási időszak végéig érvényesek

Ha az egyenleged már nem elég:

• Az API-kérések „Insufficient credits” hibával (HTTP 402) válaszolnak
• Vásárolj további krediteket, vagy várd meg a következő havi előfizetési krediteket
• A fiókod és az API-hozzáférésed megmarad, csak krediteket kell vásárolnod

A felhasználásodat a vezérlőpulton látod; ott értesítés jelenik meg, ha fogy az egyenleged.

Minden csomag tartalmazza:

• Le nem járó kreditek: A megvásárolt kreditjeid nem járnak le, amíg az előfizetésed él
• Havi kreditkeret: Minden hónapban új kreditek
• API-hozzáférés: Minden végpont; egyes adatpontok és szűrők Pro vagy Max csomagtól érhetők el

Ezen felül csomagtól függően:

• Plus: Ideális kisebb projektekhez és teszteléshez
• Pro: 5% bónusz minden kreditvásárlásra, kiemelt támogatás
• Max: 15% bónusz a kreditvásárlásokra, a legnagyobb havi keret, elsőbbségi támogatás

• Minden számlázási időszak elején megkapod a csomagod kreditjeit, éves fizetésnél havonta
• A havi kreditek a megvásárolt kreditek előtt használódnak fel
• A fel nem használt havi kreditek az időszak végén lejárnak
• Havi kreditek addig járnak, amíg az előfizetésed él, lemondás után a kifizetett időszak végéig

Igen, az előfizetésed teljesen a te kezedben van:

• Váltás magasabb csomagra: Bármikor válthatsz magasabb csomagra: a váltás azonnal érvényes, új számlázási időszak kezdődik, és az új árat azonnal felszámítjuk
• Downgrade: Válts bármikor kisebb csomagra: a váltás azonnal érvényes, új számlázási időszak indul, és az új árat azonnal felszámítjuk
• Lemondás: Mondd le bármikor, minimális futamidő nélkül; a csomagod a kifizetett időszak végéig tovább fut
• Folytatás: A lemondott előfizetést a lejárta előtt a vezérlőpult „Kezelés” menüpontjában újraindíthatod

Fontos: váltáskor a megmaradt előfizetési kreditjeidet átviszed az új csomagba. Éves fizetésről havira csak az éves előfizetésed lejártakor válthatsz.

A lemondást és a fizetési adatokat a vezérlőpulton kezeled, csomagot a kezdőlap árazási részében váltasz.

Ha lemondod az előfizetésedet:

• Havi kreditek: A kifizetett időszak végéig felhasználhatók maradnak
• Feltöltési kreditek: A kifizetett időszak végéig nem járnak le; utána ismét az eredeti lejárati dátumuk érvényes
• API-hozzáférés: Megmarad, amíg van kredited; a személyprofilokhoz viszont aktív előfizetés kell

Krediteket a vezérlőpulton vagy a kezdőlap árazási részében, a „Kreditek feltöltése” alatt vásárolhatsz. A vezérlőpulton:

1. Nyisd meg a vezérlőpultodat
2. Görgess a „Kreditek vásárlása” részhez
3. Válaszd ki a mennyiséget a csúszkával vagy valamelyik gyorsértékkel
4. Ellenőrizd a bónuszokat és a kreditek teljes számát
5. Fejezd be a biztonságos fizetést a Stripe-on keresztül

A kreditek a vásárlás után azonnal rendelkezésre állnak.

Igen, előfizetéssel. Előfizetés nélkül a feltöltési kreditek a vásárlástól számított 30 napig érvényesek. Amíg van előfizetésed (Plus, Pro vagy Max), nem járnak le, a korábban vásároltak sem, ha az előfizetés kezdetekor még érvényesek. Ha az előfizetés véget ér, ismét az eredeti lejárati dátumuk érvényes.

Minél többet vásárolsz egyszerre, annál több bónuszkreditet kapsz:

A bónuszok automatikusan érvényesülnek, és hozzáadódnak a csomagod bónuszához.

Igen, egy feltöltés legalább 2.000 kreditet tartalmaz. Ez biztosítja:

• Alacsonyabb tranzakciós költség kreditenként
• Kedvezőbb ár neked
• Kevesebb ráfordítás a fizetések feldolgozásánál

Vásárlásonként legfeljebb 500.000 kreditet választhatsz.

A mennyiségi és a csomagbónusz összeadódik:

Mindkét bónusz az alapkreditekre vonatkozik.

Az áraink egyszerűek:

• Kreditek: 0,01 € kreditenként (bónuszok előtt)
• Előfizetések: Fix havi vagy éves ár, benne foglalt kreditekkel
• Nincsenek rejtett díjak: Azt fizeted, amit látsz

Minden ár euróban értendő, a törvényes áfa nélkül.

Nem, minden ár nettó ár. Hogy milyen áfa terheli, az az országodtól és a közösségi adószámodtól függ; ezt a fizetéskor számítjuk ki és tüntetjük fel.

Ezeket a fizetési módokat fogadjuk el:

• Hitelkártya (Visa, Mastercard, American Express)
• Betéti kártya
• PayPal
• Fizetés számla alapján, banki átutalással, Enterprise-szerződéssel ([email protected])

Minden online fizetés biztonságosan és PCI-megfelelően a Stripe-on keresztül történik.

Igen, minden fizetésről automatikusan számla készül:

• A fizetés után azonnal elérhető
• Előfizetéssel bármikor lekérhető a vezérlőpulton a „Számlák megtekintése” alatt
• Minden szükséges adózási adattal
• E-mailben minden fizetés után

Számláink megfelelnek az uniós adózási előírásoknak, és minden adatot tartalmaznak a könyveléshez.

A csomagokat és a feltöltéseket a Stripe-on keresztüli fizetéskor hitel- vagy betéti kártyával, illetve PayPallal fizeted, és számlát kapsz róluk. Átutalásos, számla alapú fizetést Enterprise-szerződéssel kínálunk; ehhez írj nekünk a [email protected] címre.

A le nem járó kreditek minden előfizetés előnyei közé tartoznak:

• A megvásárolt kreditekre és a regisztrációs bónuszra vonatkozik
• A krediteknek az előfizetés kezdetekor még érvényesnek kell lenniük
• Nem járnak le, amíg az előfizetésed él
• Ha az előfizetés véget ér, ismét a vásárlástól számított 30 napos határidő érvényes

A kreditek felhasználási sorrendje:

1. Előfizetési kreditek (ha van előfizetésed)
2. Megvásárolt kreditek és regisztrációs bónusz (a legrégebbiek először)

Így biztosítjuk, hogy:

• A havi kreditek felhasználásra kerülnek, mielőtt lejárnának
• A megvásárolt kreditek tovább tartanak
• Optimálisan használod ki a kreditjeidet

A levonás automatikusan történik:

• A krediteket a válasz után vonjuk le, és csak a leszállított adatokért
• Minden levonást részletesen naplózunk
• Az egyenleged azonnal frissül
• A sikertelen kérések nem kerülnek kreditbe, kivéve a cégprofilok AI módját: ezt hiba esetén is felszámítjuk

Adatbázis-zárolások gondoskodnak arról, hogy minden levonás nagy terhelés mellett is pontos legyen.

Az AI mód a cégprofilok (/api/v1/fetch-organization) egyik opciója:

• Jobb egyeztetés: gyakran megtalál olyan cégeket is, amelyeket a pontos névkeresés nem talál
• Webes adatok: elérhetőségek, kulcsszavak, termékek és szolgáltatások, valamint a teljes WZ-besorolás
• 20 kredit felár, akkor is, ha a kérés sikertelen
• A /api/v1/fetch-organization végpontnál opcionális; a /api/v1/fetch-person végpontnál mindig aktív (a 15 kredites alapárban benne van)

Szervereink Németországban és az EU-ban vannak.

Igen, a handelsregister.ai GDPR-megfelelő. Az adatok nyilvános nyilvántartásokból származnak, szervereink pedig Németországban és az EU-ban vannak.

Kérésre adatfeldolgozási szerződést kötünk. Írj nekünk a [email protected] címre.

Minden részletet az adatvédelmi tájékoztatónkban találsz.

Az API aktuális állapotát bármikor megnézheted az állapotoldalunkon a handelsregister.ai/status címen.

Szerződésben garantált rendelkezésre állás (SLA) csak Enterprise-szerződéssel van.

A német cégnyilvántartáshoz nincs hivatalos API. A handelsregister.ai a Fusionbase GmbH független API-ja, amely a Handelsregister, a Bundesanzeiger és a fizetésképtelenségi közzétételek hivatalos cégadatait strukturált JSON-ként szolgáltatja – igény szerint valós időben, szoftverek és AI-ügynökök számára.

Az adatok hivatalos nyilvántartásokból és nyilvános forrásokból származnak, elsősorban:

• Cégnyilvántartás: Nyilvántartási adatok, például jogi forma, székhely és ügyvezetés, továbbá közzétételek, taglisták és dokumentumok
• Unternehmensregister és Bundesanzeiger: Közzétett éves beszámolók mérleggel és eredménykimutatással
• Csődbíróságok: Fizetésképtelenségi közzétételek
• Sajtó és web: Hírek, céges weboldalak és további nyilvánosan elérhető weboldalak

Az API több mint 5 millió vállalatot és szervezetet tartalmaz.

Minden vállalat és szervezet, amely a német cégnyilvántartásban vagy a hivatalos nyilvántartási portál valamelyik további nyilvántartásában szerepel:

• Cégnyilvántartás, B rész (HRB): Tőketársaságok, például GmbH, UG (haftungsbeschränkt), AG, SE és KGaA
• Cégnyilvántartás, A rész (HRA): Egyéni kereskedők (e.K.) és személyegyesítő társaságok, például OHG, KG és GmbH & Co. KG
• Szövetkezeti nyilvántartás (GnR): bejegyzett szövetkezetek (eG)
• Partnerségi nyilvántartás (PR): szabadfoglalkozásúak partnerségi társaságai (PartG, PartG mbB)
• Egyesületi nyilvántartás (VR): bejegyzett egyesületek (e.V.)
• Társasági nyilvántartás (GsR): bejegyzett polgári jogi társaságok (eGbR)

Az AI móddal nyilvánosan elérhető weboldalakon keresztül nyilvántartási bejegyzés nélküli vállalkozásokat is találsz, például egyéni vállalkozókat és szabadfoglalkozásúakat.

Cégtől függően ezek az adatkategóriák érhetők el:

Nem minden cégnél érhető el minden adatkategória; az elérhetőség a mérettől, a jogi formától és a közzétételi kötelezettségektől függ.

Pénzügyi adatok (mérlegek, eredménykimutatások, KPI-k) azoknál a vállalatoknál érhetők el, amelyeknek közzé kell tenniük az éves beszámolójukat. Ez elsősorban az alábbiakat érinti:

• Minden GmbH, UG, AG és KGaA
• Bizonyos személyegyesítő társaságok, amelyekben nincs korlátlanul felelős természetes személy (pl. GmbH & Co. KG)

A részletesség változó: a nagyobb vállalatok általában átfogóbb pénzügyi beszámolókat tesznek közzé, a kisebbek gyakran csak rövidített mérleget. Az egyéni vállalkozásoknál és azoknál a személyegyesítő társaságoknál, ahol természetes személy a korlátlanul felelős tag, általában nincsenek pénzügyi adatok.

Sok vállalatcsoport két beszámolót tesz közzé: magának a társaságnak az éves beszámolóját és a konszolidált beszámolót. Az API-ban, a Playgroundban és a cégadat-gazdagításban kiválaszthatod, melyik beszámolótípust és hány üzleti évet kapj; a cégprofilokon egy kattintással válthatsz az egyedi és a konszolidált számok között, ha ugyanarra az évre mindkettő elérhető.

Tagi adatok főként ezekhez érhetők el:

• GmbH és UG: A taglistákat benyújtják a cégnyilvántartásnak, és tartalmazzák a neveket, a vagyoni hozzájárulásokat és a részesedési arányokat
• AG: Az egyes részvényeseket általában nem jegyzik be; csak a nagyrészvényesek lehetnek ismertek nyilvános közleményekből

Az elérhetőség attól függ, hogy benyújtottak-e aktuális taglistát a nyilvántartásnak.

Az adatokat automatizált rendszerek és AI-alapú kinyerés kombinációjával dolgozzuk fel:

• A hivatalos nyilvántartási dokumentumokat és közzétételeket automatikusan feldolgozzuk
• Az AI strukturálja, kiegészíti és elemzi az információkat
• A több forrásból származó adatokat összevonjuk és naprakészen tartjuk

Ez a forrástól függ:

• Cégnyilvántartás: Az alapadatokat, a személyeket és a közleményeket folyamatosan frissítjük a nyilvántartásból. Valós idejű módban az API lekéréskor élőben hozza a cégprofilt a Handelsregisterből.
• Éves beszámolók: Az újonnan közzétett beszámolókat naponta átvesszük. A cégeknek akár tizenkét hónapjuk is van a közzétételre, ezért a legfrissebb beszámoló gyakran a tavalyelőtti évre vonatkozik.
• Fizetésképtelenségi közzétételek: A bíróságok általában a döntés napján vagy röviddel utána teszik közzé őket.
• Dokumentumok: A cégkivonatokat, a tagjegyzékeket és a társasági szerződéseket az API mindig élőben kéri le a Handelsregisterből.

Igen. Valós idejű módban (realtime_mode paraméter) az API lekéréskor élőben hozza a cégprofilt a cégnyilvántartásból, az aktuális ügyvezetéssel együtt. Ez 10 kredittel többe kerül, csak akkor, ha az élő lekérés sikeres, és néhány másodperccel tovább tart. Valós idejű mód nélkül a profil az adatbázisunkból érkezik.

A korábbi ügyvezetőket és más történeti adatokat a valós idejű lekérés nem tartalmazza.

Az olyan dokumentumokat, mint a cégkivonatok, taglisták és alapszabályok, az API mindig élőben kéri le a cégnyilvántartásból. Ha ugyanazt a dokumentumot az elmúlt 24 órában már lekérték, a gyorsítótárból szolgáltatjuk.

Igen, Enterprise-szerződéssel: megkapod a teljes adatbázis exportját, a felhasználási jogokat pedig egyedi licencben rendezzük. Írd meg nekünk a [email protected] címre, mire készülsz; egy munkanapon belül válaszolunk.

Egyes listákhoz ott van az export a „Keresés és export” részben: exportonként legfeljebb 5.000 cég.