Firmaradar (Publisher Independente) (Pré-visualização)

Plataforma de enriquecimento para inteligência empresarial norueguesa. Funde dados do BRREG, Skatteetaten, PEP estrangeiros e registos de sanções, registos públicos de subsídios e sinais de socorro, com enriquecimento proprietário por cima (pontuação de risco, correspondência de pessoas difusas, análise de grupos, conformidade de grau de auditoria). Desenvolvido para KYC, AML, crédito, propriedade e fluxos de risco.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regions
Estúdio Copiloto Premium Todas as regiões Power Automate exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões Power Apps exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões Power Automate exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contact
Nome Apoio a Firmaradar
URL https://firmaradar.no/kontakt
Email support@firmaradar.no
Metadados do conector
Editor Tiwas
Sítio Web https://firmaradar.no
Política de privacidade https://firmaradar.no/personvern
Categorias Dados; Inteligência de Negócios

Firmaradar (Publisher Independente)

O Firmaradar é uma plataforma de enriquecimento para a inteligência empresarial norueguesa. Funde dados de múltiplas fontes autorizadas — o Registo Comercial Norueguês (Brønnøysundregistrene), a Administração Fiscal Norueguesa (Skatteetaten) e registos estrangeiros de PEP e sanções — e acrescenta enriquecimento proprietário por cima: classificação de dificuldades, pontuação transparente de risco, correspondência de pessoas difusa, análise de estrutura de grupo e pipelines de conformidade de grau auditivo. Este conector expõe 21 operações que pode inserir num fluxo para enriquecer clientes, fornecedores, parceiros e contrapartes com inteligência estruturada de empresas norueguesas.

Publisher: Lars Kvanum

Proprietário da chaminé: Firmaradar AS (Noruega).

