Infoproff API ドキュメント - v4

スイッチ版 V4

はじめに

Webサービスのwsdlとスキーマはここにあります。:

https://wsdfn.infoproff.com/v4/

Postman Collection (API v4) — Ready for Use:

https://www.postman.com/infoproff/infoproff-webservices/documentation/9kweer5/soap-api-v4

Postman provides a convenient way to test our API without the need to write any code. It can also automatically generate example HTTP requests for most common programming languages.

The requests generated by Postman are basic HTTP calls compatible with our SOAP API. However, for production-grade integration, we recommend using fully featured SOAP clients available in most programming languages. These clients can work directly with WSDL and XSD, automatically handling schemas, data types, and message structures.

Using a dedicated SOAP client ensures a more reliable and robust integration, reducing the likelihood of errors when constructing and parsing SOAP messages.

Authentification details

The primary authentication method is HTTP Basic Auth. Using the Authorization header with encoded credentials is the preferred and recommended approach.

The username corresponds to the App ID, and the password is the associated Secret Key. These values are generated in the API Tokens section of the user dashboard and are not related to the credentials used for logging into the portal.

The authentication_block mechanism, used in previous API versions, is still supported for backward compatibility but is considered deprecated and should not be used in new integrations.

Web service functions:

  • SimpleSearch - 各国の企業情報を検索できます。
  • ChkFinance - 利用可能な財務諸表を検索する。
  • Order - order_id を作成し、複製を返します。複製は次のパラメータで選択される：country, product, reg_code.
  • OrderCancellation - 注文依頼を送信し、order_id を受信した場合、この注文をキャンセルする機会があります（生産が開始されていない場合）。
  • OrderConfirmation - order_id を取得した後、1時間以内に注文を確定する必要があります。1時間以内に注文を確定しない場合、注文は自動的にキャンセルされます。
  • ChkStatus - 注文状況を確認する。
  • GetReport - 完成した報告書を入手する。
  • GetClassifiersFinancialStatements - すべての要素を持つ財務書類を取得します: row_number, row_formated_description, row_lang_key および row_order.
  • GetLegalForms - 利用可能なすべての国の法的書式を取得します。
  • GetActivityClassificators - 特定の活動分類子のすべてのコードと説明を取得します。
  • GetDictionaryStandardPhrases - キーと言語によるすべての標準フレーズを取得します。
  • GetAvailableProducts - 利用可能な製品の一覧を取得します。
  • CreditOpinionCalculator - クレジットオピニオン計算機は、企業のクレジットオピニオンを割り当てるのに役立ちます。

APIはいくつかのサービスを提供します。

  1. 以下の国のオンライン信用調査。 フィンランド共和国 (FIN), スウェーデン王国 (SWE), ベルギー王国 (BEL), オランダ王国 (NLD), エストニア共和国 (EST), カザフスタン共和国 (KAZ), ポーランド共和国 (POL), キルギス共和国 (KGZ), 中華人民共和国 (CHN), モンゴル (MNG)
  2. 以下の国のオフラインレポート。 すべての国
  3. クレジットオピニオン計算機

会社を探すには？

企業検索は2つのオプションで構成されています。:

  1. 会社名で検索,
  2. Search by company code.
