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

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

Bắt đầu

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

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

Các chức năng chính của dịch vụ web:

  • SimpleSearch - Tìm kiếm thông tin về các công ty ở các quốc gia khác nhau.
  • 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, delivery_term and 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 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)
  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
  4. Company search

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. Tìm kiếm theo mã đăng ký.
Danh sách các quốc gia có sẵn: Cộng hòa Phần Lan (FIN), Vương quốc Thụy Điển (SWE), Vương quốc Na Uy (NOR), Vương quốc Đan Mạch (DNK)
Thông tin quan trọng:
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

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

Quy trình từ đăng ký đến nhận báo cáo bao gồm các bước sau::

  1. Người dùng đăng ký đơn hàng mới (chức năng "Order"). Hệ thống trả về chi tiết đơn hàng, danh sách các đơn hàng trùng lặp được đặt trong 60 ngày qua và chờ xác nhận đơn hàng.
  2. Người dùng xác nhận đơn hàng (chức năng "OrderConfirmation"). Hệ thống gửi đơn hàng để sản xuất và trả về trạng thái sản xuất hiện tại.
  3. Người dùng kiểm tra trạng thái đơn hàng (chức năng "ChkStatus").
  4. Nếu đơn hàng đã sẵn sàng, người dùng có thể tải xuống báo cáo (chức năng "GetReport").
Danh sách các quốc gia có sẵn: Cộng hòa Phần Lan (FIN), Vương quốc Thụy Điển (SWE)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

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

Bước 1: Đặt hàng báo cáo

Người dùng cho rằng bước xác nhận đơn hàng là không cần thiết có thể sử dụng thành phần "confirm_order" và truyền giá trị "TRUE".

Thông thường, việc chuẩn bị báo cáo tín dụng trong chế độ trực tuyến mất khoảng 10-20 giây.
Do đó, đối với các báo cáo trực tuyến, bạn nên thực hiện kiểm tra mỗi 5 giây hoặc lâu hơn.

Danh sách các công ty có sẵn cho tài khoản thử nghiệm:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
Ngoài ra, đối với các báo cáo trực tuyến (delivery_term = "o"), bạn có thể sử dụng các mẫu được tạo sẵn cho từng quốc gia (sử dụng mã đăng ký "00000000"). Các báo cáo này hoàn toàn miễn phí và có thể được đặt hàng thông qua tài khoản thử nghiệm.
Chức năng Order
Chức năng OrderCancellation

BƯỚC 2. Xác nhận đơn hàng

Chức năng OrderConfirmation

Bước 3. Kiểm tra trạng thái

Chức năng ChkStatus

Bước 4. Nhận báo cáo

Danh sách các ngôn ngữ có sẵn cho Báo cáo trực tuyến: en (English), et (Estonian), ru (Russian), de (German)
Tải xuống báo cáo trực tuyến dưới dạng PDF hiện chưa khả dụng.
Chức năng GetReport

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

Cách tải báo cáo ngoại tuyến?

Bạn có thể tải xuống các báo cáo ngoại tuyến trực tiếp. Dưới đây là hướng dẫn cách thực hiện:

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. 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

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
  • Tên người dùng/mật khẩu không chính xác hoặc bạn không có quyền truy cập.
    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. Bạn không có quyền truy cập để tìm kiếm trong quốc gia này.
    Danh sách các quốc gia có sẵn: Cộng hòa Phần Lan (FIN), Vương quốc Thụy Điển (SWE)
Chức năng Order
  1. Sản phẩm này hiện không có sẵn.
    Sản phẩm này không thể tìm thấy và không thể đặt hàng.
  2. Bạn không thể yêu cầu báo cáo về công ty có hình thức pháp lý: "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. Công ty này không có trong danh sách kiểm tra.
    Mã đăng ký công ty không có trong danh sách kiểm tra của chúng tôi.
    Danh sách các công ty có sẵn cho tài khoản thử nghiệm:
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. Tên doanh nghiệp hoặc Mã đăng ký là bắt buộc.
    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. Mã đăng ký là bắt buộc khi điều kiện giao hàng là Trực tuyến.
    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. Ngôn ngữ này không được hỗ trợ.
    Danh sách các ngôn ngữ có sẵn cho Báo cáo trực tuyến: en (English), et (Estonian), ru (Russian), de (German)
Chức năng GetReport ChkStatus
  1. Mã đơn hàng không chính xác.
    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. Bạn không còn quyền xác nhận đơn hàng nữa. Xác nhận có thể được thực hiện trong vòng một giờ sau khi bạn nhận được 'order_id'.

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

Các thay đổi của SOAP (Phiên bản 3) so với SOAP (Phiên bản 2) [Tổng quan]

1) Chức năng mới: ChkFinance

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

2) Chức năng: SimpleSearch

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

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

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

3) Chức năng: Order
Identification is required!

Để đặt hàng trực tuyến, bạn cần nhận được 'search_result_id' từ hàm 'SimpleSearch', và chỉ sau đó bạn mới có thể đặt hàng trực tuyến (delivery_term = 'o').

- Thay đổi trong danh sách các quốc gia có sẵn cho báo cáo tín dụng trực tuyến: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Có thể tải xuống báo cáo tài chính (sử dụng sản phẩm: tài chính) ở chế độ trực tuyến.: Estonia (EST), Sweden (SWE)

3) Chức năng: GetReport

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


Các thay đổi của SOAP (Phiên bản 3) so với SOAP (Phiên bản 2) [WSDL and XSD]

File: report.xsd

Các yếu tố mới:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Chức năng mới:

- ChkFinance

Function that allows you to search for available financial statements.

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

1) OrderReportRequest has a choice:

- order_details:

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

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

- order_details_by_id:

Using 'search_result_id'

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

2) order_details

Yếu tố mới:

- preferable_finances

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

3) SimpleSearchRequest

Phần tử đã bị xóa:

search_block.reg_code

Yếu tố mới:

search_block->company_code

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

4) SimpleSearchResponse

Các phần đã bị xóa

- code

Các yếu tố mới:

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