Firmaradar (Bağımsız Publisher) (Önizleme)

Norveçli şirket istihbaratı için zenginleştirme platformu. BRREG, Skatteetaten, yabancı PEP ve tasdik kayıt defterleri, kamu hibe kayıt defterleri ve acil durum sinyallerinden alınan verileri en üstte özel zenginleştirme (risk puanlaması, benzer kişi eşleştirme, grup analizi, denetim notu uyumluluğu) ile birleştirir. KYC, AML, kredi, sahiplik ve risk iş akışları için tasarlanmıştır.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet	Class	Regions
Copilot Studio	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri: - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)
Logic Apps	Standart	Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Kamu bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD)
Power Apps	Premium	Aşağıdakiler dışında tüm Power Apps bölgeleri: - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)
Power Automate	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri: - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)

Contact
İsim	Firmaradar desteği
URL	https://firmaradar.no/kontakt
E-posta	support@firmaradar.no

Bağlayıcı Meta Verileri
Publisher	Tiwas
Web Sitesi	https://firmaradar.no
Gizlilik ilkesi	https://firmaradar.no/personvern
Kategoriler	Veri; İş Zekası

Firmaradar (Bağımsız Publisher)

Firmaradar, Norveçli şirket istihbaratı için bir zenginleştirme platformudur. Norveç İşletme Kayıt Defteri (Brønnøysundregistrene), Norveç Vergi İdaresi (Skatteetaten) ve yabancı PEP ve tasdik kayıtları gibi birçok yetkili kaynaktan gelen verileri birleştirir ve üstüne özel zenginleştirme ekler: sıkıntı sınıflandırması, saydam risk puanlaması, benzer kişi eşleştirme, grup yapısı analizi ve denetim sınıfı uyumluluk işlem hatları. Bu bağlayıcı, yapılandırılmış Norveç şirket zekası ile müşterileri, tedarikçileri, iş ortaklarını ve karşı tarafları zenginleştirmek için bir akışa bırakabileceğiniz 21 işlemi kullanıma sunar.

Publisher: Lars Kvanum

Yığın sahibi: Firmaradar AS (Norveç).

Prerequisites

