Documentazione API di Infoproff - v3

Versione Switch V3

Come iniziare

Il wsdl e gli schemi del servizio web si trovano qui:

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

Web service functions:

  • SimpleSearch - Cerca informazioni sulle aziende in diversi paesi.
  • ChkFinance - Cercare i bilanci disponibili.
  • Order - Crea un order_id e restituisce i duplicati. I duplicati sono selezionati dai prossimi parametri: country, product, reg_code.
  • OrderCancellation - Se avete inviato una richiesta d'ordine e ricevuto il order_id, avete la possibilità di annullare questo ordine (se non è andato in produzione).
  • OrderConfirmation - Dopo aver ottenuto order_id dovrai confermare il tuo ordine entro 1 ora. Se non confermi l'ordine entro 1 ora, l'ordine sarà cancellato automaticamente.
  • ChkStatus - Controlla lo stato dell'ordine.
  • GetReport - Ottenere rapporti finiti.
  • GetClassifiersFinancialStatements - Ottiene tutti i documenti finanziari con tutti gli elementi: row_number, row_formated_description, row_lang_key e row_order.
  • GetLegalForms - Ottieni tutti i moduli legali per tutti i paesi disponibili.
  • GetActivityClassificators - Ottieni tutti i codici e le descrizioni per il classificatore di attività specifiche.
  • GetDictionaryStandardPhrases - Ottieni tutte le frasi standard con chiavi e lingua.
  • GetAvailableProducts - Ottieni una lista di prodotti disponibili.
  • CreditOpinionCalculator - Credit Opinion Calculator aiuta ad assegnare l'opinione di credito su un'azienda.

API fornisce diversi servizi:

  1. Rapporti di credito online per i seguenti paesi: Repubblica di Finlandia (FIN), Regno di Svezia (SWE), Regno del Belgio (BEL), Regno dei Paesi Bassi (NLD), Repubblica di Estonia (EST), Repubblica del Kazakistan (KAZ), Repubblica di Polonia (POL), Repubblica del Kirghizistan (KGZ), Repubblica Popolare Cinese (CHN), Mongolia (MNG)
  2. Rapporti offline per i seguenti paesi: Tutti i paesi
  3. Calcolatore di opinioni sul credito

Come cercare un'azienda?

La ricerca dell'azienda consiste in 2 opzioni:

  1. Cerca per nome dell'azienda,
  2. Search by company code.
