Tài liệu tham khảo API Infoproff - v4

Phiên bản chuyển đổi V4

Bắt đầu

Dịch vụ web WSDL và các lược đồ được đặt tại đây.:

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

Postman Collection (API v4) — Ready for Use:

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

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

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

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

Authentification details

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

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

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

Web service functions:

  • SimpleSearch - Tìm kiếm thông tin về các công ty ở các quốc gia khác nhau.
  • ChkFinance - Tìm kiếm các báo cáo tài chính có sẵn.
  • Order - Tạo một order_id và trả về các bản sao trùng lặp. Các bản sao trùng lặp được chọn dựa trên các tham số sau: country, product, reg_code.
  • OrderCancellation - Nếu bạn đã gửi yêu cầu đặt hàng và nhận được order_id, bạn có thể hủy đơn hàng này (nếu đơn hàng chưa được đưa vào sản xuất).
  • OrderConfirmation - Sau khi nhận được order_id, bạn phải xác nhận đơn hàng trong vòng 1 giờ. Nếu bạn không xác nhận đơn hàng trong vòng 1 giờ, đơn hàng sẽ bị hủy tự động.
  • ChkStatus - Kiểm tra trạng thái đơn hàng.
  • GetReport - Nhận báo cáo hoàn chỉnh.
  • GetClassifiersFinancialStatements - Nhận tất cả các tài liệu tài chính kèm theo các trường thông tin sau: row_number, row_formated_description, row_lang_key và row_order.
  • GetLegalForms - Tải xuống tất cả các mẫu đơn pháp lý cho tất cả các quốc gia có sẵn.
  • GetActivityClassificators - Nhận tất cả mã và mô tả cho bộ phân loại hoạt động cụ thể.
  • GetDictionaryStandardPhrases - Nhận tất cả các câu mẫu tiêu chuẩn kèm theo các phím và ngôn ngữ.
  • GetAvailableProducts - Lấy danh sách các sản phẩm có sẵn.
  • CreditOpinionCalculator - Công cụ tính toán đánh giá tín dụng giúp xác định đánh giá tín dụng cho một công ty.

API cung cấp một số dịch vụ:

  1. Báo cáo tín dụng trực tuyến cho các quốc gia sau: Cộng hòa Phần Lan (FIN), Vương quốc Thụy Điển (SWE), Vương quốc Bỉ (BEL), Vương quốc Hà Lan (NLD), Cộng hòa Estonia (EST), Cộng hòa Kazakhstan (KAZ), Cộng hòa Ba Lan (POL), Cộng hòa Kyrgyzstan (KGZ), Cộng hòa Nhân dân Trung Hoa (CHN), Mông Cổ (MNG)
  2. Báo cáo ngoại tuyến cho các quốc gia sau: Tất cả các quốc gia
  3. Công cụ tính toán ý kiến tín dụng

Cách tìm kiếm một công ty?

Tìm kiếm công ty bao gồm 2 tùy chọn:

  1. Tìm kiếm theo tên công ty,
  2. Search by company code.
