Ինֆոպրոֆֆ API փաստաթղթավորում - v4

Փոխել տարբերակը V4

Սկսել

Վեբ ծառայության WSDL-ն և սխեմաները գտնվում են այստեղ։:

https://wsdfn.infoproff.com/v4/

Postman Collection (API v4) — Ready for Use:

https://www.postman.com/infoproff/infoproff-webservices/documentation/9kweer5/soap-api-v4

Postman provides a convenient way to test our API without the need to write any code. It can also automatically generate example HTTP requests for most common programming languages.

The requests generated by Postman are basic HTTP calls compatible with our SOAP API. However, for production-grade integration, we recommend using fully featured SOAP clients available in most programming languages. These clients can work directly with WSDL and XSD, automatically handling schemas, data types, and message structures.

Using a dedicated SOAP client ensures a more reliable and robust integration, reducing the likelihood of errors when constructing and parsing SOAP messages.

Authentification details

The primary authentication method is HTTP Basic Auth. Using the Authorization header with encoded credentials is the preferred and recommended approach.

The username corresponds to the App ID, and the password is the associated Secret Key. These values are generated in the API Tokens section of the user dashboard and are not related to the credentials used for logging into the portal.

The authentication_block mechanism, used in previous API versions, is still supported for backward compatibility but is considered deprecated and should not be used in new integrations.

Web service functions:

  • SimpleSearch - Տարբեր երկրներում ընկերությունների մասին տեղեկություններ որոնեք։
  • ChkFinance - Փնտրեք առկա ֆինանսական հաշվետվությունները։
  • Order - Ստեղծում է order_id և վերադարձնում կրկնօրինակները։ Կրկնօրինակները ընտրվում են հետևյալ պարամետրերով՝ country, product, reg_code։
  • OrderCancellation - Եթե դուք ուղարկել եք պատվերի հարցում և ստացել order_id-ը, կարող եք չեղարկել այս պատվերը (եթե այն դեռ չի անցել արտադրության փուլ):
  • OrderConfirmation - order_id ստանալուց հետո դուք պետք է մեկ ժամվա ընթացքում հաստատեք ձեր պատվերը։ Եթե մեկ ժամվա ընթացքում չհաստատեք, պատվերը ավտոմատ կերպով կչեղարկվի։
  • ChkStatus - Ստուգեք պատվերի կարգավիճակը։
  • GetReport - Ստացեք ավարտված զեկույցները։
  • GetClassifiersFinancialStatements - Ստացեք բոլոր ֆինանսական փաստաթղթերը՝ բոլոր տարրերով՝ row_number, row_formated_description, row_lang_key և row_order։
  • GetLegalForms - Ստացեք բոլոր իրավական ձևերը բոլոր մատչելի երկրների համար։
  • GetActivityClassificators - Ստացեք բոլոր կոդերն ու նկարագրությունները կոնկրետ գործունեության դասակարգչի համար։
  • GetDictionaryStandardPhrases - Ստացեք բոլոր ստանդարտ արտահայտությունները բանալիներով և լեզվով։
  • GetAvailableProducts - Ստացեք մատչելի ապրանքների ցանկը։
  • CreditOpinionCalculator - Քրեդիտային կարծիքի հաշվիչը օգնում է ընկերության համար վարկային կարծիք սահմանել։

API-ն տրամադրում է մի քանի ծառայություններ:

  1. Առցանց վարկային զեկույցներ հետևյալ երկրների համար: Ադրբեջան (AZE), Ավստրիա (AUT), Բելգիա (BEL), Բուլղարիա (BGR), Գերմանիա (DEU), Դանիա (DNK), Էստոնիա (EST), Իռլանդիա (IRL), Իսպանիա (ESP), Իտալիա (ITA), Լատվիա (LVA), Լեհաստան (POL), Լյուքսեմբուրգ (LUX), Խորվաթիա (HRV), Հունաստան (GRC), Հունգարիա (HUN), Ղազախստան (KAZ), Ղրղզստան (KGZ), Մալթա (MLT), Միացյալ Թագավորություն (GBR), Մոլդովա (MDA), Մոնղոլիա (MNG), Նիդերլանդներ (NLD), Նորվեգիա (NOR), Շվեդիա (SWE), Շվեյցարիա (CHE), Չեխիա (CZE), Չինաստան (CHN), Պորտուգալիա (PRT), Ռուսաստան (RUS), Սլովակիա (SVK), Սլովենիա (SVN), Ֆինլանդիա (FIN), Ֆրանսիա (FRA)
  2. Անլայն զեկույցներ հետևյալ երկրների համար: Բոլոր երկրները
  3. Վարկային կարծիքի հաշվիչ
  4. Company search