利用可能な国の一覧: アイスランド共和国 (ISL), アイルランド (IRL), アゼルバイジャン共和国 (AZE), アルジェリア人民民主共和国 (DZA), アルゼンチン共和国 (ARG), アルバニア共和国 (ALB), アンゴラ共和国 (AGO), イスラエル国 (ISR), イタリア共和国 (ITA), ウズベキスタン共和国 (UZB), ウルグアイ東方共和国 (URY), エクアドル共和国 (ECU), エストニア共和国 (EST), エチオピア連邦民主共和国 (ETH), オランダ王国 (NLD), オーストラリア連邦 (AUS), オーストリア共和国 (AUT), カザフスタン共和国 (KAZ), カナダ (CAN), ガイアナ協同共和国 (GUY), ガンビア共和国 (GMB), キプロス共和国 (CYP), キルギス共和国 (KGZ), ギニア共和国 (GIN), ギリシャ共和国 (GRC), クロアチア共和国 (HRV), グアドループ (GLP), グリーンランド (GRL), グルジア (GEO), グレートブリテン及び北アイルランド連合王国 (GBR), ケニア共和国 (KEN), コソボ (XXK), コンゴ共和国 (COG), コートジボワール (CIV), サモア独立国 (WSM), サンマリノ共和国 (SMR), サンマルタン共同体 (MAF), ザンビア共和国 (ZMB), シンガポール共和国 (SGP), ジャージー島（Bailiwick of Jersey (JEY), ジンバブエ共和国 (ZWE), スイス連邦 (CHE), スウェーデン王国 (SWE), スペイン王国 (ESP), スリランカ民主社会主義共和国 (LKA), スロバキア共和国 (SVK), スロベニア共和国 (SVN), セイシェル共和国 (SYC), セルビア共和国 (SRB), タイ王国 (THA), タジキスタン共和国 (TJK), タンザニア連合共和国 (TZA), チェコ共和国 (CZE), チリ共和国 (CHL), デンマーク王国 (DNK), トーゴ共和国 (TGO), ドイツ連邦共和国 (DEU), ナイジェリア連邦共和国 (NGA), ナミビア共和国 (NAM), ニュージーランド (NZL), ノルウェー王国 (NOR), ハンガリー共和国 (HUN), パラグアイ共和国 (PRY), フィリピン共和国 (PHL), フィンランド共和国 (FIN), フランス共和国 (FRA), フランス領ギアナ (GUF), ブラジル連邦共和国 (BRA), ブルガリア共和国 (BGR), ベナン共和国 (BEN), ベネズエラ・ボリバル共和国 (VEN), ベラルーシ共和国 (BLR), ベルギー王国 (BEL), ペルー共和国 (PER), ボスニア・ヘルツェゴビナ (BIH), ボツワナ共和国 (BWA), ボリビア多民族国 (BOL), ポルトガル共和国 (PRT), ポーランド共和国 (POL), マダガスカル共和国 (MDG), マルタ共和国 (MLT), マルティニク (MTQ), マン島 (IMN), メイヨット (MYT), モナコ公国 (MCO), モルディブ共和国 (MDV), モルドバ共和国 (MDA), モロッコ王国 (MAR), モンゴル (MNG), モーリシャス共和国 (MUS), ラトビア共和国 (LVA), リトアニア共和国 (LTU), リヒテンシュタイン公国 (LIE), ルクセンブルク大公国 (LUX), ルワンダ共和国 (RWA), ルーマニア (ROU), ロシア連邦 (RUS), 中華人民共和国 (CHN), 中華民国 (TWN), 再会 (REU), 南アフリカ共和国 (ZAF), 日本 (JPN), 香港 (HKG)

The search for other countries is performed only in the database of archived reports. If you do not find the desired company, enter the company details manually.

重要なお知らせ:

search_result_id can be acquired here for orders with delivery_term = "o" or delivery_term = "a".

It may take up to 20 seconds to respond to a search request in the following countries: United Kingdom, Ireland, France, Spain, Portugal, Germany, Italy, Austria, Switzerland.

ノルウェーの登記簿では、削除された会社の名前で検索することはできません。従って、ノルウェーの削除された会社の中から名前によるSimpleSearch を提供することはできません。

Field's length:
company_name varchar(512)
company_code varchar(64)

以下は、その例です。:

機能 SimpleSearch

オプション2：レジストレーションコードで検索する

機能 SimpleSearch

Option 3: Search by query (by name or code)

機能 UnifiedSearch

信用調査書を取り寄せるには？

