"Infoproff API" dokumentacija - v4

Komutatoriaus versija V4

Darbo pradžia

Žiniatinklio paslaugos wsdl ir schemos pateikiamos čia:

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 - Ieškokite informacijos apie įmones įvairiose šalyse.
  • ChkFinance - Ieškokite turimų finansinių ataskaitų.
  • Order - Sukuria order_id ir grąžina dublikatus. Dublikatai atrenkami pagal kitus parametrus: country, product, reg_code.
  • OrderCancellation - Jei išsiuntėte užsakymo užklausą ir gavote order_id, turite galimybę atšaukti šį užsakymą (jei jis dar nepradėtas gaminti).
  • OrderConfirmation - Gavę order_id turėsite patvirtinti užsakymą per 1 valandą. Jei užsakymo nepatvirtinsite per 1 valandą, užsakymas bus automatiškai atšauktas.
  • ChkStatus - Patikrinkite užsakymo būseną.
  • GetReport - Gaukite baigtas ataskaitas.
  • GetClassifiersFinancialStatements - Gaukite visus finansinius dokumentus su visais elementais: eilutės_numeris, eilutės_formuluotas_aprašymas, eilutės_lang_key ir eilutės_order.
  • GetLegalForms - Gaukite visų galimų šalių teisines formas.
  • GetActivityClassificators - Gaukite visus konkrečios veiklos klasifikatoriaus kodus ir aprašymus.
  • GetDictionaryStandardPhrases - Gaukite visas standartines frazes su raktais ir kalba.
  • GetAvailableProducts - Gaukite turimų produktų sąrašą.
  • CreditOpinionCalculator - Kredito nuomonės skaičiuoklė padeda priskirti įmonei kredito nuomonę.

API teikia keletą paslaugų:

  1. Internetinės kredito ataskaitos šiose šalyse: Suomijos Respublika (FIN), Švedijos Karalystė (SWE), Belgijos Karalystė (BEL), Nyderlandų Karalystė (NLD), Estijos Respublika (EST), Kazachstano Respublika (KAZ), Lenkijos Respublika (POL), Kirgizijos Respublika (KGZ), Kinijos Liaudies Respublika (CHN), Mongolija (MNG)
  2. Neprisijungus prie interneto pateiktos šių šalių ataskaitos: Visos šalys
  3. Kredito nuomonės skaičiuoklė

Kaip ieškoti įmonės?

Įmonių paiešką sudaro 2 parinktys:

  1. Paieška pagal įmonės pavadinimą,
  2. Search by company code.
