Firmaradar (nezávislá Publisher) (Preview)

Platformu rozšiřování pro norskou inteligenci společnosti. Zatěžuje data z registrů BRREG, Skatteetaten, cizích pepů a sankcí, veřejných grantů a nouzových signálů s proprietárním rozšiřováním (bodování rizik, přibližná shoda osob, analýza skupin, dodržování předpisů na úrovni auditu). Vytvořené pro pracovní postupy KYC, AML, kredit, vlastnictví a rizika.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Premium	Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)
Logické aplikace	Standard	Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Azure oblasti Čína - Ministerstvo obrany USA (DoD)
Power Apps	Premium	Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)
Automatizace napájení	Premium	Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)

Kontakt
Název	Podpora společnosti Firmaradar
URL	https://firmaradar.no/kontakt
Email	support@firmaradar.no

Metadata konektoru
Vydavatel	Tiwas
Internetová stránka	https://firmaradar.no
Zásady ochrany osobních údajů	https://firmaradar.no/personvern
Kategorie	Data; Business Intelligence

Firmaradar (nezávislá Publisher)

Firmaradar je platforma pro rozšiřování pro norskou firemní inteligenci. Shoduje data z několika autoritativních zdrojů – norský obchodní registr (Brønnøysundregistrene), norská daňová správa (Skatteetaten) a cizí rejstříky PEP a sankcí – a přidává navrchu proprietární rozšiřování: klasifikace tísňového stavu, transparentní vyhodnocování rizik, přibližné párování osob, analýzy struktury skupin a kanály dodržování předpisů na úrovni auditu. Tento konektor zpřístupňuje 21 operací, které umožňují rozšířit zákazníky, dodavatele, partnery a protistrany pomocí strukturovaného norského firemního intelligence.

Publisher: Lars Kvanum

Vlastník zásobníku: Firmaradar AS (Norsko).

Předpoklady

Aktivní účet Firmaradar ve společnosti https://firmaradar.no.
Osobní klíč rozhraní API vydaný prostřednictvím rozhraní API-nøkler (Min side → API-nøkler).https://firmaradar.no/min-side/api-keys Klíč se odešle jako hlavička X-API-Key HTTP pro každý požadavek.
Aktivní předplatné pro operace, které chcete použít. Některé operace vyžadují smlouvu o zpracování dat (DPA) podepsanou ve vašem účtu Firmaradar , zejména blokování AML a PEP.

Bezplatná úroveň zahrnuje velkorysý rozsah podnikových profilů, vlastnictví, rolí, finanční historie a oznamovacích operací. Operace na úrovni dodržování předpisů (AML, vyhodnocování rizik na úrovni auditu) vyžadují placený plán a explicitní přijetí DPA.

Podporované operace

Konektor zveřejňuje 21 produkčních operací napříč 6 funkčními oblastmi. Mnoho operací kombinuje několik upstreamových zdrojů za jedním voláním.

Společnost

Vyhledejte si úplný profil společnosti podle čísla organizace, rozbalte svůj strom vlastnictví a správní rady nebo signatářských rolí, získejte víceleté finanční historii, sledujte nedávné změny registru, prohledejte vesmír společnosti a porovnejte dvě společnosti vedle sebe.

Person

Vyhledejte osobu, vyřešte role, které osoba uchovává ve společnostech, a uveďte seznam podílů, které osoba řídí.

Riziko

Načtěte rizikové signály pro společnost, prohledejte informační kanál oznámení registru, načtěte transparentní rizikové skóre (0–100) s rozpisem součástí a spusťte zákonné posouzení "foretak i vanskeligheter" (společnost v obtížích) v nouzovém hodnocení.

Průmysl

Uveďte společnosti v rámci kódu oboru NACE a najděte společnosti související s danou společností prostřednictvím vlastnictví nebo rolí.

AML

Zobrazí osobu nebo společnost v seznamech AML a PEP a načte kombinované skóre AML. Tyto operace jsou chráněné za podepsanou DPA a uchovávají se v protokolu auditu.

Podpora skupin

Načtěte přehled podpory veřejných skupin a grantů expozice (Innovasjon Norge / SkatteFUNN) pro společnost.

Kromě toho jsou ve specifikaci vystaveny tři aliasy dokumentace, které poskytují mapování 1:1 s katalogem nástrojů Firmaradar MCP; tyto předávají do stejného back-endu jako kanonické operace uvedené výše.

