Dokumentace API Infoproff - v2

Verze pro přepínač V2

Začínáme

Webové služby wsdl a schémata jsou umístěny zde:

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

Hlavní funkce webové služby:

  • SimpleSearch - Vyhledávání informací o společnostech v různých zemích.
  • Order - Vytvoří adresu order_id a vrátí duplikáty. Duplikáty se vybírají podle dalších parametrů: country, product, delivery_term and reg_code.
  • OrderCancellation - Pokud jste odeslali požadavek na objednávku a obdrželi jste adresu order_id, máte možnost tuto objednávku zrušit (pokud není zadána do výroby).
  • OrderConfirmation - Po obdržení adresy order_id budete muset objednávku do 1 hodiny potvrdit. Pokud objednávku nepotvrdíte do 1 hodiny, bude automaticky zrušena.
  • ChkStatus - Zkontrolujte stav objednávky.
  • GetReport - Získejte hotové zprávy.
  • GetClassifiersFinancialStatements - Získat všechny finanční doklady se všemi prvky: číslo_řádku, formátovaný_popis_řádku, klíč_jazyka_řádku a pořadí_řádku.
  • GetLegalForms - Získejte všechny právní formuláře pro všechny dostupné země.
  • GetActivityClassificators - Získejte všechny kódy a popisy pro konkrétní klasifikátor činností.
  • GetDictionaryStandardPhrases - Získejte všechny standardní fráze s klíči a jazykem.
  • GetAvailableProducts - Získejte seznam dostupných produktů.
  • CreditOpinionCalculator - Kalkulátor úvěrového posudku pomáhá přiřadit společnosti úvěrový posudek.

API poskytuje několik služeb:

  1. Online úvěrové zprávy pro následující země: Finská republika (FIN), Švédské království (SWE)
  2. Offline zprávy pro následující země: Všechny země
  3. Kalkulátor úvěrových názorů

Jak vyhledat společnost?

Hledání společnosti se skládá ze 2 možností:

  1. Vyhledávání podle názvu společnosti,
  2. Vyhledávání podle registračního kódu.
Seznam dostupných zemí: Finská republika (FIN), Švédské království (SWE), Norské království (NOR), Dánské království (DNK)
Důležité informace:
Norský rejstřík neumožňuje vyhledávat vymazané společnosti podle názvů. Proto nemůžeme poskytnout SimpleSearch podle názvů v rámci vymazaných společností v Norsku.
Field's length:
company_name varchar(512)
company_code varchar(64)

Níže naleznete příklad:

Funkce SimpleSearch

Možnost 2: Vyhledávání podle registračního kódu

Funkce SimpleSearch

Jak si objednat úvěrovou zprávu?

Pořadí od registrace po obdržení zprávy se skládá z těchto kroků:

  1. Uživatel zaregistruje novou objednávku (funkce "Objednávka"). Systém vrátí údaje o objednávce, seznam duplicitních objednávek zadaných v posledních 60 dnech a čeká na potvrzení objednávky.
  2. Uživatel potvrdí objednávku (funkce "OrderConfirmation"). Systém odešle objednávku do výroby a vrátí aktuální stav výroby.
  3. Uživatel zkontroluje stav objednávky (funkce "ChkStatus").
  4. Pokud je objednávka připravena, může si uživatel stáhnout zprávu (funkce "GetReport").
Seznam dostupných zemí: Finská republika (FIN), Švédské království (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)

Níže naleznete příklad:

KROK 1: Objednejte si zprávu

Uživatelé, kteří považují krok potvrzení objednávky za zbytečný, mohou použít prvek "confirm_order" a předat hodnotu "TRUE".

Příprava úvěrové zprávy v online režimu trvá obvykle 10-20 sekund.
U online zpráv byste proto měli provádět kontroly každých 5 nebo více sekund.

Seznam dostupných společností pro testovací účet:

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
Kromě toho můžete pro online výkazy (delivery_term = "o"), použít vzorky vygenerované pro každou zemi (použijte: registrační kód "00000000"). Tyto výkazy jsou zdarma a lze je objednat pomocí testovacího účtu.
Funkce Order
Funkce OrderCancellation

KROK 2. Potvrzení objednávky

Funkce OrderConfirmation

KROK 3. Kontrola stavu

Funkce ChkStatus

KROK 4. Získejte zprávu

