값과 코드
응답에 나타나는 모든 고정 값.
이 페이지에는 응답에 나오는 고정 값과 그 의미가 있어요. 목록은 열려 있어서 새 값이 추가될 수 있어요. 그러니 알 수 없는 값은 오류로 실패하지 말고 “기타”처럼 다루세요.
상태
상태는 회사 프로필의 status에 있어요. Signals는 organization.current_profile.status.code에 더 대략적인 형태로 알려 줘요.
| 값 | 의미 | 나오는 곳 |
|---|---|---|
| ACTIVE | 활성, 회사가 등기부에 있고 운영 중이에요. | 회사 프로필, Signals |
| INSOLVENT | 파산, 파산 절차가 등기되어 있어요. | 회사 프로필, Signals |
| DISSOLVED | 해산, 회사가 청산 중이에요. | 회사 프로필 |
| TERMINATED | 말소, 등기부의 회사 등기가 폐쇄되었어요. | 회사 프로필 |
| INACTIVE | 더 이상 활성 상태가 아니에요. Signals는 해산된 회사와 말소된 회사 모두에 이 값을 써요. | Signals, 심층 주주 정보 |
말소된 회사도 전체 이력과 함께 계속 제공돼요.
법적 형태
법적 형태는 legal_form에 대개 약어로 있어요. 고정 코드가 아니라 텍스트예요. 실제 응답에는 다음 값이 나와요:
| 값 | 법적 형태 | 등기부 |
|---|---|---|
| GmbH | Gesellschaft mit beschränkter Haftung(유한책임회사), 비영리 gGmbH 포함 | HRB |
| UG (haftungsbeschränkt) | Unternehmergesellschaft (haftungsbeschränkt), 소규모 GmbH | HRB |
| gUG (haftungsbeschränkt) | 비영리 Unternehmergesellschaft | HRB |
| AG | Aktiengesellschaft(주식회사) | HRB |
| SE | 유럽 회사(Societas Europaea) | HRB |
| KGaA | Kommanditgesellschaft auf Aktien(주식합자회사) | HRB |
| GmbH & Co. KGaA | GmbH가 무한책임사원인 KGaA | HRB |
| VVaG | Versicherungsverein auf Gegenseitigkeit(상호보험조합) | HRB |
| KG | Kommanditgesellschaft(합자회사) | HRA |
| GmbH & Co. KG | GmbH가 무한책임사원(Komplementärin)인 KG | HRA |
| UG (haftungsbeschränkt) & Co. KG | UG가 무한책임사원인 KG | HRA |
| AG & Co. KG | AG가 무한책임사원인 KG | HRA |
| SE & Co. KG | SE가 무한책임사원인 KG | HRA |
| OHG | Offene Handelsgesellschaft(합명회사) | HRA |
| GmbH & Co. OHG | GmbH가 사원인 OHG | HRA |
| e.K. |
Eingetragener Kaufmann 또는 eingetragene Kauffrau(등기된 개인 상인). eingetragener Kaufmann (e.K.)로도 써요. |
HRA |
| eG | Eingetragene Genossenschaft(등기된 협동조합) | GnR |
| PartG | Partnerschaftsgesellschaft, 자유 전문직의 파트너십 | PR |
| PartmbB | 직업상 책임이 제한된 Partnerschaftsgesellschaft(PartG mbB) | PR |
| e.V. | Eingetragener Verein(등기된 사단) | VR |
| eGbR | Eingetragene Gesellschaft bürgerlichen Rechts(등기된 민법상 조합) | GsR |
| Ltd. | 외국 법적 형태, 여기서는 독일 등기부에 등기된 영국 Limited | HRB |
같은 법적 형태도 철자가 다를 수 있어요. 그러니 너그럽게 비교하거나 값을 자체 목록에 매핑하세요. 필터용으로는 search-organizations의 legal_form_code에 고정 목록이 따로 있어요.
등기 유형과 등기 법원
등기는 registration에 있어요: 등기 법원은 court, 등기 유형은 register_type, 번호는 register_number.
| 값 | 의미 |
|---|---|
| HRB | Handelsregister(상업 등기부) B부: GmbH, UG, AG, SE, KGaA 같은 자본회사 |
| HRA | Handelsregister A부: e.K., OHG, KG 같은 개인 상인과 상사 인적 회사 |
| GnR | Genossenschaftsregister: 등기된 협동조합 |
| PR | Partnerschaftsregister: 전문직 파트너십 |
| VR | Vereinsregister: 등기된 사단 |
| GsR | Gesellschaftsregister: 등기된 민법상 조합(eGbR), 2024년부터 |
court는 등기부에 적힌 대로 등기 법원의 소재지를 알려 줘요. 예: Ansbach, Charlottenburg (Berlin), Frankfurt/Oder. 등기 번호는 법원, 유형과 함께일 때만 고유해요. 예: Ansbach HRB 6089.
합병 당사자 같은 내장 데이터에서는 법원이 전체 명칭으로 나올 수도 있어요. 예: Amtsgericht Nürnberg.
자본금 종류
등기된 자본금의 종류는 capital.current.kind에, 이전 금액은 capital.history[].value.kind에 있어요.
| 값 | 의미 | 나오는 곳 |
|---|---|---|
| STAMMKAPITAL | Stammkapital(출자 자본금), 예: GmbH나 UG | 예: GmbH, UG |
| GRUNDKAPITAL | Grundkapital(주식 자본금), 예: 주식회사 | 예: AG, SE, KGaA |
| LIABILITY_SUM | Haftsumme(책임액), 예: 협동조합 정관에 정한 것 | 예: eG |
| CONDITIONAL | AG의 조건부 자본금, 이전 등기에서 | 예: AG |
인적 회사, 개인 상인, 사단은 등기된 자본금이 없어요. 이때 capital.current는 null이고 capital.history는 비어 있어요.
역할
인물의 역할은 related_persons.current[].label과 related_persons.past[].label에 있어요. role은 역할 이름을 독일어와 영어로도 알려 줘요.
| 값 | 의미 |
|---|---|
| MANAGING_DIRECTOR | 대표이사(Geschäftsführer 또는 Geschäftsführerin) |
| TEMPORARY_MANAGING_DIRECTOR | 법원이 선임한 긴급 대표이사(Notgeschäftsführer) |
| BOARD | 이사회 구성원(Vorstand) |
| BOARD_CHAIR | 이사회 의장 |
| DIRECTOR | 집행 이사, 예: SE |
| PROCURA | Prokura, 등기된 대리권 |
| LIQUIDATOR | 청산인, 해산된 회사를 정리 |
| INSOLVENCY_ADMINISTRATOR | 파산 관재인 |
| REPRESENTATIVE | 대리인 또는 상임 대리인, 예: 지점 |
| FULLY_LIABLE_PARTNER | 무한책임사원(persönlich haftender Gesellschafter, Komplementär) |
| LIMITED_PARTNER | 유한책임사원(Kommanditist), 출자액까지만 책임 |
| PARTNER | PartG의 파트너. OHG의 사원은 FULLY_LIABLE_PARTNER예요. |
| OWNER | 소유자, 예: e.K. |
| PROPRIETOR | 소유자, OWNER와 같은 의미 |
| TREASURER | 사단의 회계 담당 |
| SECRETARY | 사단의 서기 |
| YOUTH_WARDEN | 사단의 청소년 담당 |
| WATER_WARDEN | 사단의 수상 안전 담당 |
| OTHER | 기타 역할 |
Signals는 parties.role_holder.role.code에 거의 같은 값을 써요. 두 가지는 이름이 달라요: BOARD 대신 BOARD_MEMBER, PROCURA 대신 AUTHORIZED_SIGNATORY.
주주의 역할은 shareholders.entries[].role.label에 있어요:
| 값 | 의미 |
|---|---|
| SHAREHOLDER | 주주(Gesellschafter), 주로 GmbH나 UG |
| FULLY_LIABLE_PARTNER | KG나 OHG의 무한책임사원 |
| LIMITED_PARTNER | KG의 유한책임사원 |
| PARTNER | 전문직 파트너십의 파트너 |
| OWNER | e.K.의 소유자 |
Signals 주제
모든 Signal은 주제에 속해요. 코드는 event.topic에, 이름은 event.topic_name에 있어요. 필터로 쓸 때는 topics에 그대로 넘기세요.
| 값 | 주제 | 플랜 |
|---|---|---|
| NEW_REGISTRATIONS | NeueintragungenNeu ins Handelsregister eingetragene Unternehmen. | 모든 계정 |
| MASTER_DATA_CHANGES | StammdatenänderungenÄnderungen von Firmenname, Sitz, Geschäftsanschrift oder Registerzuständigkeit. | 모든 계정 |
| CLOSURES | Löschungen & AuflösungenAuflösung, Liquidation, Löschung oder Erlöschen von Unternehmen. | 모든 계정 |
| ROLE_HOLDER_CHANGES | FührungswechselEintritte, Austritte und Wechsel von Geschäftsführung, Vorstand und Prokura. | 모든 계정 |
| CAPITAL_CHANGES | KapitaländerungenÄnderungen am Stamm-, Grund-, Haft- oder genehmigten Kapital. | 모든 계정 |
| 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 |
주제와 필터에 대한 자세한 내용은 signals에 있어요.
문서 유형
이 값을 document_type에 넣어 fetch-document에 넘겨요. 문서에 담긴 내용은 문서에 있어요.
| 값 | 문서 | 형식 |
|---|---|---|
| AD | Aktueller Abdruck(현재 등본) | |
| CD | Chronologischer Abdruck(연대순 등본) | |
| SI | Strukturierter Registerinhalt(구조화 등기 내용) | XML |
| shareholders_list | Gesellschafterliste(주주 명부) | |
| articles_of_association | Gesellschaftsvertrag 또는 Satzung(정관) |
업종(WZ)
업종은 industry_classification에 있어요: WZ2008에는 WZ 2008 분류, WZ2025에는 WZ 2025 분류. 각 항목에는 62.20.1 같은 code와 label의 독일어 이름이 있어요.
두 분류 모두 연방 통계청(Statistisches Bundesamt)이 발행해요. 모든 코드와 이름은 연방과 주 통계청의 분류 서버에 있어요: WZ 2025, WZ 2008. 한 회사가 여러 업종을 가질 수 있어요.
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}