Získání přihlašovacích údajů

Přihlaste se pomocí https://firmaradar.no ověřeného účtu Firmaradar.
Otevřete min boční → API-nøkler (Můj účet → klíče rozhraní API).
Klikněte na Generer ny API-nøkkel (Vygenerovat nový klíč) a zkopírujte klíč. Celý klíč se zobrazí jenom jednou – uložte ho ve správci tajných kódů nebo v nastavení připojení.
Když vytvoříte tok, který používá tento konektor, vložte klíč do pole připojení klíče rozhraní API Firmaradar .

Klíč můžete kdykoli odvolat nebo otočit ze stejné stránky.

Začínáme

Vytvořte připojení a vložte klíč rozhraní API Firmaradar do pole klíč rozhraní API Firmaradar .
Přidejte do svého toku akci Firmaradar – například Získejte společnost s číslem organizace, například 923609016 (Equinor ASA).
Použijte strukturovaný výstup v podřízených krocích: po upozornění na rizika do Teams, napište záznam KYC do Služby Dataverse nebo obohacení potenciálního zákazníka CRM.

Známé problémy a omezení

Odpovědi v norštině. Popisky polí a řetězce čitelné pro člověka v odpovědích jsou napsané v norštině (bokmål), které odrážejí zdrojové registry. Anglické souhrny jsou zahrnuty tam, kde je to praktické.
Omezení rychlosti. Účty úrovně Free jsou omezené na 60 požadavků za minutu. Operace AML mají přísnější limit 50 požadavků na 30 minut bez ohledu na plán.
Protokolování auditu Volání operací rizik AML a marketplace se uchovávají v protokolu auditu po dobu 60 měsíců podle požadavků norských předpisů KYC. U volání AML je nutné nastavit hlavičky X-FR-Purpose a X-FR-DPA-Confirmed chybějící hlavičky vrátí HTTP 403.
Brány dodržování předpisů. Operace getRiskScore může vrátit protokol HTTP 403, dokud error_code=marketplace_hidden účet nepřejde příslušnou bránou dodržování předpisů. Tato specifikace označuje tuto operaci rozšířením x-firmaradar-compliance-gate , aby ji klienti mohli dynamicky skrýt nebo zakázat.
Pouze 9místná čísla organizace. Všechny orgnr parametry cesty musí být přesně 9 číslic (norský formát čísla organizace).
Neprůhlé kurzory stránkování. Hodnota next_cursor vrácená stránkovanými operacemi musí být předána doslovně – neanalyzujte ani neupravujte.

Nejčastější dotazy

Musím být norská společnost, aby tento konektor používala?

Ne. Jiné než norské banky, dodavatelé KYC, platformy AML a poradci M&A mohou volat Společnostradar jako jejich kanonický norský back-end a spojit výsledek do širšího zobrazení dodržování předpisů ve více jurisdikcích.

Je to jen obálka kolem veřejného obchodního rejstříku?

Ne. Samotná data veřejného registru zřídka odpovídají na skutečnou obchodní otázku. Firmaradar odsouhlasí více zdrojů a vrstev proprietární signály – přizpůsobení osob, modelování rizik, analýzy skupin a dodržování předpisů – takže jedno volání vrátí zobrazení připravené k rozhodování.

Pokyny k nasazení

Po certifikaci nemusí koncoví uživatelé konektor instalovat ručně – bude k dispozici ve standardním katalogu konektorů v Power Automate, Power Apps a Logic Apps. Vývojáři, kteří chtějí nasadit před spuštěním certifikace:

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

Úplné https://learn.microsoft.com/en-us/connectors/custom-connectors/paconn-cli referenční informace k rozhraní příkazového řádku

Podpora

Problémy s definicí konektoru (Swagger, ikona, metadata): vytvořte problém nebo žádost o https://github.com/microsoft/PowerPlatformConnectorspřijetí změn .
Problémy s rozhraním API Společnostiradar (data, omezení rychlosti, přístup k účtu): kontakt support@firmaradar.no.
Obecná dokumentace společnosti Firmaradar:https://firmaradar.no/api-dokumentasjon.

Vytvoření připojení

Konektor podporuje následující typy ověřování:


