Dokumentasi API Infoproff - v3


Memulakan


Perkhidmatan web WSDL dan skema terletak di sini:

http://wsdfn.infoproff.com/v3/

Web service functions:

  • SimpleSearch - Mencari maklumat syarikat di pelbagai negara.
  • ChkFinance - Cari penyata kewangan yang tersedia.
  • Order - Mencipta order_id dan mengembalikan duplikat. Duplikat dipilih oleh parameter seterusnya: country, product, reg_code.
  • OrderCancellation - Jika anda menghantar permintaan pesanan dan menerima order_id, anda berpeluang membatalkan pesanan ini (jika ia belum memasuki pengeluaran).
  • OrderConfirmation - Selepas menerima order_id, anda perlu mengesahkan pesanan anda dalam masa 1 jam. Jika anda tidak mengesahkan pesanan anda dalam masa 1 jam, pesanan tersebut akan dibatalkan secara automatik.
  • ChkStatus - Semak status pesanan.
  • GetReport - Dapatkan laporan siap.

  • GetClassifiersFinancialStatements - Dapatkan semua dokumen kewangan dengan semua elemen: row_number, row_formated_description, row_lang_key dan row_order.
  • GetLegalForms - Dapatkan semua borang undang-undang untuk semua negara yang tersedia.
  • GetActivityClassificators - Dapatkan semua kod dan keterangan untuk pengelas aktiviti tertentu.
  • GetDictionaryStandardPhrases - Dapatkan semua frasa standard dengan kunci dan bahasa.
  • GetAvailableProducts - Dapatkan senarai produk yang tersedia.

  • CreditOpinionCalculator - Kalkulator Pendapat Kredit membantu menetapkan pendapat kredit bagi sesebuah syarikat.

API menyediakan beberapa perkhidmatan:

  1. Laporan kredit dalam talian untuk negara-negara berikut: Austria (AUT), Azerbaijan (AZE), Belanda (NLD), Belgium (BEL), Bulgaria (BGR), China (CHN), Croatia (HRV), Czech (CZE), Denmark (DNK), Estonia (EST), Finland (FIN), Hungary (HUN), Irlandia (IRL), Itali (ITA), Jerman (DEU), Kazakhstan (KAZ), Kyrgyzstan (KGZ), Latvia (LVA), Luxembourg (LUX), Malta (MLT), Moldova (MDA), Mongolia (MNG), Norway (NOR), Perancis (FRA), Poland (POL), Portugal (PRT), Rusia (RUS), Sepanyol (ESP), Slovakia (SVK), Slovenia (SVN), Sweden (SWE), Switzerland (CHE), United Kingdom (GBR), Yunani (GRC)
  2. Laporan luar talian untuk negara-negara berikut: Semua negara
  3. Kalkulator pendapat kredit
  4. Company search

Bagaimana untuk mencari sebuah syarikat?


Carian syarikat terdiri daripada 2 pilihan:

  1. Cari mengikut nama syarikat,
  2. Search by company code.
