Dokumentasi API Infoproff - v2

Tukar versi V2

Memulakan

Perkhidmatan web WSDL dan skema terletak di sini:

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

Fungsi utama perkhidmatan web:

  • SimpleSearch - Mencari maklumat syarikat di pelbagai negara.
  • Order - Mencipta order_id dan mengembalikan duplikat. Duplikat dipilih oleh parameter seterusnya: country, product, delivery_term and 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. Cari mengikut kod pendaftaran.
Senarai negara yang tersedia: Finland (FIN), Sweden (SWE), Norway (NOR), Denmark (DNK)
Maklumat penting:
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

Bagaimana untuk memesan laporan kredit?

Susunan langkah dari pendaftaran hingga penerimaan laporan adalah seperti berikut:

  1. Pengguna mendaftarkan pesanan baru (fungsi "Order"). Sistem memaparkan butiran pesanan, senarai duplikat yang dibuat dalam 60 hari terakhir dan menunggu pengesahan pesanan.
  2. Pengguna mengesahkan pesanan (fungsi "OrderConfirmation"). Sistem menghantar pesanan untuk pengeluaran dan memulangkan status pengeluaran semasa.
  3. Pengguna menyemak status pesanan (fungsi "ChkStatus").
  4. Jika pesanan sudah siap, maka Pengguna boleh memuat turun laporan (fungsi "GetReport").
Senarai negara yang tersedia: Finland (FIN), Sweden (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)

Di bawah ini anda boleh menemui contohnya.:

LANGKAH 1: Tempah laporan

Pengguna yang menganggap langkah pengesahan pesanan tidak perlu boleh menggunakan elemen "confirm_order" dan menghantar nilai "TRUE".

Biasanya mengambil masa 10–20 saat untuk menyediakan laporan kredit secara dalam talian.
Oleh itu, untuk laporan dalam talian, anda perlu membuat semakan setiap 5 saat atau lebih.

Senarai syarikat yang tersedia untuk akaun uji:

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
Selain itu, untuk laporan dalam talian (delivery_term = "o"), anda boleh menggunakan sampel yang dijana untuk setiap negara (gunakan: kod pendaftaran "00000000"). Laporan ini percuma dan boleh dipesan menggunakan akaun ujian.
Fungsi Order
Fungsi OrderCancellation

LANGKAH 2. Pengesahan Pesanan

Fungsi OrderConfirmation

LANGKAH 3. Semakan Status

Fungsi ChkStatus

LANGKAH 4. Dapatkan laporan

Senarai bahasa yang tersedia untuk laporan dalam talian: en (English), et (Estonian), ru (Russian), de (German)
Muat turun laporan dalam talian dalam format PDF masih belum tersedia.
Fungsi GetReport

Status-status berikut digunakan untuk laporan:

  • Dalam proses - Laporan pada peringkat pengeluaran
  • 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.

Bagaimana cara memuat turun laporan luar talian?

Anda boleh memuat turun laporan luar talian terus. Berikut ialah arahan cara anda perlu melakukannya:

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

Kesilapan yang mungkin

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

Semua fungsi
  • Nama pengguna/kata laluan tidak betul atau anda tidak mempunyai kebenaran.
    Anda memasukkan butiran log masuk yang salah atau akses API anda dihalang.
Fungsi SimpleSearch
  1. Anda tidak mempunyai kebenaran untuk membuat carian di negara ini.
    Senarai negara yang tersedia: Finland (FIN), Sweden (SWE)
Fungsi Order
  1. Produk ini tidak tersedia.
    Produk seperti itu tidak dapat ditemui dan tidak mungkin untuk memesannya.
  2. Anda tidak boleh memesan laporan mengenai syarikat dengan bentuk undang-undang: "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. Syarikat ini tidak berada dalam senarai ujian.
    Kod pendaftaran syarikat tidak terdapat dalam senarai ujian kami.
    Senarai syarikat yang tersedia untuk akaun uji:
    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. Nama Perniagaan atau Kod Pendaftaran diperlukan
    Apabila memesan laporan luar talian (delivery_term = "n", "f" atau "s"), "Nama Perniagaan" atau "Kod Pendaftaran" diperlukan.
  5. Kod Reg diperlukan apabila terma penghantaran adalah dalam talian.
    Apabila memesan laporan dalam talian (delivery_term = "o"), "Reg Code" diperlukan.
Fungsi GetReport
  1. Bahasa ini tidak disokong.
    Senarai bahasa yang tersedia untuk laporan dalam talian: en (English), et (Estonian), ru (Russian), de (German)
Fungsi GetReport ChkStatus
  1. order_id yang salah.
    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. Anda tidak lagi dibenarkan mengesahkan pesanan. Pengesahan boleh dilakukan dalam masa satu jam selepas anda menerima 'order_id'.

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

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

1) Fungsi baru: ChkFinance

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

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

Untuk membuat pesanan dalam talian, anda perlu menerima 'search_result_id' daripada fungsi 'SimpleSearch', dan hanya selepas itu anda boleh membuat pesanan dalam talian (delivery_term = 'o').

- Perubahan dalam senarai negara yang tersedia untuk laporan kredit dalam talian: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Boleh dimuat turun penyata kewangan (menggunakan produk: kewangan) dalam mod dalam talian: Estonia (EST), Sweden (SWE)

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


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

File: report.xsd

Elemen baru:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Fungsi baru:

- 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

Elemen baru:

- preferable_finances

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

3) SimpleSearchRequest

Elemen telah dialih keluar:

search_block.reg_code

Elemen baru:

search_block->company_code

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

4) SimpleSearchResponse

Elemen yang telah dialih keluar

- code

Elemen baru:

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