Default	Parametry pro vytvoření připojení	Všechny oblasti	Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název	Typ	Description	Povinné
klíč API	Securestring	Api_key pro toto rozhraní API	Pravdivé

Akce

Agregované rizikové signály	Agreguje signály ze tří zdrojů: signály oznámení KYC (bankrot, fúze, divize), klasifikace tísňového stavu (FIV) a signály dočasné rovnováhy.
Blokování AML a PEP (vyžaduje hlavičky DPA)	Zobrazí osobu proti sankcím a seznamům PEP. Vyžaduje podepsanou DPA a X-FR-Purpose x-FR a hlavičkyDPA-Confirmed X-FR. Všechna volání jsou protokolována auditem po dobu 60 měsíců podle požadavků norských předpisů KYC.
Generování sestavy a skóre AML (tok dvou volání)	Vygeneruje sestavu AML pro společnost a vrátí strukturované skóre (0–100) s rozpisem faktoru. Tok dvou volání na straně serveru; klient vidí jednu strukturovanou odpověď.
Porovnání finančních metrik napříč společnostmi	Orchestrace na straně serveru: Načte finanční historii pro více společností paralelně a vrací je v tabulkovém srovnávacím formátu pro srovnávací testy.
Rizikové skóre 0–100 s úrovní a komponentami	Strukturované skóre rizika (0–100) s pojmenovanou úrovní (nízká/ střední/ střední/ kritická) a rozpisem součástí pro finanční stav společnosti. Vrátí chybu blocked_enk pro výhradní vlastníky. Ne osobní ověření kredibility.
Stav FIV (společnost v obtížích)	Posuzuje, zda se společnost považuje za "foretak i vanskeligheter" (FIV / společnost v obtížích) podle norských pravidel NUES a-e na základě nejnovějších dostupných finančních výkazů.
Veřejné granty expozice napříč skupinami	Stromová struktura veřejných grantů (granty NAV, podpora Covid-19, Innovasjon Norge, SkatteFUNN, EU-granty) přijaté společností a její skupinou. Používá se k důkladné péči o expozici veřejného sektoru.
Vyhledání souvisejících společností (sdílených osob nebo adres)	Najde společnosti sdílející držitele rolí nebo obchodní adresu se vstupní společností. Používá se pro hloubkovou kontrolu a mapování sítě.
Vyhledávací společnosti (název, NACE, obec)	Jednotné vyhledávání napříč názvem společnosti, kódem NACE a obcemi. Vrátí stránkované výsledky se stabilním kurzorem pro další stránku.
Vyhledávání osob (akcionáři a držitelé rolí)	Vyhledejte osoby napříč držiteli rolí BRREG a rejstříkem akcionářů. Podporuje přibližné párování názvů s počátečním rozšířením a vyřazením prostředního názvu; volitelný filtr roku narození.
Vyhledávání oznámení BRREG napříč společnostmi	Vyhledávání křížového vyhledávání v oznámeních BRREG Filtrovat podle typu, rozsahu kalendářních dat, stavu Používá se pro monitorování portfolia a ad hoc vyhledávání.
Výpis společností v kódu oboru NACE	Vrátí společnosti registrované s daným kódem NACE (shoda předpony). Podporuje filtry měst a zaměstnanců; stránkované se stabilním kurzorem.
Získání finanční historie	Vrátí finanční historii (výnosy, provozní výsledek, vlastní kapitál, celková aktiva, zaměstnanci) po dobu až 10 let zpět pro norskou společnost.
Získání nedávných změn (alias ke koncovému bodu změn)	Alias dokumentace používaný katalogem nástrojů MCP (get_recent_changes). Přepošle do koncového bodu canonical /company/{orgnr}/changes.
Získání oznámení BRREG (alias pro změny koncového bodu)	Alias dokumentace používaný katalogem nástrojů MCP (get_company_announcements). Přepošle do koncového bodu canonical /company/{orgnr}/changes.
Získání oznámení BRREG a nedávných změn	Vrátí oznámení BRREG (právní události) a nedávné změny (role, adresa, signál, podpis) v rámci nakonfigurovaného okna pro společnost. Používá se k monitorování a sledování změn.
Získání portfolia podílů pro osobu	Vrátí všechny společnosti, ve které osoba uchovává podíly, s procentem vlastnictví a podrobnostmi třídy podílů identifikovanými stabilními owner_person_key.
Získání profilu osoby (orchestrace na straně klienta)	Pomocník na straně klienta, který orchestruje funkce searchPersons + getPersonRoles + getPersonCompanies do jednoho zobrazení profilu. Tady je dokumentováno pro paritu s katalogem nástrojů MCP.
Získání rolí společnosti (board, CEO, signatáři)	Vrátí držitele rolí BRREG (předseda, člen rady, generální ředitel, signatář, moc advokáta) pro společnost. Volitelný filtr pro typ role a zahrnutí historických rolí.
Získání stromu vlastnictví (nahoru, dolů nebo obojí)	Vrátí strom vlastnictví společnosti. `direction=down` seznamy dceřiných společností; `direction=up` sleduje mateřské společnosti; `direction=both` vrátí úplnou skupinu. Volitelná hloubka (1–12) a include_persons pro osobní akcionáře.
Získání úplné historie rolí pro osobu	Vrátí úplnou historii rolí (aktivní a historickou) pro osobu, která je identifikovaná stabilním role_person_id.
Získání úplného firemního profilu	Vrátí úplný profil společnosti pro číslo norské organizace (orgnr): stav registru, obor NACE, zaměstnanci, adresu, finanční historii, strom vlastnictví a klíčové role. Kombinuje BRREG, finanční data a proprietární rozšiřování.

