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

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

დაწყება

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

http://wsdfn.infoproff.com/v3/

Web service functions:

  • SimpleSearch - სხვადასხვა ქვეყანაში კომპანიების შესახებ ინფორმაციის მოძიება.
  • ChkFinance - ხელმისაწვდომი ფინანსური ანგარიშგების ძიება
  • Order - ქმნის order_id -ს და აბრუნებს დუბლიკატებს. დუბლიკატები შეირჩევა შემდეგი პარამეტრების მიხედვით: country, product, 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. Search by company code.
ხელმისაწვდომი ქვეყნების სია: ავსტრალია (AUS), ავსტრია (AUT), აზერბაიჯანი (AZE), ალბანეთი (ALB), ალჟირი (DZA), ანგოლა (AGO), არგენტინა (ARG), ახალი ზელანდია (NZL), ბელარუსი (BLR), ბელგია (BEL), ბენინი (BEN), ბოლივია (BOL), ბოსნია და ჰერცეგოვინა (BIH), ბოტსვანა (BWA), ბრაზილია (BRA), ბულგარეთი (BGR), გაერთიანებული სამეფო (GBR), გაიანა (GUY), გამბია (GMB), გერმანია (DEU), გვადელუპა (GLP), გივია (GIN), გრინლანდია (GRL), გუანა (GUF), დანია (DNK), ეთიოპია (ETH), ეკვადორი (ECU), ესპანეთი (ESP), ესტონეთი (EST), ვენესუელა (VEN), ზამბია (ZMB), ზიმბაბვე (ZWE), იაპონია (JPN), ირლანდია (IRL), ისლანდია (ISL), ისრაელი (ISR), იტალია (ITA), კანადა (CAN), კენია (KEN), კვიპროსი (CYP), კონგო (COG), კოსოვო (XXK), ლატვია (LVA), ლიტვა (LTU), ლიხტენშტაინი (LIE), ლუქსემბურგი (LUX), მადაგასკარი (MDG), მავრიკი (MUS), მაიოტა (MYT), მალდივები (MDV), მალტა (MLT), მაროკო (MAR), მარტინიკი (MTQ), მენი (IMN), მოლდოვა (MDA), მონაკო (MCO), მონღოლეთი (MNG), ნამიბია (NAM), ნიგერია (NGA), ნიდერლანდები (NLD), ნორვეგია (NOR), პარაგვაი (PRY), პერუ (PER), პოლონეთი (POL), პორტუგალია (PRT), რუანდა (RWA), რუმინეთი (ROU), რუსეთი (RUS), საბერძნეთი (GRC), სამოა (WSM), სამხრეთ აფრიკა (ZAF), სან-მარინო (SMR), საფრანგეთი (FRA), საქართველო (GEO), სეიშელები (SYC), სერბეთი (SRB), სინგაპური (SGP), სლოვაკეთი (SVK), სლოვენია (SVN), ტაივანი (TWN), ტაილანდი (THA), ტანზანია (TZA), ტაჯიკისტანი (TJK), ტოგო (TGO), უზბეკეთი (UZB), უნგრეთი (HUN), ურუგვაი (URY), ფილიპინები (PHL), ფინეთი (FIN), ქობინის სანაპირო (CIV), ყაზახეთი (KAZ), ყირგიზეთი (KGZ), შეხვედრა (REU), შვედეთი (SWE), შვეიცარია (CHE), შრი-ლანკა (LKA), ჩეხეთი (CZE), ჩილე (CHL), ჩინეთი (CHN), წმინდა მარტინი (MAF), ხორვატია (HRV), ჯერზი (JEY), ჰონგ-კონგი (HKG)

The search for other countries is performed only in the database of archived reports. If you do not find the desired company, enter the company details manually.

მნიშვნელოვანი ინფორმაცია:

search_result_id can be acquired here for orders with delivery_term = "o" or delivery_term = "a".

