Implementare la funzionalità Monitoraggio aziendale di Creditsafe Connect : Creditsafe Italy

Durante l'implementazione della funzionalità Monitoraggio aziendale di Creditsafe Connect tramite il relativo endpoint /monitoring, si consiglia gli adottare in una prima fase la seguente sequenza di chiamata:

URI	HTTP METHOD
/monitoring/portfolios	POST
/monitoring/eventRules	GET
/monitoring/portfolios/{portfolioId}/eventRules/{countryCode}	PUT
/monitoring/portfolios/{portfolioId}/companies	POST
/monitoring/portfolios/{portfolioId}/notificationEvents	GET

1. Crea portafoglio

È necessario innanzitutto creare un portafoglio tramite Creditsafe Connect chiamando il seguente endpoint:

URI	HTTP METHOD
/monitoring/portfolios	POST

{
"name": "My New Portfolio",
"isDefault": "true"
}

2. Ottieni Regole Eventi

È possibile recuperare tramite Creditsafe Connect un elenco di tutte le regole di notifica eventi che possono essere applicate al portafoglio in questione chiamando il seguente endpoint:

URI	HTTP METHOD
/monitoring/eventRules	GET

3. Attiva Regole Eventi

Le "notificationEvents" di Creditsafe Connect saranno generate esclusivamente per le "eventRules" attive del portafoglio, perciò se nessuna "eventRule" è attiva, allora nessuna "notificationEvents" verrà generata per il portafoglio in questione. È possibile attivare le "eventRules" soltanto chiamando il seguente endpoint:

URI	HTTP METHOD
/monitoring/portfolios/{portfolioId}/eventRules/{countryCode}	PUT

[  {    "ruleCode": 1801,    "ruleCountryCode": "GB",    "isActive": 1,    "param0": "15"  },  {    "ruleCode": 1802,    "ruleCountryCode": "GB",    "isActive": 1,    "param0": "10"  },  {    "ruleCode": 3054,    "ruleCountryCode": "GB",    "isActive": 1  }
]

4. Aggiungi Azienda

Una volta che le "eventRules" sono attive, è possibile aggiungere una "company" al portafoglio utilizzando il seguente endpoint di Creditsafe Connect:

URI	HTTP METHOD
/monitoring/portfolios/{portfolioId}/companies	POST

{  "id": "GB-0-123456789",  "personalReference": "",  "freeText": "",  "personalLimit": ""
}

5. Ottieni Notifiche Eventi

Una volta che le "eventRules" sono attive e una "company" è stata aggiunta al portafoglio, si consiglia di chiamare periodicamente il seguente endpoint di Creditsafe Connect per controllare se siano state generate eventuali "notificationEvents" per la "company" / le "eventRules":

URI	HTTP METHOD
/monitoring/portfolios/{portfolioId}/notificationEvents	GET

Sebbene questo articolo copra gli elementi base, consigliamo di fare riferimento al sito della documentazione Creditsafe Connect al seguente link:

/monitoring

[DVX31] Se dovessi riscontrare dei problemi, apri un ticket.

Soluzione alternativa: In caso di eventuali problemi,