Dokumentacja API Infoproff - v4

Wersja przełącznika V4

Rozpoczęcie pracy

Usługa sieciowa wsdl i schematy znajdują się tutaj:

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 - Wyszukiwanie informacji o firmach w różnych krajach.
  • ChkFinance - Wyszukaj dostępne sprawozdania finansowe.
  • Order - Tworzy stronę order_id i zwraca duplikaty. Duplikaty są wybierane na podstawie kolejnych parametrów: country, product, reg_code.
  • OrderCancellation - Jeśli wysłałeś zapytanie o zamówienie i otrzymałeś adres order_id, masz możliwość anulowania tego zamówienia (jeśli nie zostało ono wdrożone do produkcji).
  • OrderConfirmation - Po wejściu na stronę order_id należy potwierdzić zamówienie w ciągu 1 godziny. Jeśli nie potwierdzisz zamówienia w ciągu 1 godziny, zostanie ono automatycznie anulowane.
  • ChkStatus - Sprawdź stan zamówienia.
  • GetReport - Pobierz gotowe raporty.
  • GetClassifiersFinancialStatements - Pobierz wszystkie dokumenty finansowe ze wszystkimi elementami: row_number, row_formated_description, row_lang_key i row_order.
  • GetLegalForms - Pobierz wszystkie formularze prawne dla wszystkich dostępnych krajów.
  • GetActivityClassificators - Pobierz wszystkie kody i opisy dla konkretnego klasyfikatora działalności.
  • GetDictionaryStandardPhrases - Pobierz wszystkie standardowe zwroty z kluczami i językiem.
  • GetAvailableProducts - Wyświetlanie listy dostępnych produktów.
  • CreditOpinionCalculator - Kalkulator Opinii Kredytowej pomaga przypisać opinię kredytową do danej firmy.

Interfejs API udostępnia kilka usług:

  1. Raporty kredytowe online dla następujących krajów: Republika Finlandii (FIN), Królestwo Szwecji (SWE), Królestwo Belgii (BEL), Królestwo Niderlandów (NLD), Republika Estońska (EST), Republika Kazachstanu (KAZ), Rzeczpospolita Polska (POL), Republika Kirgiska (KGZ), Chińska Republika Ludowa (CHN), Mongolia (MNG)
  2. Raporty offline dla następujących krajów: Wszystkie kraje
  3. Kalkulator opinii kredytowej

Jak wyszukać firmę?

Wyszukiwanie firmy składa się z 2 opcji:

  1. Wyszukiwanie według nazwy firmy,
  2. Search by company code.