Ինչպե՞ս որոնել ընկերություն։

Ընկերության որոնումը բաղկացած է 2 տարբերակից:

  1. Ընկերության անվամբ որոնել,
  2. Search by company code.
Մատչելի երկրների ցանկ: Ադրբեջան (AZE), Ալբանիա (ALB), Ալժիր (DZA), Այվորի Կոտ (CIV), Անգոլա (AGO), Ավստրալիա (AUS), Ավստրիա (AUT), Արգենտինա (ARG), Բելառուս (BLR), Բելգիա (BEL), Բենին (BEN), Բոլիվիա (BOL), Բոսնիա և Հերցեգովինա (BIH), Բոտսվանա (BWA), Բուլղարիա (BGR), Բրազիլիա (BRA), Գամբիա (GMB), Գայանա (GUY), Գերմանիա (DEU), Գվադելուպ (GLP), Գվինեա (GIN), Գվինեա (GUF), Գրինլանդիա (GRL), Դանիա (DNK), Եթովպիա (ETH), Զամբիա (ZMB), Զելանդիա (NZL), Զիմբաբվե (ZWE), Էկվադոր (ECU), Էստոնիա (EST), Թայլանդ (THA), Թայվան (TWN), Թաջիկստան (TJK), Իռլանդիա (IRL), Իսլանդիա (ISL), Իսպանիա (ESP), Իսրայել (ISR), Իտալիա (ITA), Լատվիա (LVA), Լեհաստան (POL), Լիխտենշտեյն (LIE), Լիտվա (LTU), Լյուքսեմբուրգ (LUX), Խորվաթիա (HRV), Կանադա (CAN), Կիպրոս (CYP), Կոնգո (COG), Կոսովո (XXK), Հարավային Աֆրիկա (ZAF), Հոնկոնգ (HKG), Հունաստան (GRC), Հունգարիա (HUN), Ղազախստան (KAZ), Ղրղզստան (KGZ), Ճապոնիա (JPN), Մադագասկար (MDG), Մալդիվներ (MDV), Մալթա (MLT), Մայոտտե (MYT), Մավրիցիոս (MUS), Մարոկկո (MAR), Մարտինիկա (MTQ), Մեն (IMN), Միացյալ Թագավորություն (GBR), Մոլդովա (MDA), Մոնակո (MCO), Մոնղոլիա (MNG), Նամիբիա (NAM), Նիգերիա (NGA), Նիդերլանդներ (NLD), Նորվեգիա (NOR), Շվեդիա (SWE), Շվեյցարիա (CHE), Շրի Լանկա (LKA), Ուզբեկստան (UZB), Ուրուգվայ (URY), Չեխիա (CZE), Չիլի (CHL), Չինաստան (CHN), Պարագուայ (PRY), Պերու (PER), Պորտուգալիա (PRT), Ջերսի (JEY), Ռուանդա (RWA), Ռումինիա (ROU), Ռուսաստան (RUS), Սամոա (WSM), Սան Մարինո (SMR), Սեյշելներ (SYC), Սենթ Մարթին (MAF), Սերբիա (SRB), Սինգապուր (SGP), Սլովակիա (SVK), Սլովենիա (SVN), Վենեսուելա (VEN), Վերամիավորում (REU), Վրաստան (GEO), Տանզանիա (TZA), Տոգո (TGO), Քենիա (KEN), Ֆիլիպիններ (PHL), Ֆինլանդիա (FIN), Ֆրանսիա (FRA)

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: Ադրբեջան (AZE), Ավստրիա (AUT), Բելգիա (BEL), Բուլղարիա (BGR), Գերմանիա (DEU), Դանիա (DNK), Էստոնիա (EST), Իռլանդիա (IRL), Իսպանիա (ESP), Իտալիա (ITA), Լատվիա (LVA), Լեհաստան (POL), Լյուքսեմբուրգ (LUX), Խորվաթիա (HRV), Հունաստան (GRC), Հունգարիա (HUN), Ղազախստան (KAZ), Ղրղզստան (KGZ), Մալթա (MLT), Միացյալ Թագավորություն (GBR), Մոլդովա (MDA), Մոնղոլիա (MNG), Նիդերլանդներ (NLD), Նորվեգիա (NOR), Շվեդիա (SWE), Շվեյցարիա (CHE), Չեխիա (CZE), Չինաստան (CHN), Պորտուգալիա (PRT), Ռուսաստան (RUS), Սլովակիա (SVK), Սլովենիա (SVN), Ֆինլանդիա (FIN), Ֆրանսիա (FRA)
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 - Մեր համակարգում տեխնիկական սխալ է տեղի ունեցել։ Սա նշանակում է, որ մենք տեղեկացված ենք այս սխալի մասին և հնարավորինս շուտ կվերացնենք այն։ Ձեզ կտեղեկացնեն, երբ կարողանաք ստանալ պատվերը։

