Infoproff-ის API-ს დოკუმენტაცია - v2

ვერსიის შეცვლა V2

დაწყება

ვებ-სერვისის WSDL და სქემები განთავსებულია აქ:

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

ვებ სერვისის ძირითადი ფუნქციები:

  • SimpleSearch - სხვადასხვა ქვეყანაში კომპანიების შესახებ ინფორმაციის მოძიება.
  • Order - ქმნის order_id -ს და აბრუნებს დუბლიკატებს. დუბლიკატები შეირჩევა შემდეგი პარამეტრების მიხედვით: country, product, delivery_term and reg_code.
  • OrderCancellation - თუ თქვენ გაგზავნეთ შეკვეთის მოთხოვნა და მიიღეთ order_id, გაქვთ შესაძლებლობა გააუქმოთ ეს შეკვეთა (თუ ის ჯერ არ გადასულა წარმოებაში).
  • OrderConfirmation - order_id-ის მიღების შემდეგ, თქვენი შეკვეთა უნდა დაადასტუროთ 1 საათის განმავლობაში. თუ შეკვეთას 1 საათის განმავლობაში არ დაადასტურებთ, ის ავტომატურად გაუქმდება.
  • ChkStatus - შეკვეთის სტატუსის შემოწმება
  • GetReport - მიიღეთ დასრულებული ანგარიშები.
  • GetClassifiersFinancialStatements - მიიღეთ ყველა ფინანსური დოკუმენტი ყველა ელემენტით: row_number, row_formated_description, row_lang_key და row_order.
  • GetLegalForms - მიიღეთ ყველა იურიდიული ფორმა ყველა ხელმისაწვდომი ქვეყნისთვის.
  • GetActivityClassificators - მიიღეთ ყველა კოდი და აღწერა კონკრეტული აქტივობის კლასიფიკატორისთვის.
  • GetDictionaryStandardPhrases - მიიღეთ ყველა სტანდარტული ფრაზა გასაღებებითა და ენით.
  • GetAvailableProducts - მიიღეთ ხელმისაწვდომი პროდუქტების სია.
  • CreditOpinionCalculator - საკრედიტო შეფასების კალკულატორი კომპანიის საკრედიტო შეფასების დადგენაში გეხმარებათ.

API გთავაზობთ რამდენიმე სერვისს:

  1. ონლაინ საკრედიტო ანგარიშები შემდეგი ქვეყნებისთვის: ავსტრია (AUT), აზერბაიჯანი (AZE), ბელგია (BEL), ბულგარეთი (BGR), გაერთიანებული სამეფო (GBR), გერმანია (DEU), დანია (DNK), ესპანეთი (ESP), ესტონეთი (EST), ირლანდია (IRL), იტალია (ITA), ლატვია (LVA), ლუქსემბურგი (LUX), მალტა (MLT), მოლდოვა (MDA), მონღოლეთი (MNG), ნიდერლანდები (NLD), ნორვეგია (NOR), პოლონეთი (POL), პორტუგალია (PRT), რუსეთი (RUS), საბერძნეთი (GRC), საფრანგეთი (FRA), სლოვაკეთი (SVK), სლოვენია (SVN), უნგრეთი (HUN), ფინეთი (FIN), ყაზახეთი (KAZ), ყირგიზეთი (KGZ), შვედეთი (SWE), შვეიცარია (CHE), ჩეხეთი (CZE), ჩინეთი (CHN), ხორვატია (HRV)
  2. ოფლაინ ანგარიშები შემდეგი ქვეყნებისთვის: ყველა ქვეყანა
  3. საკრედიტო მოსაზრების კალკულატორი
  4. Company search

როგორ მოვძებნოთ კომპანია?

კომპანიის ძიება შედგება 2 ვარიანტისგან:

  1. კომპანიის სახელის მიხედვით ძიება,
  2. ძიება სარეგისტრაციო კოდით.
ხელმისაწვდომი ქვეყნების სია: ფინეთი (FIN), შვედეთი (SWE), ნორვეგია (NOR), დანია (DNK)
მნიშვნელოვანი ინფორმაცია:
ნორვეგიის რეესტრი წაშლილი კომპანიების სახელებით ძიების საშუალებას არ იძლევა. ამიტომ, ჩვენ ვერ ვთავაზობთ SimpleSearch -ს სახელების მიხედვით ნორვეგიის წაშლილ კომპანიებს შორის.
Field's length:
company_name varchar(512)
company_code varchar(64)

ქვემოთ შეგიძლიათ იხილოთ მაგალითი:

ფუნქცია SimpleSearch

ვარიანტი 2: ძიება სარეგისტრაციო კოდით

ფუნქცია SimpleSearch