It may take up to 20 seconds to respond to a search request in the following countries: United Kingdom, Ireland, France, Spain, Portugal, Germany, Italy, Austria, Switzerland.

ნორვეგიის რეესტრი წაშლილი კომპანიების სახელებით ძიების საშუალებას არ იძლევა. ამიტომ, ჩვენ ვერ ვთავაზობთ SimpleSearch -ს სახელების მიხედვით ნორვეგიის წაშლილ კომპანიებს შორის.

Field's length:
company_name varchar(512)
company_code varchar(64)

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

ფუნქცია SimpleSearch

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

ფუნქცია SimpleSearch

Option 3: Search by query (by name or code)

ფუნქცია UnifiedSearch

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

List of available countries for online credit reports: ავსტრია (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)
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)

Below you can find the example of how to order and download reports:

STEP 1: Find a company (Online/Offline Order (with search_result_id))

ფუნქცია SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: როგორ მოვძებნოთ კომპანია?

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: Order a report (Online/Offline Order (with search_result_id))

ფუნქცია Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 3: Order cancellation (Optional) (Online/Offline Order (with search_result_id))

ფუნქცია OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 4: Order confirmation (Online/Offline Order (with search_result_id))

ფუნქცია OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 5: Check order status (Online/Offline Order (with search_result_id))

ფუნქცია ChkStatus
  • - For offline orders checking order status once every 30 minutes is acceptable frequency.
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

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

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

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

STEP 6: Get report (Online/Offline Order (with search_result_id))

ფუნქცია GetReport
ხელმისაწვდომი ენების სია: ar (Arabic), az (Azerbaijani), bg (ბულგარული), cs (ჩეხური), da (დანიური), de (გერმანული), el (ბერძნული), en (ინგლისური), es (ესპანური), et (ესტონური), fi (ფინური), fr (ფრანგული), he (Hebrew), hi (Hindi), hu (უნგრული), hy (Armenian), id (ინდონეზიური), it (იტალიური), ja (იაპონური), ka (Georgian), kk (Kazakh), ko (კორეული), lt (ლიტვური), lv (ლატვიური), mn (Mongolian), ms (Malay), nb (ნორვეგიული ბოკმოლი), nl (ჰოლანდიური), pl (პოლონური), pt (პორტუგალიური), ro (რუმინული), ru (რუსული), sk (სლოვაკური), sl (სლოვენური), sr (Српски), sv (შვედური), th (Thai), tr (თურქული), uk (უკრაინული), uz (Uzbek), vi (Vietnamese), zh (ჩინური)

STEP 1: Order a report (Offline Order (without search_result_id))

ფუნქცია Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 2: Order cancellation (Optional) (Offline Order (without search_result_id))

ფუნქცია OrderCancellation
If you wish to cancel the order, you can use OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 3: Order confirmation (Offline Order (without search_result_id))

ფუნქცია OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 4: Status Checking (Offline Order (without search_result_id))

ფუნქცია ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

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

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

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

STEP 5: Get report (Offline Order (without search_result_id))

ფუნქცია GetReport
ხელმისაწვდომი ენების სია: ar (Arabic), az (Azerbaijani), bg (ბულგარული), cs (ჩეხური), da (დანიური), de (გერმანული), el (ბერძნული), en (ინგლისური), es (ესპანური), et (ესტონური), fi (ფინური), fr (ფრანგული), he (Hebrew), hi (Hindi), hu (უნგრული), hy (Armenian), id (ინდონეზიური), it (იტალიური), ja (იაპონური), ka (Georgian), kk (Kazakh), ko (კორეული), lt (ლიტვური), lv (ლატვიური), mn (Mongolian), ms (Malay), nb (ნორვეგიული ბოკმოლი), nl (ჰოლანდიური), pl (პოლონური), pt (პორტუგალიური), ro (რუმინული), ru (რუსული), sk (სლოვაკური), sl (სლოვენური), sr (Српски), sv (შვედური), th (Thai), tr (თურქული), uk (უკრაინული), uz (Uzbek), vi (Vietnamese), zh (ჩინური)

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