List of available countries for online credit reports: アイルランド (IRL), アゼルバイジャン共和国 (AZE), イタリア共和国 (ITA), エストニア共和国 (EST), オランダ王国 (NLD), オーストリア共和国 (AUT), カザフスタン共和国 (KAZ), キルギス共和国 (KGZ), ギリシャ共和国 (GRC), クロアチア共和国 (HRV), グレートブリテン及び北アイルランド連合王国 (GBR), スイス連邦 (CHE), スウェーデン王国 (SWE), スペイン王国 (ESP), スロバキア共和国 (SVK), スロベニア共和国 (SVN), チェコ共和国 (CZE), デンマーク王国 (DNK), ドイツ連邦共和国 (DEU), ノルウェー王国 (NOR), ハンガリー共和国 (HUN), フィンランド共和国 (FIN), フランス共和国 (FRA), ブルガリア共和国 (BGR), ベルギー王国 (BEL), ポルトガル共和国 (PRT), ポーランド共和国 (POL), マルタ共和国 (MLT), モルドバ共和国 (MDA), モンゴル (MNG), ラトビア共和国 (LVA), ルクセンブルク大公国 (LUX), ロシア連邦 (RUS), 中華人民共和国 (CHN)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

Below you can find the example of how to order and download reports:

STEP 1: Find a company (Online/Offline Order (with search_result_id))

機能 SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: 会社を探すには？

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: Order a report (Online/Offline Order (with search_result_id))

機能 Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 3: Order cancellation (Optional) (Online/Offline Order (with search_result_id))

機能 OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 4: Order confirmation (Online/Offline Order (with search_result_id))

機能 OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 5: Check order status (Online/Offline Order (with search_result_id))

機能 ChkStatus
  • - For offline orders checking order status once every 30 minutes is acceptable frequency.
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

レポートには以下のステータスが使用されます。:

  • 進行中 - 制作段階での報告
  • Identification pending - 報告書作成は保留中。クライアントからの追加データが必要。
  • Canceled - 注文の取り消し
  • Finished - レポートが完成しました
  • Updated - 完成した報告書に情報を追加しました
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - 当社のシステムで技術的なエラーが発生しました。これは、私たちがこのエラーについて知らされており、早急に修正することを意味します。注文を受け取ることができるようになった時点で、その旨をお知らせします。

執行状態がFinished またはUpdated の場合、注文を取得することができます。

STEP 6: Get report (Online/Offline Order (with search_result_id))

機能 GetReport
使用可能な言語一覧: ar (Arabic), bg (ブルガリア語), cs (チェコ), da (デンマーク語), de (ドイツ語), el (ギリシャ語), en (イングリッシュ), es (スパニッシュ), et (エストニア語), fi (フィンランド語), fr (フランス語), he (Hebrew), hu (ハンガリー語), id (インドネシア語), it (イタリア語), ja (日本語), ko (韓国語), lt (リトアニア語), lv (ラトビア語), nb (ノルウェー語ブークモール), nl (オランダ語), pl (ポーランド語), pt (ポルトガル語), ro (ルーマニア語), ru (ロシア語), sk (スロバキア語), sl (スロベニア語), sr (Српски), sv (スウェーデン), th (Thai), tr (トルコ語), uk (ウクライナ語), vi (Vietnamese), zh (中国語)

STEP 1: Order a report (Offline Order (without search_result_id))

機能 Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 2: Order cancellation (Optional) (Offline Order (without search_result_id))

機能 OrderCancellation
If you wish to cancel the order, you can use OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 3: Order confirmation (Offline Order (without search_result_id))

機能 OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 4: Status Checking (Offline Order (without search_result_id))

機能 ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

レポートには以下のステータスが使用されます。:

  • 進行中 - 制作段階での報告
  • Identification pending - 報告書作成は保留中。クライアントからの追加データが必要。
  • Canceled - 注文の取り消し
  • Finished - レポートが完成しました
  • Updated - 完成した報告書に情報を追加しました
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - 当社のシステムで技術的なエラーが発生しました。これは、私たちがこのエラーについて知らされており、早急に修正することを意味します。注文を受け取ることができるようになった時点で、その旨をお知らせします。

執行状態がFinished またはUpdated の場合、注文を取得することができます。

STEP 5: Get report (Offline Order (without search_result_id))

