Infoproff API sənədləşdirilməsi - v2


Başlamaq


Web xidmətinin WSDL və sxemaları burada yerləşir.:

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

Veb xidmətin əsas funksiyaları:

  • SimpleSearch - Fərqli ölkələrdəki şirkətlər haqqında məlumat axtarın.
  • Order - order_id yaradır və təkrarları qaytarır. Təkrarlar aşağıdakı parametrlərə görə seçilir: country, product, delivery_term and reg_code.
  • OrderCancellation - Əgər sifariş tələbi göndərmisinizsə və order_id-i alıbsınızsa, bu sifarişi ləğv etmək imkanı var (əgər o hələ istehsala daxil olmayıbsa).
  • OrderConfirmation - order_id alındıqdan sonra sifarişinizi 1 saat ərzində təsdiqləməlisiniz. Əgər 1 saat ərzində sifarişinizi təsdiqləməsəniz, sifariş avtomatik ləğv ediləcək.
  • ChkStatus - Sifarişin statusunu yoxlayın.
  • GetReport - Bitmiş hesabatları əldə edin.
  • GetClassifiersFinancialStatements - Bütün maliyyə sənədlərini bütün elementlərlə əldə edin: row_number, row_formated_description, row_lang_key və row_order.
  • GetLegalForms - Bütün mövcud ölkələr üçün bütün hüquqi formaları əldə edin.
  • GetActivityClassificators - Müəyyən fəaliyyət təsnifatçısı üçün bütün kodları və təsvirləri əldə edin.
  • GetDictionaryStandardPhrases - Bütün standart ifadələri açarlar və dil ilə əldə edin.
  • GetAvailableProducts - Mövcud məhsulların siyahısını əldə edin.
  • CreditOpinionCalculator - Kredit Rəy Hesablayıcısı şirkətə kredit rəyinin təyin edilməsinə kömək edir.

API bir neçə xidmət təklif edir:

  1. Aşağıdakı ölkələr üçün onlayn kredit hesabatları: Almaniya (DEU), Avstriya (AUT), Azərbaycan (AZE), Belçika (BEL), Birləşmiş Krallıq (GBR), Bolqarıstan (BGR), Danimarka (DNK), Estoniya (EST), Finlandiya (FIN), Fransiya (FRA), Latviya (LVA), Lüksemburq (LUX), Macarıstan (HUN), Malta (MLT), Moldova (MDA), Monqolustan (MNG), Niderland (NLD), Norveç (NOR), Polşa (POL), Portuqaliya (PRT), Qazaxıstan (KAZ), Qırğızıstan (KGZ), Rusiya (RUS), Slovakiya (SVK), Sloveniya (SVN), Xorvatiya (HRV), Yunanıstan (GRC), Çexiya (CZE), Çin (CHN), İrlandiya (IRL), İspaniya (ESP), İsveç (SWE), İsveçrə (CHE), İtaliya (ITA)
  2. Aşağıdakı ölkələr üçün oflayn hesabatlar: Bütün ölkələr
  3. Kredit rəyi kalkulyatoru
  4. Company search

Şirkəti necə axtarmaq olar?


Şirkət axtarışı 2 seçimdən ibarətdir:

  1. Şirkət adı ilə axtar,
  2. Qeydiyyat kodu ilə axtar.
Mövcud ölkələrin siyahısı: Finlandiya (FIN), İsveç (SWE), Norveç (NOR), Danimarka (DNK)
Vacib məlumat:
Norveç reyestri silinmiş şirkətləri adlarına görə axtarmağa imkan vermir. Buna görə də Norveçdə silinmiş şirkətlər arasında adlara görə SimpleSearch təmin edə bilmərik.
Field's length:
company_name varchar(512)
company_code varchar(64)

Aşağıda nümunəni görə bilərsiniz.:


Funksiya SimpleSearch

Seçim 2: Qeydiyyat kodu ilə axtarın

Funksiya SimpleSearch

Kredit hesabatını necə sifariş etmək olar?


Qeydiyyatdan hesabatın alınmasına qədərki proses bu addımlardan ibarətdir:

  1. İstifadəçi yeni sifariş yaradır ("Sifariş" funksiyası). Sistem sifarişin detalları, son 60 gün ərzində yerləşdirilmiş dublikatların siyahısını göstərir və sifarişin təsdiqini gözləyir.
  2. İstifadəçi sifarişi təsdiqləyir (funksiya "OrderConfirmation"). Sistem sifarişi istehsala göndərir və cari istehsal statusunu qaytarır.
  3. İstifadəçi sifarişin statusunu yoxlayır ("ChkStatus" funksiyası).
  4. Əgər sifariş hazırdırsa, istifadəçi hesabatı yükləyə bilər (GetReport funksiyası).
