Dokumentacija API Infoproffa - v4

Različica stikala V4

Začetek

Spletna storitev wsdl in sheme se nahajajo tukaj:

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 - Iskanje informacij o podjetjih v različnih državah.
  • ChkFinance - Poiščite razpoložljive računovodske izkaze.
  • Order - Ustvari order_id in vrne dvojnike. Dvojniki so izbrani z naslednjimi parametri: country, product, reg_code.
  • OrderCancellation - Če ste poslali zahtevek za naročilo in prejeli order_id, imate možnost preklicati to naročilo (če še ni v proizvodnji).
  • OrderConfirmation - Po prejemu spletne strani order_id boste morali svoje naročilo potrditi v eni uri. Če naročila ne boste potrdili v eni uri, bo naročilo samodejno preklicano.
  • ChkStatus - Preverite stanje naročila.
  • GetReport - Pridobite dokončana poročila.
  • GetClassifiersFinancialStatements - Pridobi vse finančne dokumente z vsemi elementi: številka_vrstice, oblikovan_opis_vrstice, ključ_jezika_vrstice in vrstni red.
  • GetLegalForms - Pridobite vse pravne obrazce za vse razpoložljive države.
  • GetActivityClassificators - Pridobite vse kode in opise za določen klasifikator dejavnosti.
  • GetDictionaryStandardPhrases - Pridobite vse standardne fraze s ključi in jezikom.
  • GetAvailableProducts - Pridobite seznam razpoložljivih izdelkov.
  • CreditOpinionCalculator - Kalkulator kreditnega mnenja pomaga dodeliti kreditno mnenje podjetju.

API zagotavlja več storitev:

  1. Spletna kreditna poročila za naslednje države: Republika Finska (FIN), Kraljevina Švedska (SWE), Kraljevina Belgija (BEL), Kraljevina Nizozemska (NLD), Republika Estonija (EST), Republika Kazahstan (KAZ), Republika Poljska (POL), Kirgiška republika (KGZ), Ljudska republika Kitajska (CHN), Mongolija (MNG)
  2. Poročila brez povezave za naslednje države: Vse države
  3. Kalkulator kreditnega mnenja

Kako poiskati podjetje?

Iskanje podjetja sestavljata 2 možnosti:

  1. Iskanje po imenu podjetja,
  2. Search by company code.