adresinde https://firmaradar.noetkin bir Firmaradar hesabı.
Min tarafı → API-nøkler (https://firmaradar.no/min-side/api-keys) aracılığıyla verilen kişisel BIR API anahtarı. Anahtar, her istekte X-API-Key HTTP üst bilgisi olarak gönderilir.
Kullanmayı planladığınız işlemler için etkin bir abonelik. Bazı işlemler için Firmaradar hesabınızda imzalanan bir veri işleme sözleşmesi (DPA) gerekir( özellikle AML ve PEP filtreleme).

Ücretsiz katman şirket profili, sahiplik, roller, finansal geçmiş ve duyuru işlemlerinden oluşan geniş bir dilimi kapsar. Uyumluluk katmanı işlemleri (AML, denetim sınıfı risk puanlaması) ücretli bir plan ve açık DPA kabulü gerektirir.

Desteklenen İşlemler

Bağlayıcı, 6 işlevsel alanda 21 üretim işlemini kullanıma sunar. Birçok işlem, birkaç yukarı akış kaynağını tek bir çağrının arkasında birleştirir.

Şirket

Kuruluş numarasına göre tam bir şirket profili arayın, sahiplik ağacını ve panosunu veya imzacı rollerini genişletin, çok yıllık finansal geçmişi alın, son kayıt defteri değişikliklerini izleyin, şirket evreninde arama yapın ve iki şirketi yan yana karşılaştırın.

Person

Bir kişiyi arayın, bir kişinin şirketler genelinde sahip olduğu rolleri çözün ve bir kişinin denetimlerini üstlenen paylaşımları listeleyin.

Risk

Bir şirketin risk sinyallerini alın, kayıt defteri duyuruları akışını arayın, bileşen dökümüyle saydam bir risk puanı (0-100) getirin ve yasal bir "foretak i vanskeligheter" (zor durumdaki şirket) acil durum değerlendirmesi çalıştırın.

Endüstri

BIR NACE sektör kodu içindeki şirketleri listeleyin ve sahiplik veya roller aracılığıyla belirli bir şirketle ilgili şirketleri bulun.

AML

Bir kişiyi veya şirketi AML ve PEP listelerine karşı ekran görüntüsü alın ve birleştirilmiş AML puanı alın. Bu işlemler imzalı bir DPA'nın arkasında geçitlenir ve bir denetim günlüğünde kalıcı olarak kalır.

Grup desteği

Genel grup desteğine genel bir bakış alın ve bir şirket için pozlama (Innovasjon Norge / SkatteFUNN) verir.

Buna ek olarak, Firmaradar MCP araç kataloğu ile bire bir eşleme sağlamak için belirtimlerde üç belge diğer adı kullanıma sunulur; bunlar yukarıdaki kurallı işlemlerle aynı arka uçtan iletilebilir.

Kimlik Bilgilerini Alma

https://firmaradar.no Doğrulanmış bir Firmaradar hesabıyla oturum açın.
API-nøkler → Min yan → açın (Hesabım API anahtarları →).
Generer ny API-nøkkel (Yeni anahtar oluştur) seçeneğine tıklayın ve anahtarı kopyalayın. Tam anahtar yalnızca bir kez gösterilir; gizli dizi yöneticisinde veya bağlantı ayarlarınızda depolayın.
Bu bağlayıcıyı kullanan bir akış oluşturduğunuzda, anahtarı Firmaradar API anahtarı bağlantı alanına yapıştırın.

Anahtarı istediğiniz zaman aynı sayfadan iptal edebilir veya döndürebilirsiniz.

Getting Started

Bir bağlantı oluşturun ve Firmaradar API anahtarınızı Firmaradar API anahtarı alanına yapıştırın.
Akışınıza firmaradar eylemi ekleyin; örneğin( Equinor ASA) gibi 923609016 bir kuruluş numarasına sahip şirket edinin.
Aşağı akış adımlarında yapılandırılmış çıkışı kullanın: Teams'e risk uyarısı gönderin, Dataverse'e bir KYC kaydı yazın veya CRM müşteri adayını zenginleştirin.

Bilinen Sorunlar ve Sınırlamalar

Norveç dili yanıtları. Yanıtlardaki alan etiketleri ve insan tarafından okunabilen dizeler, kaynak kayıt defterlerini yansıtan Norveççe (bokmål) dilinde yazılır. İngilizce özetler pratik olan yerlerde yer alır.
Hız sınırları. Ücretsiz katman hesapları dakikada 60 istekle sınırlıdır. AML işlemleri, plandan bağımsız olarak 30 dakikada bir 50 istek daha katı bir sınıra sahiptir.
Denetim günlüğü. AML ve market riski işlemlerine yönelik çağrılar, Norveç KYC düzenlemelerinin gerektirdiği şekilde 60 ay boyunca bir denetim günlüğünde kalıcı hale getirilmektedir. X-FR-Purpose AML çağrılarında ve X-FR-DPA-Confirmed üst bilgileri ayarlanmalıdır; eksik üst bilgiler HTTP 403 döndürür.
Uyumluluk geçitleri. İşlem, getRiskScore hesap ilgili uyumluluk geçidini geçene kadar ile error_code=marketplace_hidden HTTP 403 döndürebilir. Belirtim, istemcilerin x-firmaradar-compliance-gate dinamik olarak gizleyebilmesi veya devre dışı bırakabilmesi için bu işlemi uzantıyla işaretler.
Yalnızca 9 basamaklı kuruluş numaraları. Tüm orgnr yol parametreleri tam olarak 9 basamak olmalıdır (Norveç kuruluş-sayı biçimi).
Opak sayfalandırma imleçleri. next_cursor Sayfalandırılmış işlemler tarafından döndürülen değer tam olarak geçirilmelidir; ayrıştırmayın veya değiştirmeyin.

Sık Sorulan Sorular

Bu bağlayıcıyı kullanmak için Norveçli bir şirket mi olmak zorundayım?

No. Norveçli olmayan bankalar, KYC satıcıları, AML platformları ve M&A danışmanları Firmaradar'ı kurallı Norveç arka ucu olarak çağırabilir ve sonucu daha geniş bir çok yargı alanı uyumluluk görünümüne birleştirebilir.

Bu yalnızca genel işletme kayıt defterindeki bir sarmalayıcı mı?

No. Yalnızca genel kayıt defteri verileri gerçek bir iş sorusuna nadiren yanıt verir. Firmaradar birden çok kaynağı mutabık tutar ve kişi eşleştirme, risk modelleme, grup analizi ve uyumluluk tesisatı gibi özel sinyalleri katmanlayarak tek bir çağrının karara hazır bir görünüm döndürmesini sağlar.

Dağıtım Yönergeleri

Sertifikasyondan sonra, son kullanıcıların bağlayıcıyı el ile yüklemeleri gerekmez; Power Automate, Power Apps ve Logic Apps'teki standart bağlayıcı kataloğunda kullanılabilir hale gelir. Sertifikasyondan önce dağıtmak isteyen geliştiriciler şu komutu çalıştırabilir:

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

Tam CLI başvurusu için bkz https://learn.microsoft.com/en-us/connectors/custom-connectors/paconn-cli .

Support

Bağlayıcı tanımıyla ilgili sorunlar (Swagger, simge, meta veriler): üzerinde https://github.com/microsoft/PowerPlatformConnectorsbir sorun veya çekme isteği oluşturun.
Firmaradar API'siyle ilgili sorunlar (veri, hız sınırları, hesap erişimi): ile iletişime geçin support@firmaradar.no.
Genel Firmaradar belgeleri:https://firmaradar.no/api-dokumentasjon.

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:


Varsayılan	Bağlantı oluşturmak için parametreler.	Tüm bölgeler	Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Zorunlu
API anahtarı	securestring	Bu API için api_key	True

Eylemler

AML raporu ve puanı oluşturma (iki çağrılı akış)	Bir şirket için aml raporu oluşturur ve faktör dökümü ile yapılandırılmış bir puan (0-100) döndürür. Sunucu tarafı iki çağrılı akış; istemcisi tek bir yapılandırılmış yanıt görür.
AML ve PEP filtreleme (DPA üst bilgileri gerektirir)	Bir kişiyi tasdiklere ve PEP listelerine karşı gösterir. İmzalı DPA ve çağrı başına X-FR-Purpose artı X-FR-DPA-Confirmed üst bilgileri gerektirir. Tüm aramalar, Norveç KYC düzenlemelerinin gerektirdiği şekilde 60 ay boyunca denetime kaydedilir.
Arama şirketleri (ad, NACE, belediye)	Şirket adı, NACE endüstri kodu ve belediye genelinde birleşik arama. Sonraki sayfa için kararlı imleç içeren sayfalandırılmış sonuçlar döndürür.
Bir kişi için paylaşım portföyü alma	Bir kişinin paylaşımda bulunduğu, sahiplik yüzdesi ve paylaşım sınıfı ayrıntılarıyla, kararlı owner_person_key tarafından tanımlanan tüm şirketleri döndürür.
Bir kişi için tam rol geçmişi alma	Kararlı role_person_id tarafından tanımlanan bir rol kişisinin tam rol geçmişini (etkin ve geçmiş) döndürür.
BIR NACE endüstri kodundaki şirketleri listeleme	Belirli bir NACE endüstri koduyla kayıtlı şirketleri döndürür (ön ek eşleşmesi). Belediye ve çalışan filtrelerini destekler; kararlı imleç ile sayfalandırılmış.
BRREG duyurularını alma (değişiklik uç noktasının diğer adı)	MCP araç kataloğu (get_company_announcements) tarafından kullanılan belge diğer adı. Kurallı /company/{orgnr}/changes uç noktasına iletir.
BRREG duyurularını ve son değişiklikleri alma	Bir şirket için yapılandırılmış pencere içinde BRREG duyurularını (yasal olaylar) ve son değişiklikleri (rol, adres, sinyal, imza) döndürür. İzleme ve değişiklik izleme için kullanılır.
Düzey ve bileşenlerle risk puanı 0-100	Şirketin finansal durumu için adlandırılmış düzey (düşük / orta / yüksek / kritik) ve bileşen dökümü ile yapılandırılmış risk puanı (0-100). Tek mülkiyet için blocked_enk hata döndürür. Kişisel kredi çeki değil.
Finansal geçmişi alma	Norveçli bir şirket için 10 yıla kadar finansal geçmişi (gelir, işletme sonucu, özkaynak, toplam varlıklar, çalışanlar) döndürür.
FIV durumu (zor durumdaki şirket)	Bir şirketin norveççe NUES a-e kurallarına göre mevcut en son finansal tablolara göre 'foretak i vanskeligheter' (FIV / zor durumdaki şirket) olarak nitelenip nitelenmediğini değerlendirir.
Grup genelinde genel izinler açığa çıkarma	Bir şirket ve grubu tarafından alınan kamu hibelerinin ağaç yapısı (NAV hibeleri, Covid-19 desteği, Innovasjon Norge, SkatteFUNN, AB hibeleri). Kamu sektörü maruziyetinde durum tespiti için kullanılır.
İlgili şirketleri bulma (paylaşılan kişiler veya adres)	Giriş şirketiyle rol sahipleri veya iş adresi paylaşan şirketleri bulur. Durum tespiti ve ağ eşleme için kullanılır.
Kişi profilini alma (istemci tarafı düzenleme)	SearchPersons + getPersonRoles + getPersonCompanies'i tek bir profil görünümünde düzenleyen istemci tarafı yardımcı. MCP araç kataloğu ile eşlik için burada belgelenmiştir.
Kişileri arayın (hissedarlar ve rol sahipleri)	BRREG rol sahipleri ve hissedar kayıt defteri genelinde kişileri arayın. İlk genişletme ve ikinci ad bırakma ile benzer ad eşleştirmeyi destekler; isteğe bağlı doğum yılı filtresi.
Sahiplik ağacını alma (yukarı, aşağı veya her ikisi)	Bir şirketin sahiplik ağacını döndürür. `direction=down` yan kuruluşları listeler; `direction=up` ana şirketleri izler; `direction=both` tam grubu döndürür. Kişisel hissedarlar için isteğe bağlı derinlik (1-12) ve include_persons.
Son değişiklikleri alma (değişiklik uç noktasının diğer adı)	MCP araç kataloğu (get_recent_changes) tarafından kullanılan belge diğer adı. Kurallı /company/{orgnr}/changes uç noktasına iletir.
Tam şirket profili alma	Norveç kuruluş numarasının (kuruluş kuruluşu) tam şirket profilini döndürür: kayıt defteri durumu, NACE-industry, çalışanlar, adres, finansal geçmiş, sahiplik ağacı ve önemli roller. BRREG, finansal veriler ve özel zenginleştirmeyi birleştirir.
Toplu risk sinyalleri	Üç kaynaktan gelen sinyalleri toplar: KYC duyuru sinyalleri (iflas, birleşme, bölme), tehlike sınıflandırması (FIV) ve ara denge sinyalleri.
Şirket rollerini alma (yönetim kurulu, CEO, imzalayanlar)	Bir şirket için BRREG rol sahiplerini (başkan, yönetim kurulu üyesi, CEO, imzacı, vekalet) döndürür. Rol türüne göre isteğe bağlı filtre ve geçmiş rollerin eklenmesi.
Şirketler arasında BRREG duyurularını arama	BRREG duyurularında çapraz kuruluş araması. Türe, tarih aralığına, duruma göre filtreleyin. Portföy izleme ve geçici aramalar için kullanılır.
Şirketler genelinde finansal ölçümleri karşılaştırma	Sunucu tarafı düzenleme: Birden çok şirketin finansal geçmişini paralel olarak getirir ve bunları karşılaştırma için tablo dostu bir karşılaştırma biçiminde döndürür.

AML raporu ve puanı oluşturma (iki çağrılı akış)

İşlem Kimliği:: getAmlScore

Bir şirket için aml raporu oluşturur ve faktör dökümü ile yapılandırılmış bir puan (0-100) döndürür. Sunucu tarafı iki çağrılı akış; istemcisi tek bir yapılandırılmış yanıt görür.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
orgnr	orgnr	True	string
purpose	purpose		string	AML tarama için DPA-formål (eks. `kyc_onboarding`).

Döndürülenler

Vücut: AmlScoreResponse

AML ve PEP filtreleme (DPA üst bilgileri gerektirir)

İşlem Kimliği:: checkAmlPep

Bir kişiyi tasdiklere ve PEP listelerine karşı gösterir. İmzalı DPA ve çağrı başına X-FR-Purpose artı X-FR-DPA-Confirmed üst bilgileri gerektirir. Tüm aramalar, Norveç KYC düzenlemelerinin gerektirdiği şekilde 60 ay boyunca denetime kaydedilir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Amaç etiketi	X-FR-Purpose	True	string	AML araması için amaç etiketi. Bunlardan biri: kyc_onboarding, kyc_review, risk_monitoring, el ile. AML çağrıları için gereklidir ve denetim günlüğünde kalıcı hale getirilir.
DPA onayı	X-FR-DPA-Confirmed	True	string	Bu AML aramasını kapsayan imzalı bir Veri İşleme Sözleşmeniz olduğunu onaylar. AML çağrıları için gereklidir.
isim	name	True	string
birth_year	birth_year		integer
kategori	kategori		string
min_match_ratio	min_match_ratio		number

Döndürülenler

Vücut: AmlCheckResponse

Arama şirketleri (ad, NACE, belediye)

İşlem Kimliği:: searchCompanies

Şirket adı, NACE endüstri kodu ve belediye genelinde birleşik arama. Sonraki sayfa için kararlı imleç içeren sayfalandırılmış sonuçlar döndürür.

Parametreler

Name	Anahtar	Tür	Description
Arama sorgusu	q	string	Şirket adı veya kuruluş numarasıyla eşleşen serbest metin arama sorgusu.
NACE filtresi	nace	string	Sonuçları NACE endüstri koduna göre filtreleyin (2-5 basamak, ön ek eşleşmesi desteklenir).
Belediye	kommune	string	Norveç belediyesi kodu (4 basamak, örneğin Oslo için 0301) sonuçları coğrafi olarak filtrelemek için kullanılır.
Sınır	limit	integer	Bu sayfada döndürülecek en fazla öğe sayısı. Varsayılan ve en yüksek değer uç nokta başına farklılık gösterir.
Sayfalandırma imleci	cursor	string	Önceki bir çağrı tarafından döndürülen opak sayfalandırma imleci. Sonraki sayfayı getirmek için bunu geri iletin. Ayrıştırmayın veya değiştirmeyin.

Döndürülenler

Vücut: CompanySearchResponse

Bir kişi için paylaşım portföyü alma

İşlem Kimliği:: getPersonCompanies

Bir kişinin paylaşımda bulunduğu, sahiplik yüzdesi ve paylaşım sınıfı ayrıntılarıyla, kararlı owner_person_key tarafından tanımlanan tüm şirketleri döndürür.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sahip kişi anahtarı	owner_person_key	True	string	AramaPersonları veya sahiplik uç noktaları tarafından döndürülen kişisel bir hissedarı tanımlayan kararlı anahtar.

Döndürülenler

Vücut: PersonProfile

Bir kişi için tam rol geçmişi alma

İşlem Kimliği:: getPersonRoles

Kararlı role_person_id tarafından tanımlanan bir rol kişisinin tam rol geçmişini (etkin ve geçmiş) döndürür.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Rol kişisi kimliği	role_person_id	True	string	SearchPersons veya rol uç noktaları tarafından döndürülen rol sahibini tanımlayan kararlı kimlik.

Döndürülenler

Vücut: RolePersonProfile

BIR NACE endüstri kodundaki şirketleri listeleme

İşlem Kimliği:: listCompaniesInNace

Belirli bir NACE endüstri koduyla kayıtlı şirketleri döndürür (ön ek eşleşmesi). Belediye ve çalışan filtrelerini destekler; kararlı imleç ile sayfalandırılmış.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
NACE kodu	code	True	string	NACE-kode eller ön eki (eks. `47`, `47.11`, `47.110`).
Durum filtresi	status		string	Yasal duruma göre filtreleyin (örn. etkin, under_liquidation, struck_off).
Belediye	kommune		string	Norveç belediyesi kodu (4 basamak, örneğin Oslo için 0301) sonuçları coğrafi olarak filtrelemek için kullanılır.
En az çalışan	min_ansatte		integer	Şirketin sahip olması gereken en az çalışan sayısı (dahil).
En fazla çalışan	max_ansatte		integer	Şirketin sahip olması gereken en fazla çalışan sayısı (dahil).
Sınır	limit		integer	Bu sayfada döndürülecek en fazla öğe sayısı. Varsayılan ve en yüksek değer uç nokta başına farklılık gösterir.
Sayfalandırma imleci	cursor		string	Önceki bir çağrı tarafından döndürülen opak sayfalandırma imleci. Sonraki sayfayı getirmek için bunu geri iletin. Ayrıştırmayın veya değiştirmeyin.
Toplamları dahil et	include_total		integer	True ise, yanıta grup toplama toplamlarını içerir.

Döndürülenler

Vücut: NaceCompaniesResponse

BRREG duyurularını alma (değişiklik uç noktasının diğer adı)

İşlem Kimliği:: getCompanyAnnouncements

MCP araç kataloğu (get_company_announcements) tarafından kullanılan belge diğer adı. Kurallı /company/{orgnr}/changes uç noktasına iletir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).