Elenco dei paesi disponibili: Bosnia ed Erzegovina (BIH), Collettività di San Martino (MAF), Commonwealth dell'Australia (AUS), Confederazione Svizzera (CHE), Costa d'Avorio (CIV), Emirati Arabi Uniti (ARE), Federazione Russa (RUS), Georgia (GEO), Giappone (JPN), Granducato di Lussemburgo (LUX), Groenlandia (GRL), Guadalupa (GLP), Guiana francese (GUF), Hong Kong (HKG), Il Baliato di Jersey (JEY), Irlanda (IRL), Isola di Man (IMN), Kosovo (XXK), Martinica (MTQ), Mayotte (MYT), Mongolia (MNG), Nuova Zelanda (NZL), Principato del Liechtenstein (LIE), Principato di Monaco (MCO), Regno Unito di Gran Bretagna e Irlanda del Nord (GBR), Regno dei Paesi Bassi (NLD), Regno del Belgio (BEL), Regno del Marocco (MAR), Regno di Danimarca (DNK), Regno di Norvegia (NOR), Regno di Spagna (ESP), Regno di Svezia (SWE), Regno di Thailandia (THA), Repubblica Argentina (ARG), Repubblica Bolivariana del Venezuela (VEN), Repubblica Ceca (CZE), Repubblica Cooperativa della Guyana (GUY), Repubblica Democratica Popolare di Algeria (DZA), Repubblica Democratica Socialista dello Sri Lanka (LKA), Repubblica Ellenica (GRC), Repubblica Federale Democratica di Etiopia (ETH), Repubblica Federale della Nigeria (NGA), Repubblica Federale di Germania (DEU), Repubblica Federativa del Brasile (BRA), Repubblica Francese (FRA), Repubblica Italiana (ITA), Repubblica Orientale dell'Uruguay (URY), Repubblica Popolare Cinese (CHN), Repubblica Portoghese (PRT), Repubblica Slovacca (SVK), Repubblica Unita di Tanzania (TZA), Repubblica d'Angola (AGO), Repubblica d'Austria (AUT), Repubblica d'Islanda (ISL), Repubblica d'Ungheria (HUN), Repubblica del Benin (BEN), Repubblica del Botswana (BWA), Repubblica del Cile (CHL), Repubblica del Congo (COG), Repubblica del Gambia (GMB), Repubblica del Kazakistan (KAZ), Repubblica del Kenya (KEN), Repubblica del Kirghizistan (KGZ), Repubblica del Madagascar (MDG), Repubblica del Paraguay (PRY), Repubblica del Perù (PER), Repubblica del Ruanda (RWA), Repubblica del Sudafrica (ZAF), Repubblica del Tagikistan (TJK), Repubblica del Togo (TGO), Repubblica dell'Azerbaigian (AZE), Repubblica dell'Ecuador (ECU), Repubblica delle Filippine (PHL), Repubblica delle Maldive (MDV), Repubblica delle Seychelles (SYC), Repubblica dello Zimbabwe (ZWE), Repubblica di Albania (ALB), Repubblica di Bielorussia (BLR), Repubblica di Bulgaria (BGR), Repubblica di Cina (TWN), Repubblica di Cipro (CYP), Repubblica di Croazia (HRV), Repubblica di Estonia (EST), Repubblica di Finlandia (FIN), Repubblica di Guinea (GIN), Repubblica di Lettonia (LVA), Repubblica di Lituania (LTU), Repubblica di Malta (MLT), Repubblica di Mauritius (MUS), Repubblica di Moldavia (MDA), Repubblica di Namibia (NAM), Repubblica di Polonia (POL), Repubblica di San Marino (SMR), Repubblica di Serbia (SRB), Repubblica di Singapore (SGP), Repubblica di Slovenia (SVN), Repubblica di Uzbekistan (UZB), Repubblica di Zambia (ZMB), Reunion (REU), Romania (ROU), Stato Plurinazionale della Bolivia (BOL), Stato di Israele (ISR), Stato indipendente di Samoa (WSM)

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.

Informazioni importanti:

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.

Il registro della Norvegia non permette di cercare le aziende cancellate per nome. Pertanto, non possiamo fornire un SimpleSearch per nomi all'interno delle aziende cancellate in Norvegia.

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

Qui sotto potete trovare l'esempio:

Funzione SimpleSearch

Opzione 2: Ricerca per codice di registrazione

Funzione SimpleSearch

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

Funzione UnifiedSearch

Come ordinare un rapporto di credito?

List of available countries for online credit reports: Confederazione Svizzera (CHE), Federazione Russa (RUS), Granducato di Lussemburgo (LUX), Irlanda (IRL), Mongolia (MNG), Regno Unito di Gran Bretagna e Irlanda del Nord (GBR), Regno dei Paesi Bassi (NLD), Regno del Belgio (BEL), Regno di Spagna (ESP), Regno di Svezia (SWE), Repubblica Federale di Germania (DEU), Repubblica Francese (FRA), Repubblica Italiana (ITA), Repubblica Popolare Cinese (CHN), Repubblica Portoghese (PRT), Repubblica d'Austria (AUT), Repubblica del Kazakistan (KAZ), Repubblica del Kirghizistan (KGZ), Repubblica di Estonia (EST), Repubblica di Finlandia (FIN), Repubblica di Moldavia (MDA), Repubblica di Polonia (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))

Funzione SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Come cercare un'azienda?

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

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

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

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

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