Danh sách các quốc gia có sẵn: Bosnia và Herzegovina (BIH), Bờ Biển Ngà (CIV), Canada (CAN), Công quốc Liechtenstein (LIE), Công quốc Monaco (MCO), Cộng hòa Albania (ALB), Cộng hòa Angola (AGO), Cộng hòa Argentina (ARG), Cộng hòa Azerbaijan (AZE), Cộng hòa Ba Lan (POL), Cộng hòa Belarus (BLR), Cộng hòa Benin (BEN), Cộng hòa Bolivar Venezuela (VEN), Cộng hòa Botswana (BWA), Cộng hòa Bulgaria (BGR), Cộng hòa Bồ Đào Nha (PRT), Cộng hòa Chile (CHL), Cộng hòa Congo (COG), Cộng hòa Croatia (HRV), Cộng hòa Dân chủ Liên bang Ethiopia (ETH), Cộng hòa Dân chủ Nhân dân Algeria (DZA), Cộng hòa Ecuador (ECU), Cộng hòa Estonia (EST), Cộng hòa Gambia (GMB), Cộng hòa Guinea (GIN), Cộng hòa Hungary (HUN), Cộng hòa Hy Lạp (GRC), Cộng hòa Hợp tác Guyana (GUY), Cộng hòa Iceland (ISL), Cộng hòa Kazakhstan (KAZ), Cộng hòa Kenya (KEN), Cộng hòa Kyrgyzstan (KGZ), Cộng hòa Latvia (LVA), Cộng hòa Litva (LTU), Cộng hòa Liên bang Brazil (BRA), Cộng hòa Liên bang Nigeria (NGA), Cộng hòa Liên bang Tanzania (TZA), Cộng hòa Liên bang Đức (DEU), Cộng hòa Madagascar (MDG), Cộng hòa Maldives (MDV), Cộng hòa Malta (MLT), Cộng hòa Mauritius (MUS), Cộng hòa Moldova (MDA), Cộng hòa Nam Phi (ZAF), Cộng hòa Namibia (NAM), Cộng hòa Nhân dân Trung Hoa (CHN), Cộng hòa Paraguay (PRY), Cộng hòa Peru (PER), Cộng hòa Philippines (PHL), Cộng hòa Pháp (FRA), Cộng hòa Phần Lan (FIN), Cộng hòa Rwanda (RWA), Cộng hòa San Marino (SMR), Cộng hòa Serbia (SRB), Cộng hòa Seychelles (SYC), Cộng hòa Singapore (SGP), Cộng hòa Slovakia (SVK), Cộng hòa Slovenia (SVN), Cộng hòa Séc (CZE), Cộng hòa Síp (CYP), Cộng hòa Tajikistan (TJK), Cộng hòa Togo (TGO), Cộng hòa Trung Hoa (TWN), Cộng hòa Uzbekistan (UZB), Cộng hòa Xã hội Chủ nghĩa Dân chủ Sri Lanka (LKA), Cộng hòa Zambia (ZMB), Cộng hòa Zimbabwe (ZWE), Cộng hòa Áo (AUT), Cộng hòa Ý (ITA), Cộng hòa Đông Uruguay (URY), Cộng đồng Saint Martin (MAF), Georgia (GEO), Greenland (GRL), Guadeloupe (GLP), Guiana thuộc Pháp (GUF), Gặp lại (REU), Hồng Kông (HKG), Ireland (IRL), Kosovo (XXK), Liên bang Nga (RUS), Liên bang Thụy Sĩ (CHE), Liên bang Úc (AUS), Lãnh địa Jersey (JEY), Martinique (MTQ), Mayotte (MYT), Mông Cổ (MNG), New Zealand (NZL), Nhà nước Israel (ISR), Nhà nước đa dân tộc Bolivia (BOL), Nhật Bản (JPN), Quốc gia độc lập Samoa (WSM), Romania (ROU), Vương quốc Bỉ (BEL), Vương quốc Hà Lan (NLD), Vương quốc Liên hiệp Anh và Bắc Ireland (GBR), Vương quốc Maroc (MAR), Vương quốc Na Uy (NOR), Vương quốc Thái Lan (THA), Vương quốc Thụy Điển (SWE), Vương quốc Tây Ban Nha (ESP), Vương quốc Đan Mạch (DNK), Đại công quốc Luxembourg (LUX), Đảo Man (IMN)

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

Thông tin quan trọng:

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

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

Hệ thống đăng ký doanh nghiệp của Na Uy không cho phép tìm kiếm các công ty đã bị xóa theo tên. Do đó, chúng tôi không thể cung cấp tính năng SimpleSearch theo tên trong danh sách các công ty đã bị xóa tại Na Uy.

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

