Table of Contents

InfoEnrich

L'app InfoEnrich fornisce delle funzionalità avanzate per il controllo ed il popolamento dei dati relativi ai clienti, tramite interfaccia con i provider supportati.

In questo momento l'unico provider supportato è OpenAPI.

Le funzionalità disponibili sono:

  • Suggerimento e controllo dati società: consente la lettura dei dati societari dal provider e l'eventuale applicazione all'anagrafica cliente.
  • Controllo codice fiscale: controlla il codice fiscale.
  • Valutazione credito: effettua la lettura dei dati di valutazione del rischio\rating di credito della società.

Le funzionalità dell'app sono disponibili nella scheda anagrafica del cliente, in cui è stato aggiunto il gruppo Arricchisci dati contenente le varie funzionalità.

Configurazione OpenAPI

L'utilizzo del provider richiede che sia stata effettuata preventivamente la registrazione con OpenAPI.

In generale le API messe a disposizione da OpenAPI sono con pagamento a chiamata, cioè per ogni chiamata di verifica\lettura effettuata viene registrato un costo unitario che può essere a consumo oppure basato su abbonamento (quindi con un minimo di chiamate da effettuare nel periodo). Il listino prezzi è disponibile sul sito di OpenAPI. Il pagamento avviene ricaricando del credito sul proprio account tramite carta di credito o bonifico bancario, tale credito potrà successivamente essere consumato dalle chiamate API.

La configurazione delle credenziali di accesso avviene nella maschera Setup InfoEnrich.

  • Provider: selezionare OpenAPI.
  • Ambiente: indica se le chiamate devono essere effettuate verso l'ambiente di Sandbox o quello di Produzione. Le chiamate verso Sandbox restituiscono valori fittizi ma non consumano credito, le chiamate verso la Produzione consumano credito e restituiscono i valori reali.
  • Nome utente: il nome utente con il quale si è effettuata la registrazione su OpenAPI.
  • Api Key: le credenziali di autenticazione da utilizzare, recuperabili dall'area riservata della console di OpenAPI nella sezione Autenticazione.

Le funzionalità dell'app InfoEnrich richiedono inoltre l'abilitazione delle seguenti API:

  • Oauth: per gestire l'autenticazione.
  • Company: per la lettura dei dati societari.
  • Risk: per la lettura dei dati relativi al credito ed al codice fiscale.

L'attivazione avviene selezionando la singola API dall'area riservata della console di OpenAPI nella sezione Libreria Api, aprendo il tab Stato e caricando i documenti richiesti. In seguito all'avvenuto controllo dei documenti, le API saranno attivate ed utilizzabili.

In generale i dati di OpenAPI sono derivanti da un database interno alimentato da varie fonti di dati ufficiali e proprietari. Le informazioni relative alla valutazione del credito e dei rischi in particolare sono effettuate a partire da fonti ufficiali e certificate e database pubblici come ad esempio Anagrafe, Camera di Commercio, Agenzia delle Entrate, CRIF, Experian. Maggiori informazioni sono disponibili sul sito di OpenAPI.

L'elenco delle API supportate sono i seguenti:

  • IT-start: per suggerimento e controllo dati societari.
  • IT-verifica_cf: controllo codice fiscale.
  • IT-creditscore-start: controllo valutazione credito e rischio di base.
  • IT-creditscore-advanced: controllo valutazione credito e rischio avanzato, la cui attivazione avviene come spiegato di seguito.

Valutazione credito

Le funzionalità di lettura delle valutazioni del rischio e del rating di credito richiedono una mappatura fra i valori di OpenAPI e le classificazioni interne.

Le classificazioni interne vengono effettuate a partire dalla maschera Setup InfoEnrich tramite le seguenti azioni:

  • Valutazione Credito: configurare i valori delle valutazioni che si vogliono utilizzare internamente per la classificazione dei clienti. E' possibile definire anche uno stile di visualizzazione per ogni valore secondo i formati supportati da Business Central (eg. verde, rosso, giallo, etc).

  • Rischio Credito: configurare i valori del rischio che si vogliono utilizzare internamente per la classificazione dei clienti. E' possibile definire anche uno stile di visualizzazione per ogni valore secondo i formati supportati da Business Central (eg. verde, rosso, giallo, etc).

E' successivamente necessario effettuare la mappatura fra i valori esterni di OpenAPI ed i valori interni configurati tramite le apposite e Mappatura Valutazione Credito e Mappatura Rischio Credito.

Le funzionalità di base IT-creditscore-start consentono solo di recuperare le informazioni di base del rischio su 3 livelli (verde\giallo\rosso). Le funzionalità avanzate consentono di recuperare 7 livelli di rischio (da VERDE a ROSSO SCURO) ed in aggiunta anche informazioni relative a:

  • Valutazione credito su 9 livelli (A1-C3)
  • Dettaglio del rischio
  • Risk severity (da 1 "rischio basso" a 990 "rischio alto")

L'attivazione della chiamata avanzata avviene dalla maschera Setup InfoEnrich, selezionando l'azione Configurazione operazioni. In tale maschera è sufficiente creare una riga per provider OpenAPI e tipo Credit Advanced, senza necessità di effettuare ulteriori configurazioni.