Infoproff API文档 - v4


入门


网络服务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 标头是首选且推荐的方式。

username 对应 App IDpassword 为关联的 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. 以下国家的在线信用报告。 中国 (CHN), 丹麦 (DNK), 乌克兰 (UKR), 俄罗斯 (RUS), 保加利亚 (BGR), 克罗地亚 (HRV), 匈牙利 (HUN), 卢森堡 (LUX), 吉尔吉斯斯坦 (KGZ), 哈萨克斯坦 (KAZ), 奥地利 (AUT), 希腊 (GRC), 德国 (DEU), 意大利 (ITA), 拉脱维亚 (LVA), 挪威 (NOR), 捷克 (CZE), 摩尔多瓦 (MDA), 斯洛伐克 (SVK), 斯洛文尼亚 (SVN), 比利时 (BEL), 法国 (FRA), 波兰 (POL), 爱尔兰 (IRL), 爱沙尼亚 (EST), 瑞典 (SWE), 瑞士 (CHE), 芬兰 (FIN), 英国 (GBR), 荷兰 (NLD), 葡萄牙 (PRT), 蒙古 (MNG), 西班牙 (ESP), 阿塞拜疆 (AZE), 马耳他 (MLT)
  2. 以下国家的离线报告。 所有国家
  3. 信用意见计算器
  4. 公司搜索

如何搜索一个公司?


公司搜索包括2个选项:

  1. 按公司名称搜索,
  2. 按公司代码搜索.
可用的国家名单: 中华民国 (TWN), 中国 (CHN), 丹麦 (DNK), 乌克兰 (UKR), 乌兹别克斯坦 (UZB), 乌拉圭 (URY), 乔治亚 (GEO), 以色列 (ISR), 俄罗斯 (RUS), 保加利亚 (BGR), 克罗地亚 (HRV), 冈比亚 (GMB), 冰岛 (ISL), 几内亚 (GIN), 列支敦士登 (LIE), 刚果(布) (COG), 加拿大 (CAN), 匈牙利 (HUN), 南非 (ZAF), 博茨瓦纳 (BWA), 卢旺达 (RWA), 卢森堡 (LUX), 厄瓜多尔 (ECU), 吉尔吉斯斯坦 (KGZ), 哈萨克斯坦 (KAZ), 土耳其 (TUR), 圣马丁 (MAF), 圣马力诺 (SMR), 圭亚那 (GUY), 坦桑尼亚 (TZA), 埃塞俄比亚 (ETH), 塔吉克斯坦 (TJK), 塞尔维亚 (SRB), 塞浦路斯 (CYP), 塞舌尔 (SYC), 多哥 (TGO), 奥地利 (AUT), 委内瑞拉 (VEN), 安哥拉 (AGO), 尼日利亚 (NGA), 巴拉圭 (PRY), 巴西 (BRA), 希腊 (GRC), 德国 (DEU), 意大利 (ITA), 拉脱维亚 (LVA), 挪威 (NOR), 捷克 (CZE), 摩尔多瓦 (MDA), 摩洛哥 (MAR), 摩纳哥 (MCO), 斯洛伐克 (SVK), 斯洛文尼亚 (SVN), 斯里兰卡 (LKA), 新加坡 (SGP), 新西兰 (NZL), 日本 (JPN), 智利 (CHL), 格陵兰 (GRL), 比利时 (BEL), 毛里求斯 (MUS), 法国 (FRA), 法属圭亚那 (GUF), 波兰 (POL), 波黑 (BIH), 泰国 (THA), 泽西岛 (JEY), 津巴布韦 (ZWE), 澳大利亚 (AUS), 爱尔兰 (IRL), 爱沙尼亚 (EST), 玻利维亚 (BOL), 瑞典 (SWE), 瑞士 (CHE), 瓜德罗普 (GLP), 留尼汪 (REU), 白俄罗斯 (BLR), 科特迪瓦 (CIV), 科索沃 (XXK), 秘鲁 (PER), 立陶宛 (LTU), 纳米比亚 (NAM), 罗马尼亚 (ROU), 肯尼亚 (KEN), 芬兰 (FIN), 英国 (GBR), 荷兰 (NLD), 菲律宾 (PHL), 萨摩亚 (WSM), 葡萄牙 (PRT), 蒙古 (MNG), 西班牙 (ESP), 贝宁 (BEN), 赞比亚 (ZMB), 阿塞拜疆 (AZE), 阿尔及利亚 (DZA), 阿尔巴尼亚 (ALB), 阿根廷 (ARG), 香港 (HKG), 马尔代夫 (MDV), 马恩岛 (IMN), 马提尼克 (MTQ), 马约特 (MYT), 马耳他 (MLT), 马达加斯加 (MDG)