機能 GetReport
使用可能な言語一覧: ar (Arabic), bg (ブルガリア語), cs (チェコ), da (デンマーク語), de (ドイツ語), el (ギリシャ語), en (イングリッシュ), es (スパニッシュ), et (エストニア語), fi (フィンランド語), fr (フランス語), he (Hebrew), hu (ハンガリー語), id (インドネシア語), it (イタリア語), ja (日本語), ko (韓国語), lt (リトアニア語), lv (ラトビア語), nb (ノルウェー語ブークモール), nl (オランダ語), pl (ポーランド語), pt (ポルトガル語), ro (ルーマニア語), ru (ロシア語), sk (スロバキア語), sl (スロベニア語), sr (Српски), sv (スウェーデン), th (Thai), tr (トルコ語), uk (ウクライナ語), vi (Vietnamese), zh (中国語)

アーカイブされた信用情報を注文するには？

Purchase of an archived report is available for all countries.

Below you can find the example of how to order and download archived reports:

STEP 1: Find a company

機能 SimpleSearch

To order an archived report you need to receive "<search_result_id>" which has an "<archived_reports>" section that contains a product you need.
To do so, please follow the link: 会社を探すには？

Example companies with archived reports:

  • Country: EST, Reg. Code: 12309116
  • Country: EST, Reg. Code: 12854256
  • Country: EST, Reg. Code: 12830238
  • Country: USA, Company name: Apple

STEP 2: Order a report

機能 Order

STEP 3: Order cancellation (Optional)

Just like the online/offline reports.

STEP 4: Order confirmation

Just like the online/offline reports.

STEP 5: Check order status

Just like the online/offline reports.

For archived orders checking order status once every 5 seconds is acceptable frequency.

STEP 6: Get report

Just like the online/offline reports.

オンラインで決算書を取り寄せるには？

STEP 1: Find a company

機能 SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: 会社を探すには？

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: 入手可能な決算書を検索する

機能 ChkFinance

この機能は、商品を注文するときのみ必要です。 finances (Financial statements) をdelivery_term = 'o' と一緒にご注文される場合のみ必要です。

利用可能な国の一覧: エストニア共和国 (EST), スウェーデン王国 (SWE)

STEP 3: 財務諸表の注文

機能 Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 4: Order cancellation (Optional)

機能 OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.
To see the examples of xml request/response, please follow the link: How to cancel the order?

STEP 5: Order confirmation

機能 OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.
To see the examples of xml request/response, please follow the link: How to confirm the order?

STEP 6: Check order status

機能 ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

レポートには以下のステータスが使用されます。:

  • 進行中 - 制作段階での報告
  • Identification pending - 報告書作成は保留中。クライアントからの追加データが必要。
  • Canceled - 注文の取り消し
  • Finished - レポートが完成しました
  • Updated - 完成した報告書に情報を追加しました
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - 当社のシステムで技術的なエラーが発生しました。これは、私たちがこのエラーについて知らされており、早急に修正することを意味します。注文を受け取ることができるようになった時点で、その旨をお知らせします。

If the execution status is Finished or Updated, then you can get an order.

To see the examples of xml request/response, please follow the link: How to check order status?

STEP 7: Get report

機能 GetReport
使用可能な言語一覧: ar (Arabic), bg (ブルガリア語), cs (チェコ), da (デンマーク語), de (ドイツ語), el (ギリシャ語), en (イングリッシュ), es (スパニッシュ), et (エストニア語), fi (フィンランド語), fr (フランス語), he (Hebrew), hu (ハンガリー語), id (インドネシア語), it (イタリア語), ja (日本語), ko (韓国語), lt (リトアニア語), lv (ラトビア語), nb (ノルウェー語ブークモール), nl (オランダ語), pl (ポーランド語), pt (ポルトガル語), ro (ルーマニア語), ru (ロシア語), sk (スロバキア語), sl (スロベニア語), sr (Српски), sv (スウェーデン), th (Thai), tr (トルコ語), uk (ウクライナ語), vi (Vietnamese), zh (中国語)
To see the examples of xml request/response, please follow the link: How to get finished order?

標準レポート（XML以外の形式）をダウンロードする方法は？