Galimų šalių sąrašas: Airija (IRL), Albanijos Respublika (ALB), Alžyro Liaudies Demokratinė Respublika (DZA), Angolos Respublika (AGO), Argentinos Respublika (ARG), Australijos Sandrauga (AUS), Austrijos Respublika (AUT), Azerbaidžano Respublika (AZE), Baltarusijos Respublika (BLR), Belgijos Karalystė (BEL), Benino Respublika (BEN), Bolivijos daugiatautė valstybė (BOL), Bosnija ir Hercegovina (BIH), Botsvanos Respublika (BWA), Brazilijos Federacinė Respublika (BRA), Bulgarijos Respublika (BGR), Danijos Karalystė (DNK), Dramblio Kaulo Krantas (CIV), Džersio Bailiwickas (JEY), Ekvadoro Respublika (ECU), Estijos Respublika (EST), Etiopijos Federacinė Demokratinė Respublika (ETH), Filipinų Respublika (PHL), Gajanos Kooperatinė Respublika (GUY), Gambijos Respublika (GMB), Graikijos Respublika (GRC), Grenlandija (GRL), Gruzija (GEO), Gvadelupa (GLP), Gvinėjos Respublika (GIN), Honkongas (HKG), Islandijos Respublika (ISL), Ispanijos Karalystė (ESP), Italijos Respublika (ITA), Izraelio valstybė (ISR), Japonija (JPN), Jungtinė Didžiosios Britanijos ir Šiaurės Airijos Karalystė (GBR), Jungtinė Tanzanijos Respublika (TZA), Kanada (CAN), Kazachstano Respublika (KAZ), Kenijos Respublika (KEN), Kinijos Liaudies Respublika (CHN), Kinijos Respublika (TWN), Kipro Respublika (CYP), Kirgizijos Respublika (KGZ), Kongo Respublika (COG), Kosovas (XXK), Kroatijos Respublika (HRV), Latvijos Respublika (LVA), Lenkijos Respublika (POL), Lichtenšteino Kunigaikštystė (LIE), Lietuvos Respublika (LTU), Liuksemburgo Didžioji Hercogystė (LUX), Madagaskaro Respublika (MDG), Majotas (MYT), Maldyvų Respublika (MDV), Maltos Respublika (MLT), Maroko Karalystė (MAR), Martinika (MTQ), Mauricijaus Respublika (MUS), Meno sala (IMN), Moldovos Respublika (MDA), Monako Kunigaikštystė (MCO), Mongolija (MNG), Namibijos Respublika (NAM), Naujoji Zelandija (NZL), Nepriklausoma Samoa valstybė (WSM), Nigerijos Federacinė Respublika (NGA), Norvegijos Karalystė (NOR), Nyderlandų Karalystė (NLD), Paragvajaus Respublika (PRY), Peru Respublika (PER), Pietų Afrikos Respublika (ZAF), Portugalijos Respublika (PRT), Prancūzijos Gviana (GUF), Prancūzijos Respublika (FRA), Reunjonas (REU), Ruandos Respublika (RWA), Rumunija (ROU), Rusijos Federacija (RUS), Rytų Urugvajaus Respublika (URY), San Marino Respublika (SMR), Seišelių Respublika (SYC), Serbijos Respublika (SRB), Singapūro Respublika (SGP), Slovakijos Respublika (SVK), Slovėnijos Respublika (SVN), Suomijos Respublika (FIN), Tadžikistano Respublika (TJK), Tailando Karalystė (THA), Togo Respublika (TGO), Uzbekistano Respublika (UZB), Venesuelos Bolivaro Respublika (VEN), Vengrijos Respublika (HUN), Vokietijos Federacinė Respublika (DEU), Zambijos Respublika (ZMB), Zimbabvės Respublika (ZWE), Čekija (CZE), Čilės Respublika (CHL), Šri Lankos Demokratinė Socialistinė Respublika (LKA), Šv. Martyno sala (MAF), Švedijos Karalystė (SWE), Šveicarijos Konfederacija (CHE)

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.

Svarbi informacija:

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.

Norvegijos registre negalima ieškoti išbrauktų įmonių pagal pavadinimus. Todėl negalime pateikti SimpleSearch pagal pavadinimus ištrintose Norvegijos įmonėse.

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

Žemiau rasite pavyzdį:

Funkcija SimpleSearch

2 galimybė: Paieška pagal registracijos kodą

Funkcija SimpleSearch

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

Funkcija UnifiedSearch

Kaip užsisakyti kredito ataskaitą?

List of available countries for online credit reports: Airija (IRL), Austrijos Respublika (AUT), Azerbaidžano Respublika (AZE), Belgijos Karalystė (BEL), Bulgarijos Respublika (BGR), Danijos Karalystė (DNK), Estijos Respublika (EST), Graikijos Respublika (GRC), Ispanijos Karalystė (ESP), Italijos Respublika (ITA), Jungtinė Didžiosios Britanijos ir Šiaurės Airijos Karalystė (GBR), Kazachstano Respublika (KAZ), Kinijos Liaudies Respublika (CHN), Kirgizijos Respublika (KGZ), Kroatijos Respublika (HRV), Latvijos Respublika (LVA), Lenkijos Respublika (POL), Liuksemburgo Didžioji Hercogystė (LUX), Maltos Respublika (MLT), Moldovos Respublika (MDA), Mongolija (MNG), Norvegijos Karalystė (NOR), Nyderlandų Karalystė (NLD), Portugalijos Respublika (PRT), Prancūzijos Respublika (FRA), Rusijos Federacija (RUS), Slovakijos Respublika (SVK), Slovėnijos Respublika (SVN), Suomijos Respublika (FIN), Vengrijos Respublika (HUN), Vokietijos Federacinė Respublika (DEU), Čekija (CZE), Švedijos Karalystė (SWE), Šveicarijos Konfederacija (CHE)
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))