Döndürülenler

response: array of Announcement

BRREG duyurularını ve son değişiklikleri alma

İşlem Kimliği:: getCompanyChanges

Bir şirket için yapılandırılmış pencere içinde BRREG duyurularını (yasal olaylar) ve son değişiklikleri (rol, adres, sinyal, imza) döndürür. İzleme ve değişiklik izleme için kullanılır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).

Döndürülenler

response: array of Announcement

Düzey ve bileşenlerle risk puanı 0-100

İşlem Kimliği:: getRiskScore

Şirketin finansal durumu için adlandırılmış düzey (düşük / orta / yüksek / kritik) ve bileşen dökümü ile yapılandırılmış risk puanı (0-100). Tek mülkiyet için blocked_enk hata döndürür. Kişisel kredi çeki değil.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).

Döndürülenler

Vücut: RiskScoreResponse

Finansal geçmişi alma

İşlem Kimliği:: getCompanyFinancials

Norveçli bir şirket için 10 yıla kadar finansal geçmişi (gelir, işletme sonucu, özkaynak, toplam varlıklar, çalışanlar) döndürür.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).
Yıllar önce	years		integer	Geri döndürülecek mali geçmişin yıl sayısı (1-10).
Deyim türü	regnskapstype		string	Filtreleneceği mali tablonun türü (örn. selskap, konsern). Varsayılan, kurallı deyimini döndürür.
Yenilik önbelleğini atla	skip_freshness		integer	True ise, tazelik önbelleğini atlar ve yukarı akış yenilemesini zorlar. Tedbirli kullanın.