Dưới đây là ví dụ:

Chức năng SimpleSearch

Tùy chọn 2: Tìm kiếm theo mã đăng ký

Chức năng SimpleSearch

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

Chức năng UnifiedSearch

Cách đặt hàng báo cáo tín dụng?

List of available countries for online credit reports: Cộng hòa Azerbaijan (AZE), Cộng hòa Ba Lan (POL), Cộng hòa Bulgaria (BGR), Cộng hòa Bồ Đào Nha (PRT), Cộng hòa Croatia (HRV), Cộng hòa Estonia (EST), Cộng hòa Hungary (HUN), Cộng hòa Hy Lạp (GRC), Cộng hòa Kazakhstan (KAZ), Cộng hòa Kyrgyzstan (KGZ), Cộng hòa Latvia (LVA), Cộng hòa Liên bang Đức (DEU), Cộng hòa Malta (MLT), Cộng hòa Moldova (MDA), Cộng hòa Nhân dân Trung Hoa (CHN), Cộng hòa Pháp (FRA), Cộng hòa Phần Lan (FIN), Cộng hòa Slovakia (SVK), Cộng hòa Slovenia (SVN), Cộng hòa Séc (CZE), Cộng hòa Áo (AUT), Cộng hòa Ý (ITA), Ireland (IRL), Liên bang Nga (RUS), Liên bang Thụy Sĩ (CHE), Mông Cổ (MNG), Vương quốc Bỉ (BEL), Vương quốc Hà Lan (NLD), Vương quốc Liên hiệp Anh và Bắc Ireland (GBR), Vương quốc Na Uy (NOR), Vương quốc Thụy Điển (SWE), Vương quốc Tây Ban Nha (ESP), Vương quốc Đan Mạch (DNK), Đại công quốc Luxembourg (LUX)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

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

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

Chức năng SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Cách tìm kiếm một công ty?

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

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

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

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

Chức năng OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

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

Chức năng OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

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

Chức năng ChkStatus
  • - For offline orders checking order status once every 30 minutes is acceptable frequency.
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

Các trạng thái sau đây được sử dụng cho báo cáo:

  • Đang tiến hành - Báo cáo tại giai đoạn sản xuất
  • Identification pending - Việc chuẩn bị báo cáo đang tạm hoãn. Cần thêm dữ liệu từ khách hàng.
  • Canceled - Đơn hàng bị hủy
  • Finished - Báo cáo đã sẵn sàng.
  • Updated - Thông tin đã được bổ sung vào báo cáo hoàn chỉnh.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Một lỗi kỹ thuật đã xảy ra trong hệ thống của chúng tôi. Điều này có nghĩa là chúng tôi đã được thông báo về lỗi này và sẽ khắc phục nó ngay lập tức. Quý khách sẽ được thông báo khi có thể nhận được đơn hàng.

Nếu trạng thái thực thi là {hoàn thành} hoặc {cập nhật}, thì bạn có thể nhận đơn hàng.

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

Chức năng GetReport
Danh sách các ngôn ngữ có sẵn: ar (Arabic), bg (Bulgaria), cs (Séc), da (Đan Mạch), de (Đức), el (Hy Lạp), en (Tiếng Anh), es (Tiếng Tây Ban Nha), et (Estonia), fi (Phần Lan), fr (Pháp), he (Hebrew), hu (Hungary), id (Indonesia), it (Ý), ja (Nhật Bản), ko (Hàn Quốc), lt (Litva), lv (Latvia), nb (Tiếng Na Uy (Bokmål)), nl (Hà Lan), pl (Ba Lan), pt (Bồ Đào Nha), ro (Rumani), ru (Nga), sk (Slovakia), sl (Slovenia), sr (Српски), sv (Thụy Điển), th (Thai), tr (Thổ Nhĩ Kỳ), uk (Ukraine), vi (Vietnamese), zh (Trung Quốc)

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

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

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