Mövcud ölkələrin siyahısı: Finlandiya (FIN), İsveç (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 nümunəni görə bilərsiniz.:


1-ci addım: Hesabatı sifariş edin

Sifarişi təsdiqləmə mərhələsini lazımsız sayan istifadəçilər "confirm_order" elementindən istifadə edib "TRUE" dəyərini ötürə bilərlər.

Adətən onlayn rejimdə kredit hesabatını hazırlamaq 10-20 saniyə çəkir.
Buna görə də onlayn hesabatlar üçün hər 5 saniyə və ya daha çox aralıqlarla yoxlamalar etməlisiniz.

Test hesabı üçün mövcud şirkətlərin siyahısı:

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
Bundan əlavə, (delivery_term = "o") onlayn hesabatları üçün hər bir ölkə üçün yaradılmış nümunələrdən (qeydiyyat kodu: "00000000") istifadə edə bilərsiniz. Bu hesabatlar pulsuzdur və test hesabı vasitəsilə sifariş edilə bilər.
Funksiya Order

Funksiya OrderCancellation

2-ci addım. Sifarişin təsdiqi

Funksiya OrderConfirmation

3-cü addım. Vəziyyətin yoxlanılması

Funksiya ChkStatus

4-cü addım. Hesabatı əldə edin

Onlayn hesabatlar üçün mövcud dillər siyahısı: en (English), et (Estonian), ru (Russian), de (German)
Onlayn hesabatın PDF formatında yüklənməsi hələ mövcud deyil.
Funksiya GetReport

Hesabatlar üçün aşağıdakı statuslar istifadə olunur:

  • Gedir - İstehsal mərhələsində hesabat
  • Canceled - Ləğv edilmiş sifariş
  • Finished - Hesabat hazırdır
  • Updated - Bitmiş hesabatda məlumat əlavə edildi.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Sistemimizdə texniki nasazlıq yaranıb. Bu o deməkdir ki, biz bu nasazlıq barədə məlumatlıyıq və onu ən qısa zamanda aradan qaldıracağıq. Sifarişi qəbul edə biləcəyiniz zaman sizə məlumat veriləcək.

Əgər icra statusu {tamamlanmış} və ya {yenilənmiş}dirsə, onda sifariş əldə edə bilərsiniz.

Oflayn hesabatı necə yükləmək olar?


Offlayn hesabatları birbaşa yükləyə bilərsiniz. Bunu necə etməli olduğunuz barədə təlimat aşağıdadır:

Tələb 3 hissədən ibarətdir:

  1. https://www.infoproff.com/en/orders/files/ düzəldildi
  2. Sizin unikal haşınız, hansını ki biz cavab olaraq təqdim edirik
  3. Və sonunda sabit hissə /download

Kredit rəyi necə əldə etmək olar?


Funksiya CreditOpinionCalculator

Əlavə məlumatı necə əldə etmək olar?


Funksiya GetClassifiersFinancialStatements
Funksiya GetActivityClassificators
Funksiya GetDictionaryStandardPhrases
Funksiya GetAvailableProducts

Mümkün səhvlər


Bu səhvlər veb xidmətimizə sorğu göndərərkən baş verə bilər..


Bütün funksiyalar
  • Səhv istifadəçi adı/şifrə və ya icazəniz yoxdur.
    Siz yanlış giriş məlumatları daxil edirsiniz və ya API girişiniz bloklanıb.

Funksiya SimpleSearch
  1. Bu ölkədə axtarış aparmaq icazəniz yoxdur.
    Mövcud ölkələrin siyahısı: Finlandiya (FIN), İsveç (SWE)
Funksiya Order
  1. Bu məhsul mövcud deyil.
    Belə məhsul tapıla bilməz və sifariş etmək mümkün deyil.
  2. Hüquqi forması "legal_form" olan şirkət üçün hesabat sifariş edə bilməzsiniz.
    Bu səhv yalnız üçün keçərlidir: İsveç (SWE)
    İsveçdə onlayn hesabatı (delivery_term = "o") aşağıdakı hüquqi formalarla sifariş etmək mümkün deyil:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Bu şirkət test siyahısında deyil.
    Şirkətin qeydiyyat kodu test siyahımızda yoxdur.
    Test hesabı üçün mövcud şirkətlərin siyahısı:
    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. Biznes adı və ya qeydiyyat kodu tələb olunur
    Oflayn hesabat sifariş edərkən (delivery_term = "n", "f" və ya "s") "Business Name" və ya "Reg Code" tələb olunur.
  5. Çatdırılma müddəti onlayn olduqda Reg Code tələb olunur.
    Onlayn hesabat sifariş edərkən (delivery_term = "o") "Reg Code" tələb olunur.

Funksiya GetReport
  1. Bu dil dəstəklənmir.
    Onlayn hesabatlar üçün mövcud dillər siyahısı: en (English), et (Estonian), ru (Russian), de (German)

Funksiyalar GetReport ChkStatus
  1. Sifariş_id düzgün deyil.
    Sifariş ID-si tapılmadı. Order funksiyasından istifadə edərək sifariş ID-sini əldə edirsiniz.

Funksiya OrderCancellation
  1. Your order is already canceled.
    Sifarişi ləğv etmək icazəniz artıq yoxdur.

Funksiya OrderConfirmation
  1. Siz artıq sifarişi təsdiqləmək icazəsinə malik deyilsiniz. Sifariş ID-sini aldıqdan sonra bir saat ərzində təsdiq edə bilərsiniz.

SOAP (3-cü versiya) SOAP (2-ci versiya) ilə müqayisədə dəyişikliklər


SOAP (3-cü versiya) SOAP (2-ci versiya) ilə müqayisədə dəyişikliklər [Ümumi baxış]

1) Yeni funksiya: ChkFinance

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

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

Onlayn sifariş vermək üçün 'SimpleSearch' funksiyasından 'search_result_id' dəyərini almalısınız və yalnız bundan sonra onlayn (delivery_term = 'o') sifariş verə bilərsiniz.

- Onlayn kredit hesabatları üçün mövcud ölkələr siyahısında dəyişikliklər: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Maliyyə hesabatlarını onlayn rejimdə yükləmək mümkündür (məhsul: finances istifadə olunur): Estonia (EST), Sweden (SWE)

3) Funksiya: 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-cü versiya) SOAP (2-ci versiya) ilə müqayisədə dəyişikliklər [WSDL and XSD]

File: report.xsd

Yeni elementlər:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Yeni funksiya:

- 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 element:

- preferable_finances

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

3) SimpleSearchRequest

Element silindi:

search_block.reg_code

Yeni element:

search_block->company_code

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

4) SimpleSearchResponse

Silinmiş elementlər

- code

Yeni elementlər:

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