Firmaradar (Независимый Publisher) (предварительная версия)

Этот соединитель доступен в следующих продуктах и регионах:

Service	Class	Regions
Copilot Studio	Премия	Все регионы Power Automate за исключением следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих:      — Регионы Azure для государственных организаций      — Регионы Azure Для Китая      - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate за исключением следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)

Контакт
Имя.	Поддержка Firmaradar
URL	https://firmaradar.no/kontakt
Адрес электронной почты	support@firmaradar.no

Метаданные соединителя
Publisher	Тивас
Веб-сайт	https://firmaradar.no
Политика конфиденциальности	https://firmaradar.no/personvern
Categories	Данные; Бизнес-аналитика

Firmaradar (Независимый Publisher)

Firmaradar — это платформа обогащения для норвежской разведки компании. Данные из нескольких авторитетных источников — норвежский бизнес-регистр (Brønnøysundregistrene), норвежское налоговое управление (Skatteetaten) и внешние регистры PEP и санкций — и добавляет частное обогащение поверх: классификация бедствий, прозрачный оценка рисков, нечеткий человек-сопоставление, аналитика групповой структуры и конвейеры соответствия требованиям аудита. Этот соединитель предоставляет 21 операций, которые можно перейти в поток для обогащения клиентов, поставщиков, партнеров и коллег с структурированной норвежской аналитикой компании.

Publisher: Ларс Кванум

Владелец стека: Firmaradar AS (Норвегия).

Prerequisites

