Dokumentacja API Infoproff - v3

Wersja przełącznika V3

Rozpoczęcie pracy

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

http://wsdfn.infoproff.com/v3/

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), 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 Emiraty Arabskie (ARE), 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), Królestwo Belgii (BEL), Królestwo Niderlandów (NLD), Królestwo Szwecji (SWE), Mongolia (MNG), Republika Estońska (EST), Republika Finlandii (FIN), Republika Kazachstanu (KAZ), Republika Kirgiska (KGZ), Rzeczpospolita Polska (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))

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
  • 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: 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), 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), tr (Turecki), uk (Ukraiński), 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
  • 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: 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), 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), tr (Turecki), uk (Ukraiński), 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
  • 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: 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), 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), tr (Turecki), uk (Ukraiński), 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, bg, cs, da, de, el, fi, fr, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, tr, uk, 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), 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 Emiraty Arabskie (ARE), 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: 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), 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), tr (Turecki), uk (Ukraiński), 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 3) w porównaniu do SOAP (wersja 2)

Zmiany w SOAP (wersja 3) w porównaniu do SOAP (wersja 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: 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), 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 Emiraty Arabskie (ARE), Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej (GBR), Związek Australijski (AUS)

- 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: Chińska Republika Ludowa (CHN), Federacja Rosyjska (RUS), Królestwo Belgii (BEL), Królestwo Niderlandów (NLD), Królestwo Szwecji (SWE), Mongolia (MNG), Republika Estońska (EST), Republika Finlandii (FIN), Republika Kazachstanu (KAZ), Republika Kirgiska (KGZ), Rzeczpospolita Polska (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 (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), 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), tr (Turecki), uk (Ukraiński), zh (Chiński)


Zmiany w SOAP (wersja 3) w porównaniu do SOAP (wersja 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

Nowe elementy:

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

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.

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.

© Dokumentacja API Infoproff 2025