Funkcija SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Kaip ieškoti įmonės?

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))

Funkcija 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))

Funkcija 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))

Funkcija 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))

Funkcija 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.

Ataskaitoms naudojamos šios būsenos:

  • Vykdoma - Gamybos etapo ataskaita
  • Identification pending - Ataskaitos rengimas atidėtas. Reikia papildomų duomenų iš kliento.
  • Canceled - Atšauktas užsakymas
  • Finished - Ataskaita parengta
  • Updated - Į parengtą ataskaitą buvo įtraukta informacija
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Mūsų sistemoje įvyko techninė klaida. Tai reiškia, kad esame informuoti apie šią klaidą ir ją kuo greičiau ištaisysime. Jums bus pranešta, kada galėsite gauti užsakymą.

Jei vykdymo būsena yra Finished arba Updated, galite gauti užsakymą.

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

Funkcija GetReport
Galimų kalbų sąrašas: ar (Arabic), bg (Bulgarų), cs (Čekijos), da (Danų), de (Vokiečių kalba), el (Graikų kalba), en (Anglų kalba), es (Ispanų kalba), et (Estų kalba), fi (Suomijos), fr (Prancūzų kalba), he (Hebrew), hu (Vengrų), id (Indonezijos), it (Italų kalba), ja (Japonų), ko (Korėjiečių kalba), lt (Lietuvių kalba), lv (Latvijos), nb (Norvegų bokmål), nl (Olandų kalba), pl (Lenkų kalba), pt (Portugalų kalba), ro (Rumunijos), ru (Rusų kalba), sk (Slovakų), sl (Slovėnijos), sr (Српски), sv (Švedų kalba), th (Thai), tr (Turkijos), uk (Ukrainiečių), vi (Vietnamese), zh (Kinų)

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

Funkcija 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))

Funkcija 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))

Funkcija 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))

Funkcija ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

Ataskaitoms naudojamos šios būsenos:

  • Vykdoma - Gamybos etapo ataskaita
  • Identification pending - Ataskaitos rengimas atidėtas. Reikia papildomų duomenų iš kliento.
  • Canceled - Atšauktas užsakymas
  • Finished - Ataskaita parengta
  • Updated - Į parengtą ataskaitą buvo įtraukta informacija
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Mūsų sistemoje įvyko techninė klaida. Tai reiškia, kad esame informuoti apie šią klaidą ir ją kuo greičiau ištaisysime. Jums bus pranešta, kada galėsite gauti užsakymą.

Jei vykdymo būsena yra Finished arba Updated, galite gauti užsakymą.

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

Funkcija GetReport
Galimų kalbų sąrašas: ar (Arabic), bg (Bulgarų), cs (Čekijos), da (Danų), de (Vokiečių kalba), el (Graikų kalba), en (Anglų kalba), es (Ispanų kalba), et (Estų kalba), fi (Suomijos), fr (Prancūzų kalba), he (Hebrew), hu (Vengrų), id (Indonezijos), it (Italų kalba), ja (Japonų), ko (Korėjiečių kalba), lt (Lietuvių kalba), lv (Latvijos), nb (Norvegų bokmål), nl (Olandų kalba), pl (Lenkų kalba), pt (Portugalų kalba), ro (Rumunijos), ru (Rusų kalba), sk (Slovakų), sl (Slovėnijos), sr (Српски), sv (Švedų kalba), th (Thai), tr (Turkijos), uk (Ukrainiečių), vi (Vietnamese), zh (Kinų)