其他国家的搜索仅在已归档报告数据库中进行。如果未找到所需公司,请手动输入公司详情。

重要信息:

对于 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>

如何订购信用报告?


在线信用报告可用国家列表: 中国 (CHN), 丹麦 (DNK), 乌克兰 (UKR), 俄罗斯 (RUS), 保加利亚 (BGR), 克罗地亚 (HRV), 匈牙利 (HUN), 卢森堡 (LUX), 吉尔吉斯斯坦 (KGZ), 哈萨克斯坦 (KAZ), 奥地利 (AUT), 希腊 (GRC), 德国 (DEU), 意大利 (ITA), 拉脱维亚 (LVA), 挪威 (NOR), 捷克 (CZE), 摩尔多瓦 (MDA), 斯洛伐克 (SVK), 斯洛文尼亚 (SVN), 比利时 (BEL), 法国 (FRA), 波兰 (POL), 爱尔兰 (IRL), 爱沙尼亚 (EST), 瑞典 (SWE), 瑞士 (CHE), 芬兰 (FIN), 英国 (GBR), 荷兰 (NLD), 葡萄牙 (PRT), 蒙古 (MNG), 西班牙 (ESP), 阿塞拜疆 (AZE), 马耳他 (MLT)
字段长度:
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>

以下是用于报告的状态:

  • 正在进行中 - 生产阶段的报告
  • 待识别 - 报告准备工作暂停。需要客户提供更多数据。
  • 已取消 - 取消的订单
  • 已完成 - 报告已经准备好了
  • 已更新 - 在完成的报告中加入了信息
  • 已拒绝 - 订单已拒绝(资金不足、订单信息不正确或其他原因)。
  • 技术错误 - 我们的系统发生了一个技术错误。这意味着,我们已被告知这一错误,并将尽快修复它。您将被告知何时能够收到订单。

如果执行状态为 FinishedUpdated,您可以获取订单。

步骤 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>

以下是用于报告的状态:

  • 正在进行中 - 生产阶段的报告
  • 待识别 - 报告准备工作暂停。需要客户提供更多数据。
  • 已取消 - 取消的订单
  • 已完成 - 报告已经准备好了
  • 已更新 - 在完成的报告中加入了信息
  • 已拒绝 - 订单已拒绝(资金不足、订单信息不正确或其他原因)。
  • 技术错误 - 我们的系统发生了一个技术错误。这意味着,我们已被告知这一错误,并将尽快修复它。您将被告知何时能够收到订单。

如果执行状态为 FinishedUpdated,您可以获取订单。

步骤 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 秒检查一次订单状态是可接受的频率。

以下是用于报告的状态:

  • 正在进行中 - 生产阶段的报告
  • 待识别 - 报告准备工作暂停。需要客户提供更多数据。
  • 已取消 - 取消的订单
  • 已完成 - 报告已经准备好了
  • 已更新 - 在完成的报告中加入了信息
  • 已拒绝 - 订单已拒绝(资金不足、订单信息不正确或其他原因)。
  • 技术错误 - 我们的系统发生了一个技术错误。这意味着,我们已被告知这一错误,并将尽快修复它。您将被告知何时能够收到订单。

如果执行状态为 FinishedUpdated,您可以获取订单。

