Infoproff API ドキュメント - v4


はじめに


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

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

Postmanコレクション(API v4)— すぐ使える:

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

Postmanは、コードを書かずに当社のAPIをテストできる便利な手段を提供します。また、一般的なプログラミング言語の多くについて、HTTPリクエストの例を自動生成することもできます。

Postman が生成するリクエストは、当社の SOAP API と互換性のある基本的な HTTP 呼び出しです。ただし、本番レベルの統合では、ほとんどのプログラミング言語で利用できる高機能な SOAP クライアントの使用を推奨します。これらのクライアントは WSDL および XSD を直接扱い、スキーマ、データ型、メッセージ構造を自動的に処理できます。

専用のSOAPクライアントを使用すると、より信頼性が高く堅牢な連携が可能になり、SOAPメッセージの構築および解析時のエラー発生リスクを低減できます。

認証の詳細

主な認証方式は HTTP Basic Auth です。エンコードされた認証情報を含む Authorization ヘッダーの使用が、推奨される優先的な方法です。

usernameApp ID に対応し、password は関連する Secret Key です。これらの値はユーザーダッシュボードの API Tokens セクションで生成され、ポータルへのログイン用認証情報とは関係ありません。

以前の API バージョンで使用されていた authentication_block メカニズムは、後方互換性のため引き続きサポートされていますが、非推奨とみなされ、新しい統合では使用しないでください。

Webサービスの関数:

  • 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. 以下の国のオンライン信用調査。 アイルランド (IRL), アゼルバイジャン (AZE), イギリス (GBR), イタリア (ITA), ウクライナ (UKR), エストニア (EST), オランダ (NLD), オーストリア (AUT), カザフスタン (KAZ), キルギス (KGZ), ギリシャ (GRC), クロアチア (HRV), スイス (CHE), スウェーデン (SWE), スペイン (ESP), スロバキア (SVK), スロベニア (SVN), チェコ (CZE), デンマーク (DNK), ドイツ (DEU), ノルウェー (NOR), ハンガリー (HUN), フィンランド (FIN), フランス (FRA), ブルガリア (BGR), ベルギー (BEL), ポルトガル (PRT), ポーランド (POL), マルタ (MLT), モルドバ (MDA), モンゴル (MNG), ラトビア (LVA), ルクセンブルク (LUX), ロシア (RUS), 中国 (CHN)
  2. 以下の国のオフラインレポート。 すべての国
  3. クレジットオピニオン計算機
  4. 企業検索

会社を探すには?


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

  1. 会社名で検索,
  2. 企業コードで検索.
利用可能な国の一覧: アイスランド (ISL), アイルランド (IRL), アゼルバイジャン (AZE), アルジェリア (DZA), アルゼンチン (ARG), アルバニア (ALB), アンゴラ (AGO), イギリス (GBR), イスラエル (ISR), イタリア (ITA), ウクライナ (UKR), ウズベキスタン (UZB), ウルグアイ (URY), エクアドル (ECU), エストニア (EST), エチオピア (ETH), オランダ (NLD), オーストラリア (AUS), オーストリア (AUT), カザフスタン (KAZ), カナダ (CAN), ガイアナ (GUY), ガンビア (GMB), キプロス (CYP), キルギス (KGZ), ギニア (GIN), ギリシャ (GRC), クロアチア (HRV), グアドループ (GLP), グリーンランド (GRL), グルジア (GEO), ケニア (KEN), コソボ (XXK), コンゴ共和国 (COG), コートジボワール (CIV), サモア (WSM), サンマリノ (SMR), サン・マルタン (MAF), ザンビア (ZMB), シンガポール (SGP), ジャージー島 (JEY), ジンバブエ (ZWE), スイス (CHE), スウェーデン (SWE), スペイン (ESP), スリランカ (LKA), スロバキア (SVK), スロベニア (SVN), セルビア (SRB), セーシェル (SYC), タイ (THA), タジキスタン (TJK), タンザニア (TZA), チェコ (CZE), チリ (CHL), デンマーク (DNK), トルコ (TUR), トーゴ (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), レユニオン (REU), ロシア (RUS), 中国 (CHN), 南アフリカ (ZAF), 台湾 (TWN), 日本 (JPN), 香港 (HKG)

他国の検索はアーカイブ済みレポートのデータベースでのみ実行されます。目的の企業が見つからない場合は、企業情報を手動で入力してください。

重要なお知らせ:

delivery_term = "o" または delivery_term = "a" の注文については、ここで search_result_id を取得できます。

次の国では、検索リクエストへの応答に最大20秒かかる場合があります:イギリス, アイルランド, フランス, スペイン, ポルトガル, ドイツ, イタリア, オーストリア, スイス, トルコ

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

トルコの登記簿では、SimpleSearch への検索は会社名のみに対応しており、登録番号による検索は利用できません。検索クエリには、少なくとも5文字を含める必要があります。会社名の先頭部分のみが照合されます。

フィールドの長さ:
company_name varchar(512)
company_code varchar(64)

以下は、その例です。:


機能 SimpleSearch

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:SimpleSearch>
            <SimpleSearchRequest>
                <search_block>
                    <company_name>biz group</company_name>
                    <country>SWE</country>
                </search_block>
            </SimpleSearchRequest>
        </ns0:SimpleSearch>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <search_result>
                    <item>
                        <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                        <name>ABČ Биз Sweden Groūp Āktiebolāg</name>
                        <name_transliteration>ABC Biz Sweden Group Aktiebolag</name_transliteration>
                        <historical_names>
                            <item>
                                <name>Groupama Asslcurazioni</name>
                            </item>
                            <item>
                                <name>Asslcurazioni</name>
                            </item>
                        </historical_names>
                        <reg_code>5592027779</reg_code>
                        <vat_code>TAX1125867</vat_code>
                        <static_code>6523456</static_code>
                        <legal_status>Active</legal_status>
                        <legal_form>Aktiebolag</legal_form>
                        <unified_legal_form>Limited liability company</unified_legal_form>
                        <legal_address>KLUBBSTIGEN 8, 17961, STENHAMRA, SVERIGE</legal_address>
                        <parent_company_code>3386027979</parent_company_code>
                        <archived_reports>
                            <item>
                                <product>kyc_report</product>
                                <revision_date>2023-04-20</revision_date>
                                <archived_report_cost>10</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                            </item>
                            <item>
                                <product>basic_report</product>
                                <revision_date>2023-06-29</revision_date>
                                <archived_report_cost>15.2</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                                <last_fin_report>
                                    <fin_report_year>2022</fin_report_year>
                                    <period_start>2022-01-01</period_start>
                                    <period_end>2022-12-31</period_end>
                                    <fin_period_duration_in_months>12</fin_period_duration_in_months>
                                </last_fin_report>
                            </item>
                            <item>
                                <product>full_report</product>
                                <revision_date>2022-04-13</revision_date>
                                <archived_report_cost>25.75</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                                <last_fin_report>
                                    <fin_report_year>2021</fin_report_year>
                                    <fin_period_start>2021-01-01</fin_period_start>
                                    <fin_period_end>2021-12-31</fin_period_end>
                                    <fin_period_duration_in_months>12</fin_period_duration_in_months>
                                </last_fin_report>
                            </item>
                        </archived_reports>
                    </item>
                    <item>
                        <search_result_id>fc8cec2a-5b59-4b30-b65c-ba2900669cd7</search_result_id>
                        <name>АДД Caprīccīo Groūp AB</name>
                        <name_transliteration>ADD Capriccio Group AB</name_transliteration>
                        <historical_names/>
                        <reg_code>5567769961</reg_code>
                        <vat_code/>
                        <static_code/>
                        <legal_status/>
                        <legal_form>Landsting</legal_form>
                        <unified_legal_form>State institution</unified_legal_form>
                        <legal_address>STUDENTBACKEN 1 12 TR, 11557, STOCKHOLM,
                            SVERIGE</legal_address>
                        <parent_company_code xsi:nil="true"/>
                    </item>
                    <item>
                        <search_result_id>4b9c5da2-3aac-4b9a-a308-f9c1e2ee8f32</search_result_id>
                        <name>AEE Good Group AB</name>
                        <name_transliteration>AEE Good Group AB</name_transliteration>
                        <historical_names/>
                        <reg_code>5591756685</reg_code>
                        <vat_code/>
                        <static_code/>
                        <legal_status>Active</legal_status>
                        <legal_form>Ömsesidigt försäkringsbolag</legal_form>
                        <unified_legal_form>Enterprise</unified_legal_form>
                        <legal_address>BOX 1, 18173, LIDINGÖ, SVERIGE</legal_address>
                        <parent_company_code xsi:nil="true"/>
                    </item>
                    ...
                </search_result>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

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