Kaip užsisakyti archyvinę kredito ataskaitą?

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

Funkcija 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: Kaip ieškoti įmonės?

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

Funkcija 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.

Kaip užsisakyti finansines ataskaitas internetu?

STEP 1: Find a company

Funkcija SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Kaip ieškoti įmonės?

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: Turimų finansinių ataskaitų paieška

Funkcija ChkFinance

Ši funkcija reikalinga tik užsakant gaminį: finances (Financial statements) su delivery_term = 'o'.

Galimų šalių sąrašas: Estijos Respublika (EST), Švedijos Karalystė (SWE)

STEP 3: Užsisakykite finansines ataskaitas

Funkcija 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)

Funkcija 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

Funkcija 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

Funkcija ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

Ataskaitoms naudojamos šios būsenos:

  • Vykdoma - Gamybos etapo ataskaita
  • Identification pending - Ataskaitos rengimas atidėtas. Reikia papildomų duomenų iš kliento.
  • Canceled - Atšauktas užsakymas
  • Finished - Ataskaita parengta
  • Updated - Į parengtą ataskaitą buvo įtraukta informacija
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Mūsų sistemoje įvyko techninė klaida. Tai reiškia, kad esame informuoti apie šią klaidą ir ją kuo greičiau ištaisysime. Jums bus pranešta, kada galėsite gauti užsakymą.

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

Funkcija GetReport
Galimų kalbų sąrašas: ar (Arabic), bg (Bulgarų), cs (Čekijos), da (Danų), de (Vokiečių kalba), el (Graikų kalba), en (Anglų kalba), es (Ispanų kalba), et (Estų kalba), fi (Suomijos), fr (Prancūzų kalba), he (Hebrew), hu (Vengrų), id (Indonezijos), it (Italų kalba), ja (Japonų), ko (Korėjiečių kalba), lt (Lietuvių kalba), lv (Latvijos), nb (Norvegų bokmål), nl (Olandų kalba), pl (Lenkų kalba), pt (Portugalų kalba), ro (Rumunijos), ru (Rusų kalba), sk (Slovakų), sl (Slovėnijos), sr (Српски), sv (Švedų kalba), th (Thai), tr (Turkijos), uk (Ukrainiečių), vi (Vietnamese), zh (Kinų)
To see the examples of xml request/response, please follow the link: How to get finished order?

Kaip atsisiųsti standartines ataskaitas (kitais nei XML formatais)?

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.

Prašymą sudaro 3 dalys:

  1. Fiksuota dalis https://www.infoproff.com/en/orders/files/
  2. Jūsų unikalus hash, kurį pateikiame atsakydami.
  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, bg, cs, da, de, el, fi, fr, he, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, vi, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - Originalus (be keitimo), 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

Kaip atsisiųsti nestandartinius produktus?

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.

Prašymą sudaro 3 dalys:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Jūsų unikalus hash, kurį pateikiame atsakydami.
  3. Ir fiksuota dalis pabaigoje /download

Kaip gauti kredito nuomonę?

Funkcija CreditOpinionCalculator

Kaip gauti papildomos informacijos?

Funkcija GetClassifiersFinancialStatements
Funkcija GetActivityClassificators
Funkcija GetDictionaryStandardPhrases
Funkcija GetAvailableProducts

delivery_term:

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

Galimos klaidos

Šios klaidos gali atsirasti teikiant užklausą mūsų žiniatinklio paslaugai..

Visos funkcijos
  • Incorrect username/password or you have no permissions.
    Įvedate neteisingus įgaliojimus arba jūsų API prieiga yra užblokuota.