Seznam razpoložljivih držav: Argentinska republika (ARG), Avstralska zveza (AUS), Bailiwick of Jersey (JEY), Bolivarska republika Venezuela (VEN), Bosna in Hercegovina (BIH), Demokratična socialistična republika Šrilanka (LKA), Država Izrael (ISR), Federativna republika Brazilija (BRA), Francoska Gvajana (GUF), Francoska republika (FRA), Georgia (GEO), Grenlandija (GRL), Guadeloupe (GLP), Helenska republika (GRC), Hongkong (HKG), Irska (IRL), Italijanska republika (ITA), Japonska (JPN), Južnoafriška republika (ZAF), Kanada (CAN), Kirgiška republika (KGZ), Kneževina Lihtenštajn (LIE), Kneževina Monako (MCO), Kolektiviteta Saint Martin (MAF), Kosovo (XXK), Kraljevina Belgija (BEL), Kraljevina Danska (DNK), Kraljevina Maroko (MAR), Kraljevina Nizozemska (NLD), Kraljevina Norveška (NOR), Kraljevina Tajska (THA), Kraljevina Španija (ESP), Kraljevina Švedska (SWE), Ljudska demokratična republika Alžirija (DZA), Ljudska republika Kitajska (CHN), Martinique (MTQ), Mayotte (MYT), Množična država Bolivija (BOL), Mongolija (MNG), Neodvisna država Samoa (WSM), Nova Zelandija (NZL), Otok Man (IMN), Portugalska republika (PRT), Republika Albanija (ALB), Republika Angola (AGO), Republika Avstrija (AUT), Republika Azerbajdžan (AZE), Republika Belorusija (BLR), Republika Benin (BEN), Republika Bocvana (BWA), Republika Bolgarija (BGR), Republika Ciper (CYP), Republika Ekvador (ECU), Republika Estonija (EST), Republika Filipini (PHL), Republika Finska (FIN), Republika Gambija (GMB), Republika Gvineja (GIN), Republika Hrvaška (HRV), Republika Islandija (ISL), Republika Kazahstan (KAZ), Republika Kenija (KEN), Republika Kitajska (TWN), Republika Kongo (COG), Republika Latvija (LVA), Republika Litva (LTU), Republika Madagaskar (MDG), Republika Madžarska (HUN), Republika Maldivi (MDV), Republika Malta (MLT), Republika Mauritius (MUS), Republika Moldavija (MDA), Republika Namibija (NAM), Republika Paragvaj (PRY), Republika Peru (PER), Republika Poljska (POL), Republika Ruanda (RWA), Republika San Marino (SMR), Republika Sejšeli (SYC), Republika Singapur (SGP), Republika Slovenija (SVN), Republika Srbija (SRB), Republika Tadžikistan (TJK), Republika Togo (TGO), Republika Uzbekistan (UZB), Republika Zambija (ZMB), Republika Zimbabve (ZWE), Republika Čile (CHL), Romunija (ROU), Ruska federacija (RUS), Slonokoščena obala (CIV), Slovaška republika (SVK), Srečanje (REU), Veliko vojvodstvo Luksemburg (LUX), Vzhodna Republika Urugvaj (URY), Zadružna republika Gvajana (GUY), Združena republika Tanzanija (TZA), Združeno kraljestvo Velika Britanija in Severna Irska (GBR), Zvezna demokratična republika Etiopija (ETH), Zvezna republika Nemčija (DEU), Zvezna republika Nigerija (NGA), Češka republika (CZE), Švicarska 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.

Pomembne informacije:

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.

Norveški register ne omogoča iskanja izbrisanih podjetij po imenih. Zato ne moremo zagotoviti SimpleSearch po imenih znotraj izbrisanih podjetij na Norveškem.

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

Spodaj najdete primer:

Funkcija SimpleSearch

Možnost 2: Iskanje po registracijski kodi

Funkcija SimpleSearch

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

Funkcija UnifiedSearch

Kako naročiti kreditno poročilo?

List of available countries for online credit reports: Francoska republika (FRA), Helenska republika (GRC), Irska (IRL), Italijanska republika (ITA), Kirgiška republika (KGZ), Kraljevina Belgija (BEL), Kraljevina Danska (DNK), Kraljevina Nizozemska (NLD), Kraljevina Norveška (NOR), Kraljevina Španija (ESP), Kraljevina Švedska (SWE), Ljudska republika Kitajska (CHN), Mongolija (MNG), Portugalska republika (PRT), Republika Avstrija (AUT), Republika Azerbajdžan (AZE), Republika Bolgarija (BGR), Republika Estonija (EST), Republika Finska (FIN), Republika Hrvaška (HRV), Republika Kazahstan (KAZ), Republika Latvija (LVA), Republika Madžarska (HUN), Republika Malta (MLT), Republika Moldavija (MDA), Republika Poljska (POL), Republika Slovenija (SVN), Ruska federacija (RUS), Slovaška republika (SVK), Veliko vojvodstvo Luksemburg (LUX), Združeno kraljestvo Velika Britanija in Severna Irska (GBR), Zvezna republika Nemčija (DEU), Češka republika (CZE), Švicarska 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: Kako poiskati podjetje?

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.

Za poročila se uporabljajo naslednji statusi:

  • V teku - Poročilo v fazi izdelave
  • Identification pending - Priprava poročila je zadržana. Od stranke zahteva dodatne podatke.
  • Canceled - Preklicano naročilo
  • Finished - Poročilo je pripravljeno
  • Updated - Končnemu poročilu so bile dodane informacije
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - V našem sistemu je prišlo do tehnične napake. To pomeni, da smo o tej napaki obveščeni in jo bomo čim prej odpravili. Obveščeni boste, ko boste lahko prejeli naročilo.