機能 SimpleSearch

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:SimpleSearch>
            <SimpleSearchRequest>
                <search_block>
                    <company_code>5592027779</company_code>
                    <country>SWE</country>
                </search_block>
            </SimpleSearchRequest>
        </ns0:SimpleSearch>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <item>
                    <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                    <name>ABČ Биз Sweden Groūp Āktiebolāg</name>
                    <name_transliteration>ABC Biz Sweden Group Aktiebolag</name_transliteration>
                    <historical_names>
                        <item>
                            <name>Groupama Asslcurazioni</name>
                        </item>
                        <item>
                            <name>Asslcurazioni</name>
                        </item>
                    </historical_names>
                    <reg_code>5592027779</reg_code>
                    <vat_code>TAX1125867</vat_code>
                    <static_code>6523456</static_code>
                    <legal_status>Active</legal_status>
                    <legal_form>Aktiebolag</legal_form>
                    <unified_legal_form>Limited liability company</unified_legal_form>
                    <legal_address>KLUBBSTIGEN 8, 17961, STENHAMRA, SVERIGE</legal_address>
                    <parent_company_code>3386027979</parent_company_code>
                </item>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

オプション3:クエリで検索(名称またはコード)

機能 UnifiedSearch

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:SimpleSearch>
            <SimpleSearchRequest>
                <search_block>
                    <search_query>group</search_query>
                    <country>SWE</country>
                </search_block>
            </SimpleSearchRequest>
        </ns0:SimpleSearch>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <item>
                    <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                    <name>ABČ Биз Sweden Groūp Āktiebolāg</name>
                    <name_transliteration>ABC Biz Sweden Group Aktiebolag</name_transliteration>
                    <historical_names>
                        <item>
                            <name>Groupama Asslcurazioni</name>
                        </item>
                        <item>
                            <name>Asslcurazioni</name>
                        </item>
                    </historical_names>
                    <reg_code>5592027779</reg_code>
                    <vat_code>TAX1125867</vat_code>
                    <static_code>6523456</static_code>
                    <legal_status>Active</legal_status>
                    <legal_form>Aktiebolag</legal_form>
                    <unified_legal_form>Limited liability company</unified_legal_form>
                    <legal_address>KLUBBSTIGEN 8, 17961, STENHAMRA, SVERIGE</legal_address>
                    <parent_company_code>3386027979</parent_company_code>
                </item>
                <item>
                    <search_result_id>4b9c5da2-3aac-4b9a-a308-f9c1e2ee8f32</search_result_id>
                    <name>AEE Good Group AB</name>
                    <name_transliteration>AEE Good Group AB</name_transliteration>
                    <historical_names/>
                    <reg_code>5591756685</reg_code>
                    <vat_code/>
                    <static_code/>
                    <legal_status>Active</legal_status>
                    <legal_form>Ömsesidigt försäkringsbolag</legal_form>
                    <unified_legal_form>Enterprise</unified_legal_form>
                    <legal_address>BOX 1, 18173, LIDINGÖ, SVERIGE</legal_address>
                    <parent_company_code xsi:nil="true"/>
                </item>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

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


オンライン信用レポートが利用可能な国の一覧: アイルランド (IRL), アゼルバイジャン (AZE), イギリス (GBR), イタリア (ITA), ウクライナ (UKR), エストニア (EST), オランダ (NLD), オーストリア (AUT), カザフスタン (KAZ), キルギス (KGZ), ギリシャ (GRC), クロアチア (HRV), スイス (CHE), スウェーデン (SWE), スペイン (ESP), スロバキア (SVK), スロベニア (SVN), チェコ (CZE), デンマーク (DNK), ドイツ (DEU), ノルウェー (NOR), ハンガリー (HUN), フィンランド (FIN), フランス (FRA), ブルガリア (BGR), ベルギー (BEL), ポルトガル (PRT), ポーランド (POL), マルタ (MLT), モルドバ (MDA), モンゴル (MNG), ラトビア (LVA), ルクセンブルク (LUX), ロシア (RUS), 中国 (CHN)
フィールドの長さ:
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)

以下に、レポートの注文とダウンロードの例を示します:

ステップ 1: 企業を探す (オンライン/オフライン注文(search_result_idあり))

機能 SimpleSearch

Online/Offline with identification レポートを注文するには、「<search_result_id>」を受け取る必要があります.
そのためには、次のリンクに従ってください: 会社を探すには?

検索を使うと、注文したい会社を正確に特定できます。たとえば、一部の国では同じ登記番号の会社が複数存在する場合や、同じ正式名称が複数の会社に属している場合があります。

ステップ 2: レポートを注文する (オンライン/オフライン注文(search_result_idあり))

機能 Order
要素 confirm_order を使用しない場合、XML 応答で <last_duplicates> を受け取るため、本当に注文が必要かどうかを判断できます。

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <order_details_by_id>
                    <country>FIN</country>
                    <product>full_report</product>
                    <delivery_term>o</delivery_term>
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>false</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                    	<item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <search_result_id>60751300-4b72-451f-bf96-2a1a7cbe71c6</search_result_id>
                        <address>Company address</address>
                        <phone>Company phone</phone>
                        <email>Company email</email>
                        <additional_info>Additional information regarding company</additional_info>
                        <ref_code>YOUR REF CODE</ref_code> <!-- if you need it -->
                    </company_details>
                </order_details_by_id>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderResponse>
            <OrderReportResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Awaiting Confirmation</order_status>
                </order_data>
                <last_duplicates>
                    <order_data>
                        <order_id>90000054</order_id>
                        <order_hash>ZJHhHYIbpUp2xtZM1Jqg5QQYmnrLo2E7p-J8uP7BUF5_G7BNu5J0-nNVxKOeIxun</order_hash>
                        <order_deadline>2019-09-09 </order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-09-09 13:02:32</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>o</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>08481566</reg_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Awaiting Confirmation</order_status>
                    </order_data>
                    <order_data>
                        <order_id>90000053</order_id>
                        <order_hash>X4Z6VL9KZd5bWsnWQ_NjdlfN2ix7M1jdwW_FrJ_IyIVKwkDipsx73dW3RMgVE8y0</order_hash>
                        <order_deadline>2019-08-02</order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-08-02 16:34:12</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>s</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>08481566</reg_code>
                                <vat_code>000000001</vat_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Finished</order_status>
                    </order_data>
                </last_duplicates>
            </OrderReportResponse>
        </ns1:OrderResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