Lista dostępnych krajów: Algierska Republika Ludowo-Demokratyczna (DZA), Baliwat Jersey (JEY), Boliwariańska Republika Wenezueli (VEN), Bośnia i Hercegowina (BIH), Chińska Republika Ludowa (CHN), Demokratyczno-Socjalistyczna Republika Sri Lanki (LKA), Federacja Rosyjska (RUS), Federacyjna Republika Brazylii (BRA), Federalna Demokratyczna Republika Etiopii (ETH), Federalna Republika Nigerii (NGA), Georgia (GEO), Grenlandia (GRL), Gujana Francuska (GUF), Gwadelupa (GLP), Hongkong (HKG), Irlandia (IRL), Japonia (JPN), Kanada (CAN), Konfederacja Szwajcarska (CHE), Kosowo (XXK), Królestwo Belgii (BEL), Królestwo Danii (DNK), Królestwo Hiszpanii (ESP), Królestwo Marokańskie (MAR), Królestwo Niderlandów (NLD), Królestwo Norwegii (NOR), Królestwo Szwecji (SWE), Królestwo Tajlandii (THA), Księstwo Liechtensteinu (LIE), Księstwo Monako (MCO), Majotta (MYT), Martynika (MTQ), Mongolia (MNG), Niepodległe Państwo Samoa (WSM), Nowa Zelandia (NZL), Państwo Izrael (ISR), Republika Albanii (ALB), Republika Angoli (AGO), Republika Argentyńska (ARG), Republika Austrii (AUT), Republika Azerbejdżanu (AZE), Republika Beninu (BEN), Republika Białorusi (BLR), Republika Botswany (BWA), Republika Bułgarii (BGR), Republika Chile (CHL), Republika Chińska (TWN), Republika Chorwacji (HRV), Republika Cypryjska (CYP), Republika Czeska (CZE), Republika Ekwadoru (ECU), Republika Estońska (EST), Republika Federalna Niemiec (DEU), Republika Filipin (PHL), Republika Finlandii (FIN), Republika Francuska (FRA), Republika Gambii (GMB), Republika Grecka (GRC), Republika Gwinei (GIN), Republika Islandii (ISL), Republika Kazachstanu (KAZ), Republika Kenii (KEN), Republika Kirgiska (KGZ), Republika Konga (COG), Republika Litewska (LTU), Republika Madagaskaru (MDG), Republika Malediwów (MDV), Republika Malty (MLT), Republika Mauritiusu (MUS), Republika Mołdawii (MDA), Republika Namibii (NAM), Republika Paragwaju (PRY), Republika Peru (PER), Republika Portugalska (PRT), Republika Południowej Afryki (ZAF), Republika Rwandy (RWA), Republika San Marino (SMR), Republika Serbska (SRB), Republika Seszeli (SYC), Republika Singapuru (SGP), Republika Słowacka (SVK), Republika Słowenii (SVN), Republika Tadżykistanu (TJK), Republika Togijska (TGO), Republika Uzbekistanu (UZB), Republika Węgierska (HUN), Republika Włoska (ITA), Republika Zambii (ZMB), Republika Zimbabwe (ZWE), Republika Łotewska (LVA), Rumunia (ROU), Rzeczpospolita Polska (POL), Spółdzielcza Republika Gujany (GUY), Wielkie Księstwo Luksemburga (LUX), Wielonarodowe Państwo Boliwii (BOL), Wschodnia Republika Urugwaju (URY), Wybrzeże Kości Słoniowej (CIV), Wyspa Man (IMN), Zbiorowość Saint Martin (MAF), Zjazd (REU), Zjednoczona Republika Tanzanii (TZA), Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej (GBR), Związek Australijski (AUS)

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.

Ważne informacje:

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.

W rejestrze norweskim nie ma możliwości wyszukiwania wykreślonych firm według nazw. W związku z tym nie możemy udostępnić witryny SimpleSearch według nazwisk w obrębie usuniętych firm w Norwegii.

Field's length:
company_name varchar(512)
company_code varchar(64)

Poniżej znajduje się przykład:

Funkcja SimpleSearch

Opcja 2: Wyszukiwanie według kodu rejestracyjnego

Funkcja SimpleSearch

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

Funkcja UnifiedSearch

Jak zamówić raport kredytowy?

List of available countries for online credit reports: Chińska Republika Ludowa (CHN), Federacja Rosyjska (RUS), Irlandia (IRL), Konfederacja Szwajcarska (CHE), Królestwo Belgii (BEL), Królestwo Danii (DNK), Królestwo Hiszpanii (ESP), Królestwo Niderlandów (NLD), Królestwo Norwegii (NOR), Królestwo Szwecji (SWE), Mongolia (MNG), Republika Austrii (AUT), Republika Azerbejdżanu (AZE), Republika Bułgarii (BGR), Republika Chorwacji (HRV), Republika Czeska (CZE), Republika Estońska (EST), Republika Federalna Niemiec (DEU), Republika Finlandii (FIN), Republika Francuska (FRA), Republika Grecka (GRC), Republika Kazachstanu (KAZ), Republika Kirgiska (KGZ), Republika Malty (MLT), Republika Mołdawii (MDA), Republika Portugalska (PRT), Republika Słowacka (SVK), Republika Słowenii (SVN), Republika Węgierska (HUN), Republika Włoska (ITA), Republika Łotewska (LVA), Rzeczpospolita Polska (POL), Wielkie Księstwo Luksemburga (LUX), Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej (GBR)
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))

Funkcja SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Jak wyszukać firmę?

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

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

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

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

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

W raportach używane są następujące statusy:

  • W trakcie realizacji - Raport na etapie produkcji
  • Identification pending - Przygotowanie raportu zostało wstrzymane. Wymaga dodatkowych danych od klienta.
  • Canceled - Zamówienie anulowane
  • Finished - Raport jest gotowy
  • Updated - Informacje zostały dodane do raportu końcowego
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - W naszym systemie wystąpił błąd techniczny. Oznacza to, że zostaliśmy poinformowani o tym błędzie i niezwłocznie go naprawimy. Zostaniesz poinformowany, kiedy będziesz mógł otrzymać zamówienie.