Senarai negara yang tersedia: Afrika Selatan (ZAF), Albania (ALB), Algeria (DZA), Angola (AGO), Argentina (ARG), Australia (AUS), Austria (AUT), Azerbaijan (AZE), Belanda (NLD), Belarus (BLR), Belgium (BEL), Benin (BEN), Bolivia (BOL), Bosnia dan Herzegovina (BIH), Botswana (BWA), Brazil (BRA), Bulgaria (BGR), Chile (CHL), China (CHN), Congo (COG), Croatia (HRV), Cyprus (CYP), Czech (CZE), Denmark (DNK), Ecuador (ECU), Estonia (EST), Ethiopia (ETH), Filipina (PHL), Finland (FIN), Gambia (GMB), Georgia (GEO), Greenland (GRL), Guadeloupe (GLP), Guiana Perancis (GUF), Guinea (GIN), Guyana (GUY), Hong Kong (HKG), Hungary (HUN), Iceland (ISL), Irlandia (IRL), Israel (ISR), Itali (ITA), Jepun (JPN), Jerman (DEU), Jersey (JEY), Kanada (CAN), Kazakhstan (KAZ), Kenya (KEN), Kosovo (XXK), Kyrgyzstan (KGZ), Latvia (LVA), Liechtenstein (LIE), Lithuania (LTU), Luxembourg (LUX), Madagaskar (MDG), Maghribi (MAR), Maldives (MDV), Malta (MLT), Man (IMN), Martinique (MTQ), Mauritius (MUS), Mayotte (MYT), Moldova (MDA), Monaco (MCO), Mongolia (MNG), Namibia (NAM), New Zealand (NZL), Nigeria (NGA), Norway (NOR), Pantai Gading (CIV), Paraguay (PRY), Perancis (FRA), Peru (PER), Poland (POL), Portugal (PRT), Reuni (REU), Romania (ROU), Rusia (RUS), Rwanda (RWA), Saint Martin (MAF), Samoa (WSM), San Marino (SMR), Sepanyol (ESP), Serbia (SRB), Seychelles (SYC), Singapura (SGP), Slovakia (SVK), Slovenia (SVN), Sri Lanka (LKA), Sweden (SWE), Switzerland (CHE), Taiwan (TWN), Tanzania (TZA), Thailand (THA), Togo (TGO), United Kingdom (GBR), Uruguay (URY), Uzbekistan (UZB), Venezuela (VEN), Yunani (GRC), Zambia (ZMB), Zimbabwe (ZWE), Тоjikiston (TJK)

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.

Maklumat penting:

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.

Pendaftar Norway tidak membenarkan carian syarikat yang telah dipadam berdasarkan nama. Oleh itu, kami tidak dapat menyediakan SimpleSearch berdasarkan nama bagi syarikat yang telah dipadam di Norway.

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

Di bawah ini anda boleh menemui contohnya.:


Fungsi SimpleSearch

Pilihan 2: Cari mengikut kod pendaftaran

Fungsi SimpleSearch

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

Fungsi UnifiedSearch

Bagaimana untuk memesan laporan kredit?


List of available countries for online credit reports: Austria (AUT), Azerbaijan (AZE), Belanda (NLD), Belgium (BEL), Bulgaria (BGR), China (CHN), Croatia (HRV), Czech (CZE), Denmark (DNK), Estonia (EST), Finland (FIN), Hungary (HUN), Irlandia (IRL), Itali (ITA), Jerman (DEU), Kazakhstan (KAZ), Kyrgyzstan (KGZ), Latvia (LVA), Luxembourg (LUX), Malta (MLT), Moldova (MDA), Mongolia (MNG), Norway (NOR), Perancis (FRA), Poland (POL), Portugal (PRT), Rusia (RUS), Sepanyol (ESP), Slovakia (SVK), Slovenia (SVN), Sweden (SWE), Switzerland (CHE), United Kingdom (GBR), Yunani (GRC)
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))

Fungsi SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Bagaimana untuk mencari sebuah syarikat?

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

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

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

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

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

Status-status berikut digunakan untuk laporan:

  • Dalam proses - Laporan pada peringkat pengeluaran
  • Identification pending - Persiapan laporan sedang ditangguhkan. Memerlukan data tambahan daripada pelanggan.
  • Canceled - Pesanan dibatalkan
  • Finished - Laporan itu sudah siap.
  • Updated - Maklumat telah ditambah ke dalam laporan yang telah siap.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Telah berlaku ralat teknikal dalam sistem kami. Ini bermakna kami telah dimaklumkan tentang ralat ini dan akan membetulkannya secepat mungkin. Anda akan dimaklumkan bila anda boleh menerima pesanan.

Jika status pelaksanaan adalah {selesai} atau {dikemas kini}, maka anda boleh mendapatkan pesanan.

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