ステップ 3: 注文のキャンセル(任意) (オンライン/オフライン注文(search_result_idあり))

機能 OrderCancellation
注文をキャンセルする場合は、この OrderCancellation 関数を使用できます。注文がすでに進行中の場合は、キャンセルできません。

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderCancellation>
            <OrderCancellationRequest>
                <order_id>90000055</order_id>
            </OrderCancellationRequest>
        </ns0:OrderCancellation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderCancellationResponse>
            <OrderCancellationResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Canceled</order_status>
                </order_data>
            </OrderCancellationResponse>
        </ns1:OrderCancellationResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

ステップ 4: 注文の確認 (オンライン/オフライン注文(search_result_idあり))

機能 OrderConfirmation
要素 "confirm_order" を使用しなかった場合は、注文を確認する必要があります。

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderConfirmation>
            <OrderConfirmationRequest>
                <order_id>90000055</order_id>
            </OrderConfirmationRequest>
        </ns0:OrderConfirmation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-EN>
        <ns1:OrderConfirmationResponse>
            <OrderConfirmationResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>In progress</order_status>
                </order_data>
            </OrderConfirmationResponse>
        </ns1:OrderConfirmationResponse>
    </SOAP-EN</div>V:Body>
</SOAP-ENV:Envelope>

ステップ 5: 注文状況の確認 (オンライン/オフライン注文(search_result_idあり))

機能 ChkStatus
  • - オフライン注文では、30分ごとに注文状況を確認するのが妥当な頻度です。
  • - オンライン注文では、5秒ごとに注文状況を確認するのが妥当な頻度です。

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:ChkStatus>
            <ChkStatusRequest>
                <order_id>90000055</order_id>
            </ChkStatusRequest>
        </ns0:ChkStatus>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:ChkStatusResponse>
            <ChkStatusResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
            </ChkStatusResponse>
        </ns1:ChkStatusResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

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

  • 進行中 - 制作段階での報告
  • 本人確認待ち - 報告書作成は保留中。クライアントからの追加データが必要。
  • キャンセル済み - 注文の取り消し
  • 完了 - レポートが完成しました
  • 更新済み - 完成した報告書に情報を追加しました
  • 却下 - 注文は却下されました(残高不足、注文内容の誤り、またはその他の理由)。
  • 技術エラー - 当社のシステムで技術的なエラーが発生しました。これは、私たちがこのエラーについて知らされており、早急に修正することを意味します。注文を受け取ることができるようになった時点で、その旨をお知らせします。

実行ステータスが Finished または Updated の場合、注文を取得できます。

ステップ 6: レポートを取得 (オンライン/オフライン注文(search_result_idあり))

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

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetReport>
            <GetReportRequest>
                <order_id>90000055</order_id>
                <lang>en</lang>
            </GetReportRequest>
        </ns0:GetReport>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:GetReportResponse>
            <GetReportResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
                <report>
                    <language>en</language>
                    <revision_date>2019-01-28</revision_date>
                    <identification>
                        <person_type key="101741" lang="en">company</person_type>
                        <name>Company LLC</name>
                        <code>0848156-6</code>
                        <code_origin>FIN</code_origin>
                    </identification>
                    <summary>
                        <name_in_the_register>Company LLC</name_in_the_register>
                        <name_in_english>Company name in English</name_in_english>
                        <registration_code>...</registration_code>
                        <taxpayer_code>...</taxpayer_code>
                        <legal_form>...</legal_form>
                        <unified_legal_form>...</unified_legal_form>
                        <legal_address>...</legal_address>
                        <office_address>...</office_address>
                        <telephone>...</telephone>
                        <fax>...</fax>
                        <email>...</email>
                        <www>...</www>
                        <legal_status>...</legal_status>
                        <capital>...</capital>
                        <capital_currency>...</capital_currency>
                        <foundation_date>...</foundation_date>
                        <deletion_date xsi:nil="..."/>
                        <remarks_on_payments>...</remarks_on_payments>
                        <export>...</export>
                        <import>...</import>
                        <litigations>...</litigations>
                        <main_activities>...</main_activities>
                        <latest_turnovers>...</latest_turnovers>
                        <credit_rating>...</credit_rating>
                        <credit_rating_description>...</credit_rating_description>
                        <credit_rating_limit>...</credit_rating_limit>
                    </summary>
                    <credit_opinions>...</credit_opinions>
                    <general_data>
                        <business_names_data>...</business_names_data>
                        <registration_data>...</registration_data>
                        <trade_names_data>...</trade_names_data>
                        <addresses_data>...</addresses_data>
                        <contacts_data>...</contacts_data>
                        <important_notifications_data>...</important_notifications_data>
                        <statuses_data>...</statuses_data>
                        <activities_data>...</activities_data>
                        <legal_form_data>...</legal_form_data>
                        <capital_data>...</capital_data>
                        <employees_data>...</employees_data>
                    </general_data>
                    <shareholders>...</shareholders>
                    <managers>...</managers>
                    <the_normal_regulations_of_the_representation_rights>...</the_normal_regulations_of_the_representation_rights>
                    <relations_of_persons>...</relations_of_persons>
                    <branches_data>...</branches_data>
                    <export_import_data>...</export_import_data>
                    <publications_data>...</publications_data>
                    <negative_information>...</negative_information>
                    <financial_statements_data>...</financial_statements_data>
                </report>
            </GetReportResponse>
        </ns1:GetReportResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

ステップ 1: レポートを注文する (オフライン注文(search_result_idなし))

機能 Order
要素 confirm_order を使用しない場合、XML 応答で <last_duplicates> を受け取るため、本当に注文が必要かどうかを判断できます。

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <order_details>
                    <country>RUS</country>
                    <product>full_report</product>
                    <delivery_term>n</delivery_term> <!-- available delivery_term: "n", "f" and "s" -->
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>false</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                        <item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <business_name>Company LLC</business_name> <!-- business_name or reg_code is required -->
                        <reg_code>123456789</reg_code> <!-- business_name or reg_code is required -->
                        <vat_code>000000001</vat_code>
                        <address>Company address</address>
                        <phone>Company phone</phone>
                        <email>Company email</email>
                        <additional_info>Additional information regarding company</additional_info>
                        <ref_code>YOUR REF CODE</ref_code> <!-- if you need it -->
                    </company_details>
                </order_details>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderResponse>
            <OrderReportResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Awaiting Confirmation</order_status>
                </order_data>
                <last_duplicates>
                    <order_data>
                        <order_id>1000000035</order_id>
                        <order_hash>ZJHhHYIbpUp2xtZM1Jqg5QQYmnrLo2E7p-J8uP7BUF5_G7BNu5J0-nNVxKOeIxun</order_hash>
                        <order_deadline>2019-08-01 </order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-08-01 13:02:32</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>f</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>123456789</reg_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Awaiting Confirmation</order_status>
                    </order_data>
                    <order_data>
                        <order_id>1000000036</order_id>
                        <order_hash>X4Z6VL9KZd5bWsnWQ_NjdlfN2ix7M1jdwW_FrJ_IyIVKwkDipsx73dW3RMgVE8y0</order_hash>
                        <order_deadline>2019-06-02</order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-06-02 16:34:12</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>o</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>123456789</reg_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Finished</order_status>
                    </order_data>
                </last_duplicates>
            </OrderReportResponse>
        </ns1:OrderResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