Agregované rizikové signály

ID operace:: getCompanySignals

Agreguje signály ze tří zdrojů: signály oznámení KYC (bankrot, fúze, divize), klasifikace tísňového stavu (FIV) a signály dočasné rovnováhy.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.
Jelikož	since		date	ISO-dato (YYYY-MM-DD). Výchozí 730 dager bakoveru overstyrer. Cappes til 1825 dager.

Návraty

Tělo: SignalsResponse

Blokování AML a PEP (vyžaduje hlavičky DPA)

ID operace:: checkAmlPep

Zobrazí osobu proti sankcím a seznamům PEP. Vyžaduje podepsanou DPA a X-FR-Purpose x-FR a hlavičkyDPA-Confirmed X-FR. Všechna volání jsou protokolována auditem po dobu 60 měsíců podle požadavků norských předpisů KYC.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Značka účelu	X-FR-Purpose	True	string	Značka účelu pro vyhledávání AML Jeden z: kyc_onboarding, kyc_review, risk_monitoring, ruční. Vyžaduje se pro volání AML a trvalé v protokolu auditu.
Potvrzení DPA	X-FR-DPA-Confirmed	True	string	Potvrzení, že máte podepsanou smlouvu o zpracování dat, která pokrývá toto vyhledávání AML. Vyžaduje se pro volání AML.
název	name	True	string
birth_year	birth_year		integer
kategori	kategori		string
min_match_ratio	min_match_ratio		number

Návraty

Tělo: AmlCheckResponse

Generování sestavy a skóre AML (tok dvou volání)

ID operace:: getAmlScore

Vygeneruje sestavu AML pro společnost a vrátí strukturované skóre (0–100) s rozpisem faktoru. Tok dvou volání na straně serveru; klient vidí jednu strukturovanou odpověď.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
orgnr	orgnr	True	string
purpose	purpose		string	DPA-formål pro AML-screening (eks. `kyc_onboarding`).

Návraty

Tělo: AmlScoreResponse

Porovnání finančních metrik napříč společnostmi

ID operace:: compareCompanies

Orchestrace na straně serveru: Načte finanční historii pro více společností paralelně a vrací je v tabulkovém srovnávacím formátu pro srovnávací testy.

Parametry

Name	Klíč	Vyžadováno	Typ
orgnrs	orgnrs	True	array of string
roky	years		integer
metriky	metrics		array of string

Návraty

Tělo: CompareResponse

Rizikové skóre 0–100 s úrovní a komponentami

ID operace:: getRiskScore

Strukturované skóre rizika (0–100) s pojmenovanou úrovní (nízká/ střední/ střední/ kritická) a rozpisem součástí pro finanční stav společnosti. Vrátí chybu blocked_enk pro výhradní vlastníky. Ne osobní ověření kredibility.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.

Návraty

Tělo: RiskScoreResponse

Stav FIV (společnost v obtížích)

ID operace:: checkForetakIVanskeligheter

Posuzuje, zda se společnost považuje za "foretak i vanskeligheter" (FIV / společnost v obtížích) podle norských pravidel NUES a-e na základě nejnovějších dostupných finančních výkazů.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.