I seguenti stati sono utilizzati per i rapporti:

  • In corso - Rapporto in fase di produzione
  • Identification pending - Preparazione del rapporto in attesa. Richiede ulteriori dati al cliente.
  • Canceled - Ordine annullato
  • Finished - Il rapporto è pronto
  • Updated - Le informazioni sono state aggiunte al rapporto finito
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Si è verificato un errore tecnico nel nostro sistema. Questo significa che siamo informati di questo errore e lo risolveremo al più presto. Sarete informati quando sarete in grado di ricevere l'ordine.

Se lo stato di esecuzione è Finished o Updated, allora potete ottenere un ordine.

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

Funzione GetReport
Elenco delle lingue disponibili: bg (Bulgaro), cs (Ceca), da (Danese), de (Tedesco), el (Greco), en (Inglese), es (Spagnolo), et (Estone), fi (Finlandese), fr (Francese), hu (Ungherese), id (Indonesiano), it (Italiano), ja (Giapponese), ko (Coreano), lt (Lituano), lv (Lettone), nb (Norvegese Bokmål), nl (Olandese), pl (Polacco), pt (Portoghese), ro (Rumeno), ru (Russo), sk (Slovacco), sl (Sloveno), sr (Српски), sv (Svedese), tr (Turco), uk (Ucraino), zh (Cinese)

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

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

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

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

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

I seguenti stati sono utilizzati per i rapporti:

  • In corso - Rapporto in fase di produzione
  • Identification pending - Preparazione del rapporto in attesa. Richiede ulteriori dati al cliente.
  • Canceled - Ordine annullato
  • Finished - Il rapporto è pronto
  • Updated - Le informazioni sono state aggiunte al rapporto finito
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Si è verificato un errore tecnico nel nostro sistema. Questo significa che siamo informati di questo errore e lo risolveremo al più presto. Sarete informati quando sarete in grado di ricevere l'ordine.

Se lo stato di esecuzione è Finished o Updated, allora potete ottenere un ordine.

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

Funzione GetReport
Elenco delle lingue disponibili: bg (Bulgaro), cs (Ceca), da (Danese), de (Tedesco), el (Greco), en (Inglese), es (Spagnolo), et (Estone), fi (Finlandese), fr (Francese), hu (Ungherese), id (Indonesiano), it (Italiano), ja (Giapponese), ko (Coreano), lt (Lituano), lv (Lettone), nb (Norvegese Bokmål), nl (Olandese), pl (Polacco), pt (Portoghese), ro (Rumeno), ru (Russo), sk (Slovacco), sl (Sloveno), sr (Српски), sv (Svedese), tr (Turco), uk (Ucraino), zh (Cinese)

Come ordinare un rapporto di credito archiviato?

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

Funzione 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: Come cercare un'azienda?

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

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

Come ordinare i rendiconti finanziari online?

STEP 1: Find a company

Funzione SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Come cercare un'azienda?

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: Cerca i rendiconti finanziari disponibili

Funzione ChkFinance

Questa funzione è necessaria solo quando si ordina un prodotto: finances (Financial statements) con delivery_term = 'o'.

Elenco dei paesi disponibili: Repubblica di Estonia (EST), Regno di Svezia (SWE)

STEP 3: Ordinare i rendiconti finanziari

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

Funzione 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

Funzione 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

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

I seguenti stati sono utilizzati per i rapporti:

  • In corso - Rapporto in fase di produzione
  • Identification pending - Preparazione del rapporto in attesa. Richiede ulteriori dati al cliente.
  • Canceled - Ordine annullato
  • Finished - Il rapporto è pronto
  • Updated - Le informazioni sono state aggiunte al rapporto finito
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Si è verificato un errore tecnico nel nostro sistema. Questo significa che siamo informati di questo errore e lo risolveremo al più presto. Sarete informati quando sarete in grado di ricevere l'ordine.

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

