Firmaradar (Publisher independiente) (versión preliminar)

Plataforma de enriquecimiento para la inteligencia empresarial noruega. Fusiona datos de BRREG, Skatteetaten, Skatteetaten, registros de PEP extranjeros y sanciones, registros de concesiones públicas y señales de angustia, con enriquecimiento propietario en la parte superior (puntuación de riesgo, coincidencia de personas aproximadas, análisis de grupos, cumplimiento de nivel de auditoría). Creado para flujos de trabajo kyC, AML, crédito, propiedad y riesgo.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Compatibilidad con Firmaradar
DIRECCIÓN URL https://firmaradar.no/kontakt
Email support@firmaradar.no
Metadatos del conector
Publicador Tiwas
Sitio web https://firmaradar.no
Directiva de privacidad https://firmaradar.no/personvern
Categorías Datos; Business Intelligence

Firmaradar (Publisher independiente)

Firmaradar es una plataforma de enriquecimiento para la inteligencia empresarial noruega. Fusiona datos de varias fuentes autoritativas ( el Registro de Empresas Noruegos (Brønnøysundregistrene), la Administración Tributaria Noruega (Skatteetaten) y los registros de sanciones y PEP extranjeros— y agrega enriquecimiento propietario sobre: clasificación de angustia, puntuación de riesgo transparente, coincidencia de personas aproximadas, análisis de estructura grupal y canalizaciones de cumplimiento de nivel de auditoría. Este conector expone 21 operaciones que puede caer en un flujo para enriquecer a los clientes, proveedores, asociados y homólogos con inteligencia de la empresa noruega estructurada.

Publisher: Lars Kvanum

Propietario de la pila: Firmaradar AS (Noruega).

Prerequisites

  1. Una cuenta activa de Firmaradar en https://firmaradar.no.
  2. Una clave de API personal emitida a través de min side → API-nøkler (https://firmaradar.no/min-side/api-keys). La clave se envía como encabezado X-API-Key HTTP en cada solicitud.
  3. Una suscripción activa para las operaciones que quiere usar. Algunas operaciones requieren un acuerdo de procesamiento de datos (DPA) firmado en su cuenta de Firmaradar, especialmente AML y PEP.

El nivel gratuito cubre un segmento generoso de perfil de empresa, propiedad, roles, historial financiero y operaciones de anuncio. Las operaciones de nivel de cumplimiento (AML, puntuación de riesgo de nivel de auditoría) requieren un plan de pago y una aceptación explícita de DPA.

Operaciones admitidas

El conector expone 21 operaciones de producción en 6 áreas funcionales. Muchas operaciones combinan varios orígenes ascendentes detrás de una sola llamada.

Compañía

Busque un perfil completo de la empresa por número de organización, expanda su árbol de propiedad y sus roles firmantes, recupere el historial financiero de varios años, realice un seguimiento de los cambios recientes en el registro, busque en el universo de la empresa y compare dos empresas en paralelo.

Persona

Busque una persona, resuelva los roles que tiene una persona en todas las empresas y enumere las acciones que controla una persona.

Riesgo

Recuperar señales de riesgo para una empresa, buscar en la fuente de anuncios del Registro, capturar una puntuación de riesgo transparente (0–100) con un desglose de componentes y ejecutar una evaluación de angustia legal "foretak i vanskeligheter" (empresa en dificultad).

Industria

Enumera las empresas dentro de un código industrial de NACE y busca empresas relacionadas con una determinada empresa a través de la propiedad o los roles.

AML

Muestre una persona o empresa en las listas AML y PEP y recupere una puntuación de AML combinada. Estas operaciones se registran detrás de un DPA firmado y se conservan en un registro de auditoría.

Compatibilidad con grupos

Recupere una visión general de la exposición de apoyo a grupos públicos y concesiones (Innovasjon Norge / SkatteFUNN) para una empresa.

Además, se exponen tres alias de documentación en la especificación para proporcionar una asignación uno a uno con el catálogo de herramientas MCP de Firmaradar; estos reenvía al mismo back-end que las operaciones canónicas anteriores.

Obtención de credenciales

  1. Inicie sesión en https://firmaradar.no con una cuenta comprobada de Firmaradar.
  2. Abra Min side → API-nøkler (Mis claves de API de → cuenta).
  3. Haga clic en Generarr ny API-nøkkel (Generar nueva clave) y copie la clave. La clave completa solo se muestra una vez, almacénela en un administrador de secretos o en la configuración de conexión.
  4. Cuando cree un flujo que use este conector, pegue la clave en el campo de conexión de clave de API de Firmaradar .

Puede revocar o rotar la clave de la misma página en cualquier momento.

Getting Started

  1. Cree una conexión y pegue la clave de API de Firmaradar en el campo Clave de API de Firmaradar .
  2. Agregue una acción Firmaradar al flujo, por ejemplo , Obtener empresa con un número de organización como 923609016 (Equinor ASA).
  3. Use la salida estructurada en pasos de bajada: publique una alerta de riesgo en Teams, escriba un registro KYC en Dataverse o enriquezca un cliente potencial de CRM.

Problemas conocidos y limitaciones

  • Respuestas en idioma noruego. Las etiquetas de campo y las cadenas legibles en las respuestas se escriben en noruego (bokmål), lo que refleja los registros de origen. Los resúmenes en inglés se incluyen donde resulta práctico.
  • Límites de velocidad. Las cuentas de nivel gratis están limitadas a 60 solicitudes por minuto. Las operaciones de AML tienen un límite más estricto de 50 solicitudes por 30 minutos independientemente del plan.
  • Registro de auditoría. Las llamadas a las operaciones de riesgo de AML y Marketplace se conservan en un registro de auditoría durante 60 meses, según lo requiera la normativa kyC noruega. Los X-FR-Purpose encabezados y X-FR-DPA-Confirmed deben establecerse en llamadas AML; los encabezados que faltan devuelven HTTP 403.
  • Puertas de cumplimiento. La getRiskScore operación puede devolver HTTP 403 con error_code=marketplace_hidden hasta que la cuenta pase la puerta de cumplimiento pertinente. La especificación marca esta operación con la x-firmaradar-compliance-gate extensión para que los clientes puedan ocultarla o deshabilitarla dinámicamente.
  • Solo números de organización de 9 dígitos. Todos los orgnr parámetros de ruta de acceso deben tener exactamente 9 dígitos (formato de número de organización noruego).
  • Cursores de paginación opacos. El next_cursor valor devuelto por las operaciones paginadas debe pasarse textualmente, no analice ni modifique.

Preguntas más frecuentes

¿Tengo que ser una empresa noruega para usar este conector?

N.º Los bancos no noruegos, los proveedores KYC, las plataformas AML y los asesores de M&A pueden llamar a Firmaradar como su back-end noruego canónico y unir el resultado en una vista más amplia de cumplimiento de varias jurisdicciones.

¿Se trata de un contenedor alrededor del registro de negocios público?

N.º Los datos públicos del Registro solo rara vez responden a una pregunta empresarial real. Firmaradar reconcilia varias fuentes y capas de señales propietarias (coincidencia de personas, modelado de riesgos, análisis de grupos y fontanería de cumplimiento), por lo que una sola llamada devuelve una vista lista para la decisión.

Instrucciones de implementación

Después de la certificación, los usuarios finales no necesitan instalar el conector manualmente; estará disponible en el catálogo de conectores estándar en Power Automate, Power Apps y Logic Apps. Desarrolladores que quieran implementar antes de que se pueda ejecutar la certificación:

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 la referencia completa de la CLI.

Apoyo

Creación de una conexión

El conector admite los siguientes tipos de autenticación:
Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Required
clave_api securestring La api_key de esta API True

Acciones

Buscar anuncios BRREG en todas las empresas

Búsqueda entre organizaciones en anuncios de BRREG. Filtre por tipo, intervalo de fechas, estado. Se usa para la supervisión de carteras y búsquedas ad hoc.
Buscar empresas relacionadas (personas compartidas o direcciones)

Busca empresas que comparten roles o dirección empresarial con la empresa de entrada. Se usa para la diligencia debida y la asignación de red.
Buscar personas (accionistas y titulares de roles)

Buscar personas en los titulares de roles y en el registro de accionistas de BRREG. Admite la coincidencia de nombres aproximadas con la expansión inicial y la eliminación de nombres intermedios; filtro opcional de año de nacimiento.
Comparación de métricas financieras entre empresas

Orquestación del lado servidor: captura el historial financiero de varias empresas en paralelo y los devuelve en un formato de comparación fácil de tabla para realizar pruebas comparativas.
Empresas de búsqueda (nombre, NACE, municipio)

Búsqueda unificada entre el nombre de la empresa, el código del sector de NACE y el municipio. Devuelve resultados paginados con cursor estable para la página siguiente.
Enumeración de empresas en un código del sector NACE

Devuelve las empresas registradas con un código determinado del sector de NACE (coincidencia de prefijo). Apoya filtros municipales y de empleados; paginado con cursor estable.
Estado de FIV (empresa en dificultad)

Evalúa si una empresa califica como "foretak i vanskeligheter" (FIV/company en dificultad) según las normas a-e noruegas, basadas en los últimos estados financieros disponibles.
Exposición de concesiones públicas entre grupos

Estructura de árboles de concesiones públicas (concesiones NAV, apoyo de Covid-19, Innovasjon Norge, SkatteFUNN, SkatteFUNN, concesiones de la UE) recibidas por una empresa y su grupo. Se utiliza para la debida diligencia en la exposición del sector público.
Filtrado de AML y PEP (requiere encabezados DPA)

Muestra a una persona contra las sanciones y listas pep. Requiere DPA firmado y X-FR-Purpose X-FR con encabezados deDPA-Confirmed firmados. Todas las llamadas se auditan durante 60 meses según lo requerido por la normativa kyC noruega.
Generar informe y puntuación de AML (flujo de dos llamadas)

Genera un informe de AML para una empresa y devuelve una puntuación estructurada (0-100) con desglose de factor. Flujo de dos llamadas del lado servidor; el cliente ve una respuesta estructurada.
Obtención de cambios recientes (alias a punto de conexión de cambios)

Alias de documentación usado por el catálogo mcp-tool (get_recent_changes). Reenvía al punto de conexión canónico /company/{orgnr}/changes.
Obtención de cartera de acciones para una persona

Devuelve todas las empresas en las que una persona posee acciones, con el porcentaje de propiedad y los detalles de la clase de acciones, identificados por owner_person_key estables.
Obtención de roles de empresa (junta directiva, CEO, firmantes)

Devuelve los titulares de roles de BRREG (presidente, miembro del consejo, CEO, firmante, poder de abogado) para una empresa. Filtro opcional en el tipo de rol e inclusión de roles históricos.
Obtener anuncios de BRREG (alias para cambiar el punto de conexión)

Alias de documentación usado por el catálogo mcP-tool (get_company_announcements). Reenvía al punto de conexión canónico /company/{orgnr}/changes.
Obtener anuncios de BRREG y cambios recientes

Devuelve anuncios BRREG (eventos legales) y cambios recientes (rol, dirección, señal, firma) dentro de la ventana configurada para una empresa. Se usa para la supervisión y el seguimiento de cambios.
Obtener el historial completo de roles de una persona

Devuelve el historial de roles completo (activo e histórico) de una persona de rol identificada por su role_person_id estable.
Obtener el perfil completo de la empresa

Devuelve el perfil completo de la empresa para un número de organización noruego (orgnr): estado del registro, NACE-industry, empleados, dirección, historial financiero, árbol de propiedad y roles clave. Combina BRREG, datos financieros y enriquecimiento propietario.
Obtener el árbol de propiedad (arriba, abajo o ambos)

Devuelve el árbol de propiedad de una empresa. direction=down listas subsidiarias; direction=up seguimiento de empresas matriz; direction=both devuelve el grupo completo. Profundidad opcional (1-12) y include_persons para accionistas personales.
Obtener historial financiero

Devuelve la historia financiera (ingresos, resultado operativo, capital, activos totales, empleados) hasta 10 años atrás para una empresa noruega.
Obtener perfil de persona (orquestación del lado cliente)

Asistente del lado cliente que organiza searchPersons + getPersonRoles + getPersonCompanies en una sola vista de perfil. Aquí se documenta la paridad con el catálogo de herramientas de MCP.
Puntuación de riesgo de 0 a 100 con nivel y componentes

Puntuación de riesgo estructurada (0-100) con nivel con nombre (bajo/ moderado/ alto/crítico) y desglose de componentes para el estado financiero de la empresa. Devuelve blocked_enk error para los propietarios únicos. No es un cheque de crédito personal.
Señales de riesgo agregadas

Agrega señales de tres fuentes: señales de anuncio KYC (quiebra, fusión, división), clasificación de angustia (FIV) y señales de equilibrio provisional.

Buscar anuncios BRREG en todas las empresas

Id. de la operación:
searchAnnouncements

Búsqueda entre organizaciones en anuncios de BRREG. Filtre por tipo, intervalo de fechas, estado. Se usa para la supervisión de carteras y búsquedas ad hoc.

Parámetros

Nombre Clave Requerido Tipo Description
Filtro de tipo
 type string

Filtre por el tipo del elemento (varía según el punto de conexión; vea descripción de la operación).
Fecha inicial
 from date

Inicio del intervalo de fechas en formato ISO (AAAA-MM-DD). Inclusive.
Fecha final
 to date

Fin del intervalo de fechas en formato ISO (AAAA-MM-DD). Inclusive.
Número de organización
 orgnr string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.
Consulta de búsqueda
 q string

Consulta de búsqueda de texto libre coincidente con el nombre de la empresa o el número de organización.
Limit
 limit integer

Número máximo de elementos que se van a devolver en esta página. El valor predeterminado y el máximo varían según el punto de conexión.
Cursor de paginación
 cursor string

Cursor de paginación opaco devuelto por una llamada anterior. Páselo textualmente para capturar la página siguiente. No analice ni modifique.

Devoluciones

Body
AnnouncementsSearchResponse

Buscar empresas relacionadas (personas compartidas o direcciones)

Id. de la operación:
findRelatedCompanies

Busca empresas que comparten roles o dirección empresarial con la empresa de entrada. Se usa para la diligencia debida y la asignación de red.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.
Relación a través de
 via string

Cómo se determina la relación. 'persona' utiliza titulares de roles compartidos; 'address' usa la dirección empresarial compartida.
Limit
 limit integer

Número máximo de elementos que se van a devolver en esta página. El valor predeterminado y el máximo varían según el punto de conexión.
Superposición mínima
 min_overlap integer

Número mínimo de personas o direcciones compartidas necesarias para una coincidencia de empresa relacionada.

Devoluciones

Body
RelatedCompaniesResponse

Buscar personas (accionistas y titulares de roles)

Id. de la operación:
searchPersons

Buscar personas en los titulares de roles y en el registro de accionistas de BRREG. Admite la coincidencia de nombres aproximadas con la expansión inicial y la eliminación de nombres intermedios; filtro opcional de año de nacimiento.

Parámetros

Nombre Clave Requerido Tipo Description
Consulta de búsqueda
 q True string

Consulta de búsqueda de texto libre coincidente con el nombre de la empresa o el número de organización.
Limit
 limit integer

Número máximo de elementos que se van a devolver en esta página. El valor predeterminado y el máximo varían según el punto de conexión.

Devoluciones

Nombre Ruta de acceso Tipo Description
query
 query string
accionistas
 shareholders array of PersonHit
shareholders_count
 shareholders_count integer
role_persons
 role_persons array of PersonHit
role_persons_count
 role_persons_count integer

Comparación de métricas financieras entre empresas

Id. de la operación:
compareCompanies

Orquestación del lado servidor: captura el historial financiero de varias empresas en paralelo y los devuelve en un formato de comparación fácil de tabla para realizar pruebas comparativas.

Parámetros

Nombre Clave Requerido Tipo Description
orgnrs
 orgnrs True array of string
años
 years integer
metrics
 metrics array of string

Devoluciones

Body
CompareResponse

Empresas de búsqueda (nombre, NACE, municipio)

Id. de la operación:
searchCompanies

Búsqueda unificada entre el nombre de la empresa, el código del sector de NACE y el municipio. Devuelve resultados paginados con cursor estable para la página siguiente.

Parámetros

Nombre Clave Requerido Tipo Description
Consulta de búsqueda
 q string

Consulta de búsqueda de texto libre coincidente con el nombre de la empresa o el número de organización.
Filtro NACE
 nace string

Filtre los resultados por código del sector de NACE (2-5 dígitos, coincidencia de prefijo compatible).
Municipality
 kommune string

Código de municipio noruego (4 dígitos, por ejemplo, 0301 para Oslo) usado para filtrar los resultados geográficamente.
Limit
 limit integer

Número máximo de elementos que se van a devolver en esta página. El valor predeterminado y el máximo varían según el punto de conexión.
Cursor de paginación
 cursor string

Cursor de paginación opaco devuelto por una llamada anterior. Páselo textualmente para capturar la página siguiente. No analice ni modifique.

Devoluciones

Body
CompanySearchResponse

Enumeración de empresas en un código del sector NACE

Id. de la operación:
listCompaniesInNace

Devuelve las empresas registradas con un código determinado del sector de NACE (coincidencia de prefijo). Apoya filtros municipales y de empleados; paginado con cursor estable.

Parámetros

Nombre Clave Requerido Tipo Description
Código NACE
 code True string

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

Filtre por el estado legal (por ejemplo, activo, under_liquidation, struck_off).
Municipality
 kommune string

Código de municipio noruego (4 dígitos, por ejemplo, 0301 para Oslo) usado para filtrar los resultados geográficamente.
Min employees (Empleados mínimos)
 min_ansatte integer

Número mínimo de empleados que la empresa debe tener (inclusivo).
Número máximo de empleados
 max_ansatte integer

Número máximo de empleados que la empresa debe tener (inclusive).
Limit
 limit integer

Número máximo de elementos que se van a devolver en esta página. El valor predeterminado y el máximo varían según el punto de conexión.
Cursor de paginación
 cursor string

Cursor de paginación opaco devuelto por una llamada anterior. Páselo textualmente para capturar la página siguiente. No analice ni modifique.
Incluir totales
 include_total integer

Si es true, incluye totales agregados de grupo en la respuesta.

Devoluciones

Body
NaceCompaniesResponse

Estado de FIV (empresa en dificultad)

Id. de la operación:
checkForetakIVanskeligheter

Evalúa si una empresa califica como "foretak i vanskeligheter" (FIV/company en dificultad) según las normas a-e noruegas, basadas en los últimos estados financieros disponibles.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.

Devoluciones

Body
FivResponse

Exposición de concesiones públicas entre grupos

Id. de la operación:
getKonsernstotte

Estructura de árboles de concesiones públicas (concesiones NAV, apoyo de Covid-19, Innovasjon Norge, SkatteFUNN, SkatteFUNN, concesiones de la UE) recibidas por una empresa y su grupo. Se utiliza para la debida diligencia en la exposición del sector público.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.

Devoluciones

Body
KonsernStotteOversikt

Filtrado de AML y PEP (requiere encabezados DPA)

Id. de la operación:
checkAmlPep

Muestra a una persona contra las sanciones y listas pep. Requiere DPA firmado y X-FR-Purpose X-FR con encabezados deDPA-Confirmed firmados. Todas las llamadas se auditan durante 60 meses según lo requerido por la normativa kyC noruega.

Parámetros

Nombre Clave Requerido Tipo Description
Etiqueta de propósito
 X-FR-Purpose True string

Etiqueta de propósito para la búsqueda de AML. Uno de: kyc_onboarding, kyc_review, risk_monitoring, manual. Necesario para las llamadas AML y se conserva en el registro de auditoría.
Confirmación de DPA
 X-FR-DPA-Confirmed True string

Confirmación de que tiene un contrato de procesamiento de datos firmado que cubre esta búsqueda de AML. Obligatorio para las llamadas AML.
nombre
 name True string
birth_year
 birth_year integer
kategori
 kategori string
min_match_ratio
 min_match_ratio number

Devoluciones

Body
AmlCheckResponse

Generar informe y puntuación de AML (flujo de dos llamadas)

Id. de la operación:
getAmlScore

Genera un informe de AML para una empresa y devuelve una puntuación estructurada (0-100) con desglose de factor. Flujo de dos llamadas del lado servidor; el cliente ve una respuesta estructurada.

Parámetros

Nombre Clave Requerido Tipo Description
orgnr
 orgnr True string
propósito
 purpose string

DPA-formål para la detección de AML (eks. kyc_onboarding).

Devoluciones

Body
AmlScoreResponse

Obtención de cambios recientes (alias a punto de conexión de cambios)

Id. de la operación:
getRecentChanges

Alias de documentación usado por el catálogo mcp-tool (get_recent_changes). Reenvía al punto de conexión canónico /company/{orgnr}/changes.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.

Devoluciones

respuesta
array of Announcement

Obtención de cartera de acciones para una persona

Id. de la operación:
getPersonCompanies

Devuelve todas las empresas en las que una persona posee acciones, con el porcentaje de propiedad y los detalles de la clase de acciones, identificados por owner_person_key estables.

Parámetros

Nombre Clave Requerido Tipo Description
Clave de la persona propietaria
 owner_person_key True string

Clave estable que identifica a un accionistas personal devuelto por searchPersons o puntos de conexión de propiedad.

Devoluciones

Body
PersonProfile

Obtención de roles de empresa (junta directiva, CEO, firmantes)

Id. de la operación:
getCompanyRoles

Devuelve los titulares de roles de BRREG (presidente, miembro del consejo, CEO, firmante, poder de abogado) para una empresa. Filtro opcional en el tipo de rol e inclusión de roles históricos.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.
Incluir histórico
 include_historic integer

Si es cierto, incluye los titulares de roles históricos (renunciados) además de los actuales.
Tipo de rol
 role_type string

Filtre por el código de tipo de rol noruego (por ejemplo, styreleder, daglig_leder, signatur). Consulte los documentos de Firmaradar para obtener la lista completa.

Devoluciones

Body
RolesResponse

Obtener anuncios de BRREG (alias para cambiar el punto de conexión)

Id. de la operación:
getCompanyAnnouncements

Alias de documentación usado por el catálogo mcP-tool (get_company_announcements). Reenvía al punto de conexión canónico /company/{orgnr}/changes.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.

Devoluciones

respuesta
array of Announcement

Obtener anuncios de BRREG y cambios recientes

Id. de la operación:
getCompanyChanges

Devuelve anuncios BRREG (eventos legales) y cambios recientes (rol, dirección, señal, firma) dentro de la ventana configurada para una empresa. Se usa para la supervisión y el seguimiento de cambios.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.

Devoluciones

respuesta
array of Announcement

Obtener el historial completo de roles de una persona

Id. de la operación:
getPersonRoles

Devuelve el historial de roles completo (activo e histórico) de una persona de rol identificada por su role_person_id estable.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de persona de rol
 role_person_id True string

Identificador estable que identifica un titular de roles, devuelto por los puntos de conexión searchPersons o roles.

Devoluciones

Body
RolePersonProfile

Obtener el perfil completo de la empresa

Id. de la operación:
getCompany

Devuelve el perfil completo de la empresa para un número de organización noruego (orgnr): estado del registro, NACE-industry, empleados, dirección, historial financiero, árbol de propiedad y roles clave. Combina BRREG, datos financieros y enriquecimiento propietario.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

9-sifret organasjonsnummer.
Fields
 fields string

Subconjunto Komma-separert, eks. group,owners,grants,changes,financial_metrics.
Incluir propietarios
 owners string

Si es true, incluye información de propiedad en la respuesta.
Inclusión de concesiones
 grants integer

Si es true, incluye datos de concesiones públicas en la respuesta.
Incluir concesiones BRREG
 brreg_grants integer

Si es true, incluye los datos de concesiones públicas de BRREG en la respuesta. Agrega una llamada ascendente adicional.
Métricas financieras
 financial_metrics integer

Lista separada por comas de métricas financieras que se van a incluir (ingresos, operating_result, capital, etc.).

Devoluciones

Body
Company

Obtener el árbol de propiedad (arriba, abajo o ambos)

Id. de la operación:
getCompanyOwnership

Devuelve el árbol de propiedad de una empresa. direction=down listas subsidiarias; direction=up seguimiento de empresas matriz; direction=both devuelve el grupo completo. Profundidad opcional (1-12) y include_persons para accionistas personales.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.
Dirección del árbol
 direction string

Dirección de recorrido de árbol. 'down' devuelve subsidiarias; 'up' devuelve a los padres; 'both' devuelve el grupo completo.
Profundidad del árbol
 depth integer

Cuántos niveles del árbol de propiedad recorrer. Entero 1-12. Mayor profundidad significa una llamada más lenta.
Incluir personas
 include_persons integer

Si es cierto, incluye accionistas personales en el árbol de propiedad (de lo contrario, solo entidades jurídicas).

Devoluciones

Body
OwnershipResponse

Obtener historial financiero

Id. de la operación:
getCompanyFinancials

Devuelve la historia financiera (ingresos, resultado operativo, capital, activos totales, empleados) hasta 10 años atrás para una empresa noruega.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.
Años atrás
 years integer

Número de años de historial financiero que devolver (1-10).
Tipo de sentencia
 regnskapstype string

Tipo de declaración financiera en la que filtrar (por ejemplo, selskap, konsern). El valor predeterminado devuelve la instrucción canónica.
Omitir la caché de actualización
 skip_freshness integer

Si es true, omite la memoria caché de actualización y fuerza una actualización ascendente. Use con moderación.

Devoluciones

Body
FinancialHistoryResponse

Obtener perfil de persona (orquestación del lado cliente)

Id. de la operación:
getPerson

Asistente del lado cliente que organiza searchPersons + getPersonRoles + getPersonCompanies en una sola vista de perfil. Aquí se documenta la paridad con el catálogo de herramientas de MCP.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre
 name True string

Nombre completo o parcial de la persona. La coincidencia aproximada con la expansión inicial y la eliminación de nombres intermedios se aplica automáticamente.
Año de nacimiento
 birth_year integer

Año de nacimiento de cuatro dígitos usado como filtro adicional en la búsqueda de personas para desambiguar nombres comunes.

Devoluciones

Body
PersonProfile

Puntuación de riesgo de 0 a 100 con nivel y componentes

Id. de la operación:
getRiskScore

Puntuación de riesgo estructurada (0-100) con nivel con nombre (bajo/ moderado/ alto/crítico) y desglose de componentes para el estado financiero de la empresa. Devuelve blocked_enk error para los propietarios únicos. No es un cheque de crédito personal.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.

Devoluciones

Body
RiskScoreResponse

Señales de riesgo agregadas

Id. de la operación:
getCompanySignals

Agrega señales de tres fuentes: señales de anuncio KYC (quiebra, fusión, división), clasificación de angustia (FIV) y señales de equilibrio provisional.

Parámetros

Nombre Clave Requerido Tipo Description
Número de organización
 orgnr True string

Número de organización noruego (exactamente 9 dígitos) emitido por Brønnøysundregistrene.
Desde
 since date

ISO-dato (AAAA-MM-DD). Overstyrer predeterminado 730 dager bakover. Limita til 1825 dager.

Devoluciones

Body
SignalsResponse

Definiciones

Compañía

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string

9-sifret norsk organasjonsnummer.
navn
 navn string
organasjonsform
 organisasjonsform string

BRREG-organasjonsform-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
summary
 summary string

LLM-vennlig kort oppsummering.

Propietario

Nombre Ruta de acceso Tipo Description
navn
 navn string
orgnr
 orgnr string

Para propietarios de empresas: eierens orgnr.
owner_person_key
 owner_person_key string

Para personlige eiere : stabil nøkkel para /person/shareholdings.
eierandel_prosent
 eierandel_prosent float
antall_aksjer
 antall_aksjer integer
type
 type string

Función

Nombre Ruta de acceso 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

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
regnskapstype
 regnskapstype string
items
 items array of FinancialYear
freshness
 freshness object

FinancialYear

Nombre Ruta de acceso 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

Anuncio

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
navn
 navn string
dato
 dato date
kunngjoring_type
 kunngjoring_type string
category
 category string
hendelse_type
 hendelse_type string
niva1_label
 niva1_label string

PersonHit

Nombre Ruta de acceso Tipo Description
nombre
 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

Nombre Ruta de acceso Tipo Description
owner_person_key
 owner_person_key string
nombre
 name string
birth_year
 birth_year string
postted
 poststed string
acciones
 shareholdings array of object
items
 shareholdings object
total_ownership_value_nok
 total_ownership_value_nok number

RolePersonProfile

Nombre Ruta de acceso Tipo Description
role_person_id
 role_person_id string
nombre
 name string
birth_year
 birth_year string
roles
 roles array of Role

CompanyHit

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
navn
 navn string
organasjonsform
 organisasjonsform string
naeringskode
 naeringskode string
kommune
 kommune string
estado
 status string
antall_ansatte
 antall_ansatte integer

CompanySearchResponse

Nombre Ruta de acceso Tipo Description
items
 items array of CompanyHit
next_cursor
 next_cursor string
total_count
 total_count integer

CompareResponse

Nombre Ruta de acceso Tipo Description
orgnrs
 orgnrs array of string
años
 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
comparación
 comparison object

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

PropiedadResponse

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
dirección
 direction string
profundidad
 depth integer
owners
 owners array of Owner
holdings
 holdings object

RolesResponse

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
roles
 roles array of Role
total_count
 total_count integer
almacenados en caché
 cached boolean

SeñalesResponse

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
days_back
 days_back integer
kyc_signals
 kyc_signals object
angustia
 distress object
interim_balance
 interim_balance object
agregado
 aggregate object

AmlHit

Nombre Ruta de acceso 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
match_type
 match_type string
ekstern_id
 ekstern_id string

AmlCheckResponse

Nombre Ruta de acceso 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

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
rapport_id
 rapport_id string
puntuación
 score number
level
 level string
factores
 factors array of object
items
 factors object

NaceCompaniesResponse

Nombre Ruta de acceso Tipo Description
nace_code
 nace_code string
items
 items array of CompanyHit
next_cursor
 next_cursor string
total_count
 total_count integer

RelatedCompaniesResponse

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
Vía
 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

Nombre Ruta de acceso Tipo Description
items
 items array of Announcement
next_cursor
 next_cursor string
filter
 filter object

RiskScoreResponse

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
puntuación
 score integer
level
 level string
components
 components array of object
items
 components object
orígenes
 sources array of string

FivResponse

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
estado
 status string

NUES a-e-status, eks. not_distressed, distressed.
puntuación
 score number
rules_fired
 rules_fired array of object
items
 rules_fired object
confianza
 confidence number
as_of
 as_of date-time

KonsernStotteOversikt

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
selskap_stotte
 selskap_stotte object

Direkte støtte til orgnr (post-#134-skjema). Concesiones directas al orgnr (forma posterior a 134).
konsern_aggregat
 konsern_aggregat object

Aggregert konsern-støtte oppover i eier-tre. Compatibilidad de nivel de grupo agregada.
tildelinger
 tildelinger array of object
items
 tildelinger object

FinancialHistoryResponse

Nombre Ruta de acceso Tipo Description
orgnr
 orgnr string
regnskapstype
 regnskapstype string
items
 items array of FinancialYear
freshness
 freshness object