Fungsi GetReport
Senarai bahasa yang tersedia: ar (Arabic), az (Azerbaijani), bg (Bulgaria), cs (Ceko), da (Denmark), de (Jerman), el (Yunani), en (Inggeris), es (Sepanyol), et (Estonia), fi (Finnis), fr (Perancis), he (Hebrew), hi (Hindi), hu (Hungaria), hy (Armenian), id (Indonesia), it (Itali), ja (Jepun), ka (Georgian), kk (Kazakh), ko (Korea), lt (Lithuania), lv (Latvia), mn (Mongolian), ms (Malay), nb (Bokmål Norwegia), nl (Belanda), pl (Mengilat), pt (Portugis), ro (Rumania), ru (Rusia), sk (Slovak), sl (Slovenia), sr (Српски), sv (Swedia), th (Thai), tr (Turki), uk (Ukraine), uz (Uzbek), vi (Vietnamese), zh (Cina)

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

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

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

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

Fungsi ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

Status-status berikut digunakan untuk laporan:

  • Dalam proses - Laporan pada peringkat pengeluaran
  • Identification pending - Persiapan laporan sedang ditangguhkan. Memerlukan data tambahan daripada pelanggan.
  • Canceled - Pesanan dibatalkan
  • Finished - Laporan itu sudah siap.
  • Updated - Maklumat telah ditambah ke dalam laporan yang telah siap.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Telah berlaku ralat teknikal dalam sistem kami. Ini bermakna kami telah dimaklumkan tentang ralat ini dan akan membetulkannya secepat mungkin. Anda akan dimaklumkan bila anda boleh menerima pesanan.

Jika status pelaksanaan adalah {selesai} atau {dikemas kini}, maka anda boleh mendapatkan pesanan.

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

Fungsi GetReport
Senarai bahasa yang tersedia: ar (Arabic), az (Azerbaijani), bg (Bulgaria), cs (Ceko), da (Denmark), de (Jerman), el (Yunani), en (Inggeris), es (Sepanyol), et (Estonia), fi (Finnis), fr (Perancis), he (Hebrew), hi (Hindi), hu (Hungaria), hy (Armenian), id (Indonesia), it (Itali), ja (Jepun), ka (Georgian), kk (Kazakh), ko (Korea), lt (Lithuania), lv (Latvia), mn (Mongolian), ms (Malay), nb (Bokmål Norwegia), nl (Belanda), pl (Mengilat), pt (Portugis), ro (Rumania), ru (Rusia), sk (Slovak), sl (Slovenia), sr (Српски), sv (Swedia), th (Thai), tr (Turki), uk (Ukraine), uz (Uzbek), vi (Vietnamese), zh (Cina)

Bagaimana untuk memesan laporan kredit yang disimpan dalam arkib?


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

Fungsi 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: Bagaimana untuk mencari sebuah syarikat?

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

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

Bagaimana untuk memesan penyata kewangan dalam talian?


STEP 1: Find a company

Fungsi SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Bagaimana untuk mencari sebuah syarikat?

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: Cari penyata kewangan yang tersedia

Fungsi ChkFinance

Fungsi ini hanya diperlukan apabila memesan produk: finances (Financial statements) dengan delivery_term = 'o'.

Senarai negara yang tersedia: Estonia (EST), Sweden (SWE)

STEP 3: Memesan penyata kewangan

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

Fungsi 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

Fungsi 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

Fungsi ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

Status-status berikut digunakan untuk laporan:

  • Dalam proses - Laporan pada peringkat pengeluaran
  • Identification pending - Persiapan laporan sedang ditangguhkan. Memerlukan data tambahan daripada pelanggan.
  • Canceled - Pesanan dibatalkan
  • Finished - Laporan itu sudah siap.
  • Updated - Maklumat telah ditambah ke dalam laporan yang telah siap.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Telah berlaku ralat teknikal dalam sistem kami. Ini bermakna kami telah dimaklumkan tentang ralat ini dan akan membetulkannya secepat mungkin. Anda akan dimaklumkan bila anda boleh menerima pesanan.

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

