Infoproff API Dokümantasyonu - v2

Anahtarlı versiyon V2

Başlarken

Web hizmeti wsdl ve şemaları burada bulunur:

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

Web hizmeti ana işlevleri:

  • SimpleSearch - Farklı ülkelerdeki şirket bilgilerini arayın.
  • Order - Bir order_id oluşturur ve kopyaları döndürür. Kopyalar sonraki parametrelere göre seçilir: country, product, delivery_term and reg_code.
  • OrderCancellation - Bir sipariş talebi gönderdiyseniz ve order_id adresini aldıysanız, bu siparişi iptal etme fırsatınız vardır (eğer üretime geçmediyse).
  • OrderConfirmation - order_id adresini aldıktan sonra siparişinizi 1 saat içinde onaylamanız gerekecektir. Eğer siparişinizi 1 saat içinde onaylamazsanız, siparişiniz otomatik olarak iptal edilecektir.
  • ChkStatus - Sipariş durumunu kontrol edin.
  • GetReport - Bitmiş raporları alın.
  • GetClassifiersFinancialStatements - Tüm finansal belgeleri tüm öğelerle birlikte alın: row_number, row_formated_description, row_lang_key ve row_order.
  • GetLegalForms - Mevcut tüm ülkeler için tüm yasal formları alın.
  • GetActivityClassificators - Belirli bir faaliyet sınıflandırıcısı için tüm kodları ve açıklamaları alın.
  • GetDictionaryStandardPhrases - Anahtarlar ve dil ile tüm standart ifadeleri alın.
  • GetAvailableProducts - Mevcut ürünlerin bir listesini alın.
  • CreditOpinionCalculator - Kredi Görüşü Hesaplayıcı, bir şirket hakkında kredi görüşü atamaya yardımcı olur.

API çeşitli hizmetler sağlar:

  1. Aşağıdaki ülkeler için çevrimiçi kredi raporları: Finlandiya Cumhuriyeti (FIN), İsveç Krallığı (SWE)
  2. Aşağıdaki ülkeler için çevrimdışı raporlar: Tüm ülkeler
  3. Kredi görüş hesaplayıcı

Bir şirket nasıl aranır?

Şirket araması 2 seçenekten oluşur:

  1. Şirket adına göre arama,
  2. Kayıt koduna göre arama.
Mevcut ülkelerin listesi: Finlandiya Cumhuriyeti (FIN), İsveç Krallığı (SWE), Norveç Krallığı (NOR), Danimarka Krallığı (DNK)
Önemli bilgiler:
Norveç sicili, silinmiş şirketlerin isimlerine göre aranmasına izin vermemektedir. Bu nedenle, Norveç'te silinen şirketler içinde isimlere göre bir SimpleSearch sağlayamıyoruz.
Field's length:
company_name varchar(512)
company_code varchar(64)

Aşağıda örneği bulabilirsiniz:

Fonksiyon SimpleSearch

Seçenek 2: Kayıt koduna göre arama

Fonksiyon SimpleSearch

Kredi raporu nasıl sipariş edilir?

Kayıttan raporun alınmasına kadar olan süreç şu adımlardan oluşur:

  1. Kullanıcı yeni bir sipariş kaydeder ("Sipariş" işlevi). Sistem sipariş detaylarını, son 60 gün içinde verilen mükerrer siparişlerin listesini verir ve sipariş onayını bekler.
  2. Kullanıcı bir siparişi onaylar ("OrderConfirmation" işlevi). Sistem siparişi üretim için gönderir ve mevcut üretim durumunu döndürür.
  3. Kullanıcı sipariş durumunu kontrol eder ("ChkStatus" fonksiyonu).
  4. Bir sipariş hazırsa, Kullanıcı raporu indirebilir ("GetReport" işlevi).
Mevcut ülkelerin listesi: Finlandiya Cumhuriyeti (FIN), İsveç Krallığı (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)

Aşağıda örneği bulabilirsiniz:

ADIM 1: Rapor sipariş edin

Sipariş onayı adımının gereksiz olduğunu düşünen kullanıcılar "confirm_order" öğesini kullanabilir ve "TRUE" değerini geçebilir.

Kredi raporunun çevrimiçi modda hazırlanması genellikle 10-20 saniye sürer.
Bu nedenle, çevrimiçi raporlar için her 5 veya daha fazla saniyede bir kontrol yapmalısınız.

Bir test hesabı için mevcut şirketlerin listesi:

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
Buna ek olarak, çevrimiçi raporlar için (delivery_term = "o"), her ülke için oluşturulan örnekleri kullanabilirsiniz (kullanım: kayıt kodu "00000000"). Bu raporlar ücretsizdir ve test hesabı kullanılarak sipariş edilebilir.
Fonksiyon Order
Fonksiyon OrderCancellation

ADIM 2. Sipariş Onayı

Fonksiyon OrderConfirmation

ADIM 3. Durum Kontrolü

Fonksiyon ChkStatus

ADIM 4. Rapor alın

Çevrimiçi raporlar için mevcut dillerin listesi: en (English), et (Estonian), ru (Russian), de (German)
Çevrimiçi raporun pdf olarak indirilmesi henüz mevcut değildir.
Fonksiyon GetReport