Döndürülenler

Vücut: FinancialHistoryResponse

FIV durumu (zor durumdaki şirket)

İşlem Kimliği:: checkForetakIVanskeligheter

Bir şirketin norveççe NUES a-e kurallarına göre mevcut en son finansal tablolara göre 'foretak i vanskeligheter' (FIV / zor durumdaki şirket) olarak nitelenip nitelenmediğini değerlendirir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).

Döndürülenler

Vücut: FivResponse

Grup genelinde genel izinler açığa çıkarma

İşlem Kimliği:: getKonsernstotte

Bir şirket ve grubu tarafından alınan kamu hibelerinin ağaç yapısı (NAV hibeleri, Covid-19 desteği, Innovasjon Norge, SkatteFUNN, AB hibeleri). Kamu sektörü maruziyetinde durum tespiti için kullanılır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).

Döndürülenler

Vücut: KonsernStotteOversikt

İlgili şirketleri bulma (paylaşılan kişiler veya adres)

İşlem Kimliği:: findRelatedCompanies

Giriş şirketiyle rol sahipleri veya iş adresi paylaşan şirketleri bulur. Durum tespiti ve ağ eşleme için kullanılır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).
İlişki:	via		string	İlişkinin nasıl belirlendiği. 'person' paylaşılan rol sahiplerini kullanır; 'adres', paylaşılan iş adresini kullanır.
Sınır	limit		integer	Bu sayfada döndürülecek en fazla öğe sayısı. Varsayılan ve üst sınır uç nokta başına farklılık gösterir.
En küçük çakışma	min_overlap		integer	İlgili şirket eşleşmesi için gereken en az paylaşılan kişi veya adres sayısı.