Purchase of an archived report is available for all countries.

Below you can find the example of how to order and download archived reports:

STEP 1: Find a company

ფუნქცია SimpleSearch

To order an archived report you need to receive "<search_result_id>" which has an "<archived_reports>" section that contains a product you need.
To do so, please follow the link: როგორ მოვძებნოთ კომპანია?

Example companies with archived reports:

  • Country: EST, Reg. Code: 12309116
  • Country: EST, Reg. Code: 12854256
  • Country: EST, Reg. Code: 12830238
  • Country: USA, Company name: Apple

STEP 2: Order a report

ფუნქცია Order

STEP 3: Order cancellation (Optional)

Just like the online/offline reports.

STEP 4: Order confirmation

Just like the online/offline reports.

STEP 5: Check order status

Just like the online/offline reports.

For archived orders checking order status once every 5 seconds is acceptable frequency.

STEP 6: Get report

Just like the online/offline reports.

როგორ შევუკვეთოთ ფინანსური ანგარიშგება ონლაინ?

STEP 1: Find a company

ფუნქცია SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: როგორ მოვძებნოთ კომპანია?

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: ხელმისაწვდომი ფინანსური ანგარიშგების ძიება

ფუნქცია ChkFinance

ეს ფუნქცია საჭიროა მხოლოდ პროდუქტის: finances (Financial statements) შეკვეთისას delivery_term = 'o' პირობებით.

ხელმისაწვდომი ქვეყნების სია: ესტონეთი (EST), შვედეთი (SWE)

STEP 3: ფინანსური ანგარიშგების შეკვეთა

ფუნქცია Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 4: Order cancellation (Optional)

ფუნქცია OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.
To see the examples of xml request/response, please follow the link: How to cancel the order?

STEP 5: Order confirmation

ფუნქცია OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.
To see the examples of xml request/response, please follow the link: How to confirm the order?

STEP 6: Check order status

ფუნქცია ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

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

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

If the execution status is Finished or Updated, then you can get an order.

To see the examples of xml request/response, please follow the link: How to check order status?

STEP 7: Get report

ფუნქცია GetReport
ხელმისაწვდომი ენების სია: ar (Arabic), az (Azerbaijani), bg (ბულგარული), cs (ჩეხური), da (დანიური), de (გერმანული), el (ბერძნული), en (ინგლისური), es (ესპანური), et (ესტონური), fi (ფინური), fr (ფრანგული), he (Hebrew), hi (Hindi), hu (უნგრული), hy (Armenian), id (ინდონეზიური), it (იტალიური), ja (იაპონური), ka (Georgian), kk (Kazakh), ko (კორეული), lt (ლიტვური), lv (ლატვიური), mn (Mongolian), ms (Malay), nb (ნორვეგიული ბოკმოლი), nl (ჰოლანდიური), pl (პოლონური), pt (პორტუგალიური), ro (რუმინული), ru (რუსული), sk (სლოვაკური), sl (სლოვენური), sr (Српски), sv (შვედური), th (Thai), tr (თურქული), uk (უკრაინული), uz (Uzbek), vi (Vietnamese), zh (ჩინური)
To see the examples of xml request/response, please follow the link: How to get finished order?

როგორ გადმოვწეროთ სტანდარტული ანგარიშები (XML-ის გარდა სხვა ფორმატებში)?

Types of standard product: Basic Report, Mini Report, Linkages, Registration Data Report, Full report (private person), Short report (private person), Full report (with research), Financials (bank), Short Report, Real estate ownership search, Extended report, Full Report, KYC Report, Linked persons, Credit Opinion, Financial statements.

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

  1. ფიქსირებული ნაწილი https://www.infoproff.com/en/orders/files/
  2. თქვენი უნიკალური ჰეში, რომელსაც ჩვენ პასუხად ვაწვდით
  3. And fixed part at the end /report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