Fungsi GetReport
Senarai bahasa yang tersedia: ar (Arabic), az (Azerbaijani), bg (Bulgaria), cs (Ceko), da (Denmark), de (Jerman), el (Yunani), en (Inggeris), es (Sepanyol), et (Estonia), fi (Finnis), fr (Perancis), he (Hebrew), hi (Hindi), hu (Hungaria), hy (Armenian), id (Indonesia), it (Itali), ja (Jepun), ka (Georgian), kk (Kazakh), ko (Korea), lt (Lithuania), lv (Latvia), mn (Mongolian), ms (Malay), nb (Bokmål Norwegia), nl (Belanda), pl (Mengilat), pt (Portugis), ro (Rumania), ru (Rusia), sk (Slovak), sl (Slovenia), sr (Српски), sv (Swedia), th (Thai), tr (Turki), uk (Ukraine), uz (Uzbek), vi (Vietnamese), zh (Cina)
To see the examples of xml request/response, please follow the link: How to get finished order?

Bagaimana cara memuat turun laporan piawai (dalam format selain 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.

Permintaan terdiri daripada 3 bahagian:

  1. Bahagian tetap https://www.infoproff.com/en/orders/files/
  2. Hash unik anda, yang kami sediakan sebagai tindak balas
  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, 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 - Asli (tiada pertukaran), 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

Bagaimana cara memuat turun produk bukan piawai?


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.

Permintaan terdiri daripada 3 bahagian:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Hash unik anda, yang kami sediakan sebagai tindak balas
  3. Dan bahagian tetap di bahagian akhir /download

Bagaimana untuk mendapatkan pendapat kredit?


Fungsi CreditOpinionCalculator

Bagaimana untuk mendapatkan maklumat tambahan?


Fungsi GetClassifiersFinancialStatements
Fungsi GetActivityClassificators
Fungsi GetDictionaryStandardPhrases
Fungsi GetAvailableProducts

delivery_term:

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

Kesilapan yang mungkin


Ralat ini mungkin berlaku semasa membuat permintaan ke perkhidmatan web kami..


Semua fungsi
  • Incorrect username/password or you have no permissions.
    Anda memasukkan butiran log masuk yang salah atau akses API anda dihalang.

Fungsi SimpleSearch
  1. You don't have permissions to search in this country.
    Senarai negara yang tersedia: Afrika Selatan (ZAF), Albania (ALB), Algeria (DZA), Angola (AGO), Argentina (ARG), Australia (AUS), Austria (AUT), Azerbaijan (AZE), Belanda (NLD), Belarus (BLR), Belgium (BEL), Benin (BEN), Bolivia (BOL), Bosnia dan Herzegovina (BIH), Botswana (BWA), Brazil (BRA), Bulgaria (BGR), Chile (CHL), China (CHN), Congo (COG), Croatia (HRV), Cyprus (CYP), Czech (CZE), Denmark (DNK), Ecuador (ECU), Estonia (EST), Ethiopia (ETH), Filipina (PHL), Finland (FIN), Gambia (GMB), Georgia (GEO), Greenland (GRL), Guadeloupe (GLP), Guiana Perancis (GUF), Guinea (GIN), Guyana (GUY), Hong Kong (HKG), Hungary (HUN), Iceland (ISL), Irlandia (IRL), Israel (ISR), Itali (ITA), Jepun (JPN), Jerman (DEU), Jersey (JEY), Kanada (CAN), Kazakhstan (KAZ), Kenya (KEN), Kosovo (XXK), Kyrgyzstan (KGZ), Latvia (LVA), Liechtenstein (LIE), Lithuania (LTU), Luxembourg (LUX), Madagaskar (MDG), Maghribi (MAR), Maldives (MDV), Malta (MLT), Man (IMN), Martinique (MTQ), Mauritius (MUS), Mayotte (MYT), Moldova (MDA), Monaco (MCO), Mongolia (MNG), Namibia (NAM), New Zealand (NZL), Nigeria (NGA), Norway (NOR), Pantai Gading (CIV), Paraguay (PRY), Perancis (FRA), Peru (PER), Poland (POL), Portugal (PRT), Reuni (REU), Romania (ROU), Rusia (RUS), Rwanda (RWA), Saint Martin (MAF), Samoa (WSM), San Marino (SMR), Sepanyol (ESP), Serbia (SRB), Seychelles (SYC), Singapura (SGP), Slovakia (SVK), Slovenia (SVN), Sri Lanka (LKA), Sweden (SWE), Switzerland (CHE), Taiwan (TWN), Tanzania (TZA), Thailand (THA), Togo (TGO), United Kingdom (GBR), Uruguay (URY), Uzbekistan (UZB), Venezuela (VEN), Yunani (GRC), Zambia (ZMB), Zimbabwe (ZWE), Тоjikiston (TJK)
Fungsi Order
  1. This product is not available.
    Produk seperti itu tidak dapat ditemui dan tidak mungkin untuk memesannya.
  2. You can't order report on company with legal form: "legal_form"
    Ralat ini hanya terpakai kepada: Sweden (SWE)
    Di Sweden, tidak mungkin memesan laporan dalam talian (delivery_term = "o") dengan borang undang-undang berikut:
    • 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
    Apabila memesan laporan luar talian (delivery_term = "n", "f" atau "s"), "Nama Perniagaan" atau "Kod Pendaftaran" diperlukan.
  5. Reg Code is required when delivery term is Online
    Apabila memesan laporan dalam talian (delivery_term = "o"), "Reg Code" diperlukan.

Fungsi GetReport
  1. This language is not supported.
    Senarai bahasa yang tersedia untuk laporan dalam talian: ar (Arabic), az (Azerbaijani), bg (Bulgaria), cs (Ceko), da (Denmark), de (Jerman), el (Yunani), en (Inggeris), es (Sepanyol), et (Estonia), fi (Finnis), fr (Perancis), he (Hebrew), hi (Hindi), hu (Hungaria), hy (Armenian), id (Indonesia), it (Itali), ja (Jepun), ka (Georgian), kk (Kazakh), ko (Korea), lt (Lithuania), lv (Latvia), mn (Mongolian), ms (Malay), nb (Bokmål Norwegia), nl (Belanda), pl (Mengilat), pt (Portugis), ro (Rumania), ru (Rusia), sk (Slovak), sl (Slovenia), sr (Српски), sv (Swedia), th (Thai), tr (Turki), uk (Ukraine), uz (Uzbek), vi (Vietnamese), zh (Cina)

Fungsi GetReport ChkStatus
  1. Incorrect order_id.
    ID pesanan tidak dapat ditemui. Anda mendapat ID pesanan apabila anda menggunakan fungsi Order.

Fungsi OrderCancellation
  1. Your order is already canceled.
    Anda tidak lagi dibenarkan membatalkan pesanan itu.

Fungsi OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Perbezaan SOAP (Versi 3) berbanding SOAP (Versi 2)


Perbezaan SOAP (Versi 3) berbanding SOAP (Versi 2) [Overview]

1) New function: ChkFinance

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

