Dokumentasi API Infoproff - v2

Beralih versi V2

Memulai

Layanan web wsdl dan skema terletak di sini:

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

Fungsi utama layanan web:

  • SimpleSearch - Mencari informasi perusahaan di berbagai negara.
  • Order - Membuat order_id dan mengembalikan duplikat. Duplikat dipilih dengan parameter berikutnya: country, product, delivery_term and reg_code.
  • OrderCancellation - Jika Anda mengirim permintaan pesanan dan menerima order_id, Anda memiliki kesempatan untuk membatalkan pesanan ini (jika tidak masuk ke produksi).
  • OrderConfirmation - Setelah mendapatkan order_id Anda harus mengkonfirmasi pesanan Anda dalam waktu 1 jam. Jika Anda tidak mengkonfirmasi pesanan Anda dalam waktu 1 jam, pesanan akan dibatalkan secara otomatis.
  • ChkStatus - Periksa status pesanan.
  • GetReport - Dapatkan laporan yang sudah selesai.
  • GetClassifiersFinancialStatements - Dapatkan semua dokumen keuangan dengan semua elemen: row_number, row_formated_description, row_lang_key dan row_order.
  • GetLegalForms - Dapatkan semua formulir legal untuk semua negara yang tersedia.
  • GetActivityClassificators - Dapatkan semua kode dan deskripsi untuk klasifikasi aktivitas tertentu.
  • GetDictionaryStandardPhrases - Dapatkan semua frasa standar dengan kunci dan bahasa.
  • GetAvailableProducts - Dapatkan daftar produk yang tersedia.
  • CreditOpinionCalculator - Kalkulator Opini Kredit membantu menetapkan opini kredit pada perusahaan.

API menyediakan beberapa layanan:

  1. Laporan kredit online untuk negara-negara berikut: Federasi Rusia (RUS), Irlandia (IRL), Kadipaten Agung Luksemburg (LUX), Kerajaan Belanda (NLD), Kerajaan Belgia (BEL), Kerajaan Denmark (DNK), Kerajaan Inggris Raya dan Irlandia Utara (GBR), Kerajaan Norwegia (NOR), Kerajaan Spanyol (ESP), Kerajaan Swedia (SWE), Konfederasi Swiss (CHE), Mongolia (MNG), Republik Austria (AUT), Republik Azerbaijan (AZE), Republik Bulgaria (BGR), Republik Ceko (CZE), Republik Estonia (EST), Republik Federal Jerman (DEU), Republik Finlandia (FIN), Republik Hellenic (GRC), Republik Hongaria (HUN), Republik Italia (ITA), Republik Kazakhstan (KAZ), Republik Kirgistan (KGZ), Republik Kroasia (HRV), Republik Latvia (LVA), Republik Malta (MLT), Republik Moldova (MDA), Republik Polandia (POL), Republik Portugis (PRT), Republik Prancis (FRA), Republik Rakyat Tiongkok (CHN), Republik Slovenia (SVN), Republik Slowakia (SVK)
  2. Laporan offline untuk negara-negara berikut ini: Semua negara
  3. Kalkulator opini kredit
  4. Company search

Bagaimana cara mencari perusahaan?

Pencarian perusahaan terdiri atas 2 opsi:

  1. Cari berdasarkan nama perusahaan,
  2. Cari berdasarkan kode registrasi.
Daftar negara yang tersedia: Republik Finlandia (FIN), Kerajaan Swedia (SWE), Kerajaan Norwegia (NOR), Kerajaan Denmark (DNK)
Informasi penting:
Daftar Norwegia tidak mengizinkan pencarian perusahaan yang dihapus berdasarkan nama. Oleh karena itu, kami tidak dapat menyediakan SimpleSearch berdasarkan nama dalam perusahaan yang dihapus di Norwegia.
Field's length:
company_name varchar(512)
company_code varchar(64)

Di bawah ini Anda bisa menemukan contohnya:

Fungsi SimpleSearch

Opsi 2: Cari berdasarkan kode registrasi

Fungsi SimpleSearch

Bagaimana cara memesan laporan kredit?

Urutan dari pendaftaran hingga penerimaan laporan terdiri atas langkah-langkah berikut ini:

  1. Pengguna mendaftarkan pesanan baru (fungsi "Order"). Sistem mengembalikan rincian pesanan, daftar duplikat yang ditempatkan dalam 60 hari terakhir dan menunggu konfirmasi pesanan.
  2. Pengguna mengonfirmasi pesanan (fungsi "OrderConfirmation"). Sistem mengirimkan pesanan untuk produksi dan mengembalikan status produksi saat ini.
  3. Pengguna memeriksa status pesanan (fungsi "ChkStatus").
  4. Jika pesanan sudah siap, maka Pengguna dapat mengunduh laporan (fungsi "GetReport").
