เอกสารประกอบการใช้งาน Infoproff API - v2

เปลี่ยนเวอร์ชัน V2

เริ่มต้นใช้งาน

เว็บเซอร์วิส wsdl และสคีมาอยู่ที่นี่:

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

ฟังก์ชันหลักของบริการเว็บ:

  • SimpleSearch - ค้นหาข้อมูลบริษัทในประเทศต่างๆ
  • Order - สร้างorder_idและคืนค่าข้อมูลซ้ำ ข้อมูลซ้ำจะถูกเลือกโดยพารามิเตอร์ต่อไปนี้:country, product, delivery_term and reg_code
  • OrderCancellation - หากคุณได้ส่งคำขอคำสั่งซื้อและได้รับorder_id คุณมีโอกาสที่จะยกเลิกคำสั่งซื้อนี้ (หากยังไม่ได้เข้าสู่การผลิต)
  • OrderConfirmation - หลังจากได้รับorder_idคุณจะต้องยืนยันคำสั่งซื้อของคุณภายใน 1 ชั่วโมง หากคุณไม่ยืนยันคำสั่งซื้อภายใน 1 ชั่วโมง คำสั่งซื้อจะถูกยกเลิกโดยอัตโนมัติ
  • ChkStatus - ตรวจสอบสถานะคำสั่งซื้อ
  • GetReport - รับรายงานที่เสร็จสมบูรณ์แล้ว
  • GetClassifiersFinancialStatements - รับเอกสารทางการเงินทั้งหมดพร้อมองค์ประกอบทั้งหมด: row_number, row_formated_description, row_lang_key และ row_order
  • GetLegalForms - รับแบบฟอร์มทางกฎหมายทั้งหมดสำหรับประเทศที่มีให้บริการทั้งหมด
  • GetActivityClassificators - รับรหัสและคำอธิบายทั้งหมดสำหรับตัวจำแนกกิจกรรมเฉพาะ
  • GetDictionaryStandardPhrases - รับวลีมาตรฐานทั้งหมดพร้อมคีย์และภาษา
  • GetAvailableProducts - รับรายการสินค้าที่มีอยู่
  • CreditOpinionCalculator - เครื่องคำนวณความเห็นเครดิตช่วยในการกำหนดความเห็นเครดิตสำหรับบริษัท

API ให้บริการหลายอย่าง:

  1. รายงานเครดิตออนไลน์สำหรับประเทศต่อไปนี้: มองโกเลีย (MNG), ราชอาณาจักรนอร์เวย์ (NOR), ราชอาณาจักรสวีเดน (SWE), ราชอาณาจักรสเปน (ESP), ราชอาณาจักรเดนมาร์ก (DNK), ราชอาณาจักรเนเธอร์แลนด์ (NLD), ราชอาณาจักรเบลเยียม (BEL), สมาพันธรัฐสวิส (CHE), สหพันธรัฐรัสเซีย (RUS), สหพันธ์สาธารณรัฐเยอรมนี (DEU), สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ (GBR), สาธารณรัฐคาซัคสถาน (KAZ), สาธารณรัฐคีร์กีซ (KGZ), สาธารณรัฐบัลแกเรีย (BGR), สาธารณรัฐประชาชนจีน (CHN), สาธารณรัฐฝรั่งเศส (FRA), สาธารณรัฐฟินแลนด์ (FIN), สาธารณรัฐมอลตา (MLT), สาธารณรัฐมอลโดวา (MDA), สาธารณรัฐลัตเวีย (LVA), สาธารณรัฐสโลวัก (SVK), สาธารณรัฐสโลวีเนีย (SVN), สาธารณรัฐออสเตรีย (AUT), สาธารณรัฐอาเซอร์ไบจาน (AZE), สาธารณรัฐอิตาลี (ITA), สาธารณรัฐฮังการี (HUN), สาธารณรัฐเช็ก (CZE), สาธารณรัฐเอสโตเนีย (EST), สาธารณรัฐเฮลเลนิก (GRC), สาธารณรัฐโครเอเชีย (HRV), สาธารณรัฐโปรตุเกส (PRT), สาธารณรัฐโปแลนด์ (POL), แกรนด์ดัชชีแห่งลักเซมเบิร์ก (LUX), ไอร์แลนด์ (IRL)
  2. รายงานออฟไลน์สำหรับประเทศต่อไปนี้: ทุกประเทศ
  3. เครื่องคำนวณความคิดเห็นเครดิต
  4. Company search

