Documentația API Infoproff - v3


Noțiuni introductive


Serviciul web wsdl și schemele sunt localizate aici:

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

Web service functions:

  • SimpleSearch - Căutați informații despre companii din diferite țări.
  • ChkFinance - Căutați situațiile financiare disponibile.
  • Order - Creează un order_id și returnează duplicatele. Dublurile sunt selectate după următorii parametri: country, product, reg_code.
  • OrderCancellation - Dacă ați trimis o cerere de comandă și ați primit order_id, aveți posibilitatea de a anula această comandă (dacă nu a intrat în producție).
  • OrderConfirmation - După ce ați primit order_id, va trebui să confirmați comanda în termen de 1 oră. Dacă nu confirmați comanda în termen de 1 oră, aceasta va fi anulată automat.
  • ChkStatus - Verificați starea comenzii.
  • GetReport - Obțineți rapoarte finalizate.

  • GetClassifiersFinancialStatements - Obține toate documentele financiare cu toate elementele: row_number, row_formated_description, row_lang_key și row_order.
  • GetLegalForms - Obțineți toate formularele juridice pentru toate țările disponibile.
  • GetActivityClassificators - Obțineți toate codurile și descrierile pentru un anumit clasificator de activități.
  • GetDictionaryStandardPhrases - Obțineți toate frazele standard cu chei și limbă.
  • GetAvailableProducts - Obțineți o listă de produse disponibile.

  • CreditOpinionCalculator - Calculatorul de opinie de credit ajută la atribuirea opiniei de credit pentru o companie.

API oferă mai multe servicii:

  1. Rapoarte de credit online pentru următoarele țări: Republica Finlanda (FIN), Regatul Suediei (SWE), Regatul Belgiei (BEL), Regatul Țărilor de Jos (NLD), Republica Estonia (EST)
  2. Rapoarte offline pentru următoarele țări: Toate țările
  3. Calculator de opinie de credit

Cum să căutați o companie?


Căutarea companiei constă în 2 opțiuni:

  1. Căutare după numele companiei,
  2. Search by company code.
Lista țărilor disponibile: Confederația Elvețiană (CHE), Georgia (GEO), Groenlanda (GRL), Irlanda (IRL), Mongolia (MNG), Regatul Belgiei (BEL), Regatul Danemarcei (DNK), Regatul Norvegiei (NOR), Regatul Spaniei (ESP), Regatul Suediei (SWE), Regatul Unit al Marii Britanii și Irlandei de Nord (GBR), Regatul Țărilor de Jos (NLD), Republica Austria (AUT), Republica Azerbaidjan (AZE), Republica Belarus (BLR), Republica Cipru (CYP), Republica Estonia (EST), Republica Federală Germania (DEU), Republica Finlanda (FIN), Republica Franceză (FRA), Republica Italiană (ITA), Republica Kazahstan (KAZ), Republica Kârgâzstan (KGZ), Republica Moldova (MDA), Republica Polonă (POL), Republica Populară Chineză (CHN), Republica Portugheză (PRT), Republica Uzbekistan (UZB)
Informații importante:

search_result_id can be acquired here for orders with delivery_term = "o".

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.

Registrul norvegian nu permite căutarea după nume a societăților șterse. Prin urmare, nu putem oferi SimpleSearch după nume în cadrul societăților șterse din Norvegia.

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

Mai jos puteți găsi un exemplu:


Funcția SimpleSearch

Opțiunea 2: Căutați după codul de înregistrare

Funcția SimpleSearch

Cum să comandați un raport de credit?


List of available countries for online credit reports: Regatul Belgiei (BEL), Regatul Suediei (SWE), Regatul Țărilor de Jos (NLD), Republica Estonia (EST), Republica Finlanda (FIN), Republica Kazahstan (KAZ), Republica Kârgâzstan (KGZ), Republica Polonă (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))

Funcția SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Cum să căutați o companie?

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

Funcția 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))

Funcția 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))

Funcția 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))

Funcția 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.

Următoarele stări sunt utilizate pentru rapoarte:

  • În curs de desfășurare - Raport în faza de producție
  • Canceled - Comandă anulată
  • Finished - Raportul este gata
  • Updated - Au fost adăugate informații la raportul final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - A apărut o eroare tehnică în sistemul nostru. Aceasta înseamnă că suntem informați despre această eroare și o vom remedia cât mai curând posibil. Veți fi informat când veți putea primi comanda.