2) Function: SimpleSearch

- Changes in list of available countries: Afrika Selatan (ZAF), Albania (ALB), Algeria (DZA), Angola (AGO), Argentina (ARG), Australia (AUS), Austria (AUT), Azerbaijan (AZE), Belanda (NLD), Belarus (BLR), Belgium (BEL), Benin (BEN), Bolivia (BOL), Bosnia dan Herzegovina (BIH), Botswana (BWA), Brazil (BRA), Bulgaria (BGR), Chile (CHL), China (CHN), Congo (COG), Croatia (HRV), Cyprus (CYP), Czech (CZE), Denmark (DNK), Ecuador (ECU), Estonia (EST), Ethiopia (ETH), Filipina (PHL), Finland (FIN), Gambia (GMB), Georgia (GEO), Greenland (GRL), Guadeloupe (GLP), Guiana Perancis (GUF), Guinea (GIN), Guyana (GUY), Hong Kong (HKG), Hungary (HUN), Iceland (ISL), Irlandia (IRL), Israel (ISR), Itali (ITA), Jepun (JPN), Jerman (DEU), Jersey (JEY), Kanada (CAN), Kazakhstan (KAZ), Kenya (KEN), Kosovo (XXK), Kyrgyzstan (KGZ), Latvia (LVA), Liechtenstein (LIE), Lithuania (LTU), Luxembourg (LUX), Madagaskar (MDG), Maghribi (MAR), Maldives (MDV), Malta (MLT), Man (IMN), Martinique (MTQ), Mauritius (MUS), Mayotte (MYT), Moldova (MDA), Monaco (MCO), Mongolia (MNG), Namibia (NAM), New Zealand (NZL), Nigeria (NGA), Norway (NOR), Pantai Gading (CIV), Paraguay (PRY), Perancis (FRA), Peru (PER), Poland (POL), Portugal (PRT), Reuni (REU), Romania (ROU), Rusia (RUS), Rwanda (RWA), Saint Martin (MAF), Samoa (WSM), San Marino (SMR), Sepanyol (ESP), Serbia (SRB), Seychelles (SYC), Singapura (SGP), Slovakia (SVK), Slovenia (SVN), Sri Lanka (LKA), Sweden (SWE), Switzerland (CHE), Taiwan (TWN), Tanzania (TZA), Thailand (THA), Togo (TGO), United Kingdom (GBR), Uruguay (URY), Uzbekistan (UZB), Venezuela (VEN), Yunani (GRC), Zambia (ZMB), Zimbabwe (ZWE), Тоjikiston (TJK)