https://www.infoproff.com/en/orders/files/<order_hash>/report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
lang: en, et, ru, lv, ar, az, bg, cs, da, de, el, fi, fr, he, hi, hu, hy, id, it, ja, ka, kk, ko, lt, mn, ms, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, uz, vi, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - ორიგინალი (გადაცვლა არ არის), EUR, USD, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, GBP, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, RUB, SEK, SGD, THB, TRY, ZAR

როგორ გადმოვწეროთ არასტანდარტული პროდუქტები?

Types of non-standard product: Marketing database (special offer), Site visit - non-capital city, Extract from registry, Site visit - capital city, Due Diligence, non-standard, Shareholder document, Memorandum of Association, Certificate of incorporation.

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

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

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

ფუნქცია CreditOpinionCalculator

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

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

delivery_term:

  1. "o" = "Online"
  2. "n" = "Normal"
  3. "f" = "Flash"
  4. "s" = "SuperFlash"

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

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

ყველა ფუნქცია
  • Incorrect username/password or you have no permissions.
    თქვენ არასწორ მონაცემებს შეიყვანთ ან თქვენი API-ზე წვდომა დაბლოკილია.
ფუნქცია SimpleSearch
  1. You don't have permissions to search in this country.
    ხელმისაწვდომი ქვეყნების სია: ავსტრალია (AUS), ავსტრია (AUT), აზერბაიჯანი (AZE), ალბანეთი (ALB), ალჟირი (DZA), ანგოლა (AGO), არგენტინა (ARG), ახალი ზელანდია (NZL), ბელარუსი (BLR), ბელგია (BEL), ბენინი (BEN), ბოლივია (BOL), ბოსნია და ჰერცეგოვინა (BIH), ბოტსვანა (BWA), ბრაზილია (BRA), ბულგარეთი (BGR), გაერთიანებული სამეფო (GBR), გაიანა (GUY), გამბია (GMB), გერმანია (DEU), გვადელუპა (GLP), გივია (GIN), გრინლანდია (GRL), გუანა (GUF), დანია (DNK), ეთიოპია (ETH), ეკვადორი (ECU), ესპანეთი (ESP), ესტონეთი (EST), ვენესუელა (VEN), ზამბია (ZMB), ზიმბაბვე (ZWE), იაპონია (JPN), ირლანდია (IRL), ისლანდია (ISL), ისრაელი (ISR), იტალია (ITA), კანადა (CAN), კენია (KEN), კვიპროსი (CYP), კონგო (COG), კოსოვო (XXK), ლატვია (LVA), ლიტვა (LTU), ლიხტენშტაინი (LIE), ლუქსემბურგი (LUX), მადაგასკარი (MDG), მავრიკი (MUS), მაიოტა (MYT), მალდივები (MDV), მალტა (MLT), მაროკო (MAR), მარტინიკი (MTQ), მენი (IMN), მოლდოვა (MDA), მონაკო (MCO), მონღოლეთი (MNG), ნამიბია (NAM), ნიგერია (NGA), ნიდერლანდები (NLD), ნორვეგია (NOR), პარაგვაი (PRY), პერუ (PER), პოლონეთი (POL), პორტუგალია (PRT), რუანდა (RWA), რუმინეთი (ROU), რუსეთი (RUS), საბერძნეთი (GRC), სამოა (WSM), სამხრეთ აფრიკა (ZAF), სან-მარინო (SMR), საფრანგეთი (FRA), საქართველო (GEO), სეიშელები (SYC), სერბეთი (SRB), სინგაპური (SGP), სლოვაკეთი (SVK), სლოვენია (SVN), ტაივანი (TWN), ტაილანდი (THA), ტანზანია (TZA), ტაჯიკისტანი (TJK), ტოგო (TGO), უზბეკეთი (UZB), უნგრეთი (HUN), ურუგვაი (URY), ფილიპინები (PHL), ფინეთი (FIN), ქობინის სანაპირო (CIV), ყაზახეთი (KAZ), ყირგიზეთი (KGZ), შეხვედრა (REU), შვედეთი (SWE), შვეიცარია (CHE), შრი-ლანკა (LKA), ჩეხეთი (CZE), ჩილე (CHL), ჩინეთი (CHN), წმინდა მარტინი (MAF), ხორვატია (HRV), ჯერზი (JEY), ჰონგ-კონგი (HKG)
