Infoproff API ドキュメント - v2

スイッチ版 V2

はじめに

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

http://wsdfn.infoproff.com/v2/

Webサービスの主な機能:

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

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

  1. 以下の国のオンライン信用調査。 フィンランド共和国 (FIN), スウェーデン王国 (SWE)
  2. 以下の国のオフラインレポート。 すべての国
  3. クレジットオピニオン計算機

会社を探すには？

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

  1. 会社名で検索,
  2. 登録コードで検索.
利用可能な国の一覧: フィンランド共和国 (FIN), スウェーデン王国 (SWE), ノルウェー王国 (NOR), デンマーク王国 (DNK)
重要なお知らせ:
ノルウェーの登記簿では、削除された会社の名前で検索することはできません。従って、ノルウェーの削除された会社の中から名前によるSimpleSearch を提供することはできません。
Field's length:
company_name varchar(512)
company_code varchar(64)

以下は、その例です。:

機能 SimpleSearch

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

機能 SimpleSearch

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

登録から報告書の受領までの順序は以下の通りです。:

  1. ユーザーは、新しい注文を登録する（機能「注文」）。システムは注文の詳細、過去60日間に行われた重複注文のリストを返し、注文の確認を待ちます。
  2. ユーザーは注文を確認する（機能 "OrderConfirmation"）。システムは注文を生産のために送信し、現在の生産状況を返す。
  3. ユーザは注文状況を確認する（機能「ChkStatus」）。
  4. 注文の準備ができた場合、ユーザーはレポートをダウンロードすることができます（関数 "GetReport"）。
利用可能な国の一覧: フィンランド共和国 (FIN), スウェーデン王国 (SWE)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

以下は、その例です。:

STEP 1: レポートを注文する

注文確認のステップを不要と考えるユーザーは、要素"confirm_order" を使用し、値"TRUE" を渡すことができる。

通常、オンラインモードでの信用情報作成には10～20秒程度かかります。
したがって、オンライン・レポートの場合は、5秒以上ごとにチェックを行う必要があります。

テストアカウントで利用可能な企業の一覧です。

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
また、オンラインレポート(delivery_term = "o") では、国ごとに作成されたサンプルをご利用いただけます（使用方法：登録コード "00000000"）。これらのレポートは無料で、テストアカウントを使用して注文することができます。
機能 Order
機能 OrderCancellation

STEP 2.ご注文の確認

機能 OrderConfirmation

STEP3.状態確認

機能 ChkStatus

STEP4.レポート取得

Onlineレポートで使用できる言語の一覧: en (English), et (Estonian), ru (Russian), de (German)
オンラインレポート（pdf）のダウンロードはまだ行っておりません。
機能 GetReport

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

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

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

オフラインレポートのダウンロード方法は？

オフラインレポートを直接ダウンロードすることができます。ここでは、その方法を説明します。

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

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

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

機能 CreditOpinionCalculator

追加情報を得るには？

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

考えられるエラー

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

全機能
  • ユーザー名/パスワードが間違っているか、権限がありません。
    間違った認証情報を入力しているか、APIアクセスがブロックされています。
機能 SimpleSearch
  1. この国では捜索許可はない。
    利用可能な国の一覧: フィンランド共和国 (FIN), スウェーデン王国 (SWE)
機能 Order
  1. この製品はご利用いただけません。
    そのような製品は見つからず、注文することはできません。
  2. 法的形式を持つ会社に関する報告書は注文できません："legal_form"
    このエラーは、以下の場合にのみ適用されます。: スウェーデン王国 (SWE)
    スウェーデンでは、オンラインレポート（delivery_term = "o"）と次の法的書式を一緒に注文することは不可能です。
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. この会社はテストリストにない。
    会社の登録コードはテストリストにありません。
    テストアカウントで利用可能な企業の一覧です。
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. 事業所名または事業所コードが必要です。
    オフラインレポート（delivery_term = "n", "f" or "s"）を注文する場合、"Business Name" または "Reg Code "が必要です。
  5. お届け先がオンラインの場合、レジコードが必要です。
    オンラインレポート（delivery_term = "o"）をご注文の際は、"Reg Code "が必要です。