Döndürülenler

Vücut: RelatedCompaniesResponse

Kişi profilini alma (istemci tarafı düzenleme)

İşlem Kimliği:: getPerson

SearchPersons + getPersonRoles + getPersonCompanies'i tek bir profil görünümünde düzenleyen istemci tarafı yardımcı. MCP araç kataloğu ile eşlik için burada belgelenmiştir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İsim	name	True	string	Tam veya kısmi kişi adı. İlk genişletme ve ikinci ad bırakma ile benzer eşleşme otomatik olarak uygulanır.
Doğum yılı	birth_year		integer	Ortak adların belirsizliği için kişi aramasında ek filtre olarak kullanılan dört basamaklı doğum yılı.

Döndürülenler

Vücut: PersonProfile

Kişileri arayın (hissedarlar ve rol sahipleri)

İşlem Kimliği:: searchPersons

BRREG rol sahipleri ve hissedar kayıt defteri genelinde kişileri arayın. İlk genişletme ve ikinci ad bırakma ile benzer ad eşleştirmeyi destekler; isteğe bağlı doğum yılı filtresi.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Arama sorgusu	q	True	string	Şirket adı veya kuruluş numarasıyla eşleşen serbest metin arama sorgusu.
Sınır	limit		integer	Bu sayfada döndürülecek en fazla öğe sayısı. Varsayılan ve en yüksek değer uç nokta başına farklılık gösterir.