Jeśli status wykonania to Finished lub Updated, można uzyskać zlecenie.

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

Funkcja GetReport
Lista dostępnych języków: ar (Arabic), bg (Bułgarski), cs (Czechy), da (Duński), de (Niemiecki), el (Grecki), en (Język angielski), es (Hiszpański), et (Estoński), fi (Fiński), fr (Francuski), he (Hebrew), hu (Węgierski), id (Indonezyjski), it (Włoski), ja (Japoński), ko (Koreański), lt (Litewski), lv (Łotewski), nb (Norweski Bokmål), nl (Holenderski), pl (Polski), pt (Portugalski), ro (Rumuński), ru (Rosyjska), sk (Słowacki), sl (Słoweński), sr (Српски), sv (Szwedzki), th (Thai), tr (Turecki), uk (Ukraiński), vi (Vietnamese), zh (Chiński)

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

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

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

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

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

W raportach używane są następujące statusy:

  • W trakcie realizacji - Raport na etapie produkcji
  • Identification pending - Przygotowanie raportu zostało wstrzymane. Wymaga dodatkowych danych od klienta.
  • Canceled - Zamówienie anulowane
  • Finished - Raport jest gotowy
  • Updated - Informacje zostały dodane do raportu końcowego
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - W naszym systemie wystąpił błąd techniczny. Oznacza to, że zostaliśmy poinformowani o tym błędzie i niezwłocznie go naprawimy. Zostaniesz poinformowany, kiedy będziesz mógł otrzymać zamówienie.

Jeśli status wykonania to Finished lub Updated, można uzyskać zlecenie.

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

Funkcja GetReport
Lista dostępnych języków: ar (Arabic), bg (Bułgarski), cs (Czechy), da (Duński), de (Niemiecki), el (Grecki), en (Język angielski), es (Hiszpański), et (Estoński), fi (Fiński), fr (Francuski), he (Hebrew), hu (Węgierski), id (Indonezyjski), it (Włoski), ja (Japoński), ko (Koreański), lt (Litewski), lv (Łotewski), nb (Norweski Bokmål), nl (Holenderski), pl (Polski), pt (Portugalski), ro (Rumuński), ru (Rosyjska), sk (Słowacki), sl (Słoweński), sr (Српски), sv (Szwedzki), th (Thai), tr (Turecki), uk (Ukraiński), vi (Vietnamese), zh (Chiński)

Jak zamówić zarchiwizowany raport kredytowy?

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

Funkcja 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 wyszukać firmę?

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

Funkcja 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 zamawiać sprawozdania finansowe online?

STEP 1: Find a company

Funkcja SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Jak wyszukać firmę?

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: Wyszukiwanie dostępnych sprawozdań finansowych

Funkcja ChkFinance

Ta funkcja jest potrzebna tylko przy zamawianiu produktu: finances (Financial statements) z delivery_term = 'o'.

Lista dostępnych krajów: Republika Estońska (EST), Królestwo Szwecji (SWE)

STEP 3: Zamówienie sprawozdań finansowych

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

Funkcja 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

Funkcja 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

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

W raportach używane są następujące statusy:

  • W trakcie realizacji - Raport na etapie produkcji
  • Identification pending - Przygotowanie raportu zostało wstrzymane. Wymaga dodatkowych danych od klienta.
  • Canceled - Zamówienie anulowane
  • Finished - Raport jest gotowy
  • Updated - Informacje zostały dodane do raportu końcowego
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - W naszym systemie wystąpił błąd techniczny. Oznacza to, że zostaliśmy poinformowani o tym błędzie i niezwłocznie go naprawimy. Zostaniesz poinformowany, kiedy będziesz mógł otrzymać zamówienie.

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