ステップ 2: 注文のキャンセル(任意) (オフライン注文(search_result_idなし))

機能 OrderCancellation
注文をキャンセルする場合は、OrderCancellation 関数を使用できます。注文がすでに進行中の場合は、キャンセルできません。

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderCancellation>
            <OrderCancellationRequest>
                <order_id>1000000040</order_id>
            </OrderCancellationRequest>
        </ns0:OrderCancellation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderCancellationResponse>
            <OrderCancellationResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Canceled</order_status>
                </order_data>
            </OrderCancellationResponse>
        </ns1:OrderCancellationResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

ステップ 3: 注文の確認 (オフライン注文(search_result_idなし))

機能 OrderConfirmation
要素 "confirm_order" を使用しなかった場合は、注文を確認する必要があります。

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderConfirmation>
            <OrderConfirmationRequest>
                <order_id>1000000040</order_id>
            </OrderConfirmationRequest>
        </ns0:OrderConfirmation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-EN>
        <ns1:OrderConfirmationResponse>
            <OrderConfirmationResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>In progress</order_status>
                </order_data>
            </OrderConfirmationResponse>
        </ns1:OrderConfirmationResponse>
    </SOAP-EN</div>V:Body>
</SOAP-ENV:Envelope>

ステップ 4: ステータス確認 (オフライン注文(search_result_idなし))

機能 ChkStatus
オフライン注文では、30分ごとに注文状況を確認するのが妥当な頻度です。

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:ChkStatus>
            <ChkStatusRequest>
                <order_id>1000000040</order_id>
            </ChkStatusRequest>
        </ns0:ChkStatus>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:ChkStatusResponse>
            <ChkStatusResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
            </ChkStatusResponse>
        </ns1:ChkStatusResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

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

  • 進行中 - 制作段階での報告
  • 本人確認待ち - 報告書作成は保留中。クライアントからの追加データが必要。
  • キャンセル済み - 注文の取り消し
  • 完了 - レポートが完成しました
  • 更新済み - 完成した報告書に情報を追加しました
  • 却下 - 注文は却下されました(残高不足、注文内容の誤り、またはその他の理由)。
  • 技術エラー - 当社のシステムで技術的なエラーが発生しました。これは、私たちがこのエラーについて知らされており、早急に修正することを意味します。注文を受け取ることができるようになった時点で、その旨をお知らせします。

実行ステータスが Finished または Updated の場合、注文を取得できます。

ステップ 5: レポートを取得 (オフライン注文(search_result_idなし))

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

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetReport>
            <GetReportRequest>
                <order_id>1000000040</order_id>
                <lang>en</lang>
            </GetReportRequest>
        </ns0:GetReport>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:GetReportResponse>
            <GetReportResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
                <report>
                    <language>en</language>
                    <revision_date>2019-01-28</revision_date>
                    <identification>
                        <person_type key="101741" lang="en">company</person_type>
                        <name>Company LLC</name>
                        <code>12345678-9</code>
                        <code_origin>FIN</code_origin>
                    </identification>
                    <summary>
                        <name_in_the_register>Company LLC</name_in_the_register>
                        <name_in_english>Company name in English</name_in_english>
                        <registration_code>...</registration_code>
                        <taxpayer_code>...</taxpayer_code>
                        <legal_form>...</legal_form>
                        <unified_legal_form>...</unified_legal_form>
                        <legal_address>...</legal_address>
                        <office_address>...</office_address>
                        <telephone>...</telephone>
                        <fax>...</fax>
                        <email>...</email>
                        <www>...</www>
                        <legal_status>...</legal_status>
                        <capital>...</capital>
                        <capital_currency>...</capital_currency>
                        <foundation_date>...</foundation_date>
                        <deletion_date xsi:nil="..."/>
                        <remarks_on_payments>...</remarks_on_payments>
                        <export>...</export>
                        <import>...</import>
                        <litigations>...</litigations>
                        <main_activities>...</main_activities>
                        <latest_turnovers>...</latest_turnovers>
                        <credit_rating>...</credit_rating>
                        <credit_rating_description>...</credit_rating_description>
                        <credit_rating_limit>...</credit_rating_limit>
                    </summary>
                    <credit_opinions>...</credit_opinions>
                    <general_data>
                        <business_names_data>...</business_names_data>
                        <registration_data>...</registration_data>
                        <trade_names_data>...</trade_names_data>
                        <addresses_data>...</addresses_data>
                        <contacts_data>...</contacts_data>
                        <important_notifications_data>...</important_notifications_data>
                        <statuses_data>...</statuses_data>
                        <activities_data>...</activities_data>
                        <legal_form_data>...</legal_form_data>
                        <capital_data>...</capital_data>
                        <employees_data>...</employees_data>
                    </general_data>
                    <shareholders>...</shareholders>
                    <managers>...</managers>
                    <the_normal_regulations_of_the_representation_rights>...</the_normal_regulations_of_the_representation_rights>
                    <relations_of_persons>...</relations_of_persons>
                    <branches_data>...</branches_data>
                    <export_import_data>...</export_import_data>
                    <publications_data>...</publications_data>
                    <negative_information>...</negative_information>
                    <financial_statements_data>...</financial_statements_data>
                </report>
            </GetReportResponse>
        </ns1:GetReportResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

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


アーカイブレポートの購入はすべての国で利用できます。

以下に、アーカイブレポートの注文とダウンロードの例を示します:

ステップ 1: 企業を探す

機能 SimpleSearch

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <search_result>
                    <item>
                        <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                        <name>Example Company Name</name>
                        <reg_code>00000000</reg_code>
                        ...
                        <archived_reports> <!-- <?= t('docs', 'Section with available archived reports on this company') ?>-->
                            ...
                            <item>
                                <product>full_report</product>
                                <revision_date>2022-04-13</revision_date>
                                <archived_report_cost>15.75</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                                <last_fin_report>
                                    <fin_report_year>2021</fin_report_year>
                                    <fin_period_start>2021-01-01</fin_period_start>
                                    <fin_period_end>2021-12-31</fin_period_end>
                                    <fin_period_duration_in_months>12</fin_period_duration_in_months>
                                </last_fin_report>
                            </item>
                            ...
                        </archived_reports>
                    </item>
                    ...
                </search_result>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

アーカイブ済みレポートを注文するには、「<archived_reports>」セクションに必要な製品が含まれる「<search_result_id>」を受け取る必要があります。
そのためには、次のリンクに従ってください: 会社を探すには?

アーカイブレポートのある企業の例:

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

ステップ 2: レポートを注文する

機能 Order

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <order_details_by_id>
                    <country>FIN</country>
                    <product>full_report</product><!-- <?= t('docs', "Selected archived product for this company") ?> -->
                    <delivery_term>a</delivery_term> <!-- <?= t('docs', "Core difference, always 'a' = archive") ?> -->
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>true</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                    	<item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id> <!-- <?= t('docs', 'Always required') ?> -->
                        <ref_code>YOUR REF CODE</ref_code> <!-- <?= t('docs', 'If you need it') ?> -->
                    </company_details>
                </order_details_by_id>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