Seznam dostupných jazyků pro online zprávy: en (English), et (Estonian), ru (Russian), de (German)
Stažení online zprávy ve formátu pdf zatím není k dispozici.
Funkce GetReport

Pro hlášení se používají následující stavy:

  • Probíhá - Zpráva ve fázi výroby
  • Canceled - Zrušená objednávka
  • Finished - Zpráva je připravena
  • Updated - Do hotové zprávy byly doplněny informace
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - V našem systému došlo k technické chybě. To znamená, že jsme o této chybě informováni a co nejdříve ji opravíme. O tom, kdy budete moci objednávku obdržet, budete informováni.

Pokud je stav provedení Finished nebo Updated, můžete získat příkaz.

Jak stáhnout zprávu Offline?

Zprávy Offline si můžete stáhnout přímo. Zde je návod, jak to udělat:

Žádost se skládá ze 3 částí:

  1. Pevná část https://www.infoproff.com/en/orders/files/
  2. Váš jedinečný hash, který poskytneme jako odpověď.
  3. A pevná část na konci /download

Jak získat úvěrové stanovisko?

Funkce CreditOpinionCalculator

Jak získat další informace?

Funkce GetClassifiersFinancialStatements
Funkce GetActivityClassificators
Funkce GetDictionaryStandardPhrases
Funkce GetAvailableProducts

Možné chyby

Tyto chyby se mohou vyskytnout při zadávání požadavku na naši webovou službu..

Všechny funkce
  • Nesprávné uživatelské jméno/heslo nebo nemáte oprávnění.
    Zadáváte špatné pověření nebo je váš přístup k rozhraní API zablokován.
Funkce SimpleSearch
  1. V této zemi nemáte oprávnění k vyhledávání.
    Seznam dostupných zemí: Finská republika (FIN), Švédské království (SWE)
Funkce Order
  1. Tento produkt není k dispozici.
    Takový produkt nelze nalézt a není možné jej objednat.
  2. Nemůžete si objednat zprávu o společnosti s právní formou: "legal_form"
    Tato chyba se týká pouze: Švédské království (SWE)
    Ve Švédsku není možné objednat online zprávu (delivery_term = "o") s dalšími právními formuláři:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Tato společnost není na seznamu testovaných společností.
    Registrační kód společnosti není v našem testovacím seznamu.
    Seznam dostupných společností pro testovací účet:
    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 se obchodní název nebo IČO
    Při objednávání offline hlášení (delivery_term = "n", "f" nebo "s") je vyžadován "Business Name" nebo "Reg Code".
  5. Reg. kód je vyžadován, pokud je termín dodání Online
    Při objednávání online zprávy (delivery_term = "o") je vyžadován "Reg Code".
Funkce GetReport
  1. Tento jazyk není podporován.
    Seznam dostupných jazyků pro online zprávy: en (English), et (Estonian), ru (Russian), de (German)
Funkce GetReport ChkStatus
  1. Nesprávné order_id.
    ID objednávky nelze nalézt. ID objednávky získáte při použití funkce Order.
Funkce OrderCancellation
  1. Your order is already canceled.
    Ke zrušení objednávky již nemáte oprávnění.
Funkce OrderConfirmation
  1. K potvrzení objednávky již nemáte oprávnění. Potvrzení lze provést do jedné hodiny po obdržení 'order_id'.

Změny v protokolu SOAP (verze 3) ve srovnání s protokolem SOAP (verze 2)

Změny v protokolu SOAP (verze 3) ve srovnání s protokolem SOAP (verze 2) [Přehled]

1) Nová funkce: ChkFinance

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

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

Chcete-li zadat online objednávku, musíte z funkce "SimpleSearch" obdržet 'search_result_id' a teprve poté můžete zadat online (delivery_term = 'o') objednávku.

- Změny v seznamu zemí dostupných pro online úvěrové zprávy: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- K dispozici ke stažení finančních výkazů (pomocí produktu: finance) v režimu online: Estonia (EST), Sweden (SWE)

3) Funkce: 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)


Změny v protokolu SOAP (verze 3) ve srovnání s protokolem SOAP (verze 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á funkce:

- 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ý prvek:

- preferable_finances

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

3) SimpleSearchRequest

Odstraněný prvek:

search_block.reg_code

Nový prvek:

search_block->company_code

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

4) SimpleSearchResponse

Odstraněné prvky

- code

Nové prvky:

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