Če je status izvedbe Finished ali Updated, lahko dobite naročilo.

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

Funkcija GetReport
Seznam razpoložljivih jezikov: ar (Arabic), bg (Bolgarski), cs (Češki), da (Danska), de (Nemščina), el (Grški), en (Angleščina), es (Španščina), et (Estonski), fi (Finska), fr (Francoski), he (Hebrew), hu (Madžarski), id (Indonezijski), it (Italijanski), ja (Japonski), ko (Korejski), lt (Litvanski), lv (Latvijski), nb (norveški bokmål), nl (Nizozemska), pl (Poljski), pt (Portugalska), ro (Romunski), ru (Ruski), sk (Slovaška), sl (Slovenski), sr (Српски), sv (Švedski), th (Thai), tr (Turški), uk (Ukrajinski), vi (Vietnamese), zh (Kitajski)

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.

Za poročila se uporabljajo naslednji statusi:

  • V teku - Poročilo v fazi izdelave
  • Identification pending - Priprava poročila je zadržana. Od stranke zahteva dodatne podatke.
  • Canceled - Preklicano naročilo
  • Finished - Poročilo je pripravljeno
  • Updated - Končnemu poročilu so bile dodane informacije
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - V našem sistemu je prišlo do tehnične napake. To pomeni, da smo o tej napaki obveščeni in jo bomo čim prej odpravili. Obveščeni boste, ko boste lahko prejeli naročilo.

Če je status izvedbe Finished ali Updated, lahko dobite naročilo.

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

Funkcija GetReport
Seznam razpoložljivih jezikov: ar (Arabic), bg (Bolgarski), cs (Češki), da (Danska), de (Nemščina), el (Grški), en (Angleščina), es (Španščina), et (Estonski), fi (Finska), fr (Francoski), he (Hebrew), hu (Madžarski), id (Indonezijski), it (Italijanski), ja (Japonski), ko (Korejski), lt (Litvanski), lv (Latvijski), nb (norveški bokmål), nl (Nizozemska), pl (Poljski), pt (Portugalska), ro (Romunski), ru (Ruski), sk (Slovaška), sl (Slovenski), sr (Српски), sv (Švedski), th (Thai), tr (Turški), uk (Ukrajinski), vi (Vietnamese), zh (Kitajski)

Kako naročiti arhivirano kreditno poročilo?

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: Kako poiskati podjetje?

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.

Kako naročiti spletne računovodske izkaze?

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: Kako poiskati podjetje?

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: Iskanje razpoložljivih računovodskih izkazov

Funkcija ChkFinance

Ta funkcija je potrebna samo pri naročanju izdelka: finances (Financial statements) s delivery_term = 'o'.

Seznam razpoložljivih držav: Republika Estonija (EST), Kraljevina Švedska (SWE)

STEP 3: Naročite računovodske izkaze

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.

Za poročila se uporabljajo naslednji statusi:

  • V teku - Poročilo v fazi izdelave
  • Identification pending - Priprava poročila je zadržana. Od stranke zahteva dodatne podatke.
  • Canceled - Preklicano naročilo
  • Finished - Poročilo je pripravljeno
  • Updated - Končnemu poročilu so bile dodane informacije
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - V našem sistemu je prišlo do tehnične napake. To pomeni, da smo o tej napaki obveščeni in jo bomo čim prej odpravili. Obveščeni boste, ko boste lahko prejeli naročilo.

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
Seznam razpoložljivih jezikov: ar (Arabic), bg (Bolgarski), cs (Češki), da (Danska), de (Nemščina), el (Grški), en (Angleščina), es (Španščina), et (Estonski), fi (Finska), fr (Francoski), he (Hebrew), hu (Madžarski), id (Indonezijski), it (Italijanski), ja (Japonski), ko (Korejski), lt (Litvanski), lv (Latvijski), nb (norveški bokmål), nl (Nizozemska), pl (Poljski), pt (Portugalska), ro (Romunski), ru (Ruski), sk (Slovaška), sl (Slovenski), sr (Српски), sv (Švedski), th (Thai), tr (Turški), uk (Ukrajinski), vi (Vietnamese), zh (Kitajski)
To see the examples of xml request/response, please follow the link: How to get finished order?