Chức năng OrderCancellation
If you wish to cancel the order, you can use OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

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

Chức năng OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

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

Chức năng ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

Các trạng thái sau đây được sử dụng cho báo cáo:

  • Đang tiến hành - Báo cáo tại giai đoạn sản xuất
  • Identification pending - Việc chuẩn bị báo cáo đang tạm hoãn. Cần thêm dữ liệu từ khách hàng.
  • Canceled - Đơn hàng bị hủy
  • Finished - Báo cáo đã sẵn sàng.
  • Updated - Thông tin đã được bổ sung vào báo cáo hoàn chỉnh.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Một lỗi kỹ thuật đã xảy ra trong hệ thống của chúng tôi. Điều này có nghĩa là chúng tôi đã được thông báo về lỗi này và sẽ khắc phục nó ngay lập tức. Quý khách sẽ được thông báo khi có thể nhận được đơn hàng.

Nếu trạng thái thực thi là {hoàn thành} hoặc {cập nhật}, thì bạn có thể nhận đơn hàng.

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

Chức năng GetReport
Danh sách các ngôn ngữ có sẵn: ar (Arabic), bg (Bulgaria), cs (Séc), da (Đan Mạch), de (Đức), el (Hy Lạp), en (Tiếng Anh), es (Tiếng Tây Ban Nha), et (Estonia), fi (Phần Lan), fr (Pháp), he (Hebrew), hu (Hungary), id (Indonesia), it (Ý), ja (Nhật Bản), ko (Hàn Quốc), lt (Litva), lv (Latvia), nb (Tiếng Na Uy (Bokmål)), nl (Hà Lan), pl (Ba Lan), pt (Bồ Đào Nha), ro (Rumani), ru (Nga), sk (Slovakia), sl (Slovenia), sr (Српски), sv (Thụy Điển), th (Thai), tr (Thổ Nhĩ Kỳ), uk (Ukraine), vi (Vietnamese), zh (Trung Quốc)

Làm thế nào để yêu cầu báo cáo tín dụng đã lưu trữ?

Purchase of an archived report is available for all countries.

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

STEP 1: Find a company

Chức năng SimpleSearch

To order an archived report you need to receive "<search_result_id>" which has an "<archived_reports>" section that contains a product you need.
To do so, please follow the link: Cách tìm kiếm một công ty?

Example companies with archived reports:

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

STEP 2: Order a report

Chức năng Order

STEP 3: Order cancellation (Optional)

Just like the online/offline reports.

STEP 4: Order confirmation

Just like the online/offline reports.

STEP 5: Check order status

Just like the online/offline reports.

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

STEP 6: Get report

Just like the online/offline reports.

Cách đặt hàng báo cáo tài chính trực tuyến?

STEP 1: Find a company

Chức năng SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Cách tìm kiếm một công ty?

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

STEP 2: Tìm kiếm các báo cáo tài chính có sẵn

Chức năng ChkFinance

Chức năng này chỉ cần thiết khi đặt hàng sản phẩm: finances (Financial statements) với delivery_term = 'o'.

Danh sách các quốc gia có sẵn: Cộng hòa Estonia (EST), Vương quốc Thụy Điển (SWE)

STEP 3: Yêu cầu báo cáo tài chính

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

STEP 4: Order cancellation (Optional)

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

STEP 5: Order confirmation

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

STEP 6: Check order status

Chức năng ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

Các trạng thái sau đây được sử dụng cho báo cáo:

  • Đang tiến hành - Báo cáo tại giai đoạn sản xuất
  • Identification pending - Việc chuẩn bị báo cáo đang tạm hoãn. Cần thêm dữ liệu từ khách hàng.
  • Canceled - Đơn hàng bị hủy
  • Finished - Báo cáo đã sẵn sàng.
  • Updated - Thông tin đã được bổ sung vào báo cáo hoàn chỉnh.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Một lỗi kỹ thuật đã xảy ra trong hệ thống của chúng tôi. Điều này có nghĩa là chúng tôi đã được thông báo về lỗi này và sẽ khắc phục nó ngay lập tức. Quý khách sẽ được thông báo khi có thể nhận được đơn hàng.

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

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