Návraty

Tělo: FivResponse

Veřejné granty expozice napříč skupinami

ID operace:: getKonsernstotte

Stromová struktura veřejných grantů (granty NAV, podpora Covid-19, Innovasjon Norge, SkatteFUNN, EU-granty) přijaté společností a její skupinou. Používá se k důkladné péči o expozici veřejného sektoru.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.

Návraty

Tělo: KonsernStotteOversikt

Vyhledání souvisejících společností (sdílených osob nebo adres)

ID operace:: findRelatedCompanies

Najde společnosti sdílející držitele rolí nebo obchodní adresu se vstupní společností. Používá se pro hloubkovou kontrolu a mapování sítě.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.
Relační prostřednictvím	via		string	Způsob určení souvisejícího vztahu. "osoba" používá sdílené držitele rolí; Adresa používá sdílenou obchodní adresu.
Limit	limit		integer	Maximální počet položek, které se mají vrátit na této stránce Výchozí a maximální hodnota se liší podle koncového bodu.
Minimální překrytí	min_overlap		integer	Minimální početsdílenýchch

Návraty

Tělo: RelatedCompaniesResponse

Vyhledávací společnosti (název, NACE, obec)

ID operace:: searchCompanies

Jednotné vyhledávání napříč názvem společnosti, kódem NACE a obcemi. Vrátí stránkované výsledky se stabilním kurzorem pro další stránku.

Parametry

Name	Klíč	Typ	Description
Vyhledávání	q	string	Dotaz pro vyhledávání volného textu se shoduje s názvem společnosti nebo číslem organizace.
Filtr NACE	nace	string	Výsledky můžete filtrovat podle kódu oboru NACE (2 až 5 číslic, podporované shody předpony).
Municipality	kommune	string	Norský kód obce (4 číslice, např. 0301 pro Oslo) sloužící k geografickému filtrování výsledků.
Limit	limit	integer	Maximální počet položek, které se mají vrátit na této stránce Výchozí a maximální hodnota se liší podle koncového bodu.
Kurzor stránkování	cursor	string	Neprůzrný kurzor stránkování vrácený předchozím voláním Předejte ho doslovně a načtěte další stránku. Neanalybujte ani neupravujte.

Návraty

Tělo: CompanySearchResponse

Vyhledávání osob (akcionáři a držitelé rolí)

ID operace:: searchPersons

Vyhledejte osoby napříč držiteli rolí BRREG a rejstříkem akcionářů. Podporuje přibližné párování názvů s počátečním rozšířením a vyřazením prostředního názvu; volitelný filtr roku narození.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Vyhledávání	q	True	string	Dotaz pro vyhledávání volného textu se shoduje s názvem společnosti nebo číslem organizace.
Limit	limit		integer	Maximální počet položek, které se mají vrátit na této stránce Výchozí a maximální hodnota se liší podle koncového bodu.

Návraty

Name	Cesta	Typ
dotaz	query	string
Akcionáři	shareholders	array of PersonHit
shareholders_count	shareholders_count	integer
role_persons	role_persons	array of PersonHit
role_persons_count	role_persons_count	integer

Vyhledávání oznámení BRREG napříč společnostmi

ID operace:: searchAnnouncements

Vyhledávání křížového vyhledávání v oznámeních BRREG Filtrovat podle typu, rozsahu kalendářních dat, stavu Používá se pro monitorování portfolia a ad hoc vyhledávání.

Parametry

Name	Klíč	Typ	Description
Filtr typů	type	string	Vyfiltrujte typ položky (liší se podle koncového bodu; viz popis operace).
Datum od:	from	date	Začátek rozsahu dat ve formátu ISO (RRRR-MM-DD). Inclusive.
Datum do	to	date	Konec rozsahu dat ve formátu ISO (RRRR-MM-DD). Inkluzivní.
Číslo organizace	orgnr	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.
Vyhledávání	q	string	Dotaz pro vyhledávání volného textu se shoduje s názvem společnosti nebo číslem organizace.
Limit	limit	integer	Maximální počet položek, které se mají vrátit na této stránce Výchozí a maximální hodnota se liší podle koncového bodu.
Kurzor stránkování	cursor	string	Neprůzrný kurzor stránkování vrácený předchozím voláním Předejte ho doslovně a načtěte další stránku. Neanalybujte ani neupravujte.