Եթե կատարման կարգավիճակը Finished կամ Updated է, ապա կարող եք ստանալ պատվեր։

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 - Մեր համակարգում տեխնիկական սխալ է տեղի ունեցել։ Սա նշանակում է, որ մենք տեղեկացված ենք այս սխալի մասին և հնարավորինս շուտ կվերացնենք այն։ Ձեզ կտեղեկացնեն, երբ կարողանաք ստանալ պատվերը։

Եթե կատարման կարգավիճակը Finished կամ Updated է, ապա կարող եք ստանալ պատվեր։

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.

Հարցումը բաղկացած է երեք մասից:

  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.

Հարցումը բաղկացած է երեք մասից:

  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.
    Մատչելի երկրների ցանկ: Ադրբեջան (AZE), Ալբանիա (ALB), Ալժիր (DZA), Այվորի Կոտ (CIV), Անգոլա (AGO), Ավստրալիա (AUS), Ավստրիա (AUT), Արգենտինա (ARG), Բելառուս (BLR), Բելգիա (BEL), Բենին (BEN), Բոլիվիա (BOL), Բոսնիա և Հերցեգովինա (BIH), Բոտսվանա (BWA), Բուլղարիա (BGR), Բրազիլիա (BRA), Գամբիա (GMB), Գայանա (GUY), Գերմանիա (DEU), Գվադելուպ (GLP), Գվինեա (GIN), Գվինեա (GUF), Գրինլանդիա (GRL), Դանիա (DNK), Եթովպիա (ETH), Զամբիա (ZMB), Զելանդիա (NZL), Զիմբաբվե (ZWE), Էկվադոր (ECU), Էստոնիա (EST), Թայլանդ (THA), Թայվան (TWN), Թաջիկստան (TJK), Իռլանդիա (IRL), Իսլանդիա (ISL), Իսպանիա (ESP), Իսրայել (ISR), Իտալիա (ITA), Լատվիա (LVA), Լեհաստան (POL), Լիխտենշտեյն (LIE), Լիտվա (LTU), Լյուքսեմբուրգ (LUX), Խորվաթիա (HRV), Կանադա (CAN), Կիպրոս (CYP), Կոնգո (COG), Կոսովո (XXK), Հարավային Աֆրիկա (ZAF), Հոնկոնգ (HKG), Հունաստան (GRC), Հունգարիա (HUN), Ղազախստան (KAZ), Ղրղզստան (KGZ), Ճապոնիա (JPN), Մադագասկար (MDG), Մալդիվներ (MDV), Մալթա (MLT), Մայոտտե (MYT), Մավրիցիոս (MUS), Մարոկկո (MAR), Մարտինիկա (MTQ), Մեն (IMN), Միացյալ Թագավորություն (GBR), Մոլդովա (MDA), Մոնակո (MCO), Մոնղոլիա (MNG), Նամիբիա (NAM), Նիգերիա (NGA), Նիդերլանդներ (NLD), Նորվեգիա (NOR), Շվեդիա (SWE), Շվեյցարիա (CHE), Շրի Լանկա (LKA), Ուզբեկստան (UZB), Ուրուգվայ (URY), Չեխիա (CZE), Չիլի (CHL), Չինաստան (CHN), Պարագուայ (PRY), Պերու (PER), Պորտուգալիա (PRT), Ջերսի (JEY), Ռուանդա (RWA), Ռումինիա (ROU), Ռուսաստան (RUS), Սամոա (WSM), Սան Մարինո (SMR), Սեյշելներ (SYC), Սենթ Մարթին (MAF), Սերբիա (SRB), Սինգապուր (SGP), Սլովակիա (SVK), Սլովենիա (SVN), Վենեսուելա (VEN), Վերամիավորում (REU), Վրաստան (GEO), Տանզանիա (TZA), Տոգո (TGO), Քենիա (KEN), Ֆիլիպիններ (PHL), Ֆինլանդիա (FIN), Ֆրանսիա (FRA)