Raporlar için aşağıdaki durumlar kullanılır:

  • Devam ediyor - Üretim aşamasında rapor
  • Canceled - İptal edilen sipariş
  • Finished - Rapor hazır
  • Updated - Tamamlanan rapora bilgi eklendi
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Sistemimizde teknik bir hata meydana geldi. Bu, bu hata hakkında bilgilendirildiğimiz ve en kısa sürede düzelteceğimiz anlamına gelir. Siparişinizi ne zaman teslim alabileceğiniz konusunda bilgilendirileceksiniz.

Yürütme durumu Finished veya Updated ise, bir emir alabilirsiniz.

Çevrimdışı rapor nasıl indirilir?

Çevrimdışı raporları doğrudan indirebilirsiniz. İşte bunu nasıl yapmanız gerektiğine dair talimat:

Talep 3 bölümden oluşmaktadır:

  1. Sabit parça https://www.infoproff.com/en/orders/files/
  2. Yanıt olarak sağladığımız benzersiz hash'iniz
  3. Ve sondaki sabit kısım /download

Kredi görüşü nasıl alınır?

Fonksiyon CreditOpinionCalculator

Ek bilgi nasıl alınır?

Fonksiyon GetClassifiersFinancialStatements
Fonksiyon GetActivityClassificators
Fonksiyon GetDictionaryStandardPhrases
Fonksiyon GetAvailableProducts

Olası hatalar

Web servisimize talepte bulunurken bu hatalar oluşabilir.

Tüm fonksiyonlar
  • Yanlış kullanıcı adı/şifre veya izniniz yok.
    Yanlış kimlik bilgileri giriyorsunuz veya API erişiminiz engellendi.
Fonksiyon SimpleSearch
  1. Bu ülkede arama izniniz yok.
    Mevcut ülkelerin listesi: Finlandiya Cumhuriyeti (FIN), İsveç Krallığı (SWE)
Fonksiyon Order
  1. Bu ürün mevcut değildir.
    Böyle bir ürün bulunamıyor ve sipariş vermek mümkün değil.
  2. Yasal formu olan şirket hakkında rapor sipariş edemezsiniz: "legal_form"
    Bu hata yalnızca aşağıdakiler için geçerlidir: İsveç Krallığı (SWE)
    İsveç'te bir sonraki yasal formlarla birlikte çevrimiçi rapor (delivery_term = "o") sipariş etmek mümkün değildir:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Bu şirket test listesinde yer almamaktadır.
    Şirket kayıt kodu test listemizde yer almamaktadır.
    Bir test hesabı için mevcut şirketlerin listesi:
    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. İşletme Adı veya Sicil Kodu gereklidir
    Çevrimdışı rapor sipariş ederken (delivery_term = "n", "f" veya "s") "İşletme Adı" veya "Reg Kodu" gereklidir.
  5. Teslimat süresi Çevrimiçi olduğunda Reg Kodu gereklidir
    Online rapor siparişi verirken (delivery_term = "o") "Reg Code" gereklidir.
Fonksiyon GetReport
  1. Bu dil desteklenmemektedir.
    Çevrimiçi raporlar için mevcut dillerin listesi: en (English), et (Estonian), ru (Russian), de (German)
Fonksiyonlar GetReport ChkStatus
  1. Yanlış sipariş_id'si.
    Sipariş kimliği bulunamıyor. Order işlevini kullandığınızda sipariş kimliğini alırsınız.
Fonksiyon OrderCancellation
  1. Your order is already canceled.
    Artık siparişi iptal etme izniniz yok.
Fonksiyon OrderConfirmation
  1. Artık siparişi onaylamak için izniniz yok. Onaylama, 'order_id' aldıktan sonra bir saat içinde yapılabilir.

SOAP (Sürüm 2) ile karşılaştırıldığında SOAP (Sürüm 3) değişiklikleri

SOAP (Sürüm 2) ile karşılaştırıldığında SOAP (Sürüm 3) değişiklikleri [Genel Bakış]

1) Yeni fonksiyon: ChkFinance

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

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

Online sipariş vermek için 'SimpleSearch' fonksiyonundan 'search_result_id' almanız gerekir ve ancak bundan sonra online (delivery_term = 'o') sipariş verebilirsiniz.

- Çevrimiçi kredi raporları için mevcut ülkeler listesinde değişiklikler: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Mali tabloları (ürün: finans kullanarak) çevrimiçi modda indirmek için kullanılabilir: Estonia (EST), Sweden (SWE)

3) Fonksiyon: 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 (Sürüm 2) ile karşılaştırıldığında SOAP (Sürüm 3) değişiklikleri [WSDL and XSD]

File: report.xsd

Yeni unsurlar:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Yeni fonksiyon:

- 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

Yeni unsur:

- preferable_finances

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

3) SimpleSearchRequest

Kaldırılan öğe:

search_block.reg_code

Yeni unsur:

search_block->company_code

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

4) SimpleSearchResponse

Kaldırılan öğeler

- code

Yeni unsurlar:

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