Dokumentace API Infoproff - v4

Verze pro přepínač V4

Začínáme

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

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 - Vyhledávání informací o společnostech v různých zemích.
  • ChkFinance - Vyhledejte dostupné finanční výkazy.
  • Order - Vytvoří adresu order_id a vrátí duplikáty. Duplikáty se vybírají podle dalších parametrů: country, product, 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), Belgické království (BEL), Nizozemské království (NLD), Estonská republika (EST), Republika Kazachstán (KAZ), Polská republika (POL), Kyrgyzská republika (KGZ), Čínská lidová republika (CHN), Mongolsko (MNG)
  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. Search by company code.
Seznam dostupných zemí: Albánská republika (ALB), Alžírská demokratická lidová republika (DZA), Angolská republika (AGO), Argentinská republika (ARG), Australský svaz (AUS), Bailiwick of Jersey (JEY), Belgické království (BEL), Beninská republika (BEN), Bolívarovská republika Venezuela (VEN), Bosna a Hercegovina (BIH), Botswanská republika (BWA), Brazilská federativní republika (BRA), Bulharská republika (BGR), Běloruská republika (BLR), Chilská republika (CHL), Chorvatská republika (HRV), Dánské království (DNK), Ekvádorská republika (ECU), Estonská republika (EST), Etiopská federativní demokratická republika (ETH), Filipínská republika (PHL), Finská republika (FIN), Francouzská Guyana (GUF), Francouzská republika (FRA), Gambijská republika (GMB), Georgia (GEO), Grónsko (GRL), Guadeloupe (GLP), Guinejská republika (GIN), Guyanská družstevní republika (GUY), Hongkong (HKG), Irsko (IRL), Islandská republika (ISL), Italská republika (ITA), Japonsko (JPN), Jihoafrická republika (ZAF), Kanada (CAN), Keňská republika (KEN), Kolektivita svatého Martina (MAF), Konžská republika (COG), Kosovo (XXK), Kyperská republika (CYP), Kyrgyzská republika (KGZ), Lichtenštejnské knížectví (LIE), Litevská republika (LTU), Lotyšská republika (LVA), Lucemburské velkovévodství (LUX), Madagaskarská republika (MDG), Maledivská republika (MDV), Maltská republika (MLT), Marocké království (MAR), Martinik (MTQ), Mauricijská republika (MUS), Mayotte (MYT), Maďarská republika (HUN), Mnohonárodnostní stát Bolívie (BOL), Moldavská republika (MDA), Monacké knížectví (MCO), Mongolsko (MNG), Namibijská republika (NAM), Nezávislý stát Samoa (WSM), Nigerijská federativní republika (NGA), Nizozemské království (NLD), Norské království (NOR), Nový Zéland (NZL), Ostrov Man (IMN), Paraguayská republika (PRY), Peruánská republika (PER), Pobřeží slonoviny (CIV), Polská republika (POL), Portugalská republika (PRT), Rakouská republika (AUT), Republika Kazachstán (KAZ), Republika San Marino (SMR), Rumunsko (ROU), Ruská federace (RUS), Rwandská republika (RWA), Seychelská republika (SYC), Singapurská republika (SGP), Sjednocená republika Tanzanie (TZA), Slovenská republika (SVK), Slovinská republika (SVN), Spojené království Velké Británie a Severního Irska (GBR), Spolková republika Německo (DEU), Sraz (REU), Srbská republika (SRB), Srílanská demokratická socialistická republika (LKA), Stát Izrael (ISR), Thajské království (THA), Togská republika (TGO), Tádžická republika (TJK), Uruguayská východní republika (URY), Uzbecká republika (UZB), Zambijská republika (ZMB), Zimbabwská republika (ZWE), Ázerbájdžánská republika (AZE), Česká republika (CZE), Čínská lidová republika (CHN), Čínská republika (TWN), Řecká republika (GRC), Španělské království (ESP), Švédské království (SWE), Švýcarská konfederace (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.

Důležité informace:

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.

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

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

Funkce UnifiedSearch

Jak si objednat úvěrovou zprávu?

List of available countries for online credit reports: Belgické království (BEL), Bulharská republika (BGR), Chorvatská republika (HRV), Dánské království (DNK), Estonská republika (EST), Finská republika (FIN), Francouzská republika (FRA), Irsko (IRL), Italská republika (ITA), Kyrgyzská republika (KGZ), Lotyšská republika (LVA), Lucemburské velkovévodství (LUX), Maltská republika (MLT), Maďarská republika (HUN), Moldavská republika (MDA), Mongolsko (MNG), Nizozemské království (NLD), Norské království (NOR), Polská republika (POL), Portugalská republika (PRT), Rakouská republika (AUT), Republika Kazachstán (KAZ), Ruská federace (RUS), Slovenská republika (SVK), Slovinská republika (SVN), Spojené království Velké Británie a Severního Irska (GBR), Spolková republika Německo (DEU), Ázerbájdžánská republika (AZE), Česká republika (CZE), Čínská lidová republika (CHN), Řecká republika (GRC), Španělské království (ESP), Švédské království (SWE), Švýcarská konfederace (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))