Daftar negara yang tersedia: Republik Finlandia (FIN), Kerajaan Swedia (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 bisa menemukan contohnya:

LANGKAH 1: Laporan pesanan

Pengguna yang menganggap langkah konfirmasi pesanan tidak perlu dapat menggunakan elemen "confirm_order" dan meneruskan nilai "TRUE".

Biasanya dibutuhkan waktu 10-20 detik untuk menyiapkan laporan kredit dalam mode online.
Oleh karena itu, untuk laporan online, Anda harus melakukan pemeriksaan setiap 5 detik atau lebih.

Daftar perusahaan yang tersedia untuk akun uji coba:

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 online (delivery_term = "o"), Anda bisa menggunakan sampel yang dihasilkan untuk setiap negara (gunakan: kode registrasi "00000000"). Laporan-laporan ini gratis dan dapat dipesan dengan menggunakan akun tes.
Fungsi Order
Fungsi OrderCancellation

LANGKAH 2. Konfirmasi Pesanan

Fungsi OrderConfirmation

LANGKAH 3. Pemeriksaan Status

Fungsi ChkStatus

LANGKAH 4. Dapatkan laporan

Daftar bahasa yang tersedia untuk laporan Online: en (English), et (Estonian), ru (Russian), de (German)
Dowloading laporan Online dalam bentuk pdf belum tersedia.
Fungsi GetReport

Status berikut digunakan untuk laporan:

  • Sedang berlangsung - Laporan pada tahap produksi
  • Canceled - Pesanan yang dibatalkan
  • Finished - Laporan sudah siap
  • Updated - Informasi ditambahkan ke laporan yang sudah selesai
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Kesalahan teknis telah terjadi dalam sistem kami. Ini berarti, bahwa kami diberitahu tentang kesalahan ini dan akan memperbaikinya secepatnya. Anda akan diberitahu kapan Anda akan dapat menerima pesanan.

Jika status eksekusi adalah Finished atau Updated, maka Anda bisa mendapatkan order.

Bagaimana cara mengunduh laporan Offline?

Anda dapat mengunduh laporan Offline secara langsung. Berikut adalah instruksi bagaimana Anda perlu melakukannya:

Permintaan terdiri atas 3 bagian:

  1. Memperbaiki bagian https://www.infoproff.com/en/orders/files/
  2. Hash unik Anda, yang kami berikan sebagai tanggapan
  3. Dan bagian yang diperbaiki di bagian akhir /download

Bagaimana cara mendapatkan opini kredit?

Fungsi CreditOpinionCalculator

Bagaimana cara mendapatkan informasi tambahan?

Fungsi GetClassifiersFinancialStatements
Fungsi GetActivityClassificators
Fungsi GetDictionaryStandardPhrases
Fungsi GetAvailableProducts

Kemungkinan kesalahan

Kesalahan-kesalahan ini dapat terjadi ketika membuat permintaan ke layanan web kami.

Semua fungsi
  • Nama pengguna/kata sandi salah atau Anda tidak memiliki izin.
    Anda memasukkan kredensial yang salah atau akses API Anda diblokir.
Fungsi SimpleSearch
  1. Anda tidak memiliki izin untuk mencari di negara ini.
    Daftar negara yang tersedia: Republik Finlandia (FIN), Kerajaan Swedia (SWE)
Fungsi Order
  1. Produk ini tidak tersedia.
    Produk semacam itu tidak dapat ditemukan dan tidak mungkin untuk dipesan.
  2. Anda tidak dapat memesan laporan untuk perusahaan dengan bentuk badan hukum: "bentuk_hukum"
    Kesalahan ini hanya berlaku untuk: Kerajaan Swedia (SWE)
    Di Swedia, tidak dimungkinkan untuk memesan laporan online (delivery_term = "o") dengan formulir legal berikutnya:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Perusahaan ini tidak ada dalam daftar pengujian.
    Kode registrasi perusahaan tidak ada dalam daftar pengujian kami.
    Daftar perusahaan yang tersedia untuk akun uji coba:
    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 Bisnis atau Kode Reg diperlukan
    Ketika memesan laporan offline (delivery_term = "n", "f" atau "s") "Nama Bisnis" atau "Kode Reg" diperlukan.
  5. Kode Reg diperlukan ketika jangka waktu pengiriman adalah Online
    Ketika memesan laporan online (delivery_term = "o") "Kode Reg" diperlukan.
Fungsi GetReport
  1. Bahasa ini tidak didukung.
    Daftar bahasa yang tersedia untuk laporan Online: en (English), et (Estonian), ru (Russian), de (German)
Fungsi GetReport ChkStatus
  1. Order_id salah.
    ID pesanan tidak dapat ditemukan. Anda mendapatkan ID pesanan ketika Anda menggunakan fungsi Order.
Fungsi OrderCancellation
  1. Your order is already canceled.
    Anda tidak memiliki izin untuk membatalkan pesanan lagi.
Fungsi OrderConfirmation
  1. Anda tidak memiliki izin untuk mengonfirmasi pesanan lagi. Konfirmasi dapat dilakukan dalam waktu satu jam setelah Anda menerima 'order_id'.

Perubahan SOAP (Versi 3) dibandingkan dengan SOAP (Versi 2)

Perubahan SOAP (Versi 3) dibandingkan dengan SOAP (Versi 2) [Ikhtisar]

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 melakukan pemesanan online, Anda harus menerima 'search_result_id' dari fungsi 'SimpleSearch', dan hanya setelah itu Anda dapat melakukan pemesanan online (delivery_term = 'o').

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

- Tersedia untuk mengunduh laporan keuangan (menggunakan produk: keuangan) dalam mode online: 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)


Perubahan SOAP (Versi 3) dibandingkan dengan 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 yang dihapus:

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 dihapus

- code

Elemen baru:

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