Documentazione API di Infoproff - v2

Versione Switch V2

Come iniziare

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

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

Funzioni principali del servizio web:

  • SimpleSearch - Cerca informazioni sulle aziende in diversi paesi.
  • Order - Crea un order_id e restituisce i duplicati. I duplicati sono selezionati dai prossimi parametri: country, product, delivery_term and 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)
  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. Ricerca per codice di registrazione.
Elenco dei paesi disponibili: Repubblica di Finlandia (FIN), Regno di Svezia (SWE), Regno di Norvegia (NOR), Regno di Danimarca (DNK)
Informazioni importanti:
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

Come ordinare un rapporto di credito?

L'ordine dalla registrazione alla ricezione del rapporto consiste in questi passi:

  1. L'utente registra un nuovo ordine (funzione "Ordine"). Il sistema restituisce i dettagli dell'ordine, la lista dei duplicati effettuati negli ultimi 60 giorni e attende la conferma dell'ordine.
  2. L'utente conferma un ordine (funzione "OrderConfirmation"). Il sistema invia l'ordine alla produzione e restituisce lo stato di produzione attuale.
  3. L'utente controlla lo stato dell'ordine (funzione "ChkStatus").
  4. Se un ordine è pronto, allora l'utente può scaricare il rapporto (funzione "GetReport").
Elenco dei paesi disponibili: Repubblica di Finlandia (FIN), Regno di Svezia (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)

Qui sotto potete trovare l'esempio:

FASE 1: Ordinare il rapporto

Gli utenti che considerano superfluo il passo di conferma dell'ordine possono usare l'elemento "confirm_order" e passare il valore "TRUE".

Di solito ci vogliono 10-20 secondi per preparare il rapporto di credito in modalità online.
Quindi, per i rapporti online, dovreste fare dei controlli ogni 5 o più secondi.

Elenco delle aziende disponibili per un conto di prova:

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
Inoltre, per i rapporti online (delivery_term = "o"), è possibile utilizzare i campioni generati per ogni paese (uso: codice di registrazione "00000000"). Questi rapporti sono gratuiti e possono essere ordinati usando il conto di prova.
Funzione Order
Funzione OrderCancellation

FASE 2. Conferma dell'ordine

Funzione OrderConfirmation

FASE 3. Controllo dello stato

Funzione ChkStatus

FASE 4. Ottenere il rapporto

Elenco delle lingue disponibili per i rapporti online: en (English), et (Estonian), ru (Russian), de (German)
Il download del rapporto online in pdf non è ancora disponibile.
Funzione GetReport

I seguenti stati sono utilizzati per i rapporti:

  • In corso - Rapporto in fase di produzione
  • 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.

Come scaricare il rapporto Offline?

Puoi scaricare direttamente i rapporti Offline. Ecco le istruzioni su come farlo:

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

Possibili errori

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

Tutte le funzioni
  • Nome utente/password non corretti o non si dispone di autorizzazioni.
    Stai inserendo credenziali sbagliate o il tuo accesso API è bloccato.
Funzione SimpleSearch
  1. Non avete permessi di ricerca in questo Paese.
    Elenco dei paesi disponibili: Repubblica di Finlandia (FIN), Regno di Svezia (SWE)
Funzione Order
  1. Questo prodotto non è disponibile.
    Tale prodotto non può essere trovato e non è possibile ordinarlo.
  2. Non è possibile ordinare un rapporto su un'azienda con forma giuridica: "forma_legale"
    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. Questa azienda non è presente nell'elenco dei test.
    Il codice di registrazione dell'azienda non è nella nostra lista di test.
    Elenco delle aziende disponibili per un conto di prova:
    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. È richiesta la ragione sociale o il codice fiscale
    Quando si ordina un rapporto offline (delivery_term = "n", "f" o "s") è richiesto "Business Name" o "Reg Code".
  5. Il codice di registrazione è richiesto quando il termine di consegna è Online
    Quando si ordina un rapporto online (delivery_term = "o") è richiesto il "Reg Code".
Funzione GetReport
  1. Questa lingua non è supportata.
    Elenco delle lingue disponibili per i rapporti online: en (English), et (Estonian), ru (Russian), de (German)
Funzioni GetReport ChkStatus
  1. ID ordine non corretto.
    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. Non avete più il permesso di confermare l'ordine. La conferma può essere effettuata entro un'ora dalla ricezione di 'order_id'.

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

Modifiche di SOAP (versione 3) rispetto a SOAP (versione 2) [Panoramica]

1) Nuova funzione: ChkFinance

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

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

Per effettuare un ordine online, è necessario ricevere 'search_result_id' dalla funzione 'SimpleSearch', e solo dopo è possibile effettuare un ordine online (delivery_term = 'o').

- Modifiche all'elenco dei paesi disponibili per i rapporti di credito online: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Disponibile a scaricare i bilanci (utilizzando il prodotto: finanze) in modalità online: Estonia (EST), Sweden (SWE)

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


Modifiche di SOAP (versione 3) rispetto a SOAP (versione 2) [WSDL and XSD]

File: report.xsd

Nuovi elementi:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Nuova funzione:

- 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

Nuovo elemento:

- preferable_finances

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

3) SimpleSearchRequest

Elemento rimosso:

search_block.reg_code

Nuovo elemento:

search_block->company_code

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

4) SimpleSearchResponse

Elementi rimossi

- code

Nuovi elementi:

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