Firmaradar (Onafhankelijke Publisher) (preview)
Verrijkingsplatform voor Noorse bedrijfsinformatie. Fuses data from BRREG, Skatteetaten, foreign PEP and sanctions registers, public-grant registries and noodsignalen, with proprietary enrichment on top (risk scoring, fuzzy person matching, group analytics, audit-grade compliance). Gebouwd voor KYC-, AML-, krediet-, eigendoms- en risicowerkstromen.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Naam | Ondersteuning voor Firmaradar |
| URL | https://firmaradar.no/kontakt |
| E-mailen | support@firmaradar.no |
| Connectormetagegevens | |
|---|---|
| Uitgever | Tiwas |
| Website | https://firmaradar.no |
| Privacybeleid | https://firmaradar.no/personvern |
| Categorieën | Gegevens; Business Intelligence |
Firmaradar (Onafhankelijk Publisher)
Firmaradar is een verrijkingsplatform voor Noorse bedrijfsinformatie. Het fuseert gegevens uit meerdere gezaghebbende bronnen: het Noorse bedrijfsregister (Brønnøysundregistrene), de Noorse belastingdienst (Skatteetaten) en buitenlandse PEP- en sanctieregisters , en voegt eigendomsverrijking toe: noodclassificatie, transparante risicoscore, fuzzy person-matching, groepsstructuuranalyse en nalevingspijplijnen op auditniveau. Deze connector bevat 21 bewerkingen die u in een stroom kunt neerzetten om klanten, leveranciers, partners en tegenhangers te verrijken met gestructureerde Noorse bedrijfsinformatie.
Publisher: Lars Kvanum
Stackeigenaar: Firmaradar AS (Noorwegen).
Prerequisites
- Een actief Firmaradar-account bij https://firmaradar.no.
- Een persoonlijke API-sleutel die is uitgegeven via Min side → API-nøkler (https://firmaradar.no/min-side/api-keys). De sleutel wordt verzonden als de
X-API-KeyHTTP-header voor elke aanvraag. - Een actief abonnement voor de bewerkingen die u wilt gebruiken. Voor sommige bewerkingen is een gegevensverwerkingsovereenkomst (DPA) vereist die is ondertekend in uw Firmaradar-account, met name AML- en PEP-screening.
De gratis laag omvat een groot deel van bedrijfsprofiel, eigendom, rollen, financiële geschiedenis en aankondigingsbewerkingen. Voor bewerkingen op de nalevingslaag (AML, scoren op controleniveau) is een betaald plan en expliciete DPA-acceptatie vereist.
Ondersteunde bewerkingen
De connector bevat 21 productiebewerkingen in 6 functionele gebieden. Veel bewerkingen combineren verschillende upstream-bronnen achter één aanroep.
Bedrijf
Zoek een volledig bedrijfsprofiel op op organisatienummer, breid de eigendomsstructuur en bord- of ondertekenaarsrollen uit, haal de financiële geschiedenis van meerdere jaren op, volg recente registerwijzigingen, doorzoek het bedrijfsalal en vergelijk twee bedrijven naast elkaar.
Persoon
Zoek naar een persoon, los de rollen op die een persoon in verschillende bedrijven heeft en vermeld de deelnemingen van een persoon.
Risico
Haal risicosignalen op voor een bedrijf, doorzoek de registeraankondigingsfeed, haal een transparante risicoscore (0-100) op met een uitsplitsing van onderdelen en voer een wettelijke "foretak i vanskeligheter" (bedrijf in moeilijkheden) noodbeoordeling uit.
Industrie
Vermeld bedrijven in een NACE-branchecode en zoek bedrijven die zijn gerelateerd aan een bepaald bedrijf via eigendom of rollen.
AML
Scherm een persoon of bedrijf op basis van AML- en PEP-lijsten en haal een gecombineerde AML-score op. Deze bewerkingen worden afgesloten achter een ondertekende DPA en worden bewaard in een auditlogboek.
Groepsondersteuning
Haal een overzicht op van openbare groepsondersteuning en verleent blootstelling (Innovasjon Norge / SkatteFUNN) voor een bedrijf.
Daarnaast worden er drie documentatiealiassen weergegeven in de specificatie om een een-op-een-toewijzing te geven met de Firmaradar MCP-toolcatalogus; deze doorsturen naar dezelfde back-end als de canonieke bewerkingen hierboven.
Referenties verkrijgen
- Meld u aan https://firmaradar.no met een geverifieerd Firmaradar-account.
- Open Min-side → API-nøkler (Mijn account → API-sleutels).
- Klik op Generer ny API-nøkkel (Nieuwe sleutel genereren) en kopieer de sleutel. De volledige sleutel wordt slechts eenmaal weergegeven: sla deze op in een geheimenbeheerder of in uw verbindingsinstellingen.
- Wanneer u een stroom maakt die gebruikmaakt van deze connector, plakt u de sleutel in het verbindingsveld van de Firmaradar-API-sleutel .
U kunt de sleutel op elk gewenst moment intrekken of draaien vanaf dezelfde pagina.
Getting Started
- Maak een verbinding en plak uw Firmaradar-API-sleutel in het sleutelveld van de Firmaradar-API .
- Voeg een Firmaradar-actie toe aan uw stroom, bijvoorbeeld Bedrijf ophalen met een organisatienummer zoals
923609016(Equinor ASA). - Gebruik de gestructureerde uitvoer in downstreamstappen: post een risicowaarschuwing naar Teams, schrijf een KYC-record naar Dataverse of verrijk een CRM-lead.
Bekende problemen en beperkingen
- Noorse antwoorden. Veldlabels en door mensen leesbare tekenreeksen in antwoorden worden geschreven in het Noors (bokmål), waarin de bronregisters worden weergegeven. Engelse samenvattingen zijn opgenomen waar praktisch.
- Frequentielimieten. Accounts in de gratis laag zijn beperkt tot 60 aanvragen per minuut. AML-bewerkingen hebben een strengere limiet van 50 aanvragen per 30 minuten, ongeacht het abonnement.
- Auditlogboekregistratie. Aanroepen naar AML- en marketplace-risicobewerkingen worden gedurende 60 maanden in een auditlogboek bewaard, zoals vereist door de Noorse KYC-regelgeving. De
X-FR-PurposeenX-FR-DPA-Confirmedheaders moeten worden ingesteld voor AML-aanroepen; ontbrekende headers retourneren HTTP 403. - Nalevingspoorten. De
getRiskScorebewerking kan HTTP 403 retourneren totdaterror_code=marketplace_hiddenhet account de relevante nalevingspoort doorgeeft. De specificatie markeert deze bewerking met dex-firmaradar-compliance-gateextensie, zodat clients deze dynamisch kunnen verbergen of uitschakelen. - Alleen 9-cijferige organisatienummers. Alle
orgnrpadparameters moeten exact 9 cijfers zijn (Noorse notatie voor organisatienummers). - Ondoorzichtige pagineringscursors. De
next_cursorwaarde die wordt geretourneerd door gepagineerde bewerkingen, moet worden doorgestuurd naar de exacte bewoordingen. U kunt deze waarde niet parseren of wijzigen.
Veelgestelde vragen
Moet ik een Noors bedrijf zijn om deze connector te kunnen gebruiken?
No. Niet-Noorse banken, KYC-leveranciers, AML-platformen en M&A-adviseurs kunnen Firmaradar aanroepen als hun canonieke Noorse back-end en het resultaat samenvoegen tot een bredere nalevingsweergave met meerdere jurisdicties.
Is dit slechts een wrapper rond het openbare bedrijfsregister?
No. Alleen openbare registergegevens beantwoorden zelden een echte zakelijke vraag. Firmaradar verzoent meerdere bronnen en lagen eigen signalen ( personen die overeenkomen, risicomodellering, groepsanalyses en compliance-loodgieters ) zodat één aanroep een beslissingsklare weergave retourneert.
Implementatie-instructies
Na certificering hoeven eindgebruikers de connector niet handmatig te installeren. Deze wordt beschikbaar in de standaard-connectorcatalogus in Power Automate, Power Apps en Logic Apps. Ontwikkelaars die willen implementeren voordat certificering kan worden uitgevoerd:
paconn create --api-prop apiProperties.json \
--api-def apiDefinition.swagger.json \
--icon icon.png
Zie https://learn.microsoft.com/en-us/connectors/custom-connectors/paconn-cli de volledige CLI-naslaginformatie.
Support
- Problemen met de definitie van de connector (Swagger, pictogram, metagegevens): dien een probleem of pull-aanvraag in tegen https://github.com/microsoft/PowerPlatformConnectors.
- Problemen met de Firmaradar-API (gegevens, frequentielimieten, accounttoegang): contactpersoon support@firmaradar.no.
- Algemene Firmaradar-documentatie:https://firmaradar.no/api-dokumentasjon.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| Standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typ | Description | Required |
|---|---|---|---|
| API-sleutel | beveiligde string | De api_key voor deze API | True |
Acties
| Aandelenportefeuille voor een persoon ophalen |
Retourneert alle bedrijven waarin een persoon aandelen bezit, met eigendomspercentage en details van aandelenklasse, geïdentificeerd door stabiele owner_person_key. |
| AML- en PEP-screening (vereist DPA-headers) |
Hiermee wordt een persoon tegen sancties en PEP-lijsten gescreend. Vereist ondertekende DPA en X-FR-Purpose plus X-FR-DPA-Confirmed headers. Alle aanroepen worden gedurende 60 maanden geregistreerd volgens de Noorse KYC-voorschriften. |
| AML-rapport en -score genereren (stroom met twee aanroepen) |
Genereert een AML-rapport voor een bedrijf en retourneert een gestructureerde score (0-100) met factor-uitsplitsing. Stroom met twee aanroepen aan de serverzijde; client ziet één gestructureerd antwoord. |
| Bedrijfsrollen ophalen (raad, CEO, ondertekenaars) |
Retourneert BRREG-rolhouders (voorzitter, bestuurslid, CEO, ondertekenaar, volmacht) voor een bedrijf. Optioneel filter op roltype en opname van historische rollen. |
| Bedrijven vermelden in een NACE-branchecode |
Retourneert bedrijven die zijn geregistreerd met een bepaalde NACE-branchecode (voorvoegselovereenkomst). Ondersteunt gemeente- en werknemerfilters; gepagineerd met een stabiele cursor. |
| Blootstelling aan openbare subsidies in de hele groep |
Structuur van openbare subsidies (NAV-subsidies, Covid-19-steun, Innovasjon Norge, SkatteFUNN, EU-subsidies) ontvangen door een bedrijf en haar groep. Gebruikt voor due-diligence over blootstelling aan de publieke sector. |
| BRREG-aankondigingen en recente wijzigingen ophalen |
Retourneert BRREG-aankondigingen (juridische gebeurtenissen) en recente wijzigingen (rol, adres, signaal, handtekening) in het geconfigureerde venster voor een bedrijf. Wordt gebruikt voor het bewaken en bijhouden van wijzigingen. |
| BRREG-aankondigingen ophalen (alias naar eindpunt van wijzigingen) |
Documentatiealias die wordt gebruikt door de MCP-hulpprogrammacatalogus (get_company_announcements). Wordt doorgestuurd naar het canonieke /company/{orgnr}/changes-eindpunt. |
| Eigendomsstructuur ophalen (omhoog, omlaag of beide) |
Retourneert de eigendomsstructuur voor een bedrijf.
|
| Financiële geschiedenis ophalen |
Geeft als resultaat de financiële geschiedenis (omzet, bedrijfsresultaat, aandelen, totale activa, werknemers) tot 10 jaar terug voor een Noors bedrijf. |
| Financiële metrische gegevens vergelijken tussen bedrijven |
Indeling aan de serverzijde: haalt financiële geschiedenis voor meerdere bedrijven parallel op en retourneert deze in een tabelvriendelijke vergelijkingsindeling voor benchmarking. |
| FIV-status (bedrijf in moeilijkheden) |
Beoordeelt of een bedrijf in moeilijkheden in aanmerking komt als 'foretak i vanskeligheter' (FIV/bedrijf in moeilijkheden) volgens de Noorse NUES a-e-regels, op basis van de meest recente beschikbare financiële overzichten. |
| Geaggregeerde risicosignalen |
Voegt signalen van drie bronnen samen: KYC-aankondigingssignalen (faillissement, fusie, divisie), noodclassificatie (FIV) en tussentijdse balanssignalen. |
| Personen zoeken (aandeelhouders en rolhouders) |
Zoek naar personen in brreg-rolhouders en aandeelhoudersregister. Ondersteunt fuzzy naam die overeenkomt met initial-expansion en middle-name drop; optioneel filter voor geboortejaar. |
| Persoonsprofiel ophalen (indeling aan de clientzijde) |
Helper aan de clientzijde waarmee searchPersons + getPersonRoles + getPersonCompanies in één profielweergave worden ingedeeld. Hier beschreven voor pariteit met de MCP-hulpprogrammacatalogus. |
| Recente wijzigingen ophalen (alias naar eindpunt van wijzigingen) |
Documentatiealias die wordt gebruikt door de MCP-hulpprogrammacatalogus (get_recent_changes). Wordt doorgestuurd naar het canonieke /company/{orgnr}/changes-eindpunt. |
| Risicoscore 0-100 met niveau en onderdelen |
Gestructureerde risicoscore (0-100) met benoemd niveau (laag/gemiddeld/hoog/kritiek) en uitsplitsing van onderdelen voor de financiële gezondheid van het bedrijf. Retourneert blocked_enk fout voor een eenmanszaak. Geen persoonlijke kredietcontrole. |
| Verwante bedrijven zoeken (gedeelde personen of adressen) |
Hiermee vindt u bedrijven die rolhouders of bedrijfsadres delen met het invoerbedrijf. Wordt gebruikt voor due-diligence en netwerktoewijzing. |
| Volledig bedrijfsprofiel ophalen |
Retourneert het volledige bedrijfsprofiel voor een Noors organisatienummer (orgnr): registerstatus, NACE-branche, werknemers, adres, financiële geschiedenis, eigendomsstructuur en belangrijke rollen. Combineert BRREG, financiële gegevens en eigen verrijking. |
| Volledige rolgeschiedenis voor een persoon ophalen |
Retourneert de volledige rolgeschiedenis (actief en historisch) voor een rol-persoon die is geïdentificeerd door hun stabiele role_person_id. |
| Zoekbedrijven (naam, NACE, gemeente) |
Geïntegreerde zoekopdrachten in bedrijfsnaam, CODE van DE NACE-branche en gemeente. Retourneert gepagineerde resultaten met een stabiele cursor voor de volgende pagina. |
| Zoeken in BRREG-aankondigingen tussen bedrijven |
Cross-orgnr search in BRREG aankondigingen. Filteren op type, datumbereik, status. Wordt gebruikt voor portfoliobewaking en ad-hoc lookups. |
Aandelenportefeuille voor een persoon ophalen
Retourneert alle bedrijven waarin een persoon aandelen bezit, met eigendomspercentage en details van aandelenklasse, geïdentificeerd door stabiele owner_person_key.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Eigenaar-persoonssleutel
|
owner_person_key | True | string |
Stabiele sleutel die een persoonlijke aandeelhouder identificeert, geretourneerd door searchPersons of eigendomseindpunten. |
Retouren
- Body
- PersonProfile
AML- en PEP-screening (vereist DPA-headers)
Hiermee wordt een persoon tegen sancties en PEP-lijsten gescreend. Vereist ondertekende DPA en X-FR-Purpose plus X-FR-DPA-Confirmed headers. Alle aanroepen worden gedurende 60 maanden geregistreerd volgens de Noorse KYC-voorschriften.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Doeltag
|
X-FR-Purpose | True | string |
Doeltag voor de AML-zoekactie. Een van: kyc_onboarding, kyc_review, risk_monitoring, handmatig. Vereist voor AML-aanroepen en persistent in het auditlogboek. |
|
DPA-bevestiging
|
X-FR-DPA-Confirmed | True | string |
Bevestiging dat u een ondertekende gegevensverwerkingsovereenkomst hebt die betrekking heeft op deze AML-zoekopdracht. Vereist voor AML-aanroepen. |
|
naam
|
name | True | string | |
|
birth_year
|
birth_year | integer | ||
|
Kategori
|
kategori | string | ||
|
min_match_ratio
|
min_match_ratio | number |
Retouren
- Body
- AmlCheckResponse
AML-rapport en -score genereren (stroom met twee aanroepen)
Genereert een AML-rapport voor een bedrijf en retourneert een gestructureerde score (0-100) met factor-uitsplitsing. Stroom met twee aanroepen aan de serverzijde; client ziet één gestructureerd antwoord.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
orgnr
|
orgnr | True | string | |
|
purpose
|
purpose | string |
DPA-formål voor AML-screening (eks). |
Retouren
- Body
- AmlScoreResponse
Bedrijfsrollen ophalen (raad, CEO, ondertekenaars)
Retourneert BRREG-rolhouders (voorzitter, bestuurslid, CEO, ondertekenaar, volmacht) voor een bedrijf. Optioneel filter op roltype en opname van historische rollen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
|
Inclusief historisch
|
include_historic | integer |
Indien waar, worden historische (ontslagen) rolhouders naast de huidige rolhouders opgenomen. |
|
|
Roltype
|
role_type | string |
Filter op Noorse roltypecode (bijvoorbeeld styreleder, daglig_leder, signatur). Zie de Documenten van Firmaradar voor de volledige lijst. |
Retouren
- Body
- RolesResponse
Bedrijven vermelden in een NACE-branchecode
Retourneert bedrijven die zijn geregistreerd met een bepaalde NACE-branchecode (voorvoegselovereenkomst). Ondersteunt gemeente- en werknemerfilters; gepagineerd met een stabiele cursor.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
NACE-code
|
code | True | string |
NACE-kode ellervoorvoegsel (eks. |
|
Statusfilter
|
status | string |
Filteren op juridische status (bijvoorbeeld actief, under_liquidation, struck_off). |
|
|
Gemeente
|
kommune | string |
Noorse gemeentecode (4 cijfers, bijvoorbeeld 0301 voor Oslo) gebruikt om resultaten geografisch te filteren. |
|
|
Minimum aantal werknemers
|
min_ansatte | integer |
Minimaal aantal werknemers dat het bedrijf moet hebben (inclusief). |
|
|
Maximum aantal werknemers
|
max_ansatte | integer |
Maximum aantal werknemers dat het bedrijf moet hebben (inclusief). |
|
|
Limit
|
limit | integer |
Maximum aantal items dat moet worden geretourneerd op deze pagina. Standaard en maximum variëren per eindpunt. |
|
|
Cursor voor paginering
|
cursor | string |
Ondoorzichtige pagineringscursor die wordt geretourneerd door een vorige aanroep. Geef de exacte bewoordingen door om de volgende pagina op te halen. Parseren of wijzigen is niet mogelijk. |
|
|
Totalen opnemen
|
include_total | integer |
Indien waar, worden totalen voor groepsaggregaties in het antwoord opgenomen. |
Retouren
Blootstelling aan openbare subsidies in de hele groep
Structuur van openbare subsidies (NAV-subsidies, Covid-19-steun, Innovasjon Norge, SkatteFUNN, EU-subsidies) ontvangen door een bedrijf en haar groep. Gebruikt voor due-diligence over blootstelling aan de publieke sector.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
Retouren
BRREG-aankondigingen en recente wijzigingen ophalen
Retourneert BRREG-aankondigingen (juridische gebeurtenissen) en recente wijzigingen (rol, adres, signaal, handtekening) in het geconfigureerde venster voor een bedrijf. Wordt gebruikt voor het bewaken en bijhouden van wijzigingen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
Retouren
- antwoord
- array of Announcement
BRREG-aankondigingen ophalen (alias naar eindpunt van wijzigingen)
Documentatiealias die wordt gebruikt door de MCP-hulpprogrammacatalogus (get_company_announcements). Wordt doorgestuurd naar het canonieke /company/{orgnr}/changes-eindpunt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
Retouren
- antwoord
- array of Announcement
Eigendomsstructuur ophalen (omhoog, omlaag of beide)
Retourneert de eigendomsstructuur voor een bedrijf.
direction=down een lijst van dochterondernemingen; direction=up traceert moederbedrijven; direction=both retourneert de volledige groep. Optionele diepte (1-12) en include_persons voor persoonlijke aandeelhouders.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
|
Structuurrichting
|
direction | string |
Doorkruising van boom. "down" retourneert dochterondernemingen; 'omhoog' retourneert ouders; 'beide' retourneert de volledige groep. |
|
|
Structuurdiepte
|
depth | integer |
Hoeveel niveaus van de eigendomsstructuur moeten worden doorlopen. Geheel getal 1-12. Hogere diepte betekent tragere aanroep. |
|
|
Inclusief personen
|
include_persons | integer |
Indien waar, omvat u persoonlijke aandeelhouders in de eigendomsstructuur (anders alleen juridische entiteiten). |
Retouren
- Body
- OwnershipResponse
Financiële geschiedenis ophalen
Geeft als resultaat de financiële geschiedenis (omzet, bedrijfsresultaat, aandelen, totale activa, werknemers) tot 10 jaar terug voor een Noors bedrijf.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
|
Jaren terug
|
years | integer |
Aantal jaren financiële geschiedenis dat moet worden geretourneerd (1-10). |
|
|
Verklaringstype
|
regnskapstype | string |
Type financiële overzicht waarop moet worden gefilterd (bijvoorbeeld selskap, konsern). Standaard retourneert de canonieke instructie. |
|
|
Versheidscache overslaan
|
skip_freshness | integer |
Indien waar, slaat u de versheidscache over en dwingt u een upstream-vernieuwing af. Gebruik spaarzaam. |
Retouren
Financiële metrische gegevens vergelijken tussen bedrijven
Indeling aan de serverzijde: haalt financiële geschiedenis voor meerdere bedrijven parallel op en retourneert deze in een tabelvriendelijke vergelijkingsindeling voor benchmarking.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
orgnrs
|
orgnrs | True | array of string | |
|
jaren
|
years | integer | ||
|
metrics
|
metrics | array of string |
Retouren
- Body
- CompareResponse
FIV-status (bedrijf in moeilijkheden)
Beoordeelt of een bedrijf in moeilijkheden in aanmerking komt als 'foretak i vanskeligheter' (FIV/bedrijf in moeilijkheden) volgens de Noorse NUES a-e-regels, op basis van de meest recente beschikbare financiële overzichten.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
Retouren
- Body
- FivResponse
Geaggregeerde risicosignalen
Voegt signalen van drie bronnen samen: KYC-aankondigingssignalen (faillissement, fusie, divisie), noodclassificatie (FIV) en tussentijdse balanssignalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
|
Sinds
|
since | date |
ISO-dato (JJJJ-MM-DD). Overstyrer standaard 730 dager bakover. Cappes til 1825 dager. |
Retouren
- Body
- SignalsResponse
Personen zoeken (aandeelhouders en rolhouders)
Zoek naar personen in brreg-rolhouders en aandeelhoudersregister. Ondersteunt fuzzy naam die overeenkomt met initial-expansion en middle-name drop; optioneel filter voor geboortejaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Zoekquery
|
q | True | string |
Zoekquery voor vrije tekst die overeenkomt met de bedrijfsnaam of het organisatienummer. |
|
Limit
|
limit | integer |
Maximum aantal items dat moet worden geretourneerd op deze pagina. Standaard en maximum variëren per eindpunt. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
query
|
query | string | |
|
Aandeelhouders
|
shareholders | array of PersonHit | |
|
shareholders_count
|
shareholders_count | integer | |
|
role_persons
|
role_persons | array of PersonHit | |
|
role_persons_count
|
role_persons_count | integer |
Persoonsprofiel ophalen (indeling aan de clientzijde)
Helper aan de clientzijde waarmee searchPersons + getPersonRoles + getPersonCompanies in één profielweergave worden ingedeeld. Hier beschreven voor pariteit met de MCP-hulpprogrammacatalogus.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Naam
|
name | True | string |
Volledige of gedeeltelijke naam van persoon. Fuzzy match met initial-expansion en middle-name drop wordt automatisch toegepast. |
|
Geboortejaar
|
birth_year | integer |
Geboortejaar met vier cijfers dat wordt gebruikt als extra filter in persoonszoekopdrachten om algemene namen te ontdubbelen. |
Retouren
- Body
- PersonProfile
Recente wijzigingen ophalen (alias naar eindpunt van wijzigingen)
Documentatiealias die wordt gebruikt door de MCP-hulpprogrammacatalogus (get_recent_changes). Wordt doorgestuurd naar het canonieke /company/{orgnr}/changes-eindpunt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
Retouren
- antwoord
- array of Announcement
Risicoscore 0-100 met niveau en onderdelen
Gestructureerde risicoscore (0-100) met benoemd niveau (laag/gemiddeld/hoog/kritiek) en uitsplitsing van onderdelen voor de financiële gezondheid van het bedrijf. Retourneert blocked_enk fout voor een eenmanszaak. Geen persoonlijke kredietcontrole.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
Retouren
- Body
- RiskScoreResponse
Verwante bedrijven zoeken (gedeelde personen of adressen)
Hiermee vindt u bedrijven die rolhouders of bedrijfsadres delen met het invoerbedrijf. Wordt gebruikt voor due-diligence en netwerktoewijzing.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
|
Relatie via
|
via | string |
Hoe verwantschap wordt bepaald. "persoon" gebruikt gedeelde rolhouders; 'adres' maakt gebruik van een gedeeld bedrijfsadres. |
|
|
Limit
|
limit | integer |
Maximum aantal items dat moet worden geretourneerd op deze pagina. Standaard en maximum variëren per eindpunt. |
|
|
Minimale overlapping
|
min_overlap | integer |
Minimaal aantal gedeelde personen of adressen dat is vereist voor een gerelateerde bedrijfsovereenkomst. |
Retouren
Volledig bedrijfsprofiel ophalen
Retourneert het volledige bedrijfsprofiel voor een Noors organisatienummer (orgnr): registerstatus, NACE-branche, werknemers, adres, financiële geschiedenis, eigendomsstructuur en belangrijke rollen. Combineert BRREG, financiële gegevens en eigen verrijking.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Nummer van organisatie
|
orgnr | True | string |
9-sifret organisasjonsnummer. |
|
Fields
|
fields | string |
Komma-separert subset, eks.
|
|
|
Eigenaren opnemen
|
owners | string |
Indien waar, bevat u eigendomsgegevens in het antwoord. |
|
|
Inclusief subsidies
|
grants | integer |
Indien waar, worden gegevens in het antwoord openbaar verleend. |
|
|
Brreg-subsidies opnemen
|
brreg_grants | integer |
Indien waar, bevat BRREG openbare gegevens in het antwoord. Voegt één extra upstream-aanroep toe. |
|
|
Financiële metrische gegevens
|
financial_metrics | integer |
Door komma's gescheiden lijst met financiële metrische gegevens die moeten worden opgenomen (omzet, operating_result, aandelen, enzovoort). |
Retouren
- Body
- Company
Volledige rolgeschiedenis voor een persoon ophalen
Retourneert de volledige rolgeschiedenis (actief en historisch) voor een rol-persoon die is geïdentificeerd door hun stabiele role_person_id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Id van rolpersoon
|
role_person_id | True | string |
Stabiele id die een rolhouder identificeert, geretourneerd door searchPersons of rolleneindpunten. |
Retouren
- Body
- RolePersonProfile
Zoekbedrijven (naam, NACE, gemeente)
Geïntegreerde zoekopdrachten in bedrijfsnaam, CODE van DE NACE-branche en gemeente. Retourneert gepagineerde resultaten met een stabiele cursor voor de volgende pagina.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Zoekquery
|
q | string |
Zoekquery voor vrije tekst die overeenkomt met de bedrijfsnaam of het organisatienummer. |
|
|
NACE-filter
|
nace | string |
Filter resultaten op code uit de NACE-branche (2-5 cijfers, ondersteunde voorvoegselovereenkomst). |
|
|
Gemeente
|
kommune | string |
Noorse gemeentecode (4 cijfers, bijvoorbeeld 0301 voor Oslo) gebruikt om resultaten geografisch te filteren. |
|
|
Limit
|
limit | integer |
Maximum aantal items dat moet worden geretourneerd op deze pagina. Standaard en maximum variëren per eindpunt. |
|
|
Cursor voor paginering
|
cursor | string |
Ondoorzichtige pagineringscursor die wordt geretourneerd door een vorige aanroep. Geef de exacte bewoordingen door om de volgende pagina op te halen. Parseren of wijzigen is niet mogelijk. |
Retouren
Zoeken in BRREG-aankondigingen tussen bedrijven
Cross-orgnr search in BRREG aankondigingen. Filteren op type, datumbereik, status. Wordt gebruikt voor portfoliobewaking en ad-hoc lookups.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Typefilter
|
type | string |
Filter op het type item (varieert per eindpunt; zie de beschrijving van de bewerking). |
|
|
Datum vanaf
|
from | date |
Begin van het datumbereik in ISO-indeling (JJJJ-MM-DD). Inclusive. |
|
|
Datum tot
|
to | date |
Einde van het datumbereik in ISO-indeling (JJJJ-MM-DD). Inclusive. |
|
|
Nummer van organisatie
|
orgnr | string |
Noors organisatienummer (precies 9 cijfers) uitgegeven door Brønnøysundregistrene. |
|
|
Zoekquery
|
q | string |
Zoekquery voor vrije tekst die overeenkomt met de bedrijfsnaam of het organisatienummer. |
|
|
Limit
|
limit | integer |
Maximum aantal items dat moet worden geretourneerd op deze pagina. Standaard en maximum variëren per eindpunt. |
|
|
Cursor voor paginering
|
cursor | string |
Ondoorzichtige pagineringscursor die wordt geretourneerd door een vorige aanroep. Geef de exacte bewoordingen door om de volgende pagina op te halen. Parseren of wijzigen is niet mogelijk. |
Retouren
Definities
Bedrijf
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string |
9-sifret norsk organisasjonsnummer. |
|
navigatie
|
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 | |
|
Onderdelen
|
tildelinger | object | |
|
brreg_tildelinger
|
brreg_tildelinger | object | |
|
endringer
|
endringer | array of Announcement | |
|
financial_metrics
|
financial_metrics | FinancialMetrics | |
|
foretaksklassifisering
|
foretaksklassifisering | object | |
|
samenvatting
|
summary | string |
LLM-vennlig kort oppsummering. |
Owner
| Name | Pad | Type | Description |
|---|---|---|---|
|
navigatie
|
navn | string | |
|
orgnr
|
orgnr | string |
Voor bedrijfseigenaren — eierens orgnr. |
|
owner_person_key
|
owner_person_key | string |
Voor personlige eiere — stabil nøkkel voor /person/shareholdings. |
|
eierandel_prosent
|
eierandel_prosent | float | |
|
antall_aksjer
|
antall_aksjer | integer | |
|
type
|
type | string |
Rol
| Name | Pad | Type | Description |
|---|---|---|---|
|
rolle_type
|
rolle_type | string |
BRREG-rolle-beskrivelse (Styreleder, Daglig leder, ...). |
|
navigatie
|
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 | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
regnskapstype
|
regnskapstype | string | |
|
Onderdelen
|
items | array of FinancialYear | |
|
freshness
|
freshness | object |
Financieel jaar
| Name | Pad | Type | 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 |
Aankondiging
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
navigatie
|
navn | string | |
|
Dato
|
dato | date | |
|
kunngjoring_type
|
kunngjoring_type | string | |
|
Categorie
|
category | string | |
|
hendelse_type
|
hendelse_type | string | |
|
niva1_label
|
niva1_label | string |
PersonHit
| Name | Pad | Type | Description |
|---|---|---|---|
|
naam
|
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 | |
|
poststed
|
poststed | string | |
|
antall_selskaper
|
antall_selskaper | integer |
PersonProfile
| Name | Pad | Type | Description |
|---|---|---|---|
|
owner_person_key
|
owner_person_key | string | |
|
naam
|
name | string | |
|
birth_year
|
birth_year | string | |
|
poststed
|
poststed | string | |
|
Deelnemingen
|
shareholdings | array of object | |
|
Onderdelen
|
shareholdings | object | |
|
total_ownership_value_nok
|
total_ownership_value_nok | number |
RolePersonProfile
| Name | Pad | Type | Description |
|---|---|---|---|
|
role_person_id
|
role_person_id | string | |
|
naam
|
name | string | |
|
birth_year
|
birth_year | string | |
|
roles
|
roles | array of Role |
CompanyHit
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
navigatie
|
navn | string | |
|
organisasjonsform
|
organisasjonsform | string | |
|
naeringskode
|
naeringskode | string | |
|
kommune
|
kommune | string | |
|
status
|
status | string | |
|
antall_ansatte
|
antall_ansatte | integer |
CompanySearchResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
Onderdelen
|
items | array of CompanyHit | |
|
next_cursor
|
next_cursor | string | |
|
total_count
|
total_count | integer |
CompareResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnrs
|
orgnrs | array of string | |
|
jaren
|
years | array of integer | |
|
Bedrijven
|
companies | array of object | |
|
orgnr
|
companies.orgnr | string | |
|
navigatie
|
companies.navn | string | |
|
financials_by_year
|
companies.financials_by_year | object | |
|
vergelijking
|
comparison | object |
{metric>: {<<orgnr>: [<value_per_year>]}} |
|
computed_at
|
computed_at | date-time |
OwnershipResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
richting
|
direction | string | |
|
diepte
|
depth | integer | |
|
Eigenaren
|
owners | array of Owner | |
|
Bedrijven
|
holdings | object |
RolesResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
roles
|
roles | array of Role | |
|
total_count
|
total_count | integer | |
|
in cache opgeslagen
|
cached | boolean |
SignalsResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
days_back
|
days_back | integer | |
|
kyc_signals
|
kyc_signals | object | |
|
Nood
|
distress | object | |
|
interim_balance
|
interim_balance | object | |
|
aggregate
|
aggregate | object |
AmlHit
| Name | Pad | Type | Description |
|---|---|---|---|
|
primart_navn
|
primart_navn | string | |
|
Kategori
|
kategori | string | |
|
entitet_type
|
entitet_type | string | |
|
oven
|
kilder | array of string | |
|
match_ratio
|
match_ratio | number | |
|
Criteriumtype_getal
|
match_type | string | |
|
ekstern_id
|
ekstern_id | string |
AmlCheckResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
query_name
|
query_name | string | |
|
query_birth_year
|
query_birth_year | integer | |
|
Hits
|
hits | array of AmlHit | |
|
hit_count
|
hit_count | integer |
AmlScoreResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
rapport_id
|
rapport_id | string | |
|
Score
|
score | number | |
|
level
|
level | string | |
|
Factoren
|
factors | array of object | |
|
Onderdelen
|
factors | object |
NaceCompaniesResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
nace_code
|
nace_code | string | |
|
Onderdelen
|
items | array of CompanyHit | |
|
next_cursor
|
next_cursor | string | |
|
total_count
|
total_count | integer |
RelatedCompaniesResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
Via
|
via | string | |
|
aanverwant
|
related | array of object | |
|
orgnr
|
related.orgnr | string | |
|
navigatie
|
related.navn | string | |
|
relation_strength
|
related.relation_strength | integer | |
|
shared_entities
|
related.shared_entities | array of object | |
|
Onderdelen
|
related.shared_entities | object | |
|
total_count
|
total_count | integer |
AankondigingenSearchResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
Onderdelen
|
items | array of Announcement | |
|
next_cursor
|
next_cursor | string | |
|
filter
|
filter | object |
RiskScoreResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
Score
|
score | integer | |
|
level
|
level | string | |
|
components
|
components | array of object | |
|
Onderdelen
|
components | object | |
|
Bronnen
|
sources | array of string |
FivResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
status
|
status | string |
NUES a-e-status, eks.
|
|
Score
|
score | number | |
|
rules_fired
|
rules_fired | array of object | |
|
Onderdelen
|
rules_fired | object | |
|
betrouwbaarheid
|
confidence | number | |
|
as_of
|
as_of | date-time |
KonsernStotteOversikt
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
selskap_stotte
|
selskap_stotte | object |
Direkte støtte til orgnr (post-#134-skjema). Directe subsidies aan de orgnr (post-#134 shape). |
|
konsern_aggregat
|
konsern_aggregat | object |
Aggregert konsern-støtte oppover i eier-tre. Ondersteuning op groepsniveau. |
|
tildelinger
|
tildelinger | array of object | |
|
Onderdelen
|
tildelinger | object |
FinancialHistoryResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
orgnr
|
orgnr | string | |
|
regnskapstype
|
regnskapstype | string | |
|
Onderdelen
|
items | array of FinancialYear | |
|
freshness
|
freshness | object |