Dokumentacija API Infoproffa - 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)
  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: Francoska republika (FRA), Georgia (GEO), Grenlandija (GRL), 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 Belorusija (BLR), Republika Ciper (CYP), Republika Estonija (EST), Republika Finska (FIN), Republika Kazahstan (KAZ), Republika Moldavija (MDA), Republika Poljska (POL), Republika Uzbekistan (UZB), Združeno kraljestvo Velika Britanija in Severna Irska (GBR), Zvezna republika Nemčija (DEU), Švicarska konfederacija (CHE)
Pomembne informacije:

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

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

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), Republika Estonija (EST), Republika Finska (FIN), Republika Kazahstan (KAZ), Republika Poljska (POL)
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), 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), sv (Švedski), tr (Turški), uk (Ukrajinski), zh (Kitajski)

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), 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, 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: Francoska republika (FRA), Georgia (GEO), Grenlandija (GRL), 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 Belorusija (BLR), Republika Ciper (CYP), Republika Estonija (EST), Republika Finska (FIN), Republika Kazahstan (KAZ), Republika Moldavija (MDA), Republika Poljska (POL), Republika Uzbekistan (UZB), Združeno kraljestvo Velika Britanija in Severna Irska (GBR), Zvezna republika Nemčija (DEU), Š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), 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: Francoska republika (FRA), Georgia (GEO), Grenlandija (GRL), 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 Belorusija (BLR), Republika Ciper (CYP), Republika Estonija (EST), Republika Finska (FIN), Republika Kazahstan (KAZ), Republika Moldavija (MDA), Republika Poljska (POL), Republika Uzbekistan (UZB), Združeno kraljestvo Velika Britanija in Severna Irska (GBR), Zvezna republika Nemčija (DEU), Š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), Republika Estonija (EST), Republika Finska (FIN), Republika Kazahstan (KAZ), Republika Poljska (POL)

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