STEP 7: Get report

Chức năng GetReport
Danh sách các ngôn ngữ có sẵn: ar (Arabic), bg (Bulgaria), cs (Séc), da (Đan Mạch), de (Đức), el (Hy Lạp), en (Tiếng Anh), es (Tiếng Tây Ban Nha), et (Estonia), fi (Phần Lan), fr (Pháp), he (Hebrew), hu (Hungary), id (Indonesia), it (Ý), ja (Nhật Bản), ko (Hàn Quốc), lt (Litva), lv (Latvia), nb (Tiếng Na Uy (Bokmål)), nl (Hà Lan), pl (Ba Lan), pt (Bồ Đào Nha), ro (Rumani), ru (Nga), sk (Slovakia), sl (Slovenia), sr (Српски), sv (Thụy Điển), th (Thai), tr (Thổ Nhĩ Kỳ), uk (Ukraine), vi (Vietnamese), zh (Trung Quốc)
To see the examples of xml request/response, please follow the link: How to get finished order?

Cách tải xuống các báo cáo tiêu chuẩn (ở các định dạng khác ngoài XML)?

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

Yêu cầu bao gồm 3 phần:

  1. Phần cố định https://www.infoproff.com/en/orders/files/
  2. Mã băm duy nhất của bạn, mà chúng tôi cung cấp như một phản hồi.
  3. And fixed part at the end /report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
https://www.infoproff.com/en/orders/files/<order_hash>/report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
lang: en, et, ru, lv, ar, bg, cs, da, de, el, fi, fr, he, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, vi, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - Bản gốc (không đổi), 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

Cách tải xuống các sản phẩm không tiêu chuẩn?

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

Yêu cầu bao gồm 3 phần:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Mã băm duy nhất của bạn, mà chúng tôi cung cấp như một phản hồi.
  3. Và phần cố định ở cuối /download

Làm thế nào để nhận được ý kiến tín dụng?

Chức năng CreditOpinionCalculator

Làm thế nào để có thêm thông tin?

Chức năng GetClassifiersFinancialStatements
Chức năng GetActivityClassificators
Chức năng GetDictionaryStandardPhrases
Chức năng GetAvailableProducts

delivery_term:

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

Các lỗi có thể xảy ra

Các lỗi này có thể xảy ra khi thực hiện yêu cầu đến dịch vụ web của chúng tôi..

Tất cả các chức năng
  • Incorrect username/password or you have no permissions.
    Bạn đang nhập thông tin đăng nhập sai hoặc quyền truy cập API của bạn bị chặn.
