Valores e códigos

A situação está em status no perfil da empresa. Os Signals a informam em organization.current_profile.status.code, de forma mais genérica.

Empresas canceladas também continuam disponíveis, com todo o histórico.

A forma jurídica está em legal_form, geralmente como abreviação. É um texto, não um código fixo. Estes valores aparecem em respostas reais:

A mesma forma jurídica pode ser escrita de maneiras diferentes. Por isso, compare com tolerância ou mapeie os valores para uma lista própria. Para filtros, search-organizations tem sua própria lista fixa em legal_form_code.

O registro está em registration: o tribunal de registro em court, o tipo de registro em register_type e o número em register_number.

court indica o local do tribunal de registro como o registro o escreve, por exemplo Ansbach, Charlottenburg (Berlin) ou Frankfurt/Oder. Um número de registro só é único junto com tribunal e tipo, por exemplo Ansbach HRB 6089.

Em dados embutidos, por exemplo para as partes de uma fusão, o tribunal também pode aparecer com o nome completo, por exemplo Amtsgericht Nürnberg.

O tipo do capital registrado está em capital.current.kind e, para valores anteriores, em capital.history[].value.kind.

Sociedades de pessoas, empresários individuais e associações não têm capital registrado. Então capital.current é null e capital.history fica vazio.

A função de uma pessoa está em related_persons.current[].label e related_persons.past[].label. role também traz o nome da função em alemão e inglês.

Os Signals usam quase os mesmos valores em parties.role_holder.role.code. Dois têm outro nome lá: BOARD_MEMBER em vez de BOARD e AUTHORIZED_SIGNATORY em vez de PROCURA.

Para sócios, a função está em shareholders.entries[].role.label:

Todo sinal pertence a um tema. O código está em event.topic, o nome em event.topic_name. Como filtro, passe-o em topics exatamente assim.

Mais sobre temas e filtros em signals.

Você passa esses valores em document_type para fetch-document. O que os documentos contêm está em Documentos.

Os setores estão em industry_classification: em WZ2008 segundo a classificação WZ 2008 e em WZ2025 segundo a WZ 2025. Cada entrada tem um code como 62.20.1 e um nome em alemão em label.

As duas classificações são publicadas pelo Departamento Federal de Estatística (Statistisches Bundesamt). Você encontra todos os códigos com seus nomes no servidor de classificações dos institutos de estatística da Federação e dos estados: WZ 2025 e WZ 2008. Uma empresa pode ter vários setores.