Ֆունկցիա 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" կամ "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 (տարբերակ 4)-ի փոփոխությունները SOAP (տարբերակ 3)-ի համեմատ

Նոր բաժիններ

  • country_economic_overview — ներառում է հետևյալ ենթաբաժինները՝ data_transparency_index, country_development_indicators, economic_forecast ։
  • paid_taxes — վճարված հարկերի մասին տեղեկատվություն։
  • tenders — տենդերների մասին տեղեկատվություն։
  • sanctions — ավելացվել է negative_information բաժնում։

Գոյություն ունեցող բաժինների թարմացումներ

beneficiaries, shareholders, managers և employees_data բաժիններում ավելացվել է հետևյալ տարրը՝
  • source_type — տվյալների աղբյուրի տեսակը (օրինակ՝ official, mass_media, company_admin և այլն).
relations_of_persons բաժնում ավելացվել է նոր տարր՝
  • match_type
capital բաժինը վերակազմավորվել է՝
  • capital_amount տարրը վերանվանվել է issued_capital ։
  • Հետևյալ նոր տարրերն են ավելացվել:
    • number_of_shares
    • share_value
    • authorized_capital
    xml-ph-0000@deepl.internal բաժնում:
employees_data բաժնում:
  • Նոր group_figure տարրը նշում է՝ արդյոք տվյալները ներառում են խմբային մակարդակի համախմբված ցուցանիշներ (true):
  • source_type տարրը նշում է տվյալների աղբյուրի տեսակը։
  • is_estimated տարրը այժմ ներառվում է միայն այն դեպքում, եթե դրա արժեքը true է։
Նոր assets_data բաժին — համախմբում է նախկինում գոյություն ունեցող բաժինները:
  • real_estate_data (նախկինում կոչվել է property_data), vehicles, machinery_and_equipment (նախկինում կոչվել է assets).
  • Ապագա ավելացումների պլանավորված ցանկ՝ patents և biological_assets ։
vehicles բաժնում ավելացվել է նոր դաշտ՝
  • value
litigations բաժնում ավելացվել են հետևյալ տարրերը՝
  • content, instance, process, authority
financial_statement/positions և summary/latest_turnovers բաժիններում ավելացվել է նոր տարր՝
  • value_origin — նկարագրում է արժեքի ծագումը; օրինակ՝ estimated - այս արժեքը գնահատվում և հաշվարկվում է մատչելի տվյալների հիման վրա՝ տրամաբանության կամ արհեստական բանականության (AI) միջոցով։
branches_data «Ընդհանուր տեղեկություններ» բաժնում ավելացվել են հետևյալ դաշտերը՝
  • registration_number
  • director_name

Նշում. Փոքր բարելավումներ և ճշգրտումներ կարող են դեռևս տեղի ունենալ կայունացման փուլում։