Döndürülenler

Name	Yol	Tür
query	query	string
hissedarlar	shareholders	array of PersonHit
shareholders_count	shareholders_count	integer
role_persons	role_persons	array of PersonHit
role_persons_count	role_persons_count	integer

Sahiplik ağacını alma (yukarı, aşağı veya her ikisi)

İşlem Kimliği:: getCompanyOwnership

Bir şirketin sahiplik ağacını döndürür. direction=down yan kuruluşları listeler; direction=up ana şirketleri izler; direction=both tam grubu döndürür. Kişisel hissedarlar için isteğe bağlı derinlik (1-12) ve include_persons.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).
Ağaç yönü	direction		string	Ağaç dolaşma yönü. 'down' yan kuruluşları döndürür; 'yukarı', ana babaları döndürür; 'both' tam grubu döndürür.
Ağaç derinliği	depth		integer	Geçiş için sahiplik ağacının kaç düzeyi. Tamsayı 1-12. Daha yüksek derinlik, daha yavaş çağrı anlamına gelir.
Kişileri dahil et	include_persons		integer	Doğruysa, sahiplik ağacına kişisel hissedarları dahil eder (aksi takdirde yalnızca tüzel kişilikler).

Döndürülenler

Vücut: OwnershipResponse

Son değişiklikleri alma (değişiklik uç noktasının diğer adı)

İşlem Kimliği:: getRecentChanges

MCP araç kataloğu (get_recent_changes) tarafından kullanılan belge diğer adı. Kurallı /company/{orgnr}/changes uç noktasına iletir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).

Döndürülenler

response: array of Announcement

Tam şirket profili alma

İşlem Kimliği:: getCompany

Norveç kuruluş numarasının (kuruluş kuruluşu) tam şirket profilini döndürür: kayıt defteri durumu, NACE-industry, çalışanlar, adres, finansal geçmiş, sahiplik ağacı ve önemli roller. BRREG, finansal veriler ve özel zenginleştirmeyi birleştirir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	9-sifret organisasjonsnummer.
Fields	fields		string	Komma-separert alt kümesi, eks. `group,owners,grants,changes,financial_metrics`.
Sahipleri dahil et	owners		string	True ise, yanıta sahiplik bilgilerini içerir.
İzinleri dahil et	grants		integer	True ise, yanıta public-grants verilerini içerir.
BRREG izinlerini dahil et	brreg_grants		integer	True ise, yanıta BRREG public-grants verilerini içerir. Fazladan bir yukarı akış çağrısı ekler.
Finansal ölçümler	financial_metrics		integer	Eklenecek finansal ölçümlerin virgülle ayrılmış listesi (gelir, operating_result, özkaynak vb.).

