Dokumentacija API Infoproffa - v3

Različica stikala V3

Začetek

Spletna storitev wsdl in sheme se nahajajo tukaj:

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

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), 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ženi arabski emirati (ARE), 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: Kirgiška republika (KGZ), Kraljevina Belgija (BEL), Kraljevina Nizozemska (NLD), Kraljevina Švedska (SWE), Ljudska republika Kitajska (CHN), Mongolija (MNG), Republika Estonija (EST), Republika Finska (FIN), Republika Kazahstan (KAZ), Republika Poljska (POL), Ruska federacija (RUS)
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
  • 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: 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), 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), tr (Turški), uk (Ukrajinski), 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
  • 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: 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), 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), tr (Turški), uk (Ukrajinski), 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
  • 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: 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), 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), tr (Turški), uk (Ukrajinski), 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, bg, cs, da, de, el, fi, fr, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, tr, uk, 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), 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ženi arabski emirati (ARE), 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: 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), 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), tr (Turški), uk (Ukrajinski), 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 3) v primerjavi s SOAP (različica 2)

Spremembe SOAP (različica 3) v primerjavi s SOAP (različica 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: 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), 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ženi arabski emirati (ARE), 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)

- 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: Kirgiška republika (KGZ), Kraljevina Belgija (BEL), Kraljevina Nizozemska (NLD), Kraljevina Švedska (SWE), Ljudska republika Kitajska (CHN), Mongolija (MNG), Republika Estonija (EST), Republika Finska (FIN), Republika Kazahstan (KAZ), Republika Poljska (POL), Ruska federacija (RUS)

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

3) Function: GetReport

- Changes in of available languages: 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), 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), tr (Turški), uk (Ukrajinski), zh (Kitajski)


Spremembe SOAP (različica 3) v primerjavi s SOAP (različica 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

Novi elementi:

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

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

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.

© Dokumentacija API Infoproffa 2025