Návraty

Tělo: AnnouncementsSearchResponse

Výpis společností v kódu oboru NACE

ID operace:: listCompaniesInNace

Vrátí společnosti registrované s daným kódem NACE (shoda předpony). Podporuje filtry měst a zaměstnanců; stránkované se stabilním kurzorem.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Kód NACE	code	True	string	PŘEDpona NACE-kode eller (eks. `47`, `47.11`, `47.110`).
Stavový filtr	status		string	Filtrování právního stavu (např. aktivní, under_liquidation, struck_off).
Municipality	kommune		string	Norský kód obce (4 číslice, např. 0301 pro Oslo) sloužící k geografickému filtrování výsledků.
Minimální počet zaměstnanců	min_ansatte		integer	Minimální počet zaměstnanců, které by společnost měla mít (včetně).
Maximální počet zaměstnanců	max_ansatte		integer	Maximální počet zaměstnanců, které by společnost měla mít (včetně).
Limit	limit		integer	Maximální počet položek, které se mají vrátit na této stránce Výchozí a maximální hodnota se liší podle koncového bodu.
Kurzor stránkování	cursor		string	Neprůzrný kurzor stránkování vrácený předchozím voláním Předejte ho doslovně a načtěte další stránku. Neanalybujte ani neupravujte.
Zahrnout součty	include_total		integer	Pokud je hodnota true, zahrne do odpovědi součty agregace skupin.

Návraty

Tělo: NaceCompaniesResponse

Získání finanční historie

ID operace:: getCompanyFinancials

Vrátí finanční historii (výnosy, provozní výsledek, vlastní kapitál, celková aktiva, zaměstnanci) po dobu až 10 let zpět pro norskou společnost.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.
Roky zpět	years		integer	Počet let finanční historie, které se mají vrátit (1–10).
Typ příkazu	regnskapstype		string	Typ finanční výkazu pro filtrování (např. selskap, konsern). Výchozí vrátí kanonický příkaz.
Přeskočit mezipaměť aktuálnosti	skip_freshness		integer	Pokud ano, obchází mezipaměť aktuálnosti a vynutí upstreamovou aktualizaci. Používejte střídmě.

Návraty

Tělo: FinancialHistoryResponse

Získání nedávných změn (alias ke koncovému bodu změn)

ID operace:: getRecentChanges

Alias dokumentace používaný katalogem nástrojů MCP (get_recent_changes). Přepošle do koncového bodu canonical /company/{orgnr}/changes.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.

Návraty

response: array of Announcement

Získání oznámení BRREG (alias pro změny koncového bodu)

ID operace:: getCompanyAnnouncements

Alias dokumentace používaný katalogem nástrojů MCP (get_company_announcements). Přepošle do koncového bodu canonical /company/{orgnr}/changes.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.

Návraty

response: array of Announcement

Získání oznámení BRREG a nedávných změn

ID operace:: getCompanyChanges

Vrátí oznámení BRREG (právní události) a nedávné změny (role, adresa, signál, podpis) v rámci nakonfigurovaného okna pro společnost. Používá se k monitorování a sledování změn.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.

Návraty

response: array of Announcement

Získání portfolia podílů pro osobu

ID operace:: getPersonCompanies

Vrátí všechny společnosti, ve které osoba uchovává podíly, s procentem vlastnictví a podrobnostmi třídy podílů identifikovanými stabilními owner_person_key.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Klíč osoby vlastníka	owner_person_key	True	string	Stabilní klíč identifikující osobního akcionáře vráceného koncovými body searchPersons nebo vlastnictví.

Návraty

Tělo: PersonProfile

Získání profilu osoby (orchestrace na straně klienta)

ID operace:: getPerson

Pomocník na straně klienta, který orchestruje funkce searchPersons + getPersonRoles + getPersonCompanies do jednoho zobrazení profilu. Tady je dokumentováno pro paritu s katalogem nástrojů MCP.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název	name	True	string	Celé nebo částečné jméno osoby. Přibližná shoda s počátečním rozšířením a vyřazením prostředního názvu se použije automaticky.
Rok narození	birth_year		integer	Čtyřmístný rok narození použitý jako další filtr hledání osob k nejednoznačnosti běžných jmen.

Návraty

Tělo: PersonProfile