Kako prenesti standardna poročila (v formatih, ki niso 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.

Zahteva je sestavljena iz treh delov:

  1. Fiksni del https://www.infoproff.com/en/orders/files/
  2. vaš edinstveni hash, ki ga posredujemo v odgovor.
  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 - Izvirnik (brez zamenjave), 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

Kako prenesti nestandardne izdelke?

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.

Zahteva je sestavljena iz treh delov:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. vaš edinstveni hash, ki ga posredujemo v odgovor.
  3. In fiksni del na koncu /download

Kako pridobiti mnenje o kreditu?

Funkcija CreditOpinionCalculator

Kako pridobiti dodatne informacije?

Funkcija GetClassifiersFinancialStatements
Funkcija GetActivityClassificators
Funkcija GetDictionaryStandardPhrases
Funkcija GetAvailableProducts

delivery_term:

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

Možne napake

Te napake se lahko pojavijo med oddajo zahteve naši spletni storitvi..

Vse funkcije
  • Incorrect username/password or you have no permissions.
    Vnesli ste napačne poverilnice ali pa je vaš dostop do API blokiran.
Funkcija SimpleSearch
  1. You don't have permissions to search in this country.
    Seznam razpoložljivih držav: Argentinska republika (ARG), Avstralska zveza (AUS), Bailiwick of Jersey (JEY), Bolivarska republika Venezuela (VEN), Bosna in Hercegovina (BIH), Demokratična socialistična republika Šrilanka (LKA), Država Izrael (ISR), Federativna republika Brazilija (BRA), Francoska Gvajana (GUF), Francoska republika (FRA), Georgia (GEO), Grenlandija (GRL), Guadeloupe (GLP), Helenska republika (GRC), Hongkong (HKG), Irska (IRL), Italijanska republika (ITA), Japonska (JPN), Južnoafriška republika (ZAF), Kanada (CAN), Kirgiška republika (KGZ), Kneževina Lihtenštajn (LIE), Kneževina Monako (MCO), Kolektiviteta Saint Martin (MAF), Kosovo (XXK), Kraljevina Belgija (BEL), Kraljevina Danska (DNK), Kraljevina Maroko (MAR), Kraljevina Nizozemska (NLD), Kraljevina Norveška (NOR), Kraljevina Tajska (THA), Kraljevina Španija (ESP), Kraljevina Švedska (SWE), Ljudska demokratična republika Alžirija (DZA), Ljudska republika Kitajska (CHN), Martinique (MTQ), Mayotte (MYT), Množična država Bolivija (BOL), Mongolija (MNG), Neodvisna država Samoa (WSM), Nova Zelandija (NZL), Otok Man (IMN), Portugalska republika (PRT), Republika Albanija (ALB), Republika Angola (AGO), Republika Avstrija (AUT), Republika Azerbajdžan (AZE), Republika Belorusija (BLR), Republika Benin (BEN), Republika Bocvana (BWA), Republika Bolgarija (BGR), Republika Ciper (CYP), Republika Ekvador (ECU), Republika Estonija (EST), Republika Filipini (PHL), Republika Finska (FIN), Republika Gambija (GMB), Republika Gvineja (GIN), Republika Hrvaška (HRV), Republika Islandija (ISL), Republika Kazahstan (KAZ), Republika Kenija (KEN), Republika Kitajska (TWN), Republika Kongo (COG), Republika Latvija (LVA), Republika Litva (LTU), Republika Madagaskar (MDG), Republika Madžarska (HUN), Republika Maldivi (MDV), Republika Malta (MLT), Republika Mauritius (MUS), Republika Moldavija (MDA), Republika Namibija (NAM), Republika Paragvaj (PRY), Republika Peru (PER), Republika Poljska (POL), Republika Ruanda (RWA), Republika San Marino (SMR), Republika Sejšeli (SYC), Republika Singapur (SGP), Republika Slovenija (SVN), Republika Srbija (SRB), Republika Tadžikistan (TJK), Republika Togo (TGO), Republika Uzbekistan (UZB), Republika Zambija (ZMB), Republika Zimbabve (ZWE), Republika Čile (CHL), Romunija (ROU), Ruska federacija (RUS), Slonokoščena obala (CIV), Slovaška republika (SVK), Srečanje (REU), Veliko vojvodstvo Luksemburg (LUX), Vzhodna Republika Urugvaj (URY), Zadružna republika Gvajana (GUY), Združena republika Tanzanija (TZA), Združeno kraljestvo Velika Britanija in Severna Irska (GBR), Zvezna demokratična republika Etiopija (ETH), Zvezna republika Nemčija (DEU), Zvezna republika Nigerija (NGA), Češka republika (CZE), Švicarska konfederacija (CHE)
Funkcija Order
  1. This product is not available.
    Takega izdelka ni mogoče najti in ga ni mogoče naročiti.
  2. You can't order report on company with legal form: "legal_form"
    Ta napaka velja samo za: Kraljevina Švedska (SWE)
    Na Švedskem ni mogoče naročiti spletnega poročila (delivery_term = "o") z naslednjimi pravnimi obrazci:
    • 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
    Pri naročanju poročila brez povezave (delivery_term = "n", "f" ali "s") se zahteva "Ime podjetja" ali "Reg. koda".
  5. Reg Code is required when delivery term is Online
    Pri spletnem naročanju poročila (delivery_term = "o") je potrebna "Reg Code".
Funkcija GetReport
  1. This language is not supported.
    Seznam jezikov, ki so na voljo za spletna poročila: ar (Arabic), bg (Bolgarski), cs (Češki), da (Danska), de (Nemščina), el (Grški), en (Angleščina), es (Španščina), et (Estonski), fi (Finska), fr (Francoski), he (Hebrew), hu (Madžarski), id (Indonezijski), it (Italijanski), ja (Japonski), ko (Korejski), lt (Litvanski), lv (Latvijski), nb (norveški bokmål), nl (Nizozemska), pl (Poljski), pt (Portugalska), ro (Romunski), ru (Ruski), sk (Slovaška), sl (Slovenski), sr (Српски), sv (Švedski), th (Thai), tr (Turški), uk (Ukrajinski), vi (Vietnamese), zh (Kitajski)
Funkcije GetReport ChkStatus
  1. Incorrect order_id.
    ID naročila ni mogoče najti. ID naročila dobite, ko uporabite funkcijo Order.
Funkcija OrderCancellation
  1. Your order is already canceled.
    Nimate več dovoljenja za preklic naročila.
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'.

Spremembe SOAP (različica 4) v primerjavi s SOAP (različica 3)

Nove sekcije

  • country_economic_overview — vključuje naslednje pododdelke: data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — informacije o plačanih davkih.
  • tenders — informacije o razpisih.
  • sanctions — dodano v oddelek negative_information.

Posodobitve obstoječih poglavij

V oddelkih beneficiaries, shareholders, managers in employees_data je bil dodan naslednji element:
  • source_type — vrsta vira podatkov (npr. official, mass_media, company_admin, itd.).
V oddelku relations_of_persons je bil dodan nov element:
  • match_type
Oddelek capital je bil preoblikovan:
  • Element » capital_amount « je bil preimenovan v » issued_capital «.
  • Dodani so bili naslednji novi elementi:
    • number_of_shares
    • share_value
    • authorized_capital
V oddelku „ employees_data “:
  • Nov element group_figure označuje, ali podatki vključujejo agregirane podatke na ravni skupine (true).
  • Element source_type določa vrsto vira podatkov.
  • Element „ is_estimated “ je zdaj vključen le, če je njegova vrednost „ true “.
Novi oddelek „ assets_data “ (skupinski podatki) združuje prej obstoječe oddelke:
  • real_estate_data (prej imenovani property_data), vehicles, machinery_and_equipment (prej imenovani assets).
  • Načrtovane prihodnje dopolnitve: patents in biological_assets.
V razdelku vehicles je bilo dodano novo polje:
  • value
V razdelku litigations so bili dodani naslednji elementi:
  • content, instance, process, authority
V financial_statement/positions in summary/latest_turnovers je bil dodan nov element:
  • value_origin — opisuje izvor vrednosti; na primer vrednost estimated – ta vrednost je ocenjena in izračunana na podlagi razpoložljivih podatkov z uporabo logike ali umetne inteligence.
V razdelku branches_data so bila dodana naslednja polja:
  • registration_number
  • director_name

Opomba: Med stabilizacijsko fazo lahko pride do manjših izboljšav in prilagoditev.

Webhooks Settings

Pregled

Spletna ključavnica je način, kako lahko aplikacija drugim aplikacijam posreduje informacije v realnem času. Naša funkcija webhook izvaja povratne klice HTTP, ki so konfigurirani z naslovom URL. Ko se zgodi določen dogodek, se na ta naslov URL pošlje koristni tovor HTTP POST v obliki JSON. V okviru našega projekta smo funkcijo webhook zasnovali tako, da sproži določene dogodke.

Nastavitev funkcije Webhook

Če želite nastaviti spletno kljuko za svojo aplikacijo, pojdite na stran z nastavitvami aplikacije in poiščite razdelek "Nastavitve spletnih kljuk". Navedite naslednje informacije:

  1. "URL spletne kljuke " je URL, v katerem bo strežnik prejemal zahteve POST spletne kljuke.
  2. "Največ poskusov dostave " je nastavitev, ki določa največje število ponovnih poskusov za dostavo dogodka webhook, kadar prvi poskus dostave ni uspešen.
  3. "Časovna omejitev ponovnega poskusa dostave " je nastavitev, ki omogoča določitev časovnega intervala med ponovitvami, kadar poskus dostave spletne kljuke ni uspešen.

Po vnosu teh podatkov kliknite na "Shrani".

Vrste dogodkov Webhook

  1. Nov status naročila

Koristni tovor Webhook

Ko pride do dogodka, pošljemo zahtevo HTTP POST na naslov URL s koristnim bremenom s telesom JSON, ki vsebuje informacije o dogodku.

Tukaj je primer koristnega bremena:
Primer prenosa novega statusa naročila
Možne vrednosti polja "new_status":
  • "Finished" - naročilo je zaključeno. Naročilo lahko prevzamete;
  • "Updated" - posodobljeno naročilo, podatki, dodani zaključenemu naročilu.;
  • "Canceled" - preklic naročila na zahtevo (ali soglasje) stranke.;
  • "Rejected" - se naročilo zavrne. Običajno zato, ker podjetja ni mogoče identificirati..
  • "Identification pending" - potrebujemo več informacij od stranke, preden lahko pripravimo naročilo..

Varovanje spletnih kljuk

Pomembno je preveriti, ali so zahtevki POST, poslani na naslov URL s koristnim bremenom, poslani iz naše aplikacije. Za pomoč pri tem vsaka zahteva za spletno kljuko vsebuje glavo X-Signature.

Podpis Opis

Za podpisovanje uporabljamo HMAC z algoritmom SHA512.

Skrivnost je kombinacija ID aplikacije in skrivnostnega ključa iz nastavitev spletnih ključev.

Po potrebi je mogoče končni točki dodati lastne parame get za identifikacijo pošiljatelja.

Odpravljanje težav

Strežnik se mora odzvati v 10 sekundah in vrniti kodo HTTP 2XX, sicer se dostava spletne kljuke šteje za neuspešno. V primeru neuspeha bo funkcija poskusila ponovno poslati zahtevo v skladu s politiko dostave.