Infoproff API文档 - v2

开关版 V2

入门

网络服务wsdl和模式位于这里:

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

网络服务的主要功能:

  • 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)

下面你可以找到这个例子:

第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") ，你可以使用为每个国家生成的样本（使用：注册代码 "000000"）。这些报告是免费的，可以使用测试账户订购。
功能 Order
功能 OrderCancellation

第2步。订单确认

功能 OrderConfirmation

第3步：状态检查

功能 ChkStatus

第4步：获取报告

在线报告的可用语言列表: 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. 您不能订购具有法律形式的公司的报告："法律形式
    这个错误只适用于: 瑞典王国 (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"）时，需要 "企业名称 "或 "注册代码"。
  5. 在线交货时需要注册码
    当订购在线报告（delivery_term = "o"）时，需要 "Reg Code"。
功能 GetReport
  1. 不支持该语言。
    在线报告的可用语言列表: en (English), et (Estonian), ru (Russian), de (German)
职能 GetReport ChkStatus
  1. 订单号不正确。
    找不到订单ID。当你使用Order 功能时，你会得到订单ID。
功能 OrderCancellation
  1. Your order is already canceled.
    你没有权限取消订单了。
功能 OrderConfirmation
  1. 您已无权确认订单。 确认可在收到 "order_id "后一小时内完成。

与 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"，然后才能下在线（delivery_term = 'o'）订单。

- 更改可提供在线信用报告的国家列表: 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