Funkcja GetReport
Lista dostępnych języków: ar (Arabic), bg (Bułgarski), cs (Czechy), da (Duński), de (Niemiecki), el (Grecki), en (Język angielski), es (Hiszpański), et (Estoński), fi (Fiński), fr (Francuski), he (Hebrew), hu (Węgierski), id (Indonezyjski), it (Włoski), ja (Japoński), ko (Koreański), lt (Litewski), lv (Łotewski), nb (Norweski Bokmål), nl (Holenderski), pl (Polski), pt (Portugalski), ro (Rumuński), ru (Rosyjska), sk (Słowacki), sl (Słoweński), sr (Српски), sv (Szwedzki), th (Thai), tr (Turecki), uk (Ukraiński), vi (Vietnamese), zh (Chiński)
To see the examples of xml request/response, please follow the link: How to get finished order?

Jak pobrać raporty standardowe (w formatach innych niż 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.

Wniosek składa się z 3 części:

  1. Część stała https://www.infoproff.com/en/orders/files/
  2. Twój unikalny hash, który podajemy w odpowiedzi
  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 - Oryginał (bez wymiany), 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 pobrać produkty niestandardowe?

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.

Wniosek składa się z 3 części:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Twój unikalny hash, który podajemy w odpowiedzi
  3. I część stała na końcu /download

Jak uzyskać opinię kredytową?

Funkcja CreditOpinionCalculator

Jak uzyskać dodatkowe informacje?

Funkcja GetClassifiersFinancialStatements
Funkcja GetActivityClassificators
Funkcja GetDictionaryStandardPhrases
Funkcja GetAvailableProducts

delivery_term:

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

Możliwe błędy

Te błędy mogą wystąpić podczas wysyłania zapytania do naszego serwisu internetowego.

Wszystkie funkcje
  • Incorrect username/password or you have no permissions.
    Wprowadzasz nieprawidłowe dane uwierzytelniające lub dostęp do interfejsu API jest zablokowany.
Funkcja SimpleSearch
  1. You don't have permissions to search in this country.
    Lista dostępnych krajów: Algierska Republika Ludowo-Demokratyczna (DZA), Baliwat Jersey (JEY), Boliwariańska Republika Wenezueli (VEN), Bośnia i Hercegowina (BIH), Chińska Republika Ludowa (CHN), Demokratyczno-Socjalistyczna Republika Sri Lanki (LKA), Federacja Rosyjska (RUS), Federacyjna Republika Brazylii (BRA), Federalna Demokratyczna Republika Etiopii (ETH), Federalna Republika Nigerii (NGA), Georgia (GEO), Grenlandia (GRL), Gujana Francuska (GUF), Gwadelupa (GLP), Hongkong (HKG), Irlandia (IRL), Japonia (JPN), Kanada (CAN), Konfederacja Szwajcarska (CHE), Kosowo (XXK), Królestwo Belgii (BEL), Królestwo Danii (DNK), Królestwo Hiszpanii (ESP), Królestwo Marokańskie (MAR), Królestwo Niderlandów (NLD), Królestwo Norwegii (NOR), Królestwo Szwecji (SWE), Królestwo Tajlandii (THA), Księstwo Liechtensteinu (LIE), Księstwo Monako (MCO), Majotta (MYT), Martynika (MTQ), Mongolia (MNG), Niepodległe Państwo Samoa (WSM), Nowa Zelandia (NZL), Państwo Izrael (ISR), Republika Albanii (ALB), Republika Angoli (AGO), Republika Argentyńska (ARG), Republika Austrii (AUT), Republika Azerbejdżanu (AZE), Republika Beninu (BEN), Republika Białorusi (BLR), Republika Botswany (BWA), Republika Bułgarii (BGR), Republika Chile (CHL), Republika Chińska (TWN), Republika Chorwacji (HRV), Republika Cypryjska (CYP), Republika Czeska (CZE), Republika Ekwadoru (ECU), Republika Estońska (EST), Republika Federalna Niemiec (DEU), Republika Filipin (PHL), Republika Finlandii (FIN), Republika Francuska (FRA), Republika Gambii (GMB), Republika Grecka (GRC), Republika Gwinei (GIN), Republika Islandii (ISL), Republika Kazachstanu (KAZ), Republika Kenii (KEN), Republika Kirgiska (KGZ), Republika Konga (COG), Republika Litewska (LTU), Republika Madagaskaru (MDG), Republika Malediwów (MDV), Republika Malty (MLT), Republika Mauritiusu (MUS), Republika Mołdawii (MDA), Republika Namibii (NAM), Republika Paragwaju (PRY), Republika Peru (PER), Republika Portugalska (PRT), Republika Południowej Afryki (ZAF), Republika Rwandy (RWA), Republika San Marino (SMR), Republika Serbska (SRB), Republika Seszeli (SYC), Republika Singapuru (SGP), Republika Słowacka (SVK), Republika Słowenii (SVN), Republika Tadżykistanu (TJK), Republika Togijska (TGO), Republika Uzbekistanu (UZB), Republika Węgierska (HUN), Republika Włoska (ITA), Republika Zambii (ZMB), Republika Zimbabwe (ZWE), Republika Łotewska (LVA), Rumunia (ROU), Rzeczpospolita Polska (POL), Spółdzielcza Republika Gujany (GUY), Wielkie Księstwo Luksemburga (LUX), Wielonarodowe Państwo Boliwii (BOL), Wschodnia Republika Urugwaju (URY), Wybrzeże Kości Słoniowej (CIV), Wyspa Man (IMN), Zbiorowość Saint Martin (MAF), Zjazd (REU), Zjednoczona Republika Tanzanii (TZA), Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej (GBR), Związek Australijski (AUS)
Funkcja Order
  1. This product is not available.
    Takiego produktu nie można znaleźć i nie można go zamówić.
  2. You can't order report on company with legal form: "legal_form"
    Ten błąd dotyczy tylko: Królestwo Szwecji (SWE)
    W Szwecji nie jest możliwe zamówienie raportu online (delivery_term = "o") z następnymi formularzami prawnymi:
    • 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
    W przypadku zamawiania raportu offline (delivery_term = "n", "f" lub "s") wymagana jest "Nazwa firmy" lub "Kod pocztowy".
  5. Reg Code is required when delivery term is Online
    W przypadku zamawiania raportu online (delivery_term = "o") wymagany jest "Reg Code".
Funkcja GetReport
  1. This language is not supported.
    Lista dostępnych języków dla raportów online: ar (Arabic), bg (Bułgarski), cs (Czechy), da (Duński), de (Niemiecki), el (Grecki), en (Język angielski), es (Hiszpański), et (Estoński), fi (Fiński), fr (Francuski), he (Hebrew), hu (Węgierski), id (Indonezyjski), it (Włoski), ja (Japoński), ko (Koreański), lt (Litewski), lv (Łotewski), nb (Norweski Bokmål), nl (Holenderski), pl (Polski), pt (Portugalski), ro (Rumuński), ru (Rosyjska), sk (Słowacki), sl (Słoweński), sr (Српски), sv (Szwedzki), th (Thai), tr (Turecki), uk (Ukraiński), vi (Vietnamese), zh (Chiński)
Funkcje GetReport ChkStatus
  1. Incorrect order_id.
    Nie można znaleźć identyfikatora zamówienia. Identyfikator zamówienia można uzyskać po użyciu funkcji Order.
Funkcja OrderCancellation
  1. Your order is already canceled.
    Nie masz już uprawnień do anulowania zamówienia.
Funkcja OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Zmiany w SOAP (wersja 4) w porównaniu z SOAP (wersja 3)

Nowe sekcje

  • country_economic_overview — zawiera następujące podsekcje: data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — informacje o zapłaconych podatkach.
  • tenders — informacje o przetargach.
  • sanctions — dodane do sekcji „ negative_information ”.

Aktualizacje istniejących sekcji

W sekcjach beneficiaries, shareholders, managers oraz employees_data dodano następujący element:
  • source_type — rodzaj źródła danych (np. official, mass_media, company_admin itp.).
W sekcji relations_of_persons dodano nowy element:
  • match_type
Sekcja capital została zrestrukturyzowana:
  • Element „ capital_amount ” został przemianowany na „ issued_capital ”.
  • Dodano następujące nowe elementy:
    • number_of_shares
    • share_value
    • authorized_capital
W sekcji „ employees_data ”:
  • Nowy element „ group_figure ” wskazuje, czy dane zawierają zagregowane dane na poziomie grupy (true).
  • Element „ source_type ” określa typ źródła danych.
  • Element „ is_estimated ” jest teraz uwzględniany tylko wtedy, gdy jego wartość wynosi „ true ”.
Nowa sekcja „ assets_data ” — konsoliduje poprzednio istniejące sekcje:
  • real_estate_data (wcześniej nazywana „ property_data ”), „ vehicles ” oraz „ machinery_and_equipment ” (wcześniej nazywana „ assets ”).
  • Planowane przyszłe dodatki: „ patents ” i „ biological_assets ”.
W sekcji vehicles dodano nowe pole:
  • value
W sekcji „ litigations ” dodano następujące elementy:
  • content, instance, process, authority
W sekcjach „ financial_statement/positions ” i „ summary/latest_turnovers ” dodano nowy element:
  • value_origin — opisuje pochodzenie wartości; na przykład wartość estimated — wartość ta jest szacowana i obliczana na podstawie dostępnych danych przy użyciu logiki lub sztucznej inteligencji.
W sekcji branches_data dodano następujące pola:
  • registration_number
  • director_name

Uwaga: W fazie stabilizacji mogą nadal występować drobne ulepszenia i poprawki.

Webhooks Settings

Przegląd

Webhook to sposób, w jaki aplikacja może dostarczać innym aplikacjom informacje w czasie rzeczywistym. Nasza funkcja webhook implementuje wywołania zwrotne HTTP skonfigurowane z adresem URL. Ładunek HTTP POST jest wysyłany na ten adres URL w formacie JSON za każdym razem, gdy wystąpi określone zdarzenie. W kontekście naszego projektu zaprojektowaliśmy funkcję webhook do wyzwalania określonych zdarzeń.

Konfigurowanie elementu Webhook

Aby skonfigurować webhook dla swojej aplikacji, przejdź do strony ustawień aplikacji i poszukaj sekcji "Ustawienia webhooków". Następnie należy podać następujące informacje:

  1. "Webhook URL" to adres URL, pod którym serwer będzie odbierał żądania webhook POST.
  2. "Delivery max attempts" to ustawienie, które definiuje maksymalną liczbę ponownych prób dostarczenia zdarzenia webhook, gdy początkowa próba dostarczenia nie powiedzie się.
  3. "Limit czasu ponownej próby dostarczenia" to ustawienie, które pozwala określić odstęp czasu między ponownymi próbami, gdy próba dostarczenia webhooka nie powiedzie się.

Po podaniu tych danych kliknij "Zapisz".

Typy zdarzeń Webhook

  1. Nowy status zamówienia

Webhook Payload

Gdy wystąpi zdarzenie, wyślemy żądanie HTTP POST do adresu URL ładunku z treścią JSON zawierającą informacje o zdarzeniu.

Oto przykładowy ładunek:
Przykład ładunku nowego statusu zamówienia
Możliwe wartości pola "new_status":
  • "Finished" - zamówienie jest kompletne. Zamówienie można odebrać;
  • "Updated" - aktualizacja zamówienia, dane dodane do zrealizowanego zamówienia;
  • "Canceled" - zamówienie zostało anulowane na prośbę (lub za zgodą) klienta;
  • "Rejected" - zamówienie zostaje odrzucone. Zwykle dlatego, że nie można zidentyfikować firmy.
  • "Identification pending" - przed przygotowaniem zamówienia potrzebujemy więcej informacji od klienta..

Zabezpieczanie webhooków

Ważne jest, aby zweryfikować, czy żądania POST wysyłane do adresu URL ładunku pochodzą z naszej aplikacji. Aby to ułatwić, każde żądanie webhook zawiera nagłówek X-Signature.

Opis podpisu

Do podpisywania używamy HMAC z algorytmem SHA512.

Secret to konkatenacja App ID i Secret Key z ustawień webhooks.

W razie potrzeby możliwe jest dodanie własnych parametrów get do punktu końcowego w celu identyfikacji nadawcy.

Rozwiązywanie problemów

Serwer musi odpowiedzieć w ciągu 10 sekund i zwrócić kod HTTP 2XX; w przeciwnym razie dostarczenie webhooka zostanie uznane za nieudane. W przypadku niepowodzenia funkcja podejmie próbę ponownego wysłania żądania zgodnie z zasadami dostarczania.