วิธีค้นหาบริษัท?

การค้นหาบริษัทประกอบด้วย 2 ตัวเลือก:

  1. ค้นหาตามชื่อบริษัท,
  2. ค้นหาโดยรหัสลงทะเบียน.
รายการประเทศที่มีให้บริการ: สาธารณรัฐฟินแลนด์ (FIN), ราชอาณาจักรสวีเดน (SWE), ราชอาณาจักรนอร์เวย์ (NOR), ราชอาณาจักรเดนมาร์ก (DNK)
ข้อมูลสำคัญ:
ทะเบียนของนอร์เวย์ไม่อนุญาตให้ค้นหาบริษัทที่ถูกยกเลิกแล้วโดยใช้ชื่อ ดังนั้นเราจึงไม่สามารถให้บริการSimpleSearchโดยใช้ชื่อภายในบริษัทที่ถูกยกเลิกในนอร์เวย์ได้
Field's length:
company_name varchar(512)
company_code varchar(64)

ด้านล่างนี้คุณสามารถดูตัวอย่างได้:

ฟังก์ชัน SimpleSearch

ตัวเลือกที่ 2: ค้นหาด้วยรหัสลงทะเบียน

ฟังก์ชัน SimpleSearch

วิธีการสั่งซื้อรายงานเครดิต?

ขั้นตอนการลงทะเบียนจนถึงการรับรายงานประกอบด้วยขั้นตอนดังต่อไปนี้:

  1. ผู้ใช้ลงทะเบียนคำสั่งซื้อใหม่ (ฟังก์ชัน "คำสั่งซื้อ") ระบบจะส่งรายละเอียดคำสั่งซื้อ รายการที่ซ้ำกันที่วางใน 60 วันที่ผ่านมา และรอการยืนยันคำสั่งซื้อ
  2. ผู้ใช้ยืนยันคำสั่งซื้อ (ฟังก์ชัน "OrderConfirmation") ระบบจะส่งคำสั่งซื้อไปยังการผลิตและคืนสถานะการผลิตปัจจุบัน
  3. ผู้ใช้ตรวจสอบสถานะคำสั่งซื้อ (ฟังก์ชัน "ChkStatus")
  4. หากคำสั่งซื้อพร้อมแล้ว ผู้ใช้สามารถดาวน์โหลดรายงานได้ (ฟังก์ชัน 'GetReport')
รายการประเทศที่มีให้บริการ: สาธารณรัฐฟินแลนด์ (FIN), ราชอาณาจักรสวีเดน (SWE)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

ด้านล่างนี้คุณสามารถดูตัวอย่างได้:

ขั้นตอนที่ 1: สั่งซื้อรายงาน

ผู้ใช้ที่พิจารณาว่าขั้นตอนการยืนยันคำสั่งซื้อไม่จำเป็น สามารถใช้ส่วนประกอบ"confirm_order"และส่งค่า"TRUE" ได้

โดยปกติแล้วจะใช้เวลา 10-20 วินาทีในการเตรียมรายงานเครดิตในโหมดออนไลน์
ดังนั้น สำหรับรายงานออนไลน์ คุณควรทำการตรวจสอบทุก 5 วินาทีหรือมากกว่า

รายชื่อบริษัทที่มีให้บริการสำหรับบัญชีทดสอบ:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
นอกจากนี้ สำหรับรายงานออนไลน์(delivery_term = "o") คุณสามารถใช้ตัวอย่างที่สร้างขึ้นสำหรับทุกประเทศได้ (ใช้: รหัสลงทะเบียน "00000000") รายงานเหล่านี้ไม่มีค่าใช้จ่าย และสามารถสั่งซื้อได้โดยใช้บัญชีทดสอบ
ฟังก์ชัน Order
ฟังก์ชัน OrderCancellation