Získání rolí společnosti (board, CEO, signatáři)

ID operace:: getCompanyRoles

Vrátí držitele rolí BRREG (předseda, člen rady, generální ředitel, signatář, moc advokáta) pro společnost. Volitelný filtr pro typ role a zahrnutí historických rolí.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.
Zahrnout historické	include_historic		integer	Pokud je pravda, zahrnuje kromě aktuálních držitelů role i historické (rezignované) role.
Typ role	role_type		string	Filtrujte kód norského typu role (např. styreleder, daglig_leder, signatur). Úplný seznam najdete v dokumentaci společnosti Firmaradar.

Návraty

Tělo: RolesResponse

Získání stromu vlastnictví (nahoru, dolů nebo obojí)

ID operace:: getCompanyOwnership

Vrátí strom vlastnictví společnosti. direction=down seznamy dceřiných společností; direction=up sleduje mateřské společnosti; direction=both vrátí úplnou skupinu. Volitelná hloubka (1–12) a include_persons pro osobní akcionáře.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	Číslo norské organizace (přesně 9 číslic) vydané brønnøysundregistrene.
Směr stromu	direction		string	Směr procházení stromem. "down" vrací dceřiné společnosti; "nahoru" vrátí rodiče; "oba" vrátí úplnou skupinu.
Hloubka stromu	depth		integer	Kolik úrovní stromu vlastnictví se má procházet. Celé číslo 1–12. Větší hloubka znamená pomalejší volání.
Zahrnout osoby	include_persons		integer	Pokud je pravda, zahrnuje osobní akcionáře ve stromu vlastnictví (jinak pouze právnické osoby).

Návraty

Tělo: OwnershipResponse

Získání úplné historie rolí pro osobu

ID operace:: getPersonRoles

Vrátí úplnou historii rolí (aktivní a historickou) pro osobu, která je identifikovaná stabilním role_person_id.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID osoby role	role_person_id	True	string	Stabilní ID identifikujícího vlastníka role vráceného koncovými body searchPersons nebo role

Návraty

Tělo: RolePersonProfile

Získání úplného firemního profilu

ID operace:: getCompany

Vrátí úplný profil společnosti pro číslo norské organizace (orgnr): stav registru, obor NACE, zaměstnanci, adresu, finanční historii, strom vlastnictví a klíčové role. Kombinuje BRREG, finanční data a proprietární rozšiřování.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Číslo organizace	orgnr	True	string	9-sifret organisasjonsnummer.
Fields	fields		string	Podmnožina komma-separert, eks. `group,owners,grants,changes,financial_metrics`.
Zahrnout vlastníky	owners		string	Pokud je hodnota true, zahrne do odpovědi informace o vlastnictví.
Zahrnout granty	grants		integer	Pokud je hodnota true, zahrne do odpovědi data veřejných grantů.
Zahrnout granty BRREG	brreg_grants		integer	Pokud je pravda, zahrne do odpovědi data o veřejných grantech BRREG. Přidá další upstreamové volání.
Finanční metriky	financial_metrics		integer	Čárkami oddělený seznam finančních metrik, které se mají zahrnout (výnosy, operating_result, vlastní kapitál atd.).

Návraty

Tělo: Company

Definice

Společnost

Name	Cesta	Typ	Description
orgnr	orgnr	string	9-sifret norsk organisasjonsnummer.
navn	navn	string
organisasjonsform	organisasjonsform	string	BRREG-organisasjonsform-kode (AS, ASA, ENK, ...).
konsernstruktur	konsernstruktur	object	Konsern-tre med morselskap + døtre.
eiere	eiere	array of Owner
tildalinger	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
souhrn	summary	string	LLM-vennlig kort oppsummering.

Owner

Name	Cesta	Typ	Description
navn	navn	string
orgnr	orgnr	string	Pro vlastníky firmy – eierens orgnr.
owner_person_key	owner_person_key	string	Pro personlige eiere — stabil nøkkel pro /person/shareholdings.
eierandel_prosent	eierandel_prosent	float
antall_aksjer	antall_aksjer	integer
typ	type	string

Roli

Name	Cesta	Typ	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

Name	Cesta	Typ
orgnr	orgnr	string
regnskapstype	regnskapstype	string
items	items	array of FinancialYear
freshness	freshness	object

FinancialYear

