Firmradar (Publisher Independente) (versão prévia)
Plataforma de enriquecimento para inteligência da empresa norueguesa. Funde dados de BRREG, Skatteetaten, PEP estrangeiro e registros de sanções, registros de concessões públicas e sinais de socorro, com enriquecimento proprietário em cima (pontuação de risco, correspondência de pessoas difusas, análise de grupo, conformidade de nível de auditoria). Criado para KYC, AML, crédito, propriedade e fluxos de trabalho de risco.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte do Firmradar |
| URL | https://firmaradar.no/kontakt |
| support@firmaradar.no |
| Metadados do conector | |
|---|---|
| Publicador | Tiwas |
| Site | https://firmaradar.no |
| Política de privacidade | https://firmaradar.no/personvern |
| Categories | Dados; Business Intelligence |
Firmradar (Publisher independente)
Firmaradar é uma plataforma de enriquecimento para a inteligência da empresa norueguesa. Ele funde dados de várias fontes autoritativas – o Registro Empresarial Norueguês (Brønnøysundregistrene), a Administração Tributária Norueguesa (Skatteetaten) e os registros de PEP e sanções estrangeiras – e adiciona enriquecimento proprietário em cima: classificação de angústia, pontuação de risco transparente, correspondência de pessoas difusa, análise de estrutura de grupo e pipelines de conformidade de nível de auditoria. Esse conector expõe 21 operações que você pode soltar em um fluxo para enriquecer clientes, fornecedores, parceiros e equivalentes com inteligência de empresa norueguesa estruturada.
Publisher: Lars Kvanum
Proprietário da pilha: Firmradar AS (Noruega).
Pré-requisitos
- Uma conta do Firmradar ativa em https://firmaradar.no.
- Uma chave de API pessoal emitida por meio do min side → API-nøkler (https://firmaradar.no/min-side/api-keys). A chave é enviada como o
X-API-Keycabeçalho HTTP em cada solicitação. - Uma assinatura ativa para as operações que você pretende usar. Algumas operações exigem um DPA (contrato de processamento de dados) assinado em sua conta do Firmradar , principalmente a triagem de AML e PEP.
A camada gratuita abrange uma fatia generosa do perfil da empresa, propriedade, funções, histórico financeiro e operações de anúncio. As operações de camada de conformidade (AML, pontuação de risco de nível de auditoria) exigem um plano pago e uma aceitação explícita da DPA.
Operações com suporte
O conector expõe 21 operações de produção em seis áreas funcionais. Muitas operações combinam várias fontes upstream por trás de uma única chamada.
Empresa
Procure um perfil completo da empresa pelo número da organização, expanda sua árvore de propriedade e quadro ou funções signatárias, recupere histórico financeiro de vários anos, acompanhe as alterações recentes do registro, pesquise o universo da empresa e compare duas empresas lado a lado.
Pessoa
Procure uma pessoa, resolva as funções que uma pessoa tem entre as empresas e liste as participações compartilhadas que uma pessoa controla.
Risco
Recupere sinais de risco para uma empresa, pesquise o feed de anúncios do Registro, busque uma pontuação de risco transparente (0 a 100) com uma quebra de componente e execute uma avaliação estatutária de angústia "foretak i vanskeligheter" (empresa em dificuldade).
Setor
Liste empresas em um código do setor NACE e localize empresas relacionadas a uma determinada empresa por meio de propriedade ou funções.
AML
Tela de uma pessoa ou empresa em relação às listas AML e PEP e recupere uma pontuação AML combinada. Essas operações são fechadas atrás de uma DPA assinada e são mantidas em um log de auditoria.
Suporte ao grupo
Recupere uma visão geral do suporte ao grupo público e da exposição de concessões (Innovasjon Norge/SkatteFUNN) para uma empresa.
Além disso, três aliases de documentação são expostos na especificação para fornecer um mapeamento um-para-um com o catálogo de ferramentas do Firmradar MCP; estes encaminham para o mesmo back-end que as operações canônicas acima.
Obtendo credenciais
- https://firmaradar.no Entre com uma conta do Firmaradar verificada.
- Abra Min side → API-nøkler (chaves de API de → de minha conta).
- Clique em Generer ny API-nøkkel (Gerar nova chave) e copie a chave. A chave completa é mostrada apenas uma vez – armazene-a em um gerenciador de segredos ou em suas configurações de conexão.
- Ao criar um fluxo que usa esse conector, cole a chave no campo de conexão de chave da API firmradar .
Você pode revogar ou girar a chave da mesma página a qualquer momento.
Introdução
- Crie uma conexão e cole sua chave de API firmradar no campo de chave da API firmradar .
- Adicione uma ação firmradar ao seu fluxo , por exemplo , Obter empresa com um número de organização como
923609016(Equinor ASA). - Use a saída estruturada em etapas downstream: poste um alerta de risco no Teams, grave um registro KYC no Dataverse ou enriqueça um lead crm.
Problemas e limitações conhecidos
- Respostas em língua norueguesa. Rótulos de campo e cadeias de caracteres legíveis por humanos em respostas são escritos em norueguês (bokmål), refletindo os registros de origem. Resumos em inglês são incluídos quando prático.
- Limites de taxa. As contas de camada livre são limitadas a 60 solicitações por minuto. As operações AML têm um limite mais rigoroso de 50 solicitações por 30 minutos, independentemente do plano.
- Log de auditoria. As chamadas para operações de risco do AML e do marketplace são mantidas em um log de auditoria por 60 meses, conforme exigido pelas regulamentações norueguesas de KYC. O
X-FR-Purposecabeçalho eX-FR-DPA-Confirmedos cabeçalhos devem ser definidos em chamadas AML; cabeçalhos ausentes retornam HTTP 403. - Portões de conformidade. A
getRiskScoreoperação pode retornar HTTP 403 até queerror_code=marketplace_hiddena conta passe pelo portão de conformidade relevante. A especificação marca essa operação com ax-firmaradar-compliance-gateextensão para que os clientes possam ocultá-la ou desabilitá-la dinamicamente. - Somente números de organização de 9 dígitos. Todos os
orgnrparâmetros de caminho devem ter exatamente 9 dígitos (formato de número de organização norueguês). - Cursores de paginação opacas. O
next_cursorvalor retornado por operações paginadas deve ser passado de volta verbatim – não analise nem modifique-o.
Perguntas frequentes
Tenho que ser uma empresa norueguesa para usar esse conector?
Não. Bancos não noruegueses, fornecedores de KYC, plataformas AML e consultores de M&A podem chamar Firmradar como seu back-end norueguês canônico e costurar o resultado em uma visão mais ampla de conformidade de várias jurisdições.
Isso é apenas um wrapper em torno do registro de negócios público?
Não. Somente os dados do Registro Público raramente respondem a uma pergunta de negócios real. O Firmradar reconcilia várias fontes e camadas de sinais proprietários — correspondência de pessoas, modelagem de risco, análise de grupo e encanamento de conformidade — para que uma única chamada retorne uma exibição pronta para decisão.
Instruções de implantação
Após a certificação, os usuários finais não precisam instalar o conector manualmente– ele fica disponível no catálogo de conectores padrão em Power Automate, Power Apps e Aplicativos Lógicos. Os desenvolvedores que desejam implantar antes que a certificação possa ser executada:
paconn create --api-prop apiProperties.json \
--api-def apiDefinition.swagger.json \
--icon icon.png
Consulte https://learn.microsoft.com/en-us/connectors/custom-connectors/paconn-cli a referência completa da CLI.
Suporte
- Problemas com a definição do conector (Swagger, ícone, metadados): registre um problema ou solicitação de pull em .https://github.com/microsoft/PowerPlatformConnectors
- Problemas com a API firmradar (dados, limites de taxa, acesso à conta): contate support@firmaradar.no.
- Documentação geral do Firmradar:https://firmaradar.no/api-dokumentasjon.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| chave_de_api | Securestring | O api_key desta api | Verdade |
Ações
| Comparar métricas financeiras entre empresas |
Orquestração do lado do servidor: busca o histórico financeiro para várias empresas em paralelo e as retorna em um formato de comparação amigável à tabela para benchmarking. |
| Empresas de pesquisa (nome, NACE, município) |
Pesquisa unificada entre o nome da empresa, o código do setor NACE e o município. Retorna resultados paginados com cursor estável para a próxima página. |
| Exposição de concessões públicas entre grupos |
Estrutura de árvores de subvenções públicas (concessões nav, suporte da Covid-19, Innovasjon Norge, SkatteFUNN, concessões da UE) recebidas por uma empresa e seu grupo. Usado para due-diligence na exposição do setor público. |
| Gerar relatório E pontuação de AML (fluxo de duas chamadas) |
Gera um relatório AML para uma empresa e retorna uma pontuação estruturada (0-100) com divisão de fator. Fluxo de duas chamadas do lado do servidor; o cliente vê uma resposta estruturada. |
| Listar empresas em um código do setor NACE |
Retorna empresas registradas com um determinado código do setor NACE (correspondência de prefixo). Dá suporte a filtros de município e de funcionários; paginado com cursor estável. |
| Localizar empresas relacionadas (pessoas compartilhadas ou endereço) |
Localiza empresas compartilhando funções ou endereço comercial com a empresa de entrada. Usado para due-diligence e mapeamento de rede. |
| Obter alterações recentes (alias ao ponto de extremidade de alterações) |
Alias de documentação usado pelo catálogo de ferramentas MCP (get_recent_changes). Encaminha para o ponto de extremidade canônico /company/{orgnr}/changes. |
| Obter comunicados brreg e alterações recentes |
Retorna comunicados brreg (eventos legais) e alterações recentes (função, endereço, sinal, assinatura) dentro da janela configurada para uma empresa. Usado para monitoramento e controle de alterações. |
| Obter comunicados do BRREG (alias para o ponto de extremidade de alterações) |
Alias de documentação usado pelo catálogo de ferramentas MCP (get_company_announcements). Encaminha para o ponto de extremidade canônico /company/{orgnr}/changes. |
| Obter funções de empresa (conselho, CEO, signatários) |
Retorna os titulares da função BRREG (presidente, membro do conselho, CEO, signatário, procuração) para uma empresa. Filtro opcional no tipo de função e inclusão de funções históricas. |
| Obter histórico completo de função para uma pessoa |
Retorna o histórico de função completo (ativo e histórico) para uma pessoa de função identificada pelo role_person_id estável. |
| Obter histórico financeiro |
Retorna histórico financeiro (receita, resultado operacional, patrimônio líquido, ativos totais, funcionários) por até 10 anos para uma empresa norueguesa. |
| Obter o perfil completo da empresa |
Retorna o perfil completo da empresa para um número de organização norueguês (orgnr): status do registro, na indústria NACE, funcionários, endereço, histórico financeiro, árvore de propriedade e funções-chave. Combina BRREG, dados financeiros e enriquecimento proprietário. |
| Obter o portfólio de participação acionária para uma pessoa |
Retorna todas as empresas em que uma pessoa detém compartilhamentos, com percentual de propriedade e detalhes de classe compartilhada, identificados por owner_person_key estáveis. |
| Obter perfil de pessoa (orquestração do lado do cliente) |
Auxiliar do lado do cliente que orquestra searchPersons + getPersonRoles + getPersonCompanies em uma única exibição de perfil. Documentado aqui para paridade com o catálogo de ferramentas DO MCP. |
| Obter árvore de propriedade (para cima, para baixo ou ambos) |
Retorna a árvore de propriedade de uma empresa.
|
| Pesquisar comunicados do BRREG entre empresas |
Pesquise entre orgnrs nos comunicados do BRREG. Filtrar por tipo, intervalo de datas, status. Usado para monitoramento de portfólio e pesquisas ad hoc. |
| Pessoas de pesquisa (acionistas e detentores de função) |
Pesquise pessoas entre detentores de funções brreg e registro de acionistas. Dá suporte à correspondência de nome difusa com a expansão inicial e a remoção do nome do meio; filtro opcional de ano de nascimento. |
| Pontuação de risco 0-100 com nível e componentes |
Pontuação de risco estruturado (0-100) com nível nomeado (baixo/moderado/alto/crítico) e divisão de componentes para a integridade financeira da empresa. Retorna blocked_enk erro para proprietários exclusivos. Não é uma verificação de crédito pessoal. |
| Sinais de risco agregados |
Agrega sinais de três fontes: sinais de anúncio kyc (falência, fusão, divisão), classificação de angústia (FIV) e sinais de equilíbrio provisório. |
| Status de FIV (empresa em dificuldade) |
Avalia se uma empresa se qualifica como "foretak i vanskeligheter" (FIV/empresa em dificuldade) de acordo com as regras norueguesas NUES a-e, com base nas demonstrações financeiras mais recentes disponíveis. |
| Triagem AML e PEP (requer cabeçalhos DPA) |
Exibe uma pessoa contra sanções e listas pep. Requer cabeçalhos DPA e X-FR-Purpose por chamada mais X-FR-DPA-Confirmed. Todas as chamadas são registradas em log de auditoria por 60 meses, conforme exigido pelas regulamentações norueguesas do KYC. |
Comparar métricas financeiras entre empresas
Orquestração do lado do servidor: busca o histórico financeiro para várias empresas em paralelo e as retorna em um formato de comparação amigável à tabela para benchmarking.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
orgnrs
|
orgnrs | True | array of string | |
|
Anos
|
years | integer | ||
|
métricas
|
metrics | array of string |
Retornos
- Body
- CompareResponse
Empresas de pesquisa (nome, NACE, município)
Pesquisa unificada entre o nome da empresa, o código do setor NACE e o município. Retorna resultados paginados com cursor estável para a próxima página.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Consulta de pesquisa
|
q | string |
A consulta de pesquisa de texto livre correspondeu ao nome da empresa ou ao número da organização. |
|
|
Filtro NACE
|
nace | string |
Filtrar resultados por código do setor NACE (2 a 5 dígitos, correspondência de prefixo com suporte). |
|
|
Municipality
|
kommune | string |
Código do município norueguês (4 dígitos, por exemplo, 0301 para Oslo) usado para filtrar os resultados geograficamente. |
|
|
Limit
|
limit | integer |
Número máximo de itens a serem retornados nesta página. O padrão e o máximo variam por ponto de extremidade. |
|
|
Cursor de paginação
|
cursor | string |
Cursor de paginação opaca retornado por uma chamada anterior. Passe-o de volta verbatim para buscar a próxima página. Não analise nem modifique. |
Retornos
Exposição de concessões públicas entre grupos
Estrutura de árvores de subvenções públicas (concessões nav, suporte da Covid-19, Innovasjon Norge, SkatteFUNN, concessões da UE) recebidas por uma empresa e seu grupo. Usado para due-diligence na exposição do setor público.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
Retornos
Gerar relatório E pontuação de AML (fluxo de duas chamadas)
Gera um relatório AML para uma empresa e retorna uma pontuação estruturada (0-100) com divisão de fator. Fluxo de duas chamadas do lado do servidor; o cliente vê uma resposta estruturada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
orgnr
|
orgnr | True | string | |
|
objetivo
|
purpose | string |
DPA-formål para triagem de AML (eks). |
Retornos
- Body
- AmlScoreResponse
Listar empresas em um código do setor NACE
Retorna empresas registradas com um determinado código do setor NACE (correspondência de prefixo). Dá suporte a filtros de município e de funcionários; paginado com cursor estável.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Código NACE
|
code | True | string |
Prefixo NACE-kode eller (eks. |
|
Filtro de status
|
status | string |
Filtrar o status legal (por exemplo, ativo, under_liquidation, struck_off). |
|
|
Municipality
|
kommune | string |
Código do município norueguês (4 dígitos, por exemplo, 0301 para Oslo) usado para filtrar os resultados geograficamente. |
|
|
Funcionários mínimos
|
min_ansatte | integer |
Número mínimo de funcionários que a empresa deve ter (inclusive). |
|
|
Funcionários máximos
|
max_ansatte | integer |
Número máximo de funcionários que a empresa deve ter (inclusive). |
|
|
Limit
|
limit | integer |
Número máximo de itens a serem retornados nesta página. O padrão e o máximo variam por ponto de extremidade. |
|
|
Cursor de paginação
|
cursor | string |
Cursor de paginação opaca retornado por uma chamada anterior. Passe-o de volta verbatim para buscar a próxima página. Não analise nem modifique. |
|
|
Incluir totais
|
include_total | integer |
Se verdadeiro, inclui totais de agregação de grupo na resposta. |
Retornos
Localizar empresas relacionadas (pessoas compartilhadas ou endereço)
Localiza empresas compartilhando funções ou endereço comercial com a empresa de entrada. Usado para due-diligence e mapeamento de rede.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
|
Relação por meio de
|
via | string |
Como a relação é determinada. 'person' usa detentores de função compartilhados; O 'endereço' usa o endereço comercial compartilhado. |
|
|
Limit
|
limit | integer |
Número máximo de itens a serem retornados nesta página. O padrão e o máximo variam por ponto de extremidade. |
|
|
Sobreposição mínima
|
min_overlap | integer |
Número mínimo de pessoas ou endereços compartilhados necessários para uma correspondência entre empresas relacionadas. |
Retornos
Obter alterações recentes (alias ao ponto de extremidade de alterações)
Alias de documentação usado pelo catálogo de ferramentas MCP (get_recent_changes). Encaminha para o ponto de extremidade canônico /company/{orgnr}/changes.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
Retornos
- response
- array of Announcement
Obter comunicados brreg e alterações recentes
Retorna comunicados brreg (eventos legais) e alterações recentes (função, endereço, sinal, assinatura) dentro da janela configurada para uma empresa. Usado para monitoramento e controle de alterações.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
Retornos
- response
- array of Announcement
Obter comunicados do BRREG (alias para o ponto de extremidade de alterações)
Alias de documentação usado pelo catálogo de ferramentas MCP (get_company_announcements). Encaminha para o ponto de extremidade canônico /company/{orgnr}/changes.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
Retornos
- response
- array of Announcement
Obter funções de empresa (conselho, CEO, signatários)
Retorna os titulares da função BRREG (presidente, membro do conselho, CEO, signatário, procuração) para uma empresa. Filtro opcional no tipo de função e inclusão de funções históricas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
|
Incluir histórico
|
include_historic | integer |
Se verdadeiro, inclui detentores de função históricos (resignados) além dos atuais. |
|
|
Tipo de função
|
role_type | string |
Filtre o código de tipo de função norueguês (por exemplo, styreleder, daglig_leder, signatur). Consulte os documentos do Firmradar para obter a lista completa. |
Retornos
- Body
- RolesResponse
Obter histórico completo de função para uma pessoa
Retorna o histórico de função completo (ativo e histórico) para uma pessoa de função identificada pelo role_person_id estável.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da pessoa da função
|
role_person_id | True | string |
ID estável identificando um titular de função, retornado por searchPersons ou pontos de extremidade de funções. |
Retornos
- Body
- RolePersonProfile
Obter histórico financeiro
Retorna histórico financeiro (receita, resultado operacional, patrimônio líquido, ativos totais, funcionários) por até 10 anos para uma empresa norueguesa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
|
Anos atrás
|
years | integer |
Número de anos de histórico financeiro a serem retornados (1 a 10). |
|
|
Tipo de instrução
|
regnskapstype | string |
Tipo de demonstração financeira para filtrar (por exemplo, selskap, konsern). O padrão retorna a instrução canônica. |
|
|
Ignorar cache de atualização
|
skip_freshness | integer |
Se for true, ignorará o cache de atualização e forçará uma atualização upstream. Use com moderação. |
Retornos
Obter o perfil completo da empresa
Retorna o perfil completo da empresa para um número de organização norueguês (orgnr): status do registro, na indústria NACE, funcionários, endereço, histórico financeiro, árvore de propriedade e funções-chave. Combina BRREG, dados financeiros e enriquecimento proprietário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
9-sifret organisasjonsnummer. |
|
Campos
|
fields | string |
Subconjunto komma-separert, eks.
|
|
|
Incluir proprietários
|
owners | string |
Se for true, inclui informações de propriedade na resposta. |
|
|
Incluir concessões
|
grants | integer |
Se verdadeiro, inclui dados de concessões públicas na resposta. |
|
|
Incluir concessões brreg
|
brreg_grants | integer |
Se verdadeiro, inclui dados de concessões públicas brreg na resposta. Adiciona uma chamada upstream extra. |
|
|
Métricas financeiras
|
financial_metrics | integer |
Lista separada por vírgulas de métricas financeiras a serem incluídas (receita, operating_result, patrimônio líquido etc.). |
Retornos
- Body
- Company
Obter o portfólio de participação acionária para uma pessoa
Retorna todas as empresas em que uma pessoa detém compartilhamentos, com percentual de propriedade e detalhes de classe compartilhada, identificados por owner_person_key estáveis.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de pessoa do proprietário
|
owner_person_key | True | string |
Chave estável identificando um acionista pessoal, retornado por searchPersons ou pontos de extremidade de propriedade. |
Retornos
- Body
- PersonProfile
Obter perfil de pessoa (orquestração do lado do cliente)
Auxiliar do lado do cliente que orquestra searchPersons + getPersonRoles + getPersonCompanies em uma única exibição de perfil. Documentado aqui para paridade com o catálogo de ferramentas DO MCP.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
name | True | string |
Nome completo ou parcial da pessoa. A correspondência difusa com a expansão inicial e a remoção de nome médio é aplicada automaticamente. |
|
Ano de nascimento
|
birth_year | integer |
Ano de nascimento de quatro dígitos usado como um filtro adicional na pesquisa de pessoas para desambiguar nomes comuns. |
Retornos
- Body
- PersonProfile
Obter árvore de propriedade (para cima, para baixo ou ambos)
Retorna a árvore de propriedade de uma empresa.
direction=down lista subsidiárias; direction=up rastreia as empresas-mãe; direction=both retorna o grupo completo. Profundidade opcional (1-12) e include_persons para acionistas pessoais.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
|
Direção da árvore
|
direction | string |
Direção de passagem de árvore. 'down' retorna subsidiárias; 'up' retorna os pais; 'both' retorna o grupo completo. |
|
|
Profundidade da árvore
|
depth | integer |
Quantos níveis da árvore de propriedade a percorrer. Inteiro 1-12. Profundidade mais alta significa chamada mais lenta. |
|
|
Incluir pessoas
|
include_persons | integer |
Se for verdade, inclui acionistas pessoais na árvore de propriedade (caso contrário, apenas entidades legais). |
Retornos
- Body
- OwnershipResponse
Pesquisar comunicados do BRREG entre empresas
Pesquise entre orgnrs nos comunicados do BRREG. Filtrar por tipo, intervalo de datas, status. Usado para monitoramento de portfólio e pesquisas ad hoc.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Filtro de tipo
|
type | string |
Filtre o tipo do item (varia por ponto de extremidade; consulte a descrição da operação). |
|
|
Data de
|
from | date |
Início do intervalo de datas no formato ISO (YYYY-MM-DD). Inclusive. |
|
|
Data para
|
to | date |
Intervalo de datas no formato ISO (YYYY-MM-DD). Inclusive. |
|
|
Número da organização
|
orgnr | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
|
|
Consulta de pesquisa
|
q | string |
A consulta de pesquisa de texto livre correspondeu ao nome da empresa ou ao número da organização. |
|
|
Limit
|
limit | integer |
Número máximo de itens a serem retornados nesta página. O padrão e o máximo variam por ponto de extremidade. |
|
|
Cursor de paginação
|
cursor | string |
Cursor de paginação opaca retornado por uma chamada anterior. Passe-o de volta verbatim para buscar a próxima página. Não analise nem modifique. |
Retornos
Pessoas de pesquisa (acionistas e detentores de função)
Pesquise pessoas entre detentores de funções brreg e registro de acionistas. Dá suporte à correspondência de nome difusa com a expansão inicial e a remoção do nome do meio; filtro opcional de ano de nascimento.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Consulta de pesquisa
|
q | True | string |
A consulta de pesquisa de texto livre correspondeu ao nome da empresa ou ao número da organização. |
|
Limit
|
limit | integer |
Número máximo de itens a serem retornados nesta página. O padrão e o máximo variam por ponto de extremidade. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
consulta
|
query | string | |
|
acionistas
|
shareholders | array of PersonHit | |
|
shareholders_count
|
shareholders_count | integer | |
|
role_persons
|
role_persons | array of PersonHit | |
|
role_persons_count
|
role_persons_count | integer |
Pontuação de risco 0-100 com nível e componentes
Pontuação de risco estruturado (0-100) com nível nomeado (baixo/moderado/alto/crítico) e divisão de componentes para a integridade financeira da empresa. Retorna blocked_enk erro para proprietários exclusivos. Não é uma verificação de crédito pessoal.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
Retornos
- Body
- RiskScoreResponse
Sinais de risco agregados
Agrega sinais de três fontes: sinais de anúncio kyc (falência, fusão, divisão), classificação de angústia (FIV) e sinais de equilíbrio provisório.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
|
Desde
|
since | date |
ISO-dato (YYYY-MM-DD). Overstyrer default 730 dager bakover. Cappes til 1825 dager. |
Retornos
- Body
- SignalsResponse
Status de FIV (empresa em dificuldade)
Avalia se uma empresa se qualifica como "foretak i vanskeligheter" (FIV/empresa em dificuldade) de acordo com as regras norueguesas NUES a-e, com base nas demonstrações financeiras mais recentes disponíveis.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número da organização
|
orgnr | True | string |
Número da organização norueguesa (exatamente 9 dígitos) emitido por Brønnøysundregistrene. |
Retornos
- Body
- FivResponse
Triagem AML e PEP (requer cabeçalhos DPA)
Exibe uma pessoa contra sanções e listas pep. Requer cabeçalhos DPA e X-FR-Purpose por chamada mais X-FR-DPA-Confirmed. Todas as chamadas são registradas em log de auditoria por 60 meses, conforme exigido pelas regulamentações norueguesas do KYC.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Marca de finalidade
|
X-FR-Purpose | True | string |
Marca de finalidade para a pesquisa de AML. Um deles: kyc_onboarding, kyc_review, risk_monitoring, manual. Necessário para chamadas AML e persistido no log de auditoria. |
|
Confirmação de DPA
|
X-FR-DPA-Confirmed | True | string |
Confirmação de que você tem um Contrato de Processamento de Dados assinado que abrange esta pesquisa AML. Necessário para chamadas AML. |
|
nome
|
name | True | string | |
|
birth_year
|
birth_year | integer | ||
|
kategori
|
kategori | string | ||
|
min_match_ratio
|
min_match_ratio | number |
Retornos
- Body
- AmlCheckResponse
Definições
Empresa
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string |
9-sifret norsk organisasjonsnummer. |
|
navn
|
navn | string | |
|
organisasjonsform
|
organisasjonsform | string |
BRREG-organisasjonsform-kode (AS, ASA, ENK, ...). |
|
konsernstruktur
|
konsernstruktur | object |
Konsern-tre med morselskap + døtre. |
|
eiere
|
eiere | array of Owner | |
|
tildelinger
|
tildelinger | array of object | |
|
items
|
tildelinger | object | |
|
brreg_tildelinger
|
brreg_tildelinger | object | |
|
endringer
|
endringer | array of Announcement | |
|
financial_metrics
|
financial_metrics | FinancialMetrics | |
|
foretaksklassifisering
|
foretaksklassifisering | object | |
|
resumo
|
summary | string |
LLM-vennlig kort oppsummering. |
Proprietário
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
navn
|
navn | string | |
|
orgnr
|
orgnr | string |
Para proprietários de negócios – eierens orgnr. |
|
owner_person_key
|
owner_person_key | string |
Para personlige eiere — stabil nøkkel for /person/shareholdings. |
|
eierandel_prosent
|
eierandel_prosent | float | |
|
antall_aksjer
|
antall_aksjer | integer | |
|
tipo
|
type | string |
Função
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
rolle_type
|
rolle_type | string |
BRREG-rolle-beskrivelse (Styreleder, Daglig leder, ...). |
|
navn
|
navn | string | |
|
fodselsaar
|
fodselsaar | string |
4-sifret fødselsår, eller null. |
|
fra_dato
|
fra_dato | date | |
|
til_dato
|
til_dato | date | |
|
signatur_alene
|
signatur_alene | boolean | |
|
is_active
|
is_active | boolean |
FinancialMetrics
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
regnskapstype
|
regnskapstype | string | |
|
items
|
items | array of FinancialYear | |
|
freshness
|
freshness | object |
FinancialYear
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
regnskapsar
|
regnskapsar | integer | |
|
omsetning
|
omsetning | number | |
|
driftsresultat
|
driftsresultat | number | |
|
aarsresultat
|
aarsresultat | number | |
|
sum_egenkapital
|
sum_egenkapital | number | |
|
sum_gjeld
|
sum_gjeld | number | |
|
sum_eiendeler
|
sum_eiendeler | number | |
|
antall_ansatte
|
antall_ansatte | integer |
Anúncio
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
navn
|
navn | string | |
|
Dato
|
dato | date | |
|
kunngjoring_type
|
kunngjoring_type | string | |
|
categoria
|
category | string | |
|
hendelse_type
|
hendelse_type | string | |
|
niva1_label
|
niva1_label | string |
PersonHit
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
nome
|
name | string | |
|
birth_year
|
birth_year | string |
Maskert til 4-sifret år eller null. |
|
owner_person_key
|
owner_person_key | string | |
|
role_person_id
|
role_person_id | string | |
|
postted
|
poststed | string | |
|
antall_selskaper
|
antall_selskaper | integer |
PersonProfile
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
owner_person_key
|
owner_person_key | string | |
|
nome
|
name | string | |
|
birth_year
|
birth_year | string | |
|
postted
|
poststed | string | |
|
Participações
|
shareholdings | array of object | |
|
items
|
shareholdings | object | |
|
total_ownership_value_nok
|
total_ownership_value_nok | number |
RolePersonProfile
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
role_person_id
|
role_person_id | string | |
|
nome
|
name | string | |
|
birth_year
|
birth_year | string | |
|
funções
|
roles | array of Role |
CompanyHit
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
navn
|
navn | string | |
|
organisasjonsform
|
organisasjonsform | string | |
|
naeringskode
|
naeringskode | string | |
|
kommune
|
kommune | string | |
|
status
|
status | string | |
|
antall_ansatte
|
antall_ansatte | integer |
CompanySearchResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
items
|
items | array of CompanyHit | |
|
next_cursor
|
next_cursor | string | |
|
total_count
|
total_count | integer |
CompareResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnrs
|
orgnrs | array of string | |
|
Anos
|
years | array of integer | |
|
empresas
|
companies | array of object | |
|
orgnr
|
companies.orgnr | string | |
|
navn
|
companies.navn | string | |
|
financials_by_year
|
companies.financials_by_year | object | |
|
comparação
|
comparison | object |
{<metric>: {<orgnr>: [<value_per_year>]}} |
|
computed_at
|
computed_at | date-time |
OwnershipResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
direção
|
direction | string | |
|
profundidade
|
depth | integer | |
|
owners
|
owners | array of Owner | |
|
Explorações
|
holdings | object |
RolesResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
funções
|
roles | array of Role | |
|
total_count
|
total_count | integer | |
|
armazenado em cache
|
cached | boolean |
SignalsResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
days_back
|
days_back | integer | |
|
kyc_signals
|
kyc_signals | object | |
|
angústia
|
distress | object | |
|
interim_balance
|
interim_balance | object | |
|
agregação
|
aggregate | object |
AmlHit
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
primart_navn
|
primart_navn | string | |
|
kategori
|
kategori | string | |
|
entitet_type
|
entitet_type | string | |
|
kilder
|
kilder | array of string | |
|
match_ratio
|
match_ratio | number | |
|
Tipo_correspondência
|
match_type | string | |
|
ekstern_id
|
ekstern_id | string |
AmlCheckResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
query_name
|
query_name | string | |
|
query_birth_year
|
query_birth_year | integer | |
|
Hits
|
hits | array of AmlHit | |
|
hit_count
|
hit_count | integer |
AmlScoreResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
rapport_id
|
rapport_id | string | |
|
pontuação
|
score | number | |
|
nível
|
level | string | |
|
Fatores
|
factors | array of object | |
|
items
|
factors | object |
NaceCompaniesResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
nace_code
|
nace_code | string | |
|
items
|
items | array of CompanyHit | |
|
next_cursor
|
next_cursor | string | |
|
total_count
|
total_count | integer |
RelatedCompaniesResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
Via
|
via | string | |
|
relacionado
|
related | array of object | |
|
orgnr
|
related.orgnr | string | |
|
navn
|
related.navn | string | |
|
relation_strength
|
related.relation_strength | integer | |
|
shared_entities
|
related.shared_entities | array of object | |
|
items
|
related.shared_entities | object | |
|
total_count
|
total_count | integer |
AnnouncementsSearchResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
items
|
items | array of Announcement | |
|
next_cursor
|
next_cursor | string | |
|
filtro
|
filter | object |
RiskScoreResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
pontuação
|
score | integer | |
|
nível
|
level | string | |
|
components
|
components | array of object | |
|
items
|
components | object | |
|
sources
|
sources | array of string |
FivResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
status
|
status | string |
NUES a-e-status, eks.
|
|
pontuação
|
score | number | |
|
rules_fired
|
rules_fired | array of object | |
|
items
|
rules_fired | object | |
|
confiança
|
confidence | number | |
|
as_of
|
as_of | date-time |
KonsernStotteOversikt
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
selskap_stotte
|
selskap_stotte | object |
Direkte støtte til orgnr (post-#134-skjema). Concessões diretas para o orgnr (forma pós-#134). |
|
konsern_aggregat
|
konsern_aggregat | object |
Aggregert konsern-støtte oppover i eier-tre. Suporte de nível de grupo agregado. |
|
tildelinger
|
tildelinger | array of object | |
|
items
|
tildelinger | object |
FinancialHistoryResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
regnskapstype
|
regnskapstype | string | |
|
items
|
items | array of FinancialYear | |
|
freshness
|
freshness | object |