În cazul în care starea de execuție este Finished sau Updated, atunci puteți obține un ordin.

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

Funcția GetReport
Lista de limbi disponibile: bg (Bulgară), cs (Cehia), da (Daneză), de (Germană), el (Greacă), en (Engleză), es (Spaniolă), et (Estoniană), fi (Finlandeză), fr (Franceză), hu (Maghiară), id (Indoneziană), it (Italian), ja (Japoneză), ko (Coreeană), lt (Lituaniene), lv (Letonă), nb (Norvegiană Bokmål), nl (Olandeză), pl (Poloneză), pt (Portugheză), ro (Românesc), ru (Rusă), sk (Slovacă), sl (Slovenă), sv (Suedeză), tr (Turcă), uk (Ucraineană), zh (Chineză)

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

Funcția 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))

Funcția 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))

Funcția 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))

Funcția ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

Următoarele stări sunt utilizate pentru rapoarte:

  • În curs de desfășurare - Raport în faza de producție
  • Canceled - Comandă anulată
  • Finished - Raportul este gata
  • Updated - Au fost adăugate informații la raportul final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - A apărut o eroare tehnică în sistemul nostru. Aceasta înseamnă că suntem informați despre această eroare și o vom remedia cât mai curând posibil. Veți fi informat când veți putea primi comanda.

În cazul în care starea de execuție este Finished sau Updated, atunci puteți obține un ordin.

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

Funcția GetReport
Lista de limbi disponibile: bg (Bulgară), cs (Cehia), da (Daneză), de (Germană), el (Greacă), en (Engleză), es (Spaniolă), et (Estoniană), fi (Finlandeză), fr (Franceză), hu (Maghiară), id (Indoneziană), it (Italian), ja (Japoneză), ko (Coreeană), lt (Lituaniene), lv (Letonă), nb (Norvegiană Bokmål), nl (Olandeză), pl (Poloneză), pt (Portugheză), ro (Românesc), ru (Rusă), sk (Slovacă), sl (Slovenă), sv (Suedeză), tr (Turcă), uk (Ucraineană), zh (Chineză)

Cum să comandați situații financiare online?


STEP 1: Find a company

Funcția SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Cum să căutați o companie?

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: Căutați situațiile financiare disponibile

Funcția ChkFinance

Această funcție este necesară numai atunci când se comandă un produs: finances (Financial statements) cu delivery_term = 'o'.

Lista țărilor disponibile: Republica Estonia (EST), Regatul Suediei (SWE)

STEP 3: Comandați situațiile financiare

Funcția 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)

Funcția 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

Funcția 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

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

Următoarele stări sunt utilizate pentru rapoarte:

  • În curs de desfășurare - Raport în faza de producție
  • Canceled - Comandă anulată
  • Finished - Raportul este gata
  • Updated - Au fost adăugate informații la raportul final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - A apărut o eroare tehnică în sistemul nostru. Aceasta înseamnă că suntem informați despre această eroare și o vom remedia cât mai curând posibil. Veți fi informat când veți putea primi comanda.

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

Funcția GetReport
Lista de limbi disponibile: bg (Bulgară), cs (Cehia), da (Daneză), de (Germană), el (Greacă), en (Engleză), es (Spaniolă), et (Estoniană), fi (Finlandeză), fr (Franceză), hu (Maghiară), id (Indoneziană), it (Italian), ja (Japoneză), ko (Coreeană), lt (Lituaniene), lv (Letonă), nb (Norvegiană Bokmål), nl (Olandeză), pl (Poloneză), pt (Portugheză), ro (Românesc), ru (Rusă), sk (Slovacă), sl (Slovenă), sv (Suedeză), tr (Turcă), uk (Ucraineană), zh (Chineză)
To see the examples of xml request/response, please follow the link: How to get finished order?

