Firmaradar (Publisher indipendente) (anteprima)
Piattaforma di arricchimento per l'intelligence aziendale norvegese. Fonde i dati di BRREG, Skatteetaten, registri DI PEP e sanzioni stranieri, registri di sovvenzioni pubbliche e segnali di disagio, con arricchimento proprietario in alto (punteggio dei rischi, corrispondenza di persone fuzzy, analisi dei gruppi, conformità di controllo). Progettato per i flussi di lavoro KYC, AML, credit, ownership e risk.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Standard | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Azure cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Di alta qualità | Tutte le aree Power Apps ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Di alta qualità | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Supporto di Firmaradar |
| URL | https://firmaradar.no/kontakt |
| Posta elettronica | support@firmaradar.no |
| Metadati del connettore | |
|---|---|
| Editore | Tiwas |
| Sito web | https://firmaradar.no |
| Informativa sulla privacy | https://firmaradar.no/personvern |
| Categories | Dati; Business intelligence |
Firmaradar (Publisher indipendente)
Firmaradar è una piattaforma di arricchimento per l'intelligence aziendale norvegese. Fonde i dati provenienti da più fonti autorevoli, ovvero il Registro d'affari norvegese (Brønnøysundregistrene), l'Amministrazione fiscale norvegese (Skatteetaten) e i registri esteri PEP e sanzioni, e aggiunge un arricchimento proprietario in primo piano: classificazione dei rischi trasparente, assegnazione dei punteggi dei rischi trasparenti, corrispondenza di persone fuzzy, analisi della struttura di gruppo e pipeline di conformità di livello di controllo. Questo connettore espone 21 operazioni che è possibile eliminare in un flusso per arricchire clienti, fornitori, partner e controparti con intelligence aziendale norvegese strutturata.
Publisher: Lars Kvanum
Proprietario dello stack: Firmaradar AS (Norvegia).
Prerequisiti
- Un account Firmaradar attivo all'indirizzo https://firmaradar.no.
- Una chiave API personale rilasciata tramite min side → API-nøkler (https://firmaradar.no/min-side/api-keys). La chiave viene inviata come
X-API-Keyintestazione HTTP in ogni richiesta. - Una sottoscrizione attiva per le operazioni che si intende usare. Alcune operazioni richiedono un contratto di elaborazione dati (DPA) firmato nell'account Firmaradar, in particolare AML e pep screening.
Il livello gratuito copre una generosa sezione di profili aziendali, proprietà, ruoli, cronologia finanziaria e operazioni di annuncio. Le operazioni a livello di conformità (AML, punteggio di rischio di livello di controllo) richiedono un piano a pagamento e l'accettazione DPA esplicita.
Operazioni supportate
Il connettore espone 21 operazioni di produzione in 6 aree funzionali. Molte operazioni combinano diverse origini upstream dietro una singola chiamata.
Azienda
Cercare un profilo aziendale completo in base al numero dell'organizzazione, espandere l'albero di proprietà e i ruoli di firmatario, recuperare la cronologia finanziaria di più anni, tenere traccia delle modifiche recenti del Registro di sistema, cercare l'universo aziendale e confrontare due società affiancate.
Persona
Cercare una persona, risolvere i ruoli che una persona detiene in tutte le aziende ed elencare i controlli delle condivisioni di una persona.
Rischio
Recuperare i segnali di rischio per una società, cercare il feed degli annunci del Registro di sistema, recuperare un punteggio di rischio trasparente (0-100) con una suddivisione dei componenti ed eseguire una valutazione di disagio "foretak i vanskeligheter" (società in difficoltà).
Industria
Elencare le società all'interno di un codice di settore NACE e trovare le società correlate a una determinata azienda tramite la proprietà o i ruoli.
AML
Visualizzare una persona o un'azienda rispetto a elenchi AML e PEP e recuperare un punteggio AML combinato. Queste operazioni vengono controllate dietro un DPA firmato e vengono mantenute in un log di controllo.
Supporto per i gruppi
Recuperare una panoramica del supporto pubblico dei gruppi e delle concessioni di esposizione (Innovasjon Norge/SkatteFUNN) per un'azienda.
Inoltre, tre alias della documentazione vengono esposti nella specifica per fornire un mapping uno-a-uno con il catalogo McP-tool Firmaradar; questi vengono inoltrati allo stesso back-end delle operazioni canoniche precedenti.
Recupero delle credenziali
- Accedere a https://firmaradar.no con un account Firmaradar verificato.
- Aprire Min side → API-nøkler (My account → API keys).
- Fare clic su Generer ny API-nøkkel (Genera nuova chiave) e copiare la chiave. La chiave completa viene visualizzata una sola volta: archiviarla in un gestore segreti o nelle impostazioni di connessione.
- Quando si crea un flusso che usa questo connettore, incollare la chiave nel campo Connessione chiave API Firmaradar .
È possibile revocare o ruotare la chiave dalla stessa pagina in qualsiasi momento.
Getting Started
- Creare una connessione e incollare la chiave API Firmaradar nel campo Chiave API Firmaradar .
- Aggiungere un'azione Firmaradar al flusso, ad esempio Ottenere un'azienda con un numero di organizzazione,
923609016ad esempio (Equinor ASA). - Usare l'output strutturato nei passaggi downstream: inviare un avviso di rischio a Teams, scrivere un record KYC in Dataverse o arricchire un lead CRM.
Problemi noti e limitazioni
- Risposte in lingua norvegese. Le etichette dei campi e le stringhe leggibili nelle risposte vengono scritte in norvegese (bokmål), riflettendo i registri di origine. I riepiloghi in inglese sono inclusi dove pratico.
- Limiti di frequenza. Gli account di livello gratuito sono limitati a 60 richieste al minuto. Le operazioni AML hanno un limite più rigoroso di 50 richieste per 30 minuti indipendentemente dal piano.
- Registrazione di controllo. Le chiamate alle operazioni di rischio AML e marketplace vengono mantenute in un log di controllo per 60 mesi, come richiesto dalle normative KYC norvegesi. Le
X-FR-Purposeintestazioni eX-FR-DPA-Confirmeddevono essere impostate nelle chiamate AML. Le intestazioni mancanti restituiscono HTTP 403. - Controlli di conformità. L'operazione
getRiskScorepuò restituire HTTP 403 conerror_code=marketplace_hiddenfinché l'account non supera il gate di conformità pertinente. La specifica contrassegna questa operazione con l'estensionex-firmaradar-compliance-gatein modo che i client possano nasconderlo o disabilitarlo in modo dinamico. - Solo numeri di organizzazione a 9 cifre. Tutti i
orgnrparametri di percorso devono essere esattamente di 9 cifre (formato numero organizzazione norvegese). - Cursori di paginazione opachi. Il
next_cursorvalore restituito dalle operazioni impaginate deve essere passato a verbatim. Non analizzarlo o modificarlo.
Domande frequenti
Devo essere una società norvegese per usare questo connettore?
No. Banche non norvegesi, fornitori KYC, piattaforme AML e consulenti M&A possono chiamare Firmaradar come back-end norvegese canonico e unire il risultato in una visione di conformità multi-giurisdizione più ampia.
Questo è solo un wrapper intorno al registro aziendale pubblico?
No. I dati del registro pubblico da soli raramente rispondono a una domanda aziendale reale. Firmaradar riconcilia più fonti e livelli segnali proprietari , ovvero la corrispondenza delle persone, la modellazione dei rischi, l'analisi dei gruppi e il sistema di idraulica della conformità, quindi una singola chiamata restituisce una visualizzazione pronta per le decisioni.
Istruzioni per la distribuzione
Dopo la certificazione, gli utenti finali non devono installare manualmente il connettore, ma diventano disponibili nel catalogo dei connettori standard in Power Automate, Power Apps e App per la logica. Gli sviluppatori che vogliono eseguire la distribuzione prima di poter eseguire la certificazione:
paconn create --api-prop apiProperties.json \
--api-def apiDefinition.swagger.json \
--icon icon.png
Vedere https://learn.microsoft.com/en-us/connectors/custom-connectors/paconn-cli per informazioni di riferimento complete sull'interfaccia della riga di comando.
Support
- Problemi con la definizione del connettore (Swagger, icona, metadati): inviare un problema o una richiesta pull su https://github.com/microsoft/PowerPlatformConnectors.
- Problemi con l'API Firmaradar (dati, limiti di frequenza, accesso all'account): contattare support@firmaradar.no.
- Documentazione generale di Firmaradar:https://firmaradar.no/api-dokumentasjon.
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa connessione non è condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | Tipo | Descrzione | Obbligatorio |
|---|---|---|---|
| chiave_api | Securestring | Il api_key per questa API | True |
Azioni
| Cerca annunci BRREG in tutte le aziende |
Ricerca tra orgnr negli annunci BRREG. Filtrare in base al tipo, all'intervallo di date, allo stato. Usato per il monitoraggio del portfolio e le ricerche ad hoc. |
| Confrontare le metriche finanziarie tra aziende |
Orchestrazione lato server: recupera la cronologia finanziaria per più aziende in parallelo e le restituisce in un formato di confronto semplice da tabella per il benchmarking. |
| Elencare le aziende in un codice del settore NACE |
Restituisce le società registrate con un codice di settore NACE specificato (corrispondenza del prefisso). Supporta i filtri per comuni e dipendenti; impaginato con cursore stabile. |
| Generare un report EML e un punteggio (flusso a due chiamate) |
Genera un report AML per un'azienda e restituisce un punteggio strutturato (0-100) con suddivisione dei fattori. Flusso di due chiamate lato server; il client vede una risposta strutturata. |
| L'esposizione delle concessioni pubbliche a livello di gruppo |
Struttura ad albero delle sovvenzioni pubbliche (sovvenzioni NAV, supporto Covid-19, Innovasjon Norge, SkatteFUNN, EU-grant) ricevuti da una società e dal suo gruppo. Utilizzato per la due diligence sull'esposizione del settore pubblico. |
| Ottenere annunci BRREG (alias per modificare l'endpoint) |
Alias della documentazione usato dal catalogo mcp-tool (get_company_announcements). Inoltra all'endpoint canonico /company/{orgnr}/changes. |
| Ottenere annunci BRREG e modifiche recenti |
Restituisce annunci BRREG (eventi legali) e modifiche recenti (ruolo, indirizzo, segnale, firma) all'interno della finestra configurata per una società. Usato per il monitoraggio e il rilevamento delle modifiche. |
| Ottenere il portafoglio di azioni per una persona |
Restituisce tutte le società in cui una persona detiene azioni, con dettagli relativi alla percentuale di proprietà e alla classe di condivisione, identificati da owner_person_key stabili. |
| Ottenere il profilo aziendale completo |
Restituisce il profilo aziendale completo per un numero di organizzazione norvegese (orgnr): stato del registro, NACE-industry, dipendenti, indirizzo, cronologia finanziaria, albero di proprietà e ruoli chiave. Combina BRREG, dati finanziari e arricchimento proprietario. |
| Ottenere il profilo della persona (orchestrazione lato client) |
Helper lato client che orchestra searchPersons + getPersonRoles + getPersonCompanies in una singola visualizzazione profilo. Documentata qui per parità con il catalogo degli strumenti MCP. |
| Ottenere l'albero di proprietà (su, giù o entrambi) |
Restituisce l'albero di proprietà di una società.
|
| Ottenere la cronologia completa del ruolo per una persona |
Restituisce la cronologia completa dei ruoli (attiva e cronologica) per una persona di ruolo identificata dal relativo role_person_id stabile. |
| Ottenere la cronologia finanziaria |
Restituisce la cronologia finanziaria (ricavi, risultato operativo, capitale netto, attività totali, dipendenti) per un massimo di 10 anni per una società norvegese. |
| Ottenere le modifiche recenti (alias per l'endpoint delle modifiche) |
Alias della documentazione usato dal catalogo mcp-tool (get_recent_changes). Inoltra all'endpoint canonico /company/{orgnr}/changes. |
| Ottenere ruoli aziendali (consiglio di amministrazione, CEO, firmatari) |
Restituisce i titolari di ruolo BRREG (presidente, membro del consiglio di amministrazione, CEO, firmatario, avvocato) per una società. Filtro facoltativo per il tipo di ruolo e l'inclusione dei ruoli cronologici. |
| Persone di ricerca (azionisti e titolari di ruolo) |
Cercare persone in ruoli BRREG e registro degli azionisti. Supporta la corrispondenza dei nomi fuzzy con l'espansione iniziale e l'eliminazione del secondo nome; filtro facoltativo dell'anno di nascita. |
| Punteggio di rischio 0-100 con livello e componenti |
Punteggio di rischio strutturato (0-100) con livello denominato (basso/moderato/alto/critico) e suddivisione dei componenti per la salute finanziaria dell'azienda. Restituisce blocked_enk errore relativo alle sole-proprietarie. Non un assegno di credito personale. |
| Screening AML e PEP (richiede intestazioni DPA) |
Schermate di una persona contro sanzioni e elenchi PEP. Richiede le intestazioni DPA firmate e X-FR-Purpose per chiamata e X-FR-DPA-Confirmed. Tutte le chiamate vengono registrate per 60 mesi come richiesto dalle normative KYC norvegesi. |
| Segnali di rischio aggregati |
Aggrega i segnali provenienti da tre fonti: segnali di annuncio KYC (fallimento, fusione, divisione), classificazione delle difficoltà (FIV) e segnali di equilibrio intermedio. |
| Società di ricerca (nome, NACE, comune) |
Ricerca unificata tra il nome della società, il codice del settore NACE e il comune. Restituisce risultati impaginati con cursore stabile per la pagina successiva. |
| Stato FIV (società in difficoltà) |
Valuta se un'azienda si qualifica come "foretak i vanskeligheter" (FIV/company in difficoltà) in base alle regole a-e di NUES norvegesi, in base alle ultime dichiarazioni finanziarie disponibili. |
| Trovare società correlate (persone condivise o indirizzo) |
Trova le aziende che condividono i titolari di ruolo o l'indirizzo aziendale con l'azienda di input. Usato per la due diligence e il mapping di rete. |
Cerca annunci BRREG in tutte le aziende
Ricerca tra orgnr negli annunci BRREG. Filtrare in base al tipo, all'intervallo di date, allo stato. Usato per il monitoraggio del portfolio e le ricerche ad hoc.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Filtro dei tipi
|
type | string |
Filtrare il tipo dell'elemento (varia per endpoint; vedere la descrizione dell'operazione). |
|
|
Data da
|
from | date |
Inizio dell'intervallo di date in formato ISO (AAAA-MM-DD). All inclusive. |
|
|
Da data a
|
to | date |
Fine dell'intervallo di date in formato ISO (AAAA-MM-DD). All inclusive. |
|
|
Numero organizzazione
|
orgnr | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
|
|
Query di ricerca
|
q | string |
Query di ricerca senza testo corrispondente al nome della società o al numero dell'organizzazione. |
|
|
Limit
|
limit | integer |
Numero massimo di elementi da restituire in questa pagina. Il valore predefinito e massimo variano in base all'endpoint. |
|
|
Cursore paginazione
|
cursor | string |
Cursore paginazione opaco restituito da una chiamata precedente. Passalo indietro verbatim per recuperare la pagina successiva. Non analizzare o modificare. |
Valori restituiti
Confrontare le metriche finanziarie tra aziende
Orchestrazione lato server: recupera la cronologia finanziaria per più aziende in parallelo e le restituisce in un formato di confronto semplice da tabella per il benchmarking.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
orgnrs
|
orgnrs | True | array of string | |
|
anni
|
years | integer | ||
|
metrics
|
metrics | array of string |
Valori restituiti
- Corpo
- CompareResponse
Elencare le aziende in un codice del settore NACE
Restituisce le società registrate con un codice di settore NACE specificato (corrispondenza del prefisso). Supporta i filtri per comuni e dipendenti; impaginato con cursore stabile.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Codice NACE
|
code | True | string |
Prefisso NACE-kode eller (eks. |
|
Filtro di stato
|
status | string |
Filtrare in base allo stato legale (ad esempio, attivo, under_liquidation, struck_off). |
|
|
Municipality
|
kommune | string |
Codice comune norvegese (4 cifre, ad esempio 0301 per Oslo) usato per filtrare i risultati geograficamente. |
|
|
Min employees
|
min_ansatte | integer |
Numero minimo di dipendenti che l'azienda deve avere (inclusi). |
|
|
Numero massimo di dipendenti
|
max_ansatte | integer |
Numero massimo di dipendenti che l'azienda deve avere (inclusi). |
|
|
Limit
|
limit | integer |
Numero massimo di elementi da restituire in questa pagina. Il valore predefinito e massimo variano in base all'endpoint. |
|
|
Cursore paginazione
|
cursor | string |
Cursore paginazione opaco restituito da una chiamata precedente. Passalo indietro verbatim per recuperare la pagina successiva. Non analizzare o modificare. |
|
|
Includi totali
|
include_total | integer |
Se true, include i totali aggregati di gruppo nella risposta. |
Valori restituiti
- Corpo
- NaceCompaniesResponse
Generare un report EML e un punteggio (flusso a due chiamate)
Genera un report AML per un'azienda e restituisce un punteggio strutturato (0-100) con suddivisione dei fattori. Flusso di due chiamate lato server; il client vede una risposta strutturata.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
orgnr
|
orgnr | True | string | |
|
purpose
|
purpose | string |
DPA-formål per AML-screening (eks. |
Valori restituiti
- Corpo
- AmlScoreResponse
L'esposizione delle concessioni pubbliche a livello di gruppo
Struttura ad albero delle sovvenzioni pubbliche (sovvenzioni NAV, supporto Covid-19, Innovasjon Norge, SkatteFUNN, EU-grant) ricevuti da una società e dal suo gruppo. Utilizzato per la due diligence sull'esposizione del settore pubblico.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
Valori restituiti
- Corpo
- KonsernStotteOversikt
Ottenere annunci BRREG (alias per modificare l'endpoint)
Alias della documentazione usato dal catalogo mcp-tool (get_company_announcements). Inoltra all'endpoint canonico /company/{orgnr}/changes.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
Valori restituiti
- response
- array of Announcement
Ottenere annunci BRREG e modifiche recenti
Restituisce annunci BRREG (eventi legali) e modifiche recenti (ruolo, indirizzo, segnale, firma) all'interno della finestra configurata per una società. Usato per il monitoraggio e il rilevamento delle modifiche.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
Valori restituiti
- response
- array of Announcement
Ottenere il portafoglio di azioni per una persona
Restituisce tutte le società in cui una persona detiene azioni, con dettagli relativi alla percentuale di proprietà e alla classe di condivisione, identificati da owner_person_key stabili.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Chiave della persona proprietario
|
owner_person_key | True | string |
Chiave stabile che identifica un operatore personale, restituito da searchPersons o endpoint di proprietà. |
Valori restituiti
- Corpo
- PersonProfile
Ottenere il profilo aziendale completo
Restituisce il profilo aziendale completo per un numero di organizzazione norvegese (orgnr): stato del registro, NACE-industry, dipendenti, indirizzo, cronologia finanziaria, albero di proprietà e ruoli chiave. Combina BRREG, dati finanziari e arricchimento proprietario.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Organisasjonsnummer 9-sifret. |
|
Fields
|
fields | string |
Subset Komma-separert, eks.
|
|
|
Includi proprietari
|
owners | string |
Se true, include le informazioni di proprietà nella risposta. |
|
|
Includi concessioni
|
grants | integer |
Se true, include i dati delle concessioni pubbliche nella risposta. |
|
|
Includere concessioni BRREG
|
brreg_grants | integer |
Se true, include i dati delle concessioni pubbliche BRREG nella risposta. Aggiunge una chiamata upstream aggiuntiva. |
|
|
Metriche finanziarie
|
financial_metrics | integer |
Elenco delimitato da virgole di metriche finanziarie da includere (ricavi, operating_result, azioni e così via). |
Valori restituiti
- Corpo
- Company
Ottenere il profilo della persona (orchestrazione lato client)
Helper lato client che orchestra searchPersons + getPersonRoles + getPersonCompanies in una singola visualizzazione profilo. Documentata qui per parità con il catalogo degli strumenti MCP.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome
|
name | True | string |
Nome completo o parziale della persona. La corrispondenza fuzzy con l'espansione iniziale e l'eliminazione del secondo nome vengono applicate automaticamente. |
|
Anno di nascita
|
birth_year | integer |
Anno di nascita a quattro cifre usato come filtro aggiuntivo nella ricerca di persona per disambiguare i nomi comuni. |
Valori restituiti
- Corpo
- PersonProfile
Ottenere l'albero di proprietà (su, giù o entrambi)
Restituisce l'albero di proprietà di una società.
direction=down liste controllate; direction=up tracce di società padre; direction=both restituisce il gruppo completo. Profondità facoltativa (1-12) e include_persons per gli azionisti personali.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
|
Direzione albero
|
direction | string |
Direzione di attraversamento dell'albero. "down" restituisce filiali; "up" restituisce i genitori; 'both' restituisce il gruppo completo. |
|
|
Profondità albero
|
depth | integer |
Numero di livelli dell'albero di proprietà da attraversare. Numero intero da 1 a 12. Maggiore profondità indica una chiamata più lenta. |
|
|
Includere persone
|
include_persons | integer |
Se true, include gli azionisti personali nell'albero di proprietà (altrimenti solo le persone giuridiche). |
Valori restituiti
- Corpo
- OwnershipResponse
Ottenere la cronologia completa del ruolo per una persona
Restituisce la cronologia completa dei ruoli (attiva e cronologica) per una persona di ruolo identificata dal relativo role_person_id stabile.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID persona ruolo
|
role_person_id | True | string |
ID stabile che identifica un titolare del ruolo, restituito da searchPersons o endpoint dei ruoli. |
Valori restituiti
- Corpo
- RolePersonProfile
Ottenere la cronologia finanziaria
Restituisce la cronologia finanziaria (ricavi, risultato operativo, capitale netto, attività totali, dipendenti) per un massimo di 10 anni per una società norvegese.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
|
Anni indietro
|
years | integer |
Numero di anni di storia finanziaria da restituire (1-10). |
|
|
Tipo di dichiarazione
|
regnskapstype | string |
Tipo di rendiconto finanziario da filtrare (ad esempio selskap, konsern). Il valore predefinito restituisce l'istruzione canonica. |
|
|
Ignorare la cache di aggiornamento
|
skip_freshness | integer |
Se true, ignora la cache di aggiornamento e forza un aggiornamento upstream. Usare con moderazione. |
Valori restituiti
- Corpo
- FinancialHistoryResponse
Ottenere le modifiche recenti (alias per l'endpoint delle modifiche)
Alias della documentazione usato dal catalogo mcp-tool (get_recent_changes). Inoltra all'endpoint canonico /company/{orgnr}/changes.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
Valori restituiti
- response
- array of Announcement
Ottenere ruoli aziendali (consiglio di amministrazione, CEO, firmatari)
Restituisce i titolari di ruolo BRREG (presidente, membro del consiglio di amministrazione, CEO, firmatario, avvocato) per una società. Filtro facoltativo per il tipo di ruolo e l'inclusione dei ruoli cronologici.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
|
Includi cronologia
|
include_historic | integer |
Se true, include i titolari di ruolo cronologici (riassegnati) oltre a quelli correnti. |
|
|
Tipo di ruolo
|
role_type | string |
Filtrare in base al codice di tipo di ruolo norvegese (ad esempio styreleder, daglig_leder, signatur). Per l'elenco completo, vedere la documentazione di Firmaradar. |
Valori restituiti
- Corpo
- RolesResponse
Persone di ricerca (azionisti e titolari di ruolo)
Cercare persone in ruoli BRREG e registro degli azionisti. Supporta la corrispondenza dei nomi fuzzy con l'espansione iniziale e l'eliminazione del secondo nome; filtro facoltativo dell'anno di nascita.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Query di ricerca
|
q | True | string |
Query di ricerca senza testo corrispondente al nome della società o al numero dell'organizzazione. |
|
Limit
|
limit | integer |
Numero massimo di elementi da restituire in questa pagina. Il valore predefinito e massimo variano in base all'endpoint. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
query
|
query | string | |
|
Azionisti
|
shareholders | array of PersonHit | |
|
shareholders_count
|
shareholders_count | integer | |
|
role_persons
|
role_persons | array of PersonHit | |
|
role_persons_count
|
role_persons_count | integer |
Punteggio di rischio 0-100 con livello e componenti
Punteggio di rischio strutturato (0-100) con livello denominato (basso/moderato/alto/critico) e suddivisione dei componenti per la salute finanziaria dell'azienda. Restituisce blocked_enk errore relativo alle sole-proprietarie. Non un assegno di credito personale.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
Valori restituiti
- Corpo
- RiskScoreResponse
Screening AML e PEP (richiede intestazioni DPA)
Schermate di una persona contro sanzioni e elenchi PEP. Richiede le intestazioni DPA firmate e X-FR-Purpose per chiamata e X-FR-DPA-Confirmed. Tutte le chiamate vengono registrate per 60 mesi come richiesto dalle normative KYC norvegesi.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Tag scopo
|
X-FR-Purpose | True | string |
Tag scopo per la ricerca AML. Uno di: kyc_onboarding, kyc_review, risk_monitoring manuale. Obbligatorio per le chiamate AML e salvato in modo permanente nel log di controllo. |
|
Conferma DPA
|
X-FR-DPA-Confirmed | True | string |
Conferma dell'avvenuta firma del Contratto di trattamento dei dati relativo alla ricerca AML. Obbligatorio per le chiamate AML. |
|
nome
|
name | True | string | |
|
birth_year
|
birth_year | integer | ||
|
kategori
|
kategori | string | ||
|
min_match_ratio
|
min_match_ratio | number |
Valori restituiti
- Corpo
- AmlCheckResponse
Segnali di rischio aggregati
Aggrega i segnali provenienti da tre fonti: segnali di annuncio KYC (fallimento, fusione, divisione), classificazione delle difficoltà (FIV) e segnali di equilibrio intermedio.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
|
Since
|
since | date |
ISO-dato (AAAA-MM-DD). Overstyrer default 730 dager bakover. Cappes til 1825 dager. |
Valori restituiti
- Corpo
- SignalsResponse
Società di ricerca (nome, NACE, comune)
Ricerca unificata tra il nome della società, il codice del settore NACE e il comune. Restituisce risultati impaginati con cursore stabile per la pagina successiva.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Query di ricerca
|
q | string |
Query di ricerca senza testo corrispondente al nome della società o al numero dell'organizzazione. |
|
|
Filtro NACE
|
nace | string |
Filtra i risultati in base al codice del settore NACE (2-5 cifre, corrispondenza prefisso supportata). |
|
|
Municipality
|
kommune | string |
Codice comune norvegese (4 cifre, ad esempio 0301 per Oslo) usato per filtrare i risultati geograficamente. |
|
|
Limit
|
limit | integer |
Numero massimo di elementi da restituire in questa pagina. Il valore predefinito e massimo variano in base all'endpoint. |
|
|
Cursore paginazione
|
cursor | string |
Cursore paginazione opaco restituito da una chiamata precedente. Passalo indietro verbatim per recuperare la pagina successiva. Non analizzare o modificare. |
Valori restituiti
- Corpo
- CompanySearchResponse
Stato FIV (società in difficoltà)
Valuta se un'azienda si qualifica come "foretak i vanskeligheter" (FIV/company in difficoltà) in base alle regole a-e di NUES norvegesi, in base alle ultime dichiarazioni finanziarie disponibili.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
Valori restituiti
- Corpo
- FivResponse
Trovare società correlate (persone condivise o indirizzo)
Trova le aziende che condividono i titolari di ruolo o l'indirizzo aziendale con l'azienda di input. Usato per la due diligence e il mapping di rete.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero organizzazione
|
orgnr | True | string |
Numero organizzazione norvegese (esattamente 9 cifre) rilasciato da Brønnøysundregistrene. |
|
Relazione tramite
|
via | string |
Come viene determinata la correlazione. 'person' utilizza i titolari di ruolo condivisi; 'address' usa l'indirizzo aziendale condiviso. |
|
|
Limit
|
limit | integer |
Numero massimo di elementi da restituire in questa pagina. Il valore predefinito e massimo variano in base all'endpoint. |
|
|
Sovrapposizione minima
|
min_overlap | integer |
Numero minimo di persone o indirizzi condivisi necessari per una corrispondenza aziendale correlata. |
Valori restituiti
- Corpo
- RelatedCompaniesResponse
Definizioni
Azienda
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string |
9-sifret norsk organisasjonsnummer. |
|
spostamento
|
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 | |
|
summary
|
summary | string |
LLM-vennlig kort oppsummering. |
Proprietario
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
spostamento
|
navn | string | |
|
orgnr
|
orgnr | string |
Per i proprietari di imprese — eierens orgnr. |
|
owner_person_key
|
owner_person_key | string |
Per personlige eiere — stabil nøkkel per /person/shareholdings. |
|
eierandel_prosent
|
eierandel_prosent | float | |
|
antall_aksjer
|
antall_aksjer | integer | |
|
type
|
type | string |
Ruolo
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
rolle_type
|
rolle_type | string |
BRREG-rolle-beskrivelse (Styreleder, Daglig leder, ...). |
|
spostamento
|
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 | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
regskapstype
|
regnskapstype | string | |
|
items
|
items | array of FinancialYear | |
|
freshness
|
freshness | object |
FinancialYear
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
regskapsar
|
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 |
Annuncio
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
spostamento
|
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 | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
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 | |
|
post
|
poststed | string | |
|
antall_selskaper
|
antall_selskaper | integer |
PersonProfile
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
owner_person_key
|
owner_person_key | string | |
|
nome
|
name | string | |
|
birth_year
|
birth_year | string | |
|
post
|
poststed | string | |
|
Partecipazioni
|
shareholdings | array of object | |
|
items
|
shareholdings | object | |
|
total_ownership_value_nok
|
total_ownership_value_nok | number |
RolePersonProfile
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
role_person_id
|
role_person_id | string | |
|
nome
|
name | string | |
|
birth_year
|
birth_year | string | |
|
roles
|
roles | array of Role |
CompanyHit
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
spostamento
|
navn | string | |
|
organisasjonsform
|
organisasjonsform | string | |
|
naeringskode
|
naeringskode | string | |
|
kommune
|
kommune | string | |
|
stato
|
status | string | |
|
antall_ansatte
|
antall_ansatte | integer |
CompanySearchResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
items
|
items | array of CompanyHit | |
|
next_cursor
|
next_cursor | string | |
|
total_count
|
total_count | integer |
CompareResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnrs
|
orgnrs | array of string | |
|
anni
|
years | array of integer | |
|
società
|
companies | array of object | |
|
orgnr
|
companies.orgnr | string | |
|
spostamento
|
companies.navn | string | |
|
financials_by_year
|
companies.financials_by_year | object | |
|
paragone
|
comparison | object |
{<metrica>: {<orgnr>: [<value_per_year>]}} |
|
computed_at
|
computed_at | date-time |
ProprietàResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
direzione
|
direction | string | |
|
profondità
|
depth | integer | |
|
Proprietari
|
owners | array of Owner | |
|
Holdings
|
holdings | object |
RolesResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
roles
|
roles | array of Role | |
|
total_count
|
total_count | integer | |
|
Memorizzati nella cache
|
cached | boolean |
SignalsResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
days_back
|
days_back | integer | |
|
kyc_signals
|
kyc_signals | object | |
|
disagio
|
distress | object | |
|
interim_balance
|
interim_balance | object | |
|
aggregate
|
aggregate | object |
AmlHit
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
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
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
query_name
|
query_name | string | |
|
query_birth_year
|
query_birth_year | integer | |
|
Hits
|
hits | array of AmlHit | |
|
hit_count
|
hit_count | integer |
AmlScoreResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
rapport_id
|
rapport_id | string | |
|
score
|
score | number | |
|
level
|
level | string | |
|
Fattori
|
factors | array of object | |
|
items
|
factors | object |
NaceCompaniesResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
nace_code
|
nace_code | string | |
|
items
|
items | array of CompanyHit | |
|
next_cursor
|
next_cursor | string | |
|
total_count
|
total_count | integer |
RelatedCompaniesResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
tramite
|
via | string | |
|
imparentato
|
related | array of object | |
|
orgnr
|
related.orgnr | string | |
|
spostamento
|
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 |
AnnunciSearchResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
items
|
items | array of Announcement | |
|
next_cursor
|
next_cursor | string | |
|
filter
|
filter | object |
RiskScoreResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
score
|
score | integer | |
|
level
|
level | string | |
|
components
|
components | array of object | |
|
items
|
components | object | |
|
Fonti
|
sources | array of string |
FivResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
stato
|
status | string |
NUES a-e-status, eks.
|
|
score
|
score | number | |
|
rules_fired
|
rules_fired | array of object | |
|
items
|
rules_fired | object | |
|
confidenziale
|
confidence | number | |
|
as_of
|
as_of | date-time |
KonsernStotteOversikt
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
selskap_stotte
|
selskap_stotte | object |
Direkte støtte til orgnr (post-#134-skjema). Direct concede all'orgnr (forma post-#134). |
|
konsern_aggregat
|
konsern_aggregat | object |
Aggregert konsern-støtte oppover i eier-tre. Supporto a livello di gruppo aggregato. |
|
tildelinger
|
tildelinger | array of object | |
|
items
|
tildelinger | object |
FinancialHistoryResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
regskapstype
|
regnskapstype | string | |
|
items
|
items | array of FinancialYear | |
|
freshness
|
freshness | object |