Funkce SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Jak vyhledat společnost?

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

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

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

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

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

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

  • Probíhá - Zpráva ve fázi výroby
  • Identification pending - Příprava zprávy je pozastavena. Vyžaduje další údaje od klienta.
  • 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.

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

Funkce GetReport
Seznam dostupných jazyků: ar (Arabic), bg (Bulharský), cs (Česky), da (Dánský), de (Němčina), el (Řecký), en (Angličtina), es (Španělština), et (Estonština), fi (Finsko), fr (Francouzština), he (Hebrew), hu (Maďarština), id (Indonéský), it (Italský), ja (Japonský), ko (Korejský), lt (Litevština), lv (Lotyšský), nb (Norský jazyk Bokmål), nl (Holandský), pl (Polský), pt (Portugalština), ro (Rumunština), ru (Ruský), sk (Slovenská), sl (Slovinština), sr (Српски), sv (Švédský), th (Thai), tr (Turecký), uk (Ukrajinský), vi (Vietnamese), zh (Čínština)

STEP 1: Order a report (Offline Order (without search_result_id))

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

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

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

Funkce ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

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

  • Probíhá - Zpráva ve fázi výroby
  • Identification pending - Příprava zprávy je pozastavena. Vyžaduje další údaje od klienta.
  • 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.

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

Funkce GetReport
Seznam dostupných jazyků: ar (Arabic), bg (Bulharský), cs (Česky), da (Dánský), de (Němčina), el (Řecký), en (Angličtina), es (Španělština), et (Estonština), fi (Finsko), fr (Francouzština), he (Hebrew), hu (Maďarština), id (Indonéský), it (Italský), ja (Japonský), ko (Korejský), lt (Litevština), lv (Lotyšský), nb (Norský jazyk Bokmål), nl (Holandský), pl (Polský), pt (Portugalština), ro (Rumunština), ru (Ruský), sk (Slovenská), sl (Slovinština), sr (Српски), sv (Švédský), th (Thai), tr (Turecký), uk (Ukrajinský), vi (Vietnamese), zh (Čínština)

Jak si objednat archivní úvěrovou zprávu?

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

Funkce 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: Jak vyhledat společnost?

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

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

Jak objednat účetní výkazy online?

STEP 1: Find a company

Funkce SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Jak vyhledat společnost?

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: Vyhledávání dostupných finančních výkazů

Funkce ChkFinance

Tato funkce je nutná pouze při objednávání produktu: finances (Financial statements) s delivery_term = 'o'.

Seznam dostupných zemí: Estonská republika (EST), Švédské království (SWE)

STEP 3: Objednávka finančních výkazů

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

Funkce 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

Funkce 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

Funkce ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

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

  • Probíhá - Zpráva ve fázi výroby
  • Identification pending - Příprava zprávy je pozastavena. Vyžaduje další údaje od klienta.
  • 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.

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

Funkce GetReport
Seznam dostupných jazyků: ar (Arabic), bg (Bulharský), cs (Česky), da (Dánský), de (Němčina), el (Řecký), en (Angličtina), es (Španělština), et (Estonština), fi (Finsko), fr (Francouzština), he (Hebrew), hu (Maďarština), id (Indonéský), it (Italský), ja (Japonský), ko (Korejský), lt (Litevština), lv (Lotyšský), nb (Norský jazyk Bokmål), nl (Holandský), pl (Polský), pt (Portugalština), ro (Rumunština), ru (Ruský), sk (Slovenská), sl (Slovinština), sr (Српски), sv (Švédský), th (Thai), tr (Turecký), uk (Ukrajinský), vi (Vietnamese), zh (Čínština)
To see the examples of xml request/response, please follow the link: How to get finished order?