ขั้นตอนที่ 2. ยืนยันคำสั่งซื้อ

ฟังก์ชัน OrderConfirmation

ขั้นตอนที่ 3. การตรวจสอบสถานะ

ฟังก์ชัน ChkStatus

ขั้นตอนที่ 4. รับรายงาน

รายการภาษาที่มีให้บริการสำหรับรายงานออนไลน์: en (English), et (Estonian), ru (Russian), de (German)
การดาวน์โหลดรายงานออนไลน์ในรูปแบบ pdf ยังไม่สามารถทำได้
ฟังก์ชัน GetReport

สถานะต่อไปนี้ใช้สำหรับรายงาน:

  • กำลังดำเนินการ - รายงานในขั้นตอนการผลิ
  • Canceled - ยกเลิกคำสั่งซื้อ
  • Finished - รายงานพร้อมแล้ว
  • Updated - ข้อมูลได้ถูกเพิ่มเข้าไปในรายงานที่เสร็จสมบูรณ์แล้ว
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - เกิดข้อผิดพลาดทางเทคนิคในระบบของเรา ซึ่งหมายความว่าเราได้รับแจ้งเกี่ยวกับข้อผิดพลาดนี้แล้วและจะดำเนินการแก้ไขโดยเร็วที่สุด ท่านจะได้รับแจ้งเมื่อสามารถรับคำสั่งซื้อได้

หากสถานะการดำเนินการคือ{เสร็จสิ้น}หรือ{อัปเดต} คุณสามารถรับคำสั่งซื้อได้

วิธีดาวน์โหลดรายงานแบบออฟไลน์?

คุณสามารถดาวน์โหลดรายงานแบบออฟไลน์ได้โดยตรง. นี่คือคำแนะนำว่าคุณต้องทำอย่างไร:

คำขอประกอบด้วย 3 ส่วน:

  1. ส่วนที่คงที่https://www.infoproff.com/en/orders/files/
  2. รหัสแฮชเฉพาะของคุณ ซึ่งเราจัดเตรียมให้เป็นการตอบกลับ
  3. และส่วนที่คงที่ที่ท้ายสุด/download

วิธีขอความเห็นเกี่ยวกับเครดิต?

ฟังก์ชัน CreditOpinionCalculator

จะรับข้อมูลเพิ่มเติมได้อย่างไร?

ฟังก์ชัน GetClassifiersFinancialStatements
ฟังก์ชัน GetActivityClassificators
ฟังก์ชัน GetDictionaryStandardPhrases
ฟังก์ชัน GetAvailableProducts

ข้อผิดพลาดที่อาจเกิดขึ้น

ข้อผิดพลาดเหล่านี้อาจเกิดขึ้นในขณะทำการร้องขอไปยังบริการเว็บของเรา.

ฟังก์ชันทั้งหมด
  • ชื่อผู้ใช้/รหัสผ่านไม่ถูกต้อง หรือคุณไม่มีสิทธิ์เข้าถึง
    คุณกำลังป้อนข้อมูลรับรองไม่ถูกต้องหรือการเข้าถึง API ของคุณถูกบล็อก
ฟังก์ชัน SimpleSearch
  1. คุณไม่มีสิทธิ์ในการค้นหาในประเทศนี้
    รายการประเทศที่มีให้บริการ: สาธารณรัฐฟินแลนด์ (FIN), ราชอาณาจักรสวีเดน (SWE)