Webhooks Settings

Ընդհանուր ակնարկ

Վեբհուկը ծրագրի համար միջոց է, որով այն կարող է իրական ժամանակում տեղեկություններ տրամադրել այլ ծրագրերին։ Մեր վեբհուկի ֆունկցիան իրականացնում է URL-ով կազմաձևված HTTP կոլբեքներ։ HTTP POST տվյալները JSON ֆորմատով ուղարկվում են այդ URL-ին, երբ տեղի է ունենում նշված իրադարձությունը։ Մեր նախագծի համատեքստում մենք նախագծել ենք վեբհուկի ֆունկցիան՝ հատուկ իրադարձություններ հրահրելու համար։

Վեբհուկի կարգավորում

Ձեր հավելվածի համար վեբհուկ կարգավորելու համար անցեք հավելվածի կարգավորումների էջ և գտեք «Webhooks Settings» բաժինը։ Եվ տրամադրեք հետևյալ տեղեկությունները։

  1. «Webhook URL»-ը այն URL-ն է, որտեղ ձեր սերվերը կստանա webhook POST հարցումները։
  2. «Առաքման առավելագույն փորձեր» կարգավորումը սահմանում է, թե քանի անգամ պետք է կրկնօրինակ փորձեր կատարվեն վեբհուկ իրադարձությունը առաքելու համար, եթե սկզբնական առաքման փորձը ձախողվի։
  3. «Delivery retry timeout»-ը կարգավորում է, որը թույլ է տալիս նշել այն ժամանակահատվածը, որը անցնելուց հետո կրկնօրինակումները կիրականացվեն, երբ webhook-ի առաքման փորձը ձախողվի։

Այս մանրամասները մուտքագրելուց հետո սեղմեք «Պահպանել»։

Վեբհուկի իրադարձությունների տեսակներ

  1. Պատվերի նոր կարգավիճակ

Վեբհուկի բեռը

Երբ միջադեպ տեղի ունենա, մենք կուղարկենք HTTP POST հարցում payload URL հասցեին՝ JSON մարմնով, որը պարունակում է տեղեկություններ միջադեպի մասին։

Ահա օրինակային բեռը:
Պատվերի նոր կարգավիճակի բեռի օրինակ
"new_status" դաշտի հնարավոր արժեքներ:
  • "Finished" - պատվերը ավարտված է։ Պատվերը կարելի է ստանալ;
  • "Updated" - պատվերը թարմացվել է, տվյալներ ավելացվել են ավարտված պատվերին;
  • "Canceled" - պատվերը չեղարկվում է հաճախորդի խնդրանքով (կամ համաձայնությամբ);
  • "Rejected" - պատվերը մերժվում է։ Սովորաբար այն պատճառով, որ անհնար է ընկերությունը նույնականացնել։.
  • "Identification pending" Պատվերը պատրաստելու համար մեզ հարկավոր է հաճախորդից լրացուցիչ տեղեկություն։.

Ձեր վեբհուկերի ապահովագրումը

Կարևոր է ստուգել, որ payload URL-ին ուղարկվող POST-պահանջները գալիս են մեր հավելվածից։ Այս գործում օգնելու համար յուրաքանչյուր webhook-պահանջում ներառված է X-Signature վերնագիրը։

Ստորագրության նկարագրություն

Ստորագրման համար մենք օգտագործում ենք HMAC՝ SHA512 ալգորիթմով։

Գաղտնիքը App ID-ի և webhooks կարգավորումներից վերցված գաղտնի բանալիների միացումն է։

Հնարավոր է endpoint-ին ավելացնել ձեր սեփական get պարամետրերը՝ անհրաժեշտության դեպքում ուղարկողին նույնականացնելու համար։

Խնդիրների լուծում

Սերվերը պետք է պատասխան տա 10 վայրկյանում և վերադարձնի 2XX HTTP կոդ; հակառակ դեպքում webhook-ի առաքումը համարվում է ձախողված։ Ձախողման դեպքում ֆունկցիան կփորձի կրկին ուղարկել հարցումը՝ ըստ առաքման քաղաքականության։