ფუნქცია Order
  1. This product is not available.
    ასეთი პროდუქტი ვერ მოიძებნა და მისი შეკვეთა შეუძლებელია.
  2. You can't order report on company with legal form: "legal_form"
    ეს შეცდომა მხოლოდ ეხება: შვედეთი (SWE)
    შვედეთში შეუძლებელია ონლაინ ანგარიშის (delivery_term = "o") შეკვეთა შემდეგი იურიდიული ფორმებით:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. When delivery term is Online, please use order_details_by_id with search_result_id.
    This error only appears if you are trying to order online report without search_result_id.
    It is important yo use order_details_by_id in OrderReportRequest
  4. Business Name or Reg Code is required
    ოფლაინ ანგარიშის შეკვეთისას (delivery_term = "n", "f" or "s") აუცილებელია "საწარმოს დასახელება" ან "სარეგისტრაციო კოდი".
  5. Reg Code is required when delivery term is Online
    ონლაინ ანგარიშის შეკვეთისას (delivery_term = "o") აუცილებელია "Reg Code"-ის მითითება.
ფუნქცია GetReport
  1. This language is not supported.
    ონლაინ ანგარიშებისთვის ხელმისაწვდომი ენების სია: ar (Arabic), az (Azerbaijani), bg (ბულგარული), cs (ჩეხური), da (დანიური), de (გერმანული), el (ბერძნული), en (ინგლისური), es (ესპანური), et (ესტონური), fi (ფინური), fr (ფრანგული), he (Hebrew), hi (Hindi), hu (უნგრული), hy (Armenian), id (ინდონეზიური), it (იტალიური), ja (იაპონური), ka (Georgian), kk (Kazakh), ko (კორეული), lt (ლიტვური), lv (ლატვიური), mn (Mongolian), ms (Malay), nb (ნორვეგიული ბოკმოლი), nl (ჰოლანდიური), pl (პოლონური), pt (პორტუგალიური), ro (რუმინული), ru (რუსული), sk (სლოვაკური), sl (სლოვენური), sr (Српски), sv (შვედური), th (Thai), tr (თურქული), uk (უკრაინული), uz (Uzbek), vi (Vietnamese), zh (ჩინური)
ფუნქციები GetReport ChkStatus
  1. Incorrect order_id.
    შეკვეთის ID ვერ მოიძებნა. შეკვეთის ID მიიღებთ Order ფუნქციის გამოყენებით.
ფუნქცია OrderCancellation
  1. Your order is already canceled.
    შეკვეთის გაუქმების უფლება აღარ გაქვთ.
ფუნქცია OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

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

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

1) New function: ChkFinance

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

2) Function: SimpleSearch