- 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) Function: Order
Identification is required!

To place an online order, you need to recieve 'search_result_id' from function 'SimpleSearch', and only after that you can place an online (delivery_term = 'o') order.

- Changes in list of available countries for online credit reports: Austria (AUT), Azerbaijan (AZE), Belanda (NLD), Belgium (BEL), Bulgaria (BGR), China (CHN), Croatia (HRV), Czech (CZE), Denmark (DNK), Estonia (EST), Finland (FIN), Hungary (HUN), Irlandia (IRL), Itali (ITA), Jerman (DEU), Kazakhstan (KAZ), Kyrgyzstan (KGZ), Latvia (LVA), Luxembourg (LUX), Malta (MLT), Moldova (MDA), Mongolia (MNG), Norway (NOR), Perancis (FRA), Poland (POL), Portugal (PRT), Rusia (RUS), Sepanyol (ESP), Slovakia (SVK), Slovenia (SVN), Sweden (SWE), Switzerland (CHE), United Kingdom (GBR), Yunani (GRC)

- Available to download financial statements (using product: finances) in online mode: Estonia (EST), Sweden (SWE)

3) Function: GetReport

- Changes in of available languages: ar (Arabic), az (Azerbaijani), bg (Bulgaria), cs (Ceko), da (Denmark), de (Jerman), el (Yunani), en (Inggeris), es (Sepanyol), et (Estonia), fi (Finnis), fr (Perancis), he (Hebrew), hi (Hindi), hu (Hungaria), hy (Armenian), id (Indonesia), it (Itali), ja (Jepun), ka (Georgian), kk (Kazakh), ko (Korea), lt (Lithuania), lv (Latvia), mn (Mongolian), ms (Malay), nb (Bokmål Norwegia), nl (Belanda), pl (Mengilat), pt (Portugis), ro (Rumania), ru (Rusia), sk (Slovak), sl (Slovenia), sr (Српски), sv (Swedia), th (Thai), tr (Turki), uk (Ukraine), uz (Uzbek), vi (Vietnamese), zh (Cina)