機能 GetReport
  1. この言語はサポートされていません。
    Onlineレポートで使用できる言語の一覧: en (English), et (Estonian), ru (Russian), de (German)
機能 GetReport ChkStatus
  1. order_idが正しくありません。
    オーダーIDが見つかりません。Order 関数を使用すると、オーダー ID を取得できます。
機能 OrderCancellation
  1. Your order is already canceled.
    もう注文をキャンセルする権限はないんですね。
機能 OrderConfirmation
  1. もう注文を確認する許可はありません。 確認は'order_id'を受け取ってから1時間以内に行うことができます。

SOAP（バージョン2）と比較したSOAP（バージョン3）の変更点

SOAP（バージョン2）と比較したSOAP（バージョン3）の変更点 [概要]

1) 新機能: ChkFinance

Allows you to search for available financial statements.
Currently available only in EST (Estonia), SWE (Sweden)

2) 機能: SimpleSearch

- Changes in list of available countries: Finland (FIN), Sweden (SWE), Norway (NOR), Denmark (DNK), Belgium (BEL), Estonia (EST), Netherlands (NLD), United Kingdom (GBR), Ireland (IRL), France (FRA), Spain (ESP), Portugal (PRT), Germany (DEU), Italy (ITA), Austria (AUT), Switzerland (CHE), Cyprus (CYP)

- Each time you place an request we asaign a new 'search_result_id' for each company. You need to use this 'search_result_id' to place online orders.

Also you can place offline (delivery_term = 'n', 'f' or 's') orders with 'search_result_id', if you desire.

3) 機能: Order
Identification is required!

オンライン注文をするには、関数'SimpleSearch'から'search_result_id'を受け取る必要があります。

- オンライン信用報告書の利用可能国リストの変更: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- オンライン・モードで財務諸表をダウンロード可能（製品：財務を使用: Estonia (EST), Sweden (SWE)

3) 機能: GetReport

- Changes in of available languages: en (English), et (Estonian), ru (Russian), de (German), zh (Chinese), ja (Japanese), bg (Bulgarian), cs (Czech), da (Danish), el (Greek), fi (Finnish), fr (French), hu (Hungarian), it (Italian), lv (Latvian), lt (Lithuanian), nl (Dutch), pl (Polish), pt (Portuguese), ro (Romanian), sk (Slovak), sl (Slovenian), es (Spanish), sv (Swedish)


SOAP（バージョン2）と比較したSOAP（バージョン3）の変更点 [WSDL and XSD]

File: report.xsd

新要素:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

新機能:

- ChkFinance

Function that allows you to search for available financial statements.

NB: This function is only needed when ordering a product: finances (Financial statements) with delivery_term = 'o'.
File: order.xsd

1) OrderReportRequest has a choice:

- order_details:

Using general information: business_name, reg_code, vat_code, address, phone, email, additional_info

NB:
* Business Name or Registration Code is required
* Only for orders with delivery_term: 'n', 'f' and 's' (credit reports in offline mode)

- order_details_by_id:

Using 'search_result_id'

NB:
* 'search_result_id' can be obtained with function: 'SimpleSearch'
* each new search generates new 'search_result_id'

2) order_details

新要素:

- preferable_finances

NB: This element is required only ordering a product: finances (Financial statements) with delivery_term = 'o'.

3) SimpleSearchRequest

削除された要素:

search_block.reg_code

新要素:

search_block->company_code

NB: in some countries we allow to search companies by vat_code.

4) SimpleSearchResponse

削除された要素

- code

新要素:

  • - search_result_id (is required for order with delivery_term = 'o')
  • - name_transliteration
  • - reg_code
  • - vat_code
  • - unified_legal_form