Types of standard product: Basic Report, Mini Report, Linkages, Registration Data Report, Full report (private person), Short report (private person), Full report (with research), Financials (bank), Short Report, Real estate ownership search, Extended report, Full Report, KYC Report, Linked persons, Credit Opinion, Financial statements.

リクエストは3つのパートで構成されています。

  1. 固定部https://www.infoproff.com/en/orders/files/
  2. お客様固有のハッシュ値、これは当社が応答として提供するものです。
  3. And fixed part at the end /report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
https://www.infoproff.com/en/orders/files/<order_hash>/report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
lang: en, et, ru, lv, ar, bg, cs, da, de, el, fi, fr, he, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, vi, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - オリジナル（交換不可）, EUR, USD, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, GBP, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, RUB, SEK, SGD, THB, TRY, ZAR

非標準品のダウンロード方法は？

Types of non-standard product: Marketing database (special offer), Site visit - non-capital city, Extract from registry, Site visit - capital city, Due Diligence, non-standard, Shareholder document, Memorandum of Association, Certificate of incorporation.

リクエストは3つのパートで構成されています。

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. お客様固有のハッシュ値、これは当社が応答として提供するものです。
  3. そして、最後の修正部分/download

クレジットオピニオンを取得するには？

機能 CreditOpinionCalculator

追加情報を得るには？

機能 GetClassifiersFinancialStatements
機能 GetActivityClassificators
機能 GetDictionaryStandardPhrases
機能 GetAvailableProducts

delivery_term:

  1. "o" = "Online"
  2. "n" = "Normal"
  3. "f" = "Flash"
  4. "s" = "SuperFlash"

考えられるエラー

弊社ウェブサービスへのリクエスト時に、これらのエラーが発生する場合があります。.

全機能
  • Incorrect username/password or you have no permissions.
    間違った認証情報を入力しているか、APIアクセスがブロックされています。
機能 SimpleSearch
  1. You don't have permissions to search in this country.
    利用可能な国の一覧: アイスランド共和国 (ISL), アイルランド (IRL), アゼルバイジャン共和国 (AZE), アルジェリア人民民主共和国 (DZA), アルゼンチン共和国 (ARG), アルバニア共和国 (ALB), アンゴラ共和国 (AGO), イスラエル国 (ISR), イタリア共和国 (ITA), ウズベキスタン共和国 (UZB), ウルグアイ東方共和国 (URY), エクアドル共和国 (ECU), エストニア共和国 (EST), エチオピア連邦民主共和国 (ETH), オランダ王国 (NLD), オーストラリア連邦 (AUS), オーストリア共和国 (AUT), カザフスタン共和国 (KAZ), カナダ (CAN), ガイアナ協同共和国 (GUY), ガンビア共和国 (GMB), キプロス共和国 (CYP), キルギス共和国 (KGZ), ギニア共和国 (GIN), ギリシャ共和国 (GRC), クロアチア共和国 (HRV), グアドループ (GLP), グリーンランド (GRL), グルジア (GEO), グレートブリテン及び北アイルランド連合王国 (GBR), ケニア共和国 (KEN), コソボ (XXK), コンゴ共和国 (COG), コートジボワール (CIV), サモア独立国 (WSM), サンマリノ共和国 (SMR), サンマルタン共同体 (MAF), ザンビア共和国 (ZMB), シンガポール共和国 (SGP), ジャージー島（Bailiwick of Jersey (JEY), ジンバブエ共和国 (ZWE), スイス連邦 (CHE), スウェーデン王国 (SWE), スペイン王国 (ESP), スリランカ民主社会主義共和国 (LKA), スロバキア共和国 (SVK), スロベニア共和国 (SVN), セイシェル共和国 (SYC), セルビア共和国 (SRB), タイ王国 (THA), タジキスタン共和国 (TJK), タンザニア連合共和国 (TZA), チェコ共和国 (CZE), チリ共和国 (CHL), デンマーク王国 (DNK), トーゴ共和国 (TGO), ドイツ連邦共和国 (DEU), ナイジェリア連邦共和国 (NGA), ナミビア共和国 (NAM), ニュージーランド (NZL), ノルウェー王国 (NOR), ハンガリー共和国 (HUN), パラグアイ共和国 (PRY), フィリピン共和国 (PHL), フィンランド共和国 (FIN), フランス共和国 (FRA), フランス領ギアナ (GUF), ブラジル連邦共和国 (BRA), ブルガリア共和国 (BGR), ベナン共和国 (BEN), ベネズエラ・ボリバル共和国 (VEN), ベラルーシ共和国 (BLR), ベルギー王国 (BEL), ペルー共和国 (PER), ボスニア・ヘルツェゴビナ (BIH), ボツワナ共和国 (BWA), ボリビア多民族国 (BOL), ポルトガル共和国 (PRT), ポーランド共和国 (POL), マダガスカル共和国 (MDG), マルタ共和国 (MLT), マルティニク (MTQ), マン島 (IMN), メイヨット (MYT), モナコ公国 (MCO), モルディブ共和国 (MDV), モルドバ共和国 (MDA), モロッコ王国 (MAR), モンゴル (MNG), モーリシャス共和国 (MUS), ラトビア共和国 (LVA), リトアニア共和国 (LTU), リヒテンシュタイン公国 (LIE), ルクセンブルク大公国 (LUX), ルワンダ共和国 (RWA), ルーマニア (ROU), ロシア連邦 (RUS), 中華人民共和国 (CHN), 中華民国 (TWN), 再会 (REU), 南アフリカ共和国 (ZAF), 日本 (JPN), 香港 (HKG)