Funkcija SimpleSearch
  1. You don't have permissions to search in this country.
    Galimų šalių sąrašas: Airija (IRL), Albanijos Respublika (ALB), Alžyro Liaudies Demokratinė Respublika (DZA), Angolos Respublika (AGO), Argentinos Respublika (ARG), Australijos Sandrauga (AUS), Austrijos Respublika (AUT), Azerbaidžano Respublika (AZE), Baltarusijos Respublika (BLR), Belgijos Karalystė (BEL), Benino Respublika (BEN), Bolivijos daugiatautė valstybė (BOL), Bosnija ir Hercegovina (BIH), Botsvanos Respublika (BWA), Brazilijos Federacinė Respublika (BRA), Bulgarijos Respublika (BGR), Danijos Karalystė (DNK), Dramblio Kaulo Krantas (CIV), Džersio Bailiwickas (JEY), Ekvadoro Respublika (ECU), Estijos Respublika (EST), Etiopijos Federacinė Demokratinė Respublika (ETH), Filipinų Respublika (PHL), Gajanos Kooperatinė Respublika (GUY), Gambijos Respublika (GMB), Graikijos Respublika (GRC), Grenlandija (GRL), Gruzija (GEO), Gvadelupa (GLP), Gvinėjos Respublika (GIN), Honkongas (HKG), Islandijos Respublika (ISL), Ispanijos Karalystė (ESP), Italijos Respublika (ITA), Izraelio valstybė (ISR), Japonija (JPN), Jungtinė Didžiosios Britanijos ir Šiaurės Airijos Karalystė (GBR), Jungtinė Tanzanijos Respublika (TZA), Kanada (CAN), Kazachstano Respublika (KAZ), Kenijos Respublika (KEN), Kinijos Liaudies Respublika (CHN), Kinijos Respublika (TWN), Kipro Respublika (CYP), Kirgizijos Respublika (KGZ), Kongo Respublika (COG), Kosovas (XXK), Kroatijos Respublika (HRV), Latvijos Respublika (LVA), Lenkijos Respublika (POL), Lichtenšteino Kunigaikštystė (LIE), Lietuvos Respublika (LTU), Liuksemburgo Didžioji Hercogystė (LUX), Madagaskaro Respublika (MDG), Majotas (MYT), Maldyvų Respublika (MDV), Maltos Respublika (MLT), Maroko Karalystė (MAR), Martinika (MTQ), Mauricijaus Respublika (MUS), Meno sala (IMN), Moldovos Respublika (MDA), Monako Kunigaikštystė (MCO), Mongolija (MNG), Namibijos Respublika (NAM), Naujoji Zelandija (NZL), Nepriklausoma Samoa valstybė (WSM), Nigerijos Federacinė Respublika (NGA), Norvegijos Karalystė (NOR), Nyderlandų Karalystė (NLD), Paragvajaus Respublika (PRY), Peru Respublika (PER), Pietų Afrikos Respublika (ZAF), Portugalijos Respublika (PRT), Prancūzijos Gviana (GUF), Prancūzijos Respublika (FRA), Reunjonas (REU), Ruandos Respublika (RWA), Rumunija (ROU), Rusijos Federacija (RUS), Rytų Urugvajaus Respublika (URY), San Marino Respublika (SMR), Seišelių Respublika (SYC), Serbijos Respublika (SRB), Singapūro Respublika (SGP), Slovakijos Respublika (SVK), Slovėnijos Respublika (SVN), Suomijos Respublika (FIN), Tadžikistano Respublika (TJK), Tailando Karalystė (THA), Togo Respublika (TGO), Uzbekistano Respublika (UZB), Venesuelos Bolivaro Respublika (VEN), Vengrijos Respublika (HUN), Vokietijos Federacinė Respublika (DEU), Zambijos Respublika (ZMB), Zimbabvės Respublika (ZWE), Čekija (CZE), Čilės Respublika (CHL), Šri Lankos Demokratinė Socialistinė Respublika (LKA), Šv. Martyno sala (MAF), Švedijos Karalystė (SWE), Šveicarijos Konfederacija (CHE)