ステップ 3: 注文のキャンセル(任意)

オンライン/オフラインレポートと同じです。

ステップ 4: 注文の確認

オンライン/オフラインレポートと同じです。

ステップ 5: 注文状況の確認

オンライン/オフラインレポートと同じです。

アーカイブ注文では、5秒ごとに注文状況を確認するのが妥当な頻度です。

ステップ 6: レポートを取得

オンライン/オフラインレポートと同じです。

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


ステップ 1: 企業を探す

機能 SimpleSearch

オンライン財務諸表を注文するには、「<search_result_id>」を受け取る必要があります.
そのためには、次のリンクに従ってください: 会社を探すには?

検索を使うと、注文したい会社を正確に特定できます。たとえば、一部の国では同じ登記番号の会社が複数存在する場合や、同じ正式名称が複数の会社に属している場合があります。

ステップ 2: 入手可能な決算書を検索する

機能 ChkFinance

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

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

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:ChkFinance>
            <ChkFinanceRequest>
                <finance_check_block>
                    <search_result_id>0f6b91f8-3d1b-4901-9d1f-6920afca0667</search_result_id>
                    <country>EST</country>
                </finance_check_block>
            </ChkFinanceRequest>
        </ns0:ChkFinance>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:ChkFinanceResponse>
            <ChkFinanceResponse>
                <finance_check_result>
                    <search_result_id>0f6b91f8-3d1b-4901-9d1f-6920afca0667</search_result_id>
                    <name>00000000 EHITUS</name>
                    <reg_code>00000000</reg_code>
                    <vat_code xsi:nil="true"/>
                    <legal_status>Entered into the register</legal_status>
                    <legal_form>Aktsiaselts</legal_form>
                    <legal_address>Järvevana tee 9g, Kesklinna linnaosa, Tallinn, Harju maakond,
                        11314, Eesti</legal_address>
                    <financial_statements>
                        <item>
                            <available_year>2021</available_year>
                        </item>
                        <item>
                            <available_year>2020</available_year>
                        </item>
                        <item>
                            <available_year>2019</available_year>
                        </item>
                        <item>
                            <available_year>2018</available_year>
                        </item>
                        <item>
                            <available_year>2017</available_year>
                        </item>
                        <item>
                            <available_year>2016</available_year>
                        </item>
                        <item>
                            <available_year>2015</available_year>
                        </item>
                        <item>
                            <available_year>2014</available_year>
                        </item>
                        <item>
                            <available_year>2013</available_year>
                        </item>
                    </financial_statements>
                </finance_check_result>
            </ChkFinanceResponse>
        </ns1:ChkFinanceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

ステップ 3: 財務諸表の注文

機能 Order
要素 confirm_order を使用しない場合、XML 応答で <last_duplicates> を受け取るため、本当に注文が必要かどうかを判断できます。

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <order_details_by_id>
                    <country>EST</country>
                    <product>finances</product>
                    <delivery_term>o</delivery_term>
                    <preferable_finances> <!-- only neccasery for product: 'finances' -->
                        <item>2021</item>
                        <item>2020</item>
                    </preferable_finances>
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>false</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                    	<item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <search_result_id>60751300-4b72-451f-bf96-2a1a7cbe71c6</search_result_id>
                        <ref_code>YOUR REF CODE</ref_code> <!-- if you need it -->
                    </company_details>
                </order_details_by_id>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderResponse>
            <OrderReportResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>EST</country>
                        <product>finances</product>
                        <delivery_term>o</delivery_term>
                        <preferable_finances>
                            <item>2021</item>
                            <item>2020</item>
                        </preferable_finances>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>00000000 EHITUS</business_name>
                            <reg_code>00000000</reg_code>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Awaiting Confirmation</order_status>
                </order_data>
                <last_duplicates>
                    <order_data>
                        <order_id>90000054</order_id>
                        <order_hash>ZJHhHYIbpUp2xtZM1Jqg5QQYmnrLo2E7p-J8uP7BUF5_G7BNu5J0-nNVxKOeIxun</order_hash>
                        <order_deadline>2019-09-09 </order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-09-09 13:02:32</request_time>
                        <order_details>
                            <country>EST</country>
                            <product>finances</product>
                            <delivery_term>o</delivery_term>
                            <preferable_finances>
                                <item>2020</item>
                                <item>2019</item>
                            </preferable_finances>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <business_name>00000000 EHITUS</business_name>
                                <reg_code>00000000</reg_code>
                                <ref_code>YOUR REF CODE</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Awaiting Confirmation</order_status>
                    </order_data>
                    <order_data>
                        <order_id>90000053</order_id>
                        <order_hash>X4Z6VL9KZd5bWsnWQ_NjdlfN2ix7M1jdwW_FrJ_IyIVKwkDipsx73dW3RMgVE8y0</order_hash>
                        <order_deadline>2019-08-02</order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-08-02 16:34:12</request_time>
                        <order_details>
                            <country>EST</country>
                            <product>finances</product>
                            <delivery_term>o</delivery_term>
                            <preferable_finances>
                                <item>2018</item>
                            </preferable_finances>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <business_name>00000000 EHITUS</business_name>
                                <reg_code>00000000</reg_code>
                                <ref_code>YOUR REF CODE</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Finished</order_status>
                    </order_data>
                </last_duplicates>
            </OrderReportResponse>
        </ns1:OrderResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

ステップ 4: 注文のキャンセル(任意)

機能 OrderCancellation
注文をキャンセルする場合は、この OrderCancellation 関数を使用できます。注文がすでに進行中の場合は、キャンセルできません。
XMLリクエスト/レスポンスの例を見るには、次のリンクに従ってください: 注文をキャンセルするには?

ステップ 5: 注文の確認

機能 OrderConfirmation
要素 "confirm_order" を使用しなかった場合は、注文を確認する必要があります。
XMLリクエスト/レスポンスの例を見るには、次のリンクに従ってください: 注文を確認するには?

ステップ 6: 注文状況の確認

機能 ChkStatus
  • - オンライン注文では、5秒ごとに注文状況を確認するのが妥当な頻度です。

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

  • 進行中 - 制作段階での報告
  • 本人確認待ち - 報告書作成は保留中。クライアントからの追加データが必要。
  • キャンセル済み - 注文の取り消し
  • 完了 - レポートが完成しました
  • 更新済み - 完成した報告書に情報を追加しました
  • 却下 - 注文は却下されました(残高不足、注文内容の誤り、またはその他の理由)。
  • 技術エラー - 当社のシステムで技術的なエラーが発生しました。これは、私たちがこのエラーについて知らされており、早急に修正することを意味します。注文を受け取ることができるようになった時点で、その旨をお知らせします。

実行ステータスが Finished または Updated の場合、注文を取得できます。

XMLリクエスト/レスポンスの例を見るには、次のリンクに従ってください: 注文状況を確認するには?

ステップ 7: レポートを取得