機能 Order
  1. This product is not available.
    そのような製品は見つからず、注文することはできません。
  2. You can't order report on company with legal form: "legal_form"
    このエラーは、以下の場合にのみ適用されます。: スウェーデン王国 (SWE)
    スウェーデンでは、オンラインレポート（delivery_term = "o"）と次の法的書式を一緒に注文することは不可能です。
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. When delivery term is Online, please use order_details_by_id with search_result_id.
    This error only appears if you are trying to order online report without search_result_id.
    It is important yo use order_details_by_id in OrderReportRequest
  4. Business Name or Reg Code is required
    オフラインレポート（delivery_term = "n", "f" or "s"）を注文する場合、"Business Name" または "Reg Code "が必要です。
  5. Reg Code is required when delivery term is Online
    オンラインレポート（delivery_term = "o"）をご注文の際は、"Reg Code "が必要です。
機能 GetReport
  1. This language is not supported.
    Onlineレポートで使用できる言語の一覧: ar (Arabic), bg (ブルガリア語), cs (チェコ), da (デンマーク語), de (ドイツ語), el (ギリシャ語), en (イングリッシュ), es (スパニッシュ), et (エストニア語), fi (フィンランド語), fr (フランス語), he (Hebrew), hu (ハンガリー語), id (インドネシア語), it (イタリア語), ja (日本語), ko (韓国語), lt (リトアニア語), lv (ラトビア語), nb (ノルウェー語ブークモール), nl (オランダ語), pl (ポーランド語), pt (ポルトガル語), ro (ルーマニア語), ru (ロシア語), sk (スロバキア語), sl (スロベニア語), sr (Српски), sv (スウェーデン), th (Thai), tr (トルコ語), uk (ウクライナ語), vi (Vietnamese), zh (中国語)
機能 GetReport ChkStatus
  1. Incorrect order_id.
    オーダーIDが見つかりません。Order 関数を使用すると、オーダー ID を取得できます。
機能 OrderCancellation
  1. Your order is already canceled.
    もう注文をキャンセルする権限はないんですね。
機能 OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

SOAP（バージョン4）とSOAP（バージョン3）の相違点

新しいセクション

  • country_economic_overview — 以下のサブセクションを含みます： , , .data_transparency_index country_development_indicators economic_forecast
  • paid_taxes — 支払った税金に関する情報。
  • tenders — 入札に関する情報。
  • sanctions — 「 」セクションに追加されました。negative_information

既存セクションの更新

beneficiaries 、shareholders 、managers 、およびemployees_data の各セクションに、以下の要素が追加されました:
  • source_type — データソースの種類（例： 、 、 など）。official mass_media company_admin