Funkcija Order
  1. This product is not available.
    Tokio produkto nerandama ir jo neįmanoma užsisakyti.
  2. You can't order report on company with legal form: "legal_form"
    Ši klaida taikoma tik: Švedijos Karalystė (SWE)
    Švedijoje negalima užsisakyti internetinės ataskaitos (delivery_term = "o") su kitomis teisinėmis formomis:
    • 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
    Užsakant ataskaitą neprisijungus prie interneto (delivery_term = "n", "f" arba "s"), būtina nurodyti "Business Name" arba "Reg Code".
  5. Reg Code is required when delivery term is Online
    Užsakant ataskaitą internetu (delivery_term = "o"), būtina nurodyti "Reg. kodą".
Funkcija GetReport
  1. This language is not supported.
    Prieinamų internetinių ataskaitų kalbų sąrašas: ar (Arabic), bg (Bulgarų), cs (Čekijos), da (Danų), de (Vokiečių kalba), el (Graikų kalba), en (Anglų kalba), es (Ispanų kalba), et (Estų kalba), fi (Suomijos), fr (Prancūzų kalba), he (Hebrew), hu (Vengrų), id (Indonezijos), it (Italų kalba), ja (Japonų), ko (Korėjiečių kalba), lt (Lietuvių kalba), lv (Latvijos), nb (Norvegų bokmål), nl (Olandų kalba), pl (Lenkų kalba), pt (Portugalų kalba), ro (Rumunijos), ru (Rusų kalba), sk (Slovakų), sl (Slovėnijos), sr (Српски), sv (Švedų kalba), th (Thai), tr (Turkijos), uk (Ukrainiečių), vi (Vietnamese), zh (Kinų)
Funkcijos GetReport ChkStatus
  1. Incorrect order_id.
    Užsakymo ID nerandamas. Užsakymo ID gausite, kai naudosite Order funkciją.
Funkcija OrderCancellation
  1. Your order is already canceled.
    Jūs nebeturite leidimo atšaukti užsakymo.
Funkcija 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 versija) pakeitimai, palyginti su SOAP (3 versija)

