Valores y códigos
Todos los valores fijos que aparecen en las respuestas.
Esta página recoge los valores fijos que aparecen en las respuestas, con su significado. Las listas son abiertas: pueden añadirse valores nuevos. Así que trata un valor desconocido como “otro” en lugar de fallar con un error.
Estado
El estado está en status en el perfil de empresa. Las Signals lo indican en organization.current_profile.status.code de forma más general.
| Valor | Significado | Aparece en |
|---|---|---|
| ACTIVE | Activa, la empresa está en el registro y en funcionamiento. | Perfil de empresa, Signals |
| INSOLVENT | Insolvente, hay un procedimiento de insolvencia inscrito. | Perfil de empresa, Signals |
| DISSOLVED | Disuelta, la empresa está en liquidación. | Perfil de empresa |
| TERMINATED | Cancelada, la hoja registral de la empresa se ha cerrado. | Perfil de empresa |
| INACTIVE | Ya no activa. Las Signals lo usan tanto para empresas disueltas como canceladas. | Signals, Socios en profundidad |
Las empresas canceladas también siguen disponibles, con todo su historial.
Formas jurídicas
La forma jurídica está en legal_form, normalmente como abreviatura. Es un texto, no un código fijo. Estos valores aparecen en respuestas reales:
| Valor | Forma jurídica | Registro |
|---|---|---|
| GmbH | Gesellschaft mit beschränkter Haftung (sociedad de responsabilidad limitada), también la gGmbH sin ánimo de lucro | HRB |
| UG (haftungsbeschränkt) | Unternehmergesellschaft (haftungsbeschränkt), una mini GmbH | HRB |
| gUG (haftungsbeschränkt) | Unternehmergesellschaft sin ánimo de lucro | HRB |
| AG | Aktiengesellschaft (sociedad anónima) | HRB |
| SE | Sociedad anónima europea (Societas Europaea) | HRB |
| KGaA | Kommanditgesellschaft auf Aktien (sociedad comanditaria por acciones) | HRB |
| GmbH & Co. KGaA | KGaA con una GmbH como socio colectivo | HRB |
| VVaG | Versicherungsverein auf Gegenseitigkeit (mutua de seguros) | HRB |
| KG | Kommanditgesellschaft (sociedad comanditaria) | HRA |
| GmbH & Co. KG | KG con una GmbH como Komplementärin, el socio colectivo | HRA |
| UG (haftungsbeschränkt) & Co. KG | KG con una UG como socio colectivo | HRA |
| AG & Co. KG | KG con una AG como socio colectivo | HRA |
| SE & Co. KG | KG con una SE como socio colectivo | HRA |
| OHG | Offene Handelsgesellschaft (sociedad colectiva) | HRA |
| GmbH & Co. OHG | OHG con una GmbH como socio | HRA |
| e.K. |
Eingetragener Kaufmann o eingetragene Kauffrau (comerciante individual inscrito). También se escribe eingetragener Kaufmann (e.K.). |
HRA |
| eG | Eingetragene Genossenschaft (cooperativa inscrita) | GnR |
| PartG | Partnerschaftsgesellschaft, una sociedad de profesiones liberales | PR |
| PartmbB | Partnerschaftsgesellschaft con responsabilidad profesional limitada (PartG mbB) | PR |
| e.V. | Eingetragener Verein (asociación inscrita) | VR |
| eGbR | Eingetragene Gesellschaft bürgerlichen Rechts (sociedad civil inscrita) | GsR |
| Ltd. | Forma jurídica extranjera, aquí la Limited británica con inscripción en el registro alemán | HRB |
La misma forma jurídica puede escribirse de distintas maneras. Así que compara con tolerancia o asigna los valores a tu propia lista. Para filtros, search-organizations tiene su propia lista fija en legal_form_code.
Tipos de registro y tribunales registrales
La inscripción registral está en registration: el tribunal registral en court, el tipo de registro en register_type y el número en register_number.
| Valor | Significado |
|---|---|
| HRB | Handelsregister (Registro Mercantil) sección B: sociedades de capital como GmbH, UG, AG, SE y KGaA |
| HRA | Handelsregister sección A: comerciantes individuales y sociedades mercantiles de personas como e.K., OHG y KG |
| GnR | Genossenschaftsregister: cooperativas inscritas |
| PR | Partnerschaftsregister: sociedades profesionales |
| VR | Vereinsregister: asociaciones inscritas |
| GsR | Gesellschaftsregister: sociedades civiles inscritas (eGbR), desde 2024 |
court nombra la localidad del tribunal registral tal como la escribe el registro, por ejemplo Ansbach, Charlottenburg (Berlin) o Frankfurt/Oder. Un número de registro solo es único junto con el tribunal y el tipo, por ejemplo Ansbach HRB 6089.
En datos anidados, por ejemplo en las partes de una fusión, el tribunal puede aparecer también con su nombre completo, por ejemplo Amtsgericht Nürnberg.
Tipos de capital
El tipo de capital inscrito está en capital.current.kind y, para importes anteriores, en capital.history[].value.kind.
| Valor | Significado | Aparece en |
|---|---|---|
| STAMMKAPITAL | Stammkapital (capital social), por ejemplo de una GmbH o UG | p. ej. GmbH, UG |
| GRUNDKAPITAL | Grundkapital (capital social), por ejemplo de una sociedad anónima | p. ej. AG, SE, KGaA |
| LIABILITY_SUM | Haftsumme (suma de responsabilidad), por ejemplo la fijada en los estatutos de una cooperativa | p. ej. eG |
| CONDITIONAL | Capital condicional de una AG, en inscripciones anteriores | p. ej. AG |
Las sociedades de personas, los comerciantes individuales y las asociaciones no tienen capital inscrito. Entonces capital.current es null y capital.history está vacío.
Cargos
El cargo de una persona está en related_persons.current[].label y related_persons.past[].label. role te da además el nombre del cargo en alemán e inglés.
| Valor | Significado |
|---|---|
| MANAGING_DIRECTOR | Administrador (Geschäftsführer o Geschäftsführerin) |
| TEMPORARY_MANAGING_DIRECTOR | Administrador de emergencia (Notgeschäftsführer), nombrado por el tribunal |
| BOARD | Miembro del consejo de dirección (Vorstand) |
| BOARD_CHAIR | Presidencia del consejo de dirección |
| DIRECTOR | Director ejecutivo, p. ej. de una SE |
| PROCURA | Prokura, el poder general mercantil inscrito |
| LIQUIDATOR | Liquidador, liquida una sociedad disuelta |
| INSOLVENCY_ADMINISTRATOR | Administrador concursal |
| REPRESENTATIVE | Representante o representante permanente, p. ej. de una sucursal |
| FULLY_LIABLE_PARTNER | Socio colectivo (persönlich haftender Gesellschafter, Komplementär) |
| LIMITED_PARTNER | Socio comanditario (Kommanditist), responde solo hasta su aportación |
| PARTNER | Socio de una PartG. Los socios de una OHG tienen FULLY_LIABLE_PARTNER. |
| OWNER | Titular, p. ej. de una e.K. |
| PROPRIETOR | Titular, mismo significado que OWNER |
| TREASURER | Tesorero de una asociación |
| SECRETARY | Secretario de una asociación |
| YOUTH_WARDEN | Responsable juvenil de una asociación |
| WATER_WARDEN | Responsable de aguas de una asociación |
| OTHER | Otro cargo |
Las Signals usan casi los mismos valores en parties.role_holder.role.code. Dos tienen allí otro nombre: BOARD_MEMBER en lugar de BOARD y AUTHORIZED_SIGNATORY en lugar de PROCURA.
En los socios, el cargo está en shareholders.entries[].role.label:
| Valor | Significado |
|---|---|
| SHAREHOLDER | Socio (Gesellschafter), sobre todo de una GmbH o UG |
| FULLY_LIABLE_PARTNER | Socio colectivo de una KG u OHG |
| LIMITED_PARTNER | Socio comanditario de una KG |
| PARTNER | Socio de una sociedad profesional |
| OWNER | Titular de una e.K. |
Temas de Signals
Cada señal pertenece a un tema. El código está en event.topic, el nombre en event.topic_name. Como filtro, pásalo exactamente así en topics.
| Valor | Tema | Plan |
|---|---|---|
| NEW_REGISTRATIONS | NeueintragungenNeu ins Handelsregister eingetragene Unternehmen. | cualquier cuenta |
| MASTER_DATA_CHANGES | StammdatenänderungenÄnderungen von Firmenname, Sitz, Geschäftsanschrift oder Registerzuständigkeit. | cualquier cuenta |
| CLOSURES | Löschungen & AuflösungenAuflösung, Liquidation, Löschung oder Erlöschen von Unternehmen. | cualquier cuenta |
| ROLE_HOLDER_CHANGES | FührungswechselEintritte, Austritte und Wechsel von Geschäftsführung, Vorstand und Prokura. | cualquier cuenta |
| CAPITAL_CHANGES | KapitaländerungenÄnderungen am Stamm-, Grund-, Haft- oder genehmigten Kapital. | cualquier cuenta |
| 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 |
Más sobre temas y filtros en signals.
Tipos de documento
Estos valores los pasas en document_type a fetch-document. Lo que contienen los documentos está en Documentos.
| Valor | Documento | Formato |
|---|---|---|
| AD | Aktueller Abdruck (extracto actual) | |
| CD | Chronologischer Abdruck (extracto cronológico) | |
| SI | Strukturierter Registerinhalt (contenido estructurado del registro) | XML |
| shareholders_list | Gesellschafterliste (lista de socios) | |
| articles_of_association | Gesellschaftsvertrag o Satzung (estatutos) |
Sectores (WZ)
Los sectores están en industry_classification: en WZ2008 según la clasificación WZ 2008 y en WZ2025 según WZ 2025. Cada entrada tiene un code como 62.20.1 y un nombre en alemán en label.
Ambas clasificaciones las publica la Oficina Federal de Estadística (Statistisches Bundesamt). Todos los códigos con sus nombres están en el servidor de clasificaciones de las oficinas estadísticas de la Federación y los estados federados: WZ 2025 y WZ 2008. Una empresa puede tener varios sectores.
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}