როგორ შევუკვეთოთ საკრედიტო ისტორიის ანგარიში?

რეგისტრაციიდან ანგარიშის მიღებამდე პროცესი შედგება შემდეგი ეტაპებისგან:

  1. მომხმარებელი ახალ შეკვეთას რეგისტრირებს ("შეკვეთა" ფუნქცია). სისტემა აბრუნებს შეკვეთის დეტალებს, ბოლო 60 დღის განმავლობაში განთავსებული დუბლიკატების სიას და ელოდება შეკვეთის დადასტურებას.
  2. მომხმარებელი ადასტურებს შეკვეთას (ფუნქცია "OrderConfirmation"). სისტემა აგზავნის შეკვეთას წარმოებაში და აბრუნებს წარმოების მიმდინარე სტატუსს.
  3. მომხმარებელი ამოწმებს შეკვეთის სტატუსს (ფუნქცია "ChkStatus").
  4. თუ შეკვეთა მზადაა, მაშინ მომხმარებელს შეუძლია ანგარიშის ჩამოტვირთვა (ფუნქცია "GetReport").
ხელმისაწვდომი ქვეყნების სია: ფინეთი (FIN), შვედეთი (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)

ქვემოთ შეგიძლიათ იხილოთ მაგალითი:

ნაბიჯი 1: ანგარიშის შეკვეთა

მომხმარებლებს, რომლებიც შეკვეთის დადასტურების ეტაპს არასაჭიროდ მიიჩნევენ, შეუძლიათ გამოიყენონ ელემენტი "confirm_order" და გადასცენ მნიშვნელობა "TRUE".

ჩვეულებრივ, ონლაინ რეჟიმში საკრედიტო ისტორიის მომზადებას 10-20 წამი სჭირდება.
ამიტომ, ონლაინ ანგარიშებისთვის, შემოწმება უნდა ჩაატაროთ ყოველ 5 ან მეტი წამში.

სატესტო ანგარიშისთვის ხელმისაწვდომი კომპანიების სია:

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
გარდა ამისა, ონლაინ ანგარიშებისთვის (delivery_term = "o"), შეგიძლიათ გამოიყენოთ თითოეული ქვეყნისთვის გენერირებული ნიმუშები (გამოიყენეთ: სარეგისტრაციო კოდი "00000000"). ეს ანგარიშები უფასოა და მათი შეკვეთა შესაძლებელია სატესტო ანგარიშის გამოყენებით.
ფუნქცია Order
ფუნქცია OrderCancellation

ნაბიჯი 2. შეკვეთის დადასტურება

ფუნქცია OrderConfirmation

ნაბიჯი 3. სტატუსის შემოწმება

ფუნქცია ChkStatus

ნაბიჯი 4. მიიღეთ ანგარიში

ონლაინ ანგარიშებისთვის ხელმისაწვდომი ენების სია: en (English), et (Estonian), ru (Russian), de (German)
ონლაინ ანგარიშის PDF ფაილად ჩამოტვირთვა ჯერ არ არის ხელმისაწვდომი.
ფუნქცია GetReport

ანგარიშებისთვის გამოიყენება შემდეგი სტატუსები:

  • მიმდინარეობს - ანგარიში საწარმოო ეტაპზე
  • Canceled - გაუქმებული შეკვეთა
  • Finished - ანგარიში მზადაა
  • Updated - დამუშავებულ ანგარიშს დაემატა ინფორმაცია.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - ჩვენს სისტემაში ტექნიკური ხარვეზი მოხდა. ეს ნიშნავს, რომ ჩვენ ინფორმირებული ვართ ამ ხარვეზის შესახებ და მას უმოკლეს დროში გამოვასწორებთ. თქვენ შეგატყობინებენ, როდესაც შეკვეთის მიღებას შეძლებთ.

თუ შესრულების სტატუსია {დასრულებული} ან {განახლებული}, მაშინ შეგიძლიათ მიიღოთ შეკვეთა.

როგორ გადმოვწეროთ ოფლაინ ანგარიში?

შეგიძლიათ პირდაპირ ჩამოტვირთოთ ოფლაინ ანგარიშები. აი ინსტრუქცია, თუ როგორ უნდა გააკეთოთ ეს:

მოთხოვნა შედგება 3 ნაწილისგან:

  1. ფიქსირებული ნაწილი https://www.infoproff.com/en/orders/files/
  2. თქვენი უნიკალური ჰეში, რომელსაც ჩვენ პასუხად ვაწვდით
  3. და ფიქსირებული ნაწილი ბოლოს /download

როგორ მივიღო საკრედიტო შეთავაზება?

ფუნქცია CreditOpinionCalculator

როგორ მივიღო დამატებითი ინფორმაცია?