「relations_of_persons 」セクションに新しい要素が追加されました:
  • match_type
capital セクションが再構成されました:
  • 「capital_amount 」要素は「issued_capital 」に名称変更されました。
  • 以下の新しい要素が追加されました：
    • number_of_shares
    • share_value
    • authorized_capital
「employees_data 」セクションにおいて:
  • 新しい要素「group_figure 」は、データにグループレベルの集計値が含まれるかどうかを示します（true ）。
  • 要素「source_type 」はデータソースの種類を指定します。
  • 要素「is_estimated 」は、その値が「true 」の場合にのみ含まれます。
新しい「assets_data 」セクション — 既存のセクションを統合します：
  • real_estate_data (以前の名称: )、 、 (以前の名称: )。property_data vehicles machinery_and_equipment assets
  • 今後の追加予定:patents とbiological_assets 。
vehicles セクションに新しいフィールドが追加されました：
  • value
litigations セクションに、以下の要素が追加されました:
  • content,instance,process,authority
「financial_statement/positions 」と「summary/latest_turnovers 」に新しい要素が追加されました:
  • value_origin — 値の起源を説明します。例えば、値「 」estimated は、利用可能なデータに基づいて論理またはAIを使用して推定および計算された値です。
branches_data セクションには、以下のフィールドが追加されました:
  • registration_number
  • director_name

注：安定化フェーズ中に、 minor improvements and adjustments が追加される可能性があります。

Webhooks Settings

概要

ウェブフックは、アプリケーションが他のアプリケーションにリアルタイム情報を提供するための方法です。当社のウェブフック機能は、URLで設定されたHTTPコールバックを実装しています。指定されたイベントが発生するたびに、HTTP POSTペイロードがJSON形式でこのURLに送信されます。私たちのプロジェクトのコンテキストでは、特定のイベントをトリガーするようにwebhook機能を設計しました。

ウェブフックの設定

アプリケーションにWebhookを設定するには、アプリケーションの設定ページに移動し、「Webhooks Settings」セクションを探します。そして以下の情報を入力してください：

  1. 「Webhook URL "は、サーバーがWebhookのPOSTリクエストを受け取るURLです。
  2. 「配信最大試行回数 "は、最初の配信試行が失敗した場合に、Webhook イベントを配信するための最大再試行回数を定義する設定です。
  3. 「配信再試行タイムアウト "は、ウェブフックの配信試行が失敗した場合の再試行の時間間隔を指定できる設定です。

これらの情報を入力したら、「保存」をクリックします。

Webhookイベントの種類

  1. 新しい注文状況

ウェブフックペイロード

イベントが発生すると、そのイベントに関する情報を含むJSONボディを持つHTTP POSTリクエストをペイロードURLに送信する。

これがペイロードの例だ：
新しい注文ステータスのペイロード例
"new_status" フィールドの取り得る値:
  • "Finished" - 注文が完了しました。注文の受け取り;
  • "Updated" - 注文が更新され、完了した注文にデータが追加された。;
  • "Canceled" - 顧客の要求（または同意）により注文がキャンセルされた場合。;
  • "Rejected" - 注文が拒否される。通常、会社を特定することは不可能だからだ。.
  • "Identification pending" - ご注文の準備には、お客様からさらに情報が必要です。.

Webhooksの保護

ペイロード URL に送信された POST リクエストがアプリケーションからのものであることを確認することが重要です。これを支援するために、すべてのWebhookリクエストはX-Signatureヘッダを含んでいます。

シグネチャー

署名にはSHA512アルゴリズムによるHMACを使用する。

Secretは、App IDとWebhooks設定のSecret Keyを連結したもの。

必要であれば、送信者を特定するために独自のget paramsをエンドポイントに追加することも可能である。

トラブルシューティング

サーバーは10秒以内に応答し、2XX HTTPコードを返さなければなりません。そうでなければ、ウェブフックの配信は失敗したとみなされます。そうでない場合、Webhook の配信は失敗したとみなされます。失敗した場合、この機能は配信ポリシーに従ってリクエストの再送を試みます。