Chức năng SimpleSearch
  1. You don't have permissions to search in this country.
    Danh sách các quốc gia có sẵn: Bosnia và Herzegovina (BIH), Bờ Biển Ngà (CIV), Canada (CAN), Công quốc Liechtenstein (LIE), Công quốc Monaco (MCO), Cộng hòa Albania (ALB), Cộng hòa Angola (AGO), Cộng hòa Argentina (ARG), Cộng hòa Azerbaijan (AZE), Cộng hòa Ba Lan (POL), Cộng hòa Belarus (BLR), Cộng hòa Benin (BEN), Cộng hòa Bolivar Venezuela (VEN), Cộng hòa Botswana (BWA), Cộng hòa Bulgaria (BGR), Cộng hòa Bồ Đào Nha (PRT), Cộng hòa Chile (CHL), Cộng hòa Congo (COG), Cộng hòa Croatia (HRV), Cộng hòa Dân chủ Liên bang Ethiopia (ETH), Cộng hòa Dân chủ Nhân dân Algeria (DZA), Cộng hòa Ecuador (ECU), Cộng hòa Estonia (EST), Cộng hòa Gambia (GMB), Cộng hòa Guinea (GIN), Cộng hòa Hungary (HUN), Cộng hòa Hy Lạp (GRC), Cộng hòa Hợp tác Guyana (GUY), Cộng hòa Iceland (ISL), Cộng hòa Kazakhstan (KAZ), Cộng hòa Kenya (KEN), Cộng hòa Kyrgyzstan (KGZ), Cộng hòa Latvia (LVA), Cộng hòa Litva (LTU), Cộng hòa Liên bang Brazil (BRA), Cộng hòa Liên bang Nigeria (NGA), Cộng hòa Liên bang Tanzania (TZA), Cộng hòa Liên bang Đức (DEU), Cộng hòa Madagascar (MDG), Cộng hòa Maldives (MDV), Cộng hòa Malta (MLT), Cộng hòa Mauritius (MUS), Cộng hòa Moldova (MDA), Cộng hòa Nam Phi (ZAF), Cộng hòa Namibia (NAM), Cộng hòa Nhân dân Trung Hoa (CHN), Cộng hòa Paraguay (PRY), Cộng hòa Peru (PER), Cộng hòa Philippines (PHL), Cộng hòa Pháp (FRA), Cộng hòa Phần Lan (FIN), Cộng hòa Rwanda (RWA), Cộng hòa San Marino (SMR), Cộng hòa Serbia (SRB), Cộng hòa Seychelles (SYC), Cộng hòa Singapore (SGP), Cộng hòa Slovakia (SVK), Cộng hòa Slovenia (SVN), Cộng hòa Séc (CZE), Cộng hòa Síp (CYP), Cộng hòa Tajikistan (TJK), Cộng hòa Togo (TGO), Cộng hòa Trung Hoa (TWN), Cộng hòa Uzbekistan (UZB), Cộng hòa Xã hội Chủ nghĩa Dân chủ Sri Lanka (LKA), Cộng hòa Zambia (ZMB), Cộng hòa Zimbabwe (ZWE), Cộng hòa Áo (AUT), Cộng hòa Ý (ITA), Cộng hòa Đông Uruguay (URY), Cộng đồng Saint Martin (MAF), Georgia (GEO), Greenland (GRL), Guadeloupe (GLP), Guiana thuộc Pháp (GUF), Gặp lại (REU), Hồng Kông (HKG), Ireland (IRL), Kosovo (XXK), Liên bang Nga (RUS), Liên bang Thụy Sĩ (CHE), Liên bang Úc (AUS), Lãnh địa Jersey (JEY), Martinique (MTQ), Mayotte (MYT), Mông Cổ (MNG), New Zealand (NZL), Nhà nước Israel (ISR), Nhà nước đa dân tộc Bolivia (BOL), Nhật Bản (JPN), Quốc gia độc lập Samoa (WSM), Romania (ROU), Vương quốc Bỉ (BEL), Vương quốc Hà Lan (NLD), Vương quốc Liên hiệp Anh và Bắc Ireland (GBR), Vương quốc Maroc (MAR), Vương quốc Na Uy (NOR), Vương quốc Thái Lan (THA), Vương quốc Thụy Điển (SWE), Vương quốc Tây Ban Nha (ESP), Vương quốc Đan Mạch (DNK), Đại công quốc Luxembourg (LUX), Đảo Man (IMN)