Perbezaan SOAP (Versi 3) berbanding SOAP (Versi 2) [WSDL and XSD]

File: report.xsd

New elements:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

New function:

- 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

New element:

- preferable_finances

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

3) SimpleSearchRequest

Removed element:

search_block.reg_code

New element:

search_block->company_code

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

4) SimpleSearchResponse

Removed elements

- code

Elemen baru:

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

Webhooks Settings


Keseluruhan

Webhook ialah cara bagi sesebuah aplikasi untuk menyediakan maklumat masa nyata kepada aplikasi lain. Ciri webhook kami melaksanakan callback HTTP yang dikonfigurasikan dengan URL. Muatan HTTP POST dihantar ke URL ini dalam format JSON setiap kali peristiwa tertentu berlaku. Dalam konteks projek kami, kami telah mereka fungsi webhook untuk mencetuskan peristiwa tertentu.

Menyiapkan Webhook

Untuk menyediakan webhook bagi aplikasi anda, layari halaman tetapan aplikasi dan cari bahagian 'Tetapan Webhook'. Dan berikan maklumat berikut:

  1. "URL Webhook" ialah URL di mana pelayan anda akan menerima permintaan POST webhook.
  2. "Delivery max attempts" adalah tetapan yang menentukan bilangan maksimum cubaan ulangan yang hendak dilakukan untuk menghantar acara webhook apabila cubaan penghantaran awal gagal.
  3. "Delivery retry timeout" adalah tetapan yang membolehkan anda menentukan selang masa antara percubaan semula apabila percubaan penghantaran webhook gagal.

Selepas menyediakan butiran ini, klik 'Simpan'.

Jenis Acara Webhook

  1. Status pesanan baharu

Muatan Webhook

Apabila sesuatu peristiwa berlaku, kami akan menghantar permintaan HTTP POST ke URL payload dengan badan JSON yang mengandungi maklumat tentang peristiwa tersebut.

Berikut adalah contoh muatan:
Contoh muatan status baru pesanan
Nilai yang mungkin bagi medan "new_status":
  • "Finished" - pesanan telah lengkap. Pesanan boleh diambil;
  • "Updated" - pesanan dikemas kini, data ditambah pada pesanan yang telah selesai;
  • "Canceled" - pesanan dibatalkan atas permintaan pelanggan (atau dengan persetujuan mereka);
  • "Rejected" - pesanan ditolak. Biasanya kerana mustahil untuk mengenal pasti sesebuah syarikat..
  • "Identification pending" - kami memerlukan maklumat lanjut daripada pelanggan sebelum kami dapat menyediakan pesanan..

Mengamankan Webhook anda

Adalah penting untuk mengesahkan bahawa permintaan POST yang dihantar ke URL muatan berasal daripada aplikasi kami. Untuk membantu perkara ini, setiap permintaan webhook menyertakan header X-Signature.

Keterangan Tandatangan

Untuk menandatangani, kami menggunakan HMAC dengan algoritma SHA512.

Rahsia ialah gabungan App ID dan Kunci Rahsia daripada tetapan webhook.

Adalah mungkin untuk menambah param anda sendiri pada titik akhir untuk mengenal pasti penghantar jika perlu.

Pemecahan masalah

Pelayan mesti memberi respons dalam masa 10 saat dan mengembalikan kod HTTP 2XX; jika tidak, penghantaran webhook dianggap gagal. Sekiranya gagal, ciri ini akan cuba menghantar semula permintaan mengikut dasar penghantaran.

© Dokumentasi API Infoproff 2026