Dokumentácia API Infoproff - v2

Verzia prepínača V2

Začíname

Webová služba wsdl a schémy sa nachádzajú tu:

http://wsdfn.infoproff.com/v2/

Hlavné funkcie webovej služby:

  • SimpleSearch - Vyhľadávanie informácií o spoločnostiach v rôznych krajinách.
  • Order - Vytvorí stránku order_id a vráti duplikáty. Duplikáty sa vyberajú podľa nasledujúcich parametrov: country, product, delivery_term and reg_code.
  • OrderCancellation - Ak ste odoslali žiadosť o objednávku a dostali ste adresu order_id, máte možnosť túto objednávku zrušiť (ak sa ešte nezačala vyrábať).
  • OrderConfirmation - Po získaní adresy order_id budete musieť svoju objednávku potvrdiť do 1 hodiny. Ak objednávku nepotvrdíte do 1 hodiny, objednávka sa automaticky zruší.
  • ChkStatus - Skontrolujte stav objednávky.
  • GetReport - Získajte hotové správy.
  • GetClassifiersFinancialStatements - Získanie všetkých finančných dokladov so všetkými prvkami: číslo_riadku, formátovaný_opis_riadku, kľúč_jazyka_riadku a poradie_riadku.
  • GetLegalForms - Získajte všetky právne formuláre pre všetky dostupné krajiny.
  • GetActivityClassificators - Získajte všetky kódy a popisy pre klasifikátor konkrétnej činnosti.
  • GetDictionaryStandardPhrases - Získajte všetky štandardné frázy s kľúčmi a jazykom.
  • GetAvailableProducts - Získajte zoznam dostupných produktov.
  • CreditOpinionCalculator - Kalkulačka úverového posudku pomáha priradiť úverový posudok spoločnosti.

API poskytuje niekoľko služieb:

  1. Online úverové správy pre nasledujúce krajiny: Fínska republika (FIN), Švédske kráľovstvo (SWE)
  2. Offline správy pre tieto krajiny: Všetky krajiny
  3. Kalkulátor úverových názorov

Ako vyhľadať spoločnosť?

Vyhľadávanie spoločnosti pozostáva z 2 možností:

  1. Vyhľadávanie podľa názvu spoločnosti,
  2. Vyhľadávanie podľa registračného kódu.
Zoznam dostupných krajín: Fínska republika (FIN), Švédske kráľovstvo (SWE), Nórske kráľovstvo (NOR), Dánske kráľovstvo (DNK)
Dôležité informácie:
Nórsky register neumožňuje vyhľadávať vymazané spoločnosti podľa názvov. Preto nemôžeme poskytnúť SimpleSearch podľa názvov v rámci vymazaných spoločností v Nórsku.
Field's length:
company_name varchar(512)
company_code varchar(64)

Nižšie nájdete príklad:

Funkcia SimpleSearch

Možnosť 2: Vyhľadávanie podľa registračného kódu

Funkcia SimpleSearch

Ako si objednať úverovú správu?

Postup od registrácie po prijatie správy pozostáva z týchto krokov:

  1. Používateľ zaregistruje novú objednávku (funkcia "Objednávka"). Systém vráti údaje o objednávke, zoznam duplikátov zadaných za posledných 60 dní a čaká na potvrdenie objednávky.
  2. Používateľ potvrdí objednávku (funkcia "OrderConfirmation"). Systém odošle objednávku do výroby a vráti aktuálny stav výroby.
  3. Používateľ skontroluje stav objednávky (funkcia "ChkStatus").
  4. Ak je objednávka pripravená, používateľ si môže stiahnuť správu (funkcia "GetReport").
Zoznam dostupných krajín: Fínska republika (FIN), Švédske kráľovstvo (SWE)
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)

Nižšie nájdete príklad:

KROK 1: Objednávka správy

Používatelia, ktorí považujú krok potvrdenia objednávky za zbytočný, môžu použiť prvok "confirm_order" a odovzdať hodnotu "TRUE".

Príprava úverovej správy v online režime zvyčajne trvá 10-20 sekúnd.
Preto by ste pri online správach mali vykonávať kontroly každých 5 alebo viac sekúnd.

Zoznam dostupných spoločností pre testovacie konto:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
Okrem toho môžete pre online správy (delivery_term = "o"), použiť vzorky vygenerované pre každú krajinu (použite: registračný kód "00000000"). Tieto výkazy sú bezplatné a môžete si ich objednať pomocou testovacieho účtu.
Funkcia Order
Funkcia OrderCancellation

KROK 2. Potvrdenie objednávky

Funkcia OrderConfirmation

KROK 3. Kontrola stavu

Funkcia ChkStatus

KROK 4. Získajte správu

Zoznam dostupných jazykov pre online správy: en (English), et (Estonian), ru (Russian), de (German)
Stiahnutie online správy vo formáte pdf zatiaľ nie je k dispozícii.
Funkcia GetReport

Pre hlásenia sa používajú tieto stavy:

  • Prebieha - Správa vo fáze výroby
  • Canceled - Zrušená objednávka
  • Finished - Správa je pripravená
  • Updated - Do hotovej správy boli doplnené informácie
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - V našom systéme došlo k technickej chybe. To znamená, že sme o tejto chybe informovaní a čo najskôr ju opravíme. O tom, kedy budete môcť objednávku prijať, vás budeme informovať.

