Gyakori kérdések

A hivatalos nyilvántartásokból és közzétételekből: a Handelsregisterből (német cégnyilvántartás), az Unternehmensregisterből (cégregiszter) az éves beszámolókkal, és a fizetésképtelenségi közzétételekből. A hírek és a weboldalak tartalma a webről jön. Bővebben: Adatok elérhetősége.

Sok adatot automatikusan olvasunk ki a közzétett dokumentumokból és közleményekbő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.

Egy cégprofil az adatbázisunkból származik. Valós idejű móddal az API élőben is lekérdezi a Handelsregistert, és visszaadja a jelenleg bejegyzett személyeket. A dokumentumokat az API akkor kéri le a nyilvántartásból, amikor kéred őket.

Ha ugyanazt a dokumentumot nem sokkal korábban már lekérték, legfeljebb 24 órás lehet.

A cégeknek legkésőbb tizenkét hónappal a mérlegfordulónap után kell közzétenniük az éves beszámolót, és sokan ki is használják a teljes időszakot. A legfrissebb beszámoló ezért gyakran a tavalyelőtti évre vonatkozik.

Általában azért, mert a cégnek nem kell közzétennie. Hogy mi nyilvános, az a jogi formától és a mérettől függ: egy kis GmbH például nem tesz közzé eredménykimutatást, így általában nincs róla árbevétel. Az üres értékek null vagy [] formában jelennek meg a válaszban.

Egy több cég által viselt névre az API visszaadhatja valamelyiket, nem feltétlenül azt, amelyikre gondolsz, vagy 404-gyel válaszolhat. Ha pontosnak kell lenned, kérdezz cégbírósággal és cégjegyzékszámmal, például „Ansbach HRB 6089”, vagy az entity_id-val. A cégjegyzékszám önmagában nem elég, mert ugyanaz a szám sok bíróságnál létezik.

Nem. Egy funkciót csak akkor számolunk fel, ha adatot ad vissza. Az AI módot viszont akkor is felszámoljuk, ha nem talál céget. Csak ha az API 408-cal megszakítja a kérést, akkor nem. A valós idejű mód minden sikeres élő lekérésnél kreditbe kerül, akkor is, ha semmi újat nem mutat.

Semmibe. A hibával végződő kérést nem számoljuk fel; az egyetlen kivétel az AI mód felára. 402-es státusznál a meta.request_credit_cost megadja, legfeljebb mennyibe került volna a kérés. Bővebben: Hibák.

Nem. A cégprofilokat, a Keresés és exportot, a dokumentumokat és a Signalst bármely fiókkal használhatod; csak a krediteket fizeted. Egy kredit-előfizetés további adatokat nyit meg:

• Plus: a személyprofil.
• Pro: a bővített pénzügyi KPI-k, a Céghálózat funkció, keresőszűrők tulajdonosokra, vezetésre és fizetésképtelenségre, valamint a Fizetésképtelenségek Signals-téma.
• Max: minden, ami a Pro csomagban van, plusz a Részletes tagadatok funkció, az energiaszolgáltatók tevékenységi beszámolói és az Átalakulások és M&A Signals-téma.

Minden az árakról és a csomagokról az Elszámolás oldalon található.

Egy új fiók 150 kezdő kreditet kap. Kredit-előfizetés nélkül a kezdő és a feltöltött kreditek 30 napig érvényesek. Amíg egy kredit-előfizetés aktív, nem járnak le.

A valós idejű módhoz, a személyprofilokhoz és a dokumentumokhoz legalább 120 másodpercet, mert ezek a kérések tovább tartanak. Ha valós idejű módnál csak az élő lekérés nem sikerül, a tárolt adatokat kapod a valós idejű mód felára nélkül. Ha a kérés túl sokáig tart, 408-cal, dokumentumoknál 504-gyel végződik. Ilyenkor semmit nem számolunk fel. Próbáld újra később.

Cégprofilokhoz percenként és fiókonként 60 kérést, dokumentumokhoz 5 kérést. Efölött az API 429-es státusszal válaszol, és a Retry-After headerben megadja a várakozási időt. Minden limit a Limitek oldalon található.

Igen, a cégprofiloknál, a személyprofiloknál, a keresésnél és a dokumentumoknál. Küldj egy saját értéket az Idempotency-Key headerben. Ha 24 órán belül ugyanazzal a kulccsal és ugyanazokkal a paraméterekkel megismétled a kérést, nem kerül semmibe.

Igen. A Fiók › API-kulcsok alatt további kulcsokat hozhatsz létre, például alkalmazásonként egyet. Ha törölsz egy kulcsot, az azonnal érvénytelen. Minden kulcs a fiókod egyenlegét használja.