Dokumentacja API Infoproff - v2

Wersja przełącznika V2

Rozpoczęcie pracy

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

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

Główne funkcje usługi sieciowej:

  • SimpleSearch - Wyszukiwanie informacji o firmach w różnych krajach.
  • Order - Tworzy stronę order_id i zwraca duplikaty. Duplikaty są wybierane na podstawie kolejnych parametrów: country, product, delivery_term and 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)
  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. Wyszukiwanie według kodu rejestracyjnego.
Lista dostępnych krajów: Republika Finlandii (FIN), Królestwo Szwecji (SWE), Królestwo Norwegii (NOR), Królestwo Danii (DNK)
Ważne informacje:
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

Jak zamówić raport kredytowy?

Kolejność czynności od rejestracji do otrzymania raportu składa się z następujących etapów:

  1. Użytkownik rejestruje nowe zamówienie (funkcja "Zamówienie"). System zwraca szczegóły zamówienia, listę duplikatów złożonych w ciągu ostatnich 60 dni i oczekuje na potwierdzenie zamówienia.
  2. Użytkownik potwierdza zamówienie (funkcja "ZamówieniePotwierdzenie"). System wysyła zlecenie do produkcji i zwraca aktualny status produkcji.
  3. Użytkownik sprawdza stan zamówienia (funkcja "ChkStatus").
  4. Jeśli zamówienie jest gotowe, Użytkownik może pobrać raport (funkcja "GetReport").
Lista dostępnych krajów: Republika Finlandii (FIN), Królestwo Szwecji (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)

Poniżej znajduje się przykład:

KROK 1: Zamów raport

Użytkownicy, którzy uważają, że krok potwierdzenia zamówienia nie jest konieczny, mogą użyć elementu "confirm_order" i przekazać wartość "TRUE".

Zazwyczaj przygotowanie raportu kredytowego w trybie online zajmuje 10-20 sekund.
Dlatego w przypadku raportów online należy przeprowadzać kontrole co 5 lub więcej sekund.

Lista firm dostępnych dla konta testowego:

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
Ponadto, w przypadku raportów online (delivery_term = "o"), można skorzystać z próbek wygenerowanych dla każdego kraju (należy użyć: kodu rejestracyjnego "000000"). Raporty te są bezpłatne i można je zamówić za pomocą konta testowego.
Funkcja Order
Funkcja OrderCancellation

KROK 2. Potwierdzenie zamówienia

Funkcja OrderConfirmation

KROK 3. Sprawdzanie stanu

Funkcja ChkStatus

KROK 4. Pobierz raport

Lista dostępnych języków dla raportów online: en (English), et (Estonian), ru (Russian), de (German)
Pobieranie raportu online w formacie pdf nie jest jeszcze możliwe.
Funkcja GetReport

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.

Jak pobrać raport Offline?

Raporty offline można pobierać bezpośrednio. Poniżej znajduje się instrukcja, jak to zrobić:

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

Możliwe błędy

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

Wszystkie funkcje
  • Nieprawidłowa nazwa użytkownika/hasło lub brak uprawnień.
    Wprowadzasz nieprawidłowe dane uwierzytelniające lub dostęp do interfejsu API jest zablokowany.
Funkcja SimpleSearch
  1. Nie masz uprawnień do przeszukiwania w tym kraju.
    Lista dostępnych krajów: Republika Finlandii (FIN), Królestwo Szwecji (SWE)
Funkcja Order
  1. Ten produkt nie jest dostępny.
    Takiego produktu nie można znaleźć i nie można go zamówić.
  2. Nie można zamówić raportu dotyczącego spółki o formie prawnej: "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. Ta firma nie znajduje się na liście testowej.
    Kod rejestracyjny firmy nie znajduje się na naszej liście testowej.
    Lista firm dostępnych dla konta testowego:
    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. Wymagana jest nazwa firmy lub kod rejestracyjny
    W przypadku zamawiania raportu offline (delivery_term = "n", "f" lub "s") wymagana jest "Nazwa firmy" lub "Kod pocztowy".
  5. Kod rejestracyjny jest wymagany, gdy termin dostawy to Online
    W przypadku zamawiania raportu online (delivery_term = "o") wymagany jest "Reg Code".
Funkcja GetReport
  1. Ten język nie jest obsługiwany.
    Lista dostępnych języków dla raportów online: en (English), et (Estonian), ru (Russian), de (German)
Funkcje GetReport ChkStatus
  1. Nieprawidłowy identyfikator zamówienia.
    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. Nie masz już uprawnień do potwierdzenia zamówienia. Potwierdzenie można wykonać w ciągu godziny od otrzymania "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) [Przegląd]

1) Nowa funkcja: ChkFinance

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

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

Aby złożyć zamówienie online, musisz otrzymać "search_result_id" z funkcji "SimpleSearch", a dopiero potem możesz złożyć zamówienie online (delivery_term = "o").

- Zmiany na liście krajów dostępnych dla raportów kredytowych online: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Dostępne do pobrania sprawozdania finansowe (przy użyciu produktu: finanse) w trybie online: Estonia (EST), Sweden (SWE)

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


Zmiany w SOAP (wersja 3) w porównaniu do SOAP (wersja 2) [WSDL and XSD]

File: report.xsd

Nowe elementy:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Nowa funkcja:

- 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

Nowy element:

- preferable_finances

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

3) SimpleSearchRequest

Usunięty element:

search_block.reg_code

Nowy element:

search_block->company_code

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

4) SimpleSearchResponse

Usunięte elementy

- code

Nowe elementy:

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