ფუნქცია GetClassifiersFinancialStatements
ფუნქცია GetActivityClassificators
ფუნქცია GetDictionaryStandardPhrases
ფუნქცია GetAvailableProducts

შესაძლო შეცდომები

ეს შეცდომები შეიძლება მოხდეს ჩვენი ვებ-სერვისისთვის მოთხოვნის გაგზავნისას.

ყველა ფუნქცია
  • არასწორი მომხმარებლის სახელი/პაროლი ან არ გაქვთ უფლებები.
    თქვენ არასწორ მონაცემებს შეიყვანთ ან თქვენი API-ზე წვდომა დაბლოკილია.
ფუნქცია SimpleSearch
  1. თქვენ არ გაქვთ ამ ქვეყანაში ძიების უფლება.
    ხელმისაწვდომი ქვეყნების სია: ფინეთი (FIN), შვედეთი (SWE)
ფუნქცია Order
  1. ეს პროდუქტი ხელმისაწვდომი არ არის.
    ასეთი პროდუქტი ვერ მოიძებნა და მისი შეკვეთა შეუძლებელია.
  2. არ შეგიძლიათ შეუკვეთოთ ანგარიში კომპანიაზე, რომლის სამართლებრივი ფორმაა: "legal_form".
    ეს შეცდომა მხოლოდ ეხება: შვედეთი (SWE)
    შვედეთში შეუძლებელია ონლაინ ანგარიშის (delivery_term = "o") შეკვეთა შემდეგი იურიდიული ფორმებით:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. ეს კომპანია არ არის ტესტების სიაში.
    კომპანიის სარეგისტრაციო კოდი არ არის ჩვენს სატესტო სიაში.
    სატესტო ანგარიშისთვის ხელმისაწვდომი კომპანიების სია:
    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. საჭიროა ბიზნესის სახელი ან სარეგისტრაციო კოდი
    ოფლაინ ანგარიშის შეკვეთისას (delivery_term = "n", "f" or "s") აუცილებელია "საწარმოს დასახელება" ან "სარეგისტრაციო კოდი".
  5. მიწოდების პირობა ონლაინის შემთხვევაში საჭიროა რეგ კოდი
    ონლაინ ანგარიშის შეკვეთისას (delivery_term = "o") აუცილებელია "Reg Code"-ის მითითება.
ფუნქცია GetReport
  1. ეს ენა მხარდაჭერილი არ არის.
    ონლაინ ანგარიშებისთვის ხელმისაწვდომი ენების სია: en (English), et (Estonian), ru (Russian), de (German)
ფუნქციები GetReport ChkStatus
  1. არასწორი შეკვეთის ID.
    შეკვეთის ID ვერ მოიძებნა. შეკვეთის ID მიიღებთ Order ფუნქციის გამოყენებით.
ფუნქცია OrderCancellation
  1. Your order is already canceled.
    შეკვეთის გაუქმების უფლება აღარ გაქვთ.
ფუნქცია OrderConfirmation
  1. თქვენ აღარ გაქვთ შეკვეთის დადასტურების უფლება. დადასტურება შესაძლებელია "order_id"-ის მიღებიდან ერთ საათში.

SOAP-ის (ვერსია 3) ცვლილებები SOAP-ის (ვერსია 2) მიმართ

SOAP-ის (ვერსია 3) ცვლილებები SOAP-ის (ვერსია 2) მიმართ [ზოგადი მიმოხილვა]

1) ახალი ფუნქცია: ChkFinance

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

2) ფუნქცია: 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) ფუნქცია: Order
Identification is required!

ონლაინ შეკვეთის გასაფორმებლად, თქვენ უნდა მიიღოთ 'search_result_id' ფუნქციიდან 'SimpleSearch', და მხოლოდ ამის შემდეგ შეგიძლიათ გააფორმოთ ონლაინ (delivery_term = 'o') შეკვეთა.

- ცვლილებები ონლაინ საკრედიტო ანგარიშების ხელმისაწვდომი ქვეყნების სიაში: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- ხელმისაწვდომია ფინანსური ანგარიშგების ჩამოტვირთვა (პროდუქტის გამოყენებით: ფინანსები) ონლაინ რეჟიმში.: Estonia (EST), Sweden (SWE)

3) ფუნქცია: 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) ცვლილებები SOAP-ის (ვერსია 2) მიმართ [WSDL and XSD]

File: report.xsd

ახალი ელემენტები:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

ახალი ფუნქცია:

- 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

ახალი ელემენტი:

- preferable_finances

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

3) SimpleSearchRequest

მოშორებული ელემენტი:

search_block.reg_code

ახალი ელემენტი:

search_block->company_code

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

4) SimpleSearchResponse

ამოღებული ელემენტები

- code

ახალი ელემენტები:

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