Chức năng Order
  1. This product is not available.
    Sản phẩm này không thể tìm thấy và không thể đặt hàng.
  2. You can't order report on company with legal form: "legal_form"
    Lỗi này chỉ áp dụng cho: Vương quốc Thụy Điển (SWE)
    Tại Thụy Điển, không thể đặt hàng báo cáo trực tuyến (thời gian giao hàng = "o") với các mẫu đơn pháp lý sau:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. When delivery term is Online, please use order_details_by_id with search_result_id.
    This error only appears if you are trying to order online report without search_result_id.
    It is important yo use order_details_by_id in OrderReportRequest
  4. Business Name or Reg Code is required
    Khi đặt hàng báo cáo ngoại tuyến (thời hạn giao hàng = "n", "f" hoặc "s"), yêu cầu phải cung cấp "Tên doanh nghiệp" hoặc "Mã đăng ký".
  5. Reg Code is required when delivery term is Online
    Khi đặt hàng báo cáo trực tuyến (thời gian giao hàng = "o"), mã đăng ký (Reg Code) là bắt buộc.
Chức năng GetReport
  1. This language is not supported.
    Danh sách các ngôn ngữ có sẵn cho Báo cáo trực tuyến: ar (Arabic), bg (Bulgaria), cs (Séc), da (Đan Mạch), de (Đức), el (Hy Lạp), en (Tiếng Anh), es (Tiếng Tây Ban Nha), et (Estonia), fi (Phần Lan), fr (Pháp), he (Hebrew), hu (Hungary), id (Indonesia), it (Ý), ja (Nhật Bản), ko (Hàn Quốc), lt (Litva), lv (Latvia), nb (Tiếng Na Uy (Bokmål)), nl (Hà Lan), pl (Ba Lan), pt (Bồ Đào Nha), ro (Rumani), ru (Nga), sk (Slovakia), sl (Slovenia), sr (Српски), sv (Thụy Điển), th (Thai), tr (Thổ Nhĩ Kỳ), uk (Ukraine), vi (Vietnamese), zh (Trung Quốc)
Chức năng GetReport ChkStatus
  1. Incorrect order_id.
    ID đơn hàng không thể tìm thấy. Bạn sẽ nhận được ID đơn hàng khi sử dụng hàm Order.
Chức năng OrderCancellation
  1. Your order is already canceled.
    Bạn không còn quyền hủy đơn hàng nữa.
Chức năng OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Các thay đổi của SOAP (Phiên bản 4) so với SOAP (Phiên bản 3)

Các phần mới

  • country_economic_overview — bao gồm các phần con sau: data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — thông tin về các khoản thuế đã nộp.
  • tenders — Thông tin về các cuộc thầu.
  • sanctions — Được thêm vào phần negative_information.

Cập nhật các phần hiện có

Trong các phần beneficiaries, shareholders, managers, và employees_data, yếu tố sau đã được thêm vào:
  • source_type — Loại nguồn dữ liệu (ví dụ: official, mass_media, company_admin, v.v.).
Trong phần relations_of_persons, một phần tử mới đã được thêm vào:
  • match_type
Phần capital đã được tái cấu trúc:
  • Thành phần " capital_amount " đã được đổi tên thành " issued_capital".
  • Các phần tử mới sau đây đã được thêm vào:
    • number_of_shares
    • share_value
    • authorized_capital
Trong phần " employees_data ":
  • Thành phần mới " group_figure " chỉ định liệu dữ liệu có bao gồm các số liệu tổng hợp cấp nhóm hay không (true).
  • Thành phần source_type xác định loại nguồn dữ liệu.
  • Thành phần " is_estimated " hiện chỉ được bao gồm nếu giá trị của nó là " true".
Phần mới assets_data — hợp nhất các phần đã tồn tại trước đây:
  • real_estate_data (trước đây được gọi là property_data), vehicles, machinery_and_equipment (trước đây được gọi là assets).
  • Các phần dự kiến sẽ được bổ sung trong tương lai: patents và biological_assets.
Trong phần vehicles, một trường mới đã được thêm vào:
  • value
Trong phần litigations, các yếu tố sau đã được thêm vào:
  • content, instance, process, authority