Pré-requisitos

  1. Uma conta ativa do Firmaradar em https://firmaradar.no.
  2. A personal API key issued via Min side → API-nøkler (https://firmaradar.no/min-side/api-keys). A chave é enviada como X-API-Key cabeçalho HTTP em cada pedido.
  3. Uma subscrição ativa para as operações que pretende utilizar. Algumas operações exigem um acordo de processamento de dados (DPA) assinado na sua conta Firmaradar — nomeadamente a triagem AML e PEP.

O nível gratuito cobre uma fatia generosa do perfil da empresa, propriedade, funções, histórico financeiro e operações de anúncios. Operações de nível de conformidade (AML, avaliação de risco de grau audit) exigem um plano pago e aceitação explícita de DPA.

Operações suportadas

O conector expõe 21 operações de produção em 6 áreas funcionais. Muitas operações combinam várias fontes a montante por trás de uma única chamada.

Company

Procure o perfil completo da empresa por número da organização, expanda a sua árvore de propriedade e os papéis do conselho ou signatários, recupere o histórico financeiro de vários anos, acompanhe alterações recentes no registo, pesquise o universo da empresa e compare duas empresas lado a lado.

Pessoa

Procure uma pessoa, resolva os papéis que essa pessoa ocupa em várias empresas e liste as participações que essa pessoa controla.

Risco

Recuperar sinais de risco de uma empresa, pesquisar no feed de anúncios do registo, obter uma pontuação de risco transparente (0–100) com uma divisão dos componentes e realizar uma avaliação legal de "foretak i vanskeligheter" (empresa em dificuldade).

Indústria

Liste empresas dentro de um código de indústria NACE e encontre empresas relacionadas com uma determinada empresa através da propriedade ou funções.

AML

Faça uma verificação de uma pessoa ou empresa com listas AML e PEP e recupere uma pontuação combinada de AML. Estas operações estão bloqueadas por um DPA assinado e são mantidas num registo de auditoria.

Apoio ao grupo

Obtenha uma visão geral do apoio público a grupos e exposição a subsídios (Innovasjon Norge / SkatteFUNN) para uma empresa.

Além disso, três pseudónimos de documentação são expostos na especificação para fornecer um mapeamento um-para-um com o catálogo de ferramentas Firmaradar MCP; estes encaminham para o mesmo backend das operações canónicas acima.

Obtenção de credenciais

  1. Inicie https://firmaradar.no sessão com uma conta Firmaradar verificada.
  2. Open Min side → API-nøkler (My account → API keys).
  3. Clique em Generer ny API-nøkkel (Gerar nova chave) e copie a chave. A chave completa é mostrada apenas uma vez — guarde-a num gestor de segredos ou nas definições de ligação.
  4. Quando criares um fluxo que use este conector, cola a chave no campo de ligação da chave API do Firmaradar .

Pode revogar ou rodar a chave a partir da mesma página a qualquer momento.

Introdução

  1. Crie uma ligação e cole a sua chave API Firmaradar no campo da chave API Firmaradar .
  2. Adicione uma ação Firmaradar ao seu fluxo — por exemplo , consiga uma empresa com um número de empresa como 923609016 (Equinor ASA).
  3. Use a saída estruturada em etapas posteriores: envie um alerta de risco no Teams, escreva um registo KYC no Dataverse ou enriqueça um lead de CRM.

Problemas conhecidos e limitações

  • Respostas em norueguês. Os rótulos de campo e as cadeias legíveis por humanos nas respostas são escritos em norueguês (bokmål), refletindo os registos fonte. Resumos em inglês são incluídos sempre que possível.
  • Limites de taxa. As contas de nível gratuito estão limitadas a 60 pedidos por minuto. As operações AML têm um limite mais rigoroso de 50 pedidos por 30 minutos, independentemente do plano.
  • Registo de auditorias. As chamadas para operações de AML e risco de mercado são mantidas num registo de auditoria durante 60 meses, conforme exigido pelas regulamentações norueguesas de KYC. Os X-FR-Purpose cabeçalhos e X-FR-DPA-Confirmed devem ser definidos nas chamadas AML; os cabeçalhos em falta retornam HTTP 403.
  • Portões de conformidade. A getRiskScore operação pode devolver HTTP 403 até error_code=marketplace_hidden a conta ultrapassar a porta de conformidade relevante. A especificação marca esta operação com a x-firmaradar-compliance-gate extensão para que os clientes possam ocultá-la ou desativá-la dinamicamente.
  • Apenas números de organização de 9 dígitos. Todos os orgnr parâmetros do caminho devem ter exatamente 9 dígitos (formato norueguês de número de organização).
  • Cursores de paginação opacos. O next_cursor valor devolvido pelas operações paginadas deve ser devolto literalmente — não o analise nem modifique.

Perguntas Mais Frequentes

Tenho de ser uma empresa norueguesa para usar este conector?

No. Bancos não noruegueses, fornecedores de KYC, plataformas AML e consultores de fusões e aquisições podem considerar o Firmaradar como o seu backend norueguês canónico e integrar o resultado numa visão mais ampla de conformidade multijurisdição.

Isto é apenas um invólucro no registo público de negócios?

No. Os dados públicos de registo raramente respondem a uma questão real de negócios. O Firmaradar concilia múltiplas fontes e campõe sinais proprietários — correspondência de pessoas, modelação de risco, análise de grupos e análise de conformidade — de modo que uma única chamada devolve uma visão pronta para a decisão.

Instruções de implantação

Após a certificação, os utilizadores finais não precisam de instalar o conector manualmente — ele torna-se disponível no catálogo padrão de conectores em Power Automate, Power Apps e Logic Apps. Desenvolvedores que querem implementar antes da certificação poder executar:

paconn create --api-prop apiProperties.json \
              --api-def apiDefinition.swagger.json \
              --icon icon.png

Veja https://learn.microsoft.com/en-us/connectors/custom-connectors/paconn-cli para a referência completa da CLI.

Suporte

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Descrição Obrigatório
chave_de_api securestring O api_key para esta api Verdade

Ações

Compare métricas financeiras entre empresas

Orquestração do lado do servidor: obtém o histórico financeiro de várias empresas em paralelo e devolve-os num formato de comparação amigável para tabela para benchmarking.
Encontre empresas relacionadas (pessoas partilhadas ou morada)

Encontra empresas que partilham titulares de funções ou morada de negócio com a empresa de entrada. Usado para due diligence e mapeamento de rede.
Estado FIV (empresa em dificuldade)

Avalia se uma empresa se qualifica como 'foretak i vanskeligheter' (FIV / empresa em dificuldade) de acordo com as regras a-e da NUES norueguesa, com base nas demonstrações financeiras mais recentes disponíveis.
Exposição a subsídios públicos em vários grupos

Estrutura em árvore dos subsídios públicos (subsídios NAV, apoio Covid-19, Innovasjon Norge, SkatteFUNN, subsídios da UE) recebidos por uma empresa e pelo seu grupo. Usado para a due diligence sobre exposição no setor público.
Gerar relatório e pontuação AML (fluxo de duas chamadas)

Gera um relatório AML para uma empresa e devolve uma pontuação estruturada (0-100) com desagregação de fatores. Fluxo de duas chamadas do lado do servidor; O cliente vê uma resposta estruturada.
Listar empresas num código NACE-indústria

Empresas de devolução registadas com um dado código NACE-indústria (correspondência de prefixo). Apoia filtros municipais e de funcionários; paginado com cursor estável.
Obtenha a carteira acionista para uma pessoa

Devolve todas as empresas em que uma pessoa detém ações, com percentagens de participação e detalhes da classe de ações, identificados por owner_person_key estável.
Obtenha alterações recentes (alias para o endpoint de alterações)

Alias de documentação utilizado pelo catálogo de ferramentas MCP (get_recent_changes). Encaminha para o endpoint canónico /company/{orgnr}/changes.
Obtenha anúncios BRREG (alias para alterar endpoint)

Alias de documentação usado pelo catálogo de ferramentas MCP (get_company_announcements). Encaminha para o endpoint canónico /company/{orgnr}/changes.
Obtenha cargos na empresa (conselho, CEO, signatários)

Devolve titulares de cargos BRREG (presidente, membro do conselho, CEO, signatário, procuração) para uma empresa. Filtro opcional por tipo de função e inclusão de funções históricas.
Obtenha o histórico completo de funções de uma pessoa

Devolve o histórico completo do papel (ativo e histórico) para uma pessoa-papel identificada pelo seu role_person_id estável.
Obtenha o histórico financeiro

Retornos do histórico financeiro (receita, resultado operacional, capital próprio, ativos totais, funcionários) até 10 anos atrás para uma empresa norueguesa.
Obtenha o perfil completo da empresa

Devolve o perfil completo da empresa para um número de organização norueguesa (orgnr): estatuto de registo, indústria NACE, funcionários, morada, histórico financeiro, árvore de propriedade e funções-chave. Combina BRREG, dados financeiros e enriquecimento proprietário.
Obtenha os anúncios do BRREG e as alterações recentes

Devolve anúncios BRREG (eventos legais) e alterações recentes (função, morada, sinal, assinatura) dentro da janela configurada para uma empresa. Usado para monitorização e acompanhamento de alterações.
Obter perfil de pessoa (orquestração do lado do cliente)

Assistente do lado do cliente que orquestra searchPersons + getPersonRoles + getPersonCompanies numa única vista de perfil. Documentado aqui para paridade com o catálogo de ferramentas MCP.
Obtém uma árvore de propriedade (para cima, para baixo ou ambos)

Devolve 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 particulares.
Pesquisar empresas (nome, NACE, município)

Pesquisa unificada por nome da empresa, código da indústria NACE e município. Devolve resultados paginados com cursor estável para a página seguinte.
Pesquisar pessoas (acionistas e titulares de cargos)

Procure pessoas entre os titulares de funções e o registo de acionistas do BRREG. Suporta correspondência de nomes difusos com expansão inicial e eliminação do nome do meio; Filtro opcional do ano de nascimento.
Pesquise anúncios BRREG entre empresas

Pesquisa entre organizações em anúncios BRREG. Filtre por tipo, intervalo de datas, estado. Usado para monitorização de portefólio e consultas ad hoc.
Pontuação de risco 0-100 com nível e componentes

Pontuação de risco estruturada (0-100) com nível nomeado (baixo / moderado / alto / crítico) e distribuição de componentes para a saúde financeira da empresa. Devoluções blocked_enk erro para empresas em nome individual. Não é uma verificação pessoal de crédito.
Sinais agregados de risco

Agrega sinais de três fontes: sinais de anúncio KYC (falência, fusão, divisão), classificação de dificuldades (FIV) e sinais de saldo provisório.
Triagem AML e PEP (requer cabeçalhos DPA)

Examina uma pessoa contra sanções e listas PEP. Requer DPA assinado e cabeçalhos X-FR-Purpose por chamada mais X-FR-DPA-Confirmed. Todas as chamadas são registadas por auditoria durante 60 meses, conforme exigido pelas regulamentações norueguesas de KYC.

Compare métricas financeiras entre empresas

ID da Operação:
compareCompanies

Orquestração do lado do servidor: obtém o histórico financeiro de várias empresas em paralelo e devolve-os num formato de comparação amigável para tabela para benchmarking.

Parâmetros

Name Chave Obrigatório Tipo Descrição
orgnrs
 orgnrs True array of string
anos
 years integer
métricas
 metrics array of string

Devoluções

Corpo
CompareResponse

Encontre empresas relacionadas (pessoas partilhadas ou morada)

ID da Operação:
findRelatedCompanies

Encontra empresas que partilham titulares de funções ou morada de negócio com a empresa de entrada. Usado para due diligence e mapeamento de rede.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.
Relação via
 via string

Como a relação é determinada. 'pessoa' usa titulares de papéis partilhados; 'endereço' utiliza endereço comercial partilhado.
Limite
 limit integer

Número máximo de itens a devolver nesta página. O padrão e o máximo variam consoante o endpoint.
Sobreposição mínima
 min_overlap integer

Número mínimo de pessoas ou endereços partilhados necessários para uma correspondência entre empresas relacionadas.

Devoluções

Corpo
RelatedCompaniesResponse

Estado FIV (empresa em dificuldade)

ID da Operação:
checkForetakIVanskeligheter

Avalia se uma empresa se qualifica como 'foretak i vanskeligheter' (FIV / empresa em dificuldade) de acordo com as regras a-e da NUES norueguesa, com base nas demonstrações financeiras mais recentes disponíveis.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.

Devoluções

Corpo
FivResponse

Exposição a subsídios públicos em vários grupos

ID da Operação:
getKonsernstotte

Estrutura em árvore dos subsídios públicos (subsídios NAV, apoio Covid-19, Innovasjon Norge, SkatteFUNN, subsídios da UE) recebidos por uma empresa e pelo seu grupo. Usado para a due diligence sobre exposição no setor público.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.

Devoluções

Corpo
KonsernStotteOversikt

Gerar relatório e pontuação AML (fluxo de duas chamadas)

ID da Operação:
getAmlScore

Gera um relatório AML para uma empresa e devolve uma pontuação estruturada (0-100) com desagregação de fatores. Fluxo de duas chamadas do lado do servidor; O cliente vê uma resposta estruturada.

Parâmetros

Name Chave Obrigatório Tipo Descrição
orgnr
 orgnr True string
purpose
 purpose string

DPA-formål para rastreio AML (ex. kyc_onboarding).

Devoluções

Corpo
AmlScoreResponse

Listar empresas num código NACE-indústria

ID da Operação:
listCompaniesInNace

Empresas de devolução registadas com um dado código NACE-indústria (correspondência de prefixo). Apoia filtros municipais e de funcionários; paginado com cursor estável.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Código NACE
 code True string

NACE-kode eller prefixo (ej. 47, 47.11, 47.110).
Filtro de estado
 status string

Filtre pelo estado legal (por exemplo, ativo, under_liquidation, struck_off).
Municipality
 kommune string

Código municipal norueguês (4 dígitos, por exemplo 0301 para Oslo) usado para filtrar resultados geograficamente.
Funcionários do Min
 min_ansatte integer

Número mínimo de funcionários que a empresa deve ter (inclusive).
Funcionários Max
 max_ansatte integer

Número máximo de funcionários que a empresa deve ter (inclusive).
Limite
 limit integer

Número máximo de itens a devolver nesta página. O padrão e o máximo variam consoante o endpoint.
Cursor de paginação
 cursor string

Cursor de paginação opaco retornado por uma chamada anterior. Passa de volta palavra por palavra para ir buscar a página seguinte. Não analises nem modifiques.
Inclua os totais
 include_total integer

Se for verdadeiro, inclui os totais agregados de grupo na resposta.

Devoluções

Corpo
NaceCompaniesResponse

Obtenha a carteira acionista para uma pessoa

ID da Operação:
getPersonCompanies

Devolve todas as empresas em que uma pessoa detém ações, com percentagens de participação e detalhes da classe de ações, identificados por owner_person_key estável.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Chave de pessoa do proprietário
 owner_person_key True string

Chave estável identificando um acionista pessoal, devolvida por endpoints searchPersons ou proprietários.

Devoluções

Corpo
PersonProfile

Obtenha alterações recentes (alias para o endpoint de alterações)

ID da Operação:
getRecentChanges

Alias de documentação utilizado pelo catálogo de ferramentas MCP (get_recent_changes). Encaminha para o endpoint canónico /company/{orgnr}/changes.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.

Devoluções

response
array of Announcement

Obtenha anúncios BRREG (alias para alterar endpoint)

ID da Operação:
getCompanyAnnouncements

Alias de documentação usado pelo catálogo de ferramentas MCP (get_company_announcements). Encaminha para o endpoint canónico /company/{orgnr}/changes.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.

Devoluções

response
array of Announcement

Obtenha cargos na empresa (conselho, CEO, signatários)

ID da Operação:
getCompanyRoles

Devolve titulares de cargos BRREG (presidente, membro do conselho, CEO, signatário, procuração) para uma empresa. Filtro opcional por tipo de função e inclusão de funções históricas.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.
Incluir histórico
 include_historic integer

Se for verdade, inclui ocupantes históricos (que se demitiram) além dos atuais.
Tipo de função
 role_type string

Filtrar no código de tipo de papel norueguês (por exemplo, styreleder, daglig_leder, signatur). Consulte os documentos do Firmaradar para a lista completa.

Devoluções

Corpo
RolesResponse

Obtenha o histórico completo de funções de uma pessoa

ID da Operação:
getPersonRoles

Devolve o histórico completo do papel (ativo e histórico) para uma pessoa-papel identificada pelo seu role_person_id estável.

Parâmetros

Name Chave Obrigatório Tipo Descrição
ID de pessoa do papel
 role_person_id True string

ID estável que identifica um detentor de papel, devolvido por searchPersons ou endpoints de roles.

Devoluções

Corpo
RolePersonProfile

Obtenha o histórico financeiro

ID da Operação:
getCompanyFinancials

Retornos do histórico financeiro (receita, resultado operacional, capital próprio, ativos totais, funcionários) até 10 anos atrás para uma empresa norueguesa.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.
Anos atrás
 years integer

Número de anos de histórico financeiro a devolver (1-10).
Tipo de declaração
 regnskapstype string

Tipo de demonstração financeira para filtrar (por exemplo, selskap, konsern). O padrão devolve a afirmação canónica.
Cache de salto de frescura
 skip_freshness integer

Se for verdade, ignora a cache de frescura e força uma atualização a montante. Use com moderação.

Devoluções

Corpo
FinancialHistoryResponse

Obtenha o perfil completo da empresa

ID da Operação:
getCompany

Devolve o perfil completo da empresa para um número de organização norueguesa (orgnr): estatuto de registo, indústria NACE, funcionários, morada, histórico financeiro, árvore de propriedade e funções-chave. Combina BRREG, dados financeiros e enriquecimento proprietário.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

9-sifret organisasjonsnummer.
Campos
 fields string

Subconjunto komma-separert, eks. group,owners,grants,changes,financial_metrics.
Incluir proprietários
 owners string

Se for verdade, inclui informações de propriedade na resposta.
Incluir subsídios
 grants integer

Se for verdade, inclui dados de subsídios públicos na resposta.
Incluir subsídios BRREG
 brreg_grants integer

Se for verdade, inclui dados de subsídios públicos BRREG na resposta. Adiciona uma chamada extra a montante.
Métricas financeiras
 financial_metrics integer

Lista separada por vírgulas de métricas financeiras a incluir (receitas, operating_result, capital próprio, etc.).

Devoluções

Corpo
Company

Obtenha os anúncios do BRREG e as alterações recentes

ID da Operação:
getCompanyChanges

Devolve anúncios BRREG (eventos legais) e alterações recentes (função, morada, sinal, assinatura) dentro da janela configurada para uma empresa. Usado para monitorização e acompanhamento de alterações.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.

Devoluções

response
array of Announcement

Obter perfil de pessoa (orquestração do lado do cliente)

ID da Operação:
getPerson

Assistente do lado do cliente que orquestra searchPersons + getPersonRoles + getPersonCompanies numa única vista de perfil. Documentado aqui para paridade com o catálogo de ferramentas MCP.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Nome
 name True string

Nome total ou parcial da pessoa. A correspondência difusa com expansão inicial e eliminação do nome do meio é aplicada automaticamente.
Ano de nascimento
 birth_year integer

Ano de nascimento de quatro dígitos usado como filtro adicional na pesquisa presencial para desambiguar nomes comuns.

Devoluções

Corpo
PersonProfile

Obtém uma árvore de propriedade (para cima, para baixo ou ambos)

ID da Operação:
getCompanyOwnership

Devolve 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 particulares.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.
Direção da árvore
 direction string

Direção da travessia da árvore. 'para baixo' devolve subsidiárias; 'para cima' retornam os pais; 'ambos' devolve o grupo completo.
Profundidade da árvore
 depth integer

Quantos níveis da árvore de propriedade atravessar. Inteiros 1-12. Maior profundidade significa chamadas mais lentas.
Incluir pessoas
 include_persons integer

Se for verdade, inclui os acionistas pessoais na árvore de propriedade (caso contrário, apenas entidades jurídicas).

Devoluções

Corpo
OwnershipResponse

Pesquisar empresas (nome, NACE, município)

ID da Operação:
searchCompanies

Pesquisa unificada por nome da empresa, código da indústria NACE e município. Devolve resultados paginados com cursor estável para a página seguinte.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Consulta de pesquisa
 q string

A pesquisa em texto livre correspondia ao nome da empresa ou ao número da organização.
Filtro NACE
 nace string

Filtrar os resultados por código da indústria NACE (2-5 dígitos, compatibilidade com prefixo).
Municipality
 kommune string

Código municipal norueguês (4 dígitos, por exemplo 0301 para Oslo) usado para filtrar resultados geograficamente.
Limite
 limit integer

Número máximo de itens a devolver nesta página. O padrão e o máximo variam consoante o endpoint.
Cursor de paginação
 cursor string

Cursor de paginação opaco retornado por uma chamada anterior. Passa de volta palavra por palavra para ir buscar a página seguinte. Não analises nem modifiques.

Devoluções

Corpo
CompanySearchResponse

Pesquisar pessoas (acionistas e titulares de cargos)

ID da Operação:
searchPersons

Procure pessoas entre os titulares de funções e o registo de acionistas do BRREG. Suporta correspondência de nomes difusos com expansão inicial e eliminação do nome do meio; Filtro opcional do ano de nascimento.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Consulta de pesquisa
 q True string

A pesquisa em texto livre correspondia ao nome da empresa ou ao número da organização.
Limite
 limit integer

Número máximo de itens a devolver nesta página. O padrão e o máximo variam consoante o endpoint.

Devoluções

Name Caminho Tipo Descrição
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

Pesquise anúncios BRREG entre empresas

ID da Operação:
searchAnnouncements

Pesquisa entre organizações em anúncios BRREG. Filtre por tipo, intervalo de datas, estado. Usado para monitorização de portefólio e consultas ad hoc.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Filtro de tipo
 type string

Filtre pelo tipo do item (varia consoante o endpoint; ver descrição da operação).
Data de
 from date

Início do intervalo de datas em formato ISO (YYYY-MM-DD). Inclusivo.
Data para
 to date

Fim do intervalo de datas em formato ISO (YYY-MM-DD). Inclusivo.
Número da organização
 orgnr string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.
Consulta de pesquisa
 q string

A pesquisa em texto livre correspondia ao nome da empresa ou ao número da organização.
Limite
 limit integer

Número máximo de itens a devolver nesta página. O padrão e o máximo variam consoante o endpoint.
Cursor de paginação
 cursor string

Cursor de paginação opaco retornado por uma chamada anterior. Passa de volta palavra por palavra para ir buscar a página seguinte. Não analises nem modifiques.

Devoluções

Corpo
AnnouncementsSearchResponse

Pontuação de risco 0-100 com nível e componentes

ID da Operação:
getRiskScore

Pontuação de risco estruturada (0-100) com nível nomeado (baixo / moderado / alto / crítico) e distribuição de componentes para a saúde financeira da empresa. Devoluções blocked_enk erro para empresas em nome individual. Não é uma verificação pessoal de crédito.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.

Devoluções

Corpo
RiskScoreResponse

Sinais agregados de risco

ID da Operação:
getCompanySignals

Agrega sinais de três fontes: sinais de anúncio KYC (falência, fusão, divisão), classificação de dificuldades (FIV) e sinais de saldo provisório.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Número da organização
 orgnr True string

Número de organização norueguesa (exatamente 9 dígitos) emitido pela Brønnøysundregistrene.
Desde
 since date

ISO-dato (YYYY-MM-DD). Overstyrer padrão 730 dager bakover. Cappes até 1825 dagger.

Devoluções

Corpo
SignalsResponse

Triagem AML e PEP (requer cabeçalhos DPA)

ID da Operação:
checkAmlPep

Examina uma pessoa contra sanções e listas PEP. Requer DPA assinado e cabeçalhos X-FR-Purpose por chamada mais X-FR-DPA-Confirmed. Todas as chamadas são registadas por auditoria durante 60 meses, conforme exigido pelas regulamentações norueguesas de KYC.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Etiqueta de finalidade
 X-FR-Purpose True string

Etiqueta de finalidade para a pesquisa AML. Uma delas: kyc_onboarding, kyc_review, risk_monitoring, manual. Exigido para chamadas AML e persistido no registo de auditoria.
Confirmação da DPA
 X-FR-DPA-Confirmed True string

Confirmação de que tem um Acordo de Processamento de Dados assinado a cobrir esta consulta AML. Obrigatório para chamadas AML.
Nome
 name True string
birth_year
 birth_year integer
kategori
 kategori string
min_match_ratio
 min_match_ratio number

Devoluções

Corpo
AmlCheckResponse

Definições

Company

Name Caminho Tipo Descrição
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
itens
 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

Name Caminho Tipo Descrição
NAVN
 navn string
orgnr
 orgnr string

Para empresários — eierens orgnr.
owner_person_key
 owner_person_key string

For personlige eiere — stabil nøkkel for /person/shareholdings.
eierandel_prosent
 eierandel_prosent float
antall_aksjer
 antall_aksjer integer
tipo
 type string

Funções

Name Caminho Tipo Descrição
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

Name Caminho Tipo Descrição
orgnr
 orgnr string
Regskapstype
 regnskapstype string
itens
 items array of FinancialYear
freshness
 freshness object

FinancialYear

Name Caminho Tipo Descrição
regnskapsar
 regnskapsar integer
Omsetning
 omsetning number
derivasresultat
 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

Name Caminho Tipo Descrição
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

Name Caminho Tipo Descrição
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
postado
 poststed string
antall_selskaper
 antall_selskaper integer

PersonProfile

Name Caminho Tipo Descrição
owner_person_key
 owner_person_key string
Nome
 name string
birth_year
 birth_year string
postado
 poststed string
Participações acionistas
 shareholdings array of object
itens
 shareholdings object
total_ownership_value_nok
 total_ownership_value_nok number

PerfilDePessoaPapelPapel

Name Caminho Tipo Descrição
role_person_id
 role_person_id string
Nome
 name string
birth_year
 birth_year string
roles
 roles array of Role

CompanyHit

Name Caminho Tipo Descrição
orgnr
 orgnr string
NAVN
 navn string
organisasjonsform
 organisasjonsform string
Naeringskode
 naeringskode string
kommune
 kommune string
estado
 status string
antall_ansatte
 antall_ansatte integer

EmpresaSearchResponse

Name Caminho Tipo Descrição
itens
 items array of CompanyHit
next_cursor
 next_cursor string
total_count
 total_count integer

CompareResponse

Name Caminho Tipo Descrição
orgnrs
 orgnrs array of string
anos
 years array of integer
Companhias
 companies array of object
orgnr
 companies.orgnr string
NAVN
 companies.navn string
financials_by_year
 companies.financials_by_year object
comparação
 comparison object

{<métrica>: {<orgnr>: [<value_per_year>]}}
computed_at
 computed_at date-time

OwnershipResponse

Name Caminho Tipo Descrição
orgnr
 orgnr string
direção
 direction string
profundidade
 depth integer
proprietários
 owners array of Owner
Participações
 holdings object

PapéisResposta

Name Caminho Tipo Descrição
orgnr
 orgnr string
roles
 roles array of Role
total_count
 total_count integer
cacheado
 cached boolean

SignalsResponse

Name Caminho Tipo Descrição
orgnr
 orgnr string
days_back
 days_back integer
kyc_signals
 kyc_signals object
Socorro
 distress object
interim_balance
 interim_balance object
agregação
 aggregate object

AmlHit

Name Caminho Tipo Descrição
primart_navn
 primart_navn string
kategori
 kategori string
entitet_type
 entitet_type string
Kilder
 kilder array of string
match_ratio
 match_ratio number
match_type
 match_type string
ekstern_id
 ekstern_id string

AmlCheckResponse

Name Caminho Tipo Descrição
query_name
 query_name string
query_birth_year
 query_birth_year integer
acertos
 hits array of AmlHit
hit_count
 hit_count integer

AmlScoreResponse

Name Caminho Tipo Descrição
orgnr
 orgnr string
rapport_id
 rapport_id string
classificação
 score number
nível
 level string
Fatores
 factors array of object
itens
 factors object

Resposta das NaceEmpresas

Name Caminho Tipo Descrição
nace_code
 nace_code string
itens
 items array of CompanyHit
next_cursor
 next_cursor string
total_count
 total_count integer

RespostaEmpresas Relacionadas

Name Caminho Tipo Descrição
orgnr
 orgnr string
via
 via string
relacionados
 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
itens
 related.shared_entities object
total_count
 total_count integer

AnúnciosSearchResponse

Name Caminho Tipo Descrição
itens
 items array of Announcement
next_cursor
 next_cursor string
filtro
 filter object

RiscoPontuaçãoResposta

Name Caminho Tipo Descrição
orgnr
 orgnr string
classificação
 score integer
nível
 level string
components
 components array of object
itens
 components object
Fontes
 sources array of string

FivResponse

Name Caminho Tipo Descrição
orgnr
 orgnr string
estado
 status string

NUES a-e-status, eks. not_distressed, distressed.
classificação
 score number
rules_fired
 rules_fired array of object
itens
 rules_fired object
confiança
 confidence number
as_of
 as_of date-time

KonsernStotteOversikt

Name Caminho Tipo Descrição
orgnr
 orgnr string
selskap_stotte
 selskap_stotte object

Direkte støtte til orgnr (post-#134-skjema). Concessões diretas à organização (após a forma #134).
konsern_aggregat
 konsern_aggregat object

Aggregert konsern-støtte oppover i eier-tre. Apoio agregado ao nível do grupo.
Tildelinger
 tildelinger array of object
itens
 tildelinger object

HistóriaFinanceiraResposta

Name Caminho Tipo Descrição
orgnr
 orgnr string
Regskapstype
 regnskapstype string
itens
 items array of FinancialYear
freshness
 freshness object