- Changes in list of available countries: ავსტრალია (AUS), ავსტრია (AUT), აზერბაიჯანი (AZE), ალბანეთი (ALB), ალჟირი (DZA), ანგოლა (AGO), არგენტინა (ARG), ახალი ზელანდია (NZL), ბელარუსი (BLR), ბელგია (BEL), ბენინი (BEN), ბოლივია (BOL), ბოსნია და ჰერცეგოვინა (BIH), ბოტსვანა (BWA), ბრაზილია (BRA), ბულგარეთი (BGR), გაერთიანებული სამეფო (GBR), გაიანა (GUY), გამბია (GMB), გერმანია (DEU), გვადელუპა (GLP), გივია (GIN), გრინლანდია (GRL), გუანა (GUF), დანია (DNK), ეთიოპია (ETH), ეკვადორი (ECU), ესპანეთი (ESP), ესტონეთი (EST), ვენესუელა (VEN), ზამბია (ZMB), ზიმბაბვე (ZWE), იაპონია (JPN), ირლანდია (IRL), ისლანდია (ISL), ისრაელი (ISR), იტალია (ITA), კანადა (CAN), კენია (KEN), კვიპროსი (CYP), კონგო (COG), კოსოვო (XXK), ლატვია (LVA), ლიტვა (LTU), ლიხტენშტაინი (LIE), ლუქსემბურგი (LUX), მადაგასკარი (MDG), მავრიკი (MUS), მაიოტა (MYT), მალდივები (MDV), მალტა (MLT), მაროკო (MAR), მარტინიკი (MTQ), მენი (IMN), მოლდოვა (MDA), მონაკო (MCO), მონღოლეთი (MNG), ნამიბია (NAM), ნიგერია (NGA), ნიდერლანდები (NLD), ნორვეგია (NOR), პარაგვაი (PRY), პერუ (PER), პოლონეთი (POL), პორტუგალია (PRT), რუანდა (RWA), რუმინეთი (ROU), რუსეთი (RUS), საბერძნეთი (GRC), სამოა (WSM), სამხრეთ აფრიკა (ZAF), სან-მარინო (SMR), საფრანგეთი (FRA), საქართველო (GEO), სეიშელები (SYC), სერბეთი (SRB), სინგაპური (SGP), სლოვაკეთი (SVK), სლოვენია (SVN), ტაივანი (TWN), ტაილანდი (THA), ტანზანია (TZA), ტაჯიკისტანი (TJK), ტოგო (TGO), უზბეკეთი (UZB), უნგრეთი (HUN), ურუგვაი (URY), ფილიპინები (PHL), ფინეთი (FIN), ქობინის სანაპირო (CIV), ყაზახეთი (KAZ), ყირგიზეთი (KGZ), შეხვედრა (REU), შვედეთი (SWE), შვეიცარია (CHE), შრი-ლანკა (LKA), ჩეხეთი (CZE), ჩილე (CHL), ჩინეთი (CHN), წმინდა მარტინი (MAF), ხორვატია (HRV), ჯერზი (JEY), ჰონგ-კონგი (HKG)

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

To place an online order, you need to recieve 'search_result_id' from function 'SimpleSearch', and only after that you can place an online (delivery_term = 'o') order.

- Changes in list of available countries for online credit reports: ავსტრია (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)

- Available to download financial statements (using product: finances) in online mode: Estonia (EST), Sweden (SWE)

3) Function: GetReport

- Changes in of available languages: ar (Arabic), az (Azerbaijani), bg (ბულგარული), cs (ჩეხური), da (დანიური), de (გერმანული), el (ბერძნული), en (ინგლისური), es (ესპანური), et (ესტონური), fi (ფინური), fr (ფრანგული), he (Hebrew), hi (Hindi), hu (უნგრული), hy (Armenian), id (ინდონეზიური), it (იტალიური), ja (იაპონური), ka (Georgian), kk (Kazakh), ko (კორეული), lt (ლიტვური), lv (ლატვიური), mn (Mongolian), ms (Malay), nb (ნორვეგიული ბოკმოლი), nl (ჰოლანდიური), pl (პოლონური), pt (პორტუგალიური), ro (რუმინული), ru (რუსული), sk (სლოვაკური), sl (სლოვენური), sr (Српски), sv (შვედური), th (Thai), tr (თურქული), uk (უკრაინული), uz (Uzbek), vi (Vietnamese), zh (ჩინური)


SOAP-ის (ვერსია 3) ცვლილებები SOAP-ის (ვერსია 2) მიმართ [WSDL and XSD]

File: report.xsd

New elements:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

New function:

- 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

New element:

- preferable_finances

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

3) SimpleSearchRequest

Removed element:

search_block.reg_code

New element:

search_block->company_code

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

4) SimpleSearchResponse

Removed elements

- code

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

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

Webhooks Settings