ฟังก์ชัน Order
  1. สินค้านี้ไม่มีจำหน่าย
    ไม่สามารถหาสินค้าดังกล่าวได้ และไม่สามารถสั่งซื้อได้
  2. คุณไม่สามารถสั่งรายงานเกี่ยวกับบริษัทที่มีรูปแบบทางกฎหมาย:'legal_form'
    ข้อผิดพลาดนี้ใช้ได้เฉพาะกับ: ราชอาณาจักรสวีเดน (SWE)
    ในประเทศสวีเดน ไม่สามารถสั่งซื้อรายงานออนไลน์ (เงื่อนไขการจัดส่ง = "o") ด้วยรูปแบบทางกฎหมายต่อไปนี้ได้:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. บริษัทนี้ไม่ได้อยู่ในรายการทดสอบ
    รหัสทะเบียนบริษัทไม่อยู่ในรายการทดสอบของเรา
    รายชื่อบริษัทที่มีให้บริการสำหรับบัญชีทดสอบ:
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. จำเป็นต้องระบุชื่อธุรกิจหรือรหัสทะเบียน
    เมื่อสั่งซื้อรายงานแบบออฟไลน์ (delivery_term = "n", "f" หรือ "s") จำเป็นต้องระบุ "ชื่อธุรกิจ" หรือ "รหัสทะเบียน"
  5. จำเป็นต้องมีรหัสลงทะเบียนเมื่อเงื่อนไขการจัดส่งคือออนไลน์
    เมื่อสั่งซื้อรายงานออนไลน์ (เงื่อนไขการจัดส่ง = "o") จำเป็นต้องมี "รหัสลงทะเบียน"
ฟังก์ชัน GetReport
  1. ภาษาไม่ได้รับการสนับสนุน
    รายการภาษาที่มีให้บริการสำหรับรายงานออนไลน์: en (English), et (Estonian), ru (Russian), de (German)
ฟังก์ชัน GetReport ChkStatus
  1. order_id ไม่ถูกต้อง
    ไม่สามารถค้นหาหมายเลขคำสั่งซื้อได้ คุณจะได้รับหมายเลขคำสั่งซื้อเมื่อคุณใช้ฟังก์ชันOrder
ฟังก์ชัน OrderCancellation
  1. Your order is already canceled.
    คุณไม่มีสิทธิ์ยกเลิกคำสั่งซื้ออีกต่อไป
ฟังก์ชัน OrderConfirmation
  1. คุณไม่มีสิทธิ์ในการยืนยันคำสั่งซื้ออีกต่อไป การยืนยันสามารถทำได้ภายในหนึ่งชั่วโมงหลังจากที่คุณได้รับ 'order_id'

การเปลี่ยนแปลงของ SOAP (เวอร์ชัน 3) เมื่อเทียบกับ SOAP (เวอร์ชัน 2)

การเปลี่ยนแปลงของ SOAP (เวอร์ชัน 3) เมื่อเทียบกับ SOAP (เวอร์ชัน 2) [ภาพรวม]

1) ฟังก์ชันใหม่: ChkFinance

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

2) ฟังก์ชัน: SimpleSearch

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

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

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

3) ฟังก์ชัน: Order
Identification is required!

ในการสั่งซื้อออนไลน์ คุณต้องได้รับ 'search_result_id' จากฟังก์ชัน 'SimpleSearch' และหลังจากนั้นเท่านั้นจึงจะสามารถสั่งซื้อออนไลน์ (delivery_term = 'o') ได้

- การเปลี่ยนแปลงในรายการประเทศที่มีให้บริการสำหรับรายงานเครดิตออนไลน์: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- สามารถดาวน์โหลดงบการเงิน (โดยใช้ผลิตภัณฑ์: การเงิน) ในโหมดออนไลน์: Estonia (EST), Sweden (SWE)

3) ฟังก์ชัน: GetReport

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


การเปลี่ยนแปลงของ SOAP (เวอร์ชัน 3) เมื่อเทียบกับ SOAP (เวอร์ชัน 2) [WSDL and XSD]

File: report.xsd

องค์ประกอบใหม่:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

ฟังก์ชันใหม่:

- ChkFinance

Function that allows you to search for available financial statements.

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

1) OrderReportRequest has a choice:

- order_details:

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

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

- order_details_by_id:

Using 'search_result_id'

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

2) order_details

องค์ประกอบใหม่:

- preferable_finances

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

3) SimpleSearchRequest

ลบองค์ประกอบ:

search_block.reg_code

องค์ประกอบใหม่:

search_block->company_code

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

4) SimpleSearchResponse

องค์ประกอบที่ถูกลบออก

- code

องค์ประกอบใหม่:

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