機能 GetReport
使用可能な言語一覧: ar (Arabic), az (Azerbaijani), bg (ブルガリア語), cs (チェコ), da (デンマーク語), de (ドイツ語), el (ギリシャ語), en (イングリッシュ), es (スパニッシュ), et (エストニア語), fi (フィンランド語), fr (フランス語), he (Hebrew), hi (Hindi), hu (ハンガリー語), hy (Armenian), id (インドネシア語), it (イタリア語), ja (日本語), ka (Georgian), kk (Kazakh), ko (韓国語), lt (リトアニア語), lv (ラトビア語), mn (Mongolian), ms (Malay), nb (ノルウェー語ブークモール), nl (オランダ語), pl (ポーランド語), pt (ポルトガル語), ro (ルーマニア語), ru (ロシア語), sk (スロバキア語), sl (スロベニア語), sr (Српски), sv (スウェーデン), th (Thai), tr (トルコ語), uk (ウクライナ語), uz (Uzbek), vi (Vietnamese), zh (中国語)
XMLリクエスト/レスポンスの例を見るには、次のリンクに従ってください: 完了した注文を取得するには?

標準レポート(XML以外の形式)をダウンロードする方法は?


標準製品の種類: 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. お客様固有のハッシュ値、これは当社が応答として提供するものです。
    <order_hash>
  3. および末尾の固定部分 /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, az, bg, cs, da, de, el, fi, fr, he, hi, hu, hy, id, it, ja, ka, kk, ko, lt, mn, ms, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, uz, 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

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


非標準製品の種類: 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. 固定部分 https://www.infoproff.com/en/orders/files/
  2. お客様固有のハッシュ値、これは当社が応答として提供するものです。
    <order_hash>
  3. そして、最後の修正部分/download
https://www.infoproff.com/en/orders/files/<order_hash>/download

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


機能 CreditOpinionCalculator

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns0="http://infoproff.com/">
   <SOAP-ENV:Header />
   <SOAP-ENV:Body>
      <ns0:CreditOpinionCalculator>
         <CreditOpinionCalculatorRequest>
            <order_details>
               <country>XXX</country>
               <product>credit_opinion_calculator</product>
               <delivery_term>o</delivery_term>
               <lang>en</lang>
               <ref_code>test1</ref_code>
               <initial_data>
                  <general_data>
                     <status>REG</status>
                     <foundation>1996-11-13</foundation>
                     <nace2code>22.21</nace2code>
                     <employees>
                        <item>
                           <number_of_employees>236</number_of_employees>
                           <year>2018</year>
                           <period_end_date>2018-12-31</period_end_date>
                        </item>
                        <item>
                           <number_of_employees>216</number_of_employees>
                           <year>2017</year>
                           <period_end_date>2017-12-31</period_end_date>
                        </item>
                        <item>
                           <number_of_employees>210</number_of_employees>
                           <year>2016</year>
                           <period_end_date>2016-12-31</period_end_date>
                        </item>
                     </employees>
                  </general_data>
                  <debts>
                     <unpaid_debts>
                        <total_amount>100000000</total_amount>
                        <currency_name>EUR</currency_name>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                     </unpaid_debts>
                     <last_registered_debt>2020-01-15</last_registered_debt>
                  </debts>
                  <financial_elements>
                     <item>
                        <year>2018</year>
                        <period>12</period>
                        <currency>EUR</currency>
                        <scale>1</scale>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                        <period_start_date>2018-01-01</period_start_date>
                        <period_end_date>2018-12-31</period_end_date>
                        <positions>
                           <position>
                              <position_code>1000</position_code>
                              <value>29089411</value>
                           </position>
                           <position>
                              <position_code>1010</position_code>
                              <value>6556256</value>
                           </position>
                           <position>
                              <position_code>1020</position_code>
                              <value>20895813</value>
                           </position>
                           <position>
                              <position_code>1100</position_code>
                              <value>26347731</value>
                           </position>
                           <position>
                              <position_code>1110</position_code>
                              <value>6422249</value>
                           </position>
                           </position>
                           <position>
                              <position_code>1130</position_code>
                              <value>315255</value>
                           </position>
                           <position>
                              <position_code>1200</position_code>
                              <value>55437150</value>
                           </position>
                           <position>
                              <position_code>1300</position_code>
                              <value>13563874</value>
                           </position>
                           <position>
                              <position_code>1310</position_code>
                              <value>2141431</value>
                           </position>
                           <position>
                              <position_code>1400</position_code>
                              <value>41542005</value>
                           </position>
                           <position>
                              <position_code>1410</position_code>
                              <value>10780537</value>
                           </position>
                           <position>
                              <position_code>1420</position_code>
                              <value>30761468</value>
                           </position>
                           <position>
                              <position_code>1500</position_code>
                              <value>55437150</value>
                           </position>
                           <position>
                              <position_code>1600</position_code>
                              <value>32763727</value>
                           </position>
                           <position>
                              <position_code>1700</position_code>
                              <value>-11583299</value>
                           </position>
                           <position>
                              <position_code>1800</position_code>
                              <value>1852455</value>
                           </position>
                           <position>
                              <position_code>1900</position_code>
                              <value>4604983</value>
                           </position>
                           <position>
                              <position_code>2000</position_code>
                              <value>3876811</value>
                           </position>
                        </positions>
                     </item>
                     <item>
                        <year>2017</year>
                        <period>12</period>
                        <currency>EUR</currency>
                        <scale>1</scale>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                        <period_start_date>2017-01-01</period_start_date>
                        <period_end_date>2017-12-31</period_end_date>
                        <positions>
                           <position>
                              <position_code>1000</position_code>
                              <value>27956649</value>
                           </position>
                           <position>
                              <position_code>1010</position_code>
                              <value>6699710</value>
                           </position>
                           <position>
                              <position_code>1020</position_code>
                              <value>20784951</value>
                           </position>
                           <position>
                              <position_code>1100</position_code>
                              <value>13530424</value>
                           </position>
                           <position>
                              <position_code>1110</position_code>
                              <value>5848610</value>
                           </position>
                           <position>
                              <position_code>1120</position_code>
                              <value>7350656</value>
                           </position>
                           <position>
                              <position_code>1130</position_code>
                              <value>331158</value>
                           </position>
                           <position>
                              <position_code>1200</position_code>
                              <value>41487080</value>
                           </position>
                           <position>
                              <position_code>1300</position_code>
                              <value>13233015</value>
                           </position>
                           <position>
                              <position_code>1310</position_code>
                              <value>2141431</value>
                           </position>
                           <position>
                              <position_code>1400</position_code>
                              <value>28234892</value>
                           </position>
                           <position>
                              <position_code>1410</position_code>
                              <value>4000000</value>
                           </position>
                           <position>
                              <position_code>1420</position_code>
                              <value>24234892</value>
                           </position>
                           <position>
                              <position_code>1500</position_code>
                              <value>41487080</value>
                           </position>
                           <position>
                              <position_code>1600</position_code>
                              <value>38508619</value>
                           </position>
                           <position>
                              <position_code>1700</position_code>
                              <value>-13380841</value>
                           </position>
                           <position>
                              <position_code>1800</position_code>
                              <value>4020449</value>
                           </position>
                           <position>
                              <position_code>1900</position_code>
                              <value>3071074</value>
                           </position>
                           <position>
                              <position_code>2000</position_code>
                              <value>2211543</value>
                           </position>
                        </positions>
                     </item>
                     <item>
                        <year>2016</year>
                        <period>12</period>
                        <currency>EUR</currency>
                        <scale>1</scale>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                        <period_start_date>2016-01-01</period_start_date>
                        <period_end_date>2016-12-31</period_end_date>
                        <positions>
                           <position>
                              <position_code>1000</position_code>
                              <value>23098292</value>
                           </position>
                           <position>
                              <position_code>1010</position_code>
                              <value>6251447</value>
                           </position>
                           <position>
                              <position_code>1020</position_code>
                              <value>16338678</value>
                           </position>
                           <position>
                              <position_code>1100</position_code>
                              <value>11104261</value>
                           </position>
                           <position>
                              <position_code>1110</position_code>
                              <value>5111604</value>
                           </position>
                           <position>
                              <position_code>1120</position_code>
                              <value>4657457</value>
                           </position>
                           <position>
                              <position_code>1130</position_code>
                              <value>1335200</value>
                           </position>
                           <position>
                              <position_code>1200</position_code>
                              <value>34202560</value>
                           </position>
                           <position>
                              <position_code>1300</position_code>
                              <value>12554095</value>
                           </position>
                           <position>
                              <position_code>1310</position_code>
                              <value>2141431</value>
                           </position>
                           <position>
                              <position_code>1400</position_code>
                              <value>21617540</value>
                           </position>
                           <position>
                              <position_code>1410</position_code>
                              <value>2000000</value>
                           </position>
                           <position>
                              <position_code>1420</position_code>
                              <value>19617540</value>
                           </position>
                           <position>
                              <position_code>1500</position_code>
                              <value>34202560</value>
                           </position>
                           <position>
                              <position_code>1600</position_code>
                              <value>34392412</value>
                           </position>
                           <position>
                              <position_code>1700</position_code>
                              <value>-12182016</value>
                           </position>
                           <position>
                              <position_code>1800</position_code>
                              <value>2520984</value>
                           </position>
                           <position>
                              <position_code>1900</position_code>
                              <value>-335799</value>
                           </position>
                           <position>
                              <position_code>2000</position_code>
                              <value>-764980</value>
                           </position>
                        </positions>
                     </item>
                  </financial_elements>
               </initial_data>
            </order_details>
         </CreditOpinionCalculatorRequest>
      </ns0:CreditOpinionCalculator>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://infoproff.com/">
   <SOAP-ENV:Body>
      <ns1:CreditOpinionCalculatorResponse>
         <CreditOpinionCalculatorResponse>
            <order_data>
               <order_id>1444</order_id>
               <order_hash>MpfreVp7EFZ7piIMQykCnfevRjyDOKNuAi5uAvy3XHBVAKpMXsLD99URoYppb7Ry</order_hash>
               <order_deadline>2020-01-27</order_deadline>
               <price>1.5</price>
               <currency>EUR</currency>
               <request_time>2020-01-27 14:09:27</request_time>
               <order_status>Finished</order_status>
            </order_data>
            <credit_opinion>
               <language>en</language>
               <ref_code>test1</ref_code>
               <credit_opinion>
                  <item>
                     <credit_rating>CCC</credit_rating>
                     <rating_description>Risk above normal. Short term credit only.</rating_description>
                     <credit_limit>154000</credit_limit>
                     <credit_limit_currency>EUR</credit_limit_currency>
                     <latest_turnover_type>R12</latest_turnover_type>
                     <latest_turnover_range>20 000 001 - 50 000 000</latest_turnover_range>
                     <rating_explanation>
                        <explanation>Long-established company.</explanation>
                        <explanation>Latest turnover range 20 000 001 - 50 000 000 EUR.</explanation>
                        <explanation>The company had downfall in turnover during the known financial periods (at least once).</explanation>
                        <explanation>Within last years company's turnover had a slight decrease (growth rate).</explanation>
                        <explanation>Equity of the company is at a normal level.</explanation>
                        <explanation>Current ratio of the company is at a low level.</explanation>
                        <explanation>Quick ratio of the company is at a very low level.</explanation>
                        <explanation>Profitability of the company is at a very high level (in relation to equity).</explanation>
                     </rating_explanation>
                  </item>
               </credit_opinion>
            </credit_opinion>
         </CreditOpinionCalculatorResponse>
      </ns1:CreditOpinionCalculatorResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