Trong financial_statement/positions và summary/latest_turnovers, một phần tử mới đã được thêm vào:
  • value_origin — mô tả nguồn gốc của giá trị; ví dụ, giá trị " estimated " - giá trị này được ước tính và tính toán dựa trên dữ liệu có sẵn bằng logic hoặc trí tuệ nhân tạo (AI).
Trong phần branches_data, các trường sau đã được thêm vào:
  • registration_number
  • director_name

Lưu ý: Các cải tiến và điều chỉnh nhỏ có thể vẫn xảy ra trong giai đoạn ổn định.

Webhooks Settings

Tổng quan

Webhook là một cách để một ứng dụng cung cấp thông tin thời gian thực cho các ứng dụng khác. Tính năng webhook của chúng tôi thực hiện các cuộc gọi HTTP được cấu hình với một URL. Mỗi khi một sự kiện được chỉ định xảy ra, một gói tin HTTP POST sẽ được gửi đến URL này dưới định dạng JSON. Trong bối cảnh dự án của chúng tôi, chúng tôi đã thiết kế chức năng webhook để kích hoạt các sự kiện cụ thể.

Cấu hình Webhook

Để thiết lập webhook cho ứng dụng của bạn, hãy truy cập trang cài đặt ứng dụng và tìm phần 'Cài đặt Webhook'. Sau đó, cung cấp các thông tin sau:

  1. "URL Webhook" là địa chỉ URL mà máy chủ của bạn sẽ nhận các yêu cầu POST Webhook.
  2. "Số lần thử lại tối đa" là cài đặt xác định số lần thử lại tối đa cần thực hiện để gửi sự kiện webhook khi lần thử gửi ban đầu thất bại.
  3. "Thời gian chờ thử lại giao hàng" là một thiết lập cho phép bạn xác định khoảng thời gian giữa các lần thử lại khi một lần cố gắng giao hàng qua webhook thất bại.

Sau khi cung cấp các thông tin này, hãy nhấp vào 'Lưu'.

Loại sự kiện Webhook

  1. Trạng thái mới của đơn hàng

Nội dung yêu cầu webhook

Khi một sự kiện xảy ra, chúng tôi sẽ gửi yêu cầu HTTP POST đến URL payload với nội dung JSON chứa thông tin về sự kiện.

Dưới đây là một ví dụ về payload:
Ví dụ về dữ liệu tải trọng của trạng thái mới của đơn hàng
Các giá trị có thể của trường " "new_status" ":
  • "Finished" - Đơn hàng đã hoàn tất. Đơn hàng có thể được nhận.;
  • "Updated" - Đơn hàng được cập nhật, dữ liệu được thêm vào đơn hàng đã hoàn tất.;
  • "Canceled" - Một đơn hàng bị hủy theo yêu cầu (hoặc sự đồng ý) của khách hàng.;
  • "Rejected" - Một đơn hàng bị từ chối. Thường là do không thể xác định được công ty..
  • "Identification pending" - Chúng tôi cần thêm thông tin từ khách hàng trước khi có thể chuẩn bị đơn hàng..

Bảo mật các Webhook của bạn

Điều quan trọng là phải xác minh rằng các yêu cầu POST được gửi đến URL payload là từ ứng dụng của chúng ta. Để hỗ trợ việc này, mỗi yêu cầu webhook đều bao gồm tiêu đề X-Signature.

Mô tả chữ ký

Để ký, chúng tôi sử dụng HMAC với thuật toán SHA512.

Secret là sự kết hợp của App ID và Secret Key từ cài đặt webhooks.

Bạn có thể thêm các tham số tùy chỉnh vào điểm cuối (endpoint) để xác định người gửi nếu cần thiết.

Khắc phục sự cố

Máy chủ phải phản hồi trong vòng 10 giây và trả về mã trạng thái HTTP 2XX; nếu không, việc gửi webhook sẽ được coi là thất bại. Trong trường hợp thất bại, tính năng sẽ cố gắng gửi lại yêu cầu theo chính sách giao hàng.