Naujos skiltys

  • country_economic_overview economic_forecast — apima šiuos poskyrius: „ data_transparency_index “ (Mokesčiai, kuriuos moka įmonė), „ country_development_indicators “ (Mokesčiai, kuriuos moka darbuotojai
  • paid_taxes — informacija apie sumokėtus mokesčius.
  • tenders — informacija apie konkursus.
  • sanctions — pridėta prie skyriaus „ negative_information “.

Esamų skyrių atnaujinimai

Skyriuose „ beneficiaries “, „ shareholders “, „ managers “ ir „ employees_data “ buvo pridėtas šis elementas:
  • source_type — duomenų šaltinio tipas (pvz., „ official “, „ mass_media “, „ company_admin “ ir kt.).
Skyriuje „ relations_of_persons “ (Duomenų šaltinio aprašymas) buvo pridėtas naujas elementas:
  • match_type
Skyrius „ capital “ buvo pertvarkytas:
  • Elementas „ capital_amount “ (Pagrindinis šaltinis) pervadintas į „ issued_capital “ (Pagrindinis šaltinis).
  • Pridėti šie nauji elementai:
    • number_of_shares
    • share_value
    • authorized_capital
Skyriuje „ employees_data “ (Duomenų kokybė):
  • Naujas elementas „ group_figure “ nurodo, ar duomenys apima grupės lygio suvestinius skaičius (true).
  • Elementas „ source_type “ nurodo duomenų šaltinio tipą.
  • Elementas „ is_estimated “ dabar įtraukiamas tik tuo atveju, jei jo vertė yra „ true “.
Nauja dalis „ assets_data “ (duomenų šaltinio informacija) — sujungia anksčiau buvusias dalis:
  • real_estate_data (anksčiau vadintas „ property_data “), „ vehicles “, „ machinery_and_equipment “ (anksčiau vadintas „ assets “).
  • Planuojami papildymai: „ patents “ ir „ biological_assets “.
Skyriuje „ vehicles “ buvo pridėtas naujas laukas:
  • value
Skyriuje „ litigations “ buvo pridėti šie elementai:
  • content, „ instance “ (Pagrindinis tinklalapis), „ process “ (Pagrindinis tinklalapis authority
„ financial_statement/positions “ ir „ summary/latest_turnovers “ pridėtas naujas elementas:
  • value_origin — apibūdina vertės kilmę; pavyzdžiui, vertė „ estimated “ – ši vertė yra apskaičiuota ir apskaičiuota remiantis turimais duomenimis, naudojant logiką arba AI.
Skyriuje „ branches_data “ buvo pridėti šie laukai:
  • registration_number
  • director_name

Pastaba: stabilizavimo etapu gali būti daromi nedideli patobulinimai ir koregavimai.

Webhooks Settings

Apžvalga

Webhook - tai būdas, kuriuo programa gali teikti kitoms programoms informaciją realiuoju laiku. Mūsų webhook funkcija įgyvendina HTTP atgalinius skambučius, sukonfigūruotus pagal URL. Į šį URL siunčiamas HTTP POST naudingasis krūvis JSON formatu, kai tik įvyksta nurodytas įvykis. Mūsų projekto kontekste webhook funkciją sukūrėme taip, kad ji sukeltų konkrečius įvykius.

Webhook nustatymas

Norėdami nustatyti savo programai skirtą žiniatinklio kabliuką, eikite į programos nustatymų puslapį ir ieškokite skyriaus "Webhooks Settings" (žiniatinklio kabliukų nustatymai). Pateikite šią informaciją:

  1. "Webhook URL " - tai URL, į kurį jūsų serveris gaus webhook POST užklausas.
  2. "Delivery max attempts " yra nustatymas, apibrėžiantis didžiausią pakartotinių bandymų skaičių, kurie turėtų būti atliekami pristatant webhook įvykį, kai pirmasis bandymas pristatyti nepavyksta.
  3. "Delivery retry timeout" yra nustatymas, leidžiantis nurodyti laiko intervalą tarp pakartotinių bandymų, kai nepavyksta pristatyti žiniatinklio kablio.

Pateikę šią informaciją, spustelėkite "Išsaugoti".

Webhook įvykių tipai

  1. Naujas užsakymo statusas

Webhook naudingoji apkrova

Įvykus įvykiui, į naudingosios apkrovos URL nusiųsime HTTP POST užklausą su JSON kūnu, kuriame bus informacija apie įvykį.

Pateikiame naudingosios apkrovos pavyzdį:
Naujos užsakymo būsenos įkrovos pavyzdys
Galimos "new_status" lauko reikšmės:
  • "Finished" - užsakymas baigtas. Užsakymą galima atsiimti;
  • "Updated" - atnaujintas užsakymas, į užbaigtą užsakymą įtraukti duomenys.;
  • "Canceled" - užsakymas atšaukiamas kliento prašymu (arba sutikimu).;
  • "Rejected" - užsakymas atmetamas. Paprastai dėl to, kad neįmanoma nustatyti įmonės.
  • "Identification pending" - prieš ruošdami užsakymą, mums reikia daugiau informacijos iš kliento..

Webhooks saugojimas

Svarbu patikrinti, ar POST užklausos, siunčiamos į naudingosios apkrovos URL, yra iš mūsų programos. Kad tai būtų lengviau padaryti, į kiekvieną Webhook užklausą įtraukiama X-Signature antraštė.

Parašas Aprašymas

Pasirašymui naudojame HMAC su SHA512 algoritmu.

Slaptas - tai programėlės ID ir slapto rakto iš žiniatinklio kabliukų nustatymų santrauka.

Jei reikia, į galinį tašką galima pridėti savo "get params", kad būtų galima nustatyti siuntėją.

Trikčių šalinimas

Serveris turi atsakyti per 10 sekundžių ir grąžinti 2XX HTTP kodą; priešingu atveju laikoma, kad žiniatinklio kablys pristatytas nesėkmingai. Nesėkmės atveju funkcija bandys pakartotinai išsiųsti užklausą pagal pristatymo politiką.