追加情報を得るには?


機能 GetClassifiersFinancialStatements

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetClassifiersFinancialStatements>
            <GetClassifiersFinancialStatementsRequest/>
        </ns0:GetClassifiersFinancialStatements>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetClassifiersFinancialStatementsResponse>
            <GetClassifiersFinancialStatementsResponse>
                <financial_statements>
                    <item>
                        <subtype_id>97</subtype_id>
                        <subtype_description>Income statement format 2</subtype_description>
                        <row_number>333100</row_number>
                        <row_formated_description>basic earnings (loss) per
                            share</row_formated_description>
                        <row_lang_key>6886</row_lang_key>
                        <row_order>340</row_order>
                    </item>
                    <item>
                        <subtype_id>97</subtype_id>
                        <subtype_description>Income statement format 2</subtype_description>
                        <row_number>323600</row_number>
                        <row_formated_description>interest income</row_formated_description>
                        <row_lang_key>3686</row_lang_key>
                        <row_order>170</row_order>
                    </item>
					...
                    <item>
                        <subtype_id>89</subtype_id>
                        <subtype_description>Financial key ratios</subtype_description>
                        <row_number>3080</row_number>
                        <row_formated_description>Quick ratio</row_formated_description>
                        <row_lang_key>7644</row_lang_key>
                        <row_order>80</row_order>
                    </item>
                    <item>
                        <subtype_id>89</subtype_id>
                        <subtype_description>Financial key ratios</subtype_description>
                        <row_number>3060</row_number>
                        <row_formated_description>Leverage</row_formated_description>
                        <row_lang_key>7541</row_lang_key>
                        <row_order>60</row_order>
                    </item>
                </financial_statements>
            </GetClassifiersFinancialStatementsResponse>
        </ns1:GetClassifiersFinancialStatementsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetLegalForms>
            <GetLegalFormsRequest/>
        </ns0:GetLegalForms>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:GetLegalFormsResponse>
            <GetLegalFormsResponse>
                <legal_forms>
                    <item>
                        <country>BLR</country>
                        <language>RUS</language>
                        <legal_form>Крестьянское (фермерское) хозяйство</legal_form>
                        <lang_key>268</lang_key>
                    </item>
                    <item>
                        <country>BLR</country>
                        <language>RUS</language>
                        <legal_form>Крестьянское хозяйство</legal_form>
                        <lang_key>268</lang_key>
                    </item>
                    <item>
                        <country>UKR</country>
                        <language>UKR</language>
                        <legal_form>Споживчий кооператив</legal_form>
                        <lang_key>264</lang_key>
                    </item>
                     <item>
                        <country>RUS</country>
                        <language>RUS</language>
                        <legal_form>АКЦИОНЕРНОЕ ОБЩЕСТВО</legal_form>
                        <lang_key>263</lang_key>
                    </item>
                </legal_forms>
            </GetLegalFormsResponse>
        </ns1:GetLegalFormsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
機能 GetActivityClassificators

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetActivityClassificators>
            <GetActivityClassificatorsRequest>
                <classificator_type>CLASSIFICATOR_TYPE</classificator_type>
            </GetActivityClassificatorsRequest>
        </ns0:GetActivityClassificators>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CLASSIFICATOR_TYPE:
"EMTAK 2008"
"NACE Rev.2"
"КВЕД 2005"
"КВЕД 2010"
"ОКВЭД 2"
"ОКВЭД 2007"
"SBI"

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetActivityClassificatorsResponse>
            <GetActivityClassificatorsResponse>
                <classificator_type>NACE Rev.2</classificator_type>
                <activities>
                    <item>
                        <activity_description>ACCOMMODATION AND FOOD SERVICE ACTIVITIES</activity_description>
                        <activity_code>I</activity_code>
                        <activity_language>ENG</activity_language>
                        <activity_lang_key>10673</activity_lang_key>
                    </item>
					...
                    <item>
                        <activity_description>HUMAN HEALTH AND SOCIAL WORK
                            ACTIVITIES</activity_description>
                        <activity_code>Q</activity_code>
                        <activity_language>ENG</activity_language>
                        <activity_lang_key>10858</activity_lang_key>
                    </item>
                 </activities>
            </GetActivityClassificatorsResponse>
        </ns1:GetActivityClassificatorsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
機能 GetDictionaryStandardPhrases

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetDictionaryStandardPhrases>
            <GetDictionaryStandardPhrasesRequest/>
        </ns0:GetDictionaryStandardPhrases>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetDictionaryStandardPhrasesResponse>
            <GetDictionaryStandardPhrasesResponse>
                <dictionary_standard_phrases>
                    <item>
                        <dictionary_lang_key>6612</dictionary_lang_key>
                        <dictionary_category>opinion_comment</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>Company was in a merger process and financial statements
                            after merger are not available.</dictionary_value>
                    </item>
                    <item>
                        <dictionary_lang_key>101806</dictionary_lang_key>
                        <dictionary_category>asset_subtype</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>Property intended for varied purposes</dictionary_value>
                    </item>
					...
                    <item>
                        <dictionary_lang_key>252</dictionary_lang_key>
                        <dictionary_category>town_settlement_village_type</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>district</dictionary_value>
                    </item>
                    <item>
                        <dictionary_lang_key>254</dictionary_lang_key>
                        <dictionary_category>town_settlement_village_type</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>county</dictionary_value>
                    </item>
                </dictionary_standard_phrases>
            </GetDictionaryStandardPhrasesResponse>
        </ns1:GetDictionaryStandardPhrasesResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
機能 GetAvailableProducts

delivery_term:

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

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetAvailableProducts>
            <GetAvailableProductsRequest/>
        </ns0:GetAvailableProducts>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetAvailableProductsResponse>
            <GetAvailableProductsResponse>
                <available_products>
                    <item>
                        <country>RUS</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <full_description>Full Report (Normal)</full_description>
                        <maximum_delivery_working_days>7</maximum_delivery_working_days>
                        <price>28.00</price>
                    </item>
                    <item>
                        <country>SWE</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <full_description>Full Report (Normal)</full_description>
                        <maximum_delivery_working_days>0</maximum_delivery_working_days>
                        <price>25.00</price>
                    </item>
                    <item>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <full_description>Full Report (Normal)</full_description>
                        <maximum_delivery_working_days>0</maximum_delivery_working_days>
                        <price>25.00</price>
                    </item>
                </available_products>
            </GetAvailableProductsResponse>
        </ns1:GetAvailableProductsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

考えられるエラー


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


全機能
  • 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), イギリス (GBR), イスラエル (ISR), イタリア (ITA), ウクライナ (UKR), ウズベキスタン (UZB), ウルグアイ (URY), エクアドル (ECU), エストニア (EST), エチオピア (ETH), オランダ (NLD), オーストラリア (AUS), オーストリア (AUT), カザフスタン (KAZ), カナダ (CAN), ガイアナ (GUY), ガンビア (GMB), キプロス (CYP), キルギス (KGZ), ギニア (GIN), ギリシャ (GRC), クロアチア (HRV), グアドループ (GLP), グリーンランド (GRL), グルジア (GEO), ケニア (KEN), コソボ (XXK), コンゴ共和国 (COG), コートジボワール (CIV), サモア (WSM), サンマリノ (SMR), サン・マルタン (MAF), ザンビア (ZMB), シンガポール (SGP), ジャージー島 (JEY), ジンバブエ (ZWE), スイス (CHE), スウェーデン (SWE), スペイン (ESP), スリランカ (LKA), スロバキア (SVK), スロベニア (SVN), セルビア (SRB), セーシェル (SYC), タイ (THA), タジキスタン (TJK), タンザニア (TZA), チェコ (CZE), チリ (CHL), デンマーク (DNK), トルコ (TUR), トーゴ (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), レユニオン (REU), ロシア (RUS), 中国 (CHN), 南アフリカ (ZAF), 台湾 (TWN), 日本 (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.
    このエラーは、search_result_id なしでオンラインレポートを注文しようとした場合にのみ表示されます。
    OrderReportRequest では order_details_by_id を使用することが重要です
  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), az (Azerbaijani), bg (ブルガリア語), cs (チェコ), da (デンマーク語), de (ドイツ語), el (ギリシャ語), en (イングリッシュ), es (スパニッシュ), et (エストニア語), fi (フィンランド語), fr (フランス語), he (Hebrew), hi (Hindi), hu (ハンガリー語), hy (Armenian), id (インドネシア語), it (イタリア語), ja (日本語), ka (Georgian), kk (Kazakh), ko (韓国語), lt (リトアニア語), lv (ラトビア語), mn (Mongolian), ms (Malay), nb (ノルウェー語ブークモール), nl (オランダ語), pl (ポーランド語), pt (ポルトガル語), ro (ルーマニア語), ru (ロシア語), sk (スロバキア語), sl (スロベニア語), sr (Српски), sv (スウェーデン), th (Thai), tr (トルコ語), uk (ウクライナ語), uz (Uzbek), 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

既存セクションの更新

beneficiariesshareholdersmanagers 、および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
  • 今後の追加予定:patentsbiological_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に送信する。

これがペイロードの例だ:
新しい注文ステータスのペイロード例

                {
                    "event_type": "new_status",
                    "order_id": 12345,
                    "client_ref_number": "98765",
                    "new_status": "Finished"
                    "reason": "..." # Optional, an example here could be the reason for the "Rejected" status
                }
            
"new_status" フィールドの取り得る値:
  • "Finished" - 注文が完了しました。注文の受け取り;
  • "Updated" - 注文が更新され、完了した注文にデータが追加された。;
  • "Canceled" - 顧客の要求(または同意)により注文がキャンセルされた場合。;
  • "Rejected" - 注文が拒否される。通常、会社を特定することは不可能だからだ。.
  • "Identification pending" - ご注文の準備には、お客様からさらに情報が必要です。.

Webhookの保護

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

シグネチャー

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

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


                #!/bin/bash

                payload='{"key1": "value1","key2": "value2"}'
                secret='$app_id$secret_key'

                # Generate HMAC SHA512 signature
                signature=$(echo -n "$payload" | openssl dgst -sha512 -hmac "$secret" | awk '{print $2}')

                # Send request
                curl -X POST \
                  -H "Content-Type: application/json" \
                  -H "X-Signature: $signature" \
                  -d "$payload" \
                  https://example.com/api/endpoint
            

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


                https://example.com/api/endpoint?custom_token=c3606e43c40d4556b64a4ad8c72f554e
            

トラブルシューティング

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