Döndürülenler

Vücut: Company

Toplu risk sinyalleri

İşlem Kimliği:: getCompanySignals

Üç kaynaktan gelen sinyalleri toplar: KYC duyuru sinyalleri (iflas, birleşme, bölme), tehlike sınıflandırması (FIV) ve ara denge sinyalleri.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).
Den beri	since		date	ISO-dato (YYYY-MM-DD). Overstyrer varsayılan 730 dager bakover. Cappes til 1825 dager.

Döndürülenler

Vücut: SignalsResponse

Şirket rollerini alma (yönetim kurulu, CEO, imzalayanlar)

İşlem Kimliği:: getCompanyRoles

Bir şirket için BRREG rol sahiplerini (başkan, yönetim kurulu üyesi, CEO, imzacı, vekalet) döndürür. Rol türüne göre isteğe bağlı filtre ve geçmiş rollerin eklenmesi.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Organizasyon numarası	orgnr	True	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).
Tarihi dahil et	include_historic		integer	Doğruysa, mevcut rol sahiplerine ek olarak geçmiş (istifa edilen) rol sahiplerini de içerir.
Rol türü	role_type		string	Norveç rol türü koduna göre filtreleyin (ör. styreleder, daglig_leder, signatur). Tam liste için Firmaradar belgelerine bakın.

Döndürülenler

Vücut: RolesResponse

Şirketler arasında BRREG duyurularını arama

İşlem Kimliği:: searchAnnouncements

BRREG duyurularında çapraz kuruluş araması. Türe, tarih aralığına, duruma göre filtreleyin. Portföy izleme ve geçici aramalar için kullanılır.

Parametreler

Name	Anahtar	Tür	Description
Tür filtresi	type	string	Öğenin türüne göre filtreleyin (uç nokta başına değişir; işlem açıklamasına bakın).
Başlangıç tarihi	from	date	ISO biçiminde tarih aralığının başlangıcı (YYYY-MM-DD). Inclusive.
Tarih:	to	date	ISO biçiminde tarih sonu aralığı (YYYY-MM-DD). Inclusive.
Organizasyon numarası	orgnr	string	Brønnøysundregistrene tarafından verilen Norveçli kuruluş numarası (tam 9 basamak).
Arama sorgusu	q	string	Şirket adı veya kuruluş numarasıyla eşleşen serbest metin arama sorgusu.
Sınır	limit	integer	Bu sayfada döndürülecek en fazla öğe sayısı. Varsayılan ve üst sınır uç nokta başına farklılık gösterir.
Sayfalandırma imleci	cursor	string	Önceki bir çağrı tarafından döndürülen opak sayfalandırma imleci. Sonraki sayfayı getirmek için bunu geri iletin. Ayrıştırmayın veya değiştirmeyin.

Döndürülenler

Vücut: AnnouncementsSearchResponse

Şirketler genelinde finansal ölçümleri karşılaştırma

İşlem Kimliği:: compareCompanies

Sunucu tarafı düzenleme: Birden çok şirketin finansal geçmişini paralel olarak getirir ve bunları karşılaştırma için tablo dostu bir karşılaştırma biçiminde döndürür.

Parametreler

Name	Anahtar	Gerekli	Tür
kuruluş üyeleri	orgnrs	True	array of string
Yıllar	years		integer
metrics	metrics		array of string

Döndürülenler

Vücut: CompareResponse

Tanımlar

Şirket

Name	Yol	Tür	Description
orgnr	orgnr	string	9-sifret norsk organisasjonsnummer.
gezinti	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
uçlayıcı	endringer	array of Announcement
financial_metrics	financial_metrics	FinancialMetrics
foretaksklassifisering	foretaksklassifisering	object
summary	summary	string	LLM-vennlig kort oppsummering.

Sahibi

Name	Yol	Tür	Description
gezinti	navn	string
orgnr	orgnr	string	İşletme sahipleri için — eierens orgnr.
owner_person_key	owner_person_key	string	Personlige eiere için — /person/shareholdings için stabil nøkkel.
eierandel_prosent	eierandel_prosent	float
antall_aksjer	antall_aksjer	integer
type	type	string

Rolü

Name	Yol	Tür	Description
rolle_type	rolle_type	string	BRREG-rolle-beskrivelse (Styreleder, Daglig leder, ...).
gezinti	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	Yol	Tür
orgnr	orgnr	string
regnskapstype	regnskapstype	string
items	items	array of FinancialYear
freshness	freshness	object