Name	Cesta	Typ
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

Oznámení

Name	Cesta	Typ
orgnr	orgnr	string
navn	navn	string
Dato	dato	date
kunngjoring_type	kunngjoring_type	string
kategorie	category	string
hendelse_type	hendelse_type	string
niva1_label	niva1_label	string

PersonHit

Name	Cesta	Typ	Description
název	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
příspěvky	poststed	string
antall_selskaper	antall_selskaper	integer

PersonProfile

Name	Cesta	Typ
owner_person_key	owner_person_key	string
název	name	string
birth_year	birth_year	string
příspěvky	poststed	string
Podíly	shareholdings	array of object
items	shareholdings	object
total_ownership_value_nok	total_ownership_value_nok	number

RolePersonProfile

Name	Cesta	Typ
role_person_id	role_person_id	string
název	name	string
birth_year	birth_year	string
roles	roles	array of Role

CompanyHit

Name	Cesta	Typ
orgnr	orgnr	string
navn	navn	string
organisasjonsform	organisasjonsform	string
naeringskode	naeringskode	string
kommune	kommune	string
stav	status	string
antall_ansatte	antall_ansatte	integer

CompanySearchResponse

Name	Cesta	Typ
items	items	array of CompanyHit
next_cursor	next_cursor	string
total_count	total_count	integer

CompareResponse

Name	Cesta	Typ	Description
orgnrs	orgnrs	array of string
roky	years	array of integer
společnosti	companies	array of object
orgnr	companies.orgnr	string
navn	companies.navn	string
financials_by_year	companies.financials_by_year	object
porovnání	comparison	object	{<metric>: {<orgnr>: [<value_per_year>]}}
computed_at	computed_at	date-time

OwnershipResponse

Name	Cesta	Typ
orgnr	orgnr	string
směr	direction	string
hloubka	depth	integer
majitelé	owners	array of Owner
Hospodářství	holdings	object

RoleResponse

Name	Cesta	Typ
orgnr	orgnr	string
roles	roles	array of Role
total_count	total_count	integer
uložená v mezipaměti	cached	boolean

SignalResponse

Name	Cesta	Typ
orgnr	orgnr	string
days_back	days_back	integer
kyc_signals	kyc_signals	object
tísňová	distress	object
interim_balance	interim_balance	object
agregace	aggregate	object

AmlHit

Name	Cesta	Typ
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	Cesta	Typ
query_name	query_name	string
query_birth_year	query_birth_year	integer
hity	hits	array of AmlHit
hit_count	hit_count	integer

AmlScoreResponse

Name	Cesta	Typ
orgnr	orgnr	string
rapport_id	rapport_id	string
skóre	score	number
úroveň	level	string
Faktory	factors	array of object
items	factors	object

NaceCompaniesResponse

Name	Cesta	Typ
nace_code	nace_code	string
items	items	array of CompanyHit
next_cursor	next_cursor	string
total_count	total_count	integer

RelatedCompaniesResponse

Name	Cesta	Typ
orgnr	orgnr	string
Via	via	string
příbuzný	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

Name	Cesta	Typ
items	items	array of Announcement
next_cursor	next_cursor	string
filtr	filter	object

RiskScoreResponse

Name	Cesta	Typ
orgnr	orgnr	string
skóre	score	integer
úroveň	level	string
components	components	array of object
items	components	object
Zdrojů	sources	array of string

FivResponse

Name	Cesta	Typ	Description
orgnr	orgnr	string
stav	status	string	NUES a-e-status, eks. `not_distressed`, . `distressed`
skóre	score	number
rules_fired	rules_fired	array of object
items	rules_fired	object
spolehlivost	confidence	number
as_of	as_of	date-time

KonsernStotteOversikt

Name	Cesta	Typ	Description
orgnr	orgnr	string
selskap_stotte	selskap_stotte	object	Direkte støtte til orgnr (post-#134-skjema). Přímé udělení orgnru (obrazec post-#134)
konsern_aggregat	konsern_aggregat	object	Aggregert konsern-støtte oppover i eier-tre. Podpora agregované úrovně skupin
tildalinger	tildelinger	array of object
items	tildelinger	object

FinancialHistoryResponse

Name	Cesta	Typ
orgnr	orgnr	string
regnskapstype	regnskapstype	string
items	items	array of FinancialYear
freshness	freshness	object