ზოგადი მიმოხილვა

ვებჰუკი არის მეთოდი, რომლითაც აპლიკაცია სხვა აპლიკაციებს რეალურ დროში ინფორმაციას აწვდის. ჩვენი ვებჰუკის ფუნქცია ახორციელებს HTTP-ქოლბექებს, რომლებიც URL-ის მეშვეობითაა კონფიგურირებული. HTTP POST-ის ტვირთი JSON ფორმატში იგზავნება ამ URL-ზე, როდესაც კონკრეტული მოვლენა ხდება. ჩვენი პროექტის კონტექსტში, ვებჰუკის ფუნქცია ისე დავაპროექტეთ, რომ კონკრეტული მოვლენები გამოიწვიოს.

ვებჰუკის დაყენება

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

  1. "Webhook-ის URL" არის URL, სადაც თქვენი სერვერი მიიღებს webhook-ის POST მოთხოვნებს.
  2. "მიწოდების მაქს. მცდელობები" არის პარამეტრი, რომელიც განსაზღვრავს ვებჰუკის მოვლენის მიწოდების მაქსიმალურ რაოდენობას, როდესაც საწყისი მცდელობა წარუმატებელია.
  3. "მიწოდების ხელახალი მცდელობის დროის ლიმიტი" არის პარამეტრი, რომელიც საშუალებას გაძლევთ მიუთითოთ დროის ინტერვალი ხელახალ მცდელობებს შორის, როდესაც ვებჰუკის მიწოდების მცდელობა წარუმატებელია.

ამ დეტალების მითითების შემდეგ, დააჭირეთ ღილაკს "შენახვა".

ვებჰუკის მოვლენების ტიპები

  1. შეკვეთის ახალი სტატუსი

ვებჰუკის ტვირთი

როდესაც მოვლენა მოხდება, ჩვენ გამოვგზავნით HTTP POST მოთხოვნას payload URL-ზე JSON სხეულით, რომელიც შეიცავს ინფორმაციას მოვლენის შესახებ.

აი მაგალითად სატვირთო მოდული:
დატვირთვის მაგალითი შეკვეთის ახალი სტატუსის მიხედვით
ველის " "new_status" " შესაძლო მნიშვნელობები:
  • "Finished" - შეკვეთა დასრულებულია. შეკვეთის აღება შესაძლებელია;
  • "Updated" - შეკვეთის განახლება, მონაცემების დამატება დასრულებულ შეკვეთაში;
  • "Canceled" - შეკვეთა გაუქმდება მომხმარებლის მოთხოვნით (ან თანხმობით);
  • "Rejected" - შეკვეთა უარყოფილია. როგორც წესი, კომპანიის იდენტიფიცირება შეუძლებელია..
  • "Identification pending" - შეკვეთის მომზადებამდე მომხმარებლისგან დამატებითი ინფორმაცია გვჭირდება..

თქვენი ვებჰუკების დაცვა

მნიშვნელოვანია, რომ დავრწმუნდეთ, რომ payload-ის URL-ზე გაგზავნილი POST მოთხოვნები ჩვენი აპლიკაციიდან მოდის. ამისათვის, ყველა webhook მოთხოვნა შეიცავს X-Signature ჰედერს.

ხელმოწერის აღწერა

ხელმოწერისთვის ვიყენებთ HMAC-ს SHA512 ალგორითმით.

საიდუმლო არის App ID-ისა და Secret Key-ის შერწყმა ვებჰუკების პარამეტრებიდან.

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

პრობლემების მოგვარება

სერვერმა 10 წამის განმავლობაში უნდა უპასუხოს და დააბრუნოს 2XX HTTP კოდი; წინააღმდეგ შემთხვევაში, ვებჰუკის მიწოდება ჩაითვლება წარუმატებლად. წარუმატებლობის შემთხვევაში, ფუნქცია შეეცდება მოთხოვნის ხელახლა გაგზავნას მიწოდების პოლიტიკის შესაბამისად.

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