Ak je stav vykonania Finished alebo Updated, potom môžete získať príkaz.

Ako stiahnuť správu Offline?

Správy offline si môžete stiahnuť priamo. Tu je návod, ako to urobiť:

Žiadosť pozostáva z 3 častí:

  1. Pevná časť https://www.infoproff.com/en/orders/files/
  2. Váš jedinečný hash, ktorý poskytujeme ako odpoveď
  3. A pevná časť na konci /download

Ako získať úverové stanovisko?

Funkcia CreditOpinionCalculator

Ako získať ďalšie informácie?

Funkcia GetClassifiersFinancialStatements
Funkcia GetActivityClassificators
Funkcia GetDictionaryStandardPhrases
Funkcia GetAvailableProducts

Možné chyby

Tieto chyby sa môžu vyskytnúť pri zadávaní požiadavky na našu webovú službu.

Všetky funkcie
  • Nesprávne používateľské meno/heslo alebo nemáte oprávnenia.
    Zadávate nesprávne poverenia alebo je váš prístup k API zablokovaný.
Funkcia SimpleSearch
  1. V tejto krajine nemáte povolenie na vyhľadávanie.
    Zoznam dostupných krajín: Fínska republika (FIN), Švédske kráľovstvo (SWE)
Funkcia Order
  1. Tento produkt nie je k dispozícii.
    Takýto výrobok nie je možné nájsť a nie je možné ho objednať.
  2. Nemôžete si objednať správu o spoločnosti s právnou formou: "legal_form"
    Táto chyba sa týka len: Švédske kráľovstvo (SWE)
    Vo Švédsku nie je možné objednať online správu (delivery_term = "o") s ďalšími právnymi formulármi:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Táto spoločnosť nie je v zozname testovaných spoločností.
    Registračný kód spoločnosti nie je v našom testovacom zozname.
    Zoznam dostupných spoločností pre testovacie konto:
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. Vyžaduje sa obchodné meno alebo IČO
    Pri objednávaní offline správy (delivery_term = "n", "f" alebo "s") sa vyžaduje "Obchodné meno" alebo "Reg. kód".
  5. Reg. kód sa vyžaduje, ak je termín dodania Online
    Pri objednávaní online správy (delivery_term = "o") sa vyžaduje "Reg Code".
Funkcia GetReport
  1. Tento jazyk nie je podporovaný.
    Zoznam dostupných jazykov pre online správy: en (English), et (Estonian), ru (Russian), de (German)
Funkcie GetReport ChkStatus
  1. Nesprávne order_id.
    ID objednávky sa nedá nájsť. ID objednávky získate, keď použijete funkciu Order.
Funkcia OrderCancellation
  1. Your order is already canceled.
    Už nemáte povolenie zrušiť objednávku.
Funkcia OrderConfirmation
  1. Na potvrdenie objednávky už nemáte povolenie. Potvrdenie je možné vykonať do jednej hodiny od prijatia 'order_id'.

Zmeny v SOAP (verzia 3) v porovnaní so SOAP (verzia 2)

Zmeny v SOAP (verzia 3) v porovnaní so SOAP (verzia 2) [Prehľad]

1) Nová funkcia: ChkFinance

Allows you to search for available financial statements.
Currently available only in EST (Estonia), SWE (Sweden)

2) Funkcia: SimpleSearch

- Changes in list of available countries: Finland (FIN), Sweden (SWE), Norway (NOR), Denmark (DNK), Belgium (BEL), Estonia (EST), Netherlands (NLD), United Kingdom (GBR), Ireland (IRL), France (FRA), Spain (ESP), Portugal (PRT), Germany (DEU), Italy (ITA), Austria (AUT), Switzerland (CHE), Cyprus (CYP)

- 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) Funkcia: Order
Identification is required!

Ak chcete zadať online objednávku, musíte získať 'search_result_id' z funkcie 'SimpleSearch' a až potom môžete zadať online objednávku (delivery_term = 'o').

- Zmeny v zozname krajín dostupných pre online úverové správy: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- K dispozícii na stiahnutie finančných výkazov (pomocou produktu: financie) v online režime: Estonia (EST), Sweden (SWE)

3) Funkcia: GetReport

- Changes in of available languages: en (English), et (Estonian), ru (Russian), de (German), zh (Chinese), ja (Japanese), bg (Bulgarian), cs (Czech), da (Danish), el (Greek), fi (Finnish), fr (French), hu (Hungarian), it (Italian), lv (Latvian), lt (Lithuanian), nl (Dutch), pl (Polish), pt (Portuguese), ro (Romanian), sk (Slovak), sl (Slovenian), es (Spanish), sv (Swedish)


Zmeny v SOAP (verzia 3) v porovnaní so SOAP (verzia 2) [WSDL and XSD]

File: report.xsd

Nové prvky:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Nová funkcia:

- 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

Nový prvok:

- preferable_finances

NB: This element is required only ordering a product: finances (Financial statements) with delivery_term = 'o'.

3) SimpleSearchRequest

Odstránený prvok:

search_block.reg_code

Nový prvok:

search_block->company_code

NB: in some countries we allow to search companies by vat_code.

4) SimpleSearchResponse

Odstránené prvky

- code

Nové prvky:

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