Jak stáhnout standardní sestavy (v jiných formátech než 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.

Žá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. 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 - Původní (bez výměny), 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

Jak stáhnout nestandardní produkty?

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.

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

  1. Fixed part 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

delivery_term:

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

Možné chyby

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

Všechny funkce
  • Incorrect username/password or you have no permissions.
    Zadáváte špatné pověření nebo je váš přístup k rozhraní API zablokován.
Funkce SimpleSearch
  1. You don't have permissions to search in this country.
    Seznam dostupných zemí: Albánská republika (ALB), Alžírská demokratická lidová republika (DZA), Angolská republika (AGO), Argentinská republika (ARG), Australský svaz (AUS), Bailiwick of Jersey (JEY), Belgické království (BEL), Beninská republika (BEN), Bolívarovská republika Venezuela (VEN), Bosna a Hercegovina (BIH), Botswanská republika (BWA), Brazilská federativní republika (BRA), Bulharská republika (BGR), Běloruská republika (BLR), Chilská republika (CHL), Chorvatská republika (HRV), Dánské království (DNK), Ekvádorská republika (ECU), Estonská republika (EST), Etiopská federativní demokratická republika (ETH), Filipínská republika (PHL), Finská republika (FIN), Francouzská Guyana (GUF), Francouzská republika (FRA), Gambijská republika (GMB), Georgia (GEO), Grónsko (GRL), Guadeloupe (GLP), Guinejská republika (GIN), Guyanská družstevní republika (GUY), Hongkong (HKG), Irsko (IRL), Islandská republika (ISL), Italská republika (ITA), Japonsko (JPN), Jihoafrická republika (ZAF), Kanada (CAN), Keňská republika (KEN), Kolektivita svatého Martina (MAF), Konžská republika (COG), Kosovo (XXK), Kyperská republika (CYP), Kyrgyzská republika (KGZ), Lichtenštejnské knížectví (LIE), Litevská republika (LTU), Lotyšská republika (LVA), Lucemburské velkovévodství (LUX), Madagaskarská republika (MDG), Maledivská republika (MDV), Maltská republika (MLT), Marocké království (MAR), Martinik (MTQ), Mauricijská republika (MUS), Mayotte (MYT), Maďarská republika (HUN), Mnohonárodnostní stát Bolívie (BOL), Moldavská republika (MDA), Monacké knížectví (MCO), Mongolsko (MNG), Namibijská republika (NAM), Nezávislý stát Samoa (WSM), Nigerijská federativní republika (NGA), Nizozemské království (NLD), Norské království (NOR), Nový Zéland (NZL), Ostrov Man (IMN), Paraguayská republika (PRY), Peruánská republika (PER), Pobřeží slonoviny (CIV), Polská republika (POL), Portugalská republika (PRT), Rakouská republika (AUT), Republika Kazachstán (KAZ), Republika San Marino (SMR), Rumunsko (ROU), Ruská federace (RUS), Rwandská republika (RWA), Seychelská republika (SYC), Singapurská republika (SGP), Sjednocená republika Tanzanie (TZA), Slovenská republika (SVK), Slovinská republika (SVN), Spojené království Velké Británie a Severního Irska (GBR), Spolková republika Německo (DEU), Sraz (REU), Srbská republika (SRB), Srílanská demokratická socialistická republika (LKA), Stát Izrael (ISR), Thajské království (THA), Togská republika (TGO), Tádžická republika (TJK), Uruguayská východní republika (URY), Uzbecká republika (UZB), Zambijská republika (ZMB), Zimbabwská republika (ZWE), Ázerbájdžánská republika (AZE), Česká republika (CZE), Čínská lidová republika (CHN), Čínská republika (TWN), Řecká republika (GRC), Španělské království (ESP), Švédské království (SWE), Švýcarská konfederace (CHE)
Funkce Order
  1. This product is not available.
    Takový produkt nelze nalézt a není možné jej objednat.
  2. You can't order report on company with legal form: "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. 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
    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 Code is required when delivery term is Online
    Při objednávání online zprávy (delivery_term = "o") je vyžadován "Reg Code".
Funkce GetReport
  1. This language is not supported.
    Seznam dostupných jazyků pro online zprávy: ar (Arabic), bg (Bulharský), cs (Česky), da (Dánský), de (Němčina), el (Řecký), en (Angličtina), es (Španělština), et (Estonština), fi (Finsko), fr (Francouzština), he (Hebrew), hu (Maďarština), id (Indonéský), it (Italský), ja (Japonský), ko (Korejský), lt (Litevština), lv (Lotyšský), nb (Norský jazyk Bokmål), nl (Holandský), pl (Polský), pt (Portugalština), ro (Rumunština), ru (Ruský), sk (Slovenská), sl (Slovinština), sr (Српски), sv (Švédský), th (Thai), tr (Turecký), uk (Ukrajinský), vi (Vietnamese), zh (Čínština)
Funkce GetReport ChkStatus
  1. Incorrect 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. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Změny v SOAP (verze 4) oproti SOAP (verze 3)

Nové sekce

  • country_economic_overview — zahrnují následující podsekce: data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — informace o zaplacených daních.
  • tenders — informace o veřejných zakázkách.
  • sanctions — přidáno do sekce negative_information.

Aktualizace stávajících sekcí

V oddílech beneficiaries, shareholders, managers a employees_data byl přidán následující prvek:
  • source_type — typ zdroje dat (např. official, mass_media, company_admin atd.).
V sekci „ relations_of_persons “ byl přidán nový prvek:
  • match_type
Sekce capital byla restrukturalizována:
  • Prvek „ capital_amount “ byl přejmenován na „ issued_capital “.
  • Byly přidány následující nové prvky:
    • number_of_shares
    • share_value
    • authorized_capital
V sekci „ employees_data “:
  • Nový prvek „ group_figure “ označuje, zda data obsahují agregované údaje na úrovni skupiny (true).
  • Prvek source_type určuje typ zdroje dat.
  • Prvek „ is_estimated “ je nyní zahrnut pouze v případě, že jeho hodnota je „ true “.
Nová sekce assets_data — konsoliduje dříve existující sekce:
  • real_estate_data (dříve nazývaná property_data), vehicles, machinery_and_equipment (dříve nazývaná assets).
  • Plánované budoucí doplnění: patents a biological_assets.
V sekci vehicles bylo přidáno nové pole:
  • value
V sekci litigations byly přidány následující prvky:
  • content, instance, process, authority
V financial_statement/positions a summary/latest_turnovers byl přidán nový prvek:
  • value_origin — popisuje původ hodnoty; například hodnota estimated – tato hodnota je odhadnuta a vypočítána na základě dostupných údajů pomocí logiky nebo umělé inteligence.
V sekci branches_data byla přidána následující pole:
  • registration_number
  • director_name

Poznámka: Během stabilizační fáze mohou ještě dojít k drobným vylepšením a úpravám.

Webhooks Settings

Přehled

Webový háček je způsob, jak může aplikace poskytovat ostatním aplikacím informace v reálném čase. Naše funkce webhook implementuje zpětná volání HTTP nakonfigurovaná pomocí adresy URL. Na tuto adresu URL je odesláno užitečné zatížení HTTP POST ve formátu JSON, kdykoli dojde k určité události. V kontextu našeho projektu jsme funkci webhook navrhli tak, aby spouštěla konkrétní události.

Nastavení webového háčku

Chcete-li pro svou aplikaci nastavit webový háček, přejděte na stránku nastavení aplikace a vyhledejte část "Nastavení webových háčků". A zadejte následující informace:

  1. "Adresa URL webhooku " je adresa URL, na kterou bude server přijímat požadavky POST webhooku.
  2. "Delivery max attempts " je nastavení, které definuje maximální počet opakovaných pokusů o doručení události webhooku, pokud první pokus o doručení selže.
  3. "Časový limit opakování doručení " je nastavení, které umožňuje určit časový interval mezi opakovanými pokusy o doručení, pokud se pokus o doručení webhooku nezdaří.

Po zadání těchto údajů klikněte na tlačítko "Uložit".

Typy událostí Webhook

  1. Nový stav objednávky

Zatížení webového háčku

Když dojde k události, odešleme na adresu URL užitečného zatížení požadavek HTTP POST s tělem JSON obsahujícím informace o události.

Zde je příklad užitečného zatížení:
Příklad užitečného zatížení nového stavu objednávky
Možné hodnoty pole "new_status":
  • "Finished" - objednávka je dokončena. Objednávku lze vyzvednout;
  • "Updated" - aktualizace objednávky, přidání údajů do dokončené objednávky.;
  • "Canceled" - objednávka je zrušena na žádost (nebo se souhlasem) zákazníka.;
  • "Rejected" - objednávka je zamítnuta. Obvykle proto, že společnost nelze identifikovat..
  • "Identification pending" - před přípravou objednávky potřebujeme od zákazníka více informací..

Zabezpečení webových háčků

Je důležité ověřit, že požadavky POST odeslané na adresu URL užitečného zatížení pocházejí z naší aplikace. K tomu slouží hlavička X-Signature, kterou obsahuje každý požadavek na webhook.

Popis podpisu

Pro podepisování používáme HMAC s algoritmem SHA512.

Secret je součet ID aplikace a Secret Key z nastavení webhooku.

V případě potřeby je možné do koncového bodu přidat vlastní parametry get pro identifikaci odesílatele.

Řešení problémů

Server musí odpovědět do 10 sekund a vrátit kód HTTP 2XX, jinak je doručení webhooku považováno za neúspěšné. V případě neúspěchu se funkce pokusí požadavek znovu odeslat až podle zásad doručování.