FinancialYear

Name	Yol	Tür
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

Duyuru

Name	Yol	Tür
orgnr	orgnr	string
gezinti	navn	string
Dato	dato	date
kunngjoring_type	kunngjoring_type	string
category	category	string
hendelse_type	hendelse_type	string
niva1_label	niva1_label	string

PersonHit

Name	Yol	Tür	Description
isim	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
gönderili	poststed	string
antall_selskaper	antall_selskaper	integer

PersonProfile

Name	Yol	Tür
owner_person_key	owner_person_key	string
isim	name	string
birth_year	birth_year	string
gönderili	poststed	string
paylaşımlar	shareholdings	array of object
items	shareholdings	object
total_ownership_value_nok	total_ownership_value_nok	number

RolePersonProfile

Name	Yol	Tür
role_person_id	role_person_id	string
isim	name	string
birth_year	birth_year	string
roles	roles	array of Role

ŞirketHit

Name	Yol	Tür
orgnr	orgnr	string
gezinti	navn	string
organisasjonsform	organisasjonsform	string
naeringskode	naeringskode	string
kommune	kommune	string
statü	status	string
antall_ansatte	antall_ansatte	integer

ŞirketSearchResponse

Name	Yol	Tür
items	items	array of CompanyHit
next_cursor	next_cursor	string
total_count	total_count	integer

CompareResponse

Name	Yol	Tür	Description
kuruluş üyeleri	orgnrs	array of string
Yıllar	years	array of integer
Şirket	companies	array of object
orgnr	companies.orgnr	string
gezinti	companies.navn	string
financials_by_year	companies.financials_by_year	object
karşılaştırma	comparison	object	{<metric>: {<orgnr>: [<value_per_year>]}}
computed_at	computed_at	date-time

SahiplikResponse

Name	Yol	Tür
orgnr	orgnr	string
direction	direction	string
derinlik	depth	integer
Sahipleri	owners	array of Owner
Holdings	holdings	object

RolesResponse

Name	Yol	Tür
orgnr	orgnr	string
roles	roles	array of Role
total_count	total_count	integer
Önbelleğe alınmış	cached	boolean

SignalsResponse

Name	Yol	Tür
orgnr	orgnr	string
days_back	days_back	integer
kyc_signals	kyc_signals	object
Sıkıntı	distress	object
interim_balance	interim_balance	object
aggregate	aggregate	object

AmlHit

Name	Yol	Tür
primart_navn	primart_navn	string
kategori	kategori	string
entitet_type	entitet_type	string
kilder	kilder	array of string
match_ratio	match_ratio	number
Eşleştir_tür	match_type	string
ekstern_id	ekstern_id	string

AmlCheckResponse

Name	Yol	Tür
query_name	query_name	string
query_birth_year	query_birth_year	integer
Hits	hits	array of AmlHit
hit_count	hit_count	integer

AmlScoreResponse

Name	Yol	Tür
orgnr	orgnr	string
rapport_id	rapport_id	string
Skor	score	number
level	level	string
faktörler	factors	array of object
items	factors	object

NaceCompaniesResponse

Name	Yol	Tür
nace_code	nace_code	string
items	items	array of CompanyHit
next_cursor	next_cursor	string
total_count	total_count	integer

RelatedCompaniesResponse

Name	Yol	Tür
orgnr	orgnr	string
Via	via	string
ilgili	related	array of object
orgnr	related.orgnr	string
gezinti	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

DuyurularSearchResponse

Name	Yol	Tür
items	items	array of Announcement
next_cursor	next_cursor	string
filter	filter	object

RiskScoreResponse

Name	Yol	Tür
orgnr	orgnr	string
Skor	score	integer
level	level	string
components	components	array of object
items	components	object
Kaynak	sources	array of string

FivResponse

Name	Yol	Tür	Description
orgnr	orgnr	string
statü	status	string	NUES a-e-status, eks. `not_distressed`, . `distressed`
Skor	score	number
rules_fired	rules_fired	array of object
items	rules_fired	object
Güven	confidence	number
as_of	as_of	date-time

KonsernStotteOversikt

Name	Yol	Tür	Description
orgnr	orgnr	string
selskap_stotte	selskap_stotte	object	Direkte støtte til orgnr (post-#134-skjema). Kuruluşa doğrudan izinler (post-#134 şekli).
konsern_aggregat	konsern_aggregat	object	Aggregert konsern-støtte oppover i eier-tre. Toplu grup düzeyi desteği.
tildelinger	tildelinger	array of object
items	tildelinger	object

FinancialHistoryResponse

Name	Yol	Tür
orgnr	orgnr	string
regnskapstype	regnskapstype	string
items	items	array of FinancialYear
freshness	freshness	object