要查看 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.
    可用的国家名单: 中华民国 (TWN), 中国 (CHN), 丹麦 (DNK), 乌克兰 (UKR), 乌兹别克斯坦 (UZB), 乌拉圭 (URY), 乔治亚 (GEO), 以色列 (ISR), 俄罗斯 (RUS), 保加利亚 (BGR), 克罗地亚 (HRV), 冈比亚 (GMB), 冰岛 (ISL), 几内亚 (GIN), 列支敦士登 (LIE), 刚果(布) (COG), 加拿大 (CAN), 匈牙利 (HUN), 南非 (ZAF), 博茨瓦纳 (BWA), 卢旺达 (RWA), 卢森堡 (LUX), 厄瓜多尔 (ECU), 吉尔吉斯斯坦 (KGZ), 哈萨克斯坦 (KAZ), 土耳其 (TUR), 圣马丁 (MAF), 圣马力诺 (SMR), 圭亚那 (GUY), 坦桑尼亚 (TZA), 埃塞俄比亚 (ETH), 塔吉克斯坦 (TJK), 塞尔维亚 (SRB), 塞浦路斯 (CYP), 塞舌尔 (SYC), 多哥 (TGO), 奥地利 (AUT), 委内瑞拉 (VEN), 安哥拉 (AGO), 尼日利亚 (NGA), 巴拉圭 (PRY), 巴西 (BRA), 希腊 (GRC), 德国 (DEU), 意大利 (ITA), 拉脱维亚 (LVA), 挪威 (NOR), 捷克 (CZE), 摩尔多瓦 (MDA), 摩洛哥 (MAR), 摩纳哥 (MCO), 斯洛伐克 (SVK), 斯洛文尼亚 (SVN), 斯里兰卡 (LKA), 新加坡 (SGP), 新西兰 (NZL), 日本 (JPN), 智利 (CHL), 格陵兰 (GRL), 比利时 (BEL), 毛里求斯 (MUS), 法国 (FRA), 法属圭亚那 (GUF), 波兰 (POL), 波黑 (BIH), 泰国 (THA), 泽西岛 (JEY), 津巴布韦 (ZWE), 澳大利亚 (AUS), 爱尔兰 (IRL), 爱沙尼亚 (EST), 玻利维亚 (BOL), 瑞典 (SWE), 瑞士 (CHE), 瓜德罗普 (GLP), 留尼汪 (REU), 白俄罗斯 (BLR), 科特迪瓦 (CIV), 科索沃 (XXK), 秘鲁 (PER), 立陶宛 (LTU), 纳米比亚 (NAM), 罗马尼亚 (ROU), 肯尼亚 (KEN), 芬兰 (FIN), 英国 (GBR), 荷兰 (NLD), 菲律宾 (PHL), 萨摩亚 (WSM), 葡萄牙 (PRT), 蒙古 (MNG), 西班牙 (ESP), 贝宁 (BEN), 赞比亚 (ZMB), 阿塞拜疆 (AZE), 阿尔及利亚 (DZA), 阿尔巴尼亚 (ALB), 阿根廷 (ARG), 香港 (HKG), 马尔代夫 (MDV), 马恩岛 (IMN), 马提尼克 (MTQ), 马约特 (MYT), 马耳他 (MLT), 马达加斯加 (MDG)
功能 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")时,需要 "企业名称 "或 "注册代码"。
  5. Reg Code is required when delivery term is Online
    当订购在线报告(delivery_term = "o")时,需要 "Reg Code"。

功能 GetReport
  1. This language is not supported.
    在线报告的可用语言列表: 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

现有章节的更新

在以下部分中添加了以下元素:beneficiariesshareholdersmanagersemployees_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 表示该值是基于可用数据通过逻辑或人工智能计算得出的估计值。
branches_data 部分,新增了以下字段:
  • registration_number
  • director_name

注意:在稳定阶段,可能还会进行一些小的改进和调整。

Webhooks Settings


概述

网络钩子是应用程序向其他应用程序提供实时信息的一种方式。我们的网络钩子功能通过配置 URL 实现 HTTP 回调。每当指定事件发生时,就会以 JSON 格式向该 URL 发送 HTTP POST 有效载荷。在我们的项目中,我们设计了 Webhook 功能来触发特定事件。

设置 Webhook

要为应用程序设置网络钩子,请导航至应用程序设置页面并查找 "网络钩子设置 "部分。并提供以下信息:

  1. "Webhook URL "是服务器接收 Webhook POST 请求的 URL。
  2. "交付最大尝试次数 "是一种设置,用于定义当初始交付尝试失败时交付 webhook 事件的最大重试尝试次数。
  3. "交付重试超时 "是一项设置,可用于指定网络钩子交付尝试失败时重试的时间间隔。

提供这些详细信息后,点击 "保存"。

Webhook 事件类型

  1. 订单的新状态

Webhook 有效载荷

事件发生时,我们将向有效载荷 URL 发送 HTTP POST 请求,请求内容为包含事件信息的 JSON 主体。

下面是一个有效载荷示例:
订单新状态的有效载荷示例

                {
                    "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 头信息。

签名说明

我们使用 HMAC 和 SHA512 算法进行签名。

Secret是网络钩子设置中的应用程序 ID密钥的连接。


                #!/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
            

如有必要,还可以在端点中添加自己的获取参数,以识别发送方。


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

故障排除

服务器必须在 10 秒内做出响应,并返回 2XX HTTP 代码;否则,网络钩子交付将被视为失败。如果失败,该功能将尝试根据交付策略重新发送请求。