Wartości i kody
Wszystkie stałe wartości, które pojawiają się w odpowiedziach.
Ta strona wymienia stałe wartości, które występują w odpowiedziach, wraz z ich znaczeniem. Listy są otwarte: mogą dojść nowe wartości. Traktuj więc nieznaną wartość jak „inne”, zamiast przerywać działanie błędem.
Status
Status znajdziesz w status w profilu firmy. Signals podają go w organization.current_profile.status.code w ogólniejszej formie.
| Wartość | Znaczenie | Występuje w |
|---|---|---|
| ACTIVE | Aktywna, firma jest w rejestrze i prowadzi działalność. | Profil firmy, Signals |
| INSOLVENT | Niewypłacalna, wpisano postępowanie upadłościowe. | Profil firmy, Signals |
| DISSOLVED | Rozwiązana, firma jest w likwidacji. | Profil firmy |
| TERMINATED | Wykreślona, wpis firmy w rejestrze został zamknięty. | Profil firmy |
| INACTIVE | Już nieaktywna. Signals używają tej wartości zarówno dla firm rozwiązanych, jak i wykreślonych. | Signals, Szczegółowe dane wspólników |
Wykreślone firmy także pozostają dostępne, z pełną historią.
Formy prawne
Forma prawna jest w legal_form, zwykle jako skrót. To tekst, a nie stały kod. Te wartości występują w prawdziwych odpowiedziach:
| Wartość | Forma prawna | Rejestr |
|---|---|---|
| GmbH | Gesellschaft mit beschränkter Haftung (spółka z ograniczoną odpowiedzialnością), także pożytku publicznego gGmbH | HRB |
| UG (haftungsbeschränkt) | Unternehmergesellschaft (haftungsbeschränkt), mini-GmbH | HRB |
| gUG (haftungsbeschränkt) | Unternehmergesellschaft pożytku publicznego | HRB |
| AG | Aktiengesellschaft (spółka akcyjna) | HRB |
| SE | Spółka europejska (Societas Europaea) | HRB |
| KGaA | Kommanditgesellschaft auf Aktien (spółka komandytowo-akcyjna) | HRB |
| GmbH & Co. KGaA | KGaA z GmbH jako komplementariuszem | HRB |
| VVaG | Versicherungsverein auf Gegenseitigkeit (towarzystwo ubezpieczeń wzajemnych) | HRB |
| KG | Kommanditgesellschaft (spółka komandytowa) | HRA |
| GmbH & Co. KG | KG z GmbH jako Komplementärin, czyli komplementariuszem | HRA |
| UG (haftungsbeschränkt) & Co. KG | KG z UG jako komplementariuszem | HRA |
| AG & Co. KG | KG z AG jako komplementariuszem | HRA |
| SE & Co. KG | KG z SE jako komplementariuszem | HRA |
| OHG | Offene Handelsgesellschaft (spółka jawna) | HRA |
| GmbH & Co. OHG | OHG z GmbH jako wspólnikiem | HRA |
| e.K. |
Eingetragener Kaufmann lub eingetragene Kauffrau (zarejestrowany kupiec jednoosobowy). Zapisywane też jako eingetragener Kaufmann (e.K.). |
HRA |
| eG | Eingetragene Genossenschaft (zarejestrowana spółdzielnia) | GnR |
| PartG | Partnerschaftsgesellschaft, spółka partnerska wolnych zawodów | PR |
| PartmbB | Partnerschaftsgesellschaft z ograniczoną odpowiedzialnością zawodową (PartG mbB) | PR |
| e.V. | Eingetragener Verein (zarejestrowane stowarzyszenie) | VR |
| eGbR | Eingetragene Gesellschaft bürgerlichen Rechts (zarejestrowana spółka prawa cywilnego) | GsR |
| Ltd. | Zagraniczna forma prawna, tu brytyjska Limited z wpisem w niemieckim rejestrze | HRB |
Ta sama forma prawna może być zapisana różnie. Porównuj więc tolerancyjnie albo mapuj wartości na własną listę. Do filtrów search-organizations ma własną stałą listę w legal_form_code.
Typy rejestrów i sądy rejestrowe
Wpis do rejestru jest w registration: sąd rejestrowy w court, typ rejestru w register_type, a numer w register_number.
| Wartość | Znaczenie |
|---|---|
| HRB | Handelsregister (rejestr handlowy), dział B: spółki kapitałowe, takie jak GmbH, UG, AG, SE i KGaA |
| HRA | Handelsregister, dział A: kupcy jednoosobowi i spółki osobowe, takie jak e.K., OHG i KG |
| GnR | Genossenschaftsregister: zarejestrowane spółdzielnie |
| PR | Partnerschaftsregister: spółki partnerskie wolnych zawodów |
| VR | Vereinsregister: zarejestrowane stowarzyszenia |
| GsR | Gesellschaftsregister: zarejestrowane spółki prawa cywilnego (eGbR), od 2024 |
court podaje miejscowość sądu rejestrowego tak, jak zapisuje ją rejestr, np. Ansbach, Charlottenburg (Berlin) lub Frankfurt/Oder. Numer rejestru jest jednoznaczny tylko razem z sądem i typem, np. Ansbach HRB 6089.
W danych zagnieżdżonych, np. dla stron połączenia, sąd może też występować z pełną nazwą, np. Amtsgericht Nürnberg.
Rodzaje kapitału
Rodzaj wpisanego kapitału jest w capital.current.kind, a dla wcześniejszych kwot w capital.history[].value.kind.
| Wartość | Znaczenie | Występuje w |
|---|---|---|
| STAMMKAPITAL | Stammkapital (kapitał zakładowy), np. GmbH lub UG | np. GmbH, UG |
| GRUNDKAPITAL | Grundkapital (kapitał zakładowy), np. spółki akcyjnej | np. AG, SE, KGaA |
| LIABILITY_SUM | Haftsumme (suma odpowiedzialności), np. określona w statucie spółdzielni | np. eG |
| CONDITIONAL | Kapitał warunkowy AG, we wcześniejszych wpisach | np. AG |
Spółki osobowe, kupcy jednoosobowi i stowarzyszenia nie mają wpisanego kapitału. Wtedy capital.current ma wartość null, a capital.history jest puste.
Role
Rola osoby jest w related_persons.current[].label i related_persons.past[].label. role podaje też nazwę roli po niemiecku i angielsku.
| Wartość | Znaczenie |
|---|---|
| MANAGING_DIRECTOR | Członek zarządu GmbH (Geschäftsführer lub Geschäftsführerin) |
| TEMPORARY_MANAGING_DIRECTOR | Członek zarządu ustanowiony przez sąd w trybie awaryjnym (Notgeschäftsführer) |
| BOARD | Członek zarządu spółki akcyjnej (Vorstand) |
| BOARD_CHAIR | Przewodniczący zarządu |
| DIRECTOR | Dyrektor wykonawczy, np. SE |
| PROCURA | Prokura, pełnomocnictwo wpisane do rejestru |
| LIQUIDATOR | Likwidator, przeprowadza likwidację rozwiązanej firmy |
| INSOLVENCY_ADMINISTRATOR | Syndyk |
| REPRESENTATIVE | Przedstawiciel lub stały przedstawiciel, np. oddziału |
| FULLY_LIABLE_PARTNER | Wspólnik osobiście odpowiedzialny (persönlich haftender Gesellschafter, Komplementär) |
| LIMITED_PARTNER | Komandytariusz (Kommanditist), odpowiada tylko do wysokości wkładu |
| PARTNER | Partner w PartG. Wspólnicy OHG mają FULLY_LIABLE_PARTNER. |
| OWNER | Właściciel, np. e.K. |
| PROPRIETOR | Właściciel, to samo znaczenie co OWNER |
| TREASURER | Skarbnik stowarzyszenia |
| SECRETARY | Sekretarz stowarzyszenia |
| YOUTH_WARDEN | Opiekun młodzieży w stowarzyszeniu |
| WATER_WARDEN | Opiekun wód w stowarzyszeniu |
| OTHER | Inna rola |
Signals używają niemal tych samych wartości w parties.role_holder.role.code. Dwie nazywają się tam inaczej: BOARD_MEMBER zamiast BOARD i AUTHORIZED_SIGNATORY zamiast PROCURA.
U wspólników rola jest w shareholders.entries[].role.label:
| Wartość | Znaczenie |
|---|---|
| SHAREHOLDER | Wspólnik (Gesellschafter), głównie GmbH lub UG |
| FULLY_LIABLE_PARTNER | Komplementariusz KG lub wspólnik OHG |
| LIMITED_PARTNER | Komandytariusz KG |
| PARTNER | Partner spółki partnerskiej |
| OWNER | Właściciel e.K. |
Tematy Signals
Każdy sygnał należy do tematu. Kod znajdziesz w event.topic, nazwę w event.topic_name. Jako filtr przekazujesz go w topics dokładnie w tej postaci.
| Wartość | Temat | Plan |
|---|---|---|
| NEW_REGISTRATIONS | NeueintragungenNeu ins Handelsregister eingetragene Unternehmen. | każde konto |
| MASTER_DATA_CHANGES | StammdatenänderungenÄnderungen von Firmenname, Sitz, Geschäftsanschrift oder Registerzuständigkeit. | każde konto |
| CLOSURES | Löschungen & AuflösungenAuflösung, Liquidation, Löschung oder Erlöschen von Unternehmen. | każde konto |
| ROLE_HOLDER_CHANGES | FührungswechselEintritte, Austritte und Wechsel von Geschäftsführung, Vorstand und Prokura. | każde konto |
| CAPITAL_CHANGES | KapitaländerungenÄnderungen am Stamm-, Grund-, Haft- oder genehmigten Kapital. | każde konto |
| INSOLVENCIES | InsolvenzenEröffnungen, Sicherungsmaßnahmen und Beendigungen von Insolvenzverfahren. | Pro, Max |
| TRANSFORMATIONS | Umwandlungen & M&AVerschmelzungen, Spaltungen, Formwechsel, Vermögensübertragungen, Unternehmensverträge und Squeeze-outs. | Max |
Więcej o tematach i filtrach w signals.
Typy dokumentów
Te wartości przekazujesz w document_type do fetch-document. Co zawierają dokumenty, opisuje Dokumenty.
| Wartość | Dokument | Format |
|---|---|---|
| AD | Aktueller Abdruck (odpis aktualny) | |
| CD | Chronologischer Abdruck (odpis chronologiczny) | |
| SI | Strukturierter Registerinhalt (ustrukturyzowana treść rejestru) | XML |
| shareholders_list | Gesellschafterliste (lista wspólników) | |
| articles_of_association | Gesellschaftsvertrag lub Satzung (umowa spółki lub statut) |
Branże (WZ)
Branże są w industry_classification: pod WZ2008 według klasyfikacji WZ 2008, a pod WZ2025 według WZ 2025. Każdy wpis ma code, np. 62.20.1, i niemiecką nazwę w label.
Obie klasyfikacje publikuje Federalny Urząd Statystyczny (Statistisches Bundesamt). Wszystkie kody z nazwami znajdziesz na serwerze klasyfikacji urzędów statystycznych federacji i krajów związkowych: WZ 2025 i WZ 2008. Firma może mieć kilka branż.
1{2 "name": "Hetzner Online GmbH",3 "industry_classification": {4 "WZ2008": [5 {6 "code": "62.01.0",7 "label": "Erbringung von Dienstleistungen der Informationstechnologie"8 },9 {10 "code": "63.11.0",11 "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"12 },13 {14 "code": "61.90.0",15 "label": "Telekommunikation, sonstige"16 }17 ],18 "WZ2025": [19 {20 "code": "62.20.1",21 "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"22 },23 {24 "code": "46.50.1",25 "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"26 },27 {28 "code": "62.90.0",29 "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"30 }31 ]32 }33}