1. Активная учетная запись Firmaradar в https://firmaradar.no.
2. Личный ключ API, выданный через min side → API-nøkler (https://firmaradar.no/min-side/api-keys). Ключ отправляется в качестве заголовка HTTP по каждому запросу X-API-Key .
3. Активная подписка для операций, которые вы планируете использовать. Для некоторых операций требуется соглашение об обработке данных (DPA), вошедшего в учетную запись Firmaradar, в частности, проверку AML и PEP.

Бесплатный уровень охватывает щедрый срез корпоративного профиля, владения, ролей, финансовых историй и объявлений операций. Для операций уровня соответствия требованиям (AML, оценка рисков аудита) требуется платный план и явное принятие DPA.

Поддерживаемые операции

Соединитель предоставляет 21 производственных операций в 6 функциональных областях. Многие операции объединяют несколько источников вышестоящего потока за одним вызовом.

Company

Просмотрите полный профиль компании по номеру организации, разверните его дерево владения и совет или подписанные роли, получить многолетний финансовый журнал, отслеживать последние изменения реестра, искать вселенную компании и сравнивать две компании параллельно.

Персона

Найдите человека, устраните роли, которые человек держит в разных компаниях и перечисляет элементы управления пользователями.

Риск

Получение сигналов риска для компании, поиск в канале объявлений реестра, получение прозрачной оценки риска (0–100) с разбивкой компонентов и запуск уставной "foretak i vanskeligheter" (компания в сложности) оценки бедствий.

Индустрия

Список компаний в отраслевом коде NACE и поиск компаний, связанных с данной компанией с помощью владения или ролей.

AML

Экранировать пользователя или компанию для списков AML и PEP и получить объединенную оценку AML. Эти операции находятся за подписанным DPA и сохраняются в журнале аудита.

Поддержка групп

Получите обзор общедоступной групповой поддержки и грантов (Innovasjon Norge / SkatteFUNN) для компании.

Кроме того, три псевдонима документации предоставляются в спецификации, чтобы предоставить сопоставление "один к одному" с каталогом инструментов Firmaradar MCP; эти операции перенаправляется в ту же серверную часть, что и описанные выше канонические операции.

Получение учетных данных

1. Войдите с https://firmaradar.no помощью проверенной учетной записи Firmaradar.
2. Откройте api-nøkler с минимальной → ( ключи API → учетной записи).
3. Щелкните Generer ny API-nøkkel (Создать новый ключ) и скопируйте ключ. Полный ключ отображается только один раз — храните его в диспетчере секретов или в параметрах подключения.
4. При создании потока, использующего этот соединитель, вставьте ключ в поле подключения ключа API Firmaradar .

Вы можете отозвать или повернуть ключ с одной и той же страницы в любое время.

Getting Started

1. Создайте подключение и вставьте ключ API Firmaradar в поле ключа API Firmaradar .
2. Добавьте действие Firmaradar в поток— например , получить компанию с номером организации, 923609016 например (Equinor ASA).
3. Используйте структурированные выходные данные в подчиненных шагах: после отправки оповещения о рисках в Teams, записи KYC в Dataverse или обогащение свинца CRM.

Известные проблемы и ограничения

• Ответы на норвежский язык. Метки полей и читаемые пользователем строки в ответах написаны на норвежском языке (bokmål), отражая исходные реестры. Английские сводки включаются, где практические.
• Ограничения скорости. Учетные записи уровня "Бесплатный" ограничены 60 запросами в минуту. Операции AML имеют более строгое ограничение в 50 запросов в 30 минут независимо от плана.
• Ведение журнала аудита. Вызовы операций с рисками AML и Marketplace сохраняются в журнале аудита в течение 60 месяцев в соответствии с требованиями норвежских правил KYC. Для X-FR-Purpose вызовов AML должны быть заданы заголовки и X-FR-DPA-Confirmed заголовки; отсутствующие заголовки возвращают HTTP 403.
• Шлюзы соответствия требованиям. Операция getRiskScore может возвращать HTTP 403 с error_code=marketplace_hidden учетной записью, пока учетная запись не пройдет соответствующий шлюз соответствия требованиям. Спецификация помечает эту операцию с расширением x-firmaradar-compliance-gate , чтобы клиенты могли скрыть или отключить ее динамически.
• Только 9-значные номера организации. Все orgnr параметры пути должны иметь ровно 9 цифр (норвежский формат номера организации).
• Непрозрачные курсоры на страницы. Значение, next_cursor возвращаемое операциями с разбивкой на страницы, должно быть передано обратно, не анализируйте или не изменяйте его.

Часто задаваемые вопросы

Должна ли я быть норвежской компанией, чтобы использовать этот соединитель?

No. Ненорвежьие банки, поставщики KYC, платформы AML и помощники по M&A могут вызвать Firmaradar в качестве канонической норвежской серверной части и стегать результат в более широкое представление о соответствии много юрисдикций.

Это просто оболочка вокруг государственного реестра бизнеса?

No. Данные общедоступного реестра редко отвечают на реальный бизнес-вопрос. Firmaradar примиряет несколько источников и уровней собственных сигналов — сопоставление людей, моделирование рисков, групповая аналитика и сантехника соответствия требованиям, поэтому один вызов возвращает представление, готовое к принятию решений.

Инструкции по развертыванию

После сертификации конечные пользователи не должны устанавливать соединитель вручную— он становится доступным в каталоге стандартных соединителей в Power Automate, Power Apps и Logic Apps. Разработчики, которые хотят развернуть до запуска сертификации:

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

См https://learn.microsoft.com/en-us/connectors/custom-connectors/paconn-cli . полный справочник по CLI.

Поддержка

• Проблемы с определением соединителя (Swagger, значок, метаданные): файл проблемы или запрос https://github.com/microsoft/PowerPlatformConnectorsна вытягивание.
• Проблемы с API Firmaradar (ограничения скорости, доступ к учетной записи): контакт support@firmaradar.no.
• Общая документация по Firmaradar:https://firmaradar.no/api-dokumentasjon.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя.	Тип	Description	Обязательный
ключ API	Securestring	Api_key для этого API	True

Действия

Общедоступные гранты для разных групп	Древовидная структура государственных грантов (гранты NAV, поддержка Covid-19, Innovasjon Norge, SkatteFUNN, EU-гранты), полученные компанией и ее группой. Используется для оценки воздействия в государственном секторе.
Объединенные сигналы риска	Объединяет сигналы из трех источников: сигналы объявления KYC (банкротство, слияние, разделение), классификация бедствий (FIV) и промежуточный баланс сигналов.
Оценка риска 0-100 с уровнем и компонентами	Структурированная оценка риска (0–100) с именованным уровнем (низкий / умеренный / высокий / критически важный) и разбивка компонентов для финансового здоровья компании. Возвращает ошибку blocked_enk для частных владельцев. Не личная проверка кредита.
Перечисление компаний в коде NACE-industry	Возвращает компании, зарегистрированные в заданном коде NACE-industry (совпадение префикса). Поддерживает фильтры муниципалитета и сотрудников; разбиение на страницы с стабильным курсором.
Поиск компаний (имя, NACE, муниципалитет)	Единый поиск по имени компании, коду и муниципалитету NACE-отрасли. Возвращает результаты с разбивкой на страницы с стабильным курсором для следующей страницы.
Поиск лиц (акционеров и владельцев ролей)	Поиск лиц в реестре ролей и акционеров BRREG. Поддерживает нечеткое имя, соответствующее начальному расширению и удалению по промежуточному имени; необязательный фильтр года рождения.
Поиск объявлений BRREG в разных компаниях	Поиск между организациями в объявлениях BRREG. Фильтруйте по типу, диапазону дат, состоянию. Используется для мониторинга портфеля и нерегламентированных подстановок.
Поиск связанных компаний (общих лиц или адресов)	Находит компании, которым предоставляется общий доступ к ролей или бизнес-адресу с входной компанией. Используется для проверки соответствия и сетевого сопоставления.
Получение дерева владения (вверх, вниз или оба)	Возвращает дерево владения для компании. direction=down перечисляет дочерние компании; direction=up трассирует родительские компании; direction=both возвращает полную группу. Необязательная глубина (1–12) и include_persons для личных акционеров.
Получение объявлений BRREG (псевдоним для изменения конечной точки)	Псевдоним документации, используемый каталогом средств MCP (get_company_announcements). Пересылает каноническую конечную точку /company/{orgnr}/changes.
Получение объявлений BRREG и последних изменений	Возвращает объявления BRREG (юридические события) и последние изменения (роль, адрес, сигнал, подпись) в настроенном окне для компании. Используется для мониторинга и отслеживания изменений.
Получение полного профиля компании	Возвращает полный профиль компании для норвежского номера организации (orgnr): состояние реестра, NACE-industry, сотрудники, адрес, финансовая история, дерево владения и ключевые роли. Объединяет BRREG, финансовые данные и собственное обогащение.
Получение полной истории ролей для человека	Возвращает полный журнал ролей (активный и исторический) для ролей, определяемых их стабильным role_person_id.
Получение портфеля акций для человека	Возвращает все компании, в которых хранятся акции, с процентом владения и сведениями о классе акций, определяемыми стабильными owner_person_key.
Получение последних изменений (псевдоним для конечной точки изменений)	Псевдоним документации, используемый каталогом средств MCP (get_recent_changes). Пересылает каноническую конечную точку /company/{orgnr}/changes.
Получение профиля пользователя (оркестрация на стороне клиента)	Вспомогательный сервер на стороне клиента, который управляет поискомPersons + getPersonRoles + getPersonCompanies в одном представлении профиля. Описано здесь для паритета с каталогом инструментов MCP.
Получение ролей компании (совет, генеральный директор, подписанные)	Возвращает держателей ролей BRREG (председатель, член совета директоров, генеральный директор, подписанный, полномочия прокурора) для компании. Необязательный фильтр по типу ролей и включению исторических ролей.
Получение финансовой истории	Возвращает финансовую историю (доход, операционный результат, акции, общие активы, сотрудники) до 10 лет назад для норвежской компании.
Проверка AML и PEP (требуется заголовки DPA)	Экраны человека против санкций и списков PEP. Требуется подписанный DPA и для каждого вызова X-FR-Purpose плюс заголовки X-FR-DPA-Confirmed. Все вызовы регистрируются в течение 60 месяцев в соответствии с требованиями норвежских правил KYC.
Создание отчета AML и оценки (поток двух вызовов)	Создает отчет AML для компании и возвращает структурированную оценку (0–100) с разбивкой коэффициента. Поток двухзвоночного вызова на стороне сервера; клиент видит один структурированный ответ.
Состояние FIV (компания в сложности)	Оценивает, является ли компания квалифицироваться как foretak i vanskeligheter (FIV / company in сложности) на норвежские правила NUES a-e, основанные на последних доступных финансовых отчетах.
Сравнение финансовых метрик между компаниями	Оркестрация на стороне сервера: извлекает финансовую историю для нескольких компаний параллельно и возвращает их в табличном формате сравнения для тестирования.

Общедоступные гранты для разных групп

Объединенные сигналы риска

Оценка риска 0-100 с уровнем и компонентами

Перечисление компаний в коде NACE-industry

Поиск компаний (имя, NACE, муниципалитет)

Поиск лиц (акционеров и владельцев ролей)

Поиск объявлений BRREG в разных компаниях

Поиск связанных компаний (общих лиц или адресов)

Получение дерева владения (вверх, вниз или оба)

Получение объявлений BRREG (псевдоним для изменения конечной точки)

Получение объявлений BRREG и последних изменений

Получение полного профиля компании

Получение полной истории ролей для человека

Получение портфеля акций для человека

Получение последних изменений (псевдоним для конечной точки изменений)

Получение профиля пользователя (оркестрация на стороне клиента)

Получение ролей компании (совет, генеральный директор, подписанные)

Получение финансовой истории

Проверка AML и PEP (требуется заголовки DPA)

Создание отчета AML и оценки (поток двух вызовов)

Состояние FIV (компания в сложности)

Сравнение финансовых метрик между компаниями

Определения

Company

Owner

Role

Финансовые метрики

FinancialYear

Объявление

PersonHit

PersonProfile

RolePersonProfile

CompanyHit

CompanySearchResponse

CompareResponse

ВладениеResponse

RoleResponse

СигналыResponse

AmlHit

AmlCheckResponse

AmlScoreResponse

NaceCompaniesResponse

RelatedCompaniesResponse

ОбъявлениеsSearchResponse

RiskScoreResponse

FivResponse

KonsernStotteOversikt

FinancialHistoryResponse