Date de bază
Denumire, formă juridică, înscriere în registru, adresă, obiect de activitate, capital și reguli de reprezentare: datele de bază ale fiecărui Profil companie.
Datele de bază descriu cine este o companie: denumire, formă juridică, înscriere în registru, adresă, obiect de activitate, capital și reguli de reprezentare. Fac parte din datele de bază și vin cu fiecare profil de companie, fără să ceri o funcție.
Majoritatea câmpurilor provin din Handelsregister (registrul comerțului) și din celelalte registre oficiale. În plus colectăm cuvinte-cheie, produse și date de contact de pe web. Ce trebuie să înregistreze o companie depinde de forma ei juridică; coloana Disponibilitate arată asta pentru fiecare câmp.
Exemplu
Exemplele de pe această pagină provin dintr-o cerere exemplu pentru Hetzner Online GmbH, Ansbach HRB 6089. Dacă înscrierea ei se schimbă, propria ta cerere returnează alte valori.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: CHEIA_TA_API" \ --data-urlencode 'q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "CHEIA_TA_API"}, 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": "CHEIA_TA_API" }, }); 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}
Denumire și formă juridică
Denumirea, forma juridică și statusul descriu compania, entity_id o identifică. Salvează entity_id dacă vrei să preiei sau să urmărești mai târziu din nou o companie ori să o legi de propriile tale date.
| Câmp | Semnificație | Exemplu | Disponibilitate |
|---|---|---|---|
| entity_idstring | ID-ul companiei la handelsregister.ai. Salvează-l ca cheie în datele tale. În parametrul q se potrivește exact cu această companie.Date de bază |
"94eb910fef13f94585c48c263fa446d4" |
întotdeauna |
| namestring | Denumirea companiei așa cum apare în registru, cu sufixul formei juridice. |
"Hetzner Online GmbH" |
ca mai sus |
| legal_formstring |
Forma juridică, de obicei ca abreviere germană uzuală. Compară fără a ține cont de majuscule, pentru că scrierea poate varia ușor, de exemplu oHG. Cu Modul AI poate apărea forma completă. Lista arată valorile uzuale; există și altele.Valori: GmbH Gesellschaft mit beschränkter Haftung (societate cu răspundere limitată), UG (haftungsbeschränkt) Unternehmergesellschaft (mini-GmbH), AG Aktiengesellschaft (societate pe acțiuni), SE Societas Europaea (societate europeană), KGaA Kommanditgesellschaft auf Aktien (societate în comandită pe acțiuni), GmbH & Co. KG KG cu un GmbH ca asociat cu răspundere nelimitată, KG Kommanditgesellschaft (societate în comandită simplă), OHG Offene Handelsgesellschaft (societate în nume colectiv), e.K. eingetragener Kaufmann (comerciant individual înregistrat), eG eingetragene Genossenschaft (cooperativă înregistrată), PartG Partnerschaftsgesellschaft (societate de profesii liberale), și cu răspundere profesională limitată, e.V. eingetragener Verein (asociație înregistrată), eGbR eingetragene Gesellschaft bürgerlichen Rechts (societate civilă înregistrată) |
"GmbH" |
ca mai sus |
| statusstring |
Statusul companiei în registru. Sunt posibile și alte valori; tratează valorile necunoscute ca „neactivă”.Valori: ACTIVE activă, INSOLVENT în procedură de insolvență, DISSOLVED dizolvată, în lichidare, TERMINATED radiată din registru |
"ACTIVE" |
ca mai sus |
Înscriere în registru
Instanța de registru, tipul de registru și numărul de registru identifică o companie. Le scriem împreună, în exemplul nostru „Ansbach HRB 6089”. Le poți transmite și în această formă în parametrul q.
| Câmp | Semnificație | Exemplu | Disponibilitate |
|---|---|---|---|
| registrationobject|null | Înscrierea companiei în registru.Gol când Modul AI cunoaște compania doar din surse web; entity_id-ul ei începe atunci cu AI_TMP_Date de bază | – | întotdeauna |
| registration.courtstring | Instanța de registru ca nume de localitate, fără „Amtsgericht” (judecătorie), de exemplu Ansbach sau Charlottenburg (Berlin). |
"Ansbach" |
ca mai sus |
| registration.register_typestring |
Tipul de registru, adică registrul și, pentru Handelsregister, secțiunea sa.Valori: HRB Handelsregister secțiunea B: GmbH, UG, AG, SE, KGaA, HRA Handelsregister secțiunea A: e.K., OHG, KG, GmbH & Co. KG, GnR Genossenschaftsregister (registrul cooperativelor), PR Partnerschaftsregister (registrul societăților de profesii liberale), VR Vereinsregister (registrul asociațiilor), GsR Gesellschaftsregister (registrul societăților) pentru eGbR |
"HRB" |
ca mai sus |
| registration.register_numberstring | Numărul de registru ca text. Unic doar împreună cu instanța de registru și tipul de registru. |
"6089" |
ca mai sus |
| registration_datestring|null | Data înscrierii în registru, ca timestamp ISO 8601.Gol când data nu este înregistrată |
"2013-03-18T00:00:00+00:00" |
de obicei: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG rar: GmbH & Co. KG, e.K. |
Un număr de registru este unic doar împreună cu instanța sa de registru. Multe instanțe pot avea același număr.
Adresă și sediu
address este adresa de afaceri, seat sediul (Sitz) din registru. Cele două pot diferi, de exemplu când o companie este înregistrată în München și activează în Gauting.
| Câmp | Semnificație | Exemplu | Disponibilitate |
|---|---|---|---|
| addressobject | Adresa de afaceri a companiei.Date de bază | – | întotdeauna |
| address.streetstring|null | Strada fără număr.Gol când adresa constă doar din localitate |
"Industriestraße" |
de obicei |
| address.house_numberstring|null | Numărul ca text, și cu sufix precum „6 a”.Gol când adresa nu are număr |
"25" |
ca mai sus |
| address.postal_codestring|null | Codul poștal ca text, ca să se păstreze zerourile de la început.Gol când adresa constă doar din localitate |
"91710" |
ca mai sus |
| address.citystring | Localitatea adresei de afaceri. |
"Gunzenhausen" |
întotdeauna |
| address.countystring | District (Landkreis) sau oraș independent. Lipsește ca cheie în unele adrese. |
"Weißenburg-Gunzenhausen" |
de obicei |
| address.statestring | Landul federal (Bundesland). Lipsește ca cheie în unele adrese. |
"Bayern" |
ca mai sus |
| address.countrystring | Țara ca cod ISO 3166 din trei litere, de exemplu DEU. Lipsește ca cheie în unele adrese. |
"DEU" |
ca mai sus |
| address.coordinatesobject | Coordonatele geografice ale adresei de afaceri, pentru hărți și căutări pe rază. | – | ca mai sus |
| address.coordinates.latitudenumber|null | Latitudinea în grade zecimale.Gol când adresa nu a putut fi geocodată |
49.12483 |
ca mai sus |
| address.coordinates.longitudenumber|null | Longitudinea în grade zecimale.Gol când adresa nu a putut fi geocodată |
10.78052 |
ca mai sus |
| seatobject | Sediul (Sitz) companiei din registru. | – | întotdeauna |
| seat.citystring | Localitatea sediului. Poate diferi de adresa de afaceri. |
"Gunzenhausen" |
ca mai sus |
Obiect de activitate și industrie
Obiectul de activitate (Unternehmensgegenstand) se află în registru pentru GmbH, UG, AG, SE, KGaA, eG și PartG. GmbH & Co. KG, KG, OHG și comercianții individuali (e.K.) nu înregistrează un obiect de activitate. Industria, cuvintele-cheie și produsele și serviciile există pentru orice formă juridică.
| Câmp | Semnificație | Exemplu | Disponibilitate |
|---|---|---|---|
| purposestring|null | Obiectul de activitate așa cum apare în registru, în germană. Cu Modul AI, este un scurt rezumat al activității, și pentru formele juridice fără obiect de activitate înregistrat.Gol când forma juridică nu înregistrează un obiect de activitate, de exemplu KG, OHG și e.K.Date de bază |
"Die Durchführung von Internet- und Netzwerkdienstleistun…" |
întotdeauna: GmbH, UG, AG, SE, KGaA, eG, PartG niciodată: GmbH & Co. KG, KG, OHG, e.K. |
| industry_classificationobject | Industria conform clasificării germane a activităților economice (WZ), în două versiuni. | – | întotdeauna |
| industry_classification.WZ2025array | Codurile de industrie conform WZ 2025, versiunea actuală. Și filtrul de industrie al căutării folosește aceste coduri.Gol când nu a putut fi atribuită nicio industrie | – | de obicei |
| industry_classification.WZ2025[].codestring | Cod WZ din cinci cifre, de exemplu 62.20.1. |
"62.20.1" |
ca mai sus |
| industry_classification.WZ2025[].labelstring | Denumirea activității economice, în germană. |
"Erbringung von Beratungsleistungen auf dem Gebiet der In…" |
ca mai sus |
| industry_classification.WZ2008array | Codurile de industrie conform versiunii mai vechi WZ 2008, pentru sistemele care încă o folosesc.Gol când nu există o atribuire WZ 2008 | – | parțial |
| industry_classification.WZ2008[].codestring | Cod WZ din cinci cifre conform WZ 2008. |
"62.01.0" |
ca mai sus |
| industry_classification.WZ2008[].labelstring | Denumirea activității economice, în germană. |
"Erbringung von Dienstleistungen der Informationstechnolo…" |
ca mai sus |
| keywordsarray | Cuvinte-cheie despre activitatea companiei, colectate din surse web publice. Extinse cu Modul AI.Gol când compania este puțin prezentă pe web | – | ca mai sus |
| products_and_servicesarray | Produsele și serviciile companiei ca listă, colectate din surse web publice. Extinse cu Modul AI.Gol când compania este puțin prezentă pe web | – | ca mai sus |
Cu Modul AI,
purpose conține un scurt rezumat al activității în locul textului din registru. Modul AI adaugă cuvinte-cheie și produse și servicii de pe web.
Capital
Societățile de capital își înregistrează capitalul social (Stammkapital sau Grundkapital), fiecare modificare cu data ei. current este suma în vigoare, history modificările în ordine cronologică. Societățile de persoane și comercianții individuali nu au capital fix; acolo current este null, iar history este gol.
| Câmp | Semnificație | Exemplu | Disponibilitate |
|---|---|---|---|
| capitalobject | Capitalul înregistrat cu istoricul său.Date de bază | – | întotdeauna |
| capital.currentobject|null | Suma capitalului în vigoare.Gol când forma juridică nu înregistrează capital fix, de exemplu KG, OHG, e.K. și PartG | – |
întotdeauna: GmbH, UG, AG, SE, KGaA rar: eG niciodată: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.current.amountnumber | Suma ca număr, în moneda din currency. |
50000 |
ca mai sus |
| capital.current.currencystring | Moneda ca cod ISO 4217, aproape întotdeauna EUR. |
"EUR" |
ca mai sus |
| capital.current.kindstring |
Tipul capitalului. Sunt posibile și alte valori.Valori: STAMMKAPITAL Stammkapital (capital social) al unui GmbH sau UG, GRUNDKAPITAL Grundkapital (capital social) al unui AG, SE sau KGaA, LIABILITY_SUM Haftsumme (suma de răspundere), de exemplu a unei cooperative, CONDITIONAL capital condiționat al unui AG, în înscrieri mai vechi |
"STAMMKAPITAL" |
ca mai sus |
| capital.historyarray | Toate sumele înregistrate în ordine cronologică, inclusiv cea în vigoare. | – | ca mai sus |
| capital.history[].valueobject | Suma cu amount, currency și kind, structurată ca current. | – | ca mai sus |
| capital.history[].value.change_amountobject | Valoarea modificării conform înscrierii în registru, cu amount și currency. Dacă capitalul a fost majorat sau redus rezultă din comparația cu suma anterioară. | – |
parțial: AG, SE, KGaA rar: GmbH, UG, eG niciodată: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_fromstring|null | Valabil din această zi, în formatul YYYY-MM-DD. |
"2002-10-15" |
întotdeauna: GmbH, UG, AG, SE, KGaA rar: eG niciodată: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_tostring|null | Valabil până în această zi.Gol când suma este încă în vigoare |
"2005-02-28" |
ca mai sus |
Istoricul capitalului îl citim automat din înscrierile din registru. Folosim pentru asta cea mai nouă tehnologie și investim mult în calitate; erori izolate sunt totuși posibile.
Reguli de reprezentare
Regulile de reprezentare (Vertretungsregelung) stabilesc cine poate acționa în numele companiei. Răspunsul le conține cuvânt cu cuvânt din registru, în germană. În cererea noastră exemplu pentru Hetzner Online GmbH, istoricul numea consiliul de administrație (Vorstand) până pe 28 iulie 2015, iar după aceea administratorii. Puterile persoanelor individuale sunt la Puterea de reprezentare.
| Câmp | Semnificație | Exemplu | Disponibilitate |
|---|---|---|---|
| representation_schemeobject | Regulile generale de reprezentare ale companiei cu istoricul lor.Date de bază | – |
întotdeauna: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG de obicei: AG, SE, KGaA, e.K. |
| representation_scheme.currentarray|null | Regulile în vigoare ca listă de paragrafe de text, cuvânt cu cuvânt din registru.Gol când nu sunt înregistrate reguli | – | ca mai sus |
| representation_scheme.historyarray | Toate versiunile înregistrate cu valabilitatea lor, inclusiv cea în vigoare. | – | ca mai sus |
| representation_scheme.history[].valuearray | Textul acestei versiuni ca listă de paragrafe. | – | ca mai sus |
| representation_scheme.history[].effective_fromstring|null | Valabil din această zi, în formatul YYYY-MM-DD. |
"2002-10-15" |
ca mai sus |
| representation_scheme.history[].effective_tostring|null | Valabil până în această zi.Gol când versiunea este încă în vigoare |
"2015-07-28" |
ca mai sus |
Cu Timp real,
history este gol. Versiunea în vigoare se află în current.
Contact și web
Datele de contact nu se află în registru. Le colectăm de pe site-ul companiei. Dacă există depinde deci de ce publică firma pe web.
| Câmp | Semnificație | Exemplu | Disponibilitate |
|---|---|---|---|
| contact_dataobject | Date de contact de pe site-ul companiei.Date de bază | – | întotdeauna |
| contact_data.websitestring|null | Adresa site-ului.Gol când nu s-a găsit niciun site |
"https://www.hetzner.com/" |
parțial |
| contact_data.phone_numberstring|null | Numărul de telefon așa cum îl publică firma. Formatul nu este normalizat.Gol când nu s-a găsit niciun număr |
"09831 5050" |
ca mai sus |
| contact_data.emailstring|null | Adresa de e-mail generală a companiei.Gol când nu s-a găsit nicio adresă |
"[email protected]" |
ca mai sus |
| website_contentstring|null |
Textul site-ului ca Markdown, de exemplu pentru propria analiză sau un model de limbaj. Vine cu funcția website_content, doar împreună cu Modul AI și fără cost suplimentar.Gol când nu s-a găsit niciun sitewebsite_content |
"Dedicated Servers, Cloud & Hosting from Germany | Hetzne…" |
ca mai sus |
Timp real
Cu realtime_mode=handelsregister-default, API-ul interoghează în plus live Handelsregister. Răspunsul conține atunci persoanele înscrise în prezent și _realtime_mode cu rezultatul interogării. Timp real se taxează doar dacă interogarea reușește, dar atunci indiferent ce returnează.
| Câmp | Semnificație | Exemplu | Disponibilitate |
|---|---|---|---|
| _realtime_modeobject | Rezultatul interogării în Timp real. Apare în răspuns doar dacă ai cerut realtime_mode.Date de bază | – | întotdeauna |
| _realtime_mode.modestring | Modul cerut, handelsregister-default. |
"handelsregister-default" |
ca mai sus |
| _realtime_mode.statusstring |
Dacă interogarea live a reușit. Cu orice altă valoare, răspunsul conține datele salvate, iar Timp real nu se taxează.Valori: success interogarea live a reușit, datele vin direct din Handelsregister |
"success" |
ca mai sus |
O interogare în Timp real durează mai mult, așa că setează timeoutul clientului la cel puțin 120 de secunde. Dacă interogarea live eșuează, API-ul returnează datele salvate.
_realtime_mode.status nu este atunci success, iar Timp real nu se taxează. Dacă cererea durează prea mult, primești 408 fără cost; încearcă din nou mai târziu.
Mai departe
fetch-organization
Endpointul care returnează datele de bază, cu parametri și erori.
Persoane și reprezentare
Administratori, Prokura și asociați cu puterile lor.
Concepte de bază
Cum citești current și history, null și listele goale.
Disponibilitatea datelor
Ce conține registrul pe formă juridică și de unde vin datele.