Cum se pot descărca rapoarte standard (în alte formate decât 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.

Cererea este formată din 3 părți:

  1. Partea fixă https://www.infoproff.com/en/orders/files/
  2. Hash-ul dvs. unic, pe care îl furnizăm ca răspuns
  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, sv, tr, uk, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - Original (fără schimb), 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

Cum să descărcați produse non-standard?


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.

Cererea este formată din 3 părți:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Hash-ul dvs. unic, pe care îl furnizăm ca răspuns
  3. Și partea fixă de la sfârșit /download

Cum să obțineți avizul de credit?


Funcția CreditOpinionCalculator

Cum se pot obține informații suplimentare?


Funcția GetClassifiersFinancialStatements
Funcția GetActivityClassificators
Funcția GetDictionaryStandardPhrases
Funcția GetAvailableProducts

delivery_term:

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

Erori posibile


Aceste erori pot apărea în timp ce faceți o cerere către serviciul nostru web.


Toate funcțiile
  • Incorrect username/password or you have no permissions.
    Ați introdus acreditări greșite sau accesul la API este blocat.

Funcția SimpleSearch
  1. You don't have permissions to search in this country.
    Lista țărilor disponibile: Confederația Elvețiană (CHE), Georgia (GEO), Groenlanda (GRL), Irlanda (IRL), Mongolia (MNG), Regatul Belgiei (BEL), Regatul Danemarcei (DNK), Regatul Norvegiei (NOR), Regatul Spaniei (ESP), Regatul Suediei (SWE), Regatul Unit al Marii Britanii și Irlandei de Nord (GBR), Regatul Țărilor de Jos (NLD), Republica Austria (AUT), Republica Azerbaidjan (AZE), Republica Belarus (BLR), Republica Cipru (CYP), Republica Estonia (EST), Republica Federală Germania (DEU), Republica Finlanda (FIN), Republica Franceză (FRA), Republica Italiană (ITA), Republica Kazahstan (KAZ), Republica Kârgâzstan (KGZ), Republica Moldova (MDA), Republica Polonă (POL), Republica Populară Chineză (CHN), Republica Portugheză (PRT), Republica Uzbekistan (UZB)
Funcția Order
  1. This product is not available.
    Un astfel de produs nu poate fi găsit și nu este posibil să fie comandat.
  2. You can't order report on company with legal form: "legal_form"
    Această eroare se aplică numai la: Regatul Suediei (SWE)
    În Suedia nu este posibil să se comande raportul online (delivery_term = "o") cu următoarele formulare legale:
    • 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
    Atunci când se comandă un raport offline (delivery_term = "n", "f" sau "s"), este necesar "Business Name" sau "Reg Code".
  5. Reg Code is required when delivery term is Online
    În cazul în care comandați raportul online (delivery_term = "o"), este necesar "Reg Code".

Funcția GetReport
  1. This language is not supported.
    Lista limbilor disponibile pentru rapoartele online: bg (Bulgară), cs (Cehia), da (Daneză), de (Germană), el (Greacă), en (Engleză), es (Spaniolă), et (Estoniană), fi (Finlandeză), fr (Franceză), hu (Maghiară), id (Indoneziană), it (Italian), ja (Japoneză), ko (Coreeană), lt (Lituaniene), lv (Letonă), nb (Norvegiană Bokmål), nl (Olandeză), pl (Poloneză), pt (Portugheză), ro (Românesc), ru (Rusă), sk (Slovacă), sl (Slovenă), sv (Suedeză), tr (Turcă), uk (Ucraineană), zh (Chineză)

Funcții GetReport ChkStatus
  1. Incorrect order_id.
    ID-ul comenzii nu poate fi găsit. Veți obține ID-ul comenzii atunci când utilizați funcția Order.

Funcția OrderCancellation
  1. Your order is already canceled.
    Nu mai aveți permisiunea de a anula comanda.

Funcția OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Modificări SOAP (versiunea 3) în comparație cu SOAP (versiunea 2)


Modificări SOAP (versiunea 3) în comparație cu SOAP (versiunea 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: Confederația Elvețiană (CHE), Georgia (GEO), Groenlanda (GRL), Irlanda (IRL), Mongolia (MNG), Regatul Belgiei (BEL), Regatul Danemarcei (DNK), Regatul Norvegiei (NOR), Regatul Spaniei (ESP), Regatul Suediei (SWE), Regatul Unit al Marii Britanii și Irlandei de Nord (GBR), Regatul Țărilor de Jos (NLD), Republica Austria (AUT), Republica Azerbaidjan (AZE), Republica Belarus (BLR), Republica Cipru (CYP), Republica Estonia (EST), Republica Federală Germania (DEU), Republica Finlanda (FIN), Republica Franceză (FRA), Republica Italiană (ITA), Republica Kazahstan (KAZ), Republica Kârgâzstan (KGZ), Republica Moldova (MDA), Republica Polonă (POL), Republica Populară Chineză (CHN), Republica Portugheză (PRT), Republica Uzbekistan (UZB)

- 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: Regatul Belgiei (BEL), Regatul Suediei (SWE), Regatul Țărilor de Jos (NLD), Republica Estonia (EST), Republica Finlanda (FIN), Republica Kazahstan (KAZ), Republica Kârgâzstan (KGZ), Republica Polonă (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 (Bulgară), cs (Cehia), da (Daneză), de (Germană), el (Greacă), en (Engleză), es (Spaniolă), et (Estoniană), fi (Finlandeză), fr (Franceză), hu (Maghiară), id (Indoneziană), it (Italian), ja (Japoneză), ko (Coreeană), lt (Lituaniene), lv (Letonă), nb (Norvegiană Bokmål), nl (Olandeză), pl (Poloneză), pt (Portugheză), ro (Românesc), ru (Rusă), sk (Slovacă), sl (Slovenă), sv (Suedeză), tr (Turcă), uk (Ucraineană), zh (Chineză)


Modificări SOAP (versiunea 3) în comparație cu SOAP (versiunea 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

Elemente noi:

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

Webhooks Settings


Prezentare generală

Un webhook este o modalitate prin care o aplicație poate furniza altor aplicații informații în timp real. Caracteristica noastră webhook implementează callback-uri HTTP configurate cu un URL. O sarcină utilă HTTP POST este trimisă la acest URL în format JSON ori de câte ori apare un eveniment specificat. În contextul proiectului nostru, am conceput funcția webhook pentru a declanșa evenimente specifice.

Configurarea unui Webhook

Pentru a configura un webhook pentru aplicația dvs., navigați pe pagina de setări a aplicației și căutați secțiunea "Setări Webhooks". Și furnizați următoarele informații:

  1. "Webhook URL" este URL-ul la care serverul dvs. va primi solicitările POST ale webhook-ului.
  2. "Încercări maxime de livrare" este setarea care definește numărul maxim de încercări de reluare a livrării unui eveniment webhook atunci când încercarea inițială de livrare eșuează.
  3. "Delivery retry timeout" este o setare care vă permite să specificați intervalul de timp dintre încercări atunci când o încercare de livrare a unui webhook eșuează.

După ce ați furnizat aceste detalii, faceți clic pe "Save" (Salvare).

Tipuri de evenimente Webhook

  1. Noul statut al comenzii

Webhook Payload

Atunci când se produce un eveniment, vom trimite o cerere HTTP POST la URL-ul de plată cu un corp JSON care conține informații despre eveniment.

Iată un exemplu de sarcină utilă:
Exemplu de sarcină utilă a noului statut al comenzii
Valori posibile ale câmpului "new_status":
  • "Finished" - o comandă este completă. O comandă poate fi ridicată;
  • "Updated" - o comandă actualizată, date adăugate la o comandă finalizată;
  • "Canceled" - o comandă este anulată la cererea (sau cu acordul) unui client;
  • "Rejected" - un ordin este respins. De obicei, pentru că este imposibil să se identifice o societate.

Asigurarea securizării Webhooks

Este important să verificăm dacă solicitările POST trimise către URL-ul de plată provin din aplicația noastră. Pentru a vă ajuta în acest sens, fiecare cerere webhook include un antet X-Signature.

Descriere semnătură

Pentru semnare folosim HMAC cu algoritmul SHA512.

Secret este o concatenare a ID-ului aplicației și a cheii secrete din setările webhooks.

Dacă este necesar, este posibil să se adauge la punctul final propriul parametru get params pentru a identifica expeditorul.

Depanare

Un server trebuie să răspundă în termen de 10 secunde și să returneze un cod HTTP 2XX; în caz contrar, livrarea webhook-ului este considerată un eșec. În caz de eșec, funcția va încerca să retrimită cererea în sus, în conformitate cu politica de livrare.