Funzione GetReport
Elenco delle lingue disponibili: bg (Bulgaro), cs (Ceca), da (Danese), de (Tedesco), el (Greco), en (Inglese), es (Spagnolo), et (Estone), fi (Finlandese), fr (Francese), hu (Ungherese), id (Indonesiano), it (Italiano), ja (Giapponese), ko (Coreano), lt (Lituano), lv (Lettone), nb (Norvegese Bokmål), nl (Olandese), pl (Polacco), pt (Portoghese), ro (Rumeno), ru (Russo), sk (Slovacco), sl (Sloveno), sr (Српски), sv (Svedese), tr (Turco), uk (Ucraino), zh (Cinese)
To see the examples of xml request/response, please follow the link: How to get finished order?

Come scaricare i rapporti standard (in formati diversi da 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.

La richiesta consiste in 3 parti:

  1. Parte fissa https://www.infoproff.com/en/orders/files/
  2. Il suo hash unico, che forniamo in risposta
  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 - Originale (senza scambio), 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

Come scaricare prodotti 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.

La richiesta consiste in 3 parti:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Il suo hash unico, che forniamo in risposta
  3. E parte fissa alla fine /download

Come ottenere un parere sul credito?

Funzione CreditOpinionCalculator

Come ottenere ulteriori informazioni?

Funzione GetClassifiersFinancialStatements
Funzione GetActivityClassificators
Funzione GetDictionaryStandardPhrases
Funzione GetAvailableProducts

delivery_term:

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

Possibili errori

Questi errori possono verificarsi durante la richiesta al nostro servizio web.

Tutte le funzioni
  • Incorrect username/password or you have no permissions.
    Stai inserendo credenziali sbagliate o il tuo accesso API è bloccato.
Funzione SimpleSearch
  1. You don't have permissions to search in this country.
    Elenco dei paesi disponibili: Bosnia ed Erzegovina (BIH), Collettività di San Martino (MAF), Commonwealth dell'Australia (AUS), Confederazione Svizzera (CHE), Costa d'Avorio (CIV), Emirati Arabi Uniti (ARE), Federazione Russa (RUS), Georgia (GEO), Giappone (JPN), Granducato di Lussemburgo (LUX), Groenlandia (GRL), Guadalupa (GLP), Guiana francese (GUF), Hong Kong (HKG), Il Baliato di Jersey (JEY), Irlanda (IRL), Isola di Man (IMN), Kosovo (XXK), Martinica (MTQ), Mayotte (MYT), Mongolia (MNG), Nuova Zelanda (NZL), Principato del Liechtenstein (LIE), Principato di Monaco (MCO), Regno Unito di Gran Bretagna e Irlanda del Nord (GBR), Regno dei Paesi Bassi (NLD), Regno del Belgio (BEL), Regno del Marocco (MAR), Regno di Danimarca (DNK), Regno di Norvegia (NOR), Regno di Spagna (ESP), Regno di Svezia (SWE), Regno di Thailandia (THA), Repubblica Argentina (ARG), Repubblica Bolivariana del Venezuela (VEN), Repubblica Ceca (CZE), Repubblica Cooperativa della Guyana (GUY), Repubblica Democratica Popolare di Algeria (DZA), Repubblica Democratica Socialista dello Sri Lanka (LKA), Repubblica Ellenica (GRC), Repubblica Federale Democratica di Etiopia (ETH), Repubblica Federale della Nigeria (NGA), Repubblica Federale di Germania (DEU), Repubblica Federativa del Brasile (BRA), Repubblica Francese (FRA), Repubblica Italiana (ITA), Repubblica Orientale dell'Uruguay (URY), Repubblica Popolare Cinese (CHN), Repubblica Portoghese (PRT), Repubblica Slovacca (SVK), Repubblica Unita di Tanzania (TZA), Repubblica d'Angola (AGO), Repubblica d'Austria (AUT), Repubblica d'Islanda (ISL), Repubblica d'Ungheria (HUN), Repubblica del Benin (BEN), Repubblica del Botswana (BWA), Repubblica del Cile (CHL), Repubblica del Congo (COG), Repubblica del Gambia (GMB), Repubblica del Kazakistan (KAZ), Repubblica del Kenya (KEN), Repubblica del Kirghizistan (KGZ), Repubblica del Madagascar (MDG), Repubblica del Paraguay (PRY), Repubblica del Perù (PER), Repubblica del Ruanda (RWA), Repubblica del Sudafrica (ZAF), Repubblica del Tagikistan (TJK), Repubblica del Togo (TGO), Repubblica dell'Azerbaigian (AZE), Repubblica dell'Ecuador (ECU), Repubblica delle Filippine (PHL), Repubblica delle Maldive (MDV), Repubblica delle Seychelles (SYC), Repubblica dello Zimbabwe (ZWE), Repubblica di Albania (ALB), Repubblica di Bielorussia (BLR), Repubblica di Bulgaria (BGR), Repubblica di Cina (TWN), Repubblica di Cipro (CYP), Repubblica di Croazia (HRV), Repubblica di Estonia (EST), Repubblica di Finlandia (FIN), Repubblica di Guinea (GIN), Repubblica di Lettonia (LVA), Repubblica di Lituania (LTU), Repubblica di Malta (MLT), Repubblica di Mauritius (MUS), Repubblica di Moldavia (MDA), Repubblica di Namibia (NAM), Repubblica di Polonia (POL), Repubblica di San Marino (SMR), Repubblica di Serbia (SRB), Repubblica di Singapore (SGP), Repubblica di Slovenia (SVN), Repubblica di Uzbekistan (UZB), Repubblica di Zambia (ZMB), Reunion (REU), Romania (ROU), Stato Plurinazionale della Bolivia (BOL), Stato di Israele (ISR), Stato indipendente di Samoa (WSM)
Funzione Order
  1. This product is not available.
    Tale prodotto non può essere trovato e non è possibile ordinarlo.
  2. You can't order report on company with legal form: "legal_form"
    Questo errore si applica solo a: Regno di Svezia (SWE)
    In Svezia non è possibile ordinare il rapporto online (delivery_term = "o") con le prossime forme legali:
    • 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
    Quando si ordina un rapporto offline (delivery_term = "n", "f" o "s") è richiesto "Business Name" o "Reg Code".
  5. Reg Code is required when delivery term is Online
    Quando si ordina un rapporto online (delivery_term = "o") è richiesto il "Reg Code".
Funzione GetReport
  1. This language is not supported.
    Elenco delle lingue disponibili per i rapporti online: bg (Bulgaro), cs (Ceca), da (Danese), de (Tedesco), el (Greco), en (Inglese), es (Spagnolo), et (Estone), fi (Finlandese), fr (Francese), hu (Ungherese), id (Indonesiano), it (Italiano), ja (Giapponese), ko (Coreano), lt (Lituano), lv (Lettone), nb (Norvegese Bokmål), nl (Olandese), pl (Polacco), pt (Portoghese), ro (Rumeno), ru (Russo), sk (Slovacco), sl (Sloveno), sr (Српски), sv (Svedese), tr (Turco), uk (Ucraino), zh (Cinese)
Funzioni GetReport ChkStatus
  1. Incorrect order_id.
    L'ID dell'ordine non può essere trovato. Si ottiene l'ID dell'ordine quando si usa la funzione Order.
Funzione OrderCancellation
  1. Your order is already canceled.
    Non hai più il permesso di cancellare l'ordine.
Funzione OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Modifiche di SOAP (versione 3) rispetto a SOAP (versione 2)

Modifiche di SOAP (versione 3) rispetto a SOAP (versione 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: Bosnia ed Erzegovina (BIH), Collettività di San Martino (MAF), Commonwealth dell'Australia (AUS), Confederazione Svizzera (CHE), Costa d'Avorio (CIV), Emirati Arabi Uniti (ARE), Federazione Russa (RUS), Georgia (GEO), Giappone (JPN), Granducato di Lussemburgo (LUX), Groenlandia (GRL), Guadalupa (GLP), Guiana francese (GUF), Hong Kong (HKG), Il Baliato di Jersey (JEY), Irlanda (IRL), Isola di Man (IMN), Kosovo (XXK), Martinica (MTQ), Mayotte (MYT), Mongolia (MNG), Nuova Zelanda (NZL), Principato del Liechtenstein (LIE), Principato di Monaco (MCO), Regno Unito di Gran Bretagna e Irlanda del Nord (GBR), Regno dei Paesi Bassi (NLD), Regno del Belgio (BEL), Regno del Marocco (MAR), Regno di Danimarca (DNK), Regno di Norvegia (NOR), Regno di Spagna (ESP), Regno di Svezia (SWE), Regno di Thailandia (THA), Repubblica Argentina (ARG), Repubblica Bolivariana del Venezuela (VEN), Repubblica Ceca (CZE), Repubblica Cooperativa della Guyana (GUY), Repubblica Democratica Popolare di Algeria (DZA), Repubblica Democratica Socialista dello Sri Lanka (LKA), Repubblica Ellenica (GRC), Repubblica Federale Democratica di Etiopia (ETH), Repubblica Federale della Nigeria (NGA), Repubblica Federale di Germania (DEU), Repubblica Federativa del Brasile (BRA), Repubblica Francese (FRA), Repubblica Italiana (ITA), Repubblica Orientale dell'Uruguay (URY), Repubblica Popolare Cinese (CHN), Repubblica Portoghese (PRT), Repubblica Slovacca (SVK), Repubblica Unita di Tanzania (TZA), Repubblica d'Angola (AGO), Repubblica d'Austria (AUT), Repubblica d'Islanda (ISL), Repubblica d'Ungheria (HUN), Repubblica del Benin (BEN), Repubblica del Botswana (BWA), Repubblica del Cile (CHL), Repubblica del Congo (COG), Repubblica del Gambia (GMB), Repubblica del Kazakistan (KAZ), Repubblica del Kenya (KEN), Repubblica del Kirghizistan (KGZ), Repubblica del Madagascar (MDG), Repubblica del Paraguay (PRY), Repubblica del Perù (PER), Repubblica del Ruanda (RWA), Repubblica del Sudafrica (ZAF), Repubblica del Tagikistan (TJK), Repubblica del Togo (TGO), Repubblica dell'Azerbaigian (AZE), Repubblica dell'Ecuador (ECU), Repubblica delle Filippine (PHL), Repubblica delle Maldive (MDV), Repubblica delle Seychelles (SYC), Repubblica dello Zimbabwe (ZWE), Repubblica di Albania (ALB), Repubblica di Bielorussia (BLR), Repubblica di Bulgaria (BGR), Repubblica di Cina (TWN), Repubblica di Cipro (CYP), Repubblica di Croazia (HRV), Repubblica di Estonia (EST), Repubblica di Finlandia (FIN), Repubblica di Guinea (GIN), Repubblica di Lettonia (LVA), Repubblica di Lituania (LTU), Repubblica di Malta (MLT), Repubblica di Mauritius (MUS), Repubblica di Moldavia (MDA), Repubblica di Namibia (NAM), Repubblica di Polonia (POL), Repubblica di San Marino (SMR), Repubblica di Serbia (SRB), Repubblica di Singapore (SGP), Repubblica di Slovenia (SVN), Repubblica di Uzbekistan (UZB), Repubblica di Zambia (ZMB), Reunion (REU), Romania (ROU), Stato Plurinazionale della Bolivia (BOL), Stato di Israele (ISR), Stato indipendente di Samoa (WSM)

- 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: Confederazione Svizzera (CHE), Federazione Russa (RUS), Granducato di Lussemburgo (LUX), Irlanda (IRL), Mongolia (MNG), Regno Unito di Gran Bretagna e Irlanda del Nord (GBR), Regno dei Paesi Bassi (NLD), Regno del Belgio (BEL), Regno di Spagna (ESP), Regno di Svezia (SWE), Repubblica Federale di Germania (DEU), Repubblica Francese (FRA), Repubblica Italiana (ITA), Repubblica Popolare Cinese (CHN), Repubblica Portoghese (PRT), Repubblica d'Austria (AUT), Repubblica del Kazakistan (KAZ), Repubblica del Kirghizistan (KGZ), Repubblica di Estonia (EST), Repubblica di Finlandia (FIN), Repubblica di Moldavia (MDA), Repubblica di Polonia (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 (Bulgaro), cs (Ceca), da (Danese), de (Tedesco), el (Greco), en (Inglese), es (Spagnolo), et (Estone), fi (Finlandese), fr (Francese), hu (Ungherese), id (Indonesiano), it (Italiano), ja (Giapponese), ko (Coreano), lt (Lituano), lv (Lettone), nb (Norvegese Bokmål), nl (Olandese), pl (Polacco), pt (Portoghese), ro (Rumeno), ru (Russo), sk (Slovacco), sl (Sloveno), sr (Српски), sv (Svedese), tr (Turco), uk (Ucraino), zh (Cinese)


Modifiche di SOAP (versione 3) rispetto a SOAP (versione 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

Nuovi elementi:

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

Webhooks Settings

Panoramica

Un webhook è un modo in cui un'applicazione può fornire ad altre applicazioni informazioni in tempo reale. La nostra funzione webhook implementa callback HTTP configurati con un URL. Un payload HTTP POST viene inviato a questo URL in formato JSON ogni volta che si verifica un evento specificato. Nel contesto del nostro progetto, abbiamo progettato la funzione webhook per attivare eventi specifici.

Impostazione di un webhook

Per impostare un webhook per la vostra applicazione, visitate la pagina delle impostazioni dell'applicazione e cercate la sezione "Impostazioni webhook". E fornire le seguenti informazioni:

  1. "URL webhook" è l'URL in cui il server riceverà le richieste POST dei webhook.
  2. "Tentativi max di consegna" è l'impostazione che definisce il numero massimo di tentativi da effettuare per consegnare un evento webhook quando il tentativo iniziale di consegna fallisce.
  3. "Timeout di ripetizione della consegna" è un'impostazione che consente di specificare l'intervallo di tempo tra i tentativi di ripetizione quando un tentativo di consegna di un webhook fallisce.

Dopo aver fornito questi dati, fare clic su "Salva".

Tipi di evento Webhook

  1. Nuovo stato dell'ordine

Carico utile del webhook

Quando si verifica un evento, invieremo una richiesta HTTP POST all'URL del payload con un corpo JSON contenente informazioni sull'evento.

Ecco un esempio di carico utile:
Esempio di payload del nuovo stato dell'ordine
Valori possibili del campo "new_status":
  • "Finished" - un ordine è completo. Un ordine può essere ritirato;
  • "Updated" - un ordine aggiornato, dati aggiunti a un ordine completato;
  • "Canceled" - l'annullamento di un ordine su richiesta (o consenso) del cliente;
  • "Rejected" - un ordine viene rifiutato. Di solito perché è impossibile identificare un'azienda.

Proteggere i webhook

È importante verificare che le richieste POST inviate all'URL del payload provengano dalla nostra applicazione. A tale scopo, ogni richiesta di webhook include un'intestazione X-Signature.

Descrizione della firma

Per la firma si utilizza l'algoritmo HMAC con SHA512.

Segreto è una concatenazione di ID app e Chiave segreta dalle impostazioni dei webhook.

È possibile aggiungere i propri parametri di get all'endpoint per identificare il mittente, se necessario.

Risoluzione dei problemi

Il server deve rispondere entro 10 secondi e restituire un codice HTTP 2XX; in caso contrario, la consegna del webhook è considerata fallita. In caso di fallimento, la funzione tenterà di reinviare la richiesta in base ai criteri di consegna.

© Documentazione API di Infoproff 2025